Files
familienarchiv/docs/architecture/c4/l3-frontend-3c-people-stories.puml
Marcel c131507e30
Some checks failed
CI / Unit & Component Tests (pull_request) Failing after 3m4s
CI / OCR Service Tests (pull_request) Successful in 23s
CI / Backend Unit Tests (pull_request) Successful in 3m50s
CI / fail2ban Regex (pull_request) Successful in 47s
CI / Semgrep Security Scan (pull_request) Successful in 22s
CI / Compose Bucket Idempotency (pull_request) Successful in 1m12s
docs(c4): update l3-frontend-3c-people-stories for STORY/JOURNEY dispatch
geschichten components now describe the type-based reader split
(StoryReader / JourneyReader / JourneyItemCard / JourneyInterlude),
the TypeSelector creation flow, and the full set of API endpoints
(including DELETE /api/geschichten/{id} and GET /api/persons/{id}
for person pre-population).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-09 10:14:30 +02:00

3.8 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»/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/Journey list and detailpages. List:GeschichteListRow withREISE badge for JOURNEYtype. Detail: dispatches toStoryReader (rich text +persons) or JourneyReader(intro + orderedJourneyItemCard/JourneyInterludeitems + empty state) basedon GeschichteType.BLOG_WRITE users seeedit/delete actions. Loader:GET /api/geschichten, GET/api/geschichten/{id}.«component»/geschichten/[id]/editand /geschichten/new[SvelteKit Routes] Story editor and creationflow. New: TypeSelector(STORY/JOURNEY radiogroup with roving tabindex)→ StoryCreate (rich texteditor, person linking, POST/api/geschichten) orJOURNEY placeholder(editor deferred to #753).Edit: PUT/api/geschichten/{id}.Requires BLOG_WRITEpermission.«component»/stammbaum[SvelteKit Route] Family tree visualisation.Loader: GET /api/network(nodes + edges). Rendersinteractive family tree fromnetwork graph data.«component»/themen[SvelteKit Route] Browsable topic index.Shows all root tags as cardswith color bars and childrows. ThemenWidget alsoembedded in the homedashboard (reader + editorsidebar). Loader: GET/api/tags/tree.«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/dashboard/activity,GET /api/notifications[HTTP / JSON]GET /api/geschichten,GET/api/geschichten/{id},DELETE/api/geschichten/{id}[HTTP / JSON]GET /api/persons/{id}(pre-populate), POST/api/geschichten, PUT/api/geschichten/{id}[HTTP / JSON]GET /api/network[HTTP / JSON]GET /api/tags/tree[HTTP / JSON]GET/PUT/api/users/me,notification-preferences[HTTP / JSON]GET /api/users/{id}[HTTP / JSON]