Laufzettel/docs/issues/004-epic-phase-4.md

#004 Phase 4: Aktionen, Connectors, REST-API

Status: offen Meilenstein: v0.4.0 Labels: phase-4 Geschätzt: – Tatsächlich: –

Ziel

Nicht im MVP umsetzen. Der Weg dorthin wird im MVP aber bewusst freigehalten: Die in den Vorlagen vorbereiteten PowerShell-Befehle sind die Vorstufe von Schritten, die die App selbst ausführt.

Aufgaben

• Schritt-Typ AKTION mit Connector und Parametern aus Variablen und Person
• Connectors: LDAP/AD schreibend über eigenes Dienstkonto, Microsoft Graph (Entra ID, Exchange Online, Intune), authentik-API, später Ticketsystem und RMM
• Onboarding als Aktion: Konto anlegen, Initialpasswort erzeugen und sicher übergeben, Gruppen laut Abteilung, Postfach und Lizenz
• Offboarding als Aktion: Konto sperren, Sitzungen widerrufen, Postfach in Shared Mailbox wandeln
• Vorschau „das wird passieren“, ausdrückliche Bestätigung, Ergebnis-Log am Schritt, Rollback-Hinweis
• Fehler setzen den Schritt auf FEHLGESCHLAGEN mit Meldung
• Berechtigung je Connector und Rolle, Geheimnisse verschlüsselt, alle Aufrufe im Protokoll
• Wiederkehrende Läufe (v0.5.0)
• REST-API und Webhooks, Start aus Ticketsystem und Wartungsplaner (v0.5.0)
• Zeiterfassung je Lauf, automatische Prüfschritte per RMM-API, Auswertungen, Aufbewahrungsfristen, NFC-Tags (v0.5.0)

Vorleistung im MVP

• SchrittTyp ist ein Enum, dem AKTION ohne Migration bestehender Daten hinzugefügt werden kann; konfig (Json) trägt dann Connector und Parameter
• Schrittergebnis.wert ist ein Json, das ein Aktionsergebnis mit Log, IDs und Zeitstempeln aufnimmt
• Kein Codepfad nimmt an, dass ein Schritt nur von einem Menschen erledigt wird — aktualisiertVonId ist optional und ein Systemlauf ist darstellbar
• Das Krypto-Modul für das LDAP-Bind-Passwort (#006) ist schon der Platz für Connector-Geheimnisse
• NFC nutzt dieselbe URL {APP_URL}/t/{tagCode} wie der QR-Code