ITSM/README.md

Dieses Repo ist Historie. Groundcontrol (mscadm/groundcontrol) hat den Code seit 2026-07-28 uebernommen; das ITSM lebt dort als Modul Service Desk weiter (siehe ADR-010). Neue Arbeit bitte im Groundcontrol-Repo.

ITSM

ITSM-Plattform (Service-Katalog, Tickets, Wissensdatenbank, CMDB) -- AES ist ein buchbarer Service darin. Eigenstaendiges Produkt, mandantenfaehig.

Stack: Rust (axum + tokio-postgres + askama), PostgreSQL 16. Rust-Rewrite 2026-07-15; zuvor Python/Flask -- Bestandsdaten (inkl. Passwort- Hashes) werden ohne Migration weiterverwendet, alte Werkzeug-PBKDF2-Hashes werden beim ersten Login transparent auf Argon2id umgestellt.

ITIL-Ausrichtung (v3-Prozesse / v4-Practices)

• Rollen: admin (Service Owner/IT-Leitung), change_manager (Change Enablement/CAB), agent (Service Desk), user (Requester/Self-Service: eigene Tickets, nur freigegebene Wissensartikel).
• Incident/Service Request: getrennte Kategorien; Statusmodell mit erzwungenen Uebergaengen (Offen -> In Bearbeitung -> Warten/Geloest -> Geschlossen; Reopen von Geloest).
• Prioritaet: automatisch aus der Impact-x-Urgency-Matrix (v3 SO 4.2.5.4).
• Change Enablement: Standard (vorautorisiert) / Normal (CAB-Freigabe durch change_manager/admin) / Emergency (sofort, nachtraegliche ECAB-Freigabe). Umsetzung + Repo-Aenderungen erst nach Freigabe.
• Problem Management: Incident-Problem-Verknuepfung, Known-Error-Status.
• SLA (Service Level Management): Antwort-/Loesungsfristen mit Zeitstempeln (erste Reaktion, Loesung, Schliessung), Ueberfaelligkeit.
• Knowledge Management: Freigabe-Workflow (Entwurf -> Freigegeben).
• SACM/CMDB: CIs, Beziehungen, Ticket-CI-Verknuepfung.
• Continual Improvement: Dashboard mit SLA-Erfuellung, MTTR, Verteilungen.

Sicherheit

• Serverseitige Sessions in PostgreSQL (Cookie enthaelt nur ein Zufallstoken, DB speichert dessen SHA-256; Logout/Sperrung widerruft sofort).
• CSRF-Schutz fuer alle zustandsaendernden Requests (Formular-Feld/Header).
• Login-Rate-Limit (pro E-Mail und IP, DB-gestuetzt), Audit-Log aller sicherheitsrelevanten Aktionen (ISO 27001 A.12.4 / DSGVO Art. 30).
• Argon2id-Passwoerter, Policy: min. 12 Zeichen.
• Security-Header (CSP ohne Inline-JS, X-Frame-Options, nosniff, HSTS bei ITSM_HTTPS=1); X-Forwarded-For nur bei ITSM_TRUSTED_PROXY_COUNT > 0.
• SSRF-Guard fuer Service-Endpoint-URLs (Link-Local/Metadaten blockiert, Anlegen admin-only); Erreichbarkeitspruefung parallel + gecacht.
• Repo-Bearbeitung aus Tickets (Forge-Contents-API, phase-008): nur admin/change_manager, nur aus freigegebenen Change-Tickets, jede Aenderung zwingend im Worklog dokumentiert.
• DSGVO-Retention: automatische Bereinigung von Tickets/Audit-Log gemaess Mandanten-Fristen; Login-Versuche nach 7 Tagen, abgelaufene Sessions sofort.

Dokumentation

• docs/ARCHITEKTUR.md — technische Architektur (Module, Datenmodell, Request-Fluss, RBAC-Matrix, ITIL-Abbildung)
• docs/BETRIEB.md — Betriebshandbuch (ENV, Deployment/Update, Backup, Troubleshooting)
• docs/adr/ — Architecture Decision Records (ADR-001 bis ADR-008)
• Prozess-Doku nach AES-Regelwerk (Projektbeschreibung, Phasen-/Forensik-Reports, Tasks): mscadm/AES, Branch dev, Verzeichnis projects/itsm/

Betrieb

# Entwicklung
DATABASE_URL=postgresql://itsm:pw@localhost:5432/itsm cargo run

# Produktion: siehe deploy/docker-compose.yml (Multi-Stage-Build,
# kein Code-Pull beim Container-Start mehr)

ENV-Variablen: siehe src/config.rs. Schema-Migrationen laufen idempotent beim Start (schema.sql). Backup: deploy/backup.sh (taeglicher pg_dump, 14 Tage).

Tests

cargo test    # ITIL-Statusmodell, Prioritaetsmatrix, Change-Gate,
              # Argon2/Werkzeug-Hash-Verifikation, SSRF-Guard, Policy