Change Management¶

TCM365 implementiert einen strukturierten Change Management-Prozess mit mehrstufigen Approval Chains, ausgerichtet an ITIL Change Management-Praktiken.

Approval Workflow¶

sequenceDiagram
    participant R as Requester
    participant A as Approver(s)
    participant AD as Administrator

    R->>A: Change Request einreichen
    A-->>R: Request in Prüfung
    A->>AD: Genehmigt / Abgelehnt
    AD-->>R: Genehmigt / Abgelehnt
    AD->>AD: Implementierung (Rollback-Integration)
    AD-->>R: Implementierung abgeschlossen

ChangeRequest Entity¶

Feld	Typ	Beschreibung
`id`	UUID	Primärschlüssel
`title`	string	Change Request-Titel
`description`	text	Detaillierte Aenderungsbeschreibung
`type`	enum	`standard`, `normal`, `emergency`
`priority`	enum	`low`, `medium`, `high`, `critical`
`status`	enum	`draft`, `submitted`, `under_review`, `approved`, `rejected`, `implementing`, `completed`, `cancelled`
`requester_id`	UUID	FK zum anfordernden Benutzer
`affected_systems`	JSONB	Vom Change betroffene Systeme
`implementation_plan`	text	Schritt-für-Schritt Implementierungsplan
`rollback_plan`	text	Rollback-Schritte bei Fehlschlag
`scheduled_at`	timestamp	Geplantes Implementierungsdatum
`completed_at`	timestamp	Tatsaechliches Abschlussdatum
`created_at`	timestamp	Erstellungsdatum

ChangeApproval Entity¶

Feld	Typ	Beschreibung
`id`	UUID	Primärschlüssel
`change_request_id`	UUID	FK zum Change Request
`approver_id`	UUID	FK zum genehmigenden Benutzer
`decision`	enum	`approved`, `rejected`, `deferred`
`comments`	text	Genehmigungskommentare
`decided_at`	timestamp	Entscheidungszeitpunkt

Frontend-Komponenten¶

ChangeRequestCard -- Zusammenfassungskarte mit Status-Badge
ApprovalChain -- Visuelle Darstellung der Genehmigungskette mit Statusanzeigen

API-Endpoints¶

Methode	Endpoint	Beschreibung
`GET`	`/api/v1/change-management`	Alle Change Requests auflisten
`POST`	`/api/v1/change-management`	Change Request erstellen
`GET`	`/api/v1/change-management/{id}`	Change Request-Details abrufen
`PUT`	`/api/v1/change-management/{id}`	Change Request aktualisieren
`POST`	`/api/v1/change-management/{id}/approve`	Change Request genehmigen
`POST`	`/api/v1/change-management/{id}/reject`	Change Request ablehnen

Rollback-Integration¶

Change Requests können direkt mit Rollback-Operationen verknüpft werden:

Change Request mit Rollback-Begründung erstellen
Genehmigung durch Approval Chain einholen
Rollback mit changeRequestId-Referenz ausführen
Ergebnisse automatisch am Change Request dokumentiert

Best Practices¶

Alle Änderungen dokumentieren -- Auch kleine Änderungen durch Change Requests leiten
Emergency Changes nachtraeglich dokumentieren -- Notfall-Änderungen im Nachgang formal erfassen
Rollback-Plan pflichtmaessig -- Jeder Change Request muss einen Rollback-Plan enthalten
Betroffene Systeme vollständig auflisten -- Für Impact-Analyse und Benachrichtigungen