Decisions
Architecture Decision Records: what was decided for the Mediathek, why, and what follows from it. A decision is not edited once accepted; a later one extends or replaces it.
| Decision | Status |
|---|---|
| ADR-0001 — A monorepo whose backend is not a workspace | Accepted · Date: 2026-08-28 |
| ADR-0002 — Cognito only, no guest tier, no self-signup | Accepted · Date: 2026-08-28 |
| ADR-0003 — Ids are minted, never derived from names | Accepted · Date: 2026-08-28 |
| ADR-0004 — Content lives in S3 behind a proxy Lambda; DynamoDB holds the pointer | Superseded by ADR-0005 and ADR-0006 (Mediathek) · Date: 2026-08-28 |
| ADR-0005 — Media reaches the browser through CloudFront, with one signed policy per session | Accepted · Date: 2026-09-29 |
| ADR-0006 — Edges register with the digitalhome.cloud device flow, and write media through it | Accepted · Date: 2026-09-29 |
| ADR-0007 — One media store; catalogs per environment | Accepted · Date: 2026-09-29 · Amends ADR-0005 (where the CDN lives) |
| ADR-0008 — A semantic model over standard vocabularies, English master | Accepted (phase 1) · Date: 2026-09-29 |
| ADR-0009 — People are ids, names are labels; face boxes live on the Item | Accepted · Date: 2026-09-30 |
| ADR-0010 — Households and vaults | Accepted · Date: 2026-10-01 · Supersedes the single-family access model of ADR-0002 (mt-family) and ADR-0005 (one CDN policy for everything) |
| ADR-0011 — Move to vault, and one vault per item | Accepted · Date: 2026-10-04 · Amends ADR-0007 (who may delete) and ADR-0010 ("Move to vault comes later") |
| ADR-0012 — Onboarding a source, and the edge's one right to change it | Accepted, refined by [ADR-0013](0013-a-source-says-what-it-is-for.md) (roles: store, once, look; publishing through Preview) · Date: 2026-11-03 · Concerns the edge (mediathek-digitalhome-edge) |
| ADR-0013 — A source says what it is for: keep in sync, clean up once, or just look | Accepted · Date: 2026-11-06 · Concerns the edge (mediathek-digitalhome-edge) · Refines ADR-0012 |
| ADR-0014 — Office documents and other files, kept as their original | Accepted · Date: 2026-11-06 · Concerns the edge and the cloud · First step of the Archive (ROADMAP.md) |
| ADR-0015 — Generic events, occurrences, and a year set by hand | Accepted · Date: 2026-11-06 · Concerns the ontology, the edge and the cloud |
| ADR-0016 — Document summaries, written by the agent and checked by a person 2 diagrams | Accepted · Date: 2026-11-07 · Concerns the edge and the cloud · Second step of the Archive (ROADMAP.md) · Extended to photos and films by ADR-0017 |
| ADR-0017 — Summaries and similarity for every item 1 diagram | Accepted · Date: 2026-11-07 · Concerns the edge and the cloud · Extends ADR-0016 |