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 38.1 Icon
bearbeitet von Daniel Herrmann
am 2025/08/23 16:13
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Icon Seiteneigenschaften
Inhalt
... ... @@ -808,9 +808,9 @@
808 808  
809 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).**
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(%%) ===
811 +=== {{id name="DigitaleMitgliederverwaltung-Barcodeerzeugen"/}}(% style="color:var(--ds-text-accent-purple-bolder,#352c63);" %)Barcode erzeugen(%%) ===
812 812  
813 -(% style="color: rgb(53,44,99);" %)Der Prozess zur Erzeugung eines QR Codes ist wie folgt:
813 +(% style="color:var(--ds-text-accent-purple-bolder,#352c63);" %)Der Prozess zur Erzeugung eines QR Codes ist wie folgt:
814 814  
815 815  * **Payload (Daten) festlegen**. Einige Werte sind verpflichtend, andere können nach Bedarf optional hinzugefügt werden.
816 816  * JWT erzeugen und signieren. der JWT besteht aus drei Teilen:
... ... @@ -817,39 +817,42 @@
817 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 818  ** **Body**: beinhaltet die eigentlichen Daten.
819 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.
820 +* PDF417 code erzeugen: ein JWT ist per Definition URL safe und kann daher einfach in ein QR code umgewandelt werden.
821 821  
822 822  === {{id name="DigitaleMitgliederverwaltung-Header"/}}Header ===
823 823  
824 -Der Header enthält wichtige Meta-Daten:
824 +Der Header enthält wichtige Meta-Daten, diese werden von der JWT Library automatisch erzeugt und beschreiben in der Regel den verwendeten Key-Typ.
825 825  
826 -|=(% scope="col" %)(((
826 +=== {{id name="DigitaleMitgliederverwaltung-Body"/}}Body ===
827 +
828 +Die folgenden Claims sind im Body verfügbar:
829 +
830 +(% class="" %)|=(((
827 827  Claim
828 -)))|=(% scope="col" %)(((
832 +)))|=(((
829 829  Type
830 -)))|=(% scope="col" %)(((
834 +)))|=(((
831 831  Pflicht
832 -)))|=(% scope="col" %)(((
836 +)))|=(((
833 833  Beschreibung
834 834  )))
835 835  |(((
836 -time
840 +id
837 837  )))|(((
838 -Timestamp
839 -Format: YYYY-MM-DDTHH:mm:ss
842 +UUID4
840 840  )))|(((
841 841  ✅️
842 842  )))|(((
843 -Timestamp an dem das Dokument und der QR Code erzeugt wurden
846 +Eindeutige ID dieses Dokuments
844 844  )))
845 845  |(((
846 -id
849 +time
847 847  )))|(((
848 -UUID4
851 +Zahl
849 849  )))|(((
850 850  ✅️
851 851  )))|(((
852 -Eindeutige ID dieses Dokuments
855 +UTC Linux-Timestamp an dem das Dokument und der QR Code erzeugt wurden
853 853  )))
854 854  |(((
855 855  exp
... ... @@ -858,22 +858,8 @@
858 858  )))|(((
859 859  ✅️
860 860  )))|(((
861 -Dauer der Gültigkeit gemessen in Sekunden, beispielsweise 1209600 für 2 Wochen.
864 +UTC Linux-Timestamp der angibt, bis wann das Dokument gültig ist.
862 862  )))
863 -
864 -=== {{id name="DigitaleMitgliederverwaltung-Body"/}}Body ===
865 -
866 -Die folgenden Claims sind im Body verfügbar:
867 -
868 -(% class="" %)|=(((
869 -Claim
870 -)))|=(((
871 -Type
872 -)))|=(((
873 -Pflicht
874 -)))|=(((
875 -Beschreibung
876 -)))
877 877  (% class="" %)|(((
878 878  (% class="code" %)
879 879  (((
... ... @@ -1000,6 +1000,7 @@
1000 1000  ➕️ Gute Dokumentation, API, Beispiele, Changelog
1001 1001  )))|(((
1002 1002  ✅️ 2.10.1
992 +Dep von firebase
1003 1003  )))|(((
1004 1004  ✅️ 2.10.1
1005 1005  )))
... ... @@ -1021,6 +1021,7 @@
1021 1021  ➕️ API Doc, einige Beispiele
1022 1022  )))|(((
1023 1023  ✅️ 1.5.6
1014 +Dep von python-keycloak
1024 1024  )))|(((
1025 1025  ❌️
1026 1026  )))
... ... @@ -1027,6 +1027,18 @@
1027 1027  
1028 1028  Unsere bevorzugte Library ist **pyjwt**. Diese ist auch in **paperless nativ vorhanden**, sodass wir uns für die Implementierung mittels **pyjwt** entschieden haben.
1029 1029  
1021 +=== {{id name="DigitaleMitgliederverwaltung-PDF417Code"/}}PDF417 Code ===
1022 +
1023 +Als Format für den Code wurde PDF417 ausgewählt, da dieser mehr Platz und Fehlerkorrektur bietet. Weiterhin gibt es eine einfach zu nutzende Library für Python (Erzeugung) und PDF417 wird von (% style="text-decoration: none;color:var(--ds-text-accent-purple-bolder,#352c63);" %)ZXING unterstützt, welches in Paperless eingebettet ist. Ein solcher Barcode sieht beispielsweise so aus:
1024 +
1025 +(% style="text-decoration: none;color:var(--ds-text-accent-purple-bolder,#352c63);" %)[[image:attach:barcode.jpg||height="250"]]
1026 +
1027 +(% style="text-decoration: none;color:var(--ds-text-accent-purple-bolder,#352c63);" %)Daraus kann dann eine Base64 basierte Repräsentation berechnet werden, die einfach in Docuseal hochgeladen werden kann.
1028 +
1029 +=== {{id name="DigitaleMitgliederverwaltung-Referenz-Implementierung"/}}Referenz-Implementierung ===
1030 +
1031 +Eine Referenz-Implementierung befindet sich im Makerspace Gitlab: [[https:~~/~~/git.makerspace-darmstadt.de/makerspace-it-infrastructure/paperless-pdf417-reference>>url:https://git.makerspace-darmstadt.de/makerspace-it-infrastructure/paperless-pdf417-reference||shape="rect"]]
1032 +
1030 1030  == {{id name="DigitaleMitgliederverwaltung-TechnischesSetup"/}}Technisches Setup ==
1031 1031  
1032 1032  Owner: zwei Owner
Icon Confluence.Code.ConfluencePageClass[0]
Id
... ... @@ -1,1 +1,1 @@
1 -202867288
1 +205586461
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/205586461/Digitale Mitgliederverwaltung