Ziel: Nachvollziehbarkeit ohne Overhead. Dieses Logging-Setup deckt Prüfungen/Audits ab und ist in 30 Minuten startklar.
Siehe Glossar: Logging/Protokollierung, KPI, Übersteuern.

1) Die 10 Pflichtfelder (minimal, aber auditfähig)

  1. log_id – eindeutige ID (z. B. LOG-2025-0001)
  2. timestamp – ISO-Zeit in UTC (2025-09-15T10:30:00Z)
  3. actor – wer hat gehandelt (User-ID/Rolle)
  4. system – Name, Modell/Version, Umgebung (prod/test)
  5. input_ref – Bezug auf den Vorgang (z. B. REQ-…)
  6. features – relevante Merkmale (Sprache, Dokumenttyp …)
  7. score – numerischer Output/Score
  8. decision – getroffene Entscheidung (z. B. manuelle_pruefung)
  9. override – Übersteuern: ja/nein + Grund + wer
  10. meta – optional: Dauer, Hinweise, Korrekturen

Praxis: Felder 1–9 reichen oft aus. meta hilft für Analysen (z. B. Performance).

2) Minimal-JSON (Copy & Paste)

{
  "log_id": "LOG-2025-0001",
  "timestamp": "2025-09-15T10:30:00Z",
  "actor": { "user_id": "u123", "role": "HR" },
  "system": { "name": "RecruitAI", "model": "v1.4.2", "env": "prod" },
  "input_ref": "REQ-2025-0001",
  "features": { "lang": "de", "doc_type": "CV" },
  "score": 0.58,
  "decision": "manuelle_pruefung",
  "override": { "applied": true, "reason": "Grenzfall/Erfahrung", "by": "u123" },
  "meta": { "latency_ms": 320, "notes": "Uneinheitliches PDF" }
}

Direkt einsetzbar: Du findest dieses Schema auch bei den /demos/.

3) Typische Fehler (und wie du sie vermeidest)

  • Keine Version/ID des Systems → Immer system.model & env mitschreiben.
  • Override ohne Grund → Kurzbegründung verpflichtend (ein Satz reicht).
  • Score ohne Entscheidung → Menschen treffen Entscheidungen; Score allein ist kein Ergebnis.
  • Freitext statt Referenz → Vorgänge mit input_ref referenzieren (besser durchsuchbar).
  • Kein Uhrzeit-Standard → ISO-8601/UTC verwenden, lokale Zeit nur zusätzlich.

4) Mini-Checkliste (vor Go-Live)

  • [ ] Felder 1–9 sind implementiert
  • [ ] IDs: LOG-* und REQ-* sind eindeutig
  • [ ] Override-Pflichtbegründung aktiviert
  • [ ] Zeitstempel in UTC (ISO-Format)
  • [ ] Testfälle im Audit Proof Pack abgelegt

5) Nächste Schritte

Vorlage: Oversight-Kurzprotokoll & JSON zum Kopieren findest du unter /demos/.