ProofedMesh/docs/adr
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
..
0000-template.md docs(adr): add ADR template and ADR-0001..0003 (DB-App scope, session scope tokens, PII retention) 2026-10-25 15:11:23 +00:00
0001-first-rollout-db-app-scope.md docs(adr): add ADR template and ADR-0001..0003 (DB-App scope, session scope tokens, PII retention) 2026-10-25 15:11:23 +00:00
0002-session-scope-token-format.md docs(adr): add ADR template and ADR-0001..0003 (DB-App scope, session scope tokens, PII retention) 2026-10-25 15:11:23 +00:00
0003-pii-retention-policy.md docs(adr): add ADR template and ADR-0001..0003 (DB-App scope, session scope tokens, PII retention) 2026-10-25 15:11:23 +00:00
0004-db-migrations.md db: add ADR-0004 (golang-migrate), db/ layout, 0001_per_diem_rates migration (up+down) with EXCLUDE constraint and immutability trigger 2026-10-25 17:28:00 +00:00
0005-signing-service-and-transparency-log-api.md attest+tlog: ADR-0005 Signing/TLog API contract, HTTP clients + orchestrator in admin-api (go vet clean, 11 new tests pass) 2026-10-25 17:51:33 +00:00
0006-approval-service-webauthn-content-binding.md docs: Phase-1 wrap-up — README status, ADR-0006/0007/0008 (DEV-616) 2026-10-25 21:23:30 +00:00
0007-signing-service-dual-identity-check.md docs: Phase-1 wrap-up — README status, ADR-0006/0007/0008 (DEV-616) 2026-10-25 21:23:30 +00:00
0008-dummy-sink-and-verification-chain.md docs: Phase-1 wrap-up — README status, ADR-0006/0007/0008 (DEV-616) 2026-10-25 21:23:30 +00:00
README.md docs: Phase-1 wrap-up — README status, ADR-0006/0007/0008 (DEV-616) 2026-10-25 21:23:30 +00:00

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.