dorfteich/docs/architecture/adr
Claude Opus 5 b96997501a
All checks were successful
CI / Build container images (pull_request) Successful in 3m53s
CI / Auth e2e pack (pull_request) Successful in 8m42s
CI / Auth e2e pack (push) Successful in 8m41s
CI / Lint, typecheck, test (pull_request) Successful in 6m30s
CI / Import/export fidelity gate (pull_request) Successful in 58s
CD / Build and push images (push) Successful in 18s
CD / Smoke tests against Test (push) Successful in 1m19s
CD / Deploy to Test (push) Successful in 16s
CD / Promote to Int (push) Successful in 12s
CI / Lint, typecheck, test (push) Successful in 6m41s
CI / Build container images (push) Has been skipped
CI / Import/export fidelity gate (push) Successful in 52s
#303: operator-uploaded fonts — storage, API, PDF embedding, backup
An operator holding a font licence could only use it by baking the file
into a custom image, which tied every change to a rebuild and left the
file out of the backup.

ADR 0016 said there is no runtime font management. It also listed this
exact case under "Alternatives considered" — *may become a Site-Admin-
level feature later*. The amendment takes that option and answers the two
objections it raised: licensing risk (Site Admins only, licence recorded
with the family) and file-format attack surface (magic-byte check and a
size cap, never a parse).

- `CUSTOM_FONTS_DIR` (default `./data/fonts`) — a sibling of uploads and
  plugins, NOT inside the image-baked `FONTS_DIR`, where a deploy would
  overwrite it and no backup would ever see it.
- One list of data directories (`apps/backup/src/data-dirs.ts`) now feeds
  both the nightly archive and the restore, so they cannot drift. #306 and
  #307 add one line each instead of a second mechanism.
- Both Dockerfiles bake the path. The backup image sets its volume paths
  itself ("self-sufficient without compose env" — #71's lesson) and reads
  no *_DIR from compose; without the ENV entry the archive would have
  skipped the directory silently.
- The PDF path already read WOFF2 from disk at request time, so it only
  had to pick the other base directory for a custom family.
- `fontStack`/`fontEntry` take the instance's uploaded families as an
  argument — they are runtime data. The catalog is searched first, and a
  colliding family name is rejected at upload, so a custom font can never
  shadow a catalog one.
- Deletion is never blocked by usage: an unknown family already falls back
  to the system stack, so affected ponds degrade instead of breaking. The
  count of affected ponds travels into the audit entry.
- Audit catalogue v1.6 (`font.uploaded`, `font.deleted`).

Verified: api full suite against a fresh database, 102 files / 571 tests.
The upload suite writes into a real temp directory and reads the bytes
back off disk, so the storage layer is exercised rather than mocked.
2026-08-01 14:49:13 +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 #303: operator-uploaded fonts — storage, API, PDF embedding, backup 2026-08-01 14:49:13 +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 ADRs 0019-0027: accepted after explicit operator review (2026-07-31) 2026-07-31 20:47:27 +02:00
0020-token-crypto-key-separation.md ADRs 0019-0027: accepted after explicit operator review (2026-07-31) 2026-07-31 20:47:27 +02:00
0021-external-authentication.md ADRs 0019-0027: accepted after explicit operator review (2026-07-31) 2026-07-31 20:47:27 +02:00
0022-page-classification.md ADRs 0019-0027: accepted after explicit operator review (2026-07-31) 2026-07-31 20:47:27 +02:00
0023-read-access-audit-trail.md ADRs 0019-0027: accepted after explicit operator review (2026-07-31) 2026-07-31 20:47:27 +02:00
0024-reproducible-offline-deployment.md ADRs 0019-0027: accepted after explicit operator review (2026-07-31) 2026-07-31 20:47:27 +02:00
0025-plugin-trust-model.md ADRs 0019-0027: accepted after explicit operator review (2026-07-31) 2026-07-31 20:47:27 +02:00
0026-backup-target-restriction.md ADRs 0019-0027: accepted after explicit operator review (2026-07-31) 2026-07-31 20:47:27 +02:00
0027-vs-nfd-hardening-profile-mode.md ADRs 0019-0027: accepted after explicit operator review (2026-07-31) 2026-07-31 20:47:27 +02:00