Änderungen von Dokument Digitale Mitgliederverwaltung

Zusammenfassung

• Seiteneigenschaften (1 geändert, 0 hinzugefügt, 0 gelöscht)
• Objekte (1 geändert, 0 hinzugefügt, 0 gelöscht)
  • Confluence.Code.ConfluencePageClass[0]

Details

Seiteneigenschaften

Inhalt

...	...	@@ -808,7 +808,7 @@
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-Barcodeerzeugen"/}}(% style="color:var(--ds-text-accent-purple-bolder,#352c63);" %)Barcode erzeugen(%%) ===
	811	+=== {{id name="DigitaleMitgliederverwaltung-QRcodeerzeugen"/}}(% style="color:var(--ds-text-accent-purple-bolder,#352c63);" %)**QR **code erzeugen(%%) ===
812	812
813	813	(% style="color:var(--ds-text-accent-purple-bolder,#352c63);" %)Der Prozess zur Erzeugung eines QR Codes ist wie folgt:
814	814
...	...	@@ -817,42 +817,39 @@
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		-* PDF417 code erzeugen: ein JWT ist per Definition URL safe und kann daher einfach in ein QR code umgewandelt werden.
	820	+* QR 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, diese werden von der JWT Library automatisch erzeugt und beschreiben in der Regel den verwendeten Key-Typ.
	824	+Der Header enthält wichtige Meta-Daten:
825	825
826		-=== {{id name="DigitaleMitgliederverwaltung-Body"/}}Body ===
827		-
828		-Die folgenden Claims sind im Body verfügbar:
829		-
830		-(% class="" %)|=(((
	826	+|=(% scope="col" %)(((
831	831	Claim
832		-)))|=(((
	828	+)))|=(% scope="col" %)(((
833	833	Type
834		-)))|=(((
	830	+)))|=(% scope="col" %)(((
835	835	Pflicht
836		-)))|=(((
	832	+)))|=(% scope="col" %)(((
837	837	Beschreibung
838	838	)))
839	839	|(((
840		-id
	836	+time
841	841	)))|(((
842		-UUID4
	838	+Timestamp
	839	+Format: YYYY-MM-DDTHH:mm:ss
843	843	)))|(((
844	844	✅️
845	845	)))|(((
846		-Eindeutige ID dieses Dokuments
	843	+Timestamp an dem das Dokument und der QR Code erzeugt wurden
847	847	)))
848	848	|(((
849		-time
	846	+id
850	850	)))|(((
851		-Zahl
	848	+UUID4
852	852	)))|(((
853	853	✅️
854	854	)))|(((
855		-UTC Linux-Timestamp an dem das Dokument und der QR Code erzeugt wurden
	852	+Eindeutige ID dieses Dokuments
856	856	)))
857	857	|(((
858	858	exp
...	...	@@ -861,8 +861,22 @@
861	861	)))|(((
862	862	✅️
863	863	)))|(((
864		-UTC Linux-Timestamp der angibt, bis wann das Dokument gültig ist.
	861	+Dauer der Gültigkeit gemessen in Sekunden, beispielsweise 1209600 für 2 Wochen.
865	865	)))
	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	+)))
866	866	(% class="" %)|(((
867	867	(% class="code" %)
868	868	(((
...	...	@@ -1018,18 +1018,6 @@
1018	1018
1019	1019	Unsere bevorzugte Library ist **pyjwt**. Diese ist auch in **paperless nativ vorhanden**, sodass wir uns für die Implementierung mittels **pyjwt** entschieden haben.
1020	1020
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		-
1033	1033	== {{id name="DigitaleMitgliederverwaltung-TechnischesSetup"/}}Technisches Setup ==
1034	1034
1035	1035	Owner: zwei Owner

Confluence.Code.ConfluencePageClass[0]

Id

...	...	@@ -1,1 +1,1 @@
1		-205586461
	1	+202867290

URL

...	...	@@ -1,1 +1,1 @@
1		-https://wiki.makerspace-darmstadt.de/spaces/PROJ/pages/205586461/Digitale Mitgliederverwaltung
	1	+https://wiki.makerspace-darmstadt.de/spaces/PROJ/pages/202867290/Digitale Mitgliederverwaltung