Files
familienarchiv/docs/architecture/c4/l3-frontend-3c-people-stories.puml
Marcel 300b236d7d
All checks were successful
CI / Unit & Component Tests (pull_request) Successful in 7m1s
CI / OCR Service Tests (pull_request) Successful in 34s
CI / Backend Unit Tests (pull_request) Successful in 3m41s
CI / fail2ban Regex (pull_request) Successful in 1m23s
CI / Semgrep Security Scan (pull_request) Successful in 1m58s
CI / Compose Bucket Idempotency (pull_request) Successful in 1m32s
docs(persons): document the directory route, triage view and endpoints
Add /persons/review to the CLAUDE.md route tables and reflect the paged,
filtered directory plus the confirm/delete endpoints in the frontend
people-stories and backend persons C4 diagrams.

Closes #667

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-27 13:59:31 +02:00

3.3 KiB

Component Diagram: Web Frontend — People, Stories & DiscoveryComponent Diagram: Web Frontend — People, Stories & DiscoveryWeb Frontend (SvelteKit / SSR)[system]«component»/persons and/persons/[id][SvelteKit Routes] Person directory(server-side filtered +paginated) and detail.Directory:type/family/has-documentschips, reader default(familyMember ORdocumentCount > 0),writer-only show-all toggle.Detail: metadata, documentlist sent/received,correspondents, familyrelationships.«component»/persons/[id]/edit and/persons/new[SvelteKit Routes] Create and edit personforms. Edit: metadata,aliases, explicitrelationships. Actions:PUT/POST /api/persons.«component»/persons/review[SvelteKit Route] Transcriber triage view(WRITE-gated link). Listsprovisional persons; per-rowMerge / Umbenennen /Bestätigen / Löschen.Actions: POST /merge, PUT/{id}, PATCH /{id}/confirm,DELETE /{id}.«component»/briefwechsel[SvelteKit Route] Bilateral conversationtimeline. Selects twopersons viaPersonTypeahead, fetchesGET/api/documents/conversation,displays chronologicalexchange.«component»/aktivitaeten[SvelteKit Route] Unified activity feed(Chronik). Loader: GET/api/dashboard/activity andGET/api/notifications?read=false.«component»/geschichten and/geschichten/[id][SvelteKit Routes] Story list and detail pages.Loader: GET/api/geschichten?status=PUBLISHED.«component»/geschichten/[id]/editand /geschichten/new[SvelteKit Routes] Story editor with rich text,person and documentlinking. Actions: PUT/POST/api/geschichten. RequiresBLOG_WRITE permission.«component»/stammbaum[SvelteKit Route] Family tree visualisation.Loader: GET /api/network(nodes + edges). Rendersinteractive family tree fromnetwork graph data.«component»/profile[SvelteKit Route] Current user profilesettings. Loader: GET/api/users/me/notification-preferences.Actions: updatename/password andnotification preferences.«component»/users/[id][SvelteKit Route] Public user profile view.Loader: GET /api/users/{id}.«person»User«container»API Backend[Spring Boot]Browses familymembers[HTTPS / Browser]GET /api/persons(filter + page params->PersonSearchResult),GET /api/persons/{id}[HTTP / JSON]GET/api/persons/{id},PUT/api/persons/{id},POST /api/persons[HTTP / JSON]GET/api/persons?provisional=true,PATCH/api/persons/{id}/confirm,DELETE/api/persons/{id},POST/api/persons/{id}/merge[HTTP / JSON]GET/api/documents/conversation[HTTP / JSON]GET/api/dashboard/activity,GET /api/notifications[HTTP / JSON]GET /api/geschichten[HTTP / JSON]GET/PUT/POST/api/geschichten[HTTP / JSON]GET /api/network[HTTP / JSON]GET/PUT/api/users/me,notification-preferences[HTTP / JSON]GET /api/users/{id}[HTTP / JSON]