ITSM/docs/adr/ADR-010-groundcontrol-platt...

2.1 KiB
Executable File
Raw Blame History

ADR-010: Groundcontrol — Plattform als Kern, ITSM als Modul

Datum: 2026-07-28 · Status: Akzeptiert (ersetzt ADR-009) Vorgabe: "Wir brauchen einen besseren Projektnamen für die Plattform und ITSM darf nicht der Kern sein, eher ein Bestandteil (von Anfang an)."

Kontext

ADR-009 hatte HR/CRM als Module in die bestehende ITSM-Anwendung gehängt: das ITSM blieb Namens- und Codekern (Repo mscadm/ITSM, Binary itsm, Routen ohne Modul-Präfix, Rollen in itil.rs). Mit weiteren Domänen — insbesondere der Systemverwaltung (Groundwork-OS, Linux, Windows) — wird diese Schieflage strukturell falsch: Fleet ist kein „ITSM-Feature".

Entscheidung

Name: GROUNDCONTROL (Fortsetzung der Hausmarke Leerlauf.works / Groundwork-OS / PureIdle: Fundament legen → von hier steuern).

Neues Repo mscadm/groundcontrol; mscadm/ITSM wird nach der Migration archiviert. Codeschnitt trennt Kern und Module strikt:

src/platform/   Mandanten, Auth/Sessions, RBAC, Audit, Retention,
                UI-Shell, Konfiguration, DB-Pool   (modulagnostisch)
src/modules/servicedesk/   ITIL v3/v4 (vormals „das ITSM")
src/modules/people/        HR
src/modules/sales/         CRM
src/modules/fleet/         Systemverwaltung (siehe ADR-011)
src/modules/aes/           AES-Suite-Erweiterung

Module sind gleichrangig: eigener Routen-Präfix, eigene Tabellen-Präfixe (sd_, hr_, crm_, fleet_), eigene Rolle(n), eigene Nav-Gruppe, eigene Doku. Der Kern kennt kein Modul namentlich außer in der Registrierung.

Bestandsdaten bleiben: bestehende Tabellen (tickets, kb_articles, …) werden NICHT umbenannt (Datenrisiko ohne Nutzen); der Präfix gilt für neue Tabellen.

Konsequenzen

  • Fleet und künftige Domänen sind erstklassig statt „angebaut".
  • Kern bleibt schlank und wiederverwendbar; Module sind einzeln testbar.
  • Marke passt zur Produktfamilie; „ITSM" wird zum Modulnamen Service Desk. Einmaliger Migrationsaufwand (Repo, Pfade, URLs, Doku, Deployment). Ein-Rollen-Modell wird durch Fleet endgültig zu eng → Modul-Grants sind als groundcontrol phase-003 eingeplant.