|
|
||
|---|---|---|
| deploy | ||
| docs | ||
| src | ||
| static | ||
| templates | ||
| .gitignore | ||
| Cargo.lock | ||
| Cargo.toml | ||
| Dockerfile | ||
| README.md | ||
| schema.sql | ||
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, Branchdev, Verzeichnisprojects/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