Files
familienarchiv/docs/architecture/c4/l3-frontend-3c-people-stories.puml
Marcel afe7e5586a docs(architecture): update C4 geschichtenEdit for JourneyEditor
Replace the '#753 deferred' placeholder with the actual implementation:
JOURNEY edit route now opens JourneyEditor (item list, drag/move-up/down,
add bar, sidebar) while STORY route continues to use GeschichteEditor.
Add item-mutation endpoints to the relation.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-09 16:31:56 +02:00

4.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»/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 (TipTaprich text, person linking,POST /api/geschichten) orJourneyCreate (title + firstitem). Edit: branches onGeschichteType â€” STORYopens GeschichteEditor(TipTap body +GeschichteSidebar);JOURNEY opensJourneyEditor (title, introtextarea, orderedJourneyItemRow list withdrag-reorder +move-up/down,JourneyAddBar fordocument/interludeaddition,GeschichteSidebar).JourneyEditor mutations:POST/DELETE /items, PUT/items/reorder, PATCH/items/{id}. RequiresBLOG_WRITE permission.«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},POST/DELETE/api/geschichten/{id}/items,PUT/api/geschichten/{id}/items/reorder,PATCH/api/geschichten/{id}/items/{itemId}[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]