dorfteich/docs/architecture/adr
Claude Fable 5 18239e2fa9
All checks were successful
CD / Deploy to Test (push) Successful in 12s
CD / Smoke tests against Test (push) Successful in 1m15s
CD / Promote to Int (push) Successful in 12s
CI / Lint, typecheck, test (push) Successful in 6m19s
CI / Build container images (push) Has been skipped
CI / Auth e2e pack (push) Successful in 8m13s
CI / Import/export fidelity gate (push) Successful in 54s
CI / Lint, typecheck, test (pull_request) Successful in 6m20s
CI / Build container images (pull_request) Successful in 1m12s
CI / Auth e2e pack (pull_request) Successful in 8m24s
CI / Import/export fidelity gate (pull_request) Successful in 58s
CD / Build and push images (push) Successful in 22s
#221: offline update path incl. migrations, rehearsed with rollback
Adds docs/operations/update-runbook.md (obtain, verify by digest, back
up, apply, verify, roll back) with the migration behaviour stated
explicitly: a failed migration rolls back its own transaction but is
recorded in _prisma_migrations and blocks every further migrate deploy
(P3009) — including a re-deployed old image — until migrate resolve
--rolled-back; semantically irreversible migrations have exactly one way
back, the pre-update backup set. No rolling updates on a compose stage.
Rehearsed in the isolated environment of #220: regular update to a v2
image set, then a deliberate failed-update (P3018 division by zero,
schema change proven rolled back) with image-rollback-alone shown
insufficient and the documented recovery executed. Protocol:
docs/vs-nfd/98-update-rollback-protokoll.md. ADR 0024 decisions 5+6
recorded as executed; operations handbook and restore runbook updated;
plan checkbox P1-3 ticked.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01AUtYMxwTCMHG9mVHnwbFg8
2026-07-31 17:26:50 +02:00
..
0001-typescript-monorepo.md Add architecture documentation, ADRs, and operations concept 2026-07-04 14:36:16 +02:00
0002-postgresql.md Add architecture documentation, ADRs, and operations concept 2026-07-04 14:36:16 +02:00
0003-yjs-crdt-collaboration.md Add architecture documentation, ADRs, and operations concept 2026-07-04 14:36:16 +02:00
0004-tiptap-editor.md Add architecture documentation, ADRs, and operations concept 2026-07-04 14:36:16 +02:00
0005-react-vite-frontend.md Add architecture documentation, ADRs, and operations concept 2026-07-04 14:36:16 +02:00
0006-nestjs-prisma-backend.md Add architecture documentation, ADRs, and operations concept 2026-07-04 14:36:16 +02:00
0007-auth-sessions-oidc-ready.md #190: configurable session lifetime with a server-side idle timeout 2026-07-30 11:11:15 +02:00
0008-plugin-sandbox.md Add architecture documentation, ADRs, and operations concept 2026-07-04 14:36:16 +02:00
0009-import-export-converters.md Add architecture documentation, ADRs, and operations concept 2026-07-04 14:36:16 +02:00
0010-postgres-fulltext-search.md Add architecture documentation, ADRs, and operations concept 2026-07-04 14:36:16 +02:00
0011-file-storage-quotas.md Scaffold pnpm monorepo with lint, format, and test tooling 2026-07-04 19:06:27 +02:00
0012-i18n.md Add architecture documentation, ADRs, and operations concept 2026-07-04 14:36:16 +02:00
0013-versioning-and-trash.md Scaffold pnpm monorepo with lint, format, and test tooling 2026-07-04 19:06:27 +02:00
0014-gitea-actions-cicd.md Move the stage directories to /srv/DOCKER (host consolidation) 2026-07-14 12:43:29 +02:00
0015-backup-strategy.md Add architecture documentation, ADRs, and operations concept 2026-07-04 14:36:16 +02:00
0016-self-hosted-fonts.md Add architecture documentation, ADRs, and operations concept 2026-07-04 14:36:16 +02:00
0017-accessibility-by-default.md docs: ADR 0017 — Barrierefreiheit als Standard-Anforderung 2026-07-21 17:17:26 +02:00
0018-color-theming.md #186: pond accent theming — scoped derivation, cascade pond > user > default 2026-07-29 09:09:36 +02:00
0019-no-security-base-functions.md docs: VS-NfD readiness planning (ist-aufnahme, plan, ADRs 0019-0026, issue drafts) 2026-07-30 01:48:05 +02:00
0020-token-crypto-key-separation.md docs: VS-NfD readiness planning (ist-aufnahme, plan, ADRs 0019-0026, issue drafts) 2026-07-30 01:48:05 +02:00
0021-external-authentication.md #217: map IdP groups and roles onto the permission model 2026-07-31 13:09:11 +02:00
0022-page-classification.md #212: mark attachment downloads by filename prefix and companion file 2026-07-31 07:29:16 +02:00
0023-read-access-audit-trail.md #225: read-trail master switch and written purpose limitation 2026-07-31 12:35:18 +02:00
0024-reproducible-offline-deployment.md #221: offline update path incl. migrations, rehearsed with rollback 2026-07-31 17:26:50 +02:00
0025-plugin-trust-model.md docs: VS-NfD readiness planning (ist-aufnahme, plan, ADRs 0019-0026, issue drafts) 2026-07-30 01:48:05 +02:00
0026-backup-target-restriction.md docs: VS-NfD readiness planning (ist-aufnahme, plan, ADRs 0019-0026, issue drafts) 2026-07-30 01:48:05 +02:00