Änderungen von Dokument Digitale Mitgliederverwaltung

Zuletzt geändert von Daniel Herrmann am 2026/02/22 21:17

Von Version Icon 38.1 Icon
bearbeitet von Daniel Herrmann
am 2025/08/23 16:13
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version Icon 42.1 Icon
bearbeitet von Daniel Herrmann
am 2025/08/25 15:49
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Icon Seiteneigenschaften
Inhalt
... ... @@ -723,77 +723,19 @@
723 723  * **Tags**: Einem Dokument können beliebig viele Tags zugewiesen werden. **Tags** dienen der einfacheren **Zuordnung** und dem **Wiederfinden** von Dokumenten. Es gibt allerdings auch spezielle Tags für Dokumente die eingelesen aber noch nicht bearbeitet wurden, so genannte "Inbox Tags":
724 724  ** (% style="color:var(--ds-icon-success,#22a06b);" %)**Inbox Mitgliederverwaltung**(%%) - Alle **Dokumente** die **per Mail oder per Ordner** für die **Gruppe Mitgliederverwaltung** aufgenommen wurden und **nicht automatisch zugeordnet** werden konnten.
725 725  ** (% style="color:var(--ds-icon-accent-blue,#1d7afc);" %)**Inbox Vorstand**(%%) - Alle **Dokumente** die **per Mail oder per Ordner** für die **Gruppe Vorstand** aufgenommen wurden und **nicht automatisch zugeordnet** werden konnten.
726 -* (((
727 -**Dokumenten-Typen**: Einem Dokument wird exakt ein Typ zugewiesen. Dokumenten Typen sind im Prinzip einfache Gruppen. Für die Mitgliederverwaltung sind die Gruppen gemäß der folgenden Tabelle festgelegt, können aber natürlich bei Bedarf erweitert werden. Neben einem Namen haben die Dokumente einen Match String. Kommt dieser eindeutig (exakter Match) irgendwo im Dokument vor, wird der Typ automatisch zugewiesen.
728 -\\
729 -
730 -(% class="wrapped" %)
731 -|=(% scope="col" %)(((
732 -Name
733 -)))|=(% scope="col" %)(((
734 -Exact Match String
735 -)))
736 -|(((
737 -Mitgliedsantrag
738 -)))|(((
739 -mksp-doc-mitgliedsantrag
740 -)))
741 -|(((
742 -SEPA Lastschriftmandat
743 -)))|(((
744 -mksp-doc-sepamandat
745 -)))
746 -|(((
747 -Studienbescheinigung
748 -)))|(((
749 -mksp-doc-studienbescheinigung
750 -)))
751 -|(((
752 -Formular Schlüsselausgabe
753 -)))|(((
754 -mksp-doc-schluesselausgabe
755 -)))
756 -|(((
757 -Verpflichtungserklärung Datenschutz
758 -)))|(((
759 -\\
760 -)))
761 -|(((
762 -Übungsleitervertrag
763 -)))|(((
764 -\\
765 -)))
766 -|(((
767 -Nutzungsvereinbarung Schulungsinhalte
768 -)))|(((
769 -\\
770 -)))
771 -|(((
772 -Bestellung eines Einweisers
773 -)))|(((
774 -\\
775 -)))
776 -|(((
777 -Haftungsausschluss
778 -)))|(((
779 -\\
780 -)))
781 -|(((
782 -Einweisungszettel
783 -)))|(((
784 -\\
785 -)))
786 -|(((
787 -Lagervertrag Kistenlager
788 -)))|(((
789 -\\
790 -)))
791 -|(((
792 -Lagervertrag Projektlager
793 -)))|(((
794 -\\
795 -)))
796 -)))
726 +* **Dokumenten-Typen**: Einem Dokument wird exakt ein Typ zugewiesen. Dokumenten Typen sind im Prinzip einfache Gruppen. Für die Mitgliederverwaltung sind die Gruppen gemäß der folgenden Liste festgelegt, können aber natürlich bei Bedarf erweitert werden.
727 +** Mitgliedsantrag
728 +** SEPA Lastschriftmandat
729 +** Studienbescheinigung
730 +** Bestätigung Schlüsselausgabe
731 +** Verpflichtungserklärung Datenschutz
732 +** Übungsleitervertrag
733 +** Nutzungsvereinbarung Schulungsinhalte
734 +** Bestellung als Einweiser:in
735 +** Haftungsausschluss
736 +** Einweisungszettel
737 +** Lagervertrag Kistenlager
738 +** Lagervertrag Projektlager
797 797  * **Storage Path**: Speicherpfade sind ein etwas fortgeschrittenes Feature, welches kontrolliert, wie die Dateien im unterliegenden Dateisystem gespeichert werden. In der Regel arbeitet man nicht direkt mit den Dateien, aber wenn man aus lange Sicht mal aus Paperless NGX weg ziehen möchte kann es sinnvoll sein, die Dokumente in einer Struktur zu speichern, die man theoretisch auch manuell durchsuchen könnte. Details finden sich in der [[Dokumentation von Paperless zu File Name Handling>>url:https://docs.paperless-ngx.com/advanced_usage/#file-name-handling||shape="rect"]].
798 798  \\{{info title="Verhalten von Paperless"}}(% style="text-decoration: none;color:var(--ds-text-accent-purple-bolder,#352c63);" %)Paperless checks the filename of a document whenever it is saved. Changing (or deleting) a (%%)[[storage path>>url:https://docs.paperless-ngx.com/advanced_usage/#storage-paths||style="text-decoration: none;" shape="rect"]](% style="text-decoration: none;color:var(--ds-text-accent-purple-bolder,#352c63);" %) will automatically be reflected in the file system. However, when changing (% style="text-decoration: none;" %){{code language="none"}}PAPERLESS_FILENAME_FORMAT{{/code}}(% style="text-decoration: none;color:var(--ds-text-accent-purple-bolder,#352c63);" %) you will need to manually run the (%%)[[
799 799  
... ... @@ -1030,14 +1030,460 @@
1030 1030  
1031 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 1032  
1033 -== {{id name="DigitaleMitgliederverwaltung-TechnischesSetup"/}}Technisches Setup ==
975 +== {{id name="DigitaleMitgliederverwaltung-PaperlessBerechtigungen"/}}Paperless Berechtigungen ==
1034 1034  
1035 -Owner: zwei Owner
1036 -Docs: Owner = grp owner, View + Edit jeweilige Gruppen
1037 -Correspondent: owner = grp owner, view = jeweilige Gruppe, edit = it admin
1038 -Tag: owner = grp owner, view = jeweilige Gruppe, edit = it admin
1039 -Doc Type: owner = grp owner, view = jeweilige Gruppe, edit = it admin
977 +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.
1040 1040  
979 +=== {{id name="DigitaleMitgliederverwaltung-BenutzerundGruppen"/}}Benutzer und Gruppen ===
980 +
981 +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:
982 +
983 +* **Vorstand**: Für die Mitglieder des Vorstands
984 +* **Mitgliederverwaltung**: Alle Personen, die mit der Verwaltung der Mitglieder betraut sind
985 +* **IT Admin**: IT Administratoren im Makerspace
986 +
987 +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.
988 +
989 +=== {{id name="DigitaleMitgliederverwaltung-GlobaleBerechtigungen"/}}Globale Berechtigungen ===
990 +
991 +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:
992 +
993 +|=(% scope="row" %)(((
994 +Berechtigung
995 +)))|=(% scope="col" %)(((
996 +Beschreibung
997 +)))|=(% scope="col" %)(((
998 +Mitgliederverwaltung
999 +)))|=(% scope="col" %)(((
1000 +Vorstand
1001 +)))|=(% scope="col" %)(((
1002 +IT Admin
1003 +)))|=(% scope="col" %)(((
1004 +Notiz
1005 +)))
1006 +|=(% scope="row" %)(((
1007 +Document
1008 +)))|(((
1009 +Sehen und bearbeiten von Dokumenten.
1010 +)))|(((
1011 +ALLE
1012 +)))|(((
1013 +ALLE
1014 +)))|(((
1015 +KEINE
1016 +)))|(((
1017 +Wird zusätzlich durch Berechtigungen auf Objekt-Level eingeschränkt
1018 +)))
1019 +|=(% scope="row" %)(((
1020 +Tag
1021 +)))|(((
1022 +Sehen und bearbeiten von Tags.
1023 +)))|(((
1024 +Anzeigen
1025 +)))|(((
1026 +ALLE
1027 +)))|(((
1028 +ALLE
1029 +)))|(((
1030 +Wird zusätzlich durch Berechtigungen auf Objekt-Level eingeschränkt
1031 +)))
1032 +|=(% scope="row" %)(((
1033 +Correspondent
1034 +)))|(((
1035 +Sehen und bearbeiten von Korrespondenten
1036 +)))|(((
1037 +Anzeigen
1038 +)))|(((
1039 +ALLE
1040 +)))|(((
1041 +ALLE
1042 +)))|(((
1043 +Wird zusätzlich durch Berechtigungen auf Objekt-Level eingeschränkt
1044 +)))
1045 +|=(% scope="row" %)(((
1046 +DocumentType
1047 +)))|(((
1048 +Sehen und bearbeiten von Dokument-Typen
1049 +)))|(((
1050 +Anzeigen
1051 +)))|(((
1052 +ALLE
1053 +)))|(((
1054 +ALLE
1055 +)))|(((
1056 +Wird zusätzlich durch Berechtigungen auf Objekt-Level eingeschränkt
1057 +)))
1058 +|=(% scope="row" %)(((
1059 +StoragePath
1060 +)))|(((
1061 +Sehen und bearbeiten von Speicherpfaden
1062 +)))|(((
1063 +Anzeigen
1064 +)))|(((
1065 +Anzeigen
1066 +)))|(((
1067 +ALLE
1068 +)))|(((
1069 +Wird zusätzlich durch Berechtigungen auf Objekt-Level eingeschränkt
1070 +)))
1071 +|=(% scope="row" %)(((
1072 +SavedView
1073 +)))|(((
1074 +Ansichten erzeugen und speichern
1075 +)))|(((
1076 +ALLE
1077 +)))|(((
1078 +ALLE
1079 +)))|(((
1080 +KEINE
1081 +)))|(((
1082 +\\
1083 +)))
1084 +|=(% scope="row" %)(((
1085 +PaperlessTask
1086 +)))|(((
1087 +Dateiaufgaben einsehen und löschen
1088 +)))|(((
1089 +KEINE
1090 +)))|(((
1091 +KEINE
1092 +)))|(((
1093 +ALLE
1094 +)))|(((
1095 +\\
1096 +)))
1097 +|=(% scope="row" %)(((
1098 +AppConfig
1099 +)))|(((
1100 +Konfiguration von Paperless NGX selbst
1101 +)))|(((
1102 +KEINE
1103 +)))|(((
1104 +KEINE
1105 +)))|(((
1106 +ALLE
1107 +)))|(((
1108 +\\
1109 +)))
1110 +|=(% scope="row" %)(((
1111 +UISettings
1112 +)))|(((
1113 +Persönliche Anzeigeeinstellungen ändern
1114 +)))|(((
1115 +ALLE
1116 +)))|(((
1117 +ALLE
1118 +)))|(((
1119 +ALLE
1120 +)))|(((
1121 +\\
1122 +)))
1123 +|=(% scope="row" %)(((
1124 +History
1125 +)))|(((
1126 +Dokumenten-Audit Log anzeigen oder ändern
1127 +)))|(((
1128 +Anzeigen
1129 +)))|(((
1130 +Anzeigen
1131 +)))|(((
1132 +KEINE
1133 +)))|(((
1134 +Nur für Dokumente, auf die Zugriff gewährt wurde.
1135 +)))
1136 +|=(% scope="row" %)(((
1137 +Note
1138 +)))|(((
1139 +Notizen zu Dokumenten einsehen oder ändern
1140 +)))|(((
1141 +ALLE
1142 +)))|(((
1143 +ALLE
1144 +)))|(((
1145 +KEINE
1146 +)))|(((
1147 +Nur für Dokumente, auf die Zugriff gewährt wurde.
1148 +)))
1149 +|=(% scope="row" %)(((
1150 +MailAccount
1151 +)))|(((
1152 +Mail-Accounts verwalten
1153 +)))|(((
1154 +KEINE
1155 +)))|(((
1156 +Anzeigen
1157 +)))|(((
1158 +ALLE
1159 +)))|(((
1160 +\\
1161 +)))
1162 +|=(% scope="row" %)(((
1163 +MailRule
1164 +)))|(((
1165 +Verarbeitungsregeln für eingehende Mails bearbeiten
1166 +)))|(((
1167 +KEINE
1168 +)))|(((
1169 +ALLE
1170 +)))|(((
1171 +ALLE
1172 +)))|(((
1173 +\\
1174 +)))
1175 +|=(% scope="row" %)(((
1176 +User
1177 +)))|(((
1178 +Benutzer einsehen oder verwalten
1179 +)))|(((
1180 +KEINE
1181 +)))|(((
1182 +Anzeigen
1183 +)))|(((
1184 +ALLE
1185 +)))|(((
1186 +\\
1187 +)))
1188 +|=(% scope="row" %)(((
1189 +Group
1190 +)))|(((
1191 +Gruppen einsehen oder verwalten
1192 +)))|(((
1193 +KEINE
1194 +)))|(((
1195 +Anzeigen
1196 +)))|(((
1197 +ALLE
1198 +)))|(((
1199 +\\
1200 +)))
1201 +|=(% scope="row" %)(((
1202 +ShareLink
1203 +)))|(((
1204 +Öffentliche Share-Links erstellen oder verwalten
1205 +)))|(((
1206 +KEINE
1207 +)))|(((
1208 +KEINE
1209 +)))|(((
1210 +KEINE
1211 +)))|(((
1212 +\\
1213 +)))
1214 +|=(% scope="row" %)(((
1215 +CustomField
1216 +)))|(((
1217 +Custom Fields einsehen oder verwalten
1218 +)))|(((
1219 +Anzeigen
1220 +)))|(((
1221 +Anzeigen
1222 +)))|(((
1223 +ALLE
1224 +)))|(((
1225 +\\
1226 +)))
1227 +|=(% scope="row" %)(((
1228 +Workflow
1229 +)))|(((
1230 +Workflows für neue Dokumente einsehen oder verwalten
1231 +)))|(((
1232 +KEINE
1233 +)))|(((
1234 +KEINE
1235 +)))|(((
1236 +ALLE
1237 +)))|(((
1238 +\\
1239 +)))
1240 +
1241 +=== {{id name="DigitaleMitgliederverwaltung-Objekt-Berechtigungen"/}}Objekt-Berechtigungen ===
1242 +
1243 +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:
1244 +
1245 +* Owner / Eigentümer: Das Objekt gehört diesem Benutzer. Der Owner hat immer alle Berechtigungen für das Objekt
1246 +* Zusätzliche Berechtigungen:
1247 +** Es können getrennt voneinander Berechtigungen zum Anzeigen und Bearbeiten vergeben werden
1248 +** Diese Berechtigungen können jeweils für einzelne Benutzer oder für Gruppen gewährt werden
1249 +
1250 +Das sieht im Frontend beispielsweise so aus:
1251 +
1252 +[[image:attach:image-2025-8-25_10-19-25.png||thumbnail="true" height="250"]]
1253 +
1254 +{{info title="Berechtigungen"}}
1255 +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:
1256 +
1257 +|=(% scope="col" %)(((
1258 +Globale Berechtigung
1259 +)))|=(% scope="col" %)(((
1260 +Owner
1261 +)))|=(% scope="col" %)(((
1262 +Objekt-Berechtigung
1263 +)))|=(% scope="col" %)(((
1264 +Ergebnis
1265 +)))
1266 +|(((
1267 +❌️
1268 +)))|(((
1269 +Egal
1270 +)))|(((
1271 +Egal
1272 +)))|(((
1273 +❌️
1274 +)))
1275 +|(((
1276 +✅️
1277 +)))|(((
1278 +✅️
1279 +)))|(((
1280 +Egal
1281 +)))|(((
1282 +✅️
1283 +)))
1284 +|(((
1285 +✅️
1286 +)))|(((
1287 +❌️
1288 +)))|(((
1289 +❌️
1290 +)))|(((
1291 +❌️
1292 +)))
1293 +|(((
1294 +✅️
1295 +)))|(((
1296 +❌️
1297 +)))|(((
1298 +✅️
1299 +)))|(((
1300 +✅️
1301 +)))
1302 +
1303 +Mit anderen Worten, um eine Aktion auszuführen, muss ein Benutzer (a) die globale Berechtigung haben **UND** (b) Owner sein **ODER** Objekt-Berechtigungen haben.
1304 +{{/info}}
1305 +
1306 +=== {{id name="DigitaleMitgliederverwaltung-LokaleOwner"/}}Lokale Owner ===
1307 +
1308 +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.
1309 +
1310 +|=(% scope="row" %)(((
1311 +Benutzer
1312 +)))|=(% scope="col" %)(((
1313 +Verwendet für
1314 +)))
1315 +|=(% scope="row" %)(((
1316 +mksp-mv-owner
1317 +)))|(((
1318 +Alle Objekte (Dokumente, Dokumenttypen, Tags, Korrespondenten und Speicherpfade), die dem Use-Case **Mitgliederverwaltung** zugewiesen sind
1319 +)))
1320 +|=(% scope="row" %)(((
1321 +mksp-vs-owner
1322 +)))|(((
1323 +Alle Objekte (Dokumente, Dokumenttypen, Tags, Korrespondenten und Speicherpfade), die dem Use-Case **Vorstandspost** zugewiesen sind
1324 +)))
1325 +
1326 +=== {{id name="DigitaleMitgliederverwaltung-Standard-Objekt-Berechtigungen"/}}Standard-Objekt-Berechtigungen ===
1327 +
1328 +Basierend auf den hier beschrieben Regeln werden für Objekte die folgenden Berechtigungen gesetzt:
1329 +
1330 +|=(% rowspan="2" scope="rowgroup" %)(((
1331 +Objekt
1332 +\\
1333 +)))|=(% colspan="3" scope="colgroup" %)(((
1334 +Mitgliederverwaltung
1335 +)))|=(% rowspan="7" scope="rowgroup" %)(((
1336 +\\
1337 +)))|=(% colspan="3" scope="colgroup" %)(((
1338 +Vorstandspost
1339 +)))
1340 +|=(% scope="col" %)(((
1341 +Owner
1342 +)))|=(% scope="col" %)(((
1343 +Anzeigen
1344 +)))|=(% scope="col" %)(((
1345 +Bearbeiten
1346 +)))|=(((
1347 +Owner
1348 +)))|=(((
1349 +Anzeigen
1350 +)))|=(((
1351 +Bearbeiten
1352 +)))
1353 +|=(% scope="row" %)(((
1354 +Dokument
1355 +)))|(((
1356 +mksp-mv-owner
1357 +)))|(((
1358 +Mitgliederverwaltung
1359 +)))|(((
1360 +Mitgliederverwaltung
1361 +)))|(((
1362 +mksp-vs-owner
1363 +)))|(((
1364 +Vorstand
1365 +)))|(((
1366 +Vorstand
1367 +)))
1368 +|=(% scope="row" %)(((
1369 +Dokumenttyp
1370 +)))|(((
1371 +mksp-mv-owner
1372 +)))|(((
1373 +Mitgliederverwaltung, IT Admin
1374 +)))|(((
1375 +IT Admin
1376 +)))|(((
1377 +mksp-vs-owner
1378 +)))|(((
1379 +Vorstand
1380 +)))|(((
1381 +Vorstand
1382 +)))
1383 +|=(% scope="row" %)(((
1384 +Tag
1385 +)))|(((
1386 +mksp-mv-owner
1387 +)))|(((
1388 +Mitgliederverwaltung, IT Admin
1389 +)))|(((
1390 +IT Admin
1391 +)))|(((
1392 +mksp-vs-owner
1393 +)))|(((
1394 +Vorstand
1395 +)))|(((
1396 +Vorstand
1397 +)))
1398 +|=(% scope="row" %)(((
1399 +Korrespondent
1400 +)))|(((
1401 +mksp-mv-owner
1402 +)))|(((
1403 +Mitgliederverwaltung, IT Admin
1404 +)))|(((
1405 +IT Admin
1406 +)))|(((
1407 +mksp-vs-owner
1408 +)))|(((
1409 +Vorstand
1410 +)))|(((
1411 +Vorstand
1412 +)))
1413 +|=(% scope="row" %)(((
1414 +Speicherpfad
1415 +)))|(((
1416 +mksp-mv-owner
1417 +)))|(((
1418 +Mitgliederverwaltung, IT Admin
1419 +)))|(((
1420 +IT Admin
1421 +)))|(((
1422 +mksp-vs-owner
1423 +)))|(((
1424 +Vorstand
1425 +)))|(((
1426 +IT Admin
1427 +)))
1428 +
1041 1041  = {{id name="DigitaleMitgliederverwaltung-OffenePunkte"/}}Offene Punkte =
1042 1042  
1043 1043  * Docuseal Logging + Monitoring
Icon Confluence.Code.ConfluencePageClass[0]
Id
... ... @@ -1,1 +1,1 @@
1 -205586461
1 +205586470
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/205586470/Digitale Mitgliederverwaltung