pretix-bundestag-export 0.1.1__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- pretix_bundestag_export-0.1.1/LICENSE +21 -0
- pretix_bundestag_export-0.1.1/PKG-INFO +171 -0
- pretix_bundestag_export-0.1.1/README.md +127 -0
- pretix_bundestag_export-0.1.1/pretix_bundestag_export/__init__.py +12 -0
- pretix_bundestag_export-0.1.1/pretix_bundestag_export/apps.py +45 -0
- pretix_bundestag_export-0.1.1/pretix_bundestag_export/exporter.py +327 -0
- pretix_bundestag_export-0.1.1/pretix_bundestag_export/signals.py +33 -0
- pretix_bundestag_export-0.1.1/pretix_bundestag_export.egg-info/PKG-INFO +171 -0
- pretix_bundestag_export-0.1.1/pretix_bundestag_export.egg-info/SOURCES.txt +14 -0
- pretix_bundestag_export-0.1.1/pretix_bundestag_export.egg-info/dependency_links.txt +1 -0
- pretix_bundestag_export-0.1.1/pretix_bundestag_export.egg-info/entry_points.txt +2 -0
- pretix_bundestag_export-0.1.1/pretix_bundestag_export.egg-info/requires.txt +2 -0
- pretix_bundestag_export-0.1.1/pretix_bundestag_export.egg-info/top_level.txt +1 -0
- pretix_bundestag_export-0.1.1/pyproject.toml +45 -0
- pretix_bundestag_export-0.1.1/setup.cfg +4 -0
- pretix_bundestag_export-0.1.1/setup.py +3 -0
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Die Linke im Bundestag
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
|
@@ -0,0 +1,171 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: pretix-bundestag-export
|
|
3
|
+
Version: 0.1.1
|
|
4
|
+
Summary: pretix-Plugin für den Export von Teilnehmerdaten zur Anmeldung im Bundestag
|
|
5
|
+
Author-email: Die Linke im Bundestag <digitalisierung@dielinkebt.de>
|
|
6
|
+
License: MIT License
|
|
7
|
+
|
|
8
|
+
Copyright (c) 2026 Die Linke im Bundestag
|
|
9
|
+
|
|
10
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
11
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
12
|
+
in the Software without restriction, including without limitation the rights
|
|
13
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
14
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
15
|
+
furnished to do so, subject to the following conditions:
|
|
16
|
+
|
|
17
|
+
The above copyright notice and this permission notice shall be included in all
|
|
18
|
+
copies or substantial portions of the Software.
|
|
19
|
+
|
|
20
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
21
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
22
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
23
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
24
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
25
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
26
|
+
SOFTWARE.
|
|
27
|
+
|
|
28
|
+
Project-URL: Homepage, https://github.com/dielinkebt/pretix-bundestag-export
|
|
29
|
+
Project-URL: Repository, https://github.com/dielinkebt/pretix-bundestag-export
|
|
30
|
+
Keywords: pretix,plugin,export,bundestag
|
|
31
|
+
Classifier: Development Status :: 4 - Beta
|
|
32
|
+
Classifier: Environment :: Web Environment
|
|
33
|
+
Classifier: Framework :: Django
|
|
34
|
+
Classifier: Intended Audience :: Developers
|
|
35
|
+
Classifier: License :: OSI Approved :: MIT License
|
|
36
|
+
Classifier: Operating System :: OS Independent
|
|
37
|
+
Classifier: Programming Language :: Python :: 3
|
|
38
|
+
Requires-Python: >=3.10
|
|
39
|
+
Description-Content-Type: text/markdown
|
|
40
|
+
License-File: LICENSE
|
|
41
|
+
Requires-Dist: pretix>=2026.1.0
|
|
42
|
+
Requires-Dist: openpyxl>=3.1.0
|
|
43
|
+
Dynamic: license-file
|
|
44
|
+
|
|
45
|
+
# Pretix-Datenexport (Bundestag)
|
|
46
|
+
|
|
47
|
+
Ein [pretix](https://github.com/pretix/pretix)-Plugin für den standardisierten Export von Teilnehmerdaten aus Veranstaltungen als CSV- oder Excel-Datei (`.xlsx`). Das Plugin ist für einen sehr konkreten Anwendungsfall gedacht: den Export einer Teilnehmendenliste in einem vom Bundestag vorgegebenen Format.
|
|
48
|
+
|
|
49
|
+
## Format
|
|
50
|
+
|
|
51
|
+
Das Plugin erzeugt aus einer pretix-Veranstaltung eine strukturierte Liste von Teilnehmenden mit genau den Feldern, die für den vorgesehenen Bundestags-Export benötigt werden. Die Ausgabe kann wahlweise als CSV-Datei oder als Excel-Datei (`.xlsx`) erfolgen.
|
|
52
|
+
|
|
53
|
+
Die exportierten Spalten sind:
|
|
54
|
+
|
|
55
|
+
| Spalte | Inhalt |
|
|
56
|
+
|--------|--------|
|
|
57
|
+
| Name | Nachname der teilnehmenden Person |
|
|
58
|
+
| Vorname(n) | Vorname bzw. Vornamen der teilnehmenden Person |
|
|
59
|
+
| Geburtsdatum TT.MM.JJJJ | Geburtsdatum im Format `dd.mm.YYYY` |
|
|
60
|
+
|
|
61
|
+
## Funktionsweise des Exporters
|
|
62
|
+
|
|
63
|
+
Das Plugin wird in pretix als eigener Exporter registriert. Technisch geschieht das über das Signal `register_data_exporters`; dadurch erscheint der Exporter im Export-Bereich einer Veranstaltung unter "Bestellungen" -> "Export" -> "Teilnehmerexporte" und kann dort wie andere pretix-Exporte ausgewählt werden.
|
|
64
|
+
|
|
65
|
+
Beim Ausführen des Exports durchläuft der Exporter die Bestellpositionen einer Veranstaltung und liest daraus die relevanten Teilnehmerdaten aus. Die Exportlogik kombiniert dabei Systemdaten von pretix, etwa den Teilnehmernamen, mit Antworten auf Fragen, die über ihre **internen Referenzen** identifiziert werden.
|
|
66
|
+
|
|
67
|
+
Der Exporter bietet zwei Ausgabeformate an:
|
|
68
|
+
|
|
69
|
+
- CSV-Datei
|
|
70
|
+
- Excel-Datei (`.xlsx`)
|
|
71
|
+
|
|
72
|
+
Zusätzlich kann optional festgelegt werden, dass nur bezahlte Bestellungen exportiert werden. Diese Art zusätzlicher Exportparameter ist in pretix ausdrücklich über Formularfelder des Exporters vorgesehen.
|
|
73
|
+
|
|
74
|
+
## Zuordnung der Spalten
|
|
75
|
+
|
|
76
|
+
Die Spalten werden im Normalfall wie folgt befüllt:
|
|
77
|
+
|
|
78
|
+
| Spalte | Datenquelle |
|
|
79
|
+
|--------|-------------|
|
|
80
|
+
| Name | Nachname Teilnehmer*in, aus den pretix-Systemdaten zum Teilnehmernamen |
|
|
81
|
+
| Vorname(n) | Vorname Teilnehmer*in, aus den pretix-Systemdaten zum Teilnehmernamen |
|
|
82
|
+
| Geburtsdatum TT.MM.JJJJ | Antwort auf die Frage mit interner Referenz `GEBURTSDATUM` |
|
|
83
|
+
|
|
84
|
+
Das Geburtsdatum wird im Export immer in das Format `dd.mm.YYYY` umgewandelt. Wenn pretix intern bereits ein Datum speichert oder ein ISO-Datumsformat wie `YYYY-MM-DD` vorliegt, wird dieses Format sauber konvertiert. Liegt stattdessen bereits ein korrekt formatiertes Datum als Text vor, wird dieser Wert übernommen.
|
|
85
|
+
|
|
86
|
+
## Sonderlogik: abweichender Name laut Ausweisdokument
|
|
87
|
+
|
|
88
|
+
Das Plugin enthält eine spezielle Umschaltlogik für den Fall, dass der im System erfasste Name nicht mit dem amtlichen Ausweisdokument übereinstimmt.
|
|
89
|
+
|
|
90
|
+
Wenn die Frage "Der Name in meinem amtlichen Ausweisdokument unterscheidet sich vom angegebenen Namen." mit der internen Referenz `ANDERER_NAME` existiert und mit **Ja** beantwortet wurde, werden die Spalten **Name** und **Vorname(n)** nicht aus dem normalen Teilnehmernamen befüllt, sondern aus zwei anderen Fragen:
|
|
91
|
+
|
|
92
|
+
| Spalte | Datenquelle bei `ANDERER_NAME = Ja` |
|
|
93
|
+
|--------|------------------------------------|
|
|
94
|
+
| Name | `NACHNAME_AUSWEISDOKUMENT` |
|
|
95
|
+
| Vorname(n) | `VORNAME_AUSWEISDOKUMENT` |
|
|
96
|
+
|
|
97
|
+
Die Logik ist also:
|
|
98
|
+
|
|
99
|
+
Damit der Export korrekt funktioniert, müssen die internen Referenzen exakt so geschrieben sein wie unten beschrieben.
|
|
100
|
+
|
|
101
|
+
## Erforderliche interne Referenzen
|
|
102
|
+
|
|
103
|
+
Die folgenden internen Referenzen müssen in pretix vorhanden sein, wenn die jeweilige Funktion genutzt werden soll:
|
|
104
|
+
|
|
105
|
+
| Interne Referenz | Typische Bedeutung | Pflicht? |
|
|
106
|
+
|------------------|--------------------|----------|
|
|
107
|
+
| `GEBURTSDATUM` | Geburtsdatum der teilnehmenden Person | Ja |
|
|
108
|
+
| `ANDERER_NAME` | Ja/Nein-Frage, ob der Name im Ausweisdokument abweicht | Nur für Sonderlogik |
|
|
109
|
+
| `NACHNAME_AUSWEISDOKUMENT` | Nachname laut Ausweisdokument | Nur wenn `ANDERER_NAME` genutzt wird |
|
|
110
|
+
| `VORNAME_AUSWEISDOKUMENT` | Vorname(n) laut Ausweisdokument | Nur wenn `ANDERER_NAME` genutzt wird |
|
|
111
|
+
|
|
112
|
+
### Wichtig zu den Referenzen
|
|
113
|
+
|
|
114
|
+
- Die internen Referenzen müssen **exakt** mit diesen Bezeichnern übereinstimmen.
|
|
115
|
+
- Groß- und Kleinschreibung ist relevant, wenn der Exporter im Code exakt auf diese Kennungen prüft.
|
|
116
|
+
- Es zählt die **interne Referenz** der Frage, nicht der sichtbare Fragetext.
|
|
117
|
+
- Der sichtbare Fragetitel darf frei formuliert sein, solange die interne Referenz korrekt gesetzt ist.
|
|
118
|
+
|
|
119
|
+
## Installation
|
|
120
|
+
|
|
121
|
+
### 1. Plugin in das pretix-System bringen
|
|
122
|
+
|
|
123
|
+
Das Repository kann lokal installiert oder in ein bestehendes Plugin-Setup eingebunden werden. Typischerweise geschieht das per `pip`:
|
|
124
|
+
|
|
125
|
+
```bash
|
|
126
|
+
pip install -e .
|
|
127
|
+
```
|
|
128
|
+
|
|
129
|
+
Alternativ kann das Plugin auch als normales Python-Paket installiert werden.
|
|
130
|
+
|
|
131
|
+
### 2. pretix neu starten
|
|
132
|
+
|
|
133
|
+
Nach der Installation muss pretix neu gestartet werden, damit die Plugin-Metadaten geladen und die Exporter-Signale registriert werden. pretix lädt Plugins als reguläre Django-App und aktiviert zusätzliche Funktionen über deren App-Konfiguration und Signal-Registrierung.
|
|
134
|
+
|
|
135
|
+
### 3. Plugin aktivieren
|
|
136
|
+
|
|
137
|
+
Anschließend muss das Plugin in pretix für die gewünschte Veranstaltung bzw. den gewünschten Kontext aktiviert werden, damit der Exporter verfügbar ist.
|
|
138
|
+
|
|
139
|
+
## Verwendung im pretix-Backend
|
|
140
|
+
|
|
141
|
+
Nach erfolgreicher Installation und Aktivierung erscheint der Exporter im Export-Bereich der Veranstaltung. Dort kann das gewünschte Dateiformat ausgewählt werden, also CSV oder Excel, und bei Bedarf die Einschränkung auf bezahlte Bestellungen gesetzt werden.
|
|
142
|
+
|
|
143
|
+
Der Export erzeugt anschließend eine Datei mit einer Zeile pro exportierter Bestellposition bzw. teilnehmender Person.
|
|
144
|
+
|
|
145
|
+
## Typische Fehlerquellen
|
|
146
|
+
|
|
147
|
+
### Falsche oder fehlende interne Referenzen
|
|
148
|
+
|
|
149
|
+
Der häufigste Fehler ist, dass die Fragen zwar inhaltlich vorhanden sind, aber die interne Referenz nicht exakt stimmt. Schon kleine Abweichungen wie `Geburtsdatum`, `geburtsdatum` oder `GEB_DATUM` würden dazu führen, dass der Exporter die Daten nicht im erwarteten Feld findet.
|
|
150
|
+
|
|
151
|
+
### Falscher Fragetyp
|
|
152
|
+
|
|
153
|
+
Für `ANDERER_NAME` sollte eine echte Ja/Nein-Frage verwendet werden. Wenn stattdessen ein Freitextfeld oder eine Auswahl mit unerwarteten Werten genutzt wird, kann die Umschaltlogik unzuverlässig werden.
|
|
154
|
+
|
|
155
|
+
### Leere Ausweisdokument-Felder
|
|
156
|
+
|
|
157
|
+
Wenn `ANDERER_NAME` mit Ja beantwortet wird, aber `NACHNAME_AUSWEISDOKUMENT` oder `VORNAME_AUSWEISDOKUMENT` leer bleiben, dann werden entsprechend leere Werte exportiert. Die Validierung dieser Eingaben sollte daher möglichst schon im pretix-Formular sichergestellt werden.
|
|
158
|
+
|
|
159
|
+
### Abweichende Namenskonfiguration in pretix
|
|
160
|
+
|
|
161
|
+
Das Plugin nutzt für den Standardfall die Teilnehmer-Namensdaten aus dem pretix-System. Wenn eine Instanz oder ein Event sehr speziell konfiguriert ist und diese Namensbestandteile nicht wie erwartet pflegt, sollte die Exportlogik an die konkrete pretix-Konfiguration angepasst werden.
|
|
162
|
+
|
|
163
|
+
## Für wen dieses Plugin gedacht ist
|
|
164
|
+
|
|
165
|
+
Das Plugin eignet sich für Organisationen, die aus pretix standardisierte Listen mit personenbezogenen Veranstaltungsdaten exportieren müssen und dabei eine feste Zielstruktur brauchen. Es ist besonders dann sinnvoll, wenn interne Referenzen in Formularen konsequent gepflegt werden und die Exportlogik dauerhaft stabil reproduzierbar sein soll.
|
|
166
|
+
|
|
167
|
+
## Entwicklungshinweise
|
|
168
|
+
|
|
169
|
+
pretix empfiehlt für spezialisierte Datenausgaben den Weg über Exporter-Plugins statt über frei gebaute Einzelviews. Exporter sind in der Plattform bereits dafür vorgesehen, Dateiformate bereitzustellen und zusätzliche Exportoptionen als Formularfelder anzubieten.
|
|
170
|
+
|
|
171
|
+
Das Plugin folgt außerdem dem üblichen pretix-Plugin-Aufbau mit Python-Paket, App-Konfiguration und Registrierung über `entry_points`. Dadurch lässt es sich sauber deployen, versionieren und in bestehende pretix-Setups integrieren.
|
|
@@ -0,0 +1,127 @@
|
|
|
1
|
+
# Pretix-Datenexport (Bundestag)
|
|
2
|
+
|
|
3
|
+
Ein [pretix](https://github.com/pretix/pretix)-Plugin für den standardisierten Export von Teilnehmerdaten aus Veranstaltungen als CSV- oder Excel-Datei (`.xlsx`). Das Plugin ist für einen sehr konkreten Anwendungsfall gedacht: den Export einer Teilnehmendenliste in einem vom Bundestag vorgegebenen Format.
|
|
4
|
+
|
|
5
|
+
## Format
|
|
6
|
+
|
|
7
|
+
Das Plugin erzeugt aus einer pretix-Veranstaltung eine strukturierte Liste von Teilnehmenden mit genau den Feldern, die für den vorgesehenen Bundestags-Export benötigt werden. Die Ausgabe kann wahlweise als CSV-Datei oder als Excel-Datei (`.xlsx`) erfolgen.
|
|
8
|
+
|
|
9
|
+
Die exportierten Spalten sind:
|
|
10
|
+
|
|
11
|
+
| Spalte | Inhalt |
|
|
12
|
+
|--------|--------|
|
|
13
|
+
| Name | Nachname der teilnehmenden Person |
|
|
14
|
+
| Vorname(n) | Vorname bzw. Vornamen der teilnehmenden Person |
|
|
15
|
+
| Geburtsdatum TT.MM.JJJJ | Geburtsdatum im Format `dd.mm.YYYY` |
|
|
16
|
+
|
|
17
|
+
## Funktionsweise des Exporters
|
|
18
|
+
|
|
19
|
+
Das Plugin wird in pretix als eigener Exporter registriert. Technisch geschieht das über das Signal `register_data_exporters`; dadurch erscheint der Exporter im Export-Bereich einer Veranstaltung unter "Bestellungen" -> "Export" -> "Teilnehmerexporte" und kann dort wie andere pretix-Exporte ausgewählt werden.
|
|
20
|
+
|
|
21
|
+
Beim Ausführen des Exports durchläuft der Exporter die Bestellpositionen einer Veranstaltung und liest daraus die relevanten Teilnehmerdaten aus. Die Exportlogik kombiniert dabei Systemdaten von pretix, etwa den Teilnehmernamen, mit Antworten auf Fragen, die über ihre **internen Referenzen** identifiziert werden.
|
|
22
|
+
|
|
23
|
+
Der Exporter bietet zwei Ausgabeformate an:
|
|
24
|
+
|
|
25
|
+
- CSV-Datei
|
|
26
|
+
- Excel-Datei (`.xlsx`)
|
|
27
|
+
|
|
28
|
+
Zusätzlich kann optional festgelegt werden, dass nur bezahlte Bestellungen exportiert werden. Diese Art zusätzlicher Exportparameter ist in pretix ausdrücklich über Formularfelder des Exporters vorgesehen.
|
|
29
|
+
|
|
30
|
+
## Zuordnung der Spalten
|
|
31
|
+
|
|
32
|
+
Die Spalten werden im Normalfall wie folgt befüllt:
|
|
33
|
+
|
|
34
|
+
| Spalte | Datenquelle |
|
|
35
|
+
|--------|-------------|
|
|
36
|
+
| Name | Nachname Teilnehmer*in, aus den pretix-Systemdaten zum Teilnehmernamen |
|
|
37
|
+
| Vorname(n) | Vorname Teilnehmer*in, aus den pretix-Systemdaten zum Teilnehmernamen |
|
|
38
|
+
| Geburtsdatum TT.MM.JJJJ | Antwort auf die Frage mit interner Referenz `GEBURTSDATUM` |
|
|
39
|
+
|
|
40
|
+
Das Geburtsdatum wird im Export immer in das Format `dd.mm.YYYY` umgewandelt. Wenn pretix intern bereits ein Datum speichert oder ein ISO-Datumsformat wie `YYYY-MM-DD` vorliegt, wird dieses Format sauber konvertiert. Liegt stattdessen bereits ein korrekt formatiertes Datum als Text vor, wird dieser Wert übernommen.
|
|
41
|
+
|
|
42
|
+
## Sonderlogik: abweichender Name laut Ausweisdokument
|
|
43
|
+
|
|
44
|
+
Das Plugin enthält eine spezielle Umschaltlogik für den Fall, dass der im System erfasste Name nicht mit dem amtlichen Ausweisdokument übereinstimmt.
|
|
45
|
+
|
|
46
|
+
Wenn die Frage "Der Name in meinem amtlichen Ausweisdokument unterscheidet sich vom angegebenen Namen." mit der internen Referenz `ANDERER_NAME` existiert und mit **Ja** beantwortet wurde, werden die Spalten **Name** und **Vorname(n)** nicht aus dem normalen Teilnehmernamen befüllt, sondern aus zwei anderen Fragen:
|
|
47
|
+
|
|
48
|
+
| Spalte | Datenquelle bei `ANDERER_NAME = Ja` |
|
|
49
|
+
|--------|------------------------------------|
|
|
50
|
+
| Name | `NACHNAME_AUSWEISDOKUMENT` |
|
|
51
|
+
| Vorname(n) | `VORNAME_AUSWEISDOKUMENT` |
|
|
52
|
+
|
|
53
|
+
Die Logik ist also:
|
|
54
|
+
|
|
55
|
+
Damit der Export korrekt funktioniert, müssen die internen Referenzen exakt so geschrieben sein wie unten beschrieben.
|
|
56
|
+
|
|
57
|
+
## Erforderliche interne Referenzen
|
|
58
|
+
|
|
59
|
+
Die folgenden internen Referenzen müssen in pretix vorhanden sein, wenn die jeweilige Funktion genutzt werden soll:
|
|
60
|
+
|
|
61
|
+
| Interne Referenz | Typische Bedeutung | Pflicht? |
|
|
62
|
+
|------------------|--------------------|----------|
|
|
63
|
+
| `GEBURTSDATUM` | Geburtsdatum der teilnehmenden Person | Ja |
|
|
64
|
+
| `ANDERER_NAME` | Ja/Nein-Frage, ob der Name im Ausweisdokument abweicht | Nur für Sonderlogik |
|
|
65
|
+
| `NACHNAME_AUSWEISDOKUMENT` | Nachname laut Ausweisdokument | Nur wenn `ANDERER_NAME` genutzt wird |
|
|
66
|
+
| `VORNAME_AUSWEISDOKUMENT` | Vorname(n) laut Ausweisdokument | Nur wenn `ANDERER_NAME` genutzt wird |
|
|
67
|
+
|
|
68
|
+
### Wichtig zu den Referenzen
|
|
69
|
+
|
|
70
|
+
- Die internen Referenzen müssen **exakt** mit diesen Bezeichnern übereinstimmen.
|
|
71
|
+
- Groß- und Kleinschreibung ist relevant, wenn der Exporter im Code exakt auf diese Kennungen prüft.
|
|
72
|
+
- Es zählt die **interne Referenz** der Frage, nicht der sichtbare Fragetext.
|
|
73
|
+
- Der sichtbare Fragetitel darf frei formuliert sein, solange die interne Referenz korrekt gesetzt ist.
|
|
74
|
+
|
|
75
|
+
## Installation
|
|
76
|
+
|
|
77
|
+
### 1. Plugin in das pretix-System bringen
|
|
78
|
+
|
|
79
|
+
Das Repository kann lokal installiert oder in ein bestehendes Plugin-Setup eingebunden werden. Typischerweise geschieht das per `pip`:
|
|
80
|
+
|
|
81
|
+
```bash
|
|
82
|
+
pip install -e .
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
Alternativ kann das Plugin auch als normales Python-Paket installiert werden.
|
|
86
|
+
|
|
87
|
+
### 2. pretix neu starten
|
|
88
|
+
|
|
89
|
+
Nach der Installation muss pretix neu gestartet werden, damit die Plugin-Metadaten geladen und die Exporter-Signale registriert werden. pretix lädt Plugins als reguläre Django-App und aktiviert zusätzliche Funktionen über deren App-Konfiguration und Signal-Registrierung.
|
|
90
|
+
|
|
91
|
+
### 3. Plugin aktivieren
|
|
92
|
+
|
|
93
|
+
Anschließend muss das Plugin in pretix für die gewünschte Veranstaltung bzw. den gewünschten Kontext aktiviert werden, damit der Exporter verfügbar ist.
|
|
94
|
+
|
|
95
|
+
## Verwendung im pretix-Backend
|
|
96
|
+
|
|
97
|
+
Nach erfolgreicher Installation und Aktivierung erscheint der Exporter im Export-Bereich der Veranstaltung. Dort kann das gewünschte Dateiformat ausgewählt werden, also CSV oder Excel, und bei Bedarf die Einschränkung auf bezahlte Bestellungen gesetzt werden.
|
|
98
|
+
|
|
99
|
+
Der Export erzeugt anschließend eine Datei mit einer Zeile pro exportierter Bestellposition bzw. teilnehmender Person.
|
|
100
|
+
|
|
101
|
+
## Typische Fehlerquellen
|
|
102
|
+
|
|
103
|
+
### Falsche oder fehlende interne Referenzen
|
|
104
|
+
|
|
105
|
+
Der häufigste Fehler ist, dass die Fragen zwar inhaltlich vorhanden sind, aber die interne Referenz nicht exakt stimmt. Schon kleine Abweichungen wie `Geburtsdatum`, `geburtsdatum` oder `GEB_DATUM` würden dazu führen, dass der Exporter die Daten nicht im erwarteten Feld findet.
|
|
106
|
+
|
|
107
|
+
### Falscher Fragetyp
|
|
108
|
+
|
|
109
|
+
Für `ANDERER_NAME` sollte eine echte Ja/Nein-Frage verwendet werden. Wenn stattdessen ein Freitextfeld oder eine Auswahl mit unerwarteten Werten genutzt wird, kann die Umschaltlogik unzuverlässig werden.
|
|
110
|
+
|
|
111
|
+
### Leere Ausweisdokument-Felder
|
|
112
|
+
|
|
113
|
+
Wenn `ANDERER_NAME` mit Ja beantwortet wird, aber `NACHNAME_AUSWEISDOKUMENT` oder `VORNAME_AUSWEISDOKUMENT` leer bleiben, dann werden entsprechend leere Werte exportiert. Die Validierung dieser Eingaben sollte daher möglichst schon im pretix-Formular sichergestellt werden.
|
|
114
|
+
|
|
115
|
+
### Abweichende Namenskonfiguration in pretix
|
|
116
|
+
|
|
117
|
+
Das Plugin nutzt für den Standardfall die Teilnehmer-Namensdaten aus dem pretix-System. Wenn eine Instanz oder ein Event sehr speziell konfiguriert ist und diese Namensbestandteile nicht wie erwartet pflegt, sollte die Exportlogik an die konkrete pretix-Konfiguration angepasst werden.
|
|
118
|
+
|
|
119
|
+
## Für wen dieses Plugin gedacht ist
|
|
120
|
+
|
|
121
|
+
Das Plugin eignet sich für Organisationen, die aus pretix standardisierte Listen mit personenbezogenen Veranstaltungsdaten exportieren müssen und dabei eine feste Zielstruktur brauchen. Es ist besonders dann sinnvoll, wenn interne Referenzen in Formularen konsequent gepflegt werden und die Exportlogik dauerhaft stabil reproduzierbar sein soll.
|
|
122
|
+
|
|
123
|
+
## Entwicklungshinweise
|
|
124
|
+
|
|
125
|
+
pretix empfiehlt für spezialisierte Datenausgaben den Weg über Exporter-Plugins statt über frei gebaute Einzelviews. Exporter sind in der Plattform bereits dafür vorgesehen, Dateiformate bereitzustellen und zusätzliche Exportoptionen als Formularfelder anzubieten.
|
|
126
|
+
|
|
127
|
+
Das Plugin folgt außerdem dem üblichen pretix-Plugin-Aufbau mit Python-Paket, App-Konfiguration und Registrierung über `entry_points`. Dadurch lässt es sich sauber deployen, versionieren und in bestehende pretix-Setups integrieren.
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
"""
|
|
2
|
+
pretix_bundestag_export
|
|
3
|
+
~~~~~~~~~~~~~~~~~~~~~~~
|
|
4
|
+
CSV- und Excel-Export von Teilnehmerdaten für Bundestagsveranstaltungen.
|
|
5
|
+
"""
|
|
6
|
+
|
|
7
|
+
from .apps import PretixBundestagExportApp
|
|
8
|
+
|
|
9
|
+
default_app_config = "pretix_bundestag_export.apps.PretixBundestagExportApp"
|
|
10
|
+
__version__ = "0.1.1"
|
|
11
|
+
|
|
12
|
+
PretixPluginMeta = PretixBundestagExportApp.PretixPluginMeta
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
"""
|
|
2
|
+
App-Konfiguration für das pretix-Plugin „Datenexport (Bundestag)".
|
|
3
|
+
"""
|
|
4
|
+
|
|
5
|
+
try:
|
|
6
|
+
from pretix.base.plugins import PluginConfig, PLUGIN_LEVEL_ORGANIZER
|
|
7
|
+
except ImportError:
|
|
8
|
+
raise RuntimeError("Bitte pretix 2026.1.0 oder neuer verwenden.")
|
|
9
|
+
|
|
10
|
+
from django.utils.translation import gettext_lazy as _
|
|
11
|
+
|
|
12
|
+
__all__ = ['PretixBundestagExportApp']
|
|
13
|
+
|
|
14
|
+
|
|
15
|
+
class PretixBundestagExportApp(PluginConfig):
|
|
16
|
+
# Muss exakt dem Python-Paketnamen entsprechen.
|
|
17
|
+
name = 'pretix_bundestag_export'
|
|
18
|
+
verbose_name = _('Datenexport (Bundestag)')
|
|
19
|
+
|
|
20
|
+
class PretixPluginMeta:
|
|
21
|
+
name = _('Datenexport (Bundestag)')
|
|
22
|
+
author = 'Die Linke im Bundestag'
|
|
23
|
+
version = '0.1.1'
|
|
24
|
+
# CUSTOMIZATION ist die Standard-Kategorie für Plugins ohne eigene Kategorie.
|
|
25
|
+
# Damit erscheint das Plugin im richtigen Abschnitt der Plugin-Liste.
|
|
26
|
+
category = 'FORMAT'
|
|
27
|
+
# PLUGIN_LEVEL_ORGANIZER: Plugin wird auf Veranstalter-Ebene aktiviert
|
|
28
|
+
# und gilt dann automatisch für alle Veranstaltungen dieses Organizers.
|
|
29
|
+
level = PLUGIN_LEVEL_ORGANIZER
|
|
30
|
+
visible = True
|
|
31
|
+
description = _(
|
|
32
|
+
'Exportiert Teilnehmerdaten einer Veranstaltung als CSV oder Excel '
|
|
33
|
+
'mit Name, Vorname(n) und Geburtsdatum zur Anmeldung im Bundestag.'
|
|
34
|
+
)
|
|
35
|
+
compatibility = 'pretix>=2026.1.0'
|
|
36
|
+
# Kein settings_links-Eintrag nötig, da der Exporter keinen
|
|
37
|
+
# eigenen Einstellungsbereich hat.
|
|
38
|
+
settings_links = []
|
|
39
|
+
|
|
40
|
+
def ready(self):
|
|
41
|
+
"""
|
|
42
|
+
Registriert Signal-Receiver beim App-Start.
|
|
43
|
+
Das importiert signals.py, wodurch der Exporter bei pretix bekannt gemacht wird.
|
|
44
|
+
"""
|
|
45
|
+
from . import signals
|
|
@@ -0,0 +1,327 @@
|
|
|
1
|
+
"""
|
|
2
|
+
Exporter-Implementierung für "Datenexport (Bundestag)".
|
|
3
|
+
|
|
4
|
+
Diese Datei enthält die eigentliche Exportlogik. Sie:
|
|
5
|
+
- sammelt die relevanten Teilnehmerdaten aus Bestellpositionen,
|
|
6
|
+
- liest Antworten auf System- und Zusatzfragen,
|
|
7
|
+
- wendet die Sonderlogik für Ausweisdokument-Namen an,
|
|
8
|
+
- erzeugt CSV oder Excel (.xlsx).
|
|
9
|
+
|
|
10
|
+
Wichtige Annahmen:
|
|
11
|
+
- Der Export läuft auf Event-Ebene.
|
|
12
|
+
- Es werden primär positionsbezogene Daten exportiert.
|
|
13
|
+
- Das Geburtsdatum liegt in der Frage mit interner Referenz GEBURTSDATUM.
|
|
14
|
+
- Wenn ANDERER_NAME == Ja, werden NACHNAME_AUSWEISDOKUMENT und
|
|
15
|
+
VORNAME_AUSWEISDOKUMENT genutzt.
|
|
16
|
+
"""
|
|
17
|
+
|
|
18
|
+
from collections import OrderedDict
|
|
19
|
+
from datetime import date, datetime
|
|
20
|
+
import csv
|
|
21
|
+
import io
|
|
22
|
+
|
|
23
|
+
from django import forms
|
|
24
|
+
from django.utils.translation import gettext_lazy as _
|
|
25
|
+
|
|
26
|
+
from openpyxl import Workbook
|
|
27
|
+
|
|
28
|
+
from pretix.base.exporter import BaseExporter
|
|
29
|
+
from pretix.base.models import OrderPosition, QuestionAnswer
|
|
30
|
+
|
|
31
|
+
|
|
32
|
+
class BundestagDataExporter(BaseExporter):
|
|
33
|
+
"""
|
|
34
|
+
Exporter für Bundestagslisten als CSV oder Excel.
|
|
35
|
+
|
|
36
|
+
pretix instanziiert diese Klasse für ein Event und ruft dann:
|
|
37
|
+
- export_form_fields (Property, gibt Formularfelder zurück)
|
|
38
|
+
- render(form_data) (erzeugt die Datei)
|
|
39
|
+
auf.
|
|
40
|
+
"""
|
|
41
|
+
|
|
42
|
+
# Eindeutiger interner Bezeichner, darf nur Kleinbuchstaben enthalten.
|
|
43
|
+
# Pflichtfeld laut pretix-Dokumentation.
|
|
44
|
+
identifier = 'bundestag_export'
|
|
45
|
+
|
|
46
|
+
# Anzeigename im Export-Dialog von pretix.
|
|
47
|
+
# Pflichtfeld laut pretix-Dokumentation.
|
|
48
|
+
verbose_name = _('Anmeldung (Bundestag)')
|
|
49
|
+
|
|
50
|
+
# Optionale Beschreibung für den Export-Dialog
|
|
51
|
+
description = _(
|
|
52
|
+
'Exportiert Name, Vorname(n) und Geburtsdatum aus Teilnehmerdaten '
|
|
53
|
+
'als CSV oder Excel für die Anmeldung beim Bundestag.'
|
|
54
|
+
)
|
|
55
|
+
|
|
56
|
+
# Optionale Kategorie-Gruppierung im Export-Dialog
|
|
57
|
+
# Kein lazy-translate nötig, da pretix hier einen einfachen String erwartet.
|
|
58
|
+
category = 'Teilnehmerexporte'
|
|
59
|
+
|
|
60
|
+
@property
|
|
61
|
+
def export_form_fields(self):
|
|
62
|
+
"""
|
|
63
|
+
Konfigurationsfelder für den pretix-Exportdialog.
|
|
64
|
+
|
|
65
|
+
Laut pretix-Dokumentation soll diese Property ein OrderedDict
|
|
66
|
+
zurückgeben, damit die Feldreihenfolge stabil bleibt.
|
|
67
|
+
|
|
68
|
+
Wir bieten zwei Optionen an:
|
|
69
|
+
1. Dateiformat: CSV oder XLSX
|
|
70
|
+
2. Nur bezahlte Bestellungen exportieren: Ja/Nein
|
|
71
|
+
"""
|
|
72
|
+
return OrderedDict([
|
|
73
|
+
(
|
|
74
|
+
'format',
|
|
75
|
+
forms.ChoiceField(
|
|
76
|
+
label=_('Dateiformat'),
|
|
77
|
+
choices=(
|
|
78
|
+
('csv', _('CSV-Datei')),
|
|
79
|
+
('xlsx', _('Excel-Datei (.xlsx)')),
|
|
80
|
+
),
|
|
81
|
+
initial='xlsx',
|
|
82
|
+
required=True,
|
|
83
|
+
)
|
|
84
|
+
),
|
|
85
|
+
(
|
|
86
|
+
'paid_only',
|
|
87
|
+
forms.BooleanField(
|
|
88
|
+
label=_('Nur bezahlte Bestellungen exportieren'),
|
|
89
|
+
required=False,
|
|
90
|
+
initial=True,
|
|
91
|
+
)
|
|
92
|
+
),
|
|
93
|
+
])
|
|
94
|
+
|
|
95
|
+
def _get_answers_by_reference(self, position):
|
|
96
|
+
"""
|
|
97
|
+
Liest alle Antworten einer Bestellposition und mappt sie nach
|
|
98
|
+
interner Referenz (question.identifier).
|
|
99
|
+
|
|
100
|
+
Rückgabe: dict[str, str]
|
|
101
|
+
Schlüssel: interne Referenz der Frage (z. B. 'GEBURTSDATUM')
|
|
102
|
+
Wert: gespeicherte Antwort als String
|
|
103
|
+
|
|
104
|
+
Warum diese Hilfsfunktion?
|
|
105
|
+
pretix speichert Fragenantworten in QuestionAnswer-Objekten.
|
|
106
|
+
Für unsere Exportlogik müssen wir schnell auf Antworten per
|
|
107
|
+
interner Referenz zugreifen können.
|
|
108
|
+
"""
|
|
109
|
+
result = {}
|
|
110
|
+
|
|
111
|
+
answers = (
|
|
112
|
+
QuestionAnswer.objects
|
|
113
|
+
.filter(orderposition=position)
|
|
114
|
+
.select_related('question')
|
|
115
|
+
)
|
|
116
|
+
|
|
117
|
+
for answer in answers:
|
|
118
|
+
# Sicherheitscheck: Antwort ohne zugehörige Frage überspringen
|
|
119
|
+
if not answer.question:
|
|
120
|
+
continue
|
|
121
|
+
|
|
122
|
+
identifier = answer.question.identifier
|
|
123
|
+
if not identifier:
|
|
124
|
+
continue
|
|
125
|
+
|
|
126
|
+
# answer.answer enthält den gespeicherten Rohwert als String.
|
|
127
|
+
result[identifier] = answer.answer
|
|
128
|
+
|
|
129
|
+
return result
|
|
130
|
+
|
|
131
|
+
def _is_truthy_yes(self, value):
|
|
132
|
+
"""
|
|
133
|
+
Interpretiert verschiedene mögliche Ja-Werte robust als True.
|
|
134
|
+
|
|
135
|
+
Hintergrund:
|
|
136
|
+
Je nach Fragetyp und pretix-Version kann ein Ja/Nein-Wert als
|
|
137
|
+
True, 'True', 'true', '1', 'yes', 'ja' oder 'on' gespeichert sein.
|
|
138
|
+
"""
|
|
139
|
+
if value is True:
|
|
140
|
+
return True
|
|
141
|
+
if value is None:
|
|
142
|
+
return False
|
|
143
|
+
return str(value).strip().lower() in {'true', '1', 'yes', 'ja', 'on'}
|
|
144
|
+
|
|
145
|
+
def _format_birthdate(self, value):
|
|
146
|
+
"""
|
|
147
|
+
Formatiert einen Datumswert robust als 'TT.MM.JJJJ'.
|
|
148
|
+
|
|
149
|
+
Unterstützte Eingaben:
|
|
150
|
+
- datetime.date
|
|
151
|
+
- datetime.datetime
|
|
152
|
+
- ISO-String wie '2026-05-29'
|
|
153
|
+
- bereits formatiertes deutsches Datum
|
|
154
|
+
|
|
155
|
+
Wenn kein gültiges Datum erkannt wird, wird der Ursprungswert als
|
|
156
|
+
String zurückgegeben, damit keine Information verloren geht.
|
|
157
|
+
"""
|
|
158
|
+
if not value:
|
|
159
|
+
return ''
|
|
160
|
+
|
|
161
|
+
if isinstance(value, datetime):
|
|
162
|
+
return value.strftime('%d.%m.%Y')
|
|
163
|
+
|
|
164
|
+
if isinstance(value, date):
|
|
165
|
+
return value.strftime('%d.%m.%Y')
|
|
166
|
+
|
|
167
|
+
value_str = str(value).strip()
|
|
168
|
+
|
|
169
|
+
# Bekannte Datumsformate probieren: ISO, Deutsch, ISO mit Uhrzeit
|
|
170
|
+
for fmt in ('%Y-%m-%d', '%d.%m.%Y', '%Y-%m-%dT%H:%M:%S'):
|
|
171
|
+
try:
|
|
172
|
+
parsed = datetime.strptime(value_str, fmt)
|
|
173
|
+
return parsed.strftime('%d.%m.%Y')
|
|
174
|
+
except ValueError:
|
|
175
|
+
pass
|
|
176
|
+
|
|
177
|
+
# Unbekanntes Format: Originalwert zurückgeben, damit nichts verloren geht.
|
|
178
|
+
return value_str
|
|
179
|
+
|
|
180
|
+
def _get_export_rows(self, paid_only=False):
|
|
181
|
+
"""
|
|
182
|
+
Baut die eigentlichen Exportzeilen auf.
|
|
183
|
+
|
|
184
|
+
Jede Zeile ist ein Dictionary mit den Spalten:
|
|
185
|
+
- Name
|
|
186
|
+
- Vorname(n)
|
|
187
|
+
- Geburtsdatum TT.MM.JJJJ
|
|
188
|
+
|
|
189
|
+
Logik:
|
|
190
|
+
1. Vorname/Nachname kommen aus attendee_name_parts (JSONField, dict).
|
|
191
|
+
2. Falls ANDERER_NAME == Ja, werden stattdessen die Werte aus
|
|
192
|
+
NACHNAME_AUSWEISDOKUMENT und VORNAME_AUSWEISDOKUMENT genutzt.
|
|
193
|
+
3. Das Geburtsdatum wird aus GEBURTSDATUM gelesen und formatiert.
|
|
194
|
+
"""
|
|
195
|
+
positions = (
|
|
196
|
+
OrderPosition.objects
|
|
197
|
+
.filter(order__event=self.event)
|
|
198
|
+
# WICHTIG: attendee_name_parts ist ein JSONField, kein ForeignKey!
|
|
199
|
+
# Es darf NICHT in select_related stehen – das würde einen
|
|
200
|
+
# FieldError auslösen. JSONFields werden direkt mit dem
|
|
201
|
+
# Datensatz geladen und brauchen kein select_related.
|
|
202
|
+
.select_related('order', 'item')
|
|
203
|
+
.order_by('order__code', 'positionid')
|
|
204
|
+
)
|
|
205
|
+
|
|
206
|
+
# Optional nur bezahlte Bestellungen exportieren
|
|
207
|
+
if paid_only:
|
|
208
|
+
positions = positions.filter(order__status='p')
|
|
209
|
+
|
|
210
|
+
rows = []
|
|
211
|
+
|
|
212
|
+
for position in positions:
|
|
213
|
+
answers = self._get_answers_by_reference(position)
|
|
214
|
+
|
|
215
|
+
# Standardwerte aus dem Teilnehmernamen.
|
|
216
|
+
# attendee_name_parts ist ein JSONField und liefert ein dict,
|
|
217
|
+
# KEIN Objekt mit Attributen! Deshalb .get() statt Punkt-Notation.
|
|
218
|
+
# Beispiel-Inhalt: {'given_name': 'Max', 'family_name': 'Mustermann'}
|
|
219
|
+
name_parts = position.attendee_name_parts or {}
|
|
220
|
+
first_name = name_parts.get('given_name', '') or ''
|
|
221
|
+
last_name = name_parts.get('family_name', '') or ''
|
|
222
|
+
|
|
223
|
+
# Sonderlogik: Wenn ANDERER_NAME == Ja, Ausweisdaten verwenden
|
|
224
|
+
use_document_name = self._is_truthy_yes(answers.get('ANDERER_NAME'))
|
|
225
|
+
|
|
226
|
+
if use_document_name:
|
|
227
|
+
last_name = (answers.get('NACHNAME_AUSWEISDOKUMENT') or '').strip()
|
|
228
|
+
first_name = (answers.get('VORNAME_AUSWEISDOKUMENT') or '').strip()
|
|
229
|
+
|
|
230
|
+
birthdate = self._format_birthdate(answers.get('GEBURTSDATUM'))
|
|
231
|
+
|
|
232
|
+
rows.append({
|
|
233
|
+
'Name': last_name,
|
|
234
|
+
'Vorname(n)': first_name,
|
|
235
|
+
'Geburtsdatum TT.MM.JJJJ': birthdate,
|
|
236
|
+
})
|
|
237
|
+
|
|
238
|
+
return rows
|
|
239
|
+
|
|
240
|
+
def _render_csv(self, rows):
|
|
241
|
+
"""
|
|
242
|
+
Erzeugt den CSV-Inhalt als Bytes.
|
|
243
|
+
|
|
244
|
+
Wir verwenden ein Semikolon als Trennzeichen, da das im deutschen
|
|
245
|
+
Excel-Umfeld meist kompatibler ist als ein Komma.
|
|
246
|
+
|
|
247
|
+
UTF-8 mit BOM (utf-8-sig) sorgt dafür, dass Excel die Datei
|
|
248
|
+
ohne Zeichensatz-Probleme öffnen kann.
|
|
249
|
+
"""
|
|
250
|
+
output = io.StringIO()
|
|
251
|
+
writer = csv.DictWriter(
|
|
252
|
+
output,
|
|
253
|
+
fieldnames=['Name', 'Vorname(n)', 'Geburtsdatum TT.MM.JJJJ'],
|
|
254
|
+
delimiter=';'
|
|
255
|
+
)
|
|
256
|
+
|
|
257
|
+
writer.writeheader()
|
|
258
|
+
for row in rows:
|
|
259
|
+
writer.writerow(row)
|
|
260
|
+
|
|
261
|
+
return output.getvalue().encode('utf-8-sig')
|
|
262
|
+
|
|
263
|
+
def _render_xlsx(self, rows):
|
|
264
|
+
"""
|
|
265
|
+
Erzeugt den Excel-Inhalt als .xlsx-Datei im Speicher.
|
|
266
|
+
|
|
267
|
+
openpyxl schreibt die Arbeitsmappe in einen BytesIO-Puffer,
|
|
268
|
+
der anschließend als Bytes zurückgegeben wird.
|
|
269
|
+
"""
|
|
270
|
+
wb = Workbook()
|
|
271
|
+
ws = wb.active
|
|
272
|
+
ws.title = 'Bundestag-Export'
|
|
273
|
+
|
|
274
|
+
headers = ['Name', 'Vorname(n)', 'Geburtsdatum TT.MM.JJJJ']
|
|
275
|
+
ws.append(headers)
|
|
276
|
+
|
|
277
|
+
for row in rows:
|
|
278
|
+
ws.append([
|
|
279
|
+
row['Name'],
|
|
280
|
+
row['Vorname(n)'],
|
|
281
|
+
row['Geburtsdatum TT.MM.JJJJ'],
|
|
282
|
+
])
|
|
283
|
+
|
|
284
|
+
# Sinnvolle Spaltenbreiten für bessere Lesbarkeit
|
|
285
|
+
ws.column_dimensions['A'].width = 25
|
|
286
|
+
ws.column_dimensions['B'].width = 35
|
|
287
|
+
ws.column_dimensions['C'].width = 20
|
|
288
|
+
|
|
289
|
+
bio = io.BytesIO()
|
|
290
|
+
wb.save(bio)
|
|
291
|
+
return bio.getvalue()
|
|
292
|
+
|
|
293
|
+
def render(self, form_data, output_file=None):
|
|
294
|
+
"""
|
|
295
|
+
Rendert die Exportdatei.
|
|
296
|
+
|
|
297
|
+
Laut pretix-Dokumentation muss render() ein Tuple zurückgeben:
|
|
298
|
+
(dateiname: str, mime_type: str, inhalt: bytes)
|
|
299
|
+
|
|
300
|
+
Optional kann output_file als Parameter akzeptiert werden.
|
|
301
|
+
In diesem Fall wird der Inhalt in das übergebene File-Handle
|
|
302
|
+
geschrieben und None als drittes Element zurückgegeben.
|
|
303
|
+
|
|
304
|
+
Pflichtmethode laut pretix-Dokumentation.
|
|
305
|
+
"""
|
|
306
|
+
fmt = form_data.get('format', 'xlsx')
|
|
307
|
+
paid_only = bool(form_data.get('paid_only'))
|
|
308
|
+
|
|
309
|
+
rows = self._get_export_rows(paid_only=paid_only)
|
|
310
|
+
|
|
311
|
+
# Event-Slug als Dateiname-Prefix für eindeutige Benennung
|
|
312
|
+
event_slug = self.event.slug if self.event else 'export'
|
|
313
|
+
|
|
314
|
+
if fmt == 'csv':
|
|
315
|
+
content = self._render_csv(rows)
|
|
316
|
+
filename = f'{event_slug}-bundestag-export.csv'
|
|
317
|
+
mimetype = 'text/csv'
|
|
318
|
+
else:
|
|
319
|
+
content = self._render_xlsx(rows)
|
|
320
|
+
filename = f'{event_slug}-bundestag-export.xlsx'
|
|
321
|
+
mimetype = 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'
|
|
322
|
+
|
|
323
|
+
if output_file is not None:
|
|
324
|
+
output_file.write(content)
|
|
325
|
+
return filename, mimetype, None
|
|
326
|
+
|
|
327
|
+
return filename, mimetype, content
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
"""
|
|
2
|
+
Signal-Registrierung für den Exporter.
|
|
3
|
+
|
|
4
|
+
pretix nutzt zwei verschiedene Signale für Exporter:
|
|
5
|
+
|
|
6
|
+
1. register_data_exporters
|
|
7
|
+
→ Exporter erscheint unter Veranstaltung → Bestellungen → Export
|
|
8
|
+
→ Wird pro Event aufgerufen (sender = Event)
|
|
9
|
+
|
|
10
|
+
2. register_multievent_data_exporters
|
|
11
|
+
→ Exporter erscheint auf Organizer-Ebene für mehrere Events gleichzeitig
|
|
12
|
+
→ Optional, falls veranstaltungsübergreifender Export gewünscht
|
|
13
|
+
|
|
14
|
+
Laut pretix-Dokumentation müssen beide Signale registriert werden,
|
|
15
|
+
wenn der Exporter sowohl auf Event- als auch auf Organizer-Ebene
|
|
16
|
+
verfügbar sein soll.
|
|
17
|
+
"""
|
|
18
|
+
|
|
19
|
+
from django.dispatch import receiver
|
|
20
|
+
from pretix.base.signals import register_data_exporters
|
|
21
|
+
|
|
22
|
+
|
|
23
|
+
# Signal 1: Event-Ebene
|
|
24
|
+
# Der Exporter erscheint unter Veranstaltung → Bestellungen → Export,
|
|
25
|
+
# sobald das Plugin für diese Veranstaltung aktiviert ist.
|
|
26
|
+
@receiver(register_data_exporters, dispatch_uid="pretix_bundestag_exporter_event")
|
|
27
|
+
def register_exporter(sender, **kwargs):
|
|
28
|
+
"""
|
|
29
|
+
Registriert den Exporter für event-spezifische Exporte.
|
|
30
|
+
sender ist hier die jeweilige Event-Instanz.
|
|
31
|
+
"""
|
|
32
|
+
from .exporter import BundestagDataExporter
|
|
33
|
+
return BundestagDataExporter
|
|
@@ -0,0 +1,171 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: pretix-bundestag-export
|
|
3
|
+
Version: 0.1.1
|
|
4
|
+
Summary: pretix-Plugin für den Export von Teilnehmerdaten zur Anmeldung im Bundestag
|
|
5
|
+
Author-email: Die Linke im Bundestag <digitalisierung@dielinkebt.de>
|
|
6
|
+
License: MIT License
|
|
7
|
+
|
|
8
|
+
Copyright (c) 2026 Die Linke im Bundestag
|
|
9
|
+
|
|
10
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
11
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
12
|
+
in the Software without restriction, including without limitation the rights
|
|
13
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
14
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
15
|
+
furnished to do so, subject to the following conditions:
|
|
16
|
+
|
|
17
|
+
The above copyright notice and this permission notice shall be included in all
|
|
18
|
+
copies or substantial portions of the Software.
|
|
19
|
+
|
|
20
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
21
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
22
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
23
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
24
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
25
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
26
|
+
SOFTWARE.
|
|
27
|
+
|
|
28
|
+
Project-URL: Homepage, https://github.com/dielinkebt/pretix-bundestag-export
|
|
29
|
+
Project-URL: Repository, https://github.com/dielinkebt/pretix-bundestag-export
|
|
30
|
+
Keywords: pretix,plugin,export,bundestag
|
|
31
|
+
Classifier: Development Status :: 4 - Beta
|
|
32
|
+
Classifier: Environment :: Web Environment
|
|
33
|
+
Classifier: Framework :: Django
|
|
34
|
+
Classifier: Intended Audience :: Developers
|
|
35
|
+
Classifier: License :: OSI Approved :: MIT License
|
|
36
|
+
Classifier: Operating System :: OS Independent
|
|
37
|
+
Classifier: Programming Language :: Python :: 3
|
|
38
|
+
Requires-Python: >=3.10
|
|
39
|
+
Description-Content-Type: text/markdown
|
|
40
|
+
License-File: LICENSE
|
|
41
|
+
Requires-Dist: pretix>=2026.1.0
|
|
42
|
+
Requires-Dist: openpyxl>=3.1.0
|
|
43
|
+
Dynamic: license-file
|
|
44
|
+
|
|
45
|
+
# Pretix-Datenexport (Bundestag)
|
|
46
|
+
|
|
47
|
+
Ein [pretix](https://github.com/pretix/pretix)-Plugin für den standardisierten Export von Teilnehmerdaten aus Veranstaltungen als CSV- oder Excel-Datei (`.xlsx`). Das Plugin ist für einen sehr konkreten Anwendungsfall gedacht: den Export einer Teilnehmendenliste in einem vom Bundestag vorgegebenen Format.
|
|
48
|
+
|
|
49
|
+
## Format
|
|
50
|
+
|
|
51
|
+
Das Plugin erzeugt aus einer pretix-Veranstaltung eine strukturierte Liste von Teilnehmenden mit genau den Feldern, die für den vorgesehenen Bundestags-Export benötigt werden. Die Ausgabe kann wahlweise als CSV-Datei oder als Excel-Datei (`.xlsx`) erfolgen.
|
|
52
|
+
|
|
53
|
+
Die exportierten Spalten sind:
|
|
54
|
+
|
|
55
|
+
| Spalte | Inhalt |
|
|
56
|
+
|--------|--------|
|
|
57
|
+
| Name | Nachname der teilnehmenden Person |
|
|
58
|
+
| Vorname(n) | Vorname bzw. Vornamen der teilnehmenden Person |
|
|
59
|
+
| Geburtsdatum TT.MM.JJJJ | Geburtsdatum im Format `dd.mm.YYYY` |
|
|
60
|
+
|
|
61
|
+
## Funktionsweise des Exporters
|
|
62
|
+
|
|
63
|
+
Das Plugin wird in pretix als eigener Exporter registriert. Technisch geschieht das über das Signal `register_data_exporters`; dadurch erscheint der Exporter im Export-Bereich einer Veranstaltung unter "Bestellungen" -> "Export" -> "Teilnehmerexporte" und kann dort wie andere pretix-Exporte ausgewählt werden.
|
|
64
|
+
|
|
65
|
+
Beim Ausführen des Exports durchläuft der Exporter die Bestellpositionen einer Veranstaltung und liest daraus die relevanten Teilnehmerdaten aus. Die Exportlogik kombiniert dabei Systemdaten von pretix, etwa den Teilnehmernamen, mit Antworten auf Fragen, die über ihre **internen Referenzen** identifiziert werden.
|
|
66
|
+
|
|
67
|
+
Der Exporter bietet zwei Ausgabeformate an:
|
|
68
|
+
|
|
69
|
+
- CSV-Datei
|
|
70
|
+
- Excel-Datei (`.xlsx`)
|
|
71
|
+
|
|
72
|
+
Zusätzlich kann optional festgelegt werden, dass nur bezahlte Bestellungen exportiert werden. Diese Art zusätzlicher Exportparameter ist in pretix ausdrücklich über Formularfelder des Exporters vorgesehen.
|
|
73
|
+
|
|
74
|
+
## Zuordnung der Spalten
|
|
75
|
+
|
|
76
|
+
Die Spalten werden im Normalfall wie folgt befüllt:
|
|
77
|
+
|
|
78
|
+
| Spalte | Datenquelle |
|
|
79
|
+
|--------|-------------|
|
|
80
|
+
| Name | Nachname Teilnehmer*in, aus den pretix-Systemdaten zum Teilnehmernamen |
|
|
81
|
+
| Vorname(n) | Vorname Teilnehmer*in, aus den pretix-Systemdaten zum Teilnehmernamen |
|
|
82
|
+
| Geburtsdatum TT.MM.JJJJ | Antwort auf die Frage mit interner Referenz `GEBURTSDATUM` |
|
|
83
|
+
|
|
84
|
+
Das Geburtsdatum wird im Export immer in das Format `dd.mm.YYYY` umgewandelt. Wenn pretix intern bereits ein Datum speichert oder ein ISO-Datumsformat wie `YYYY-MM-DD` vorliegt, wird dieses Format sauber konvertiert. Liegt stattdessen bereits ein korrekt formatiertes Datum als Text vor, wird dieser Wert übernommen.
|
|
85
|
+
|
|
86
|
+
## Sonderlogik: abweichender Name laut Ausweisdokument
|
|
87
|
+
|
|
88
|
+
Das Plugin enthält eine spezielle Umschaltlogik für den Fall, dass der im System erfasste Name nicht mit dem amtlichen Ausweisdokument übereinstimmt.
|
|
89
|
+
|
|
90
|
+
Wenn die Frage "Der Name in meinem amtlichen Ausweisdokument unterscheidet sich vom angegebenen Namen." mit der internen Referenz `ANDERER_NAME` existiert und mit **Ja** beantwortet wurde, werden die Spalten **Name** und **Vorname(n)** nicht aus dem normalen Teilnehmernamen befüllt, sondern aus zwei anderen Fragen:
|
|
91
|
+
|
|
92
|
+
| Spalte | Datenquelle bei `ANDERER_NAME = Ja` |
|
|
93
|
+
|--------|------------------------------------|
|
|
94
|
+
| Name | `NACHNAME_AUSWEISDOKUMENT` |
|
|
95
|
+
| Vorname(n) | `VORNAME_AUSWEISDOKUMENT` |
|
|
96
|
+
|
|
97
|
+
Die Logik ist also:
|
|
98
|
+
|
|
99
|
+
Damit der Export korrekt funktioniert, müssen die internen Referenzen exakt so geschrieben sein wie unten beschrieben.
|
|
100
|
+
|
|
101
|
+
## Erforderliche interne Referenzen
|
|
102
|
+
|
|
103
|
+
Die folgenden internen Referenzen müssen in pretix vorhanden sein, wenn die jeweilige Funktion genutzt werden soll:
|
|
104
|
+
|
|
105
|
+
| Interne Referenz | Typische Bedeutung | Pflicht? |
|
|
106
|
+
|------------------|--------------------|----------|
|
|
107
|
+
| `GEBURTSDATUM` | Geburtsdatum der teilnehmenden Person | Ja |
|
|
108
|
+
| `ANDERER_NAME` | Ja/Nein-Frage, ob der Name im Ausweisdokument abweicht | Nur für Sonderlogik |
|
|
109
|
+
| `NACHNAME_AUSWEISDOKUMENT` | Nachname laut Ausweisdokument | Nur wenn `ANDERER_NAME` genutzt wird |
|
|
110
|
+
| `VORNAME_AUSWEISDOKUMENT` | Vorname(n) laut Ausweisdokument | Nur wenn `ANDERER_NAME` genutzt wird |
|
|
111
|
+
|
|
112
|
+
### Wichtig zu den Referenzen
|
|
113
|
+
|
|
114
|
+
- Die internen Referenzen müssen **exakt** mit diesen Bezeichnern übereinstimmen.
|
|
115
|
+
- Groß- und Kleinschreibung ist relevant, wenn der Exporter im Code exakt auf diese Kennungen prüft.
|
|
116
|
+
- Es zählt die **interne Referenz** der Frage, nicht der sichtbare Fragetext.
|
|
117
|
+
- Der sichtbare Fragetitel darf frei formuliert sein, solange die interne Referenz korrekt gesetzt ist.
|
|
118
|
+
|
|
119
|
+
## Installation
|
|
120
|
+
|
|
121
|
+
### 1. Plugin in das pretix-System bringen
|
|
122
|
+
|
|
123
|
+
Das Repository kann lokal installiert oder in ein bestehendes Plugin-Setup eingebunden werden. Typischerweise geschieht das per `pip`:
|
|
124
|
+
|
|
125
|
+
```bash
|
|
126
|
+
pip install -e .
|
|
127
|
+
```
|
|
128
|
+
|
|
129
|
+
Alternativ kann das Plugin auch als normales Python-Paket installiert werden.
|
|
130
|
+
|
|
131
|
+
### 2. pretix neu starten
|
|
132
|
+
|
|
133
|
+
Nach der Installation muss pretix neu gestartet werden, damit die Plugin-Metadaten geladen und die Exporter-Signale registriert werden. pretix lädt Plugins als reguläre Django-App und aktiviert zusätzliche Funktionen über deren App-Konfiguration und Signal-Registrierung.
|
|
134
|
+
|
|
135
|
+
### 3. Plugin aktivieren
|
|
136
|
+
|
|
137
|
+
Anschließend muss das Plugin in pretix für die gewünschte Veranstaltung bzw. den gewünschten Kontext aktiviert werden, damit der Exporter verfügbar ist.
|
|
138
|
+
|
|
139
|
+
## Verwendung im pretix-Backend
|
|
140
|
+
|
|
141
|
+
Nach erfolgreicher Installation und Aktivierung erscheint der Exporter im Export-Bereich der Veranstaltung. Dort kann das gewünschte Dateiformat ausgewählt werden, also CSV oder Excel, und bei Bedarf die Einschränkung auf bezahlte Bestellungen gesetzt werden.
|
|
142
|
+
|
|
143
|
+
Der Export erzeugt anschließend eine Datei mit einer Zeile pro exportierter Bestellposition bzw. teilnehmender Person.
|
|
144
|
+
|
|
145
|
+
## Typische Fehlerquellen
|
|
146
|
+
|
|
147
|
+
### Falsche oder fehlende interne Referenzen
|
|
148
|
+
|
|
149
|
+
Der häufigste Fehler ist, dass die Fragen zwar inhaltlich vorhanden sind, aber die interne Referenz nicht exakt stimmt. Schon kleine Abweichungen wie `Geburtsdatum`, `geburtsdatum` oder `GEB_DATUM` würden dazu führen, dass der Exporter die Daten nicht im erwarteten Feld findet.
|
|
150
|
+
|
|
151
|
+
### Falscher Fragetyp
|
|
152
|
+
|
|
153
|
+
Für `ANDERER_NAME` sollte eine echte Ja/Nein-Frage verwendet werden. Wenn stattdessen ein Freitextfeld oder eine Auswahl mit unerwarteten Werten genutzt wird, kann die Umschaltlogik unzuverlässig werden.
|
|
154
|
+
|
|
155
|
+
### Leere Ausweisdokument-Felder
|
|
156
|
+
|
|
157
|
+
Wenn `ANDERER_NAME` mit Ja beantwortet wird, aber `NACHNAME_AUSWEISDOKUMENT` oder `VORNAME_AUSWEISDOKUMENT` leer bleiben, dann werden entsprechend leere Werte exportiert. Die Validierung dieser Eingaben sollte daher möglichst schon im pretix-Formular sichergestellt werden.
|
|
158
|
+
|
|
159
|
+
### Abweichende Namenskonfiguration in pretix
|
|
160
|
+
|
|
161
|
+
Das Plugin nutzt für den Standardfall die Teilnehmer-Namensdaten aus dem pretix-System. Wenn eine Instanz oder ein Event sehr speziell konfiguriert ist und diese Namensbestandteile nicht wie erwartet pflegt, sollte die Exportlogik an die konkrete pretix-Konfiguration angepasst werden.
|
|
162
|
+
|
|
163
|
+
## Für wen dieses Plugin gedacht ist
|
|
164
|
+
|
|
165
|
+
Das Plugin eignet sich für Organisationen, die aus pretix standardisierte Listen mit personenbezogenen Veranstaltungsdaten exportieren müssen und dabei eine feste Zielstruktur brauchen. Es ist besonders dann sinnvoll, wenn interne Referenzen in Formularen konsequent gepflegt werden und die Exportlogik dauerhaft stabil reproduzierbar sein soll.
|
|
166
|
+
|
|
167
|
+
## Entwicklungshinweise
|
|
168
|
+
|
|
169
|
+
pretix empfiehlt für spezialisierte Datenausgaben den Weg über Exporter-Plugins statt über frei gebaute Einzelviews. Exporter sind in der Plattform bereits dafür vorgesehen, Dateiformate bereitzustellen und zusätzliche Exportoptionen als Formularfelder anzubieten.
|
|
170
|
+
|
|
171
|
+
Das Plugin folgt außerdem dem üblichen pretix-Plugin-Aufbau mit Python-Paket, App-Konfiguration und Registrierung über `entry_points`. Dadurch lässt es sich sauber deployen, versionieren und in bestehende pretix-Setups integrieren.
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
LICENSE
|
|
2
|
+
README.md
|
|
3
|
+
pyproject.toml
|
|
4
|
+
setup.py
|
|
5
|
+
pretix_bundestag_export/__init__.py
|
|
6
|
+
pretix_bundestag_export/apps.py
|
|
7
|
+
pretix_bundestag_export/exporter.py
|
|
8
|
+
pretix_bundestag_export/signals.py
|
|
9
|
+
pretix_bundestag_export.egg-info/PKG-INFO
|
|
10
|
+
pretix_bundestag_export.egg-info/SOURCES.txt
|
|
11
|
+
pretix_bundestag_export.egg-info/dependency_links.txt
|
|
12
|
+
pretix_bundestag_export.egg-info/entry_points.txt
|
|
13
|
+
pretix_bundestag_export.egg-info/requires.txt
|
|
14
|
+
pretix_bundestag_export.egg-info/top_level.txt
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
pretix_bundestag_export
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
[build-system]
|
|
2
|
+
requires = ["setuptools>=68", "wheel"]
|
|
3
|
+
build-backend = "setuptools.build_meta"
|
|
4
|
+
|
|
5
|
+
[project]
|
|
6
|
+
name = "pretix-bundestag-export"
|
|
7
|
+
dynamic = ["version"]
|
|
8
|
+
description = "pretix-Plugin für den Export von Teilnehmerdaten zur Anmeldung im Bundestag"
|
|
9
|
+
readme = "README.md"
|
|
10
|
+
requires-python = ">=3.10"
|
|
11
|
+
license = { file = "LICENSE" }
|
|
12
|
+
authors = [
|
|
13
|
+
{ name = "Die Linke im Bundestag", email = "digitalisierung@dielinkebt.de" }
|
|
14
|
+
]
|
|
15
|
+
keywords = ["pretix", "plugin", "export", "bundestag"]
|
|
16
|
+
classifiers = [
|
|
17
|
+
"Development Status :: 4 - Beta",
|
|
18
|
+
"Environment :: Web Environment",
|
|
19
|
+
"Framework :: Django",
|
|
20
|
+
"Intended Audience :: Developers",
|
|
21
|
+
"License :: OSI Approved :: MIT License",
|
|
22
|
+
"Operating System :: OS Independent",
|
|
23
|
+
"Programming Language :: Python :: 3",
|
|
24
|
+
]
|
|
25
|
+
dependencies = [
|
|
26
|
+
"pretix>=2026.1.0",
|
|
27
|
+
"openpyxl>=3.1.0",
|
|
28
|
+
]
|
|
29
|
+
|
|
30
|
+
[project.urls]
|
|
31
|
+
Homepage = "https://github.com/dielinkebt/pretix-bundestag-export"
|
|
32
|
+
Repository = "https://github.com/dielinkebt/pretix-bundestag-export"
|
|
33
|
+
|
|
34
|
+
[project.entry-points."pretix.plugin"]
|
|
35
|
+
pretix_bundestag_export = "pretix_bundestag_export:PretixPluginMeta"
|
|
36
|
+
|
|
37
|
+
[tool.setuptools]
|
|
38
|
+
include-package-data = true
|
|
39
|
+
|
|
40
|
+
[tool.setuptools.dynamic]
|
|
41
|
+
version = { attr = "pretix_bundestag_export.__version__" }
|
|
42
|
+
|
|
43
|
+
[tool.setuptools.packages.find]
|
|
44
|
+
include = ["pretix_bundestag_export*"]
|
|
45
|
+
namespaces = false
|