ProofedMesh/docs/adr/README.md
CTO (Paperclip) ddbd304659
Some checks failed
build-images / approval-service image (push) Waiting to run
build-images / dummy-sink image (push) Waiting to run
phase1-smoke / Phase 1 end-to-end smoke (push) Waiting to run
validate / JSON Schema (ajv) (push) Waiting to run
validate / Rego (opa fmt + opa test) (push) Waiting to run
validate / Go (vet + test) (push) Waiting to run
validate / DB (migrate up/down dry-run) (push) Waiting to run
build-images / verification-service image (push) Has been cancelled
build-images / signing-service image (push) Has been cancelled
docs: Phase-1 wrap-up — README status, ADR-0006/0007/0008 (DEV-616)
- README: Phase 1 abgeschlossen, Service-Liste + Deploy-Pfade + phase1-smoke-Anleitung.
- ADR-0006: Approval-Service — WebAuthn als Content-Binding mit `nonce || H_content`,
  Alternative U2F-Challenge dokumentiert und als "challenge-only"-Fallback markiert.
- ADR-0007: Signing-Service — zweistufige Identität (Pocket-ID JWKS + K8s TokenReview),
  Fehlermodus `registry_identity_mismatch` explizit.
- ADR-0008: Dummy-Sink + zweistufige Verification-Chain, zentraler Replay-Guard
  in `verification_decisions`.

Co-Authored-By: Paperclip <noreply@paperclip.ing>
2026-10-25 21:23:30 +00:00

1.7 KiB

Architecture Decision Records (ADRs)

Dieses Verzeichnis dokumentiert durchlebte Architekturentscheidungen in MADR-Form. Jede ADR ist dauerhaft: einmal akzeptiert, wird sie nicht mehr editiert. Änderungen entstehen als neue ADR mit supersedes-Verweis.

Status-Werte

  • proposed — vorgeschlagen, Entscheidung steht noch aus
  • accepted — in Kraft
  • superseded — durch eine spätere ADR ersetzt (Verweis im Dokument)
  • deprecated — nicht mehr empfohlen, aber nicht offiziell ersetzt

Index

Nummer Titel Status
0001 Erster produktiver Rollout: eigene DB-App als Senke und Datenquelle accepted
0002 Session-Scope-Token-Format accepted
0003 PII-Retention-Richtlinie accepted
0004 Datenbank-Migrationsframework (golang-migrate) accepted
0005 Signing-Service- und Transparency-Log-API-Vertrag accepted
0006 Approval-Service — WebAuthn als Content-Binding-Mechanismus accepted
0007 Signing-Service — zweistufige Identitätsprüfung (Pocket-ID JWKS + K8s TokenReview) accepted
0008 Dummy-Sink und zweistufige Verification-Chain accepted

Vorlage: 0000-template.md.