Engineering · Medien vom Mond

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.

Python 3.10StandardbibliothekSQLite WALpytestHTTP-JSON-APIHash-Kettenunabhängige Reviews
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.

API-Vertrag
Methode und PfadZweck
POST /api/v1/evidenceRecord 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}/verifyHash-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.

Review-Historie mit echten Scores
RundeCriticSecurityErgebnis
16,07,7REQUEST_CHANGES
28,48,2REQUEST_CHANGES
38,38,2REQUEST_CHANGES
48,88,8APPROVE – 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.

Quellen dieser Projektseite
DateiAussageSHA-256
docs/EVIDENCE.mdTestlauf 16 passed
architecture.mdArchitektur und Sicherheitsentscheidungen
security-review.mdReview-Historie und Restrisiken