Änderungen von Dokument Digitale Mitgliederverwaltung
Zuletzt geändert von Daniel Herrmann am 2026/02/22 21:17
Von Version
63.1
bearbeitet von Daniel Herrmann
am 2025/10/24 18:49
am 2025/10/24 18:49
Änderungskommentar:
Es gibt keinen Kommentar für diese Version
Auf Version
47.1
bearbeitet von Daniel Herrmann
am 2025/08/31 18:23
am 2025/08/31 18:23
Änderungskommentar:
Es gibt keinen Kommentar für diese Version
Zusammenfassung
Details
- Seiteneigenschaften
-
- Inhalt
-
... ... @@ -7,11 +7,11 @@ 7 7 8 8 zu diesem Zweck schaffen wir eine Platform basierend auf mehreren Open Source Software Produkten sowie einigen Hardware Produkten (NAS Speicher, Dokumentenscanner, PC Arbeitsplatz für die Mitgliederverwaltung). 9 9 10 -= Inhaltsverzeichnis = 10 += {{id name="DigitaleMitgliederverwaltung-Inhaltsverzeichnis"/}}Inhaltsverzeichnis = 11 11 12 12 {{toc/}} 13 13 14 -= Hintergrundinformationen = 14 += {{id name="DigitaleMitgliederverwaltung-Hintergrundinformationen"/}}Hintergrundinformationen = 15 15 16 16 Viele der Dokumente müssen von einer oder mehreren Partien unterschrieben werden. Wir unterscheiden dabei Dokumente mit geringem und hohem "Streitwert". Unsere Definition zielt hierbei auf eine Einschätzung ab, welcher Schaden dem Verein potentiell entstehen könnte und ob wir im Zweifel eine ordnungsgemäße Unterschrift vor Gericht beweisen können müssen. Beispielsweise hat der Lagervertrag (mögliche Schäden im 2-3 stelligen Eurobereich) einen anderen Stellenwert als beispielsweise ein Einweisungszettel (potentiell Personenschäden, dies kann in Millionen gehen). 17 17 ... ... @@ -23,7 +23,7 @@ 23 23 24 24 Kurz gesagt: Die EES ist schnell und unkompliziert, aber unsicher und nur für risikofreie Vorgänge geeignet. Die FES ist technisch sicherer, rechtlich belastbarer und für wichtige, aber formfreie Vereinbarungen ideal. Die QES ist rechtlich vollwertig wie eine handschriftliche Unterschrift und für alle Schriftformerfordernisse zwingend notwendig. Zusammenfassung: 25 25 26 -(% class="wrapped" style="text-decoration:none" %) 26 +(% class="wrapped" style="text-decoration: none;" %) 27 27 |=((( 28 28 Signaturtyp 29 29 )))|=((( ... ... @@ -61,27 +61,27 @@ 61 61 Mehrfaktor, über einen zugelassenen Vertrauensdienstleister 62 62 ))) 63 63 64 +\\ 64 64 65 - 66 66 {{confluence_tip title="Zusammenfassung"}} 67 67 Für uns im Makerspace bedeutet das, dass wir die EES und FES (über DocuSeal) einsetzen können. Wir haben keine Partnerschaft mit einem Anbieter, der die QES und damit die Schriftformerfordernis abdecken würde, sodass wir alle Dokumente, für die die Schriftform erforderlich ist, weiterhin handschriftlich unterschreiben lassen. 68 68 {{/confluence_tip}} 69 69 70 -= Dokumente und Workflow = 70 += {{id name="DigitaleMitgliederverwaltung-DokumenteundWorkflow"/}}Dokumente und Workflow = 71 71 72 -== Dokumenten-Arten == 72 +== {{id name="DigitaleMitgliederverwaltung-Dokumenten-Arten"/}}Dokumenten-Arten == 73 73 74 74 Am Dienstag, den 12.08.2025 fand hierzu ein Workshop statt, bei dem Vertreter des IT Teams, der Mitgliederverwaltung sowie des Vorstands teilgenommen haben. Dabei wurden die Ziele erläutert und definiert, ebenfalls haben eine Übersicht der bestehenden Dokumenten-Typen erstellt, mit denen wir im Verein heute hantieren. Für jedes Dokument wurde dann evaluiert, ob es in Zukunft komplett digitalisiert werden kann oder ob beispielsweise aus Haftungsgründen die Schriftform und damit eine handschriftliche Unterschrift weiterhin notwendig ist. Die folgende Tabelle gibt einen Überblick: 75 75 76 76 (% class="wrapped" %) 77 -|=((( 77 +|=(% scope="col" %)((( 78 78 Dokumenten-Typ 79 -)))|=((( 79 +)))|=(% scope="col" %)((( 80 80 Vollständig 81 81 digitalisieren 82 -)))|=((( 82 +)))|=(% scope="col" %)((( 83 83 Prozess heute 84 -)))|=((( 84 +)))|=(% scope="col" %)((( 85 85 Notwendige Änderungen 86 86 ))) 87 87 |((( ... ... @@ -164,7 +164,7 @@ 164 164 )))|((( 165 165 Notwendig für Funktionäre, Einweisende, und so weiter. 166 166 167 -Ist ein Blanko-Formular, welches ausgefüllt, eingeworfen und abgeheftet wird. 167 +Ist ein Blanko-Formular, welches ausgefüllt, eingeworfen und abgeheftet wird. 168 168 Danach wird ein Flag für das jeweilige Mitglied gesetzt, dass die Erklärung abgegeben wurde. 169 169 )))|((( 170 170 **Vollständig digital**. Vorstand oder Mitgliederverwaltung löst den Prozess über das Profil des Mitglieds aus (Button auf Homepage), danach digital weiter. ... ... @@ -286,19 +286,19 @@ 286 286 **Vollständig digital**, die Papierform entfällt. Self-Service durch Nutzer:in. 287 287 ))) 288 288 289 -== Workflow Beschreibung == 289 +== {{id name="DigitaleMitgliederverwaltung-WorkflowBeschreibung"/}}Workflow Beschreibung == 290 290 291 291 Grundsätzlich teilt sich der Umgang mit Dokumenten in folgende Phasen auf: 292 292 293 293 {{confluence_drawio border="true" diagramName="Prozess Allgemein" simpleViewer="false" links="auto" tbstyle="top" lbox="true" diagramWidth="991" height="221" revision="2"/}} 294 294 295 -=== Trigger / Starten des Workflows === 295 +=== {{id name="DigitaleMitgliederverwaltung-Trigger/StartendesWorkflows"/}}Trigger / Starten des Workflows === 296 296 297 297 Eine neues Dokument kann auf unterschiedliche Arten erstellt werden. Im Allgemeinen ist es unser Ziel, alle Dokumente vorausgefüllt zur Verfügung zu stellen. Vorausgefüllt bedeutet hierbei, dass mindestens ein QR Code vorhanden ist, der später eine automatische Verarbeitung in Paperless möglich macht. Dabei ist es unerheblich, ob das Dokument komplett digital verarbeitet wird oder zwischenzeitlich auf Grund der Schriftformerfordernis ausgedruckt werden muss. 298 298 299 299 In seltenen Fällen (Haftungsauschluss oder der Nutzungsvereinbarung für Schulungsinhalte) ist eine Personalisierung nicht möglich. In diesem Fall wird der Vorgang mit dem Einscannen des Dokuments begonnen und muss von der Mitgliederverwaltung manuell verarbeitet werden. 300 300 301 -==== Start über die Homepage ==== 301 +==== {{id name="DigitaleMitgliederverwaltung-StartüberdieHomepage"/}}Start über die Homepage ==== 302 302 303 303 Ein Prozess kann über die Homepage eingeleitet werden, entweder durch 304 304 ... ... @@ -306,24 +306,24 @@ 306 306 * **remote, explizit durch den Use**r für sich selbst (Self-Service, beispielsweise der Lager-Vertrag) 307 307 * **remote, explizit durch einen Funktionär** für einen andere User (Datenschutzvereinbarung, Übungsleitervertrag, ...) 308 308 309 -==== Lokal im Makerspace ==== 309 +==== {{id name="DigitaleMitgliederverwaltung-LokalimMakerspace"/}}Lokal im Makerspace ==== 310 310 311 311 Alternativ kann der Prozess lokal im Makerspace angestoßen werden, beispielsweise wenn die lokale Präsenz des Mitglieds notwendig ist (Schlüsselausgabe) oder nach einer Vor-Ort Einweisung. In diesem Fall wird der Prozess beispielsweise ein Tablet im Space verwendet. 312 312 313 313 * **lokal, explizit durch einen Funktionär** (Einweisungsleiter:in, Mitgliederverwaltung, Vorstand), beispielsweise Einweisungszettel oder Schlüsselausgabeformular 314 314 315 -=== Dokument erstellen === 315 +=== {{id name="DigitaleMitgliederverwaltung-Dokumenterstellen"/}}Dokument erstellen === 316 316 317 317 Im zweiten Schritt wird nun ein oder mehrere personalisierte Dokumente erstellt. Hier gibt es eine Entscheidungsmatrix: 318 318 319 319 (% class="wrapped" %) 320 -|=((( 320 +|=(% scope="col" %)((( 321 321 Remote / Lokal 322 -)))|=((( 322 +)))|=(% scope="col" %)((( 323 323 Schriftformerfordernis 324 -)))|=((( 324 +)))|=(% scope="col" %)((( 325 325 Beispiel 326 -)))|=((( 326 +)))|=(% scope="col" %)((( 327 327 Beschreibung 328 328 ))) 329 329 |((( ... ... @@ -361,7 +361,7 @@ 361 361 )))|((( 362 362 Einweisungszettel Vor-Ort Einweisung 363 363 )))|((( 364 -Dokument wird über eine Docuseal One-Off Submission erzeugt und als PDF auf das Tablet heruntergeladen. 364 +Dokument wird über eine Docuseal One-Off Submission erzeugt und als PDF auf das Tablet heruntergeladen.\\ 365 365 ))) 366 366 367 367 {{error title="Docuseal Lizenz"}} ... ... @@ -368,7 +368,7 @@ 368 368 Das genannte Feature "One-Off" Submission ist ein DocuSeal Pro Feature, welches uns nicht zur Verfügung steht. Eventuell müssen wir 369 369 {{/error}} 370 370 371 -=== Unterschrift leisten === 371 +=== {{id name="DigitaleMitgliederverwaltung-Unterschriftleisten"/}}Unterschrift leisten === 372 372 373 373 Im dritten Schritt müssen eine oder mehrere Parteien das Dokument unterschreiben. Wie viele Parteien ist abhängig vom Dokument. So muss beispielsweise der Mitgliedsantrag nur vom werdenden Mitglied unterschrieben werden, während das Schlüsselausgabeformular vom ausgebenen Funktionär und dem Mitglied unterschrieben werden muss. Analog zur Erstellung des Dokuments wird hier unterschieden, ob das Dokument zuhause unterschrieben werden kann oder ob es vor Ort im Makerspace passiert. 374 374 ... ... @@ -420,19 +420,19 @@ 420 420 Einweisungszettel Vor-Ort Einweisung 421 421 )))|((( 422 422 Auf dem Makerspace Tablet wird das Dokument vor Ort ausgedruckt (AirPrint oder CUPS) und **handschriftlich** unterschrieben. 423 - 423 +\\ 424 424 ))) 425 425 426 -=== Ablegen und Verarbeiten === 426 +=== {{id name="DigitaleMitgliederverwaltung-AblegenundVerarbeiten"/}}Ablegen und Verarbeiten === 427 427 428 428 Egal welcher Prozess angewandt wird, das Dokument muss am Ende in Paperless eingelesen und mit den Metadaten (siehe unten) versehen werden. Hier gibt es drei verschiedene Varianten: 429 429 430 430 (% class="wrapped" %) 431 -|=((( 431 +|=(% scope="col" %)((( 432 432 Signatur über 433 -)))|=((( 433 +)))|=(% scope="col" %)((( 434 434 Paperless Ingest 435 -)))|=((( 435 +)))|=(% scope="col" %)((( 436 436 Ablauf 437 437 ))) 438 438 |((( ... ... @@ -466,9 +466,9 @@ 466 466 467 467 In allen Fällen sollte das Dokument einen QR Code enthalten, der die automatische Zuordnung von Metadaten 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. 468 468 469 -= Technisches Design = 469 += {{id name="DigitaleMitgliederverwaltung-TechnischesDesign"/}}Technisches Design = 470 470 471 -== Vorhandene Komponenten == 471 +== {{id name="DigitaleMitgliederverwaltung-VorhandeneKomponenten"/}}Vorhandene Komponenten == 472 472 473 473 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: 474 474 ... ... @@ -480,17 +480,17 @@ 480 480 * [[DocuSeal>>url:http://docuseal.com||shape="rect"]] - Eine Open Source Lösung für das Signieren von Dokumenten. Wir betreiben unsere eigene Instanz unter [[https:~~/~~/sign.makerspace-darmstadt.de>>url:https://sign.makerspace-darmstadt.de||shape="rect"]]. DocuSeal ist für die Lagerverträge in die Homepage integriert - ein Mitglied kann die Unterschrift dort anfragen und erhält dann per Mail (=Authentifizierung) eine Einladung, den Vertrag zu unterschreiben. Der Vertrag wird anschließend kryptographisch gegen Veränderungen geschützt und per Mail an das Mitglied und die Mitgliederverwaltung geschickt. 481 481 * [[Vikunja>>url:https://vikunja.io||shape="rect"]] - Ein Open Source System für die Todo-Verwaltung und einfaches Projekt-Tracking. Wir nutzen es stand heute ohne jegliche Integration für die Aufgabenverwaltung im Vorstand, in der Vereins-IT sowie in einigen Bereichen. 482 482 483 -== Neue Komponenten == 483 +== {{id name="DigitaleMitgliederverwaltung-NeueKomponenten"/}}Neue Komponenten == 484 484 485 -=== Paperless NGX === 485 +=== {{id name="DigitaleMitgliederverwaltung-PaperlessNGX"/}}Paperless NGX === 486 486 487 -Paperless-NGX ist ein freies, quelloffenes Dokumentenmanagementsystem (DMS), das als aktiv gepflegter Community-Fork des eingestellten „paperless-ng“ entstanden ist. Die Software läuft unter Linux, ist in Python und TypeScript geschrieben, unter der GPL-3.0 lizenziert und wird üblicherweise containerisiert mit Docker betrieben. In unserem Fall wird sie vor Ort im Makerspace auf dem vorhandenen Kubernetes-Cluster betrieben. 487 +(% style="text-decoration: none;color:var(--ds-text,#333333);" %)Paperless-NGX ist ein freies, quelloffenes Dokumentenmanagementsystem (DMS), das als aktiv gepflegter Community-Fork des eingestellten „paperless-ng“ entstanden ist. Die Software läuft unter Linux, ist in Python und TypeScript geschrieben, unter der GPL-3.0 lizenziert und wird üblicherweise containerisiert mit Docker betrieben. In unserem Fall wird sie vor Ort im Makerspace auf dem vorhandenen Kubernetes-Cluster betrieben. 488 488 489 -Sie dient dazu, Papierdokumente und digitale Dateien zentral zu erfassen, automatisch zu verarbeiten, strukturiert zu archivieren und komfortabel wiederzufinden. Die Dokumente können über verschiedene Wege ins System gelangen – etwa durch einen speziellen „consume“-Ordner, per E-Mail-Import oder via Drag-and-drop im Webinterface. Bei der Verarbeitung wird eine leistungsfähige Texterkennung (OCR) auf Basis von Tesseract eingesetzt, die über 100 Sprachen unterstützt und auch gescannte Dokumente durchsuchbar macht. Zusätzlich werden Metadaten wie Tags, Korrespondenten, Dokumenttypen oder benutzerdefinierte Felder erfasst; diese lassen sich automatisiert per Machine-Learning oder durch definierte Workflows zuweisen, die auch externe Aktionen wie E-Mails oder Webhooks auslösen können. 489 +(% style="text-decoration: none;color:var(--ds-text,#333333);" %) Sie dient dazu, Papierdokumente und digitale Dateien zentral zu erfassen, automatisch zu verarbeiten, strukturiert zu archivieren und komfortabel wiederzufinden. Die Dokumente können über verschiedene Wege ins System gelangen – etwa durch einen speziellen „consume“-Ordner, per E-Mail-Import oder via Drag-and-drop im Webinterface. Bei der Verarbeitung wird eine leistungsfähige Texterkennung (OCR) auf Basis von Tesseract eingesetzt, die über 100 Sprachen unterstützt und auch gescannte Dokumente durchsuchbar macht. Zusätzlich werden Metadaten wie Tags, Korrespondenten, Dokumenttypen oder benutzerdefinierte Felder erfasst; diese lassen sich automatisiert per Machine-Learning oder durch definierte Workflows zuweisen, die auch externe Aktionen wie E-Mails oder Webhooks auslösen können. 490 490 491 -Die Speicherung erfolgt in einem standardisierten PDF/A-Format für die Langzeitarchivierung, wobei stets auch die Originaldateien erhalten bleiben. Metadaten werden in einer Datenbank (PostgreSQL) verwaltet, während die eigentlichen Dateien im Dateisystem (über Kubernetes CSI direkt auf dem NAS) liegen. Über das Webinterface stehen Funktionen wie Volltextsuche mit Auto-Completion, Hervorhebung von Treffern, Filterung und „Ähnliche Dokumente“-Vorschläge zur Verfügung. Mehrbenutzerfähigkeit, fein abgestufte Rechtevergabe und ein anpassbares Dashboard erleichtern die Zusammenarbeit. 491 +(% style="text-decoration: none;color:var(--ds-text,#333333);" %)Die Speicherung erfolgt in einem standardisierten PDF/A-Format für die Langzeitarchivierung, wobei stets auch die Originaldateien erhalten bleiben. Metadaten werden in einer Datenbank (PostgreSQL) verwaltet, während die eigentlichen Dateien im Dateisystem (über Kubernetes CSI direkt auf dem NAS) liegen. Über das Webinterface stehen Funktionen wie Volltextsuche mit Auto-Completion, Hervorhebung von Treffern, Filterung und „Ähnliche Dokumente“-Vorschläge zur Verfügung. Mehrbenutzerfähigkeit, fein abgestufte Rechtevergabe und ein anpassbares Dashboard erleichtern die Zusammenarbeit. 492 492 493 -=== N8n === 493 +=== {{id name="DigitaleMitgliederverwaltung-N8n"/}}(% style="text-decoration: none;color:var(--ds-text,#333333);" %)N8n(%%) === 494 494 495 495 n8n ist ein **Open-Source-Tool zur Workflow-Automatisierung**, das man selbst hosten kann. Über eine **visuelle Oberfläche** baut man Workflows per Drag-and-drop aus sogenannten „Nodes“, die verschiedene Dienste und Aktionen miteinander verbinden. Es gibt Hunderte vorgefertigte Integrationen, z. B. für Slack, Mail oder MQTT. Ebenfalls gibt es eine große Auswahl an für uns relevante Community Nodes (Vikunja, Listmonk, und so weiter) sowie die Möglichkeit, eigene Nodes zu schreiben (beispielsweise Paperless oder NATS). 496 496 ... ... @@ -498,8 +498,10 @@ 498 498 499 499 In unserem Fall wird N8n auf der Infrastruktur im Makerspace betrieben damit, der Zugriff auch auf interne Systeme wie Paperless oder die MQTT Umgebung möglich ist. Das Setup und die Konfiguration von N8n ist auf einer eigenen Wiki-Seite beschrieben. 500 500 501 - === NATS ===501 +\\ 502 502 503 +=== {{id name="DigitaleMitgliederverwaltung-NATS"/}}NATS === 504 + 503 503 Für den Transport von Events zwischen der Homepage (insbesondere dem Backend) und N8n wird **NATS** vorgeschlagen. **NATS** ist ein leichtgewichtiges, schnelles **Messaging-System** für Event-Streaming und -Queues, das auf dem **Publish/Subscribe-Prinzip** basiert. Es eignet sich besonders für verteilte Systeme, bei denen verschiedene Dienste über Events miteinander kommunizieren. 504 504 505 505 Das Backend sendet Ereignisse (als JSON) an einen NATS-Subject (ähnlich einem MQTT Topic). NATS nimmt diese Events sofort entgegen und hält sie je nach Konfiguration im Speicher oder in einer persistierten Stream-Queue (JetStream). n8n kann dann über einen **NATS-Trigger**-Node diese Events abonnieren. Sobald ein Event eintrifft, startet n8n den zugehörigen Workflow automatisch und verarbeitet die enthaltenen Daten. ... ... @@ -506,7 +506,7 @@ 506 506 507 507 NATS entkoppelt Backend und Automatisierungslogik, sorgt für sehr geringe Latenz, zuverlässige Zustellung und ermöglicht horizontale Skalierung, ohne dass FastAPI oder n8n direkt voneinander abhängig sind. 508 508 509 -== Systemübersicht == 511 +== {{id name="DigitaleMitgliederverwaltung-Systemübersicht"/}}Systemübersicht == 510 510 511 511 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. 512 512 ... ... @@ -515,13 +515,13 @@ 515 515 Im Wesentlichen teilt sich die Architektur in zwei Zonen, die **öffentliche** und die **interne** Zone: 516 516 517 517 * **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. 518 -* 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>> doc:xwiki:IN.IT Infrastruktur.Public Server Infrastruktur.WebHome]]. 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.520 +* 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. 519 519 520 520 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. 521 521 522 522 **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. 523 523 524 -== Dokument-Workflows == 526 +== {{id name="DigitaleMitgliederverwaltung-Dokument-Workflows"/}}Dokument-Workflows == 525 525 526 526 Die beiden entscheidenden Faktoren für den Workflow: 527 527 ... ... @@ -537,12 +537,12 @@ 537 537 (% class="wrapped" %) 538 538 |=(% scope="row" %)((( 539 539 Workflow 540 -)))|=((( 542 +)))|=(% scope="col" %)((( 541 541 Schriftform erforderlich 542 -)))|=((( 544 +)))|=(% scope="col" %)((( 543 543 Lokal / Remote 544 544 ))) 545 -|=((( 547 +|=(% scope="row" %)((( 546 546 Fall 1: Digital Remote 547 547 )))|((( 548 548 Nein ... ... @@ -549,7 +549,7 @@ 549 549 )))|((( 550 550 Remote 551 551 ))) 552 -|=((( 554 +|=(% scope="row" %)((( 553 553 Fall 2: Digital Makerspace 554 554 )))|((( 555 555 Nein ... ... @@ -556,7 +556,7 @@ 556 556 )))|((( 557 557 Lokal 558 558 ))) 559 -|=((( 561 +|=(% scope="row" %)((( 560 560 Fall 3: Handschriftlich Remote 561 561 )))|((( 562 562 Ja ... ... @@ -563,7 +563,7 @@ 563 563 )))|((( 564 564 Remote 565 565 ))) 566 -|=((( 568 +|=(% scope="row" %)((( 567 567 Fall 4: Handschriftlich Makerspace 568 568 )))|((( 569 569 Ja ... ... @@ -571,7 +571,7 @@ 571 571 Lokal 572 572 ))) 573 573 574 -=== Fall 1: Digital + Remote === 576 +=== {{id name="DigitaleMitgliederverwaltung-Fall1:Digital+Remote"/}}Fall 1: Digital + Remote === 575 575 576 576 Alle diese Fälle haben gemein, dass der Prozess **remote ausgelöst und abgeschlossen** wird. In diesem Fall wird nie ein ausgedrucktes Dokument erzeugt, das Dokument wird **ausschließlich digital** verwaltet. 577 577 ... ... @@ -598,7 +598,7 @@ 598 598 11. Bei Bedarf (Konfiguration im QR Code) wird ein N8n Webhook ausgelöst 599 599 1. (Optional): Wurde im vorherigen Schritt über den Webhook ein N8n Workflow ausgelöst, kann dieser nun weitere Schritte unternehmen (beispielsweise Vikunja Tasks erzeugen, Mails verschicken, oder ähnlich) 600 600 601 -=== Fall 2: Digital + Makerspace === 603 +=== {{id name="DigitaleMitgliederverwaltung-Fall2:Digital+Makerspace"/}}Fall 2: Digital + Makerspace === 602 602 603 603 In diesem Fall kann die Unterschrift digital erfolgen, allerdings findet die Unterschrift im Makerspace statt. Beispiel hier ist die Ausgabe eines Schlüssels und das Schlüsselausgabeformular. 604 604 ... ... @@ -617,7 +617,7 @@ 617 617 11. Speichert das Backend die Anfrage als Signature Request in der Datenbank 618 618 11. Erstellt eine "Submission" in DocuSeal. Diese basiert auf einem Template und enthält so viele Daten wie möglich schon vorausgefüllt. Mindestens aber enthält die Submission den signierten QR Code (siehe unten). 619 619 11. ((( 620 -Die URL für das Dokument werden als Antwort des API Requests an das Tablet zurück geschickt. Dies enthält die Embed-URL, die direkt auf dem Tablet angezeigt werden kann. Beispiel: 622 +Die URL für das Dokument werden als Antwort des API Requests an das Tablet zurück geschickt. Dies enthält die Embed-URL, die direkt auf dem Tablet angezeigt werden kann. Beispiel:\\ 621 621 622 622 {{expand}} 623 623 {{code language="json"}} ... ... @@ -652,7 +652,7 @@ 652 652 11. Bei Bedarf (Konfiguration im QR Code) wird ein N8n Webhook ausgelöst 653 653 1. (Optional): Wurde im vorherigen Schritt über den Webhook ein N8n Workflow ausgelöst, kann dieser nun weitere Schritte unternehmen (beispielsweise Vikunja Tasks erzeugen, Mails verschicken, oder ähnlich) 654 654 655 -=== Fall 3: Handschriftlich + Remote === 657 +=== {{id name="DigitaleMitgliederverwaltung-Fall3:Handschriftlich+Remote"/}}Fall 3: Handschriftlich + Remote === 656 656 657 657 In diesem Fall wird der Prozess durch einen Benutzer **remote ausgelöst, benötigt allerdings die Schriftform.** In diesem Fall wird dem Benutzer ein vorausgefülltes und mit QR Code versehenes Dokument zum Download angeboten, welches dann heruntergeladen, ausgedruckt, unterschrieben und eingereicht werden muss. 658 658 ... ... @@ -678,7 +678,7 @@ 678 678 1. Als Teil des N8n Workflows informiert N8n das Backend darüber, dass das Dokument eingescannt und verarbeitet wurde. Der Vorgang wird entsprechend in der Datenbank als erledigt markiert. 679 679 1. (Optional): Wurde im vorherigen Schritt über den Webhook ein N8n Workflow ausgelöst, kann dieser nun weitere Schritte unternehmen (beispielsweise Vikunja Tasks erzeugen, Mails verschicken, oder ähnlich) 680 680 681 -=== Fall 4: Handschriftlich + Makerspace === 683 +=== {{id name="DigitaleMitgliederverwaltung-Fall4:Handschriftlich+Makerspace"/}}Fall 4: Handschriftlich + Makerspace === 682 682 683 683 In diesem Fall wird der Prozess durch einen Benutzer **im Makerspace ausgelöst und benötigt Schriftform.** In diesem Fall wird das Dokument im Makerspace erzeugt (soweit wie möglich vorausgefüllt und mit QR Code versehen) und direkt vor Ort ausgedruckt. Dort wird es dann unterschrieben und eingeworfen. 684 684 ... ... @@ -702,11 +702,11 @@ 702 702 1. Als Teil des N8n Workflows informiert N8n das Backend darüber, dass das Dokument eingescannt und verarbeitet wurde. Der Vorgang wird entsprechend in der Datenbank als erledigt markiert. 703 703 1. (Optional): Wurde im vorherigen Schritt über den Webhook ein N8n Workflow ausgelöst, kann dieser nun weitere Schritte unternehmen (beispielsweise Vikunja Tasks erzeugen, Mails verschicken, oder ähnlich) 704 704 705 -= Paperless NGX = 707 += {{id name="DigitaleMitgliederverwaltung-PaperlessNGX"/}}Paperless NGX = 706 706 707 -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>> doc:xwiki:IN.IT Infrastruktur.IT im Makerspace.[HOWTO] Makerspace VPN.WebHome]] erreichbar. Der Zugang zu Paperless ist über OpenID Connect an [[doc:xwiki:IN.IT Infrastruktur.Services.Keycloak.WebHome]] gekoppelt, Zugang besteht nur für Mitglieder der Gruppen **Vorstand** und **Mitgliederverwaltung**.709 +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**. 708 708 709 -== Paperless Übersicht == 711 +== {{id name="DigitaleMitgliederverwaltung-PaperlessÜbersicht"/}}Paperless Übersicht == 710 710 711 711 **Dokumente** sind die primären Ressourcen in Paperless. Ein Dokument kann über mehrere Wege in Paperless aufgenommen werden (der Prozess wird **Ingestion** genannt): 712 712 ... ... @@ -725,7 +725,7 @@ 725 725 * **SCAN Vorstand** - Platziert das Dokument in dem Consumption Ordner für den Vorstand, Rechte und Tags werden dann automatisch gesetzt 726 726 * **SCAN MV** - Platziert das Dokument in dem Consumption Ordner für die Mitgliederverwaltung, Rechte und Tags werden dann automatisch gesetzt 727 727 728 -== Übersicht der Metadaten == 730 +== {{id name="DigitaleMitgliederverwaltung-ÜbersichtderMetadaten"/}}Übersicht der Metadaten == 729 729 730 730 Dokumente werden dann Meta-Daten zugeordnet, die eine spätere Suche und Zuordnung erleichtern. Diese Meta-Daten sind: 731 731 ... ... @@ -806,15 +806,15 @@ 806 806 ))) 807 807 ))) 808 808 809 -== Automatische Zuordnung von Metadaten == 811 +== {{id name="DigitaleMitgliederverwaltung-AutomatischeZuordnungvonMetadaten"/}}Automatische Zuordnung von Metadaten == 810 810 811 811 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. 812 812 813 813 **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).** 814 814 815 -=== (% style="color:var(--ds-text-accent-purple-bolder,#352c63)" %)Barcode erzeugen(%%) === 817 +=== {{id name="DigitaleMitgliederverwaltung-Barcodeerzeugen"/}}(% style="color:var(--ds-text-accent-purple-bolder,#352c63);" %)Barcode erzeugen(%%) === 816 816 817 -(% style="color:var(--ds-text-accent-purple-bolder,#352c63)" %)Der Prozess zur Erzeugung eines QR Codes ist wie folgt: 819 +(% style="color:var(--ds-text-accent-purple-bolder,#352c63);" %)Der Prozess zur Erzeugung eines QR Codes ist wie folgt: 818 818 819 819 * **Payload (Daten) festlegen**. Einige Werte sind verpflichtend, andere können nach Bedarf optional hinzugefügt werden. 820 820 * JWT erzeugen und signieren. der JWT besteht aus drei Teilen: ... ... @@ -823,13 +823,13 @@ 823 823 ** **Signature**: Mit Hilfe eines Secrets und wird die Signatur erzeugt und automatisch angehängt. 824 824 * PDF417 code erzeugen: ein JWT ist per Definition URL safe und kann daher einfach in ein QR code umgewandelt werden. 825 825 826 -=== Header === 828 +=== {{id name="DigitaleMitgliederverwaltung-Header"/}}Header === 827 827 828 828 Der Header enthält wichtige Meta-Daten, diese werden von der JWT Library automatisch erzeugt und beschreiben in der Regel den verwendeten Key-Typ. 829 829 830 -=== Body === 832 +=== {{id name="DigitaleMitgliederverwaltung-Body"/}}Body === 831 831 832 -Die folgenden Claims sind im Body verfügbar .834 +Die folgenden Claims sind im Body verfügbar: 833 833 834 834 |=((( 835 835 Claim ... ... @@ -879,7 +879,6 @@ 879 879 )))|((( 880 880 Typ des Dokuments basierend auf der unten definierten Liste. 881 881 ))) 882 -|mode|String|✅️ |Kann entweder "digital" oder "manual" sein und bestimmt, ob N8n den unterschriebenen Vertrag ans Backend meldet. 883 883 |((( 884 884 (% class="code" %) 885 885 ((( ... ... @@ -930,29 +930,29 @@ 930 930 Für diesen Anwendungsfall nutzen wir (% style="text-decoration: none;color:var(--ds-text,#333333);" %)**HS256** (HMAC mit SHA-256 Algorithmus). 931 931 {{/confluence_tip}} 932 932 933 -=== Auswahl der Library === 934 +=== {{id name="DigitaleMitgliederverwaltung-AuswahlderLibrary"/}}Auswahl der Library === 934 934 935 935 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: 936 936 937 -|=((( 938 +|=(% scope="col" %)((( 938 938 Name 939 -)))|=((( 940 +)))|=(% scope="col" %)((( 940 940 CVE 941 -)))|=((( 942 +)))|=(% scope="col" %)((( 942 942 Github 943 -)))|=((( 944 +)))|=(% scope="col" %)((( 944 944 GH⭐ 945 -)))|=((( 946 +)))|=(% scope="col" %)((( 946 946 Letztes Release 947 -)))|=((( 948 +)))|=(% scope="col" %)((( 948 948 Offene Issues 949 -)))|=((( 950 +)))|=(% scope="col" %)((( 950 950 Dokumentation 951 -)))|=((( 952 +)))|=(% scope="col" %)((( 952 952 Qualität Dokumentation 953 -)))|=((( 954 +)))|=(% scope="col" %)((( 954 954 In Backend vorhanden? 955 -)))|=((( 956 +)))|=(% scope="col" %)((( 956 956 In Paperless vorhanden? 957 957 ))) 958 958 |((( ... ... @@ -1023,27 +1023,27 @@ 1023 1023 1024 1024 Unsere bevorzugte Library ist **pyjwt**. Diese ist auch in **paperless nativ vorhanden**, sodass wir uns für die Implementierung mittels **pyjwt** entschieden haben. 1025 1025 1026 -=== PDF417 Code === 1027 +=== {{id name="DigitaleMitgliederverwaltung-PDF417Code"/}}PDF417 Code === 1027 1027 1028 -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="color:var(--ds-text-accent-purple-bolder,#352c63); text-decoration:none" %)ZXING unterstützt, welches in Paperless eingebettet ist. Ein solcher Barcode sieht beispielsweise so aus:1029 +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: 1029 1029 1030 -(% style="color:var(--ds-text-accent-purple-bolder,#352c63); text-decoration:none" %)[[image:attach:barcode.jpg||height="250"]]1031 +(% style="text-decoration: none;color:var(--ds-text-accent-purple-bolder,#352c63);" %)[[image:attach:barcode.jpg||height="250"]] 1031 1031 1032 -(% style="color:var(--ds-text-accent-purple-bolder,#352c63); text-decoration:none" %)Daraus kann dann eine Base64 basierte Repräsentation berechnet werden, die einfach in Docuseal hochgeladen werden kann.1033 +(% 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. 1033 1033 1034 -=== Referenz-Implementierung === 1035 +=== {{id name="DigitaleMitgliederverwaltung-Referenz-Implementierung"/}}Referenz-Implementierung === 1035 1035 1036 1036 Eine Referenz-Implementierung befindet sich im Makerspace Gitlab: [[https:~~/~~/git.makerspace-darmstadt.de/makerspace-it-infrastructure/mitgliederverwaltung/paperless-pdf417-reference>>url:https://git.makerspace-darmstadt.de/makerspace-it-infrastructure/mitgliederverwaltung/paperless-pdf417-reference||shape="rect"]] 1037 1037 1038 -=== Post Consumption Script === 1039 +=== {{id name="DigitaleMitgliederverwaltung-PostConsumptionScript"/}}Post Consumption Script === 1039 1039 1040 1040 Die eigentliche Zuordnung der Meta-Daten erfolgt über ein so genanntes Post Consumption Script. Dieses befindet sich ebenfalls im Makerspace Gitlab: [[https:~~/~~/git.makerspace-darmstadt.de/makerspace-it-infrastructure/mitgliederverwaltung/paperless-post-consumption-script#>>url:https://git.makerspace-darmstadt.de/makerspace-it-infrastructure/mitgliederverwaltung/paperless-post-consumption-script||shape="rect"]] 1041 1041 1042 -== Paperless Berechtigungen == 1043 +== {{id name="DigitaleMitgliederverwaltung-PaperlessBerechtigungen"/}}Paperless Berechtigungen == 1043 1043 1044 1044 Paperless NGX hat ein Berechtigungssystem, welches sich über fast alle Ressourcen erstreckt. Grundsätzlich gibt es **Benutzer** und **Gruppen**. Berechtigungen können dann global vergeben werden (Sichtbarkeit von Features) und zusätzlich auf Objektebene vergeben werden. 1045 1045 1046 -=== Benutzer und Gruppen === 1047 +=== {{id name="DigitaleMitgliederverwaltung-BenutzerundGruppen"/}}Benutzer und Gruppen === 1047 1047 1048 1048 Paperless NGX ist so konfiguriert, dass sich Benutzer mit ihrem zentralen Makerspace Login anmelden können (OIDC über Keycloak). Eine Anmeldung mit lokalen Zugangsdaten ist nicht möglich. Bei der Anmeldung werden ebenfalls die Gruppen aus Keycloak übernommen, aber nur die folgenden: 1049 1049 ... ... @@ -1053,24 +1053,24 @@ 1053 1053 1054 1054 Nutzer, die keine dieser Gruppen angehören haben keine Rechte in Paperless. Sie können sich zwar anmelden, aber selbst die Willkommens-Seite erzeugt eine "Permission Denied" Fehlermeldung. 1055 1055 1056 -=== Globale Berechtigungen === 1057 +=== {{id name="DigitaleMitgliederverwaltung-GlobaleBerechtigungen"/}}Globale Berechtigungen === 1057 1057 1058 1058 Berechtigungen werden grundsätzlich nicht auf Benutzerebene konfiguriert, sondern ausschließlich auf Gruppenebene. So wird sichergestellt, dass bei der Änderung einer Gruppenzugehörigkeit auch die damit verbundenen Rechte entzogen oder gewährt werden, ohne dass eine manuelle Änderung notwendig ist. Die folgende Tabelle gibt eine Übersicht der konfigurierten globalen Berechtigungen pro Gruppe: 1059 1059 1060 1060 |=(% scope="row" %)((( 1061 1061 Berechtigung 1062 -)))|=((( 1063 +)))|=(% scope="col" %)((( 1063 1063 Beschreibung 1064 -)))|=((( 1065 +)))|=(% scope="col" %)((( 1065 1065 Mitgliederverwaltung 1066 -)))|=((( 1067 +)))|=(% scope="col" %)((( 1067 1067 Vorstand 1068 -)))|=((( 1069 +)))|=(% scope="col" %)((( 1069 1069 IT Admin 1070 -)))|=((( 1071 +)))|=(% scope="col" %)((( 1071 1071 Notiz 1072 1072 ))) 1073 -|=((( 1074 +|=(% scope="row" %)((( 1074 1074 Document 1075 1075 )))|((( 1076 1076 Sehen und bearbeiten von Dokumenten. ... ... @@ -1083,7 +1083,7 @@ 1083 1083 )))|((( 1084 1084 Wird zusätzlich durch Berechtigungen auf Objekt-Level eingeschränkt 1085 1085 ))) 1086 -|=((( 1087 +|=(% scope="row" %)((( 1087 1087 Tag 1088 1088 )))|((( 1089 1089 Sehen und bearbeiten von Tags. ... ... @@ -1096,7 +1096,7 @@ 1096 1096 )))|((( 1097 1097 Wird zusätzlich durch Berechtigungen auf Objekt-Level eingeschränkt 1098 1098 ))) 1099 -|=((( 1100 +|=(% scope="row" %)((( 1100 1100 Correspondent 1101 1101 )))|((( 1102 1102 Sehen und bearbeiten von Korrespondenten ... ... @@ -1109,7 +1109,7 @@ 1109 1109 )))|((( 1110 1110 Wird zusätzlich durch Berechtigungen auf Objekt-Level eingeschränkt 1111 1111 ))) 1112 -|=((( 1113 +|=(% scope="row" %)((( 1113 1113 DocumentType 1114 1114 )))|((( 1115 1115 Sehen und bearbeiten von Dokument-Typen ... ... @@ -1122,7 +1122,7 @@ 1122 1122 )))|((( 1123 1123 Wird zusätzlich durch Berechtigungen auf Objekt-Level eingeschränkt 1124 1124 ))) 1125 -|=((( 1126 +|=(% scope="row" %)((( 1126 1126 StoragePath 1127 1127 )))|((( 1128 1128 Sehen und bearbeiten von Speicherpfaden ... ... @@ -1135,7 +1135,7 @@ 1135 1135 )))|((( 1136 1136 Wird zusätzlich durch Berechtigungen auf Objekt-Level eingeschränkt 1137 1137 ))) 1138 -|=((( 1139 +|=(% scope="row" %)((( 1139 1139 SavedView 1140 1140 )))|((( 1141 1141 Ansichten erzeugen und speichern ... ... @@ -1146,9 +1146,9 @@ 1146 1146 )))|((( 1147 1147 KEINE 1148 1148 )))|((( 1149 - 1150 +\\ 1150 1150 ))) 1151 -|=((( 1152 +|=(% scope="row" %)((( 1152 1152 PaperlessTask 1153 1153 )))|((( 1154 1154 Dateiaufgaben einsehen und löschen ... ... @@ -1159,9 +1159,9 @@ 1159 1159 )))|((( 1160 1160 ALLE 1161 1161 )))|((( 1162 - 1163 +\\ 1163 1163 ))) 1164 -|=((( 1165 +|=(% scope="row" %)((( 1165 1165 AppConfig 1166 1166 )))|((( 1167 1167 Konfiguration von Paperless NGX selbst ... ... @@ -1172,9 +1172,9 @@ 1172 1172 )))|((( 1173 1173 ALLE 1174 1174 )))|((( 1175 - 1176 +\\ 1176 1176 ))) 1177 -|=((( 1178 +|=(% scope="row" %)((( 1178 1178 UISettings 1179 1179 )))|((( 1180 1180 Persönliche Anzeigeeinstellungen ändern ... ... @@ -1185,9 +1185,9 @@ 1185 1185 )))|((( 1186 1186 ALLE 1187 1187 )))|((( 1188 - 1189 +\\ 1189 1189 ))) 1190 -|=((( 1191 +|=(% scope="row" %)((( 1191 1191 History 1192 1192 )))|((( 1193 1193 Dokumenten-Audit Log anzeigen oder ändern ... ... @@ -1200,7 +1200,7 @@ 1200 1200 )))|((( 1201 1201 Nur für Dokumente, auf die Zugriff gewährt wurde. 1202 1202 ))) 1203 -|=((( 1204 +|=(% scope="row" %)((( 1204 1204 Note 1205 1205 )))|((( 1206 1206 Notizen zu Dokumenten einsehen oder ändern ... ... @@ -1213,7 +1213,7 @@ 1213 1213 )))|((( 1214 1214 Nur für Dokumente, auf die Zugriff gewährt wurde. 1215 1215 ))) 1216 -|=((( 1217 +|=(% scope="row" %)((( 1217 1217 MailAccount 1218 1218 )))|((( 1219 1219 Mail-Accounts verwalten ... ... @@ -1224,9 +1224,9 @@ 1224 1224 )))|((( 1225 1225 ALLE 1226 1226 )))|((( 1227 - 1228 +\\ 1228 1228 ))) 1229 -|=((( 1230 +|=(% scope="row" %)((( 1230 1230 MailRule 1231 1231 )))|((( 1232 1232 Verarbeitungsregeln für eingehende Mails bearbeiten ... ... @@ -1237,9 +1237,9 @@ 1237 1237 )))|((( 1238 1238 ALLE 1239 1239 )))|((( 1240 - 1241 +\\ 1241 1241 ))) 1242 -|=((( 1243 +|=(% scope="row" %)((( 1243 1243 User 1244 1244 )))|((( 1245 1245 Benutzer einsehen oder verwalten ... ... @@ -1250,9 +1250,9 @@ 1250 1250 )))|((( 1251 1251 ALLE 1252 1252 )))|((( 1253 - 1254 +\\ 1254 1254 ))) 1255 -|=((( 1256 +|=(% scope="row" %)((( 1256 1256 Group 1257 1257 )))|((( 1258 1258 Gruppen einsehen oder verwalten ... ... @@ -1263,9 +1263,9 @@ 1263 1263 )))|((( 1264 1264 ALLE 1265 1265 )))|((( 1266 - 1267 +\\ 1267 1267 ))) 1268 -|=((( 1269 +|=(% scope="row" %)((( 1269 1269 ShareLink 1270 1270 )))|((( 1271 1271 Öffentliche Share-Links erstellen oder verwalten ... ... @@ -1276,9 +1276,9 @@ 1276 1276 )))|((( 1277 1277 KEINE 1278 1278 )))|((( 1279 - 1280 +\\ 1280 1280 ))) 1281 -|=((( 1282 +|=(% scope="row" %)((( 1282 1282 CustomField 1283 1283 )))|((( 1284 1284 Custom Fields einsehen oder verwalten ... ... @@ -1289,9 +1289,9 @@ 1289 1289 )))|((( 1290 1290 ALLE 1291 1291 )))|((( 1292 - 1293 +\\ 1293 1293 ))) 1294 -|=((( 1295 +|=(% scope="row" %)((( 1295 1295 Workflow 1296 1296 )))|((( 1297 1297 Workflows für neue Dokumente einsehen oder verwalten ... ... @@ -1302,10 +1302,10 @@ 1302 1302 )))|((( 1303 1303 ALLE 1304 1304 )))|((( 1305 - 1306 +\\ 1306 1306 ))) 1307 1307 1308 -=== Objekt-Berechtigungen === 1309 +=== {{id name="DigitaleMitgliederverwaltung-Objekt-Berechtigungen"/}}Objekt-Berechtigungen === 1309 1309 1310 1310 Zusätzlich zu den globalen Berechtigungen können für alle Objekte noch Berechtigungen auf Objekt-Level konfiguriert werden. Dabei werden globale Regeln zuerst geprüft, danach zusätzlich die Objekt-Berechtigungen. Jedes Objekt (egal ob Dokument, Korrespondent, Tag, Dokumenten-Typ) hat zwei wichtige Einstellungen: 1311 1311 ... ... @@ -1321,13 +1321,13 @@ 1321 1321 {{info title="Berechtigungen"}} 1322 1322 Es sind grundsätzlich sowohl globale als auch objekt-spezifische Berechtigungen notwendig. Wenn ein Benutzer ein Objekt bearbeiten ansehen oder bearbeiten möchte ergibt sich daher die folgende Matrix: 1323 1323 1324 -|=((( 1325 +|=(% scope="col" %)((( 1325 1325 Globale Berechtigung 1326 -)))|=((( 1327 +)))|=(% scope="col" %)((( 1327 1327 Owner 1328 -)))|=((( 1329 +)))|=(% scope="col" %)((( 1329 1329 Objekt-Berechtigung 1330 -)))|=((( 1331 +)))|=(% scope="col" %)((( 1331 1331 Ergebnis 1332 1332 ))) 1333 1333 |((( ... ... @@ -1370,45 +1370,45 @@ 1370 1370 Mit anderen Worten, um eine Aktion auszuführen, muss ein Benutzer (a) die globale Berechtigung haben **UND** (b) Owner sein **ODER** Objekt-Berechtigungen haben. 1371 1371 {{/info}} 1372 1372 1373 -=== Lokale Owner === 1374 +=== {{id name="DigitaleMitgliederverwaltung-LokaleOwner"/}}Lokale Owner === 1374 1374 1375 1375 Jedes Objekt in Paperless muss einen Owner haben. Damit der Owner nicht ein realer Benutzer ist, der gegebenenfalls den Vorstand / Mitgliederverwaltung oder Verein verlassen könnte, werden lokale Benutzer angelegt. Diese halten lediglich die Owner Rolle für die Ressourcen, können aber nicht für den Login verwendet werden. 1376 1376 1377 1377 |=(% scope="row" %)((( 1378 1378 Benutzer 1379 -)))|=((( 1380 +)))|=(% scope="col" %)((( 1380 1380 Verwendet für 1381 1381 ))) 1382 -|=((( 1383 +|=(% scope="row" %)((( 1383 1383 mksp-mv-owner 1384 1384 )))|((( 1385 1385 Alle Objekte (Dokumente, Dokumenttypen, Tags, Korrespondenten und Speicherpfade), die dem Use-Case **Mitgliederverwaltung** zugewiesen sind 1386 1386 ))) 1387 -|=((( 1388 +|=(% scope="row" %)((( 1388 1388 mksp-vs-owner 1389 1389 )))|((( 1390 1390 Alle Objekte (Dokumente, Dokumenttypen, Tags, Korrespondenten und Speicherpfade), die dem Use-Case **Vorstandspost** zugewiesen sind 1391 1391 ))) 1392 1392 1393 -=== Standard-Objekt-Berechtigungen === 1394 +=== {{id name="DigitaleMitgliederverwaltung-Standard-Objekt-Berechtigungen"/}}Standard-Objekt-Berechtigungen === 1394 1394 1395 1395 Basierend auf den hier beschrieben Regeln werden für Objekte die folgenden Berechtigungen gesetzt: 1396 1396 1397 1397 |=(% rowspan="2" scope="rowgroup" %)((( 1398 1398 Objekt 1399 - 1400 +\\ 1400 1400 )))|=(% colspan="3" scope="colgroup" %)((( 1401 1401 Mitgliederverwaltung 1402 1402 )))|=(% rowspan="7" scope="rowgroup" %)((( 1403 - 1404 +\\ 1404 1404 )))|=(% colspan="3" scope="colgroup" %)((( 1405 1405 Vorstandspost 1406 1406 ))) 1407 1407 |=(% scope="col" %)((( 1408 1408 Owner 1409 -)))|=((( 1410 +)))|=(% scope="col" %)((( 1410 1410 Anzeigen 1411 -)))|=((( 1412 +)))|=(% scope="col" %)((( 1412 1412 Bearbeiten 1413 1413 )))|=((( 1414 1414 Owner ... ... @@ -1417,7 +1417,7 @@ 1417 1417 )))|=((( 1418 1418 Bearbeiten 1419 1419 ))) 1420 -|=((( 1421 +|=(% scope="row" %)((( 1421 1421 Dokument 1422 1422 )))|((( 1423 1423 mksp-mv-owner ... ... @@ -1432,7 +1432,7 @@ 1432 1432 )))|((( 1433 1433 Vorstand 1434 1434 ))) 1435 -|=((( 1436 +|=(% scope="row" %)((( 1436 1436 Dokumenttyp 1437 1437 )))|((( 1438 1438 mksp-mv-owner ... ... @@ -1447,7 +1447,7 @@ 1447 1447 )))|((( 1448 1448 Vorstand 1449 1449 ))) 1450 -|=((( 1451 +|=(% scope="row" %)((( 1451 1451 Tag 1452 1452 )))|((( 1453 1453 mksp-mv-owner ... ... @@ -1462,7 +1462,7 @@ 1462 1462 )))|((( 1463 1463 Vorstand 1464 1464 ))) 1465 -|=((( 1466 +|=(% scope="row" %)((( 1466 1466 Korrespondent 1467 1467 )))|((( 1468 1468 mksp-mv-owner ... ... @@ -1477,7 +1477,7 @@ 1477 1477 )))|((( 1478 1478 Vorstand 1479 1479 ))) 1480 -|=((( 1481 +|=(% scope="row" %)((( 1481 1481 Speicherpfad 1482 1482 )))|((( 1483 1483 mksp-mv-owner ... ... @@ -1493,7 +1493,7 @@ 1493 1493 IT Admin 1494 1494 ))) 1495 1495 1496 -== Workflows == 1497 +== {{id name="DigitaleMitgliederverwaltung-Workflows"/}}Workflows == 1497 1497 1498 1498 Paperless Workflows können zur Automatisierung verschiedener Tasks eingesetzt werden. In diesem Fall werden zwei Fälle damit abgedeckt: 1499 1499 ... ... @@ -1500,7 +1500,7 @@ 1500 1500 * Beim Hinzufügen der Dokumente via Webinterface **wird standardmäßig der angemeldete Nutzer als Owner des Dokuments festgelegt**. Damit haben andere Mitglieder der gleichen Gruppe (Beispielsweise Vorstand oder Mitgliederverwaltung) kein Zugriff auf die so hinzugefügten Dokumente. Aus diesem Grund setzt einer der Workflow die entsprechend notwendigen Berechtigungen. 1501 1501 * Einscannen von Dokumenten soll sowohl für die Mitgliederverwaltung als auch für den Vorstand möglich sein und der richtigen Gruppe zugeordnet werden. Wir haben dafür zwei unterschiedliche Ordner aus dem NAS angelegt. Der Dokumentenscanner kann Dokumente in einen der beiden Ordner legen, wir nutzen Workflows um auch hier die richtigen Berechtigungen zu setzen. 1502 1502 1503 -= Offene Punkte = 1504 += {{id name="DigitaleMitgliederverwaltung-OffenePunkte"/}}Offene Punkte = 1504 1504 1505 1505 * Docuseal Logging + Monitoring 1506 1506 * N8n Error Handling