Phase 8: Lokale KI

Wiki mit semantischer Suche ueber pgvector, Diktat ueber faster-whisper,
Berichtsassistent und Belegerfassung — alles gegen selbst betriebene
Modelle. Dazu zwei Protokollansichten: was die Maschine getan hat und was
Menschen getan haben.

Nichts, was ein Modell erzeugt, gelangt ungeprueft in einen Nachweis. Jede
Ausgabe ist zuerst ein eigener Datensatz, gekennzeichnet, mit zwei gleich
grossen Knoepfen davor. Die Datenbank haelt gegen: Eingabe, Ausgabe und
Modell sind unveraenderlich, geloescht wird nicht, entschieden wird einmal.

Kein Rueckfall auf einen Anbieter: fehlen die Container, fehlt die Funktion.
Dafuer bleibt alles andere ohne Modell vollstaendig benutzbar — geprueft von
vierzehn E2E-Tests, die ohne laufendes Modell durchlaufen.

Postgres bringt jetzt PostGIS und pgvector mit (eigenes Image), Ollama und
faster-whisper stehen im Compose-Profil "ki".

73 neue Unit-Tests, 14 neue E2E-Tests, Version 0.9.0.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

docs/DEVLOG.md

@@ -19,7 +19,120 @@ Die aufgewendete Zeit wandert nach jedem Abschnitt in die Spalte
 | Phase 5 — Atemschutz nach FwDV 7 | 2:40 h | 1 | 03.09.2026 |
 | Phase 6 — Kartenmodule | 2:50 h | 1 | 04.09.2026 |
 | Phase 7 — Benachrichtigungen und Termine | 3:10 h | 1 | 04.09.2026 |
