Files

Marcel 1226bd0a07 docs(timeline): register timeline domain in package tables and diagrams

Add timeline/ to the root and backend package tables, TimelineEvent to the
domain-model entity tables, TimelineEvent/EventType/Zeitstrahl to the
glossary, a new l3-backend-timeline C4 component diagram, and the
timeline_events table + two join tables (with their CHECKs and cascade FKs)
to the db-orm and db-relationships ER diagrams. Bumps the db-orm snapshot to
V77.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

2026-06-13 00:34:18 +02:00

l1-context.puml

docs(search): update CLAUDE.md, GLOSSARY, DEPLOYMENT, and C4 diagrams

2026-06-06 16:16:04 +02:00

l2-containers.puml

refactor(search): remove NLP/smart-search feature entirely (#772 )

2026-06-08 10:57:00 +02:00

l3-backend-3a-security.puml

docs(arch): update security C4 diagram for CSRF + rate limiting

2026-05-19 09:23:01 +02:00

l3-backend-3b-document-management.puml

docs(document): ADR-031 + glossary/c4/api_tests for auto-title sync (#726 )

2026-06-04 16:44:56 +02:00

l3-backend-3c-transcription.puml

docs(c4): add L3 backend 3c transcription and 3d users/groups

2026-05-06 22:52:21 +02:00

l3-backend-3d-users-groups.puml

docs(c4): add L3 backend 3c transcription and 3d users/groups

2026-05-06 22:52:21 +02:00

l3-backend-3e-persons.puml

docs(persons): document the directory route, triage view and endpoints

2026-05-27 13:59:31 +02:00

l3-backend-3f-ocr.puml

docs(c4): add L3 backend 3e persons, 3f OCR, 3g supporting domains

2026-05-06 22:52:21 +02:00

l3-backend-3g-supporting.puml

feat(lesereisen): implement lesereisen

2026-06-12 14:04:02 +02:00

l3-backend-timeline.puml

docs(timeline): register timeline domain in package tables and diagrams

2026-06-13 00:34:18 +02:00

l3-frontend-3a-middleware-auth.puml

docs(c4): add L3 frontend 3a middleware/auth and 3b document workflows

2026-05-06 22:52:21 +02:00

l3-frontend-3b-document-workflows.puml

docs(c4): add smart-search components to l3-frontend diagram (#739 review)

2026-06-06 18:27:00 +02:00

l3-frontend-3c-people-stories.puml

feat(lesereisen): implement lesereisen

2026-06-12 14:04:02 +02:00

l3-frontend-3d-administration.puml

docs: drop remaining stale MassImportService/ExcelService references

2026-05-27 22:08:45 +02:00

README.md

docs(c4): add VS Code PlantUML server config and diagram index

2026-05-06 22:52:21 +02:00

seq-auth-flow.puml

docs(arch): update auth sequence diagram to Phase 2 (CSRF, rate limit, revocation)

2026-05-19 09:23:01 +02:00

seq-document-upload.puml

docs(c4): add L3 frontend 3c/3d and sequence diagrams

2026-05-06 22:52:21 +02:00

README.md

C4-PlantUML Diagrams

Architecture diagrams in C4-PlantUML format. These are the authoritative source for layout-accurate diagrams. The companion c4-diagrams.md in the parent directory keeps Mermaid versions for inline Gitea rendering.

Render in Gitea

Gitea is configured to render .puml files as diagrams. Open any .puml file in the Gitea UI to see the rendered diagram.

Note: plantuml code fences inside Markdown files do not render inline in Gitea — this is a Gitea limitation unrelated to the server configuration. The .md files in this repo use Mermaid for that reason.

Render in VS Code

Install the PlantUML extension (jebbs.plantuml). The project's .vscode/settings.json already points at the shared server:

plantuml.server = http://heim-nas:8500

Open any .puml file and press Alt+D to preview.

Files

File	Diagram
`l1-context.puml`	Level 1 — System Context
`l2-containers.puml`	Level 2 — Containers
`l3-backend-3a-security.puml`	L3 Backend: Security & Authentication
`l3-backend-3b-document-management.puml`	L3 Backend: Document Management & Import
`l3-backend-3c-transcription.puml`	L3 Backend: Document Transcription Pipeline
`l3-backend-3d-users-groups.puml`	L3 Backend: Users, Groups & Administration
`l3-backend-3e-persons.puml`	L3 Backend: Persons & Family Graph
`l3-backend-3f-ocr.puml`	L3 Backend: OCR Orchestration
`l3-backend-3g-supporting.puml`	L3 Backend: Supporting Domains
`l3-frontend-3a-middleware-auth.puml`	L3 Frontend: Middleware, Auth & Layout
`l3-frontend-3b-document-workflows.puml`	L3 Frontend: Document Workflows
`l3-frontend-3c-people-stories.puml`	L3 Frontend: People, Stories & Discovery
`l3-frontend-3d-administration.puml`	L3 Frontend: Administration & Help
`seq-auth-flow.puml`	Sequence: Authentication Flow
`seq-document-upload.puml`	Sequence: Document Upload Flow