Self-hosted project management for devs and their clients: tickets, time tracking, docs and meetings, with an AI assistant that cites its sources. AGPL-3.0.
Feingranulare Projektberechtigungen und Pundit Integration
Übersicht
In der neuesten Version haben wir das Berechtigungssystem umfassend überarbeitet:
- Einführung feingranularer Rechte für den Zugriff auf Projektbereiche
- Migration von
ProjectAccessServicezu PunditProjectPolicy - Optimierung der Berechtigungsprüfungen in Listen-Ansichten
Diese Änderungen ermöglichen eine genauere Kontrolle darüber, welche Benutzerrollen auf welche Projektbereiche zugreifen können, und verbessern die Code-Qualität und Wartbarkeit des Systems.
Alte Berechtigungen
Bisher gab es zwei globale Projektberechtigungen:
read_access_all_projects: Gewährte Lesezugriff auf alle Bereiche aller Projektewrite_access_all_projects: Gewährte Schreibzugriff auf alle Bereiche aller Projekte
Neue Berechtigungen
Die neuen bereichsspezifischen globalen Berechtigungen sind:
Lesezugriff pro Bereich:
read_access_chats_all_projects: Lesezugriff auf alle Chat-Bereiche in allen Projektenread_access_notes_all_projects: Lesezugriff auf alle Notiz-Bereiche in allen Projektenread_access_tickets_all_projects: Lesezugriff auf alle Ticket-Bereiche in allen Projektenread_access_documents_all_projects: Lesezugriff auf alle Dokument-Bereiche in allen Projektenread_access_time_tracking_all_projects: Lesezugriff auf die Zeiterfassung in allen Projekten
Schreibzugriff pro Bereich:
write_access_chats_all_projects: Schreibzugriff auf alle Chat-Bereiche in allen Projektenwrite_access_notes_all_projects: Schreibzugriff auf alle Notiz-Bereiche in allen Projektenwrite_access_tickets_all_projects: Schreibzugriff auf alle Ticket-Bereiche in allen Projektenwrite_access_documents_all_projects: Schreibzugriff auf alle Dokument-Bereiche in allen Projektenwrite_access_time_tracking_all_projects: Schreibzugriff auf die Zeiterfassung in allen Projekten
Migration zu Pundit
Vorteile der Pundit-Integration
Die Migration von ProjectAccessService zu Pundit ProjectPolicy bietet folgende Vorteile:
- Konsistente Autorisierung: Ein einheitliches Framework für die gesamte Anwendung
- Bessere Testbarkeit: Policy-Objekte sind einfacher zu testen als Service-Klassen
- Klarere Hierarchie: Deutliche Trennung zwischen globalen und projektspezifischen Berechtigungen
- Einfachere Controller: Kürzerer Code durch Verwendung von
authorize @project, :action? - Verbesserter Schutz: Automatische Überprüfung von Berechtigungen für alle Controller-Aktionen
Implementierte Pundit Policies
Die folgenden Policy-Klassen wurden erstellt oder aktualisiert:
ApplicationPolicy: Basisklasse für alle Policies mit gemeinsamen MethodenProjectPolicy: Spezifische Policy für Projekte mit den folgenden Hauptmethoden:index?: Prüft, ob der Benutzer die Projektliste sehen darfshow?: Prüft, ob der Benutzer ein spezifisches Projekt sehen darfcreate?: Prüft, ob der Benutzer neue Projekte erstellen darfupdate?: Prüft, ob der Benutzer ein Projekt bearbeiten darfdestroy?: Prüft, ob der Benutzer ein Projekt löschen darfarea_access?(area, action): Prüft den Zugriff auf einen bestimmten Projektbereich
Berechtigungshierarchie
Die Berechtigungsprüfung erfolgt in folgender Hierarchie:
- Grundvoraussetzungen: Projekt existiert, Organisation existiert, Benutzer ist aktives Mitglied
- Admin-Status: Account-Admins haben immer vollen Zugriff
- Projektspezifische Berechtigungen: Haben Vorrang vor globalen Berechtigungen
no_accessauf Projektebene blockiert den Zugriff, selbst wenn globale Berechtigungen existierenread_only/read_writeauf Projektebene gewährt entsprechenden Zugriff
- Globale (rollenbasierte) Berechtigungen: Greifen, wenn keine projektspezifischen Berechtigungen definiert sind
Optimierungen für Listen-Ansichten
- Bedingte UI-Elemente:
- "Neues Projekt"-Button wird nur angezeigt, wenn der Benutzer Projekte erstellen darf
- (Das projektbezogene Dropdown-Menü gibt es nicht mehr, siehe unten.)
Entfernt am 06.09.2026:
ProjectPermissionCache(app/helpers/projects_helper.rb) cachte Berechtigungsergebnisse pro Request für Projektlisten. Die zugehörige Liste gibt es seit dem Briefing-Dashboard nicht mehr, ihr letztes Zeilenmenü wurde von keiner View mehr gerendert, und die Klasse setztecan_archive?/can_unarchive?/can_destroy?ein zweites Mal nebenProjectPolicyum. Beides ist mit der Seite "Archivierte Objekte" gelöscht worden (doc/archivierte_objekte_plan.md). Wer wieder eine Projektliste baut: erstProjectPolicyfragen, und einen Cache nur dann neu einführen, wenn eine Messung ihn verlangt.
Migration bestehender Berechtigungen
Für bestehende Installationen wurde eine Migrationsstrategie implementiert:
rake permissions:migrate_to_granular
Diese Task führt die folgenden Aktionen durch:
- Identifizierung aller Rollen mit
read_access_all_projects - Erstellung der bereichsspezifischen Leseberechtigungen für diese Rollen
- Identifizierung aller Rollen mit
write_access_all_projects - Erstellung der bereichsspezifischen Schreib- und Leseberechtigungen für diese Rollen
Best Practices
Für Entwickler, die mit diesem System arbeiten, empfehlen wir:
- Verwenden Sie
policy(@resource).action?oderauthorize @resource, :action?in Controllern - Nutzen Sie in Views
<% if policy(@resource).action? %>für bedingte Anzeige - Für Listen-Ansichten
includesnutzen und die Policy pro Zeile fragen; einen Berechtigungs-Cache erst einführen, wenn eine Messung ihn rechtfertigt - Definieren Sie neue Berechtigungen in
Permission::CATEGORIESund dokumentieren Sie diese inRolesHelper - Stellen Sie sicher, dass projektspezifische Berechtigungen immer Vorrang vor globalen haben
Nächste Schritte
In zukünftigen Versionen werden wir möglicherweise:
- Die Pundit-Integration auf weitere Ressourcen ausweiten (Notes, Tickets, etc.)
- Weitere feingranulare Berechtigungen einführen
- Ein erweitertes Caching-System für Berechtigungsprüfungen implementieren