#129: `IHKRight.java`

plugins/org.projectforge.plugins.ihk/src/main/java/org/projectforge/plugins/ihk/IHKRight.java Zugriffskontrolle, plugins/org.projectforge.plugins.ihk/src/main/java/org/projectforge/plugins/ihk/IHKRight.java 59 Zeilen · 26 Code · 28 Kommentare · 5 leer

Zugriffsrechte-Prüfung für das IHK-Plugin. Erweitert UserRightAccessCheck<TimesheetDO>, um sicherzustellen, dass Benutzer über den IHK-Ausbildungsbericht nur ihre eigenen Zeiterfassungen einsehen und exportieren können.

Architektur

IHKRight wird in IHKPlugin.initialize() über registerRight(new IHKRight()) registriert und regelt den gesamten Zugriff auf Zeiterfassungsdaten im Kontext des IHK-Moduls.

Konstruktor

public IHKRight() {
    super(IHKPluginUserRightId.IHK, UserRightCategory.PLUGINS, UserRightValue.TRUE);
}

Bindet an den Enum-Wert IHKPluginUserRightId.IHK (ID "PLUGIN_IHK"), kategorisiert unter PLUGINS, mit Standardwert TRUE (standardmäßig für alle Benutzer aktiviert). Dies bedeutet, dass das Recht in der Benutzerverwaltungsoberfläche unter der Kategorie Plugins erscheint und zunächst jedem gewährt wird.

Zugriffslogik

Die Methode hasAccess(PFUserDO user, TimesheetDO obj, TimesheetDO oldObj, OperationType operationType) implementiert eine einfache Eigentümerprüfung:

Wenn sowohl obj als auch oldObj null sind, wird true zurückgegeben – allgemeiner Einfüge-/Auswahlzugriff wird standardmäßig gewährt.
Andernfalls wird user.getId() mit timesheet.getUserId() mittels Objects.equals() verglichen – nur der Eigentümer des Zeiterfassungsdatensatzes kann über das IHK-Modul darauf zugreifen.

Entwurfsentscheidungen

Standardmäßig aktiviertes Recht: Die Verwendung von UserRightValue.TRUE bedeutet, dass alle Benutzer standardmäßig das IHK-Recht haben. Administratoren können es pro Benutzer oder pro Gruppe in der Zugriffsverwaltungsoberfläche entziehen, aber der typische Auszubildende benötigt keine explizite Zuweisung.
Nur-Eigentümer-Zugriff: Die Prüfung ist bewusst einfach gehalten. Ein Auszubildender kann nur seine eigenen Zeiterfassungen exportieren. Es gibt keine Manager-/Vorgesetzten-Übersteuerung innerhalb dieser Klasse – umfassendere Zugriffe würden über andere ProjectForge-Zugriffsmechanismen gewährt (z. B. die eigenen Zugriffsprüfungen von TimesheetDao).
Nullsicher: Verwendet oldObj != null ? oldObj : obj, um Aktualisierungsszenarien zu behandeln, in denen das ursprüngliche Objekt die relevante Benutzer-ID tragen könnte.

Abhängigkeiten

Klasse	Rolle
`UserRightAccessCheck<T>`	Abstrakte Basis, die das Rahmenwerk zur Rechteregistrierung bereitstellt
`IHKPluginUserRightId.IHK`	Enum-Konstante, die dieses Recht im System identifiziert
`TimesheetDO`	Domänenobjekt, das durch dieses Recht geschützt wird

Git-Verlauf

868d6abb7 2025 -> 2026
63081666f Quelltextdatei-Header: 2024 -> 2025.
4efcbd0fb Migration in Arbeit...
b6092df09 Copyright 2023 -> 2024
ab45d51fa Copyright 2001-2022 -> 2001-2023.
5f7ef41b8 Copyright 2021 -> 2022
ceb63e8a1 Quelltextcode-Header: (C) 2001-2021.
7c79f1922 Copyright des Quelltext-Headers -> 2020.
45cad02e9 IHK-Plugin hinzugefügt (wird langfristig das "Ihk-Export"-Plugin ersetzen)