MPM – Phasen-Übersicht

Der Arbeitsplan sieht zehn inkrementelle Phasen vor. Nach jeder Phase muss das System startbar und testbar sein.

Phase	Bereich	Status
1	Grundgerüst (Docker, DB, Login, Rollen)	✅ Abgeschlossen
2	Benutzerverwaltung	✅ Abgeschlossen
3	Modul-System (Manifest, Installation, Lifecycle)	✅ Abgeschlossen
4	Gateway & dynamisches Routing (`/slug`)	⏳ Geplant
5	Berechtigungssystem (User ↔ Module)	⏳ Geplant
6	Modul-API (`/health`, `/api/manifest`, `/api/me`)	⏳ Geplant
7	Referenzmodul Kalender	⏳ Geplant
8	Modul-SDK (`platform-module-sdk`)	⏳ Geplant
9	Administration (Übersichten, Audit-UI, Einstellungen)	⏳ Geplant
10	Security Hardening & Produktivbetrieb	⏳ Geplant

Phase 1 – Grundgerüst (abgeschlossen)

Definition of Done:

Definition of Done: Admin kann Benutzer vollständig verwalten.

GET/POST/PATCH/DELETE /api/v1/users/* (nur @Roles('ADMIN'))
Benutzerliste, Benutzer anlegen (Zod-Validierung, Duplikat-Schutz 409)
Benutzer bearbeiten (Anzeigename, E-Mail, Rolle)
Benutzer deaktivieren/aktivieren (Sessions werden sofort ungültig)
Passwort-Reset durch Admin (alle Sessions des Benutzers werden gelöscht)
Schutzregeln: keine Selbst-Deaktivierung/-Löschung, letzter aktiver Admin geschützt
Profil-Endpunkte (GET /api/v1/profile, PATCH /api/v1/profile/password)
Eigenes Passwort ändern (Verifikation des aktuellen Passworts, andere Sessions werden abgemeldet)
Frontend: Benutzerverwaltungs-Seite (Tabelle, Create/Edit/Reset/Delete-Modals, Toasts)
Frontend: Profil-Seite mit Passwortänderung
UI-Komponenten: Modal, Select, Toast (Design-System erweitert)
Backend-Tests: 49 bestanden (inkl. UsersService, ProfileService)
E2E verifiziert: CRUD, RBAC (User → 403), Login-Sperre nach Deaktivierung, Passwort-Flows

Definition of Done: Modul-Datenmodell, Manifest, Installation, Registrierung, Status, Start/Stop/Restart, Healthcheck.

modules-Tabelle (Migration 002) mit Lifecycle-Status und eindeutigen Ports/Slugs
Manifest-Vertrag module.json (Zod: ID, Name, Version, Slug, Runtime, Entrypoint, Port 41000–41999, Healthcheck, apiVersion)
ZIP-Installer mit Manifest-Validierung, Größenlimit (10 MB) und Zip-Slip-Schutz
Modul-Prozess-Manager: Start/Stop (SIGTERM→SIGKILL) als Kindprozesse, minimale ENV (keine Plattform-Secrets), eigene Log-Dateien
Healthcheck-Service mit Startup-Grace (10 Retries × 500 ms)
Lifecycle: INSTALLED → STARTING → RUNNING → STOPPING → STOPPED, ERROR, DISABLED
GET/POST /api/v1/modules, POST :id/start|stop|restart, PATCH :id/enabled, GET :id/health, DELETE :id (nur ADMIN)
Duplikat-Schutz: Modul-ID, Slug und Port müssen eindeutig sein (409)
Frontend: Modulverwaltungs-Seite (ZIP-Upload, Tabelle mit Status-Badges, Lifecycle-Buttons, Health-Anzeige, Remove-Dialog)
Persistente Volumes für Modul-Dateien und Logs (modules-data, module-logs)
Demo-Modul (modules/demo) als Referenzimplementierung
Backend-Tests: 72 bestanden (inkl. ModulesService-Lifecycle, Manifest-Validierung, Installer)
E2E verifiziert: Installation (201), Start → RUNNING, Healthcheck (healthy, 2 ms), Stop, Restart, Disable (stoppt Prozess), Start-Sperre bei Disable (400), Remove, RBAC (USER → 403)