# Changelog

Alle nennenswerten Änderungen an diesem Projekt werden hier dokumentiert.
Format angelehnt an [Keep a Changelog](https://keepachangelog.com/de/1.0.0/);
Versionierung nach [SemVer](https://semver.org/lang/de/).

## [1.0.0] – 2026-07-07

Erste Auslieferung des **barox Switch Test Companion** (Version 1).

### Hinzugefügt
- **Geführter Testmodus (Assistent)** über 7 Schritte: Stammdaten, Testumgebung,
  Topologie, Testfälle, SFP-Matrix, Szenarien, Zusammenfassung.
- **Excel-Import** der Checkliste (`Switch Test Checklist`, `SFP`, `Szenarien`)
  in versionierte Vorlagen inkl. abhängigkeitsfreiem XLSX-Reader.
- Vollständige Übernahme der Excel-Inhalte: 150 Testfälle in 15 Kategorien,
  18 SFP-Module, 10 Szenarien.
- **Testlauf-Stammdaten**, **Testumgebung** und **Topologie** (Geräte,
  Verbindungen, Ring-Kennzeichnung, Topologiezeichnung als Upload).
- **Testfall-Erfassung**: Status, Priorität, Bewertung (1–10), Ist-Ergebnis,
  Messwerte, Notizen, interne Bemerkung, Hersteller-Rückfrage, Nachweise.
- **SFP-Testmatrix** mit DOM/DDM-Werten, Hot-Plug, Link/Speed/Duplex, Ergebnis.
- **Szenarien** mit Testziel, Voraussetzungen, Schritten, Messwerten, Bewertung.
- **Automatische Findings** aus fehlgeschlagenen/teilweisen Tests; manuelle
  Findings mit Schweregrad, Auswirkung, Maßnahme, Verantwortlichem.
- **Empfehlungs-Engine** (Freigeben/Nachbessern/Ablehnen) mit transparenter
  Begründung; manuell überschreibbar mit Pflichtbegründung.
- **Dashboard** mit Kennzahlen, Fortschritt, Ampelstatus, letzten Aktivitäten.
- **PDF-Report** im barox Corporate Design (dompdf) mit Deckblatt, Executive
  Summary, Empfehlung, Findings, Detailtabellen, SFP-Matrix, Szenarien,
  Nachweisverzeichnis; HTML-Druck-Fallback ohne dompdf.
- **Datei-Uploads** (PNG, JPG, PDF, TXT, LOG, CSV, PCAP, PCAPNG, ZIP) mit
  Endungs- und MIME-Validierung, Größenbegrenzung, Ablage unter
  `storage/test-runs/{id}/…`.
- **Rollen- & Rechtesystem** (Admin/Tester/Viewer), **lokale Anmeldung** und
  **Microsoft 365 / Entra ID** (OpenID Connect) mit Just-in-Time-Provisioning.
- **Admin-Bereich**: Excel-Import, Testfall-/SFP-/Szenario-Vorlagen,
  Benutzerverwaltung, Einstellungen.
- **Audit-Log** für alle relevanten Aktionen.
- **Automation-Prototyp**: SNMP-System-Info (sysName/sysDescr/sysUpTime),
  v1/v2c/v3; Adapter-Architektur (`ProbeInterface`, `AutomationRegistry`) für
  Version 2 vorbereitet.
- **Vorlagen-Versionierung**: neue Importe beschädigen bestehende Testläufe
  nicht (Snapshot-Kopie beim Anlegen).
- CLI-Skripte: `migrate`, `import_excel`, `seed` (inkl. `--demo`),
  `create_admin`, `genkey`.
- Dokumentation: README, Ubuntu-Installationsanleitung (`docs/INSTALL.md`).

### Sicherheit
- CSRF-Schutz, Prepared Statements, Passwort-Hashing, Rechteprüfung per
  Middleware, Upload-Whitelist, Secrets nur in `.env`, Log-Maskierung
  sensibler Felder, Session-Timeout und Session-Regeneration.

### Bekannte Einschränkungen / Ausblick (Version 2)
- Weitere Automation-Adapter (SNMP Walk/Set/Trap, SSH, iPerf, LLDP, SFP-DOM,
  Monitoring, PoE, Firmware-Auslesung, Umschaltzeit-Messung).
- Optionale JWKS-Signaturprüfung der MS365-ID-Token.
- E-Mail-Benachrichtigungen (SMTP-Konfiguration bereits vorbereitet).