From ddb1ec4df8592d9ce12b7110d07ba74f9efde155 Mon Sep 17 00:00:00 2001 From: Marcel Date: Mon, 8 Jun 2026 16:27:15 +0200 Subject: [PATCH] docs(timeline): add Zeitstrahl visual specs (global Concept A, event editor) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Visual design specs for Milestone #14: - zeitstrahl-global-concepts.html — A/B/C exploration of the global timeline - zeitstrahl-final-spec.html — canonical Concept A (global + per-person Lebensweg) - zeitstrahl-event-editor-spec.html — curator event editor + document quick-action Co-Authored-By: Claude Opus 4.8 --- docs/specs/zeitstrahl-event-editor-spec.html | 418 +++++++ docs/specs/zeitstrahl-final-spec.html | 391 +++++++ docs/specs/zeitstrahl-global-concepts.html | 1061 ++++++++++++++++++ 3 files changed, 1870 insertions(+) create mode 100644 docs/specs/zeitstrahl-event-editor-spec.html create mode 100644 docs/specs/zeitstrahl-final-spec.html create mode 100644 docs/specs/zeitstrahl-global-concepts.html diff --git a/docs/specs/zeitstrahl-event-editor-spec.html b/docs/specs/zeitstrahl-event-editor-spec.html new file mode 100644 index 00000000..6670500a --- /dev/null +++ b/docs/specs/zeitstrahl-event-editor-spec.html @@ -0,0 +1,418 @@ + + + + + +Zeitstrahl — Ereignis-Editor & Brief-Gruppierung · Quick-Action im Dokument · Familienarchiv + + + + +
+ + +
+

Ereignis-Editor & Brief-Gruppierung · Quick-Action im Dokument

+

Wie kuratierte Zeitstrahl-Ereignisse entstehen und wie Briefe gruppiert werden — von zwei Seiten in ein Datenmodell (TimelineEvent.documents): der Ereignis-Editor unter /zeitstrahl/events/[id]/edit (Kurator baut, verlinkt viele Briefe) und die Quick-Action im Dokument-Detail (beim Lesen schnell zuordnen). Beide bauen auf bereits ausgelieferten Komponenten auf.

+
+ Milestone #14 · Zeitstrahl + Reuse: GeschichteEditor · DocumentMultiSelect · PersonMultiSelect + WRITE_ALL +
+
Familienarchiv · 2026-06-08 · Leonie Voss, UX Lead · gegründet auf Code: GeschichteEditor.svelte · DocumentMetadataDrawer.svelte · DocumentMultiSelect.svelte
+
+ + + +
+

1 · Zwei Einstiegspunkte, ein Datenmodell

+

Manuelle Gruppierung = ein TimelineEvent mit verknüpften Dokumenten. Kuratoren arbeiten in beide Richtungen — wir bauen beide, statt eine zu erzwingen.

+
+
+
+ A · Ereignis-zuerst — der Kurator baut den Zeitstrahl. /zeitstrahl/events/new · [id]/edit mit Dokument-Mehrfach-Picker = Bulk-Linking vieler Briefe auf einmal. Spiegelt 1:1 den GeschichteEditor (gleiche zwei-Spalten-Form, Sidebar-Picker, Sticky-Save-Bar). +
+
+ B · Dokument-zuerst — beim Lesen eines Briefs. Quick-Action im Dokument-Detail: bestehendes Ereignis wählen oder neu anlegen, verlinkt diesen einen Brief. Spiegelt die bestehende Geschichten-Spalte im Details-Drawer (DocumentMetadataDrawer.svelte). +
+
+ + + +
+

2 · Ereignis-Editor — /zeitstrahl/events/[id]/edit

+

Form-Actions-Muster, gegated mit WRITE_ALL. Layout & Verhalten 1:1 vom GeschichteEditor übernommen: Hauptspalte + Sidebar (lg:grid-cols-[2fr_1fr]), Sticky-Save-Bar, beforeNavigate-Warnung bei ungespeicherten Änderungen.

+
+ +
+
+
DokumentePersonenZeitstrahlStammbaumKR
+
+
‹ Zurück zum Zeitstrahl
+
Ereignis bearbeiten
+ +
+ +
+ +
+
Briefe von der Front
+
+ +
+
+
② Typ
+
PersönlichHistorisch
+
+
+
③ Datum · Präzision
+
+
1915
+
Jahr ▾
+
+
Bei „Zeitspanne" erscheint ein zweites End-Datum-Feld. Bei „ca." / „Saison" passt sich nur das Label an.
+
+
+ +
+
④ Beschreibung · optional
+
Karls Feldpost von der Westfront, 1915 — wöchentliche Briefe an Elfriede und den neugeborenen Hans. Eine zusammenhängende Korrespondenz, die hier als Cluster gebündelt wird …
+
Schlichtes Textfeld (kein Rich-Text wie Geschichten) — Ereignisse sind kurze Notizen, keine Langform.
+
+
+ + + +
+ + +
+ Änderungen werden erst beim Speichern übernommen. +
+ Löschen + Abbrechen + Speichern +
+
+
+
+ +
+
①Titel — großes Serifen-Feld, wie der Geschichten-Titel. Pflichtfeld (Validierung bei Blur).
+
②Typ — PERSONAL / HISTORICAL Segmented-Control. Steuert Rendering (Mint-Pille vs. Welt-Band).
+
③Datum + Präzision — geteilte DatePrecisionInput (gleiche Logik wie Dokument-Datum, metaDatePrecision). „Zeitspanne" blendet End-Datum ein.
+
④Beschreibung — optionales Textfeld (TEXT), bewusst schlicht.
+
⑤Verknüpfte Briefe — hier wird gruppiert. Wiederverwendung von DocumentMultiSelect (Typeahead, Chips, Hidden-Inputs).
+
⑥Beteiligte Personen — PersonMultiSelect. Bestimmt, in welchem „Lebensweg" das Ereignis auftaucht.
+
⑦Sticky-Save-Bar — Speichern primär, Abbrechen sekundär, Löschen nur im Edit-Modus (mit Bestätigung).
+
＋/new — leeres Formular. Mit ?documentId=… ist Feld ⑤ vorbefüllt (aus der Quick-Action, §4-D).
+
+ + + +
+

3 · Brief-Gruppierung im Editor — der Dokument-Picker

+

Feld ⑤ ist der unveränderte DocumentMultiSelect: Tippen sucht über /api/documents/search?q=… (debounced 300 ms), Treffer mit ehrlichem Datums-Label, bereits gewählte werden gefiltert. Jeder Klick fügt einen Brief zum Cluster.

+
+ +
+
+
Suche aktiv — DropdownDocumentMultiSelect
+
+
+ ✉ Westfront-Brief · Mär 1915 × + ✉ Feldpost Verdun · Jul 1915 × + Verdun▏ +
+
+
Feldpost aus Verdun · Brief · Juli 1915
+
Brief aus dem Verdun-Lazarett · Brief · August 1916
+
Rückkehr aus Verdun · Brief · ca. 1917
+
+
Label = title · formatDocumentDate(precision). Bereits verknüpfte Briefe erscheinen nicht in den Treffern (Dedup).
+
+
+ +
+
Inline „＋ Ereignis" am Jahres-BandZeitstrahl
+
+
+
+
1915
+
✉ 24 Briefe
Monats-Dichte ▾
+ +
+
Kuratoren können auch direkt im Zeitstrahl ein Ereignis anlegen — öffnet denselben Editor, Jahr & Briefe des Bandes vorbefüllt.
+
+
+
+ + +
+ + +
+

4 · Quick-Action im Dokument-Detail — wo sie lebt

+

