Änderungen von Dokument Digitale Mitgliederverwaltung
Zuletzt geändert von Daniel Herrmann am 2026/02/22 21:17
Von Version
38.1
bearbeitet von Daniel Herrmann
am 2025/08/23 16:13
am 2025/08/23 16:13
Änderungskommentar:
Es gibt keinen Kommentar für diese Version
Auf Version
42.1
bearbeitet von Daniel Herrmann
am 2025/08/25 15:49
am 2025/08/25 15:49
Änderungskommentar:
Es gibt keinen Kommentar für diese Version
Zusammenfassung
Details
- 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"/}}TechnischesSetup==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
- Confluence.Code.ConfluencePageClass[0]
-
- Id
-
... ... @@ -1,1 +1,1 @@ 1 -2055864 611 +205586470 - URL
-
... ... @@ -1,1 +1,1 @@ 1 -https://wiki.makerspace-darmstadt.de/spaces/PROJ/pages/2055864 61/Digitale Mitgliederverwaltung1 +https://wiki.makerspace-darmstadt.de/spaces/PROJ/pages/205586470/Digitale Mitgliederverwaltung