-| **Summe** | **19:20 h** | **9** | |
+| Phase 8 — Lokale KI | 3:40 h | 1 | 04.09.2026 |
+| **Summe** | **23:00 h** | **10** | |
+
+---
+
+## 2026-09-04 · Phase 8 — Lokale KI
+
+**07:30 – 11:10 · 3:40 h · Version 0.9.0**
+
+### Was entstanden ist
+
+Ein Wiki, das man befragen kann, ein Diktat, ein Berichtsassistent, eine
+Belegerfassung — und zwei Protokolle, die belegen, was davon eine Maschine
+getan hat.
+
+| Bereich | Dateien |
+|---|---|
+| Rechnen | `lib/ki/zerlegen.ts`, `beleg-lesen.ts`, `anweisungen.ts`, `wiki.ts`, `vorgang.ts` |
+| Kanäle | `lib/integrations/llm.ts` (um Einbettungen und Bilder erweitert), `whisper.ts` |
+| Server | `server/routers/ki/wiki.ts`, `assistent.ts` |
+| Oberfläche | `app/(app)/wiki/`, `belege/`, `ki-protokoll/`, `protokoll/`; `components/ki/` |
+| Hintergrund | `worker/ki.ts`, zwei neue Auftragsarten |
+| Betrieb | `docker/postgres/Dockerfile` (PostGIS **und** pgvector), Ollama und faster-whisper im Profil `ki` |
+| Tests | 73 Unit, 14 E2E je Browser |
+
+### Entscheidungen
+
+**Nichts Maschinelles gelangt ungeprüft in einen Nachweis.** Das ist die Regel
+aus Phase-8.md, und sie bestimmt den ganzen Aufbau: jede KI-Ausgabe ist zuerst
+ein eigener Datensatz und nicht ein Feld im Zieldokument. Es gibt keine
+Funktion, die eine Ausgabe erzeugt und gleich übernimmt — wer das umgehen will,
+muss Code schreiben, und das fällt in einer Durchsicht auf.
+
+Die Datenbank hält gegen: Eingabe, Ausgabe, Modell und Art sind nach dem
+Anlegen unveränderlich, gelöscht wird nicht, und über einen Vorschlag wird
+genau einmal entschieden. Eine Absicht im Code ist eine Absicht; ein Trigger
+ist eine Zusicherung.
+
+**Kein Rückfall auf einen Anbieter.** Fehlt der eigene Endpunkt, fehlt die
+Funktion. Ein Einsatzbericht spricht über Menschen in ihrer schlechtesten
+Stunde — solche Texte gehören nirgendwo anders hin als ins Gerätehaus. Und ein
+Rückfall, der „nur im Notfall" greift, ist genau der Fall, in dem niemand
+hinsieht.
+
+**Ohne Modell bleibt alles andere benutzbar.** Das war der größte Einzelposten
+der Phase und steht in keiner Aufwandsschätzung. Vier Hinweise an vier Stellen,
+eine zweite Suche, die immer funktioniert, und vierzehn E2E-Tests, die genau
+diesen Zustand absichern — der Testlauf hat keinen Ollama daneben, und das ist
+Absicht.
+
+**Drei Modelle statt einem.** Text, Einbettungen und Bilder sind einzeln
+konfigurierbar, weil ein Rechner ohne Grafikkarte das Einbettungsmodell noch
+flott schafft, das Textmodell zäh und das Vision-Modell praktisch nicht. Eine
+Wehr kann so ihr Wiki durchsuchbar machen, ohne Berichte schreiben zu lassen.
+
+**Zerlegt wird an den Überschriften, nicht nach Zeichenzahl.** Weil die
+Fundstelle später unter der Antwort steht, und eine Fundstelle soll ein Kapitel
+sein. Dazu kommt die Überschriftenkette in den Einbettungstext: ein Abschnitt
+über „Rückzugsdruck" ohne das Wort „Atemschutz" darüber findet sich sonst
+nicht, wenn jemand nach Atemschutz fragt.
+
+**Markdown wird ohne HTML gerendert.** Der Text kommt von Anwendern. Jeder Weg
+über `dangerouslySetInnerHTML` wäre ein Weg für ein `<script>` in einer
+Dienstvorschrift; der Renderer baut React-Elemente, und ein spitzes
+Klammernpaar bleibt ein spitzes Klammernpaar.
+
+**HNSW statt IVFFlat.** IVFFlat muss auf einem gefüllten Bestand trainiert
+werden und liefert auf einer frisch angelegten Tabelle schlechte Treffer. Ein
+Wiki wächst Seite für Seite — es gibt nie den Moment, an dem man den Index
+einmal aufbaut.
+
+**Ein eigenes Postgres-Image.** pgvector und PostGIS gibt es nicht zusammen.
+Die Alternative wäre gewesen, den Kosinusabstand in TypeScript zu rechnen: geht
+bei zweihundert Wiki-Seiten, wird bei zweitausend zäh, und verlegt eine Aufgabe
+in die Anwendung, für die die Datenbank einen Index hat.
+
+**Die Audit-Log-Ansicht kam mit dazu.** Sie stand seit Phase 0 als ausgegrauter
+Eintrag in der Navigation, markiert mit „ab Phase 8". Mit dem KI-Protokoll
+daneben wäre es schief geworden: die Wehr könnte nachlesen, was die Maschine
+getan hat, aber nicht, was Menschen getan haben. Der Router dafür existierte
+seit Phase 0 — es fehlte nur die Seite.
+
+### Wo es gehakt hat
+
+| Problem | Ursache | Lösung |
+|---|---|---|
+| Ein kurzer Abschnitt wurde unter eine fremde Überschrift gehängt | Die Regel „zu kurz → an den vorherigen anhängen" kannte keine Kapitelgrenze. Unter einer Antwort hätte dann eine Fundstelle gestanden, in der der zitierte Satz gar nicht vorkommt | Zusammengezogen wird nur innerhalb desselben Überschriftenpfads. Gefunden hat es der Test, nicht das Ausprobieren |
+| `prisma migrate dev` wollte die Datenbank zurücksetzen | Die zurückgerollte Migration aus Phase 7 stand noch in `_prisma_migrations` und galt als „applied but missing" | Die Zeile entfernt. Ein `migrate resolve --rolled-back` räumt sie nicht weg |
+| Prisma wollte wieder die Volltextindizes abräumen | Bekannt seit Phase 1, achte Migration in Folge | 27 DropIndex-Blöcke entfernt, im Kopf der Migration vermerkt |
+| Die abgeleiteten Typen der Oberfläche waren `{}` | `ReturnType<typeof useQuery>["data"]` funktioniert bei tRPC nicht | `inferRouterOutputs<AppRouter>` — wie schon in Phase 7 |
+
+### Abweichung von der Vorgabe
+
+**Das Wiki hat keine Bilder.** Phase-8.md nennt sie nicht, aber man erwartet
+sie in einem Wiki. Sie fehlen bewusst: ein Bild in einer Seite wäre entweder
+eine Datei in MinIO mit eigener Rechteprüfung beim Ausliefern, oder ein Verweis
+auf einen fremden Server — und Letzteres verbietet die Grundregel, dass FLORIAN
+nichts von außen nachlädt. Nachrüstbar, wenn eine Wehr es vermisst.
+
+**Kein Streaming der Modellantwort.** Der Bericht erscheint am Stück, nicht Wort
+für Wort. Das sähe moderner aus, ist hier aber falsch: der Text soll gelesen und
+gegengezeichnet werden, nicht beim Entstehen bewundert. Und ein halb geschriebener
+Entwurf, den jemand vorzeitig übernimmt, wäre genau die Lücke, die diese Phase
+schließen soll.
+
+### Nachweise
+
+- `npx tsc --noEmit` — ohne Ausgabe
+- `npm run test` — 495 Tests grün, davon 21 neue gegen eine echte Datenbank
+- `npx playwright test tests/e2e/wissen.spec.ts` — 14 grün, ohne laufendes Modell
+- `npm run build` — 56 Routen
+- `npm run db:seed` — vier Wiki-Seiten mit eigenem Text
+- `docker compose build postgres` — PostGIS 3.5 und pgvector 0.8.6 im selben Image
+- `docker compose config` — Ollama und faster-whisper im Profil `ki` prüfen durch
 
 ---