Die Dokument-Detailseite ist ein vollflächiger Viewer ohne Sidebar (fixed inset). Aktions-Flächen gibt es nur zwei: die DocumentTopBar und den aufklappbaren Details-Drawer. Die Quick-Action lebt an beiden — primär als „Zeitstrahl"-Spalte im Drawer (spiegelt die Geschichten-Spalte), plus ein Top-Bar-Button für den Ein-Klick-Weg.

+
+ +
Warum der Details-Drawer der richtige Ort ist: Er zeigt heute schon, wozu ein Brief gehört — Personen, Schlagwörter und Geschichten (mit „Zuordnen"-Aktion, gegated über canBlogWrite, DocumentMetadataDrawer.svelte:210). Zeitstrahl-Ereignisse sind strukturell identisch („dieser Brief gehört zu diesen Ereignissen") und bekommen daher eine gleichwertige vierte/fünfte Spalte. Konsistent & auffindbar dort, wo Nutzer ohnehin „Zugehörigkeit" suchen.
+ +
+
+ +
+
+
‹
+
+
+
Brief über die Lage an der Westfront
+
März 1915
+
+
KR→ER
+
+ + Details ▴ +
+ + ✎ Transkribieren + + ⊕ Zeitstrahl + ⤓ +
+
+ + +
+
+ +
+
Details
+
Datum
März 1915
+
Ort
Westfront
+
Status
Transkribiert
+
+ +
+
Personen
+
KRKarl Raddatz
+
ERElfriede Raddatz
+
+ +
+
Schlagwörter
+
KriegBriefe von der Front
+
+ +
+
+ Zeitstrahl + + Zuordnen +
+ +
+
Briefe von der Front×
+
1915 · 24 Briefe · persönlich
+ Krieg +
+ +
+ Ereignis suchen … + ＋ Neu +
+
+
+
+
↓ PDF-Viewer (Brief-Scan) …
+
+ +
+
ATop-Bar-Button „⊕ Zeitstrahl" — Mint-Akzent im Aktions-Cluster (DocumentTopBarActions). Öffnet ein kleines Popover zum Ein-Klick-Zuordnen, ohne den Drawer zu öffnen. Im Mobile-Menü als Eintrag.
+
B„Zeitstrahl"-Spalte im Details-Drawer — neue Spalte neben Geschichten. Zeigt verknüpfte Ereignisse (Titel · Datum · Tag-Chip), Unlink über ×, plus Quick-Add-Zeile. Nur sichtbar/aktiv bei canWrite.
+
CQuick-Add-Zeile — Typeahead „Ereignis suchen …" (sofortiges Verlinken, keine Navigation) + „＋ Neu".
+
D„＋ Neu" → /zeitstrahl/events/new?documentId={id} — öffnet den Editor (§2) mit diesem Brief in Feld ⑤ vorbefüllt. Spiegelt /geschichten/new?documentId=.
+
+ + + +

5 · Quick-Action — Zustände

Der Typeahead in der Zeitstrahl-Spalte (oder im Top-Bar-Popover). Gleiches Muster wie DocumentMultiSelect, nur sucht es Ereignisse statt Dokumente.

+ +
+
+
A · Nicht zugeordnet
+
+
Noch keinem Ereignis zugeordnet.
+
Ereignis suchen …＋ Neu
+
+
+
+
B · Suche — Treffer
+
+
Front▏
+
+
Briefe von der Front · 1915 · 24 Briefe
+
Kriegsausbruch · 1914 · 6 Briefe
+
＋ „Front" als neues Ereignis anlegen
+
+
+
+
+
C · Zugeordnet
+
+
Briefe von der Front✓ verknüpft ×
Krieg
+
Sofortiges Verlinken (POST). Toast „Zum Ereignis hinzugefügt", aria-live. Unlink über × (DELETE).
+
+
+
+
D · Mehrfach zugeordnet
+
+
+
Briefe von der Front×
+
Weihnachten 1915×
+
+
Ein Brief darf zu mehreren Ereignissen gehören (ManyToMany) — alle werden gelistet.
+
+
+
+ + + +

6 · Wiederverwendete Bausteine & Tokens

+
Maximal wiederverwenden: DocumentMultiSelect (Brief-Gruppierung, unverändert) · PersonMultiSelect (Beteiligte) · GeschichteEditor-Layout (zwei Spalten, Sticky-Save, beforeNavigate) · DocumentMetadataDrawer-Spaltenmuster (Quick-Action) · useUnsavedWarning · formatDocumentDate / DatePrecision. Brand-Tokens wie im Zeitstrahl-Spec: Navy #012851, Mint #a1dcd8, Linie #e4e2d7, ink-3 #6b7280, danger #c0392b; Serifen-Titel (Tinos), Sans-Chrome (Montserrat).
+ + + +

7 · Implementierungs-Referenz & Barrierefreiheit

+
+ + + + + + + + + + + + + +
BausteinDatei / EndpointVerantwortung
Editor-Route (neu)/zeitstrahl/events/new · [id]/edit+page.server.ts (Form-Actions, WRITE_ALL) + +page.svelte; ?documentId= vorbefüllt Feld ⑤
Editor-Komponente (neu)TimelineEventEditor.svelteSpiegelt GeschichteEditor: Titel, Typ, Datum+Präzision, Beschreibung; Sidebar-Picker; Sticky-Save; beforeNavigate
Brief-Gruppierung (reuse)DocumentMultiSelect.svelteUnverändert — Typeahead /api/documents/search, Chips, Hidden-Inputs documentIds
Personen (reuse)PersonMultiSelect.svelteUnverändert — Beteiligte Personen
Datum + PräzisionDatePrecisionInput (geteilt)Wie Dokument-Datum (metaDatePrecision); „Zeitspanne" → End-Datum; formatDocumentDate fürs Label
Quick-Action-Spalte (neu)DocumentTimelineColumn.svelteIm DocumentMetadataDrawer neben Geschichten; verknüpfte Ereignisse + Quick-Add; nur bei canWrite
Quick-Add-Picker (neu)DocumentTimelineEventPicker.svelteEreignis-Typeahead; sofort verlinken oder ?documentId= zum Editor; auch im Top-Bar-Popover
Top-Bar-Button (neu)DocumentTopBarActions · DocumentMobileMenu„⊕ Zeitstrahl"-Button (canWrite); öffnet Quick-Add-Popover
Backend — CRUDPOST · PUT · DELETE /api/timeline/eventsTimelineEventController, WRITE_ALL; TimelineEventRequest mit documentIds / personIds
Backend — Link/UnlinkPUT /api/timeline/events/{id}Verlinken/Lösen läuft über das Event-Update (documents-Set); kein neuer ErrorCode nötig
Barrierefreiheit—Picker-Dropdowns Tastatur-navigierbar (↑↓↵), aria-live für „verknüpft/gelöst"; 44px-Ziele; sichtbarer Fokus-Ring; Löschen/Unlink mit Bestätigung
+
+
Offene Designentscheidung: Soll der Top-Bar-Button (A) MVP sein oder reicht zunächst die Drawer-Spalte (B)? Empfehlung: B als MVP (spiegelt Geschichten exakt, geringster Aufwand), A als schneller Nachzug.
+ +
+ + diff --git a/docs/specs/zeitstrahl-final-spec.html b/docs/specs/zeitstrahl-final-spec.html new file mode 100644 index 00000000..301b1404 --- /dev/null +++ b/docs/specs/zeitstrahl-final-spec.html @@ -0,0 +1,391 @@ + + + + + +Globaler Zeitstrahl — Finale Spezifikation (Konzept A) · Milestone #14 · Familienarchiv + + + + +
+ + +
+

Globaler Zeitstrahl — Finale Spezifikation

+

Kanonische Spezifikation für /zeitstrahl auf Basis von Konzept A „Der Lebensfaden": eine durchgehende vertikale Achse, die Personen-Lebensereignisse, kuratierte Ereignisse und Briefe zu einer Erzählung in der Zeit verwebt. Dieselbe Komponente betreibt den globalen Zeitstrahl und den per-Person „Lebensweg". Enthält die vollständige Fall-Abdeckung (leere Jahre, wenige Briefe, hunderte Briefe, undatiert) und die drei Gruppierungs-Modi.

