refactor(search): strip dead NL types from generated api.ts

Remove the /api/search/nl path and the NlSearchRequest, NlQueryInterpretation, NlSearchResponse, PersonHint, and TagHint schemas left over from the NLP/smart-search removal. These were unused (nothing in frontend/src imported them); the manual strip matches what `npm run generate:api` produces against the now NL-free backend. Closes the last deferred review item on PR #772. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
fix(review): resolve all review blockers and concerns
2026-06-08 10:56:32 +02:00 · 2026-06-08 10:56:32 +02:00 · 2026-06-08 10:56:32 +02:00 · 2026-06-08 10:56:32 +02:00 · 2026-06-08 10:56:32 +02:00 · 2026-06-08 10:56:32 +02:00
4 changed files with 0 additions and 2052 deletions
--- a/docs/specs/zeitstrahl-event-editor-spec.html
+++ b/docs/specs/zeitstrahl-event-editor-spec.html
@@ -1,418 +0,0 @@
-<!DOCTYPE html>
-<html lang="de">
-<head>
-<meta charset="UTF-8">
-<meta name="viewport" content="width=device-width, initial-scale=1.0">
-<title>Zeitstrahl — Ereignis-Editor &amp; Brief-Gruppierung · Quick-Action im Dokument · Familienarchiv</title>
-<link href="https://fonts.googleapis.com/css2?family=Tinos:ital,wght@0,400;0,700;1,400&family=Montserrat:wght@400;500;600;700;800;900&display=swap" rel="stylesheet">
-<style>
-*,*::before,*::after{box-sizing:border-box;margin:0;padding:0}
-body{font-family:'Montserrat',system-ui,sans-serif;background:#ECEAE4;color:#1A1A1A;line-height:1.5;font-size:13px}
-.page{max-width:1320px;margin:0 auto;padding:48px 32px 120px}
-
-.mh{padding-bottom:24px;border-bottom:3px solid #012851;margin-bottom:48px}
-.mh h1{font-size:23px;font-weight:900;color:#012851;letter-spacing:-.4px}
-.mh p{font-size:13px;color:#555;max-width:790px;line-height:1.75;margin-top:8px}
-.mh .byline{font-size:9px;color:#999;font-weight:700;letter-spacing:1.5px;text-transform:uppercase;margin-top:10px}
-.tag-row{display:flex;gap:6px;margin-top:12px;flex-wrap:wrap}
-.tg{background:#012851;color:#a1dcd8;padding:2px 8px;border-radius:2px;font-size:8px;font-weight:700;letter-spacing:.8px;text-transform:uppercase}
-.tg.mint{background:#a1dcd8;color:#012851}
-.tg.slate{background:#607080;color:#e8edf2}
-
-.sh{margin:60px 0 22px;padding-bottom:12px;border-bottom:2px solid #E0DDD6}
-.sh h2{font-size:17px;font-weight:900;color:#012851}
-.sh p{font-size:12.5px;color:#666;margin-top:5px;max-width:790px;line-height:1.65}
-
-.callout{padding:13px 17px;border-radius:4px;font-size:12px;line-height:1.65;margin-bottom:18px}
-.callout.navy{background:rgba(1,40,81,.06);border-left:3px solid #012851;color:#333}
-.callout.mint{background:rgba(161,220,216,.18);border-left:3px solid #00c7b1;color:#1f3a3a}
-.callout code{font-family:'Courier New',monospace;font-size:11px;background:#fff;padding:1px 4px;border-radius:2px}
-.callout strong{font-weight:800;color:#012851}
-
-/* desktop chrome */
-.dchrome{background:#F0EFE9;border:1.5px solid #C4C0BA;border-radius:9px;overflow:hidden;box-shadow:0 8px 30px rgba(0,0,0,.12)}
-.dbar{height:22px;background:#E2DFD8;border-bottom:1px solid #C4C0BA;display:flex;align-items:center;gap:4px;padding:0 9px}
-.ddot{width:7px;height:7px;border-radius:50%;background:#C4BFB8}
-.durl{flex:1;height:10px;background:#D2CEC8;border-radius:5px;margin:0 8px;max-width:360px}
-.dnav{height:32px;background:#012851;display:flex;align-items:center;gap:13px;padding:0 16px}
-.dnav .nlogo{font-family:'Tinos',serif;font-size:10px;color:#fff;font-weight:700}
-.dnav .nlink{font-size:7.5px;color:rgba(255,255,255,.5);font-weight:700;text-transform:uppercase;letter-spacing:.4px}
-.dnav .nlink.on{color:#fff;border-bottom:2px solid #a1dcd8;padding-bottom:9px}
-.dnav .av{margin-left:auto;width:18px;height:18px;border-radius:50%;background:rgba(255,255,255,.12);display:flex;align-items:center;justify-content:center;font-size:6px;font-weight:800;color:rgba(255,255,255,.55)}
-.dcanvas{background:#f0efe9;padding:20px 26px 26px}
-
-/* form atoms (mirror real Tailwind look) */
-.lbl{font-size:8.5px;font-weight:800;letter-spacing:1.2px;text-transform:uppercase;color:#6b7280;margin-bottom:6px}
-.inp{border:1px solid #e4e2d7;border-radius:4px;background:#fff;padding:8px 11px;font-size:12px;color:#012851}
-.inp.title{font-family:'Tinos',serif;font-size:22px;font-weight:700;padding:11px 13px}
-.card{border:1px solid #e4e2d7;border-radius:6px;background:#fff;padding:15px;box-shadow:0 1px 3px rgba(0,0,0,.04)}
-.card h3{font-size:8.5px;font-weight:800;letter-spacing:1.2px;text-transform:uppercase;color:#6b7280;margin-bottom:3px}
-.card .hint{font-size:9.5px;color:#9a9a96;margin-bottom:9px}
-.seg{display:inline-flex;border:1px solid #012851;border-radius:5px;overflow:hidden}
-.seg span{font-size:10px;font-weight:700;padding:5px 13px;color:#012851}
-.seg span.on{background:#012851;color:#fff}
-.seg span+span{border-left:1px solid #012851}
-.chips{border:1px solid #e4e2d7;border-radius:5px;background:#fff;padding:7px;display:flex;flex-wrap:wrap;gap:6px;align-items:center}
-.chip-sel{display:inline-flex;align-items:center;gap:4px;background:#f5f4ef;border-radius:4px;padding:3px 8px;font-size:10px;color:#012851}
-.chip-sel .x{color:#012851;opacity:.45;font-size:11px}
-.chip-in{flex:1;min-width:90px;font-size:10.5px;color:#9a9a96;padding:3px 4px}
-.btn{display:inline-flex;align-items:center;gap:6px;height:38px;padding:0 16px;border-radius:5px;font-size:12px;font-weight:600}
-.btn.primary{background:#012851;color:#fff}
-.btn.ghost{background:#fff;border:1px solid #e4e2d7;color:#012851}
-.btn.danger{background:#fff;border:1px solid #e7c9c4;color:#c0392b}
-.tagchip{display:inline-flex;align-items:center;gap:3px;font-size:8px;border-radius:9px;padding:2px 7px;color:#a0522d;background:#f6ece6}
-.tagchip i{width:6px;height:6px;border-radius:2px;background:#a0522d;display:inline-block}
-
-/* annotation callouts on mockups */
-.anno{display:flex;gap:9px;align-items:flex-start;font-size:11.5px;color:#4a4a46;line-height:1.55;margin-bottom:7px}
-.anno .n{flex-shrink:0;width:18px;height:18px;border-radius:50%;background:#012851;color:#a1dcd8;font-size:9px;font-weight:800;display:flex;align-items:center;justify-content:center;margin-top:1px}
-.anno b{color:#012851}
-.anno code{font-size:10px;background:#F0EFE9;padding:1px 4px;border-radius:2px}
-.annogrid{display:grid;grid-template-columns:1fr 1fr;gap:6px 26px;margin-top:14px}
-
-/* dropdown */
-.dd{border:1px solid #e4e2d7;border-radius:6px;background:#fff;box-shadow:0 6px 18px rgba(0,0,0,.12);overflow:hidden;margin-top:3px}
-.dd .opt{padding:7px 11px;font-size:11px;color:#012851;border-bottom:1px solid #f3f1ea;cursor:pointer}
-.dd .opt:hover,.dd .opt.hl{background:#f5f4ef}
-.dd .opt:last-child{border-bottom:none}
-.dd .opt .d{font-size:8.5px;color:#9a9a96}
-
-/* states grid */
-.states{display:grid;grid-template-columns:repeat(2,1fr);gap:18px}
-.state{border:1px solid #E0DDD6;border-radius:8px;background:#fff;overflow:hidden}
-.state .sh2{background:#F4F2EC;border-bottom:1px solid #E0DDD6;padding:7px 12px;font-size:8.5px;font-weight:800;letter-spacing:.8px;text-transform:uppercase;color:#012851;display:flex;justify-content:space-between}
-.state .sb{padding:13px}
-.cap{font-size:11px;color:#888;font-style:italic;line-height:1.55;margin-top:8px}
-
-/* impl-ref */
-.impl-ref{background:#fff;border:1px solid #E0DDD6;border-radius:7px;overflow:hidden;margin-top:8px}
-.impl-ref table{width:100%;border-collapse:collapse}
-.impl-ref th{background:#012851;color:#fff;padding:8px 13px;text-align:left;font-size:8px;font-weight:800;letter-spacing:.6px;text-transform:uppercase}
-.impl-ref td{padding:8px 13px;border-bottom:1px solid #F0EEE8;vertical-align:top;font-size:11px;color:#444;line-height:1.55}
-.impl-ref tr:nth-child(even) td{background:#FAFAF7}
-.impl-ref td:first-child{font-weight:700;color:#012851;white-space:nowrap;width:185px}
-.impl-ref td code{font-size:9.5px;background:#F0EFE9;padding:1px 4px;border-radius:2px;font-family:'Courier New',monospace;color:#333}
-hr{border:none;border-top:2px dashed #C8C4BE;margin:52px 0}
-.note{font-size:11px;color:#888;font-style:italic;margin-top:10px;line-height:1.6}
-</style>
-</head>
-<body>
-<div class="page">
-
-<!-- ══ MASTHEAD ══ -->
-<div class="mh">
-  <h1>Ereignis-Editor &amp; Brief-Gruppierung · Quick-Action im Dokument</h1>
-  <p>Wie kuratierte Zeitstrahl-Ereignisse entstehen und wie Briefe gruppiert werden — von zwei Seiten in ein Datenmodell (<code style="font-family:monospace;font-size:12px">TimelineEvent.documents</code>): der <strong>Ereignis-Editor</strong> unter <code style="font-family:monospace;font-size:12px">/zeitstrahl/events/[id]/edit</code> (Kurator baut, verlinkt viele Briefe) und die <strong>Quick-Action im Dokument-Detail</strong> (beim Lesen schnell zuordnen). Beide bauen auf bereits ausgelieferten Komponenten auf.</p>
-  <div class="tag-row">
-    <span class="tg">Milestone #14 · Zeitstrahl</span>
-    <span class="tg mint">Reuse: GeschichteEditor · DocumentMultiSelect · PersonMultiSelect</span>
-    <span class="tg slate">WRITE_ALL</span>
-  </div>
-  <div class="byline">Familienarchiv · 2026-06-08 · Leonie Voss, UX Lead · gegründet auf Code: GeschichteEditor.svelte · DocumentMetadataDrawer.svelte · DocumentMultiSelect.svelte</div>
-</div>
-
-
-<!-- ══ 1 · TWO ENTRY POINTS ══ -->
-<div class="sh">
-  <h2>1 · Zwei Einstiegspunkte, ein Datenmodell</h2>
-  <p>Manuelle Gruppierung = ein <code>TimelineEvent</code> mit verknüpften Dokumenten. Kuratoren arbeiten in beide Richtungen — wir bauen beide, statt eine zu erzwingen.</p>
-</div>
-<div class="states" style="grid-template-columns:1fr 1fr">
-  <div class="callout navy" style="margin:0">
-    <strong>A · Ereignis-zuerst</strong> — der Kurator baut den Zeitstrahl. <code>/zeitstrahl/events/new · [id]/edit</code> mit Dokument-Mehrfach-Picker = <b>Bulk-Linking</b> vieler Briefe auf einmal. Spiegelt 1:1 den <code>GeschichteEditor</code> (gleiche zwei-Spalten-Form, Sidebar-Picker, Sticky-Save-Bar).
-  </div>
-  <div class="callout mint" style="margin:0">
-    <strong>B · Dokument-zuerst</strong> — beim Lesen eines Briefs. Quick-Action im Dokument-Detail: bestehendes Ereignis wählen <i>oder</i> neu anlegen, verlinkt diesen einen Brief. Spiegelt die bestehende <b>Geschichten-Spalte</b> im Details-Drawer (<code>DocumentMetadataDrawer.svelte</code>).
-  </div>
-</div>
-
-
-<!-- ══ 2 · EVENT EDITOR ══ -->
-<div class="sh">
-  <h2>2 · Ereignis-Editor — <code style="font-size:14px">/zeitstrahl/events/[id]/edit</code></h2>
-  <p>Form-Actions-Muster, gegated mit <code>WRITE_ALL</code>. Layout &amp; Verhalten 1:1 vom <code>GeschichteEditor</code> übernommen: Hauptspalte + Sidebar (<code>lg:grid-cols-[2fr_1fr]</code>), Sticky-Save-Bar, <code>beforeNavigate</code>-Warnung bei ungespeicherten Änderungen.</p>
-</div>
-
-<div class="dchrome" style="margin-bottom:16px">
-  <div class="dbar"><div class="ddot"></div><div class="ddot"></div><div class="ddot"></div><div class="durl"></div></div>
-  <div class="dnav"><span class="nlogo">Familienarchiv</span><span class="nlink">Dokumente</span><span class="nlink">Personen</span><span class="nlink on">Zeitstrahl</span><span class="nlink">Stammbaum</span><span class="av">KR</span></div>
-  <div class="dcanvas">
-    <div style="font-size:8px;font-weight:800;letter-spacing:1px;text-transform:uppercase;color:#8a8a86;margin-bottom:10px">‹ Zurück zum Zeitstrahl</div>
-    <div style="font-family:'Tinos',serif;font-size:18px;font-weight:700;color:#012851;margin-bottom:16px">Ereignis bearbeiten</div>
-
-    <div style="display:grid;grid-template-columns:2fr 1fr;gap:22px">
-      <!-- MAIN COLUMN -->
-      <div style="display:flex;flex-direction:column;gap:16px">
-        <!-- ① title -->
-        <div>
-          <div class="inp title" style="width:100%">Briefe von der Front</div>
-        </div>
-        <!-- ② type + ③ date/precision -->
-        <div style="display:flex;gap:22px;flex-wrap:wrap">
-          <div>
-            <div class="lbl">② Typ</div>
-            <div class="seg"><span class="on">Persönlich</span><span>Historisch</span></div>
-          </div>
-          <div>
-            <div class="lbl">③ Datum · Präzision</div>
-            <div style="display:flex;gap:6px;align-items:center">
-              <div class="inp" style="width:120px">1915</div>
-              <div class="inp" style="display:flex;align-items:center;gap:18px;color:#6b7280">Jahr <span style="font-size:8px">▾</span></div>
-            </div>
-            <div style="font-size:9px;color:#9a9a96;margin-top:5px;font-style:italic">Bei „Zeitspanne" erscheint ein zweites End-Datum-Feld. Bei „ca." / „Saison" passt sich nur das Label an.</div>
-          </div>
-        </div>
-        <!-- ④ description -->
-        <div>
-          <div class="lbl">④ Beschreibung <span style="color:#bbb;font-weight:600">· optional</span></div>
-          <div class="inp" style="width:100%;min-height:96px;color:#4a4a46;font-family:'Tinos',serif;line-height:1.6">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 …</div>
-          <div style="font-size:9px;color:#9a9a96;margin-top:5px;font-style:italic">Schlichtes Textfeld (kein Rich-Text wie Geschichten) — Ereignisse sind kurze Notizen, keine Langform.</div>
-        </div>
-      </div>
-
-      <!-- SIDEBAR -->
-      <aside style="display:flex;flex-direction:column;gap:16px">
-        <!-- ⑤ linked letters = grouping -->
-        <div class="card" style="border-color:#a1dcd8;box-shadow:0 2px 10px rgba(161,220,216,.3)">
-          <h3 style="color:#012851">⑤ Verknüpfte Briefe · 24</h3>
-          <div class="hint">Diese Briefe bilden den Cluster. <code style="font-size:9px">DocumentMultiSelect</code></div>
-          <div class="chips">
-            <span class="chip-sel">✉ Westfront-Brief · Mär 1915 <span class="x">×</span></span>
-            <span class="chip-sel">✉ Feldpost Verdun · Jul 1915 <span class="x">×</span></span>
-            <span class="chip-sel">✉ Brief an Elfriede · Sep 1915 <span class="x">×</span></span>
-            <span class="chip-in">Brief suchen …</span>
-          </div>
-        </div>
-        <!-- ⑥ persons -->
-        <div class="card">
-          <h3>⑥ Beteiligte Personen</h3>
-          <div class="hint">Treibt die Lebensweg-Ansicht &amp; Filter. <code style="font-size:9px">PersonMultiSelect</code></div>
-          <div class="chips">
-            <span class="chip-sel">Karl Raddatz <span class="x">×</span></span>
-            <span class="chip-sel">Elfriede Raddatz <span class="x">×</span></span>
-            <span class="chip-sel">Hans Raddatz <span class="x">×</span></span>
-            <span class="chip-in">Person suchen …</span>
-          </div>
-        </div>
-      </aside>
-    </div>
-
-    <!-- ⑦ sticky save bar -->
-    <div style="margin:18px -26px -26px;border-top:1px solid #e4e2d7;background:#fff;box-shadow:0 -2px 8px rgba(0,0,0,.05);padding:13px 26px;display:flex;align-items:center;justify-content:space-between">
-      <span style="font-size:10px;color:#9a9a96">Änderungen werden erst beim Speichern übernommen.</span>
-      <div style="display:flex;gap:8px">
-        <span class="btn danger">Löschen</span>
-        <span class="btn ghost">Abbrechen</span>
-        <span class="btn primary">Speichern</span>
-      </div>
-    </div>
-  </div>
-</div>
-
-<div class="annogrid">
-  <div class="anno"><span class="n">①</span><span><b>Titel</b> — großes Serifen-Feld, wie der Geschichten-Titel. Pflichtfeld (Validierung bei Blur).</span></div>
-  <div class="anno"><span class="n">②</span><span><b>Typ</b> — <code>PERSONAL</code> / <code>HISTORICAL</code> Segmented-Control. Steuert Rendering (Mint-Pille vs. Welt-Band).</span></div>
-  <div class="anno"><span class="n">③</span><span><b>Datum + Präzision</b> — geteilte <code>DatePrecisionInput</code> (gleiche Logik wie Dokument-Datum, <code>metaDatePrecision</code>). „Zeitspanne" blendet End-Datum ein.</span></div>
-  <div class="anno"><span class="n">④</span><span><b>Beschreibung</b> — optionales Textfeld (<code>TEXT</code>), bewusst schlicht.</span></div>
-  <div class="anno"><span class="n">⑤</span><span><b>Verknüpfte Briefe</b> — <b>hier wird gruppiert.</b> Wiederverwendung von <code>DocumentMultiSelect</code> (Typeahead, Chips, Hidden-Inputs).</span></div>
-  <div class="anno"><span class="n">⑥</span><span><b>Beteiligte Personen</b> — <code>PersonMultiSelect</code>. Bestimmt, in welchem „Lebensweg" das Ereignis auftaucht.</span></div>
-  <div class="anno"><span class="n">⑦</span><span><b>Sticky-Save-Bar</b> — Speichern primär, Abbrechen sekundär, Löschen nur im Edit-Modus (mit Bestätigung).</span></div>
-  <div class="anno"><span class="n">＋</span><span><b>/new</b> — leeres Formular. Mit <code>?documentId=…</code> ist Feld ⑤ vorbefüllt (aus der Quick-Action, §4-D).</span></div>
-</div>
-
-
-<!-- ══ 3 · GROUPING / DOCUMENT PICKER ══ -->
-<div class="sh">
-  <h2>3 · Brief-Gruppierung im Editor — der Dokument-Picker</h2>
-  <p>Feld ⑤ ist der unveränderte <code>DocumentMultiSelect</code>: Tippen sucht über <code>/api/documents/search?q=…</code> (debounced 300&nbsp;ms), Treffer mit ehrlichem Datums-Label, bereits gewählte werden gefiltert. Jeder Klick fügt einen Brief zum Cluster.</p>
-</div>
-
-<div class="states">
-  <div class="state">
-    <div class="sh2"><span>Suche aktiv — Dropdown</span><span style="color:#9a9a96">DocumentMultiSelect</span></div>
-    <div class="sb">
-      <div class="chips" style="margin-bottom:0">
-        <span class="chip-sel">✉ Westfront-Brief · Mär 1915 <span class="x">×</span></span>
-        <span class="chip-sel">✉ Feldpost Verdun · Jul 1915 <span class="x">×</span></span>
-        <span class="chip-in" style="color:#012851">Verdun▏</span>
-      </div>
-      <div class="dd">
-        <div class="opt hl">Feldpost aus Verdun <span class="d">· Brief · Juli 1915</span></div>
-        <div class="opt">Brief aus dem Verdun-Lazarett <span class="d">· Brief · August 1916</span></div>
-        <div class="opt">Rückkehr aus Verdun <span class="d">· Brief · ca. 1917</span></div>
-      </div>
-      <div class="cap">Label = <code style="font-size:10px">title · formatDocumentDate(precision)</code>. Bereits verknüpfte Briefe erscheinen nicht in den Treffern (Dedup).</div>
-    </div>
-  </div>
-
-  <div class="state">
-    <div class="sh2"><span>Inline „＋ Ereignis" am Jahres-Band</span><span style="color:#9a9a96">Zeitstrahl</span></div>
-    <div class="sb">
-      <div style="position:relative;padding-left:20px">
-        <div style="position:absolute;left:6px;top:2px;bottom:2px;width:2px;background:linear-gradient(#a1dcd8,#012851)"></div>
-        <div style="font-family:'Tinos',serif;font-size:13px;font-weight:700;color:#012851;margin-bottom:8px">1915</div>
-        <div style="background:#FAF9F5;border:1px solid #eeede8;border-radius:4px;padding:7px 9px;margin-bottom:8px"><div style="font-size:9.5px;font-weight:700;color:#012851">✉ 24 Briefe</div><div style="font-size:8px;color:#9a9a96">Monats-Dichte ▾</div></div>
-        <button style="display:inline-flex;align-items:center;gap:5px;border:1px dashed #a1dcd8;background:#fff;border-radius:6px;padding:5px 11px;font-size:10px;font-weight:600;color:#012851">＋ Ereignis aus diesem Jahr anlegen</button>
-      </div>
-      <div class="cap">Kuratoren können auch direkt im Zeitstrahl ein Ereignis anlegen — öffnet denselben Editor, Jahr &amp; Briefe des Bandes vorbefüllt.</div>
-    </div>
-  </div>
-</div>
-
-
-<hr>
-
-<!-- ══ 4 · QUICK ACTION IN DOCUMENT DETAIL ══ -->
-<div class="sh">
-  <h2>4 · Quick-Action im Dokument-Detail — wo sie lebt</h2>
-  <p>Die Dokument-Detailseite ist ein <b>vollflächiger Viewer ohne Sidebar</b> (<code>fixed inset</code>). Aktions-Flächen gibt es nur zwei: die <code>DocumentTopBar</code> und den aufklappbaren <b>Details-Drawer</b>. Die Quick-Action lebt an beiden — primär als <b>„Zeitstrahl"-Spalte im Drawer</b> (spiegelt die Geschichten-Spalte), plus ein <b>Top-Bar-Button</b> für den Ein-Klick-Weg.</p>
-</div>
-
-<div class="callout navy"><strong>Warum der Details-Drawer der richtige Ort ist:</strong> Er zeigt heute schon, <i>wozu ein Brief gehört</i> — Personen, Schlagwörter und <b>Geschichten</b> (mit „Zuordnen"-Aktion, gegated über <code>canBlogWrite</code>, <code>DocumentMetadataDrawer.svelte:210</code>). Zeitstrahl-Ereignisse sind strukturell identisch („dieser Brief gehört zu diesen Ereignissen") und bekommen daher eine gleichwertige vierte/fünfte Spalte. Konsistent &amp; auffindbar dort, wo Nutzer ohnehin „Zugehörigkeit" suchen.</div>
-
-<div class="dchrome" style="margin-bottom:16px">
-  <div class="dbar"><div class="ddot"></div><div class="ddot"></div><div class="ddot"></div><div class="durl"></div></div>
-  <!-- document topbar -->
-  <div style="background:#fff;border-bottom:1px solid #e4e2d7;box-shadow:0 1px 3px rgba(0,0,0,.05);display:flex;align-items:center;height:54px">
-    <div style="width:3px;height:100%;background:#012851"></div>
-    <div style="width:34px;display:flex;justify-content:center;color:#6b7280;font-size:14px">‹</div>
-    <div style="width:1px;height:22px;background:#e4e2d7;margin:0 6px"></div>
-    <div style="flex:0 1 auto;min-width:0;padding-right:10px">
-      <div style="font-family:'Tinos',serif;font-size:13px;font-weight:700;color:#012851;white-space:nowrap;overflow:hidden;text-overflow:ellipsis">Brief über die Lage an der Westfront</div>
-      <div style="font-size:8.5px;color:#6b7280">März 1915</div>
-    </div>
-    <div style="display:flex;gap:3px;margin-left:6px"><span style="width:20px;height:20px;border-radius:50%;background:#012851;color:#fff;font-size:7px;display:flex;align-items:center;justify-content:center">KR</span><span style="font-size:9px;color:#9a9a96;align-self:center">→</span><span style="width:20px;height:20px;border-radius:50%;background:#5a8a6a;color:#fff;font-size:7px;display:flex;align-items:center;justify-content:center">ER</span></div>
-    <div style="margin-left:auto;display:flex;align-items:center;gap:7px;padding-right:14px">
-      <!-- Details toggle (active) -->
-      <span style="display:inline-flex;align-items:center;gap:5px;background:#012851;color:#fff;border-radius:5px;font-size:10px;font-weight:600;padding:6px 11px">Details ▴</span>
-      <div style="width:1px;height:22px;background:#e4e2d7"></div>
-      <!-- action buttons -->
-      <span style="display:inline-flex;align-items:center;gap:4px;border:1px solid #e4e2d7;border-radius:5px;font-size:10px;font-weight:600;color:#012851;padding:6px 11px">✎ Transkribieren</span>
-      <!-- NEW: Zeitstrahl quick button -->
-      <span style="display:inline-flex;align-items:center;gap:4px;background:#a1dcd8;color:#012851;border-radius:5px;font-size:10px;font-weight:700;padding:6px 11px">⊕ Zeitstrahl</span>
-      <span style="display:inline-flex;align-items:center;gap:4px;border:1px solid #e4e2d7;border-radius:5px;font-size:10px;color:#012851;padding:6px 9px">⤓</span>
-    </div>
-  </div>
-
-  <!-- metadata drawer (opened) -->
-  <div style="background:#fff;border-bottom:1px solid #e4e2d7;padding:20px 24px">
-    <div style="display:grid;grid-template-columns:repeat(4,1fr);gap:24px">
-      <!-- Details -->
-      <div>
-        <div class="lbl">Details</div>
-        <div style="font-size:8px;font-weight:600;color:#9a9a96;margin-bottom:1px">Datum</div><div style="font-family:'Tinos',serif;font-size:12px;color:#012851;margin-bottom:8px">März 1915</div>
-        <div style="font-size:8px;font-weight:600;color:#9a9a96;margin-bottom:1px">Ort</div><div style="font-family:'Tinos',serif;font-size:12px;color:#012851;margin-bottom:8px">Westfront</div>
-        <div style="font-size:8px;font-weight:600;color:#9a9a96;margin-bottom:1px">Status</div><div style="font-family:'Tinos',serif;font-size:12px;color:#012851">Transkribiert</div>
-      </div>
-      <!-- Personen -->
-      <div>
-        <div class="lbl">Personen</div>
-        <div style="display:flex;align-items:center;gap:7px;margin-bottom:6px"><span style="width:26px;height:26px;border-radius:50%;background:#012851;color:#fff;font-size:8px;display:flex;align-items:center;justify-content:center">KR</span><span style="font-family:'Tinos',serif;font-size:12px;color:#012851">Karl Raddatz</span></div>
-        <div style="display:flex;align-items:center;gap:7px"><span style="width:26px;height:26px;border-radius:50%;background:#5a8a6a;color:#fff;font-size:8px;display:flex;align-items:center;justify-content:center">ER</span><span style="font-family:'Tinos',serif;font-size:12px;color:#012851">Elfriede Raddatz</span></div>
-      </div>
-      <!-- Schlagwörter -->
-      <div>
-        <div class="lbl">Schlagwörter</div>
-        <div style="display:flex;flex-wrap:wrap;gap:5px"><span style="background:#f5f4ef;border-radius:3px;font-size:8px;font-weight:700;letter-spacing:.4px;text-transform:uppercase;color:#012851;padding:3px 7px">Krieg</span><span style="background:#f5f4ef;border-radius:3px;font-size:8px;font-weight:700;letter-spacing:.4px;text-transform:uppercase;color:#012851;padding:3px 7px">Briefe von der Front</span></div>
-      </div>
-      <!-- NEW: Zeitstrahl column -->
-      <div style="border-left:2px solid #eef6f5;padding-left:18px;margin-left:-6px">
-        <div style="display:flex;align-items:center;justify-content:space-between;margin-bottom:9px">
-          <span class="lbl" style="margin:0;color:#012851">Zeitstrahl</span>
-          <span style="font-size:9px;font-weight:600;color:#6b7280">+ Zuordnen</span>
-        </div>
-        <!-- linked event -->
-        <div style="border:1px solid #e4e2d7;border-radius:5px;padding:7px 9px;margin-bottom:8px">
-          <div style="display:flex;align-items:center;justify-content:space-between"><span style="font-family:'Tinos',serif;font-size:11px;font-weight:700;color:#012851">Briefe von der Front</span><span style="color:#9a9a96;font-size:11px">×</span></div>
-          <div style="font-size:8px;color:#9a9a96;margin-top:1px">1915 · 24 Briefe · persönlich</div>
-          <span class="tagchip" style="margin-top:5px"><i></i>Krieg</span>
-        </div>
-        <!-- quick add row -->
-        <div style="display:flex;gap:6px">
-          <span style="flex:1;border:1px solid #e4e2d7;border-radius:4px;font-size:9px;color:#9a9a96;padding:5px 8px">Ereignis suchen …</span>
-          <span style="background:#012851;color:#fff;border-radius:4px;font-size:9px;font-weight:600;padding:5px 8px;white-space:nowrap">＋ Neu</span>
-        </div>
-      </div>
-    </div>
-  </div>
-  <div style="height:120px;background:repeating-linear-gradient(45deg,#ececec,#ececec 8px,#e4e4e4 8px,#e4e4e4 16px);display:flex;align-items:center;justify-content:center;color:#aaa;font-size:10px">↓ PDF-Viewer (Brief-Scan) …</div>
-</div>
-
-<div class="annogrid">
-  <div class="anno"><span class="n">A</span><span><b>Top-Bar-Button „⊕ Zeitstrahl"</b> — Mint-Akzent im Aktions-Cluster (<code>DocumentTopBarActions</code>). Öffnet ein kleines Popover zum Ein-Klick-Zuordnen, ohne den Drawer zu öffnen. Im Mobile-Menü als Eintrag.</span></div>
-  <div class="anno"><span class="n">B</span><span><b>„Zeitstrahl"-Spalte im Details-Drawer</b> — neue Spalte neben Geschichten. Zeigt verknüpfte Ereignisse (Titel · Datum · Tag-Chip), Unlink über <code>×</code>, plus Quick-Add-Zeile. Nur sichtbar/aktiv bei <code>canWrite</code>.</span></div>
-  <div class="anno"><span class="n">C</span><span><b>Quick-Add-Zeile</b> — Typeahead „Ereignis suchen …" (sofortiges Verlinken, keine Navigation) + <b>„＋ Neu"</b>.</span></div>
-  <div class="anno"><span class="n">D</span><span><b>„＋ Neu"</b> → <code>/zeitstrahl/events/new?documentId={id}</code> — öffnet den Editor (§2) mit diesem Brief in Feld ⑤ vorbefüllt. Spiegelt <code>/geschichten/new?documentId=</code>.</span></div>
-</div>
-
-
-<!-- ══ 5 · QUICK-ADD STATES ══ -->
-<div class="sh"><h2>5 · Quick-Action — Zustände</h2><p>Der Typeahead in der Zeitstrahl-Spalte (oder im Top-Bar-Popover). Gleiches Muster wie <code>DocumentMultiSelect</code>, nur sucht es Ereignisse statt Dokumente.</p></div>
-
-<div class="states" style="grid-template-columns:repeat(2,1fr)">
-  <div class="state">
-    <div class="sh2"><span>A · Nicht zugeordnet</span></div>
-    <div class="sb">
-      <div style="font-size:10px;color:#9a9a96;font-style:italic;margin-bottom:9px">Noch keinem Ereignis zugeordnet.</div>
-      <div style="display:flex;gap:6px"><span style="flex:1;border:1px solid #e4e2d7;border-radius:4px;font-size:10px;color:#9a9a96;padding:6px 9px">Ereignis suchen …</span><span class="btn primary" style="height:30px;font-size:10px;padding:0 11px">＋ Neu</span></div>
-    </div>
-  </div>
-  <div class="state">
-    <div class="sh2"><span>B · Suche — Treffer</span></div>
-    <div class="sb">
-      <div style="border:1px solid #012851;border-radius:4px;font-size:10px;color:#012851;padding:6px 9px;margin-bottom:0">Front▏</div>
-      <div class="dd">
-        <div class="opt hl">Briefe von der Front <span class="d">· 1915 · 24 Briefe</span></div>
-        <div class="opt">Kriegsausbruch <span class="d">· 1914 · 6 Briefe</span></div>
-        <div class="opt" style="color:#012851;font-weight:600">＋ „Front" als neues Ereignis anlegen</div>
-      </div>
-    </div>
-  </div>
-  <div class="state">
-    <div class="sh2"><span>C · Zugeordnet</span></div>
-    <div class="sb">
-      <div style="border:1px solid #e4e2d7;border-radius:5px;padding:7px 9px"><div style="display:flex;align-items:center;justify-content:space-between"><span style="font-family:'Tinos',serif;font-size:11px;font-weight:700;color:#012851">Briefe von der Front</span><span style="font-size:9px;color:#2e7d57">✓ verknüpft <span style="color:#9a9a96">×</span></span></div><span class="tagchip" style="margin-top:5px"><i></i>Krieg</span></div>
-      <div class="cap">Sofortiges Verlinken (POST). Toast „Zum Ereignis hinzugefügt", <code style="font-size:10px">aria-live</code>. Unlink über <code>×</code> (DELETE).</div>
-    </div>
-  </div>
-  <div class="state">
-    <div class="sh2"><span>D · Mehrfach zugeordnet</span></div>
-    <div class="sb">
-      <div style="display:flex;flex-direction:column;gap:5px">
-        <div style="border:1px solid #e4e2d7;border-radius:5px;padding:5px 9px;display:flex;justify-content:space-between"><span style="font-family:'Tinos',serif;font-size:10.5px;color:#012851">Briefe von der Front</span><span style="font-size:9px;color:#9a9a96">×</span></div>
-        <div style="border:1px solid #e4e2d7;border-radius:5px;padding:5px 9px;display:flex;justify-content:space-between"><span style="font-family:'Tinos',serif;font-size:10.5px;color:#012851">Weihnachten 1915</span><span style="font-size:9px;color:#9a9a96">×</span></div>
-      </div>
-      <div class="cap">Ein Brief darf zu mehreren Ereignissen gehören (ManyToMany) — alle werden gelistet.</div>
-    </div>
-  </div>
-</div>
-
-
-<!-- ══ 6 · TOKENS ══ -->
-<div class="sh"><h2>6 · Wiederverwendete Bausteine &amp; Tokens</h2></div>
-<div class="callout mint"><strong>Maximal wiederverwenden:</strong> <code>DocumentMultiSelect</code> (Brief-Gruppierung, unverändert) · <code>PersonMultiSelect</code> (Beteiligte) · <code>GeschichteEditor</code>-Layout (zwei Spalten, Sticky-Save, <code>beforeNavigate</code>) · <code>DocumentMetadataDrawer</code>-Spaltenmuster (Quick-Action) · <code>useUnsavedWarning</code> · <code>formatDocumentDate</code> / <code>DatePrecision</code>. Brand-Tokens wie im Zeitstrahl-Spec: Navy <code>#012851</code>, Mint <code>#a1dcd8</code>, Linie <code>#e4e2d7</code>, ink-3 <code>#6b7280</code>, danger <code>#c0392b</code>; Serifen-Titel (Tinos), Sans-Chrome (Montserrat).</div>
-
-
-<!-- ══ 7 · IMPL-REF ══ -->
-<div class="sh"><h2>7 · Implementierungs-Referenz &amp; Barrierefreiheit</h2></div>
-<div class="impl-ref">
-  <table>
-    <tr><th>Baustein</th><th>Datei / Endpoint</th><th>Verantwortung</th></tr>
-    <tr><td>Editor-Route (neu)</td><td><code>/zeitstrahl/events/new · [id]/edit</code></td><td><code>+page.server.ts</code> (Form-Actions, <code>WRITE_ALL</code>) + <code>+page.svelte</code>; <code>?documentId=</code> vorbefüllt Feld ⑤</td></tr>
-    <tr><td>Editor-Komponente (neu)</td><td><code>TimelineEventEditor.svelte</code></td><td>Spiegelt <code>GeschichteEditor</code>: Titel, Typ, Datum+Präzision, Beschreibung; Sidebar-Picker; Sticky-Save; <code>beforeNavigate</code></td></tr>
-    <tr><td>Brief-Gruppierung (reuse)</td><td><code>DocumentMultiSelect.svelte</code></td><td>Unverändert — Typeahead <code>/api/documents/search</code>, Chips, Hidden-Inputs <code>documentIds</code></td></tr>
-    <tr><td>Personen (reuse)</td><td><code>PersonMultiSelect.svelte</code></td><td>Unverändert — Beteiligte Personen</td></tr>
-    <tr><td>Datum + Präzision</td><td><code>DatePrecisionInput</code> (geteilt)</td><td>Wie Dokument-Datum (<code>metaDatePrecision</code>); „Zeitspanne" → End-Datum; <code>formatDocumentDate</code> fürs Label</td></tr>
-    <tr><td>Quick-Action-Spalte (neu)</td><td><code>DocumentTimelineColumn.svelte</code></td><td>Im <code>DocumentMetadataDrawer</code> neben Geschichten; verknüpfte Ereignisse + Quick-Add; nur bei <code>canWrite</code></td></tr>
-    <tr><td>Quick-Add-Picker (neu)</td><td><code>DocumentTimelineEventPicker.svelte</code></td><td>Ereignis-Typeahead; sofort verlinken oder <code>?documentId=</code> zum Editor; auch im Top-Bar-Popover</td></tr>
-    <tr><td>Top-Bar-Button (neu)</td><td><code>DocumentTopBarActions</code> · <code>DocumentMobileMenu</code></td><td>„⊕ Zeitstrahl"-Button (canWrite); öffnet Quick-Add-Popover</td></tr>
-    <tr><td>Backend — CRUD</td><td><code>POST · PUT · DELETE /api/timeline/events</code></td><td><code>TimelineEventController</code>, <code>WRITE_ALL</code>; <code>TimelineEventRequest</code> mit <code>documentIds</code> / <code>personIds</code></td></tr>
-    <tr><td>Backend — Link/Unlink</td><td><code>PUT /api/timeline/events/{id}</code></td><td>Verlinken/Lösen läuft über das Event-Update (<code>documents</code>-Set); kein neuer ErrorCode nötig</td></tr>
-    <tr><td>Barrierefreiheit</td><td>—</td><td>Picker-Dropdowns Tastatur-navigierbar (↑↓↵), <code>aria-live</code> für „verknüpft/gelöst"; 44px-Ziele; sichtbarer Fokus-Ring; Löschen/Unlink mit Bestätigung</td></tr>
-  </table>
-</div>
-<div class="note">Offene Designentscheidung: Soll der Top-Bar-Button (A) MVP sein oder reicht zunächst die Drawer-Spalte (B)? Empfehlung: <b>B als MVP</b> (spiegelt Geschichten exakt, geringster Aufwand), A als schneller Nachzug.</div>
-
-</div>
-</body>
-</html>
--- a/docs/specs/zeitstrahl-final-spec.html
+++ b/docs/specs/zeitstrahl-final-spec.html
@@ -1,391 +0,0 @@
-<!DOCTYPE html>
-<html lang="de">
-<head>
-<meta charset="UTF-8">
-<meta name="viewport" content="width=device-width, initial-scale=1.0">
-<title>Globaler Zeitstrahl — Finale Spezifikation (Konzept A) · Milestone #14 · Familienarchiv</title>
-<link href="https://fonts.googleapis.com/css2?family=Tinos:ital,wght@0,400;0,700;1,400&family=Montserrat:wght@400;500;600;700;800;900&display=swap" rel="stylesheet">
-<style>
-*,*::before,*::after{box-sizing:border-box;margin:0;padding:0}
-body{font-family:'Montserrat',system-ui,sans-serif;background:#ECEAE4;color:#1A1A1A;line-height:1.5;font-size:13px}
-.page{max-width:1320px;margin:0 auto;padding:48px 32px 120px}
-
-/* Masthead */
-.mh{padding-bottom:24px;border-bottom:3px solid #012851;margin-bottom:48px}
-.mh h1{font-size:23px;font-weight:900;color:#012851;letter-spacing:-.4px}
-.mh p{font-size:13px;color:#555;max-width:780px;line-height:1.75;margin-top:8px}
-.mh .byline{font-size:9px;color:#999;font-weight:700;letter-spacing:1.5px;text-transform:uppercase;margin-top:10px}
-.tag-row{display:flex;gap:6px;margin-top:12px;flex-wrap:wrap}
-.tg{background:#012851;color:#a1dcd8;padding:2px 8px;border-radius:2px;font-size:8px;font-weight:700;letter-spacing:.8px;text-transform:uppercase}
-.tg.mint{background:#a1dcd8;color:#012851}
-.tg.slate{background:#607080;color:#e8edf2}
-
-.sh{margin:60px 0 24px;padding-bottom:12px;border-bottom:2px solid #E0DDD6}
-.sh h2{font-size:17px;font-weight:900;color:#012851}
-.sh p{font-size:12.5px;color:#666;margin-top:5px;max-width:780px;line-height:1.65}
-
-.callout{padding:13px 17px;border-radius:4px;font-size:12px;line-height:1.65;margin-bottom:18px}
-.callout.navy{background:rgba(1,40,81,.06);border-left:3px solid #012851;color:#333}
-.callout.mint{background:rgba(161,220,216,.18);border-left:3px solid #00c7b1;color:#1f3a3a}
-.callout strong{font-weight:800;color:#012851}
-
-/* legend */
-.legend{display:grid;grid-template-columns:repeat(3,1fr);gap:12px}
-.lg{background:#fff;border:1px solid #E0DDD6;border-radius:7px;padding:12px 14px;display:flex;gap:11px}
-.lg .ico{flex-shrink:0;width:30px;height:30px;border-radius:50%;display:flex;align-items:center;justify-content:center;font-size:14px}
-.lg .ttl{font-size:10.5px;font-weight:800;color:#012851;margin-bottom:2px}
-.lg .body{font-size:9.5px;color:#5a5a56;line-height:1.5}
-.lg .body code{font-size:8.5px;background:#F0EFE9;padding:1px 3px;border-radius:2px;color:#444}
-
-/* precision table */
-.rules{background:#fff;border:1px solid #E0DDD6;border-radius:7px;overflow:hidden;margin-top:8px}
-.rules table{width:100%;border-collapse:collapse}
-.rules th{background:#F4F2EC;font-size:8px;font-weight:800;text-transform:uppercase;letter-spacing:.8px;color:#888;padding:8px 12px;text-align:left;border-bottom:1px solid #E0DDD6}
-.rules td{font-size:11px;color:#444;padding:7px 12px;border-bottom:1px solid #F0EEE8;vertical-align:top;line-height:1.5}
-.rules tr:last-child td{border-bottom:none}
-.rules td:first-child{font-weight:700;color:#012851;width:110px}
-.rules td code{font-size:10px;background:#F0EFE9;padding:1px 5px;border-radius:2px;color:#444}
-.rules .ex{font-family:'Tinos',serif;font-size:13px;color:#012851}
-
-/* ── Timeline atoms (Konzept A) ── */
-.tl-canvas{background:#f0efe9;border:1.5px solid #E0DDD6;border-radius:10px;padding:24px 26px 30px}
-.dh{font-family:'Tinos',serif;font-size:20px;font-weight:700;color:#012851}
-.dh-sub{font-size:9.5px;color:#7a7a76;margin-bottom:20px}
-
-/* desktop centered axis */
-.axis{position:relative;max-width:780px;margin:0 auto;padding:4px 0}
-.axis::before{content:"";position:absolute;left:50%;top:0;bottom:0;width:2.5px;background:linear-gradient(#a1dcd8,#012851,#607080);transform:translateX(-50%)}
-.ybadge{text-align:center;position:relative;margin:4px 0 14px}
-.ybadge span{background:#012851;color:#fff;font-family:'Tinos',serif;font-size:13px;font-weight:700;padding:2px 15px;border-radius:12px;position:relative;z-index:2}
-.pill{text-align:center;position:relative;margin-bottom:15px}
-.pill .inner{display:inline-flex;align-items:center;gap:9px;background:#fff;border:1.5px solid #012851;border-radius:22px;padding:5px 16px 5px 5px;position:relative;z-index:2;box-shadow:0 2px 7px rgba(1,40,81,.12)}
-.pill.curated .inner{border-color:#a1dcd8;border-width:2px}
-.pill .gly{width:28px;height:28px;border-radius:50%;background:#012851;color:#a1dcd8;font-size:14px;display:flex;align-items:center;justify-content:center;flex-shrink:0}
-.pill.curated .gly{background:#a1dcd8;color:#012851}
-.pill .tx{text-align:left}
-.pill .tx .t{font-family:'Tinos',serif;font-size:12px;font-weight:700;color:#012851;display:block;line-height:1.15}
-.pill .tx .s{font-size:8.5px;color:#8a8a86}
-.wband{position:relative;margin:0 -26px 15px;padding:7px 26px;background:#EEEBE2;border-top:1px solid #ddd8cc;border-bottom:1px solid #ddd8cc;text-align:center}
-.wband .t{font-family:'Tinos',serif;font-style:italic;font-size:12px;color:#5a6776}
-.wband .s{font-size:8.5px;color:#8a8a86;margin-left:8px}
-.lrow{display:flex;align-items:flex-start;margin-bottom:12px}
-.lrow .half{flex:1}
-.lrow .dot{width:13px;height:13px;border-radius:50%;background:#fff;border:2.5px solid #a1dcd8;margin-top:9px;flex-shrink:0;z-index:2;position:relative}
-.lrow .a{padding-right:26px;text-align:right}
-.lrow .b{padding-left:26px;text-align:left}
-.lcard{display:inline-block;text-align:left;background:#fff;border:1px solid #e4e2d7;border-radius:5px;padding:8px 11px;box-shadow:0 1px 3px rgba(0,0,0,.05);max-width:300px}
-.lcard.ev{border-left:3px solid #a1dcd8}
-.lcard .t{font-size:11px;font-weight:700;color:#1A1A1A}
-.lcard.ev .t{font-family:'Tinos',serif}
-.lcard .m{font-size:8.5px;color:#9a9a96;margin-top:1px}
-
-.chip{display:inline-flex;align-items:center;gap:3px;font-size:7.5px;border-radius:9px;padding:2px 7px;margin-top:5px}
-.chip i{width:6px;height:6px;border-radius:2px;display:inline-block;flex-shrink:0}
-.chip.krieg{color:#a0522d;background:#f6ece6}.chip.krieg i{background:#a0522d}
-.chip.weih{color:#c17a00;background:#fbf3e3}.chip.weih i{background:#c17a00}
-.chip.fam{color:#5a8a6a;background:#eaf1ec}.chip.fam i{background:#5a8a6a}
-
-/* dense aggregate strip */
-.strip{max-width:440px;margin:0 auto 15px;position:relative;z-index:2;background:#fff;border:1px solid #e4e2d7;border-radius:6px;box-shadow:0 1px 3px rgba(0,0,0,.05);padding:9px 13px}
-.strip .hd{display:flex;align-items:center;justify-content:space-between;margin-bottom:6px}
-.strip .ct{font-size:10.5px;font-weight:700;color:#012851}
-.strip .ex{font-size:8px;color:#8a8a86}
-.spark{display:flex;align-items:flex-end;gap:1.5px;height:30px}
-.spark div{flex:1;background:#a1dcd8;border-radius:1px;min-height:1px}
-.strip .axl{display:flex;justify-content:space-between;margin-top:3px}
-.strip .axl span{font-size:6px;color:#bbb}
-
-/* compressed gap */
-.gap{max-width:440px;margin:0 auto 15px;position:relative;z-index:2;display:flex;align-items:center;gap:9px;padding:5px 14px;border:1px dashed #cfccc4;border-radius:18px;background:#f0efe9;color:#9a958c;font-size:9px;font-style:italic}
-.gap .ln{flex:1;height:1px;background:#ddd8cc}
-.gap b{color:#7a756c;font-style:normal;font-family:'Tinos',serif;font-size:10px}
-
-/* undated bucket */
-.undated{max-width:540px;margin:20px auto 0;background:#fff;border:1px dashed #c4c0ba;border-radius:6px;padding:12px 15px}
-.undated .h{font-family:'Tinos',serif;font-size:12px;font-weight:700;color:#7a756c;margin-bottom:6px}
-
-/* case tag floating */
-.casetag{display:inline-block;background:#012851;color:#a1dcd8;font-size:7px;font-weight:800;letter-spacing:.6px;text-transform:uppercase;padding:2px 7px;border-radius:3px;margin-bottom:6px}
-
-/* narrow (phone / rail) column */
-.col3{display:grid;grid-template-columns:repeat(3,1fr);gap:18px}
-.modehd{font-size:9px;font-weight:800;letter-spacing:1px;text-transform:uppercase;color:#012851;margin-bottom:4px;display:flex;align-items:center;gap:6px}
-.modehd .seg{background:#012851;color:#fff;font-size:7px;padding:2px 7px;border-radius:4px}
-.modesub{font-size:9.5px;color:#888;font-style:italic;margin-bottom:9px;line-height:1.45;min-height:42px}
-.nf{background:#fff;border:1px solid #e4e2d7;border-radius:6px;padding:14px}
-.nsp{position:relative;padding-left:21px}
-.nsp::before{content:"";position:absolute;left:7px;top:4px;bottom:4px;width:2px;background:linear-gradient(#a1dcd8,#012851,#607080)}
-.nyr{font-family:'Tinos',serif;font-size:12px;font-weight:700;color:#012851;margin:2px 0 7px;position:relative}
-.nyr::before{content:"";position:absolute;left:-14px;top:4px;width:8px;height:8px;border-radius:50%;background:#012851;border:2px solid #fff;box-shadow:0 0 0 1.5px #012851}
-.nnode{position:relative;margin-bottom:9px}
-.nnode .g{position:absolute;left:-18px;top:0;width:14px;height:14px;border-radius:50%;background:#012851;border:2px solid #fff;box-shadow:0 0 0 1.5px #012851;color:#a1dcd8;font-size:8px;display:flex;align-items:center;justify-content:center}
-.nnode .lt{font-family:'Tinos',serif;font-size:10.5px;font-weight:700;color:#012851;line-height:1.2}
-.nnode .lm{font-size:7.5px;color:#8a8a86}
-.nwb{position:relative;margin:0 0 9px -9px;padding:5px 8px;background:#EEEBE2;border-left:2px solid #607080;border-radius:0 3px 3px 0}
-.nwb .t{font-family:'Tinos',serif;font-style:italic;font-size:9.5px;color:#5a6776}
-.nwb .s{font-size:7px;color:#8a8a86}
-.nletter{position:relative;margin-bottom:7px}
-.nletter .d{position:absolute;left:-15px;top:3px;width:6px;height:6px;border-radius:50%;background:#fff;border:1.5px solid #a1dcd8}
-.ncard{background:#FAF9F5;border:1px solid #eeede8;border-radius:4px;padding:5px 8px}
-.ncard .t{font-size:9px;font-weight:700;color:#1A1A1A}
-.ncard .m{font-size:7px;color:#9a9a96}
-.nstrip{background:#FAF9F5;border:1px solid #eeede8;border-radius:4px;padding:6px 8px;margin-bottom:7px}
-.nbucket{border:1px solid #e4e2d7;border-radius:4px;padding:5px 8px;margin-bottom:5px;display:flex;align-items:center;justify-content:space-between}
-
-/* impl-ref */
-.impl-ref{background:#fff;border:1px solid #E0DDD6;border-radius:7px;overflow:hidden;margin-top:8px}
-.impl-ref table{width:100%;border-collapse:collapse}
-.impl-ref th{background:#012851;color:#fff;padding:8px 13px;text-align:left;font-size:8px;font-weight:800;letter-spacing:.6px;text-transform:uppercase}
-.impl-ref td{padding:8px 13px;border-bottom:1px solid #F0EEE8;vertical-align:top;font-size:11px;color:#444;line-height:1.55}
-.impl-ref tr:nth-child(even) td{background:#FAFAF7}
-.impl-ref td:first-child{font-weight:700;color:#012851;white-space:nowrap;width:165px}
-.impl-ref td code{font-size:9.5px;background:#F0EFE9;padding:1px 4px;border-radius:2px;font-family:'Courier New',monospace;color:#333}
-.sw{display:inline-block;width:11px;height:11px;border-radius:2px;vertical-align:-1px;margin-right:5px;border:1px solid rgba(0,0,0,.12)}
-
-hr{border:none;border-top:2px dashed #C8C4BE;margin:50px 0}
-.note{font-size:11px;color:#888;font-style:italic;margin-top:10px;line-height:1.6}
-</style>
-</head>
-<body>
-<div class="page">
-
-<!-- ══ MASTHEAD ══ -->
-<div class="mh">
-  <h1>Globaler Zeitstrahl — Finale Spezifikation</h1>
-  <p>Kanonische Spezifikation für <code style="font-family:monospace;font-size:12px">/zeitstrahl</code> auf Basis von <strong>Konzept A „Der Lebensfaden"</strong>: 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.</p>
-  <div class="tag-row">
-    <span class="tg">Milestone #14 · Zeitstrahl</span>
-    <span class="tg mint">Konzept A — final</span>
-    <span class="tg slate">Phone-first · honest DatePrecision</span>
-  </div>
-  <div class="byline">Familienarchiv · 2026-06-08 · Leonie Voss, UX Lead · ersetzt die A/B/C-Exploration zeitstrahl-global-concepts.html</div>
-</div>
-
-
-<!-- ══ 1 · ANATOMIE ══ -->
-<div class="sh">
-  <h2>1 · Anatomie von Konzept A</h2>
-  <p>Eine Achse, sieben Bausteine. Die Zeit ist die Achse — Lebensereignisse &amp; Jahre als zentrierte Pillen <i>unterbrechen</i> den Faden (Text wird nie von der Linie gekreuzt), Welt-Ereignisse legen sich als Bänder quer, Briefe verdichten sich adaptiv.</p>
-</div>
-
-<div class="legend" style="margin-bottom:16px">
-  <div class="lg"><div class="ico" style="background:#012851;color:#a1dcd8">⚭</div><div><div class="ttl">Lebensereignis-Pille</div><div class="body">Geburt <b>*</b> · Tod <b>†</b> · Heirat <b>⚭</b>. Abgeleitet aus <code>Person</code>-Daten. Zentriert, gefüllt — unterbricht die Achse. Glyphen aus <code>personLifeDates.ts</code>.</div></div></div>
-  <div class="lg"><div class="ico" style="background:#fff;border:2px solid #a1dcd8;color:#012851">★</div><div><div class="ttl">Kuratierte Ereignis-Pille</div><div class="body"><code>PERSONAL</code> — Umzug, Auswanderung. Mint-Rand. Editierbar im Kurator-Editor.</div></div></div>
-  <div class="lg"><div class="ico" style="background:#EEEBE2;color:#607080;border:1px solid #607080">◍</div><div><div class="ttl">Welt-Band</div><div class="body"><code>HISTORICAL</code> — Krieg, Inflation. Gedämpftes Band quer über die Achse als Kontext.</div></div></div>
-  <div class="lg"><div class="ico" style="background:#fff;border:2px solid #a1dcd8"></div><div><div class="ttl">Einzel-Brief</div><div class="body">Kleiner Punkt + Karte, alternierend links/rechts. Wurzel-Tag-Farbchip. Link zu <code>/documents/[id]</code>.</div></div></div>
-  <div class="lg"><div class="ico" style="background:#a1dcd8;color:#012851;font-size:11px">▭</div><div><div class="ttl">Jahres-Strip</div><div class="body">Verdichtung dichter Jahre: Anzahl + 12-Monats-Sparkline. <code>MonthBucket</code> / <code>aggregateToYears</code>.</div></div></div>
-  <div class="lg"><div class="ico" style="background:#f0efe9;border:1px dashed #c4c0ba;color:#9a958c;font-size:11px">⋯</div><div><div class="ttl">Lücke &amp; Ohne-Datum</div><div class="body">Ruhige/leere Jahre als dünne Span-Zeile gefaltet; <code>UNKNOWN</code>-Briefe im „Ohne Datum"-Eimer am Ende.</div></div></div>
-</div>
-
-<div class="callout navy"><strong>Gruppierungs-Umschalter</strong> (oben rechts im Zeitstrahl): <span style="display:inline-flex;border:1.5px solid #012851;border-radius:5px;overflow:hidden;vertical-align:middle;margin:0 4px"><span style="background:#012851;color:#fff;font-size:9px;font-weight:700;padding:3px 11px">Datum</span><span style="color:#012851;font-size:9px;font-weight:700;padding:3px 11px;border-left:1px solid #012851">Ereignis</span><span style="color:#012851;font-size:9px;font-weight:700;padding:3px 11px;border-left:1px solid #012851">Thema</span></span> steuert <b>nur, wie lose Briefe gebündelt werden</b>. Lebensereignisse, kuratierte Ereignisse und Welt-Bänder bleiben in allen Modi gleich auf der Achse. Standard = <b>Datum</b>.</div>
-
-
-<!-- ══ 2 · GROUPING MODES ══ -->
-<div class="sh">
-  <h2>2 · Die drei Gruppierungs-Modi</h2>
-  <p>Gleicher Ausschnitt (1914–1915), dreimal gerendert. Nur die <b>losen Briefe</b> ordnen sich um — die Achse bleibt stabil. Schmale Spaltenbreite = Phone-/Lebensweg-Form derselben Komponente.</p>
-</div>
-
-<div class="col3">
-
-  <!-- MODE: DATUM -->
-  <div>
-    <div class="modehd"><span class="seg">Datum</span> Chronologisch</div>
-    <div class="modesub">Standard. Briefe nach Datum; dichte Jahre verdichten zum Strip. Reine Zeit-Reihung.</div>
-    <div class="nf">
-      <div class="nsp">
-        <div class="nyr">1914</div>
-        <div class="nnode"><span class="g">⚭</span><div class="lt">Heirat: Karl &amp; Elfriede</div><div class="lm">1914 · abgeleitet</div></div>
-        <div class="nwb"><div class="t">◍ Erster Weltkrieg</div><div class="s">1914–1918</div></div>
-        <div class="nletter"><span class="d"></span><div class="ncard"><div class="t">✉ Kriegsausbruch — Brief an die Familie</div><div class="m">Karl → Elfriede · 4. Aug 1914</div></div></div>
-
-        <div class="nyr">1915</div>
-        <div class="nnode"><span class="g">*</span><div class="lt">Geburt: Hans Raddatz</div><div class="lm">Sommer 1915 · abgeleitet</div></div>
-        <div class="nstrip">
-          <div style="display:flex;justify-content:space-between;align-items:center;margin-bottom:5px"><span style="font-size:9.5px;font-weight:700;color:#012851">✉ 24 Briefe</span><span style="font-size:7px;color:#8a8a86">Monate ▾</span></div>
-          <div style="display:flex;align-items:flex-end;gap:1.5px;height:20px"><div style="flex:1;height:20%;background:#a1dcd8"></div><div style="flex:1;height:35%;background:#a1dcd8"></div><div style="flex:1;height:55%;background:#a1dcd8"></div><div style="flex:1;height:70%;background:#a1dcd8"></div><div style="flex:1;height:60%;background:#a1dcd8"></div><div style="flex:1;height:85%;background:#a1dcd8"></div><div style="flex:1;height:100%;background:#a1dcd8"></div><div style="flex:1;height:88%;background:#a1dcd8"></div><div style="flex:1;height:72%;background:#a1dcd8"></div><div style="flex:1;height:48%;background:#a1dcd8"></div><div style="flex:1;height:55%;background:#a1dcd8"></div><div style="flex:1;height:40%;background:#a1dcd8"></div></div>
-        </div>
-      </div>
-    </div>
-  </div>
-
-  <!-- MODE: EREIGNIS -->
-  <div>
-    <div class="modehd"><span class="seg">Ereignis</span> Kuratiert</div>
-    <div class="modesub">Briefe bündeln unter kuratierte Ereignisse (<code>TimelineEvent.documents</code>). Erzählende Cluster statt Listen.</div>
-    <div class="nf">
-      <div class="nsp">
-        <div class="nyr">1914</div>
-        <div class="nnode"><span class="g">⚭</span><div class="lt">Heirat: Karl &amp; Elfriede</div><div class="lm">1914 · abgeleitet</div></div>
-        <div class="nwb"><div class="t">◍ Erster Weltkrieg</div><div class="s">1914–1918</div></div>
-
-        <div class="nyr">1915</div>
-        <div class="nnode"><span class="g">*</span><div class="lt">Geburt: Hans Raddatz</div><div class="lm">Sommer 1915 · abgeleitet</div></div>
-        <div class="nletter"><span class="d"></span><div class="ncard" style="border-left:2px solid #a1dcd8"><div class="t">✉ Briefe von der Front · 24</div><div class="m">Karl ⇄ Elfriede &amp; Hans · 1915 ▾</div><span class="chip krieg" style="margin-top:4px"><i></i>Krieg</span></div></div>
-        <div class="nletter"><span class="d"></span><div class="ncard" style="border-left:2px solid #a1dcd8"><div class="t">✉ Weihnachten 1915 · 3</div><div class="m">kuratiertes Ereignis ▾</div><span class="chip weih" style="margin-top:4px"><i></i>Weihnachten</span></div></div>
-      </div>
-    </div>
-  </div>
-
-  <!-- MODE: THEMA -->
-  <div>
-    <div class="modehd"><span class="seg">Thema</span> Nach Wurzel-Tag</div>
-    <div class="modesub">Optional (Post-MVP). Lose Briefe je Jahr in Wurzel-Tag-Eimer; Mehrfach-Tags dedupliziert auf den primären.</div>
-    <div class="nf">
-      <div class="nsp">
-        <div class="nyr">1914</div>
-        <div class="nnode"><span class="g">⚭</span><div class="lt">Heirat: Karl &amp; Elfriede</div><div class="lm">1914 · abgeleitet</div></div>
-        <div class="nwb"><div class="t">◍ Erster Weltkrieg</div><div class="s">1914–1918</div></div>
-        <div class="nbucket"><span class="chip krieg" style="margin:0"><i></i>Krieg</span><span style="font-size:8px;color:#8a8a86">6 ▾</span></div>
-
-        <div class="nyr">1915</div>
-        <div class="nnode"><span class="g">*</span><div class="lt">Geburt: Hans Raddatz</div><div class="lm">Sommer 1915 · abgeleitet</div></div>
-        <div class="nbucket"><span class="chip krieg" style="margin:0"><i></i>Krieg › Briefe von der Front</span><span style="font-size:8px;color:#8a8a86">24 ▾</span></div>
-        <div class="nbucket"><span class="chip weih" style="margin:0"><i></i>Weihnachten</span><span style="font-size:8px;color:#8a8a86">3 ▾</span></div>
-        <div class="nbucket"><span class="chip fam" style="margin:0"><i></i>Familie</span><span style="font-size:8px;color:#8a8a86">2 ▾</span></div>
-      </div>
-    </div>
-    <div class="note" style="margin-top:8px">Hinweis im UI: „Brief mit mehreren Tags erscheint unter seinem primären Tag."</div>
-  </div>
-
-</div>
-
-
-<!-- ══ 3 · ALL CASES PREVIEW ══ -->
-<div class="sh">
-  <h2>3 · Vollständige Vorschau — alle Dichte-Fälle</h2>
-  <p>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.</p>
-</div>
-
-<div class="callout navy" style="margin-bottom:18px">
-  <strong>Abgedeckte Fälle:</strong>
-  ① leere Jahre (gefaltete Lücke) ·
-  ② wenige Briefe ≤ 3 (einzelne Karten) ·
-  ③ hunderte Briefe (Jahres-Strip + Sparkline) ·
-  ④ kuratiertes Ereignis &amp; Welt-Band ·
-  ⑤ ungenaue Präzision (<code>Sommer</code>, <code>ca.</code>) ·
-  ⑥ undatierte Briefe (Ohne-Datum-Eimer).
-</div>
-
-<div class="tl-canvas">
-  <div class="dh">Zeitstrahl</div>
-  <div class="dh-sub">Die Familie Raddatz · 1899–1950 · 412 Briefe · 38 Ereignisse &nbsp;·&nbsp; <span style="color:#012851">Gruppierung: Datum</span></div>
-
-  <div style="text-align:center;margin-bottom:8px"><span class="casetag">① Leere Jahre → gefaltet</span></div>
-  <div class="axis">
-
-    <!-- ① empty years gap -->
-    <div class="gap"><span class="ln"></span><b>1899 – 1908</b> · keine Einträge<span class="ln"></span></div>
-
-    <!-- ② 3 letters -->
-    <div class="ybadge"><span>1909</span></div>
-    <div style="text-align:center;margin-bottom:4px"><span class="casetag">② Wenige Briefe → einzeln</span></div>
-    <div class="lrow"><div class="half a"><div class="lcard"><div class="t">✉ Brief aus Stettin</div><div class="m">Elfriede → Karl · Mai 1909</div><span class="chip fam"><i></i>Familie</span></div></div><div class="dot"></div><div class="half b"></div></div>
-    <div class="lrow"><div class="half a"></div><div class="dot"></div><div class="half b"><div class="lcard"><div class="t">✉ Geburtstagsgruß</div><div class="m">Karl → Hans · Sep 1909</div></div></div></div>
-    <div class="lrow"><div class="half a"><div class="lcard"><div class="t">✉ Brief zum Jahresende</div><div class="m">Karl → Elfriede · Dez 1909</div><span class="chip weih"><i></i>Weihnachten</span></div></div><div class="dot"></div><div class="half b"></div></div>
-
-    <!-- ④ life event + world band -->
-    <div class="ybadge"><span>1914</span></div>
-    <div class="pill"><span class="inner"><span class="gly">⚭</span><span class="tx"><span class="t">Heirat: Karl &amp; Elfriede Raddatz</span><span class="s">1914 · abgeleitet aus Beziehung</span></span></span></div>
-    <div style="text-align:center;margin-bottom:6px"><span class="casetag">④ Welt-Band (RANGE 1914–1918)</span></div>
-    <div class="wband"><span class="t">◍ Erster Weltkrieg</span><span class="s">1914–1918 · historisch · 187 Briefe in dieser Zeit</span></div>
-
-    <!-- ③ hundreds of letters strip -->
-    <div class="ybadge"><span>1915</span></div>
-    <div style="text-align:center;margin-bottom:6px"><span class="casetag">③ Hunderte Briefe → Jahres-Strip</span> &nbsp; <span class="casetag" style="background:#607080">⑤ „Sommer 1915"</span></div>
-    <div class="pill"><span class="inner"><span class="gly">*</span><span class="tx"><span class="t">Geburt: Hans Raddatz</span><span class="s">Sommer 1915 · abgeleitet · SEASON</span></span></span></div>
-    <div class="strip">
-      <div class="hd"><span class="ct">✉ 187 Briefe</span><span class="ex">Monats-Dichte · antippen → Monate → Briefe ▾</span></div>
-      <div class="spark"><div style="height:22%"></div><div style="height:30%"></div><div style="height:48%"></div><div style="height:66%"></div><div style="height:58%"></div><div style="height:80%"></div><div style="height:100%"></div><div style="height:92%"></div><div style="height:74%"></div><div style="height:50%"></div><div style="height:44%"></div><div style="height:34%"></div></div>
-      <div class="axl"><span>Jan 1915</span><span>Dez 1915</span></div>
-    </div>
-
-    <!-- empty-ish span with some letters collapsed -->
-    <div class="gap"><span class="ln"></span><b>1916 – 1922</b> · Nachkriegsjahre · 96 Briefe<span class="ln"></span></div>
-
-    <!-- ⑤ approx precision world band -->
-    <div style="text-align:center;margin-bottom:6px"><span class="casetag" style="background:#607080">⑤ „ca. 1923" → APPROX</span></div>
-    <div class="wband"><span class="t">◍ Hyperinflation</span><span class="s">ca. 1923 · historisch</span></div>
-
-    <!-- curated personal event -->
-    <div class="ybadge"><span>1924</span></div>
-    <div class="pill curated"><span class="inner"><span class="gly">★</span><span class="tx"><span class="t">Auswanderung nach Argentinien</span><span class="s">Frühjahr 1924 · persönlich · kuratiert</span></span></span></div>
-
-    <!-- tail empty -->
-    <div class="gap"><span class="ln"></span><b>1925 – 1950</b> · keine Einträge<span class="ln"></span></div>
-  </div>
-
-  <!-- ⑥ undated bucket -->
-  <div style="text-align:center;margin:6px 0"><span class="casetag" style="background:#7a756c">⑥ Undatiert → eigener Eimer am Ende</span></div>
-  <div class="undated">
-    <div class="h">Ohne Datum · 11 Briefe</div>
-    <div style="display:flex;align-items:center;gap:8px;padding:4px 0;border-top:1px solid #f0eee8"><span style="width:5px;height:5px;border-radius:50%;background:#c4c0ba;flex-shrink:0"></span><span style="font-size:9.5px;color:#3a3a36;flex:1">Brief ohne Jahresangabe</span><span style="font-size:8px;color:#aaa">Präzision UNKNOWN</span></div>
-    <div style="display:flex;align-items:center;gap:8px;padding:4px 0"><span style="width:5px;height:5px;border-radius:50%;background:#c4c0ba;flex-shrink:0"></span><span style="font-size:9.5px;color:#3a3a36;flex:1">Fragment, Absender unklar</span><span style="font-size:8px;color:#aaa">+ 9 weitere ▾</span></div>
-  </div>
-</div>
-<div class="note">Kein erfundenes Datum: undatierte Briefe wandern nie spekulativ in ein Jahr, sondern bleiben sichtbar im Eimer. <code>RANGE</code>-Einträge (Krieg) erscheinen einmal im Start-Jahr mit Spannen-Marker, nicht in jedem überspannten Jahr.</div>
-
-
-<!-- ══ 4 · PRECISION ══ -->
-<div class="sh"><h2>4 · Datums-Präzision (geteilt von Ereignissen &amp; Briefen)</h2><p>Eine Render-Logik für alle datierten Einträge — <code>dateLabel.ts</code>, gespeist von <code>DatePrecision</code>.</p></div>
-<div class="rules">
-  <table>
-    <tr><th>DatePrecision</th><th>Darstellung</th><th>Beispiel</th><th>Wirkung auf der Achse</th></tr>
-    <tr><td>DAY</td><td>vollständiges Datum</td><td class="ex">28. Juli 1914</td><td>exakte Sortierung im Jahres-Band</td></tr>
-    <tr><td>MONTH</td><td>Monat + Jahr</td><td class="ex">Juli 1914</td><td>Monats-Sortierung</td></tr>
-    <tr><td>SEASON</td><td>Jahreszeit + Jahr</td><td class="ex">Sommer 1914</td><td>grobe Reihung</td></tr>
-    <tr><td>YEAR</td><td>nur Jahr</td><td class="ex">1914</td><td>ans Band-Ende</td></tr>
-    <tr><td>APPROX</td><td>„ca." + Jahr</td><td class="ex">ca. 1914</td><td>mit „ca."-Marker</td></tr>
-    <tr><td>RANGE</td><td>Start–Ende</td><td class="ex">1914–1918</td><td>Start-Jahr, Spannen-Marker, nicht dupliziert</td></tr>
-    <tr><td>UNKNOWN</td><td>undatiert</td><td class="ex">Ohne Datum</td><td>eigener Eimer am Ende</td></tr>
-  </table>
-</div>
-
-
-<!-- ══ 5 · RESPONSIVE ══ -->
-<div class="sh"><h2>5 · Responsiv — eine Komponente, drei Breiten</h2><p>Identisches Markup &amp; identische Daten. Nur die Achs-Position wechselt per Container-Query.</p></div>
-<div class="legend" style="grid-template-columns:repeat(3,1fr)">
-  <div class="lg"><div class="ico" style="background:#012851;color:#a1dcd8;font-size:10px">▏</div><div><div class="ttl">≥ 1024px · Desktop</div><div class="body"><b>Zentrale Achse</b>, Briefe alternierend links/rechts, Welt-Bänder über volle Breite. Pillen unterbrechen die Linie.</div></div></div>
-  <div class="lg"><div class="ico" style="background:#012851;color:#a1dcd8;font-size:10px">▎</div><div><div class="ttl">&lt; 1024px · Phone</div><div class="body"><b>Linke Achse</b>, alles einseitig rechts. DOM-Reihenfolge bleibt streng chronologisch (<code>&lt;ol&gt;</code>) — Screenreader liest linear.</div></div></div>
-  <div class="lg"><div class="ico" style="background:#012851;color:#a1dcd8;font-size:10px">▎</div><div><div class="ttl">Lebensweg-Rail · 35%</div><div class="body">Gleiche linke Achse in der Personenseite (<code>&lt;TimelineView personId&gt;</code>), gefiltert auf eine Person. Rail-Tauglichkeit = Stärke von A.</div></div></div>
-</div>
-
-
-<!-- ══ 6 · TOKENS ══ -->
-<div class="sh"><h2>6 · Design-Tokens (echte, ausgelieferte Werte)</h2><p>Aus <code>frontend/src/routes/layout.css</code>. Keine Hardcodes in der Komponente.</p></div>
-<div class="impl-ref">
-  <table>
-    <tr><th>Rolle</th><th>Token</th><th>Wert</th><th>Einsatz</th></tr>
-    <tr><td>Achse / Knoten / Header</td><td><code>brand-navy</code></td><td><span class="sw" style="background:#012851"></span>#012851</td><td>Spine, Lebensereignis-Pillen, Jahres-Badges, Titel</td></tr>
-    <tr><td>Akzent / Brief-Punkt</td><td><code>brand-mint</code></td><td><span class="sw" style="background:#a1dcd8"></span>#a1dcd8</td><td>Brief-Punkte, kuratierte Pillen-Ränder, Sparkline, Dark-Mode-Auswahl</td></tr>
-    <tr><td>Historisch / Welt</td><td><code>tag-slate</code></td><td><span class="sw" style="background:#607080"></span>#607080</td><td>Welt-Bänder &amp; Glyphe ◍ — gedämpft</td></tr>
-    <tr><td>Tag-Chip-Farben</td><td><code>--c-tag-*</code> (Wurzel)</td><td><span class="sw" style="background:#5a8a6a"></span><span class="sw" style="background:#a0522d"></span><span class="sw" style="background:#c17a00"></span><span class="sw" style="background:#7a4f9a"></span></td><td>sage · sienna · amber · violet — Farbe vom Wurzel-Tag, Punkt + Label</td></tr>
-    <tr><td>Seite / Karte / Linie</td><td><code>canvas · surface · line</code></td><td><span class="sw" style="background:#f0efe9"></span><span class="sw" style="background:#fff"></span><span class="sw" style="background:#e4e2d7"></span></td><td>#f0efe9 · #ffffff · #e4e2d7</td></tr>
-    <tr><td>Text sekundär</td><td><code>text-ink-3</code></td><td><span class="sw" style="background:#6b7280"></span>#6b7280</td><td>Meta-Zeilen (4,8:1 auf weiß — AA ✓)</td></tr>
-    <tr><td>Schrift</td><td><code>font-serif · font-sans</code></td><td>Tinos · Montserrat</td><td>Namen/Titel serif · Labels/Chrome sans</td></tr>
-    <tr><td>Lebensdaten-Glyphen</td><td><code>personLifeDates.ts</code></td><td>* † ⚭</td><td>Geburt · Tod · Heirat — konsistent mit Personenkarten</td></tr>
-  </table>
-</div>
-
-
-<!-- ══ 7 · IMPL-REF ══ -->
-<div class="sh"><h2>7 · Implementierungs-Referenz &amp; Barrierefreiheit</h2><p>Domain-Ordner <code>frontend/src/lib/timeline/</code>; Route <code>/zeitstrahl</code>; Backend <code>GET /api/timeline</code>.</p></div>
-<div class="impl-ref">
-  <table>
-    <tr><th>Baustein</th><th>Komponente / Datei</th><th>Verantwortung</th></tr>
-    <tr><td>Orchestrator</td><td><code>TimelineView.svelte</code></td><td>Lädt <code>/api/timeline</code>; optionaler <code>personId</code> für globalen vs. Lebensweg-Modus; hält den Gruppierungs-Modus</td></tr>
-    <tr><td>Jahres-Band</td><td><code>YearBand.svelte</code></td><td>Jahres-Badge + Einträge; Lücken-Faltung ruhiger Spannen</td></tr>
-    <tr><td>Ereignis-Pille</td><td><code>EventCard.svelte</code></td><td>PERSONAL / HISTORICAL / abgeleitet; zentrierte Pille bzw. Welt-Band; präzisions-bewusstes Label</td></tr>
-    <tr><td>Brief-Karte</td><td><code>LetterCard.svelte</code></td><td>Einzel-Brief, alternierende Seite, Wurzel-Tag-Chip, Link <code>/documents/[id]</code></td></tr>
-    <tr><td>Jahres-Strip</td><td><code>YearLetterStrip.svelte</code></td><td>Adaptive Verdichtung ab Schwellwert; 12-Monats-Sparkline aus <code>MonthBucket</code> / <code>aggregateToYears</code> (<code>lib/document/timeline.ts</code>)</td></tr>
-    <tr><td>Datums-Helfer</td><td><code>dateLabel.ts</code></td><td><code>DatePrecision</code> → deutsches Label; geteilt von Ereignissen &amp; Briefen</td></tr>
-    <tr><td>Kurator-Editor</td><td><code>/zeitstrahl/events/new · [id]/edit</code></td><td>Ereignis anlegen/bearbeiten; Personen- + Dokument-Mehrfach-Picker (Bulk-Linking); <code>WRITE_ALL</code></td></tr>
-    <tr><td>Quick-Add</td><td><code>DocumentTimelineEventPicker.svelte</code></td><td>Auf <code>/documents/[id]</code>: Ereignis wählen/neu anlegen; verlinkt einen Brief</td></tr>
-    <tr><td>Daten-API</td><td><code>GET /api/timeline</code></td><td>Verschmilzt kuratierte + abgeleitete Ereignisse + Briefe in <code>TimelineDTO</code> (Jahres-Eimer + Ohne-Datum); Filter <code>personId · type · fromYear · toYear</code></td></tr>
-    <tr><td>Barrierefreiheit</td><td>—</td><td>Achse = <code>&lt;ol&gt;</code>, chronologische DOM-Reihenfolge; ◍ ✉ * nie nur Farbe — Glyphe + Label; 44px-Tap-Ziele; <code>prefers-reduced-motion</code>; axe in Light &amp; Dark</td></tr>
-  </table>
-</div>
-
-</div>
-</body>
-</html>
--- a/docs/specs/zeitstrahl-global-concepts.html
+++ b/docs/specs/zeitstrahl-global-concepts.html
--- a/docs/superpowers/specs/2026-06-07-family-timeline-design.md
+++ b/docs/superpowers/specs/2026-06-07-family-timeline-design.md
@@ -1,182 +0,0 @@
-# Family Timeline (Zeitstrahl) — Design Spec
-
-**Date:** 2026-06-07
-**Status:** Approved — pending implementation plan
-
-## Problem
-
-The archive can capture, transcribe, organize, and browse letters, but the transcribed material does not yet add up to a *story in time*. Readers (younger, phone-first) have no way to feel the family's history unfold; transcribers don't see their work become something larger. A previous attempt to derive meaning automatically (LLM search) was slow and low-quality, so the family is wary of auto-extraction from handwriting.
-
-## Goal
-
-A **hand-curated, year-banded vertical timeline** — the "Zeitstrahl" — that weaves three layers into one chronological view:
-
-1. **Person life-events** derived from already-curated structured data (`Person` birth/death dates, marriage years from `PersonRelationship.fromYear`). Trusted, free, no extra entry. (Requires the Person birth/death fields to move from year-integers to date + precision — see foundational issue 1.)
-2. **Hand-curated events** the family writes — both **personal** (a move, an illness, emigration) and **historical** (a war, hyperinflation). Editorially controlled, always correct.
-3. **Letters**, auto-placed by their existing `documentDate`, optionally hand-linked to an event to cluster them.
-
-Two surfaces, one component:
- **Global timeline** at `/zeitstrahl`.
- **Per-person "Lebensweg"** — the same view filtered to one person, embedded on the Person detail page.
-
-Built for phones (vertical scroll), honest about date precision, with no fabricated dates.
-
-### Non-goals (YAGNI)
-
- ❌ Auto-extracting events from transcription text — explicitly avoided; this is what makes the feature trustworthy.
- ❌ Importing an external historical-events dataset — historical events are hand-entered too.
- ❌ A map / geographic view — that is a separate future feature (B2).
- ❌ Per-derived-event hide/override toggle — deferred refinement; MVP shows all derived events.
- ❌ Day-resolution timeline axis — the axis is the **year**; finer dates only affect within-band ordering and label text.
-
-## Core principle: the year is the axis
-
-Most dates in the archive are year-only (birth/death/marriage years are years by nature; many letters carry `YEAR`/`APPROX` precision). Therefore:
-
- The timeline spine is a **sequence of year bands**. Everything for a given year lives in that band.
- **Finer ordering only when we have it.** A `DAY`-precision letter (`1923-04-12`) sorts above a `YEAR`-precision one (`1923`) *within* the 1923 band; we never invent a day we don't have.
- **An "Ohne Datum" bucket** at the end holds items with `UNKNOWN` precision.
- **Honest precision rendering** reuses the existing `DatePrecision` enum for every dated item (events and letters share one rendering path).
-
-### Date rendering (shared by events and letters)
-
-| `DatePrecision` | German render | Example |
-|---|---|---|
-| `DAY` | full date | `28. Juli 1914` |
-| `MONTH` | month + year | `Juli 1914` |
-| `SEASON` | season + year | `Sommer 1914` |
-| `YEAR` | year only | `1914` |
-| `APPROX` | "ca." + year | `ca. 1914` |
-| `RANGE` | start–end year | `1914–1918` |
-| `UNKNOWN` | undated bucket | `Ohne Datum` |
-
-A `RANGE` item is shown in its **start year's band** with a span marker; it is not duplicated across every year it covers.
-
-## Data model
-
-A new `timeline/` domain package on the backend (kept deliberately separate from the in-flight Lesereisen/`Geschichte` work in #750–753).
-
-### `TimelineEvent` entity
-
-Mirrors the `Document` date model for consistency, so events and letters use one date-handling code path.
-
-| Field | Type | Notes |
-|---|---|---|
-| `id` | `UUID` | `@GeneratedValue(UUID)` |
-| `title` | `String` | required |
-| `type` | `EventType` enum | `PERSONAL`, `HISTORICAL` |
-| `eventDate` | `LocalDate` | required — most precise date known (WW1 → `1914-07-28`; vague year → `1920-01-01`) |
-| `precision` | `DatePrecision` | reuse existing enum; default `YEAR` — governs rendering & whether the day matters |
-| `eventDateEnd` | `LocalDate` (nullable) | only set when `precision == RANGE` |
-| `description` | `TEXT` (nullable) | free-text narrative for the event |
-| `persons` | ManyToMany `Person` | who the event involves; drives the per-person view & filtering |
-| `documents` | ManyToMany `Document` | optional hand-linked supporting letters (the "cluster letters to an event" feature) |
-| `createdBy` / `createdAt` / `updatedBy` / `updatedAt` / `version` | audit | standard entity conventions |
-
- `@Schema(requiredMode = REQUIRED)` on every always-populated field (`id`, `title`, `type`, `eventDate`, `precision`).
- Collections use `@Builder.Default new HashSet<>()`.
- New Flyway migration adds `timeline_events`, `timeline_event_persons`, `timeline_event_documents` join tables.
-
-### `EventType` enum
-
-`PERSONAL` | `HISTORICAL`. Personal events render with a person/family accent; historical events with a "world" accent and muted styling so the two layers are visually separable.
-
-### Prerequisite: migrate `Person` birth/death to date + precision
-
-Today `Person` stores `birthYear`/`deathYear` as `Integer`, so a known exact birthday (e.g. `1901-03-14`) has nowhere to live and derived events are stuck at year precision. This is fixed by a **foundational Person-domain migration** that the timeline depends on (and which delivers value on its own — precise dates then render on person cards, hover cards, and the Stammbaum).
-
-**Change:** replace `birthYear`/`deathYear` (`Integer`) with:
-
-| Field | Type | Notes |
-|---|---|---|
-| `birthDate` | `LocalDate` (nullable) | most precise date known |
-| `birthDatePrecision` | `DatePrecision` (nullable) | `YEAR` for year-only, `DAY` for exact birthdays, etc. |
-| `deathDate` | `LocalDate` (nullable) | |
-| `deathDatePrecision` | `DatePrecision` (nullable) | |
-
-**Flyway data migration:** existing `birth_year` → `birth_date = '{year}-01-01'`, `birth_date_precision = 'YEAR'` (same for death); then drop the year columns.
-
-**Re-import preservation (ADR-025):** the canonical importer (`PersonRegisterImporter` / `tools/import-normalizer/persons_tree.py`) only carries the *year*. On re-import it must **not** clobber a hand-entered finer-than-`YEAR` date — if the existing precision is `DAY`/`MONTH`/`SEASON`, preserve it; only refresh from the spreadsheet year when the field is empty or still `YEAR`-from-import.
-
-**Bounding the blast radius:** `PersonNodeDTO` keeps exposing an `Integer birthYear`/`deathYear` *derived* from the new date (`birthDate.getYear()`), so the Stammbaum layout (`familyForest.ts` et al.) is untouched. Display surfaces (person card, hover card) move to a shared precision-aware formatter — extend the existing `frontend/src/lib/person/personLifeDates.ts`. The person edit/new forms gain date inputs with a precision selector.
-
-**Scope note:** `PersonRelationship.fromYear` (marriage year) stays `Integer`/`YEAR` for MVP — precise marriage dates are a later, parallel extension if wanted.
-
-### Derived person-events (not persisted)
-
-Assembled on read from the migrated `Person` data; never stored:
-
-| Source | Derived event | `eventDate` | precision |
-|---|---|---|---|
-| `Person.birthDate` | *Geburt: {name}* | `Person.birthDate` | `Person.birthDatePrecision` |
-| `Person.deathDate` | *Tod: {name}* | `Person.deathDate` | `Person.deathDatePrecision` |
-| `PersonRelationship` `SPOUSE_OF.fromYear` | *Heirat: {A} & {B}* | `{fromYear}-01-01` | `YEAR` |
-
-Emitted in the same DTO shape as a curated event, flagged `derived: true`, `type = PERSONAL`. They cannot be edited from the timeline (they are edited at their source: Person record / relationship). A marriage is derived once per `SPOUSE_OF` edge (symmetric edges are stored once — see existing relationship rules).
-
-### Letters
-
-Placed by `Document.documentDate`:
- Band = `documentDate.getYear()`; `UNKNOWN` precision → "Ohne Datum" bucket.
- Sub-ordered within a band by full date when precision allows.
- A letter may also appear under an event it's linked to (via `TimelineEvent.documents`) as a cluster, in addition to its own band placement.
-
-## Assembly & API
-
-A `TimelineService` merges the three layers into a year-bucketed DTO for the requested scope and filters. Layering rules apply: the service owns `TimelineEventRepository` and reaches Person/Document/Relationship data through their **services**, never their repositories.
-
-### DTOs
-
- `TimelineEntryDTO` — one renderable item: `kind` (`EVENT` | `LETTER`), `eventDate`, `precision`, `eventDateEnd`, `title`, `type` (for events), `derived` flag, plus the source id (eventId / documentId) and minimal display fields (sender/receiver names for letters, linked person ids for events).
- `TimelineYearDTO` — `{ year: int, entries: TimelineEntryDTO[] }`.
- `TimelineDTO` — `{ years: TimelineYearDTO[], undated: TimelineEntryDTO[] }`.
-
-### Endpoints
-
- `GET /api/timeline` — global timeline. Query params (all optional): `personId`, `generation`, `type` (`PERSONAL`/`HISTORICAL`), `fromYear`, `toYear`. The per-person "Lebensweg" is just `GET /api/timeline?personId=…` — no separate endpoint. Requires `READ_ALL`.
- `POST /api/timeline/events` — create a curated event. `@RequirePermission(Permission.WRITE_ALL)`.
- `PUT /api/timeline/events/{id}` — update. `@RequirePermission(Permission.WRITE_ALL)`.
- `DELETE /api/timeline/events/{id}` — delete. `@RequirePermission(Permission.WRITE_ALL)`.
- `GET /api/timeline/events/{id}` — fetch a single event for the edit form. Requires `READ_ALL`.
-
-Input DTO `TimelineEventRequest` lives flat in the `timeline/` package. Errors use `DomainException.notFound/...`; **no new `ErrorCode`** is required. Run `npm run generate:api` after backend model/endpoint changes.
-
-## Frontend
-
- New domain dir `frontend/src/lib/timeline/`:
-  - `TimelineView.svelte` — orchestrator; accepts an optional `personId` prop so the same component powers both global and per-person views.
-  - `YearBand.svelte` — one year section header + its entries.
-  - `EventCard.svelte` — renders a `PERSONAL`/`HISTORICAL`/derived event with precision-aware date label.
-  - `LetterCard.svelte` — compact letter row (sender → receiver, snippet/title, date), links to `/documents/[id]`.
-  - `TimelineFilters.svelte` — person, generation, layer toggles, year range.
-  - `dateLabel.ts` — the shared precision→label helper (reuse/extend `lib/document/timeline.ts` helpers like `formatTickLabel` where they fit).
- Routes:
-  - `/zeitstrahl` — global timeline (`+page.server.ts` loads `/api/timeline`).
-  - `/zeitstrahl/events/new` and `/zeitstrahl/events/[id]/edit` — curator forms, gated to `WRITE_ALL`, using the form-actions pattern.
- Person detail page gains a **Lebensweg** card section embedding `<TimelineView personId={person.id} />`.
- Styling per project conventions (card pattern, brand tokens, `font-serif` for names/titles, `BackButton`, mobile-first at 375px, dark-mode tokens).
- i18n keys added to `messages/{de,en,es}.json` (German primary).
-
-## Testing
-
- Backend: `TimelineService` assembly/merge/sort/precision-bucketing (unit + `@DataJpaTest` against Postgres via Testcontainers); controller permission gating; derived-event assembly (birth/death/marriage, symmetric marriage dedup).
- Frontend: `dateLabel.ts` precision rendering; `TimelineView` global vs `personId` modes (`*.svelte.spec.ts`); filter behavior.
- Follow project test discipline: targeted single-file runs locally only; full sweep left to CI.
-
-## Proposed issue breakdown (milestone "Zeitstrahl / Family Timeline")
-
-Ordered so each issue is independently shippable and reviewable; later issues depend on earlier ones. Issue 1 is a standalone Person-domain improvement and a hard prerequisite for the timeline's derived events.
-
-1. **Person birth/death → date + precision (foundational)** — replace `birthYear`/`deathYear` with `birthDate`/`deathDate` + precision on `Person`; Flyway data migration (year → `YYYY-01-01`, `YEAR`); update importer with re-import preservation rule; derive year in `PersonNodeDTO` (Stammbaum untouched); move person card / hover card to a precision-aware `personLifeDates.ts`; add date+precision inputs to person new/edit forms. Ships value on its own.
-2. **Backend: `TimelineEvent` entity + migration** — entity, `EventType`, Flyway migration + join tables, repository.
-3. **Backend: TimelineEvent CRUD API** — `TimelineEventController` + `TimelineService` write methods, `TimelineEventRequest` DTO, permission gating, `GET /events/{id}`.
-4. **Backend: derived person-events** — assemble Geburt/Tod/Heirat from migrated Person + relationship data via their services; unit-tested dedup.
-5. **Backend: timeline assembly endpoint** — `GET /api/timeline` merging events + derived events + letters into `TimelineDTO`; year-bucketing, precision sort, undated bucket, filters.
-6. **Frontend: shared date-label helper + types** — `dateLabel.ts`, regen API types.
-7. **Frontend: global `/zeitstrahl` view** — `TimelineView`, `YearBand`, `EventCard`, `LetterCard`, server load.
-8. **Frontend: filters** — `TimelineFilters` (person / generation / layer / year range).
-9. **Frontend: curator event forms** — `/zeitstrahl/events/new` + `/[id]/edit`, gated, with document & person pickers.
-10. **Frontend: per-person Lebensweg** — embed `<TimelineView personId>` on Person detail.
-11. **Polish & a11y** — mobile layout at 375px, dark mode, axe checks, i18n completeness (de/en/es).
-
-> An ADR may be warranted for the new `timeline/` domain + entity (per `docs/CLAUDE.md`, significant data-model change). Add as the next sequential ADR number when implementation starts.
Author	SHA1	Message	Date
Marcel	3d929c55c3	refactor(search): strip dead NL types from generated api.ts All checks were successful CI / Unit & Component Tests (pull_request) Successful in 3m26s Details CI / OCR Service Tests (pull_request) Successful in 23s Details CI / Backend Unit Tests (pull_request) Successful in 3m51s Details CI / fail2ban Regex (pull_request) Successful in 47s Details CI / Semgrep Security Scan (pull_request) Successful in 23s Details CI / Compose Bucket Idempotency (pull_request) Successful in 1m6s Details Remove the /api/search/nl path and the NlSearchRequest, NlQueryInterpretation, NlSearchResponse, PersonHint, and TagHint schemas left over from the NLP/smart-search removal. These were unused (nothing in frontend/src imported them); the manual strip matches what `npm run generate:api` produces against the now NL-free backend. Closes the last deferred review item on PR #772. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-08 10:56:32 +02:00
Marcel	acc73fd3e1	fix(review): resolve all review blockers and concerns - Delete frontend/e2e/nl-search.spec.ts (was left alive; would have crashed CI when Playwright couldn't find the deleted SmartModeToggle) - Fix docs/DEPLOYMENT.md: remove NLP service arrow + key-facts bullet that were accidentally added instead of removed in the prior commit - Clean docs/GLOSSARY.md: remove keyword→tag resolution, PersonHint, TagHint, theme chip entries; trim NameMatches to drop the NlQueryParserService reference - Remove @ConfigurationPropertiesScan from FamilienarchivApplication (all remaining @ConfigurationProperties beans carry @Component) - Remove 12 orphaned i18n keys from de/en/es message files (search_loading_nl, search_chip_, search_disambiguation_, etc.) - Fix SearchFilterBar.svelte input padding: pr-20 → pr-4 (SmartModeToggle that justified the right padding is gone) - Delete docs/superpowers/plans/2026-06-07-remove-nlp-search.md (scaffolding artefact; plan files belong in Gitea issues, not the repo) - Add docs/adr/034-remove-nl-search.md documenting the removal decision (supersedes deleted ADR-028 ×2, ADR-034-ollama, ADR-035) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-08 10:56:32 +02:00
Marcel	75c9dc4be9	docs(c4): remove NLP service from L2 container diagram; delete NL search L3 diagram	2026-06-08 10:56:32 +02:00
Marcel	5301b52e0f	docs: remove nlp-service and NL search references from DEPLOYMENT.md and GLOSSARY.md	2026-06-08 10:56:32 +02:00
Marcel	62eadcacd6	docs(claude): remove NLP search references from CLAUDE.md files	2026-06-08 10:56:32 +02:00
Marcel	3b54175945	refactor(search): delete nlp-service microservice and Ollama ADRs	2026-06-08 10:56:32 +02:00
Marcel	894e92327e	refactor(infra): remove Ollama/NLP observability config	2026-06-08 10:56:32 +02:00
Marcel	f226f31fee	refactor(infra): remove nlp-service from docker-compose files	2026-06-08 10:56:32 +02:00
Marcel	a8a5130b02	refactor(search): remove smart search i18n keys from all language files	2026-06-08 10:56:32 +02:00
Marcel	c139f2969e	refactor(search): remove smart search error codes from frontend	2026-06-08 10:56:32 +02:00
Marcel	1dd40721fe	refactor(search): remove NLP smart search from documents page Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-08 10:56:32 +02:00
Marcel	2bb1433822	refactor(search): remove smart mode from SearchFilterBar Removes SmartModeToggle component import and all smart-mode conditional logic from SearchFilterBar, including mode-specific input handling, max-length constraints, and CSS class toggling. Removes associated smart-mode tests that verified chip lifecycle callbacks (onModeToggle, onSmartSearch). Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-08 10:56:32 +02:00
Marcel	b790a6f823	refactor(search): delete frontend NLP search components and utilities Removes SmartModeToggle, SmartSearchStatus, InterpretationChipRow, DisambiguationPicker, chip-types utilities, and theme-chip-removal utilities as part of NLP feature removal. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-08 10:56:32 +02:00
Marcel	35642ce6c4	refactor(search): remove NLP error codes and application config Remove SMART_SEARCH_UNAVAILABLE and SMART_SEARCH_RATE_LIMITED error codes from ErrorCode enum; remove nlp and nl-search configuration blocks from application.yaml; remove nlp config block from application-dev.yaml. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-08 10:56:32 +02:00
Marcel	63926f440f	refactor(search): delete backend NLP search package Remove entire backend search domain including: - NlSearchController, NlQueryParserService, NlpClient implementations - Rate limiting, properties, DTOs (NlSearchRequest/Response/NlQueryInterpretation) - All domain logic and tests (5 test files deleted) Backend compiles successfully post-deletion. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-08 10:56:32 +02:00
Marcel	e485626471	fix(infra): replace Ollama with nlp-service in docker-compose.prod.yml Removes the ollama and ollama-model-init services (and ollama-models volume) from the production/staging compose file. Adds the nlp-service in their place — mirroring the dev compose — and wires the backend dependency and APP_NLP_BASE_URL env var so staging can reach the new service. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-08 10:56:32 +02:00
Marcel	345b3eca87	fix(search): replace languageTag() with getLocale(); sync KI→Smart in tests Paraglide 2.5 runtime exports getLocale(), not languageTag(). The `8bed0cc6` commit introduced the wrong import when threading lang through the NL search path. Also updates two test assertions that still expected the old 'KI' button label after `0b31a51e` renamed it to 'Smart-Suche'. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-08 10:56:32 +02:00
Marcel	53fdc8e3f9	refactor(search): delete orphaned RestClientOllamaClientTest The source class RestClientOllamaClient was removed in `864f44a4` but the corresponding test file was not staged at the time. Removes the leftover file; coverage is provided by RestClientNlpClientTest. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-08 10:56:32 +02:00
Marcel	884c1156bd	docs(deployment): replace Ollama with nlp-service in DEPLOYMENT.md - §1: update memory table (nlp-service ~256 MB vs Ollama ~8 GB); update memory budget note; add nlp-service to topology diagram - §2: replace 'Ollama (NL search) service' env var table with 'NLP service' table (APP_NLP_BASE_URL, NLP_FUZZY_THRESHOLD); add credential-rotation restart note - §3.4: replace Ollama model-pull first-deploy warning with nlp-service startup note (no download, --wait safe) - §6: replace Ollama operational section (model pull, ollama list, upgrade guide) with nlp-service health check and tuning guide Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-08 10:56:32 +02:00
Marcel	960f1c171a	docs(nlp-service): update CLAUDE.md — remove stale dateparser entry and prototype note Removes 'dateparser 1.2' from the stack section (dependency was dropped in favour of the rule-based date regex pipeline). Rewrites the Notes section to reflect that docker-compose integration and Java-side wiring were both delivered in this PR. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-08 10:56:32 +02:00
Marcel	644b7c2683	fix(infra): wait for nlp-service healthy before starting backend Changes condition: service_started → service_healthy so the backend container does not start until FastAPI has bound its port and loaded person names from the database. Eliminates the startup race where a first NL search would return 503 during nlp-service bootstrap. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-08 10:56:32 +02:00
Marcel	3d2b907fb4	docs(adr): ADR-035 — replace Ollama with rule-based nlp-service Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-08 10:56:32 +02:00
Marcel	cc7132d11d	docs(c4): replace Ollama with nlp-service in L2 container diagram Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-08 10:56:32 +02:00
Marcel	34ff3dbdfd	feat(infra): replace Ollama with nlp-service in docker-compose Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-08 10:56:32 +02:00
Marcel	ab10daf325	chore(i18n): remove AI/KI/IA and timing refs from smart search strings Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-08 10:56:32 +02:00
Marcel	4a23dfff8e	test(search): assert lang field sent in E2E NL search request Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-08 10:56:32 +02:00
Marcel	08c11e567c	feat(search): raise NL search rate limit from 5 to 20 req/min The rule-based NLP service is <100ms vs Ollama's ~15s, making the old limit too restrictive for normal interactive use. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-08 10:56:32 +02:00
Marcel	503ed6adef	test(search): replace OllamaClient test suite with NlpClient equivalents - Delete RestClientOllamaClientTest, add RestClientNlpClientTest: WireMock targets POST /parse; adds isHealthy_returnsFalse_whenPersonsLoadedIsZero - NlQueryParserServiceTest: @Mock NlpClient; all stubs updated to parse(String,String); NlpExtraction throughout; service.search(..., "de", PAGE); adds verify(nlpClient).parse(eq,eq) - NlSearchControllerTest: add lang:"de" to all request bodies; stubs use anyString×3; rename search_returns503_whenOllamaUnavailable → search_returns503_whenNlpServiceUnavailable Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-08 10:56:32 +02:00
Marcel	28201e363a	refactor(search): delete Ollama* classes replaced by Nlp* equivalents Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-08 10:56:32 +02:00
Marcel	9f78f25b0a	feat(search): thread lang through NlSearchRequest → controller → NlQueryParserService → NlpClient - NlSearchRequest gains @NotBlank @Pattern(regexp="de\|en\|es") lang field - NlSearchController passes request.lang() to service - NlQueryParserService.search signature: (String, String, Pageable); renames ollamaClient→nlpClient; removes redundant length guard (Bean Validation is enforcement point) - application.yaml: replaces app.ollama.* with app.nlp.base-url; application-dev.yaml: points to localhost:8001 - frontend/documents/+page.svelte: sends lang: languageTag() in POST body Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-08 10:56:32 +02:00
Marcel	1fcadfcd8f	feat(search): add RestClientNlpClient — POST /parse, GET /health with persons_loaded check Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-08 10:56:32 +02:00
Marcel	381bd1d943	test(search): NlpPropertiesTest — validates baseUrl required and defaults Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-08 10:56:32 +02:00
Marcel	c8543726ec	feat(search): add NlpProperties config and @ConfigurationPropertiesScan Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-08 10:56:32 +02:00
Marcel	4cbe1dc2d3	feat(search): add NlpExtraction record, NlpClient and NlpHealthClient interfaces Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-08 10:56:32 +02:00
Marcel	324a76d6d2	test(nlp-service): guard global matcher state in try/finally Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-08 10:56:32 +02:00
Marcel	f4e8632e0d	chore(nlp-service): add .dockerignore to exclude dev artifacts from image Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-08 10:56:32 +02:00
Marcel	829194f345	chore(nlp-service): remove unused dateparser dependency Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-08 10:56:32 +02:00
Marcel	98ee6cf587	feat(nlp-service): wire NLP_FUZZY_THRESHOLD env var with 0-100 validation Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-08 10:56:32 +02:00
Marcel	778382cd61	feat(nlp-service): cap /parse query at 500 chars via Field(max_length=500) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-08 10:56:32 +02:00
Marcel	8d4f30019b	feat(nlp-service): log WARNING when DATABASE_URL absent, ERROR on DB failure Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-08 10:56:32 +02:00
Marcel	d65879d273	fix(nlp-service): return generic 500 detail to prevent credential leakage Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-08 10:56:32 +02:00
Marcel	bda7855cad	fix(nlp-service): eliminate false-positive person matches from dirty DB records - Wire _EXTRA_SPAN_STOPS into _extract_persons_and_role so German function words (im, seine, ihre, dem, …) terminate name spans — fixes "Clara im" and "seine Kinder" leaking into personNames - Add _NON_NAME_TOKENS filter in PersonMatcher.load() to skip DB records whose first_name contains prepositions or possessives — filters 290 bad records (annotations like "an seine Eltern", "Eltern in", place references like "Enkel Cram aus Mexiko") that were causing exact Pass-2 matches - Remove spaCy model downloads from Dockerfile (no longer needed after the DB-backed matcher rewrite) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-08 10:56:32 +02:00
Marcel	03d7d44e57	feat(nlp-service): replace spaCy NER with DB-backed PersonMatcher Rule-based pipeline: persons matched via rapidfuzz against all known names loaded from DB at startup. Fixes first-name-only extraction (Eugenie, Herbert), merged-span bug (Herbert + Eugenie de Gruyter), false positives on compound nouns, and EN/ES model failures. Date extraction unchanged (regex). No spaCy models required. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-08 10:56:32 +02:00
Marcel	aa200bf3c5	feat(nlp-service): Dockerfile — python:3.11-slim, models baked in	2026-06-08 10:56:32 +02:00
Marcel	7404284130	feat(nlp-service): FastAPI app with /parse and /health endpoints Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-08 10:56:32 +02:00
Marcel	3ddb2b278b	feat(nlp-service): full extract() pipeline — assembles all steps Also adds regex year-fallback in extract_dates() for de/es spaCy small models that don't tag bare 4-digit years as DATE entities, and widens the direction-token window to 2 tokens back to handle Spanish "antes de". Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-08 10:56:32 +02:00
Marcel	702a72d575	feat(nlp-service): keyword extraction (POS-filtered, deduped lemmas)	2026-06-08 10:56:32 +02:00
Marcel	3f74deda8c	feat(nlp-service): date range extraction with direction detection	2026-06-08 10:56:32 +02:00
Marcel	8ed2a6d95b	feat(nlp-service): role detection (sender/receiver/any)	2026-06-08 10:56:32 +02:00
Marcel	deea34c797	feat(nlp-service): NER person name extraction	2026-06-08 10:56:32 +02:00
Marcel	482a1c2863	feat(nlp-service): spaCy model loading with get_nlp/load_all_models	2026-06-08 10:56:32 +02:00