Arbeitsprobe
Audit Evidence API
Kleine Backend-Aufgabe, vollständig durchgezogen: Spezifikation, Code, Tests, Review, Fixes, Beleg
Kurzprofil
Worum es geht
Diese Arbeitsprobe ist der beste Beleg für die Arbeitsweise: eine klar umrissene Backend-Aufgabe, in vier Review-Runden von 6,0 auf 8,8 gebracht, mit ehrlich dokumentierten Grenzen – und ohne eine einzige Produktionsbehauptung.
- Reifegrad
- lokal getestet
- Veröffentlichung
- öffentlich belegt
- Letzte Aktivität
- 2026-11-04
- Repository
audit-evidence-api
Beleglage in Kurzform
- 16 von 16 Tests bestanden, von unabhängigen Reviewern wiederholt
- Review-Historie: 6,0/7,7 → 8,4/8,2 → 8,3/8,2 → 8,8/8,8 APPROVE
- Sicherheitsentscheidungen: Mandant aus Token, Idempotenz mit 409, fail-closed
- Ehrliche Grenzen dokumentiert: unkeyed SHA-256, kein WORM, SQLite Single-Writer, kein TLS
Aufgabenstellung
Die Aufgabe
Eine lokale HTTP-API für Audit-Nachweise: aufnehmen, unveränderlich speichern, hash-verkettet prüfbar machen.
Die Anforderung war bewusst vollständig: Akzeptanzkriterien, Nicht-Ziele, Testfälle und ein definierter Review-Ablauf. Die Aufgabe ist synthetisch, ohne echte Kundendaten – und genau deshalb reproduzierbar.
| Methode und Pfad | Zweck |
|---|---|
| POST /api/v1/evidence | Record annehmen, validieren, Evidence-ID und Kettenvorgänger zurückgeben |
| GET /api/v1/evidence/{id} | Record lesen, mandanten-isoliert |
| GET /api/v1/evidence?project_id=&kind= | Liste mit Gesamtzahl, deterministisch sortiert |
| GET /api/v1/chain/{project_id}/verify | Hash-Kette prüfen: ok, Länge, Kopf, Bruchstelle |
| GET /health | öffentlich, ohne Token |
Kein Update, kein Delete
Es gibt bewusst keine Endpunkte zum Ändern oder Löschen. Korrekturen entstehen als neue Records – das ist der Kern einer append-only Evidenzkette.
Architektur
Sicherheitsentscheidungen, die Reviews überstanden haben
- Mandant
- kommt aus dem Token, nicht aus dem Body – Body-Wert nur als Konsistenzprüfung, bei Abweichung 403
- Akteur
- created_by wird aus dem Token abgeleitet (
token:<tenant>), nicht vom Client behauptet - Idempotenz
- an einen kanonischen Payload-Fingerprint gebunden: gleicher Schlüssel, anderer Payload ergibt 409
- Kettenanker
- pro Projekt ein Kopf mit Länge, damit Tail-Löschung erkannt wird
- Fail-closed
- ohne konfigurierte Tokens startet der Dienst nicht; Demo nur über explizite Option
- Fehlervertrag
- 400/401/403/404/405/409/411/413/415/503, Sammelfehler ohne Traceback
Der wichtigste Befund der ersten Review-Runde war ein Integritätsfehler: Der Hash lief über eine nicht normalisierte Repräsentation. Behoben wurde nicht das Symptom, sondern die Ursache – Feldprüfung und Normalisierung vor dem Hashen.
Reviews
Vier Runden, echte Punktzahlen
Die Historie ist ungekürzt: Auch die Reihenfolge von Ablehnung und Verbesserung steht so in den Belegen.
| Runde | Critic | Security | Ergebnis |
|---|---|---|---|
| 1 | 6,0 | 7,7 | REQUEST_CHANGES |
| 2 | 8,4 | 8,2 | REQUEST_CHANGES |
| 3 | 8,3 | 8,2 | REQUEST_CHANGES |
| 4 | 8,8 | 8,8 | APPROVE – keine kritischen oder schweren Findings |
Zwischen den Runden wuchs die Testzahl von 8 auf 11, auf 14 und schließlich 16 – jede Korrektur kam mit einem Regressionstest. Die Reviews liefen in unabhängigen Kontexten, nicht im selben Durchlauf wie die Implementierung.
Abgrenzung
Grenzen – ausdrücklich nicht behauptet
- Unkeyed SHA-256, kein HMAC, kein KMS – konsistentes Neu-Hashing bleibt unentdeckt.
- Anker liegt in derselben Datenbank; ein kompletter Projekt-Wipe ist nicht erkennbar.
- SQLite mit einem Schreiber, keine Last- oder Mehrprozessnachweise.
- Kein TLS, keine Zugriffsprotokolle, keine Aufbewahrungsregeln.
- In-Memory-Token ohne Rotation und Rollen.
- Keine Produktions-, Compliance- oder Skalierungsaussage.
Was das Paket dennoch belegt
Eine vollständige Ingenieurschleife: Spezifikation, Implementierung, Test, unabhängiges Review, Korrektur, erneutes Review, Beleg. Genau das lässt sich in einem Bewerbungsgespräch schwer behaupten und leicht prüfen.
Belege
Provenienz
Welche Datei welche Aussage trägt.
| Datei | Aussage | SHA-256 |
|---|---|---|
docs/EVIDENCE.md | Testlauf 16 passed | |
architecture.md | Architektur und Sicherheitsentscheidungen | |
security-review.md | Review-Historie und Restrisiken |