+
+ Milestone #14 · Zeitstrahl + Konzept A — final + Phone-first · honest DatePrecision +
+
Familienarchiv · 2026-06-08 · Leonie Voss, UX Lead · ersetzt die A/B/C-Exploration zeitstrahl-global-concepts.html
+
+ + + +
+

1 · Anatomie von Konzept A

+

Eine Achse, sieben Bausteine. Die Zeit ist die Achse — Lebensereignisse & Jahre als zentrierte Pillen unterbrechen den Faden (Text wird nie von der Linie gekreuzt), Welt-Ereignisse legen sich als Bänder quer, Briefe verdichten sich adaptiv.

+
+ +
+
⚭
Lebensereignis-Pille
Geburt * · Tod † · Heirat ⚭. Abgeleitet aus Person-Daten. Zentriert, gefüllt — unterbricht die Achse. Glyphen aus personLifeDates.ts.
+
★
Kuratierte Ereignis-Pille
PERSONAL — Umzug, Auswanderung. Mint-Rand. Editierbar im Kurator-Editor.
+
◍
Welt-Band
HISTORICAL — Krieg, Inflation. Gedämpftes Band quer über die Achse als Kontext.
+
Einzel-Brief
Kleiner Punkt + Karte, alternierend links/rechts. Wurzel-Tag-Farbchip. Link zu /documents/[id].
+
▭
Jahres-Strip
Verdichtung dichter Jahre: Anzahl + 12-Monats-Sparkline. MonthBucket / aggregateToYears.
+
⋯
Lücke & Ohne-Datum
Ruhige/leere Jahre als dünne Span-Zeile gefaltet; UNKNOWN-Briefe im „Ohne Datum"-Eimer am Ende.
+
+ +
Gruppierungs-Umschalter (oben rechts im Zeitstrahl): DatumEreignisThema steuert nur, wie lose Briefe gebündelt werden. Lebensereignisse, kuratierte Ereignisse und Welt-Bänder bleiben in allen Modi gleich auf der Achse. Standard = Datum.
+ + + +
+

2 · Die drei Gruppierungs-Modi

+

Gleicher Ausschnitt (1914–1915), dreimal gerendert. Nur die losen Briefe ordnen sich um — die Achse bleibt stabil. Schmale Spaltenbreite = Phone-/Lebensweg-Form derselben Komponente.

+
+ +
+ + +
+
Datum Chronologisch
+
Standard. Briefe nach Datum; dichte Jahre verdichten zum Strip. Reine Zeit-Reihung.
+
+
+
1914
+
⚭
Heirat: Karl & Elfriede
1914 · abgeleitet
+
◍ Erster Weltkrieg
1914–1918
+
✉ Kriegsausbruch — Brief an die Familie
Karl → Elfriede · 4. Aug 1914
+ +
1915
+
*
Geburt: Hans Raddatz
Sommer 1915 · abgeleitet
+
+
✉ 24 BriefeMonate ▾
+
+
+
+
+
+ + +
+
Ereignis Kuratiert
+
Briefe bündeln unter kuratierte Ereignisse (TimelineEvent.documents). Erzählende Cluster statt Listen.
+
+
+
1914
+
⚭
Heirat: Karl & Elfriede
1914 · abgeleitet
+
◍ Erster Weltkrieg
1914–1918
+ +
1915
+
*
Geburt: Hans Raddatz
Sommer 1915 · abgeleitet
+
✉ Briefe von der Front · 24
Karl ⇄ Elfriede & Hans · 1915 ▾
Krieg
+
✉ Weihnachten 1915 · 3
kuratiertes Ereignis ▾
Weihnachten
+
+
+
+ + +
+
Thema Nach Wurzel-Tag
+
Optional (Post-MVP). Lose Briefe je Jahr in Wurzel-Tag-Eimer; Mehrfach-Tags dedupliziert auf den primären.
+
+
+
1914
+
⚭
Heirat: Karl & Elfriede
1914 · abgeleitet
+
◍ Erster Weltkrieg
1914–1918
+
Krieg6 ▾
+ +
1915
+
*
Geburt: Hans Raddatz
Sommer 1915 · abgeleitet
+
Krieg › Briefe von der Front24 ▾
+
Weihnachten3 ▾
+
Familie2 ▾
+
+
+
Hinweis im UI: „Brief mit mehreren Tags erscheint unter seinem primären Tag."
+
+ +
+ + + +
+

3 · Vollständige Vorschau — alle Dichte-Fälle

+

Ein durchgehender Zeitstrahl (Desktop, zentrale Achse) von 1899 bis „Ohne Datum". Jeder Dichte-Fall kommt genau einmal vor — von leeren Jahren bis zu hunderten Briefen.

+
+ +
+ Abgedeckte Fälle: + ① leere Jahre (gefaltete Lücke) · + ② wenige Briefe ≤ 3 (einzelne Karten) · + ③ hunderte Briefe (Jahres-Strip + Sparkline) · + ④ kuratiertes Ereignis & Welt-Band · + ⑤ ungenaue Präzision (Sommer, ca.) · + ⑥ undatierte Briefe (Ohne-Datum-Eimer). +
+ +
+
Zeitstrahl
+
Die Familie Raddatz · 1899–1950 · 412 Briefe · 38 Ereignisse  ·  Gruppierung: Datum
+ +
① Leere Jahre → gefaltet
+
+ + +
1899 – 1908 · keine Einträge
+ + +
1909
+
② Wenige Briefe → einzeln
+
✉ Brief aus Stettin
Elfriede → Karl · Mai 1909
Familie
+
✉ Geburtstagsgruß
Karl → Hans · Sep 1909
+
✉ Brief zum Jahresende
Karl → Elfriede · Dez 1909
Weihnachten
+ + +
1914
+
⚭Heirat: Karl & Elfriede Raddatz1914 · abgeleitet aus Beziehung
+
④ Welt-Band (RANGE 1914–1918)
+
◍ Erster Weltkrieg1914–1918 · historisch · 187 Briefe in dieser Zeit
+ + +
1915
+
③ Hunderte Briefe → Jahres-Strip   ⑤ „Sommer 1915"
+
*Geburt: Hans RaddatzSommer 1915 · abgeleitet · SEASON
+
+
✉ 187 BriefeMonats-Dichte · antippen → Monate → Briefe ▾
+
+
Jan 1915Dez 1915
+
+ + +
1916 – 1922 · Nachkriegsjahre · 96 Briefe
+ + +
⑤ „ca. 1923" → APPROX
+
◍ Hyperinflationca. 1923 · historisch
+ + +
1924
+
★Auswanderung nach ArgentinienFrühjahr 1924 · persönlich · kuratiert
+ + +
1925 – 1950 · keine Einträge
+
+ + +
⑥ Undatiert → eigener Eimer am Ende
+
+
Ohne Datum · 11 Briefe
+
Brief ohne JahresangabePräzision UNKNOWN
+
Fragment, Absender unklar+ 9 weitere ▾
+
+
+
Kein erfundenes Datum: undatierte Briefe wandern nie spekulativ in ein Jahr, sondern bleiben sichtbar im Eimer. RANGE-Einträge (Krieg) erscheinen einmal im Start-Jahr mit Spannen-Marker, nicht in jedem überspannten Jahr.
+ + + +

4 · Datums-Präzision (geteilt von Ereignissen & Briefen)

Eine Render-Logik für alle datierten Einträge — dateLabel.ts, gespeist von DatePrecision.

