Zum Inhalt springen

Änderungen von Dokument Digitale Mitgliederverwaltung

Zuletzt geändert von Daniel Herrmann am 2026/02/22 21:17
Von Version Icon 36.1 Icon
bearbeitet von Daniel Herrmann
am 2025/08/23 12:04
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version Icon 33.1 Icon
bearbeitet von Daniel Herrmann
am 2025/08/22 18:11
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Icon Seiteneigenschaften
Inhalt
... ... @@ -78,7 +78,7 @@
78 78  )))|=(% scope="col" %)(((
79 79  Prozess heute
80 80  )))|=(% scope="col" %)(((
81 -Notwendige Änderungen
81 +Prozess Zukunft
82 82  )))
83 83  |(((
84 84  Mitgliedsantrag
... ... @@ -92,7 +92,7 @@
92 92  * Nach Eingang: Mitgliederverwaltung prüft den Antrag und genehmigt ihn
93 93  * Mitgliederakte wird angelegt, der Antrag wird in der Akte abgeheftet
94 94  )))|(((
95 -Der Antrag soll komplett **digital unterschrieben** werden. Vorgehen:
95 +Der Antrag kann komplett **digital unterschrieben** werden. Vorgehen:
96 96  
97 97  * Interessent:in füllt den Online-Antrag auf der Homepage aus
98 98  * Nach Bestätigung der E-Mail Adresse wird ein Vorgang zur digitalen Unterschrift ausgelöst
... ... @@ -163,7 +163,11 @@
163 163  Ist ein Blanko-Formular, welches ausgefüllt, eingeworfen und abgeheftet wird.
164 164  Danach wird ein Flag für das jeweilige Mitglied gesetzt, dass die Erklärung abgegeben wurde.
165 165  )))|(((
166 -**Vollständig digital**. Vorstand oder Mitgliederverwaltung löst den Prozess über das Profil des Mitglieds aus (Button auf Homepage), danach digital weiter.
166 +**Vollständig digital**.
167 +
168 +* Vorstand oder Mitgliederverwaltung löst den Prozess über das Profil des Mitglieds aus (Button auf Homepage)
169 +* Mitglied erhält die Aufforderung per Mail das Dokument zu unterschreiben
170 +* Nach Unterschrift wird das Flag automatisch gesetzt und das Dokument wird zu Paperless NGX hochgeladen.
167 167  )))
168 168  |(((
169 169  Übungsleitervertrag
... ... @@ -177,9 +177,12 @@
177 177  * Bestätigung dass der Vertrag vorliegt
178 178  * Ein Flag ob das Mitglied die Übungsleiterpauschale an den Verein spendet oder nicht
179 179  )))|(((
180 -**Vollständig digital**. Vorstand oder Mitgliederverwaltung löst den Prozess über das Profil des Mitglieds aus (Button auf Homepage), danach digital weiter.
184 +**Vollständig digital**.
181 181  
182 -Ein Todo für die Mitgliederverwaltung wird erstellt um zu prüfen, ob das Mitglied die Pauschale spenden möchte oder nicht.
186 +* Vorstand oder Mitgliederverwaltung löst den Prozess über das Profil des Mitglieds aus (Button auf Homepage)
187 +* Mitglied erhält die Aufforderung per Mail das Dokument zu unterschreiben
188 +* Nach Unterschrift wird das erste automatisch gesetzt und das Dokument wird zu Paperless NGX hochgeladen.
189 +* Ein Todo für die Mitgliederverwaltung wird erstellt um zu prüfen, ob das Mitglied die Pauschale spenden möchte oder nicht.
183 183  )))
184 184  |(((
185 185  Nutzungsvereinbarung Schulungsinhalte
... ... @@ -190,7 +190,7 @@
190 190  
191 191  Urheberrecht, Übertragung von Nutzungsrechten sollte in Schriftform erfolgen
192 192  )))|(((
193 -Unverändert, bleibt handschriftlich. Manuell über Dokumentenscanner einscannen und in Paperless dem Mitglied zuweisen.
200 +Unverändert, bleibt handschriftlich. Manuell über Dokumentenscanner Einscannen und in Paperless dem Mitglied zuweisen.
194 194  )))
195 195  |(((
196 196  Bestellung eines Einweisers
... ... @@ -251,7 +251,7 @@
251 251  ** Muss für den Einweisenden eine Auszahlung veranlasst werden?
252 252  * Danach wird der Zettel in die jeweiligen Akten einsortiert.
253 253  )))|(((
254 -Der Einweisungszettel ist das bei weitem komplizierteste Dokument, hierfür wird ein separater Workshop stattfinden. Siehe weiter unten für Details.
261 +\\
255 255  )))
256 256  |(((
257 257  Lagervertrag Kistenlager
... ... @@ -265,7 +265,7 @@
265 265  
266 266  Nach Erfassen kann die Person eine Kiste beantragen, die dann monatliche Kosten auslöst
267 267  )))|(((
268 -**Vollständig digital**, die Papierform entfällt. Self-Service durch Nutzer:in.
275 +\\
269 269  )))
270 270  |(((
271 271  Lagervertrag Projektlager
... ... @@ -279,7 +279,7 @@
279 279  
280 280  Nach Erfassen kann die Person das Projektlager automatisch nutzen.
281 281  )))|(((
282 -**Vollständig digital**, die Papierform entfällt. Self-Service durch Nutzer:in.
289 +\\
283 283  )))
284 284  
285 285  == {{id name="DigitaleMitgliederverwaltung-WorkflowBeschreibung"/}}Workflow Beschreibung ==
... ... @@ -806,226 +806,54 @@
806 806  
807 807  Paperless unterstützt die automatische Zuordnung von Metadaten basierend auf festen Strings. So kann man beispielsweise angeben, dass ein Dokumententyp "Haftungsausschluss" zugewiesen werden soll, wenn der String "Haftungsausschluss" irgendwo im Dokument vorkommt. Dies ist allerdings auf eine korrekte Funktion der Texterkennung angewiesen und funktioniert erfahrungsgemäß nur in manchen Fällen, sodass mindestens eine manuelle Überprüfung trotzdem notwendig kommt. Wenn beispielsweise ein Brief mit dem Satz "ich dachte, ich hätte den Haftungsausschluss bereits abgegeben, könntet ihr dies bitte prüfen" erfasst wird, würde der basierend auf der Regel ebenfalls kategorisiert werden.
808 808  
809 -**Aus diesem Grund wird auf jedes Dokument einen spezieller QR Code aufgedruckt**. Der QR code wird vom Post-Consume Script verwendet um die Metadaten in Paperless zuzuordnen. Weiterhin können Daten übermittelt werden, die dann mittels Webhook an N8n übermittelt werden und dort im Workflow verwendet werden können. Der Aufbau orientiert sich an dem Aufbau eines **JSON Web Tokens (JWT).**
816 +Aus diesem Grund nutzen wir einen speziellen QR Code in einem für den Makerspace spezifischen Format, welches nachstehend detailliert beschrieben wird.
810 810  
811 -=== {{id name="DigitaleMitgliederverwaltung-QRcodeerzeugen"/}}(% style="color:var(--ds-text-accent-purple-bolder,#352c63);" %)**QR **(% style="color: rgb(53, 44, 99)" %)code erzeugen(%%) ===
818 +{{code language="json"}}
819 +{
820 + "payload": {
821 +        "timestamp": "YYYY-MM-DDTHH:mm:ss",
822 + "uuid": "260171c3-c71c-4da2-b13e-bf1386fe9eac",
823 + "correspondent": "Daniel Herrmann (#250)",
824 + "type": "mksp-doc-sepamandat",
825 + "tags": [
826 + "tag1",
827 + "tag2"
828 + ],
829 +"storage_path": "Mitgliederverwaltung"
830 + },
831 + "sig": "signature over the entire payload block"
832 +}
833 +{{/code}}
812 812  
813 -(% style="color: rgb(53,44,99);" %)Der Prozess zur Erzeugung eines QR Codes ist wie folgt:
835 +Die beiden Einträge **payload** und **sig** sind **Pflichtfelder**. Innerhalb der Payload müssen der **timestamp** **und die UUID** **vorhanden** sein, alle anderen Felder sind optional, jedoch muss mindestens eins angegeben werden. Der QR Code kann dann - insbesondere bei der Digitalen Unterschrift oder bei Workflows, wo die Formulare ohnehin on demand erzeugt werden bereits mit allen Daten bestückt werden. In Paperless gibt es dann ein Postconsume Script, welches den QR Code ausliest, die Signatur prüft und - falls die Signatur korrekt ist - automatisch die Meta-Daten übernimmt.
814 814  
815 -* **Payload (Daten) festlegen**. Einige Werte sind verpflichtend, andere können nach Bedarf optional hinzugefügt werden.
816 -* JWT erzeugen und signieren. der JWT besteht aus drei Teilen:
817 -** **Header**: **alg** (Algorithmus) und **typ** (JWT) sind verpflichtend. Zusätzlich fügen wir einen Timestamp, eine eindeutige ID und eine Gültigkeitsdauer hinzu.
818 -** **Body**: beinhaltet die eigentlichen Daten.
819 -** **Signature**: Mit Hilfe eines Secrets und wird die Signatur erzeugt und automatisch angehängt.
820 -* QR code erzeugen: ein JWT ist per Definition URL safe und kann daher einfach in ein QR code umgewandelt werden.
837 +=== {{id name="DigitaleMitgliederverwaltung-Signatur"/}}Signatur ===
821 821  
822 -=== {{id name="DigitaleMitgliederverwaltung-Header"/}}Header ===
839 +Die Signatur wird kryptographisch mit Hilfe asymmetrischen Verschlüsselung erzeugt. Wir erzeugen ein RSA 2048 Key Pair. Der öffentliche Schlüssel steht Paperless zur Verfügung, sodass Paperless die Signaturen verifizieren kann. Der private Teil des Schlüssels wird von den Makerspace-Systemem verwendet, welche die Formulare erzeugen. Im Detail:
823 823  
824 -Der Header enthält wichtige Meta-Daten:
841 +* **Key-Pair**: 2048 bit Schlüssellänge, RSA, 65537 Exponent
842 +* **Signatur**: SHA256 Signatur, PKCS1v15 Padding
843 +* (((
844 +**Payload**: Als Payload wird nur der Inhalt der Payload verwendet, als **JSON String ohne Whitespaces, byte encoded in UTF-8.** Das oben genannte Beispiel würde die Signatur über den folgenden String erstellen:
845 +\\
825 825  
826 -|=(% scope="col" %)(((
827 -Claim
828 -)))|=(% scope="col" %)(((
829 -Type
830 -)))|=(% scope="col" %)(((
831 -Pflicht
832 -)))|=(% scope="col" %)(((
833 -Beschreibung
834 -)))
835 -|(((
836 -time
837 -)))|(((
838 -Timestamp
839 -Format: YYYY-MM-DDTHH:mm:ss
840 -)))|(((
841 -✅️
842 -)))|(((
843 -Timestamp an dem das Dokument und der QR Code erzeugt wurden
844 -)))
845 -|(((
846 -id
847 -)))|(((
848 -UUID4
849 -)))|(((
850 -✅️
851 -)))|(((
852 -Eindeutige ID dieses Dokuments
853 -)))
854 -|(((
855 -exp
856 -)))|(((
857 -Zahl
858 -)))|(((
859 -✅️
860 -)))|(((
861 -Dauer der Gültigkeit gemessen in Sekunden, beispielsweise 1209600 für 2 Wochen.
862 -)))
847 +{{code language="json"}}
848 +{"payload":{"correspondent":"Daniel Herrmann (#250)","type":"SEPA Mandat","tags":["tag1","tag2"]},"timestamp":"YYYY-MM-DDTHH:mm:ss","sig":"this-would-be-the-signature-appended-to-the-data"}
849 +{{/code}}
863 863  
864 -=== {{id name="DigitaleMitgliederverwaltung-Body"/}}Body ===
865 865  
866 -Die folgenden Claims sind im Body verfügbar:
852 +Als Referenz, die in Python wäre der Input der Signatur:
853 +\\
867 867  
868 -(% class="" %)|=(((
869 -Claim
870 -)))|=(((
871 -Type
872 -)))|=(((
873 -Pflicht
874 -)))|=(((
875 -Beschreibung
876 -)))
877 -(% class="" %)|(((
878 -(% class="code" %)
879 -(((
880 -typ
881 -)))
882 -)))|(((
883 -String
884 -)))|(((
885 -✅️
886 -)))|(((
887 -Typ des Dokuments basierend auf der unten definierten Liste.
888 -)))
889 -(% class="" %)|(((
890 -(% class="code" %)
891 -(((
892 -cor
893 -)))
894 -)))|(((
895 -String
896 -)))|(((
897 -❌️
898 -)))|(((
899 -Optional: Name des Korrespondenten, dem das Dokument zugeordnet werden soll
900 -)))
901 -(% class="" %)|(((
902 -tags
903 -)))|(((
904 -List[String]
905 -)))|(((
906 -❌️
907 -)))|(((
908 -Liste an Tags, die dem Dokument zugeordnet werden soll
909 -)))
910 -|(((
911 -spth
912 -)))|(((
913 -String
914 -)))|(((
915 -❌️
916 -)))|(((
917 -Storage Path, das dem Dokument zugeordnet werden soll
918 -)))
919 -|(((
920 -opt
921 -)))|(((
922 -dict
923 -)))|(((
924 -❌️
925 -)))|(((
926 -Optionale Attribute, die mit eincodiert werden und dem N8n Workflow übergeben werden.
927 -)))
855 +{{code language="python"}}
856 +import json
928 928  
929 -=== {{id name="DigitaleMitgliederverwaltung-Footer"/}}Footer ===
930 -
931 -Der Footer wird automatisch erzeugt und erhält eine Signatur über den Header und den Body, basierend auf einem Algorithmus und einer Signatur.
932 -
933 -{{confluence_tip title="Algorithmus"}}
934 -Von den meisten Libraries werden symmetrische und asymmetrische Signaturen unterstützt. Die Verwendung eines symmetrischen Algorithmus ist für uns einfacher.
935 -
936 -Für diesen Anwendungsfall nutzen wir (% style="text-decoration: none;color:var(--ds-text,#333333);" %)**HS256** (HMAC mit SHA-256 Algorithmus).
937 -{{/confluence_tip}}
938 -
939 -=== {{id name="DigitaleMitgliederverwaltung-AuswahlderLibrary"/}}Auswahl der Library ===
940 -
941 -Die Implementierung für die Erzeugung und das Validieren erfolgt in Python. Dies hat den Hintergrund, dass sowohl unser Backend als auch Paperless NGX (und damit das Post-Consumption Script) in Python implementiert ist. Es gibt verschiedene Libraries, die betrachtet wurden:
942 -
943 -|=(% scope="col" %)(((
944 -Name
945 -)))|=(% scope="col" %)(((
946 -CVE
947 -)))|=(% scope="col" %)(((
948 -Github
949 -)))|=(% scope="col" %)(((
950 -GH⭐
951 -)))|=(% scope="col" %)(((
952 -Letztes Release
953 -)))|=(% scope="col" %)(((
954 -Offene Issues
955 -)))|=(% scope="col" %)(((
956 -Dokumentation
957 -)))|=(% scope="col" %)(((
958 -Qualität Dokumentation
959 -)))|=(% scope="col" %)(((
960 -In Backend vorhanden?
961 -)))|=(% scope="col" %)(((
962 -In Paperless vorhanden?
858 +input_data = {'payload': {'correspondent': 'Daniel Herrmann (#250)', 'type': 'SEPA Mandat', 'tags': ['tag1', 'tag2']}, 'timestamp': 'YYYY-MM-DDTHH:mm:ss', 'sig': 'this-would-be-the-signature-appended-to-the-data'}
859 +signature_data = json.dumps(input_data, separators=(',', ':')).encode('utf-8')
860 +{{/code}}
963 963  )))
964 -|(((
965 -python-jose
966 -)))|(((
967 -3/0
968 -)))|(((
969 -[[https:~~/~~/github.com/mpdavis/python-jose>>url:https://github.com/mpdavis/python-jose||shape="rect"]]
970 -)))|(((
971 -1.7k
972 -)))|(((
973 -28.05.2025
974 -)))|(((
975 -83
976 -)))|(((
977 -[[https:~~/~~/python-jose.readthedocs.io/en/latest/>>url:https://python-jose.readthedocs.io/en/latest/||shape="rect"]]
978 -)))|(((
979 -⛔ Wenige Bespiele, API Dokumentation fehlt komplett
980 -)))|(((
981 -❌️
982 -)))|(((
983 -❌️
984 -)))
985 -|(((
986 -pyJWT
987 -)))|(((
988 -4/0
989 -)))|(((
990 -[[https:~~/~~/github.com/jpadilla/pyjwt>>url:https://github.com/jpadilla/pyjwt||shape="rect"]]
991 -)))|(((
992 -5.4k
993 -)))|(((
994 -28.11.2024
995 -)))|(((
996 -30
997 -)))|(((
998 -[[https:~~/~~/pyjwt.readthedocs.io>>url:https://pyjwt.readthedocs.io||shape="rect"]]
999 -)))|(((
1000 -➕️ Gute Dokumentation, API, Beispiele, Changelog
1001 -)))|(((
1002 -✅️ 2.10.1
1003 -)))|(((
1004 -✅️ 2.10.1
1005 -)))
1006 -|(((
1007 -JWCrypto
1008 -)))|(((
1009 -5/0
1010 -)))|(((
1011 -[[https:~~/~~/github.com/latchset/jwcrypto>>url:https://github.com/latchset/jwcrypto||shape="rect"]]
1012 -)))|(((
1013 -465
1014 -)))|(((
1015 -06.03.2024
1016 -)))|(((
1017 -8
1018 -)))|(((
1019 -[[https:~~/~~/jwcrypto.readthedocs.io>>url:https://jwcrypto.readthedocs.io||shape="rect"]]
1020 -)))|(((
1021 -➕️ API Doc, einige Beispiele
1022 -)))|(((
1023 -✅️ 1.5.6
1024 -)))|(((
1025 -❌️
1026 -)))
1027 1027  
1028 -Unsere bevorzugte Library ist **pyjwt**. Diese ist auch in **paperless nativ vorhanden**, sodass wir uns für die Implementierung mittels **pyjwt** entschieden haben.
863 +\\
1029 1029  
1030 1030  == {{id name="DigitaleMitgliederverwaltung-TechnischesSetup"/}}Technisches Setup ==
1031 1031  
... ... @@ -1035,7 +1035,46 @@
1035 1035  Tag: owner = grp owner, view = jeweilige Gruppe, edit = it admin
1036 1036  Doc Type: owner = grp owner, view = jeweilige Gruppe, edit = it admin
1037 1037  
1038 -= {{id name="DigitaleMitgliederverwaltung-OffenePunkte"/}}Offene Punkte =
873 +TODO
1039 1039  
875 +\\
876 +
877 +=== {{id name="DigitaleMitgliederverwaltung-AusFace2Faceam20.8(DH,YS)"/}}Aus Face 2 Face am 20.8  (DH,YS) ===
878 +
879 +* Schritt 1: Einweisungszettel erzeugen 
880 +** Checkliste in Directus hinterlegen, eine pro Einweisung
881 +** N8n Workflow, welches die Liste aus Directus herunterlädt und Template mit Puppetteer Script Node erzeugen
882 +** Aus diesem Template dann ein DocuSeal Template erstellen
883 +* Schritt 2: Zettel für Einweisungen generieren
884 +** Tablet für Einweiser im makerspace
885 +** Authentifizierung über Token an der Freigabebox
886 +*** Neue Maschine, User schaltet die Maschine "Tablet" frei
887 +*** Datenbank erzeugt JWT und signiert es mit einem RSA Priv Key
888 +*** Wird als Payload in der MQTT unlock message mitgeschickt
889 +** Tablet nutzt dieses Token für API Requests gegen Homepage Backend
890 +** Backend wird um weitere Middleware angepasst, die dieses Token für manche Endpoints akzeptiert
891 +** Einweiser:in bekommt aktive Einweisung angezeigt und kann Teilnehmer Entfernern (no-show) oder hinzufügen (spontan)
892 +*** Option eine Einweisung ohne Rechnungsstellung vorzunehmen
893 +** PDFs werden automatisch ausgedruckt
894 +*** Tablet triggert einen Backend endpoint
895 +**** übergibt teilnehmer als parameter (auth über token) und
896 +**** erzeugt die entsprechenden PDFs in DocuSeal
897 +**** Gibt PDF als Return
898 +*** Tablet kann PDF über Netzwerk print drucken
899 +* Schritt 3: Einweisungen erfassen
900 +** QR code wird in Schritt 2 aufgedruckt und enthält:
901 +*** Einweisung
902 +*** Datum
903 +*** Einweiser
904 +*** Teilnehmer
905 +*** Flag Rechnung
906 +** Dokument wird über ScanSnap eingescannt und automatisch an paperless übergeben
907 +** Paperless Post Consume erkennt den QR Code, validiert ihn und löst über einen Webook einen Flow in N8n aus
908 +** N8n erstellt dann einen temporären Eintrag im Backend, ähnlich dem der heute bei "Einweisung erfassen" sichtbar ist
909 +** Die Mitgliederverwaltung hat dann x Tage Zeit, die Einträge zu korrigieren und zu prüfen (beispielsweise ob Voraussetzungen erfüllt sind)
910 +** Danach werden alle Schritte wie bisher ausgelöst (Berechtigung, Rechnung, Auszahlung an Einweiser, E-Mail Bestätigung, ...)
911 +
912 +TODO:
913 +
1040 1040  * Docuseal Logging + Monitoring
1041 1041  * N8n Error Handling
Icon Confluence.Code.ConfluencePageClass[0]
Id
... ... @@ -1,1 +1,1 @@
1 -202867288
1 +202867277
URL
... ... @@ -1,1 +1,1 @@
1 -https://wiki.makerspace-darmstadt.de/spaces/PROJ/pages/202867288/Digitale Mitgliederverwaltung
1 +https://wiki.makerspace-darmstadt.de/spaces/PROJ/pages/202867277/Digitale Mitgliederverwaltung