mscadm
/
ITSM
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
ITSM-Plattform (Service-Katalog, Tickets, Wissensdatenbank, Assets) -- AES ist ein buchbarer Service darin.
39 Commits 1 Branch 0 Tags 502 KiB
Rust 71.7%
HTML 19.1%
JavaScript 5.7%
CSS 3%
Shell 0.3%
Other 0.2%
Go to file
Moe 97facdce18 docs: technische Dokumentation + ADRs 
- docs/ARCHITEKTUR.md: Module, Datenmodell, Request-Fluss, RBAC-Matrix,
  ITIL-Abbildung, Sicherheitsarchitektur
- docs/BETRIEB.md: ENV-Referenz, Deployment-/Update-Prozedur (SRV1361746),
  Backup/Retention, Troubleshooting (inkl. Werkzeug-Hash-Diagnose,
  Rate-Limit-Entsperrung), Monitoring-Punkte
- docs/adr/: ADR-001..008 (Rust-Rewrite, Server-Sessions, Hash-Migration
  inkl. scrypt-Lehre, ITIL-Rollen/Change-Gate, idempotente Migrationen,
  Multi-Stage-Build, CSP, SSRF-Policy) + Index
- README: Verweis auf docs/ und Prozess-Doku in mscadm/AES projects/itsm (dev)
 		2026-07-15 11:49:47 +02:00
deploy feat!: Rust-Rewrite (axum/PostgreSQL) mit ITIL-v3/v4-Prozessen und Sicherheits-Haertung 2026-07-15 05:02:02 +02:00
docs docs: technische Dokumentation + ADRs 2026-07-15 11:49:47 +02:00
src fix(auth): Werkzeug-scrypt-Hashes verifizierbar (Bestandskonten-Login) 2026-07-15 09:53:47 +02:00
static feat(ui): Dashboard-Redesign nach Nutzer-Mockup + Kanban, Suche, Pagination, Bulk-Aktionen 2026-07-15 05:23:26 +02:00
templates feat(ui): Dashboard-Redesign nach Nutzer-Mockup + Kanban, Suche, Pagination, Bulk-Aktionen 2026-07-15 05:23:26 +02:00
.gitignore feat!: Rust-Rewrite (axum/PostgreSQL) mit ITIL-v3/v4-Prozessen und Sicherheits-Haertung 2026-07-15 05:02:02 +02:00
Cargo.lock fix(auth): Werkzeug-scrypt-Hashes verifizierbar (Bestandskonten-Login) 2026-07-15 09:53:47 +02:00
Cargo.toml fix(auth): Werkzeug-scrypt-Hashes verifizierbar (Bestandskonten-Login) 2026-07-15 09:53:47 +02:00
Dockerfile feat!: Rust-Rewrite (axum/PostgreSQL) mit ITIL-v3/v4-Prozessen und Sicherheits-Haertung 2026-07-15 05:02:02 +02:00
README.md docs: technische Dokumentation + ADRs 2026-07-15 11:49:47 +02:00
schema.sql feat!: Rust-Rewrite (axum/PostgreSQL) mit ITIL-v3/v4-Prozessen und Sicherheits-Haertung 2026-07-15 05:02:02 +02:00

README.md

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