Zum Inhalt springen

Änderungen von Dokument Digitale Mitgliederverwaltung

Zuletzt geändert von Daniel Herrmann am 2026/02/22 21:17
Von Version Icon 21.1 Icon
bearbeitet von Daniel Herrmann
am 2025/08/21 21:11
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version Icon 23.1 Icon
bearbeitet von Daniel Herrmann
am 2025/08/22 08:47
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Icon Seiteneigenschaften
Inhalt
... ... @@ -425,10 +425,48 @@
425 425  
426 426  === {{id name="DigitaleMitgliederverwaltung-AblegenundVerarbeiten"/}}Ablegen und Verarbeiten ===
427 427  
428 -Egal welcher Prozess angewandt wird, das Dokument muss am Ende in Paperless eingelesen und mit den Meta-Daten (siehe unten) versehen werden.
428 +Egal welcher Prozess angewandt wird, das Dokument muss am Ende in Paperless eingelesen und mit den Meta-Daten (siehe unten) versehen werden. Hier gibt es drei verschiedene Varianten:
429 429  
430 -= {{id name="DigitaleMitgliederverwaltung-TechnischeÜbersicht"/}}Technische Übersicht =
430 +|=(% scope="col" %)(((
431 +Signatur über
432 +)))|=(% scope="col" %)(((
433 +Paperless Ingest
434 +)))|=(% scope="col" %)(((
435 +Ablauf
436 +)))
437 +|(((
438 +Docuseal
439 +)))|(((
440 +N8n
441 +)))|(((
442 +Docuseal sendet ein Webhook ans Backend
431 431  
444 +* Backend setzt den Prozess auf abgeschlossen
445 +* Backend publisht ein Event auf N8n
446 +* N8n lädt das Dokument von Docuseal herunter und lädt es zu Paperless hoch
447 +)))
448 +|(((
449 +Tablet
450 +)))|(((
451 +N8n oder API
452 +)))|(((
453 +Je nach gewählter Implementierung auf dem Tablet.
454 +
455 +* Wenn Docuseal In Person Signing: Webhook + N8n wie oben
456 +* Wenn Unterschrift in Tablet App: Tablet lädt das über die API hoch
457 +)))
458 +|(((
459 +Handschriftliche Unterschrift
460 +)))|(((
461 +ScanSnap Scanner
462 +)))|(((
463 +Das Dokument wird von der Mitgliederverwaltung eingescannt und dann von Paperless verarbeitet
464 +)))
465 +
466 +In allen Fällen sollte das Dokument einen QR Code enthalten, der die automatische Zuordnung von Meta-Daten ermöglicht. Weiterhin wird vom Post-Consumption Script ein NATS Event für jedes erfolgreich erkannte Dokument erstellt, welches dann vom N8n verarbeitet werden kann. Darüber lassen sich beispielsweise Einweisungszettel im Backend erfassen.
467 +
468 += {{id name="DigitaleMitgliederverwaltung-TechnischesDesign"/}}Technisches Design =
469 +
432 432  == {{id name="DigitaleMitgliederverwaltung-VorhandeneKomponenten"/}}Vorhandene Komponenten ==
433 433  
434 434  Der Verein hat in den letzten Jahren bereits einige Systeme aufgebaut, die uns den Alltag erleichtern und eine gewisse Automatisierung ermöglichen. Dazu gehören:
... ... @@ -469,12 +469,23 @@
469 469  
470 470  == {{id name="DigitaleMitgliederverwaltung-Systemübersicht"/}}Systemübersicht ==
471 471  
472 -Das folgende Kapitel gibt eine Übersicht über die vorgeschlagene Systemarchitektur basierend auf den oben vorgestellten Komponenten. Zusätzlich werden einige Beispiel-Worksflows vorgestellt, eine detailliertere Übersicht der oben vorgestellten Use-Cases für die Dokumente folgt weiter unten.
510 +Das folgende Kapitel gibt eine Übersicht über die vorgeschlagene Systemarchitektur basierend auf den oben vorgestellten Komponenten. Zusätzlich werden für die oben analysierten Dokumente und Workflows die technischen Ablaufdiagramme dargestellt.
473 473  
474 474  {{confluence_drawio border="true" diagramName="System Architecture" simpleViewer="false" links="auto" tbstyle="top" lbox="true" diagramWidth="1034" height="578" revision="5"/}}
475 475  
476 -TODO: Genauere Beschreibung der Komponenten
514 +Im Wesentlichen teilt sich die Architektur in zwei Zonen, die **öffentliche** und die **interne** Zone:
477 477  
516 +* **Paperless** ist das maßgebliche System, welches ausschließlich **intern** erreichbar ist. Es enthält alle Dokumente und somit sehr viele Mitglieder-Daten. Weiterhin ist es auf ein Teil der Infrastruktur im Makerspace (NAS, Drucker, Scanner) angewiesen, sodass es im Netzwerk des Makerspaces laufen muss. Aus Sicherheitsgründen ist Paperless ausschließlich im lokalen Netzwerk des Makerspaces oder per VPN erreichbar.
517 +* Alle den **Mitgliedern gegenüber sichtbare Systeme (Homepage, Backend, ...) sind öffentlich **und auf einem gemieteten Server beim deutschen Anbieter Hetzner gehostet. [[Details dazu finden sich im Wiki>>confluencePage:page:IN.Public Server Infrastruktur]]. Die meiste bestehende Automatisierung wird aktuell im Backend durchgeführt, ist dort allerdings in Python Logic fest einprogrammiert. Die meiste Logik soll in Zukunft über N8n realisiert werden.
518 +
519 +Für die Kommunikation zwischen beiden Zonen kommt eine **Event Queue** zum Einsatz, wir nutzen hier NATS. NATS wird ebenfalls **auf dem öffentlichen Server installiert. **Der Makerspace selbst ist nur über eine reguläre DSL Leitung an das Internet angebunden, sodass wir hier keine hohe Verfügbarkeit voraussetzen können. Durch die Installation der NATS Services auf dem öffentlichen Server können die dort laufenden Services wie das Backend jederzeit (auch wenn die Internet-Verbindung im Makerspace nicht zur Verfügung steht) die Events veröffentlichen. Die Events werden dann bis zu 7 Tage in der NATS EventQueue persistent gespeichert, und nach Wiederherstellung der Verbindung abgearbeitet.
520 +
521 +**In N8n** werden dann für die **verschiedenen Events Workflows** definiert. Jeder Workflow beginnt mit einem Trigger (genauer: ein NATS JetStream Trigger), der bei auf definierbare Events in der NATS Queue lauscht. Wird ein solches Event gefunden wird es konsumiert und die im Workflow definierten Aktionen werden abgearbeitet. Weiterhin kann auch **Paperless Events in N8n triggern**, dies passiert allerdings direkt über **Webhooks**. Hier nutzen wir NATS nicht, da der NATS Server in der öffentlichen Zone läuft und dann erneut eine Abhängigkeit zur Internet-Anbindung bestehen würde.
522 +
523 +== {{id name="DigitaleMitgliederverwaltung-Workflows"/}}Workflows ==
524 +
525 +asd
526 +
478 478  = {{id name="DigitaleMitgliederverwaltung-PaperlessNGX"/}}Paperless NGX =
479 479  
480 480  Das Herzstück der digitalen Mitgliederakte bildet Paperless NGX. Es wird im Makerspace lokal betrieben und ist daher nur aus dem Netzwerk des Makerspaces oder [[per VPN>>confluencePage:page:IN.[HOWTO] Makerspace VPN]] erreichbar. Der Zugang zu Paperless ist über OpenID Connect an [[confluencePage:page:IN.Keycloak]] gekoppelt, Zugang besteht nur für Mitglieder der Gruppen **Vorstand** und **Mitgliederverwaltung**.
Icon Confluence.Code.ConfluencePageClass[0]
Id
... ... @@ -1,1 +1,1 @@
1 -202866926
1 +202867019
URL
... ... @@ -1,1 +1,1 @@
1 -https://wiki.makerspace-darmstadt.de/spaces/PROJ/pages/202866926/Digitale Mitgliederverwaltung
1 +https://wiki.makerspace-darmstadt.de/spaces/PROJ/pages/202867019/Digitale Mitgliederverwaltung