Zum Inhalt springen

Änderungen von Dokument Digitale Mitgliederverwaltung

Zuletzt geändert von Daniel Herrmann am 2026/02/22 21:17
Von Version Icon 37.1 Icon
bearbeitet von Daniel Herrmann
am 2025/08/23 12:05
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version Icon 40.1 Icon
bearbeitet von Daniel Herrmann
am 2025/08/25 10:40
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Icon 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-QRcodeerzeugen"/}}(% style="color:var(--ds-text-accent-purple-bolder,#352c63);" %)**QR **code erzeugen(%%) ===
811 +=== {{id name="DigitaleMitgliederverwaltung-Barcodeerzeugen"/}}(% style="color:var(--ds-text-accent-purple-bolder,#352c63);" %)Barcode 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,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  (((
... ... @@ -1029,8 +1029,485 @@
1029 1029  
1030 1030  Unsere bevorzugte Library ist **pyjwt**. Diese ist auch in **paperless nativ vorhanden**, sodass wir uns für die Implementierung mittels **pyjwt** entschieden haben.
1031 1031  
1032 -== {{id name="DigitaleMitgliederverwaltung-TechnischesSetup"/}}Technisches Setup ==
1021 +=== {{id name="DigitaleMitgliederverwaltung-PDF417Code"/}}PDF417 Code ===
1033 1033  
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 +== {{id name="DigitaleMitgliederverwaltung-PaperlessBerechtigungen"/}}Paperless Berechtigungen ==
1034 +
1035 +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.
1036 +
1037 +=== {{id name="DigitaleMitgliederverwaltung-BenutzerundGruppen"/}}Benutzer und Gruppen ===
1038 +
1039 +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:
1040 +
1041 +* **Vorstand**: Für die Mitglieder des Vorstands
1042 +* **Mitgliederverwaltung**: Alle Personen, die mit der Verwaltung der Mitglieder betraut sind
1043 +* **IT Admin**: IT Administratoren im Makerspace
1044 +
1045 +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.
1046 +
1047 +=== {{id name="DigitaleMitgliederverwaltung-GlobaleBerechtigungen"/}}Globale Berechtigungen ===
1048 +
1049 +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:
1050 +
1051 +|=(% scope="row" %)(((
1052 +Berechtigung
1053 +)))|=(% scope="col" %)(((
1054 +Beschreibung
1055 +)))|=(% scope="col" %)(((
1056 +Mitgliederverwaltung
1057 +)))|=(% scope="col" %)(((
1058 +Vorstand
1059 +)))|=(% scope="col" %)(((
1060 +IT Admin
1061 +)))|=(% scope="col" %)(((
1062 +Notiz
1063 +)))
1064 +|=(% scope="row" %)(((
1065 +Document
1066 +)))|(((
1067 +Sehen und bearbeiten von Dokumenten.
1068 +)))|(((
1069 +ALLE
1070 +)))|(((
1071 +ALLE
1072 +)))|(((
1073 +KEINE
1074 +)))|(((
1075 +Wird zusätzlich durch Berechtigungen auf Objekt-Level eingeschränkt
1076 +)))
1077 +|=(% scope="row" %)(((
1078 +Tag
1079 +)))|(((
1080 +Sehen und bearbeiten von Tags.
1081 +)))|(((
1082 +Anzeigen
1083 +)))|(((
1084 +ALLE
1085 +)))|(((
1086 +ALLE
1087 +)))|(((
1088 +Wird zusätzlich durch Berechtigungen auf Objekt-Level eingeschränkt
1089 +)))
1090 +|=(% scope="row" %)(((
1091 +Correspondent
1092 +)))|(((
1093 +Sehen und bearbeiten von Korrespondenten
1094 +)))|(((
1095 +Anzeigen
1096 +)))|(((
1097 +ALLE
1098 +)))|(((
1099 +ALLE
1100 +)))|(((
1101 +Wird zusätzlich durch Berechtigungen auf Objekt-Level eingeschränkt
1102 +)))
1103 +|=(% scope="row" %)(((
1104 +DocumentType
1105 +)))|(((
1106 +Sehen und bearbeiten von Dokument-Typen
1107 +)))|(((
1108 +Anzeigen
1109 +)))|(((
1110 +ALLE
1111 +)))|(((
1112 +ALLE
1113 +)))|(((
1114 +Wird zusätzlich durch Berechtigungen auf Objekt-Level eingeschränkt
1115 +)))
1116 +|=(% scope="row" %)(((
1117 +StoragePath
1118 +)))|(((
1119 +Sehen und bearbeiten von Speicherpfaden
1120 +)))|(((
1121 +Anzeigen
1122 +)))|(((
1123 +Anzeigen
1124 +)))|(((
1125 +ALLE
1126 +)))|(((
1127 +Wird zusätzlich durch Berechtigungen auf Objekt-Level eingeschränkt
1128 +)))
1129 +|=(% scope="row" %)(((
1130 +SavedView
1131 +)))|(((
1132 +Ansichten erzeugen und speichern
1133 +)))|(((
1134 +ALLE
1135 +)))|(((
1136 +ALLE
1137 +)))|(((
1138 +KEINE
1139 +)))|(((
1140 +\\
1141 +)))
1142 +|=(% scope="row" %)(((
1143 +PaperlessTask
1144 +)))|(((
1145 +Dateiaufgaben einsehen und löschen
1146 +)))|(((
1147 +KEINE
1148 +)))|(((
1149 +KEINE
1150 +)))|(((
1151 +ALLE
1152 +)))|(((
1153 +\\
1154 +)))
1155 +|=(% scope="row" %)(((
1156 +AppConfig
1157 +)))|(((
1158 +Konfiguration von Paperless NGX selbst
1159 +)))|(((
1160 +KEINE
1161 +)))|(((
1162 +KEINE
1163 +)))|(((
1164 +ALLE
1165 +)))|(((
1166 +\\
1167 +)))
1168 +|=(% scope="row" %)(((
1169 +UISettings
1170 +)))|(((
1171 +Persönliche Anzeigeeinstellungen ändern
1172 +)))|(((
1173 +ALLE
1174 +)))|(((
1175 +ALLE
1176 +)))|(((
1177 +ALLE
1178 +)))|(((
1179 +\\
1180 +)))
1181 +|=(% scope="row" %)(((
1182 +History
1183 +)))|(((
1184 +Dokumenten-Audit Log anzeigen oder ändern
1185 +)))|(((
1186 +Anzeigen
1187 +)))|(((
1188 +Anzeigen
1189 +)))|(((
1190 +KEINE
1191 +)))|(((
1192 +Nur für Dokumente, auf die Zugriff gewährt wurde.
1193 +)))
1194 +|=(% scope="row" %)(((
1195 +Note
1196 +)))|(((
1197 +Notizen zu Dokumenten einsehen oder ändern
1198 +)))|(((
1199 +ALLE
1200 +)))|(((
1201 +ALLE
1202 +)))|(((
1203 +KEINE
1204 +)))|(((
1205 +Nur für Dokumente, auf die Zugriff gewährt wurde.
1206 +)))
1207 +|=(% scope="row" %)(((
1208 +MailAccount
1209 +)))|(((
1210 +Mail-Accounts verwalten
1211 +)))|(((
1212 +KEINE
1213 +)))|(((
1214 +Anzeigen
1215 +)))|(((
1216 +ALLE
1217 +)))|(((
1218 +\\
1219 +)))
1220 +|=(% scope="row" %)(((
1221 +MailRule
1222 +)))|(((
1223 +Verarbeitungsregeln für eingehende Mails bearbeiten
1224 +)))|(((
1225 +KEINE
1226 +)))|(((
1227 +ALLE
1228 +)))|(((
1229 +ALLE
1230 +)))|(((
1231 +\\
1232 +)))
1233 +|=(% scope="row" %)(((
1234 +User
1235 +)))|(((
1236 +Benutzer einsehen oder verwalten
1237 +)))|(((
1238 +KEINE
1239 +)))|(((
1240 +Anzeigen
1241 +)))|(((
1242 +ALLE
1243 +)))|(((
1244 +\\
1245 +)))
1246 +|=(% scope="row" %)(((
1247 +Group
1248 +)))|(((
1249 +Gruppen einsehen oder verwalten
1250 +)))|(((
1251 +KEINE
1252 +)))|(((
1253 +Anzeigen
1254 +)))|(((
1255 +ALLE
1256 +)))|(((
1257 +\\
1258 +)))
1259 +|=(% scope="row" %)(((
1260 +ShareLink
1261 +)))|(((
1262 +Öffentliche Share-Links erstellen oder verwalten
1263 +)))|(((
1264 +KEINE
1265 +)))|(((
1266 +KEINE
1267 +)))|(((
1268 +KEINE
1269 +)))|(((
1270 +\\
1271 +)))
1272 +|=(% scope="row" %)(((
1273 +CustomField
1274 +)))|(((
1275 +Custom Fields einsehen oder verwalten
1276 +)))|(((
1277 +Anzeigen
1278 +)))|(((
1279 +Anzeigen
1280 +)))|(((
1281 +ALLE
1282 +)))|(((
1283 +\\
1284 +)))
1285 +|=(% scope="row" %)(((
1286 +Workflow
1287 +)))|(((
1288 +Workflows für neue Dokumente einsehen oder verwalten
1289 +)))|(((
1290 +KEINE
1291 +)))|(((
1292 +KEINE
1293 +)))|(((
1294 +ALLE
1295 +)))|(((
1296 +\\
1297 +)))
1298 +
1299 +=== {{id name="DigitaleMitgliederverwaltung-Objekt-Berechtigungen"/}}Objekt-Berechtigungen ===
1300 +
1301 +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:
1302 +
1303 +* Owner / Eigentümer: Das Objekt gehört diesem Benutzer. Der Owner hat immer alle Berechtigungen für das Objekt
1304 +* Zusätzliche Berechtigungen:
1305 +** Es können getrennt voneinander Berechtigungen zum Anzeigen und Bearbeiten vergeben werden
1306 +** Diese Berechtigungen können jeweils für einzelne Benutzer oder für Gruppen gewährt werden
1307 +
1308 +Das sieht im Frontend beispielsweise so aus:
1309 +
1310 +[[image:attach:image-2025-8-25_10-19-25.png||thumbnail="true" height="250"]]
1311 +
1312 +{{info title="Berechtigungen"}}
1313 +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:
1314 +
1315 +|=(% scope="col" %)(((
1316 +Globale Berechtigung
1317 +)))|=(% scope="col" %)(((
1318 +Owner
1319 +)))|=(% scope="col" %)(((
1320 +Objekt-Berechtigung
1321 +)))|=(% scope="col" %)(((
1322 +Ergebnis
1323 +)))
1324 +|(((
1325 +❌️
1326 +)))|(((
1327 +Egal
1328 +)))|(((
1329 +Egal
1330 +)))|(((
1331 +❌️
1332 +)))
1333 +|(((
1334 +✅️
1335 +)))|(((
1336 +✅️
1337 +)))|(((
1338 +Egal
1339 +)))|(((
1340 +✅️
1341 +)))
1342 +|(((
1343 +✅️
1344 +)))|(((
1345 +❌️
1346 +)))|(((
1347 +❌️
1348 +)))|(((
1349 +❌️
1350 +)))
1351 +|(((
1352 +✅️
1353 +)))|(((
1354 +❌️
1355 +)))|(((
1356 +✅️
1357 +)))|(((
1358 +✅️
1359 +)))
1360 +
1361 +Mit anderen Worten, um eine Aktion auszuführen, muss ein Benutzer (a) die globale Berechtigung haben **UND** (b) Owner sein **ODER** Objekt-Berechtigungen haben.
1362 +{{/info}}
1363 +
1364 +=== {{id name="DigitaleMitgliederverwaltung-LokaleOwner"/}}Lokale Owner ===
1365 +
1366 +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.
1367 +
1368 +|=(% scope="row" %)(((
1369 +Benutzer
1370 +)))|=(% scope="col" %)(((
1371 +Verwendet für
1372 +)))
1373 +|=(% scope="row" %)(((
1374 +mksp-mv-owner
1375 +)))|(((
1376 +Alle Objekte (Dokumente, Dokumenttypen, Tags, Korrespondenten und Speicherpfade), die dem Use-Case **Mitgliederverwaltung** zugewiesen sind
1377 +)))
1378 +|=(% scope="row" %)(((
1379 +mksp-vs-owner
1380 +)))|(((
1381 +Alle Objekte (Dokumente, Dokumenttypen, Tags, Korrespondenten und Speicherpfade), die dem Use-Case **Vorstandspost** zugewiesen sind
1382 +)))
1383 +
1384 +=== {{id name="DigitaleMitgliederverwaltung-Standard-Objekt-Berechtigungen"/}}Standard-Objekt-Berechtigungen ===
1385 +
1386 +Basierend auf den hier beschrieben Regeln werden für Objekte die folgenden Berechtigungen gesetzt:
1387 +
1388 +|=(% scope="rowgroup" %)(((
1389 +Objekt
1390 +)))|=(% colspan="3" scope="colgroup" %)(((
1391 +Mitgliederverwaltung
1392 +)))|=(% scope="row" %)(((
1393 +\\
1394 +)))|=(% colspan="3" scope="colgroup" %)(((
1395 +Vorstandspost
1396 +)))
1397 +|=(% scope="rowgroup" %)(((
1398 +Objekt
1399 +)))|=(% scope="col" %)(((
1400 +Owner
1401 +)))|=(% scope="col" %)(((
1402 +Anzeigen
1403 +)))|=(% scope="col" %)(((
1404 +Bearbeiten
1405 +)))|=(% scope="row" %)(((
1406 +\\
1407 +)))|=(((
1408 +Owner
1409 +)))|=(((
1410 +Anzeigen
1411 +)))|=(((
1412 +Bearbeiten
1413 +)))
1414 +|=(% scope="row" %)(((
1415 +Dokument
1416 +)))|(((
1417 +\\
1418 +)))|(((
1419 +\\
1420 +)))|(((
1421 +\\
1422 +)))|=(% scope="row" %)(((
1423 +\\
1424 +)))|(((
1425 +\\
1426 +)))|(((
1427 +\\
1428 +)))|(((
1429 +\\
1430 +)))
1431 +|=(% scope="row" %)(((
1432 +Dokumenttyp
1433 +)))|(((
1434 +\\
1435 +)))|(((
1436 +\\
1437 +)))|(((
1438 +\\
1439 +)))|=(% scope="row" %)(((
1440 +\\
1441 +)))|(((
1442 +\\
1443 +)))|(((
1444 +\\
1445 +)))|(((
1446 +\\
1447 +)))
1448 +|=(% scope="row" %)(((
1449 +Tag
1450 +)))|(((
1451 +\\
1452 +)))|(((
1453 +\\
1454 +)))|(((
1455 +\\
1456 +)))|=(% scope="row" %)(((
1457 +\\
1458 +)))|(((
1459 +\\
1460 +)))|(((
1461 +\\
1462 +)))|(((
1463 +\\
1464 +)))
1465 +|=(% scope="row" %)(((
1466 +Korrespondent
1467 +)))|(((
1468 +\\
1469 +)))|(((
1470 +\\
1471 +)))|(((
1472 +\\
1473 +)))|=(% scope="row" %)(((
1474 +\\
1475 +)))|(((
1476 +\\
1477 +)))|(((
1478 +\\
1479 +)))|(((
1480 +\\
1481 +)))
1482 +|=(% scope="row" %)(((
1483 +Speicherpfad
1484 +)))|(((
1485 +\\
1486 +)))|(((
1487 +\\
1488 +)))|(((
1489 +\\
1490 +)))|=(% scope="row" %)(((
1491 +\\
1492 +)))|(((
1493 +\\
1494 +)))|(((
1495 +\\
1496 +)))|(((
1497 +\\
1498 +)))
1499 +
1034 1034  Owner: zwei Owner
1035 1035  Docs: Owner = grp owner, View + Edit jeweilige Gruppen
1036 1036  Correspondent: owner = grp owner, view = jeweilige Gruppe, edit = it admin
Icon Confluence.Code.ConfluencePageClass[0]
Id
... ... @@ -1,1 +1,1 @@
1 -202867290
1 +205586464
URL
... ... @@ -1,1 +1,1 @@
1 -https://wiki.makerspace-darmstadt.de/spaces/PROJ/pages/202867290/Digitale Mitgliederverwaltung
1 +https://wiki.makerspace-darmstadt.de/spaces/PROJ/pages/205586464/Digitale Mitgliederverwaltung