+
+ + + + + + + + + +
DatePrecisionDarstellungBeispielWirkung auf der Achse
DAYvollständiges Datum28. Juli 1914exakte Sortierung im Jahres-Band
MONTHMonat + JahrJuli 1914Monats-Sortierung
SEASONJahreszeit + JahrSommer 1914grobe Reihung
YEARnur Jahr1914ans Band-Ende
APPROX„ca." + Jahrca. 1914mit „ca."-Marker
RANGEStart–Ende1914–1918Start-Jahr, Spannen-Marker, nicht dupliziert
UNKNOWNundatiertOhne Datumeigener Eimer am Ende
+
+ + + +

5 · Responsiv — eine Komponente, drei Breiten

Identisches Markup & identische Daten. Nur die Achs-Position wechselt per Container-Query.

+
+
▏
≥ 1024px · Desktop
Zentrale Achse, Briefe alternierend links/rechts, Welt-Bänder über volle Breite. Pillen unterbrechen die Linie.
+
▎
< 1024px · Phone
Linke Achse, alles einseitig rechts. DOM-Reihenfolge bleibt streng chronologisch (<ol>) — Screenreader liest linear.
+
▎
Lebensweg-Rail · 35%
Gleiche linke Achse in der Personenseite (<TimelineView personId>), gefiltert auf eine Person. Rail-Tauglichkeit = Stärke von A.
+
+ + + +

6 · Design-Tokens (echte, ausgelieferte Werte)

Aus frontend/src/routes/layout.css. Keine Hardcodes in der Komponente.

+
+ + + + + + + + + + +
RolleTokenWertEinsatz
Achse / Knoten / Headerbrand-navy#012851Spine, Lebensereignis-Pillen, Jahres-Badges, Titel
Akzent / Brief-Punktbrand-mint#a1dcd8Brief-Punkte, kuratierte Pillen-Ränder, Sparkline, Dark-Mode-Auswahl
Historisch / Welttag-slate#607080Welt-Bänder & Glyphe ◍ — gedämpft
Tag-Chip-Farben--c-tag-* (Wurzel)sage · sienna · amber · violet — Farbe vom Wurzel-Tag, Punkt + Label
Seite / Karte / Liniecanvas · surface · line#f0efe9 · #ffffff · #e4e2d7
Text sekundärtext-ink-3#6b7280Meta-Zeilen (4,8:1 auf weiß — AA ✓)
Schriftfont-serif · font-sansTinos · MontserratNamen/Titel serif · Labels/Chrome sans
Lebensdaten-GlyphenpersonLifeDates.ts* † ⚭Geburt · Tod · Heirat — konsistent mit Personenkarten
+
+ + + +

7 · Implementierungs-Referenz & Barrierefreiheit

Domain-Ordner frontend/src/lib/timeline/; Route /zeitstrahl; Backend GET /api/timeline.

+
+ + + + + + + + + + + + +
BausteinKomponente / DateiVerantwortung
OrchestratorTimelineView.svelteLädt /api/timeline; optionaler personId für globalen vs. Lebensweg-Modus; hält den Gruppierungs-Modus
Jahres-BandYearBand.svelteJahres-Badge + Einträge; Lücken-Faltung ruhiger Spannen
Ereignis-PilleEventCard.sveltePERSONAL / HISTORICAL / abgeleitet; zentrierte Pille bzw. Welt-Band; präzisions-bewusstes Label
Brief-KarteLetterCard.svelteEinzel-Brief, alternierende Seite, Wurzel-Tag-Chip, Link /documents/[id]
Jahres-StripYearLetterStrip.svelteAdaptive Verdichtung ab Schwellwert; 12-Monats-Sparkline aus MonthBucket / aggregateToYears (lib/document/timeline.ts)
Datums-HelferdateLabel.tsDatePrecision → deutsches Label; geteilt von Ereignissen & Briefen
Kurator-Editor/zeitstrahl/events/new · [id]/editEreignis anlegen/bearbeiten; Personen- + Dokument-Mehrfach-Picker (Bulk-Linking); WRITE_ALL
Quick-AddDocumentTimelineEventPicker.svelteAuf /documents/[id]: Ereignis wählen/neu anlegen; verlinkt einen Brief
Daten-APIGET /api/timelineVerschmilzt kuratierte + abgeleitete Ereignisse + Briefe in TimelineDTO (Jahres-Eimer + Ohne-Datum); Filter personId · type · fromYear · toYear
Barrierefreiheit—Achse = <ol>, chronologische DOM-Reihenfolge; ◍ ✉ * nie nur Farbe — Glyphe + Label; 44px-Tap-Ziele; prefers-reduced-motion; axe in Light & Dark
+
+ +
+ + diff --git a/docs/specs/zeitstrahl-global-concepts.html b/docs/specs/zeitstrahl-global-concepts.html new file mode 100644 index 00000000..7bb0ac78 --- /dev/null +++ b/docs/specs/zeitstrahl-global-concepts.html @@ -0,0 +1,1061 @@ + + + + + +Globaler Zeitstrahl — Visuelle Konzept-Exploration · Milestone #14 · Familienarchiv + + + + +
+ + +
+

Globaler Zeitstrahl — Visuelle Konzept-Exploration

+

Der „Zeitstrahl" unter /zeitstrahl ist die globale Familien-Chronik. Diese Exploration beantwortet zuerst die entscheidende Frage — warum sollte jemand den Zeitstrahl benutzen statt einfach durch die sortierte Suchliste zu scrollen? — und zeigt dann drei Layout-Konzepte, die genau das tun, was die Suche nicht kann: drei Ebenen zu einer Erzählung in der Zeit verweben.

+
+ Milestone #14 · Zeitstrahl + Phone-first · 375px + Explorativ — vor Implementierung +
+
Familienarchiv · 2026-06-08 · Leonie Voss, UX Lead · Design-Basis: docs/superpowers/specs/2026-06-07-family-timeline-design.md
+
+ + + +
+

1 · Warum Zeitstrahl ≠ Suchliste

+

Die Gefahr: zwei Seiten, die wie dasselbe wirken. Wenn der Zeitstrahl nur „Briefe, chronologisch" zeigt, fragt jeder zu Recht — wozu? Der Unterschied ist nicht die Sortierung. Es sind die drei Ebenen und der historische Kontext, die nur hier zusammenkommen.

+
+ +
+ +
+
/documents · nach Datum sortiertEINE EBENE
+
+
Brief über die Lage an der Westfront
Karl → Elfriede Raddatz
Mär 1915
+
Feldpost aus Verdun
Hans → Karl Raddatz
Jul 1915
+
Brief an die Eltern
Karl → Elfriede Raddatz
Sep 1915
+
Päckchen-Dank
Karl → Elfriede Raddatz
Nov 1915
+
Nur Briefe. Keine Geburten, keine Hochzeiten, kein Krieg. Warum 1915 so viele Feldpostbriefe? Die Liste sagt es nicht — man muss es wissen.
+
+
+ +
vs
+ + +
+
/zeitstrahl · die Familie in der ZeitDREI EBENEN
+
+
+
1914
+
⚭ Heirat: Karl & Elfriede Raddatz · abgeleitet
+
Erster Weltkrieg
1914–1918 · historisch
+
1915
+
4 Briefe · Feldpost von der Westfront
+
* Geburt: Hans Raddatz · abgeleitet
+
1918
+
Kriegsende
Nov 1918 · historisch
+
+
+
+
+ +
Der Aha-Moment: Plötzlich ergeben die vier Feldpostbriefe von 1915 Sinn — sie liegen zwischen Hochzeit und Kriegsende, neben der Geburt des Sohnes. Die Suche findet Dokumente. Der Zeitstrahl erzählt, was mit der Familie geschah. Das ist kein sortierter Listenfilter — es ist eine Erzählung, die die Suche strukturell nicht leisten kann.
+ +
+ Fünf Dinge, die nur der Zeitstrahl kann — und die jede Konzept-Variante sichtbar machen muss: +
+
① Personen-Lebensereignisse (Geburt *, Tod †, Heirat ⚭) — abgeleitet aus kuratierten Personendaten, gibt es in der Suche gar nicht.
+
② Kuratierte Ereignisse — persönlich (Umzug, Auswanderung) & historisch (Krieg, Inflation), redaktionell, immer korrekt.
+
③ Historischer Kontext-Hintergrund — Weltereignisse als Bänder hinter den Briefen erklären, warum Briefe sich häufen.
+
④ Ehrliche Datums-Präzision — ca. 1914, Sommer 1914, „Ohne Datum"-Eimer. Nie ein erfundenes Datum.
+
⑤ Verwobene Erzählung statt Trefferliste — eine durchgehende vertikale Geschichte über 50 Jahre, kein paginiertes Suchergebnis.
+
+
+ + + +
+

