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.
@@ -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,2 @@
1
+ [pretix.plugin]
2
+ pretix_bundestag_export = pretix_bundestag_export:PretixPluginMeta
@@ -0,0 +1,2 @@
1
+ pretix>=2026.1.0
2
+ openpyxl>=3.1.0
@@ -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
@@ -0,0 +1,4 @@
1
+ [egg_info]
2
+ tag_build =
3
+ tag_date = 0
4
+
@@ -0,0 +1,3 @@
1
+ from setuptools import setup
2
+
3
+ setup()