2 · Die drei Ebenen — visuelle Sprache

+

Jede Ebene muss auf den ersten Blick unterscheidbar sein. Diese Kodierung gilt in allen drei Konzepten gleich — nur das Layout ändert sich, nicht die Bedeutung der Farben & Glyphen.

+
+ +
+
+
⚭
+
Abgeleitetes Lebensereignis
Geburt * · Tod † · Heirat ⚭ — automatisch aus Person.birthDate / deathDate / SPOUSE_OF.fromYear. Große Navy-Knoten auf der Achse. Glyphen * / † aus personLifeDates.ts. Badge „abgeleitet", nicht im Zeitstrahl editierbar.
+
+
+
★
+
Kuratiertes persönliches Ereignis
EventType.PERSONAL — von der Familie geschrieben (Umzug, Krankheit, Auswanderung). Mint-Akzent, Serifen-Titel, optionaler Beschreibungstext. Editierbar über /zeitstrahl/events/[id]/edit.
+
+
+
◍
+
Historisches Ereignis (Welt)
EventType.HISTORICAL — Krieg, Inflation. Gedämpftes Slate-Band quer über die Achse als Kontext-Hintergrund. Bewusst zurückhaltend, damit Familie im Vordergrund bleibt.
+
+
+
✉
+
Brief
Platziert nach Document.documentDate. Kleine Mint-Punkte, kompakte Karte (Absender → Empfänger), verlinkt zu /documents/[id]. Häufungen clustern unter dem Ereignis, zu dem sie gehören.
+
+
+ +
+ + + + + + + + + +
DatePrecisionDeutsche DarstellungBeispielWirkung auf der Achse
DAYvollständiges Datum28. Juli 1914sortiert exakt innerhalb des Jahres-Bandes
MONTHMonat + JahrJuli 1914sortiert nach Monat innerhalb des Bandes
SEASONJahreszeit + JahrSommer 1914grobe Reihung im Band
YEARnur Jahr1914ans Ende des Jahres-Bandes
APPROX„ca." + Jahrca. 1914mit „ca."-Marker, Jahres-Band
RANGEStart–Ende1914–1918im Start-Jahr mit Spannen-Marker, nicht dupliziert
UNKNOWNundatiertOhne Datumeigener Eimer ganz am Ende
+
+ +
+ + +
+
+
A
+
+
Konzept A · Erzählend
+
Der Lebensfaden — eine durchgehende Achse
+
Eine einzige vertikale Spine läuft von oben nach unten durch alle Jahre. Lebensereignisse sitzen als große Knoten auf dem Faden, historische Ereignisse legen sich als Bänder dahinter, Briefe zweigen als kleine Punkte ab. Liest sich wie eine Familien-Saga, von 1899 bis 1950 am Stück scrollbar.
+
DifferenzierungMaximaler Abstand zur Suche — gar keine Listen-Anmutung. Der Faden ist eine Geschichte, kein Suchergebnis.
+
Trade-off: bei dichten Brief-Jahren kann der Faden lang werden — braucht eine Quiet-Year-Kompression (mehrere ereignislose Jahre als ein dünner Abschnitt).
+
+
+ +
+
+
+
+
+
+
Zeitstrahl
+
Die Familie Raddatz · 1899–1950 · 412 Briefe, 38 Ereignisse
+ + +
+
+ + +
+
*
+
Geburt: Karl Raddatz
+
14. März 1901 · abgeleitet
+
+ + +
+
⚭
+
Heirat: Karl & Elfriede
+
1914 · abgeleitet
+
+ + +
+
◍ Erster Weltkrieg
+
1914–1918 · historisch
+
+ + +
+
+
1915
+
+
✉ Brief über die Westfront
+
Karl → Elfriede · Mär 1915
+
Krieg › Briefe von der Front
+
+
+
✉ Feldpost aus Verdun
+
Hans → Karl · Jul 1915 · +2 weitere
+
Krieg › Briefe von der Front
+
+
+ + +
+
◍ Hyperinflation
+
1923 · historisch
+
+ + +
+
★
+
Auswanderung nach Argentinien
+
Frühjahr 1924 · persönlich
+
+ +
+
+
+
+ +
+

Warum dieses Layout

+
    +
  • Ein Faden, keine Karten-Liste. Schon die Silhouette signalisiert „Geschichte", nicht „Suchtreffer".
    • +
  • Hierarchie über Knotengröße: Lebensereignisse 16px-Knoten, kuratierte 11px, Briefe 7px-Punkte. Das Auge liest zuerst die Meilensteine.
    • +
  • Welt-Bänder hinterlegt in gedämpftem Slate — präsent, aber nie konkurrierend mit der Familie.
    • +
  • Brief-Cluster fassen Häufungen zusammen („+2 weitere") statt 24 Zeilen zu zeigen — genau hier unterscheidet es sich von der Liste.
    • +
+

Offene Fragen

+
    +
  • Quiet-Year-Kompression: ereignislose Jahre als dünner „1925–1929"-Abschnitt zusammenfalten?
    • +
  • Tap auf Cluster → expandiert inline oder springt in die gefilterte Suche?
    • +
+
+
+
+ +
+ + +
+
+
B
+
+
Konzept B · Strukturiert
+
Jahres-Bänder — drei Spuren pro Jahr
+
Jedes Jahr ist ein volle-Breite-Abschnitt (wie die bestehende ChronikTimeline). Innerhalb des Bandes machen drei Spuren — Personen · Welt · Briefe — das Verweben explizit und scannbar. Auf dem Desktop nebeneinander, auf dem Phone gestapelt. Sehr lesbar, senioren-freundlich.
+
DifferenzierungDie drei Spuren zeigen die drei Ebenen als Struktur — man sieht sofort, dass hier mehr als Briefe leben.
+
Trade-off: bändriger, weniger „flüssige Saga" als A. Leere Spuren in ruhigen Jahren brauchen eine elegante Leer-Behandlung.
+
+
+ +
+
+
+
+
+
+
Zeitstrahl
+
Die Familie Raddatz · 1899–1950
+ + +
+
+ 1914 + 2 EREIGNISSE · 6 BRIEFE +
+ +
+
Personen
+
⚭Heirat: Karl & Elfriede Raddatz
+
+ +
+
Welt
+
◍Erster Weltkrieg beginnt · 28. Juli 1914
+
+ +
+
Briefe · 6
+
+
+
+
+ Kriegsausbruch — Brief an die Familie → +
+
+
+ + +
+
+ 1915 + 1 EREIGNIS · 24 BRIEFE +
+
+
Personen
+
*Geburt: Hans Raddatz
+
+
+
Briefe · 24 Feldpost
+
✉ Brief über die Lage an der Westfront
Karl → Elfriede · März 1915 · 23 weitere ▾
Krieg › Briefe von der Front
+
+
+ + +
+ 1916 – 1918ruhige Jahre · 9 Briefe ▾ +
+
+
+
+ +
+

Warum dieses Layout

+
    +
  • Drei benannte Spuren machen das Versprechen explizit — „hier sind Personen, Welt und Briefe", nicht nur Dokumente.
    • +
  • Baut auf vorhandenem Idiom: Jahres-Band = ChronikTimeline-Sektion mit Navy-Header. Schnell umsetzbar, vertraut.
    • +
  • Senioren-stark: klare Boxen, große Jahreszahl, ruhiges Raster — kein überlagertes Spine-Lesen nötig.
    • +
  • Ruhige Jahre kollabieren zu einer dünnen Zeile — hält das Scrollen kurz.
    • +
+

Desktop-Enhancement

+
    +
  • Die drei Spuren werden drei Spalten nebeneinander (Personen | Welt | Briefe) statt gestapelt — das Verweben wird horizontal lesbar.
    • +
+
+
+
+ +
+ + +
+
+
C
+
+
Konzept C · Navigierbar
+
Spine + Dichte-Schiene — 50 Jahre im Griff
+
Eine dünne vertikale Dichte-Schiene am linken Rand (dieselbe Balken-Sprache wie der Such-Dichtefilter, nur hochkant) zeigt Brief-Volumen pro Jahr plus Ereignis-Markierungen — und dient zugleich als Mini-Map & Sprung-Navigation. Rechts die verwobene Erzählung. Verbindet Vertrautheit mit dem Dichtefilter und ist doch klar eine andere Oberfläche.
+
DifferenzierungÜber 50 Jahre at-a-glance navigierbar — etwas, das eine paginierte Suchliste nie bietet. Dichte wird zur Landkarte.
+
Trade-off: Die Schiene kostet horizontale Breite — auf 320px muss sie sehr schmal (oder ausklappbar) sein. Nähe zum Dichtefilter könnte verwirren, wenn nicht klar getrennt.
+
+
+ +
+
+
+
+
+
+ +
+
DICHTE
+ +
+
1900
+
+
+
+
1915
+
+
+
+
1923
+
+
+
1950
+
+
+ + +
+
Zeitstrahl
+
Familie Raddatz · 1915 ▾
+ +
+
+ +
+
*
+
Geburt: Hans Raddatz
+
Sommer 1915 · abgeleitet
+
+ +
+
◍ Erster Weltkrieg
+
1914–1918
+
+ +
+
+
✉ Brief über die Westfront
Karl → Elfriede · Mär 1915
+
✉ Feldpost aus Verdun
Hans → Karl · Jul 1915 · +22 ▾
+
+
+
+
+
+
+ +
+

Warum dieses Layout

+
    +
  • Dichte-Schiene als Mini-Map: 50 Jahre Brief-Volumen auf einen Blick, Tap springt zum Jahr. Das kann keine Suchliste.
    • +
  • Ereignis-Marker (weiß = Lebensereignis, slate = Welt) auf der Schiene zeigen, wo etwas passiert ist — nicht nur wo Briefe sind.
    • +
  • Vertraute Sprache, klar getrennter Kontext: dieselben Balken wie /documents, aber hochkant + als Navigation, nicht als Filter.
    • +
  • Hier in Dark Mode gezeigt — Mint wird zum Auswahl-/Akzentton, wie im Dichtefilter-Spec.
    • +
+

320px-Verhalten

+
    +
  • Schiene schrumpft auf ~24px (nur Balken + Jahrzehnt-Ticks) oder klappt hinter ein „Karte"-Icon.
    • +
+
+
+
+ +
+ + + + +
+

3 · Desktop-Ansichten — A vs. B im direkten Vergleich

+

Auf /zeitstrahl gibt es Breite, die das Phone nicht hat. Hier entscheidet sich A gegen B: A nutzt die Breite für eine dramatische, alternierende Erzähl-Achse; B nutzt sie, um die drei Ebenen als drei echte Spalten nebeneinander lesbar zu machen.

+
+ + +
+ A +
+
Konzept A · Desktop
+
Zentrale Achse, alternierende Ereignisse
+
+
+ +
+
+
DokumentePersonenZeitstrahlStammbaumKR
+
+
Zeitstrahl
+
Die Familie Raddatz · 1899–1950 · 412 Briefe · 38 Ereignisse
+ + +
+ +
+ + +
1914
+ + +
+ + ⚭ + Heirat: Karl & Elfriede Raddatz1914 · abgeleitet aus Beziehung + +
+ + +
+ ◍ Erster Weltkrieg + 1914–1918 · historisch · 187 Briefe in dieser Zeit +
+ + +
1915
+ + +
+
+
✉ 24 Feldpost — Westfront
Karl ⇄ Elfriede & Hans Raddatz · März–Dez 1915
Krieg › Briefe von der Front
+
+
+
+
+ + +
+ + * + Geburt: Hans RaddatzSommer 1915 · abgeleitet + +
+ + +
+
+
+
+
★ Umzug nach Berlin
persönlich · Herbst 1915 · „Die Wohnung in der Kastanienallee …"
+
+
+ +
+
+
+ +
+
+

Was die Breite hier gewinnt

+
    +
  • Alternierende Seiten — Briefe links, kuratierte Ereignisse rechts; das Auge zickzackt die Geschichte entlang. Maximal un-listenhaft.
    • +
  • Lebensereignisse & Jahre als zentrierte Meilenstein-Pillen, deren gefüllter Hintergrund die Achse unterbricht — der Spine läuft nie durch den Text, sondern endet sauber an der Pille.
    • +
  • Welt-Bänder über die volle Breite — der historische Kontext umschließt buchstäblich die Briefe darunter.
    • +
+
+
+

Risiken für Senioren / A11y

+
    +
  • Alternierende Lese-Richtung ist anstrengender. Mitigation: nie wichtige Info nur rechtsbündig; auf <1024px kollabiert A in die einseitige Phone-Achse.
    • +
  • DOM-Reihenfolge bleibt streng chronologisch (eine <ol>) — Screenreader liest die Saga linear, egal welche Seite.
    • +
+
+
+ + +
+ B +
+
Konzept B · Desktop
+
Drei Spalten — Personen · Welt · Briefe
+
+
+ +
+
+
DokumentePersonenZeitstrahlStammbaumKR
+
+
Zeitstrahl
+
Die Familie Raddatz · 1899–1950
+ + +
+
+
Personen & Familie
+
Weltgeschehen
+
Briefe
+
+ + +
+
1914
+
+
⚭Heirat: Karl & Elfriede
+
+
+
◍Erster Weltkrieg beginnt
28. Juli 1914
+
+
+
+
6 Briefe · „Kriegsausbruch — Brief an die Familie" →
+
+
+ + +
+
1915
+
+
*Geburt: Hans Raddatz
+
+
+ — im Krieg — +
+
+
✉ Brief über die Westfront
Karl → Elfriede · Mär 1915 · 23 weitere ▾
Krieg
+
+
+ + +
+
1923
+
—
+
+
◍Hyperinflation
ca. 1923
+
+
3 Briefe
+
+ +
+
+ +
+
+

Was die Breite hier gewinnt

+
    +
  • Drei Spalten = drei Ebenen, dauerhaft sichtbar. Das Verweben wird zur lesbaren Tabelle: Auge wandert pro Jahr quer durch Familie → Welt → Briefe.
    • +
  • Gemeinsame Jahres-Achse links bindet die Spalten — man sieht sofort „1915: Geburt, Krieg läuft, 24 Feldpost".
    • +
  • Leere Zellen erzählen mit („— im Krieg —") statt zu verschwinden.
    • +
+
+
+

Risiken / A11y

+
    +
  • Tabellarischer, weniger „Saga". Dafür senioren-stärker: ruhige Spalten, keine alternierende Lese-Richtung.
    • +
  • <1024px: die drei Spalten stapeln zu den drei Spuren aus dem Phone-Konzept (siehe §B oben) — ein Markup, zwei Layouts via Container-Query.
    • +
+
+
+ + + +
+

4 · Wiederverwendung: „Lebensweg" in der Personenansicht

+

Dieselbe TimelineView-Komponente mit personId-Prop, gefiltert auf eine Person. Sie zieht in die linke 35%-Spalte der Personenseite ein, direkt unter die PersonCard (persons/[id]/+page.svelte:60–67). Weil diese Spalte schmal ist, ist es exakt das Phone-Layout in Spaltenbreite — kein zweites Design nötig.

+
+ +
Platzierung im echten Layout: Die Personenseite ist lg:grid-cols-[35%_65%]. Links: PersonCard + NameHistoryCard → wird zu PersonCard + Lebensweg. Rechts (65%): Korrespondenten, Beziehungen, Dokumente bleiben unverändert. Der Lebensweg filtert auf diese Person: ihre Geburt/Heirat/Tod, Ereignisse an denen sie beteiligt ist, ihre gesendeten/empfangenen Briefe.
+ + +
+
+
DokumentePersonenZeitstrahlStammbaumKR
+
+
‹ Zurück
+ +
+ +
+ +
+
KR
+
Karl Raddatz
+
* 14. März 1901  †  1967
+
Großvater128 Briefe
+
+ + +
+
Lebensweg nur Karl
+ +
+
+ +
+
*
+
Geburt
+
14. März 1901 · Stettin
+
+ +
+
⚭
+
Heirat mit Elfriede
+
1914 · abgeleitet
+
+ +
+
◍ Erster Weltkrieg
+
1914–1918
+
+ +
+
+
1915 · 24 Feldpost
+
an Elfriede & Hans · Westfront
+
+ +
+
†
+
Tod
+
1967 · abgeleitet
+
+
+
+
+ + +
+
+
Gemeinsame Korrespondenten
+
+
+
Beziehungen
+
Gesendete Dokumente
+
+
+
+
+

Der Lebensweg sitzt unter der PersonCard in der 35%-Spalte. Gefiltert auf Karl: eigene Geburt/Heirat/Tod, beteiligte Welt-Ereignisse als Kontext, eigene Brief-Cluster. <TimelineView personId={person.id} />

+ + +

… und so verhalten sich A vs. B in der schmalen Lebensweg-Spalte

Bei Spaltenbreite (~330px) ist die Entscheidung wichtig: A bleibt eine klare Faden-Achse, B muss seine drei Spuren stapeln.

+
+
+
A · Faden im Rail
+
+
+
+
*
Geburt · 1901
+
⚭
Heirat · 1914
+
1915 · 24 Feldpost
+
†
Tod · 1967
+
+
+
Faden bleibt intakt — eine durchgehende Lebenslinie. Natürliche Passform fürs Rail.
+
+ +
+
B · Bänder im Rail (gestapelt)
+
+
+
1914
+
PERSONEN
⚭ Heirat mit Elfriede
+
WELT
◍ Erster Weltkrieg
+
BRIEFE
6 Briefe ▾
+
+
+
1915
+
PERSONEN
* Geburt: Hans
+
BRIEFE
24 Feldpost ▾
+
+
+
Spuren stapeln zu Mini-Sektionen pro Jahr. Mehr Struktur, aber höher & mehr Scroll im engen Rail.
+
+ +
+

Konsequenz für die Wahl

+
    +
  • A skaliert nahtlos von Rail (330px) über Phone bis Desktop — ein Layout-Idiom, drei Breiten.
    • +
  • B braucht zwei Modi: gestapelt im Rail/Phone, Spalten auf Desktop. Mehr Code, aber explizitere Ebenen-Trennung.
    • +
  • Da der Lebensweg denselben Component nutzt, zählt die Rail-Tauglichkeit doppelt — sie ist ein echtes Argument für A.
    • +
+
+
+ +
+ + +
+

5 · Brief-Gruppierung & Tag-Farben

+

Die Zeit ist die Achse — nicht das Thema. Briefe gruppieren wir nach Datum (Standard), echte Bündel entstehen über kuratierte Ereignisse, und Tags dienen als Farb-Akzent & Filter. So bleibt der Zeitstrahl eine Zeit-Oberfläche und konkurriert nicht mit der /themen-Seite.

+
+ +
+ Warum nicht primär nach Tags gruppieren? Ein Dokument hat mehrere Tags (ManyToMany). Ein Brief mit Weihnachten und Lazarett hätte keinen eindeutigen Eimer — duplizieren verfälscht Zählungen, willkürlich wählen verfälscht die Bedeutung. Daten sind exklusiv, Themen nicht. Außerdem spannt Weihnachten jeden Dezember 1899–1950 — das ist genau die Themen-Seite, nicht der Zeitstrahl. +
+ +
+ + +
+
① Gruppierungs-Umschalter
+
+ Datum + Ereignis + Thema +
+
Standard = Datum. „Ereignis" bündelt unter kuratierte Ereignisse, „Thema" (optional, Post-MVP) nach Wurzel-Tag.
+ +
② Cluster-Karte (Ereignis)
+
+
+ ✉ + Briefe von der Front + Krieg + 24 Briefe + ▾ +
+
+
Brief über die Lage an der WestfrontMär 1915
+
Feldpost aus VerdunJul 1915
+
+ 22 weitere · alle öffnen →
+
+
+
Ein Jahr mit 24 Feldpostbriefen wird zu einer erzählenden Zeile statt 24 Treffern — der schärfste Unterschied zur Suche. Quelle: TimelineEvent.documents.
+
+ + +
+
③ Tag-Farb-Chips am Brief
+
Die Farbe kommt vom Wurzel-Tag (Tag.color ist nur auf Root gesetzt). Kinder erben sie: Lazarett & Briefe von der Front tragen die Farbe von Krieg. Nie Farbe allein — immer Punkt + Label.
+ +
+
+
✉ Weihnachtsgruß an Elfriede
+
Karl → Elfriede · Dez 1915
+ Weihnachten › Weihnachtsgrüße +
+
+
✉ Brief aus dem Lazarett
+
Hans → Karl · Aug 1916
+ Krieg › Lazarett +
+
+
✉ Brief zum neuen Jahr
+
Elfriede → Karl · Jan 1916 · 2 Tags
+ Weihnachten + Familie +
+
+
Mehrere Tags → mehrere Chips. Unter „Thema"-Gruppierung erscheint der Brief nur unter seinem primären Tag (dedupliziert, mit Hinweis).
+
+
+ + +
④ Lose Briefe ohne Cluster — adaptive Verdichtung
+
Lose Briefe (kein Ereignis, Modus „Datum") nie einzeln auflisten — 412 Briefe würden die Erzählung sprengen. Stattdessen verdichtet der Zeitstrahl nach Datum, adaptiv: wenige Briefe pro Jahr einzeln, viele als verdichteter Jahres-Strip mit 12-Monats-Sparkline. Gleiche Daten & Logik wie der Such-Dichtefilter — MonthBucket + aggregateToYears aus lib/document/timeline.ts.
+ +
+ +
+
Ruhiges Jahr · ≤ 3 lose Briefe → einzeln
+
+
1909
+
✉ Brief aus Stettin
Elfriede → Karl · Mai 1909
+
✉ Geburtstagsgruß
Karl → Hans · Sep 1909
+
+
Unter dem Schwellwert: jeder Brief als eigene Karte mit Tag-Chip.
+
+ +
+
Dichtes Jahr · > 3 → Jahres-Strip mit Sparkline
+
+
1915
+
+
+ ✉ 24 Briefe + Monats-Dichte ▾ +
+
+
+
+
JanDez
+
+
+
Über dem Schwellwert: ein Strip mit 12-Monats-Sparkline. Tap → Monate → einzelne Briefe, oder „im Suchergebnis öffnen →".
+
+
+ +
Disclosure-Leiter: Jahres-Strip → Monats-Gruppen → einzelne Briefe. Auf jeder Stufe gilt der Schwellwert; die unterste Stufe verlinkt in die gefilterte Dokumentsuche (/documents?from=1915-01-01&to=1915-12-31) — die Brücke zur dritten Oberfläche, dem Dichtefilter. So bleibt der Zeitstrahl Erzählung und delegiert die vollständige Liste an die Suche, die genau dafür gebaut ist.
+ + +
⑤ Wie Cluster entstehen — Kuratierung von zwei Seiten
+
Manuelle Gruppierung = ein TimelineEvent mit verknüpften Dokumenten. Zwei Einstiegspunkte, ein Datenmodell (TimelineEvent.documents): Ereignis-zuerst (Kurator baut den Zeitstrahl, verlinkt viele Briefe auf einmal) und Dokument-zuerst (beim Lesen eines Briefs schnell zuordnen).
+ +
+ +
+
A · Kurator-Editor · /zeitstrahl/events/[id]/edit
+
+
TITEL
+
Briefe von der Front
+
+
TYP
PersönlichHistorisch
+
DATUM · PRÄZISION
1915 · Jahr ▾
+
+
VERKNÜPFTE BRIEFE · 24
+
+ ✉ Westfront-Brief × + ✉ Verdun × + + Brief suchen… +
+
+
Form-Actions-Muster, WRITE_ALL. Dokument-Mehrfach-Picker = Bulk-Linking. Auch inline „＋ Ereignis" auf jedem Jahres-Band.
+
+ + +
+
B · Quick-Add · /documents/[id]
+
+
… Dokument-Detail · Seitenleiste …
+
+
Zeitstrahl-Ereignis
+
✉Briefe von der Front✓ verknüpft
+
Ereignis wählen ▾＋ Neues Ereignis
+
+
+
Beim Lesen eines Briefs: bestehendes Ereignis wählen oder direkt neu anlegen — verlinkt diesen einen Brief. Schreibt dieselbe TimelineEvent.documents-Relation.
+
+
+ +
+ Wo Tags stark sind — als Filter: „nur Krieg" verengt den gesamten Zeitstrahl über alle 50 Jahre auf Kriegsbriefe — die Zeit-Achse bleibt erhalten. Genau das kann die Themen-Seite nicht. Tag-Filter ist additiv, nicht duplikativ. +
+ +
+ + +

6 · Empfehlung & nächster Schritt

+
+

Konzept A als Basis, mit der Spur-Klarheit von B und der Schiene von C als Stufe 2.

+

A (Lebensfaden) trifft die Differenzierungs-Frage am direktesten: es sieht null wie eine Suchliste aus und macht die verwobene Erzählung zur Hauptfigur. Die drei benannten Spuren aus B sind die beste Antwort, falls Nutzer-Tests zeigen, dass „welche Ebene ist das?" unklar bleibt — sie lassen sich als Desktop-Enhancement in A einziehen. Die Dichte-Schiene aus C ist die richtige Lösung für „50 Jahre navigieren", aber Stufe 2 — sie löst Navigation, nicht Differenzierung, und kann nachgerüstet werden.

+

Für alle gilt: Brief-Cluster statt Brief-Listen sind der schärfste Unterschied zur Suche — ein Jahr mit 24 Feldpostbriefen wird zu einer erzählenden Zeile („24 Feldpost, Westfront"), nicht zu 24 Treffern. Genau hier hört der Zeitstrahl auf, eine sortierte Suche zu sein. Nächster Schritt: dieses Konzept für die Person-Detail-„Lebensweg"-Ansicht (gefilterte Variante) durchdeklinieren.

+
+ + + +

7 · Design-Tokens (echte, ausgelieferte Werte)

Direkt aus frontend/src/routes/layout.css. Keine Hardcodes in den Komponenten — nur diese Tokens.

+
+ + + + + + + + + + + + + + + +
RolleToken / UtilityWertEinsatz im Zeitstrahl
Spine / Knoten / Headerbrand-navy · --palette-navy#012851Achsen-Spine, Lebensereignis-Knoten, Jahres-Header, Titel
Akzent / Brief-Punktbrand-mint · --palette-mint#a1dcd8Brief-Punkte & -Ringe, kuratierte Ereignis-Akzente, Dark-Mode-Auswahl
Historisch / Welttag-slate (Vorschlag)#607080Welt-Ereignis-Bänder & Glyphe ◍ — gedämpft, im Hintergrund
Tag-Chip-Farben--c-tag-* (nur Wurzel-Tag)sage · sienna · amber · violet · slate — Farbe vom Wurzel-Tag, Kinder erben; Punkt + Label (nie Farbe allein)
Seiten-Hintergrundbg-canvas · --c-canvas#f0efe9Zeitstrahl-Seitenfläche
Karten-Flächebg-surface · --c-surface#ffffffBrief-Karten, Jahres-Bänder
Gedämpfte Flächebg-muted · --c-muted#f5f4efWelt-Spur-Hintergrund (Konzept B)
Linienborder-line · --c-line#e4e2d7Karten-Rahmen, Spur-Trenner
Text primärtext-ink · --c-ink#012851Titel, Namen (= Navy)
Text sekundärtext-ink-3 · --c-ink-3#6b7280Meta-Zeilen (4,8:1 auf weiß — AA ✓)
Schrift — Namen/Titelfont-serif (Tinos)—Personennamen, Ereignis- & Jahres-Titel
Schrift — Meta/Chromefont-sans (Montserrat)—Labels, Spur-Überschriften, Badges
Lebensdaten-GlyphenpersonLifeDates.ts* † ⚭Geburt * · Tod † · Heirat ⚭ — konsistent mit Personenkarten
+
+ + +

8 · Implementierungs-Referenz

Komponenten-Plan aus der Design-Basis. Neuer Domain-Ordner frontend/src/lib/timeline/; Route /zeitstrahl.

+
+ + + + + + + + + + + + + +
BereichKomponente / DateiVerantwortung
OrchestratorTimelineView.svelteLädt GET /api/timeline; optionaler personId-Prop treibt auch die Lebensweg-Ansicht
Jahres-BandYearBand.svelteEin Jahres-Abschnitt + seine Einträge (Spine-Knoten in A, Spuren-Box in B)
Ereignis-KarteEventCard.sveltePERSONAL / HISTORICAL / abgeleitet, präzisions-bewusstes Datumslabel
Brief-KarteLetterCard.svelteKompakte Zeile Absender → Empfänger, Link zu /documents/[id]; Cluster-Variante; Wurzel-Tag-Farbchip
Lose-Brief-VerdichtungYearLetterStrip.svelteAdaptiver Jahres-Strip mit Monats-Sparkline ab Schwellwert; nutzt MonthBucket / aggregateToYears aus lib/document/timeline.ts
Kurator-Editor/zeitstrahl/events/new · [id]/editEreignis anlegen/bearbeiten; Personen- + Dokument-Mehrfach-Picker (Bulk-Linking); WRITE_ALL, Form-Actions
Quick-Add (Dokument)DocumentTimelineEventPicker.svelteAuf /documents/[id]: bestehendes Ereignis wählen oder neu anlegen; verlinkt einen Brief in TimelineEvent.documents
Datums-HelferdateLabel.tsDatePrecision → deutsches Label; wiederverwendet lib/document/timeline.ts-Helfer wo sinnvoll
Dichte-Schiene (C)TimelineMinimap.svelteStufe 2 — vertikale Dichte + Ereignis-Marker + Sprung-Navigation
Daten-APIGET /api/timelineVerschmilzt Ereignisse + abgeleitete Personen-Ereignisse + Briefe in TimelineDTO (Jahres-Eimer + Ohne-Datum)
A11y—Spine = <ol>; Knoten erreichbar; ◍/✉/* nie nur als Farbe — immer Glyphe+Text; 44px-Tap-Ziele; prefers-reduced-motion; axe in Light & Dark
+
+ +
+ +