Document the laptop-to-home transfer without moving personal data into git.

SQLite restore stays wave 1; Docker and Postgres stay wave 2. Session bootstrap for the switch is environment_handover.md plus the laptop and home work orders.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
LarsandCursor committed 2026-09-07 08:25:20 +02:00
1 parent ec0f8bad55
commit 29e3d0ff74
12 files changed
+1374 -10

No files matched your search

@@ -0,0 +1,204 @@
---
title: "Kanshō – Arbeitsauftrag Debug-Diagnostik und Export"
status: "Arbeitsauftrag"
date: "2026-08-31"
document_role: "Cursor Implementation Brief"
canonical_architecture: "docs/architecture/technical/admin_diagnostics.md"
---
# Arbeitsauftrag: Debug-Diagnostik und Export konsolidieren
Arbeite im aktiven Repository `C:\dev\Kansho`.
Dieses Dokument ist ein Umsetzungsauftrag. Es ersetzt keine kanonische Fach- oder Technikdokumentation. Neue Entscheidungen und der tatsächliche Implementierungsstand sind additiv in den jeweils zuständigen Dateien unter `docs/architecture/` zu dokumentieren.
## Ausgangslage
Die bestehende Diagnostik enthält bereits viele wertvolle Informationen. Sie ist aber über verschiedene Seiten und Exportwege verteilt. Je nachdem, ob ein Export aus einem Dialog, einem Tag oder einer Generierung gestartet wird, entsteht ein anderer und teilweise sehr großer JSON-Export.
Dadurch ist oft unklar:
- welche Läufe im Export enthalten sind,
- welche Dialoge und Generierungen zu einem Tag gehören,
- warum ein Lauf fehlgeschlagen ist,
- welche Fassung tatsächlich angezeigt oder gespeichert wurde,
- und an welcher Stelle der passende Export ausgelöst werden muss.
Teilweise werden dieselben Daten mehrfach eingebettet. Das macht Exporte unnötig groß und ihre Analyse schwierig.
Die bereits ergänzte Speicherung fehlgeschlagener Detect- und Journal-Läufe muss erhalten bleiben.
## Ziel
Baue eine zentrale, verständliche Admin-Diagnostik mit einem einheitlichen Exportverfahren.
Ein Administrator soll gezielt auswählen können:
1. welchen Reflection Space,
2. welchen Tag oder Zeitraum,
3. welche Dialoge,
4. welche Generierungsläufe – auch mehrere,
5. welche Laufarten und Status,
6. und welche Detailinformationen
der Export enthalten soll.
Die Diagnose soll sowohl für eine schnelle Sichtprüfung in der Oberfläche als auch für eine genaue externe Analyse des JSON geeignet sein.
## Vor der Umsetzung
Lies zunächst:
- `docs/architecture/functional/documentation_index.md`,
- `docs/architecture/technical/documentation_index.md`,
- `docs/architecture/technical/admin_diagnostics.md`,
- `docs/architecture/technical/privacy_gateway.md`,
- die bestehenden Debug-Routen, Datenmodelle und Frontend-Komponenten.
Prüfe die tatsächliche Implementierung und beschreibe kurz:
- die aktuellen Exportwege,
- vorhandene Doppelungen,
- fehlende Beziehungen,
- und welche Informationen bei Fehlern noch verloren gehen.
Leite die konkrete technische Lösung daraus ab. Übernimm nicht ungeprüft Annahmen aus diesem Auftrag.
## Anforderungen
### Zentrale Auswahl
Unter `/admin/debug` soll es einen zentralen Exportdialog geben.
Filter:
- Reflection Space,
- einzelner Tag oder Zeitraum,
- Dialoge als Mehrfachauswahl,
- Laufart beziehungsweise Purpose,
- Status,
- einzelne Run-IDs,
- optional Generierungszeitraum.
Vor dem Export soll sichtbar sein, wie viele Dialoge und Läufe durch die Auswahl erfasst werden.
### Auswählbare Inhalte
Der Administrator soll bestimmen können, welche Bereiche enthalten sind:
- kompakte Zusammenfassung,
- chronologische Ereignis- und Aufrufübersicht,
- Modell, Provider, Token, Kosten und Laufzeiten,
- Generierungsrichtlinien und wirksame Auswahl,
- wirksame Stilanwendung einschließlich tatsächlich eingebundener Profilbestandteile,
- verwendete Quellen,
- Privacy- und Detection-Diagnostik,
- Validierung und Fehlerursachen,
- Provideranfrage und Providerantwort,
- sichtbare und gespeicherte Ausgabe,
- vollständige Prompts und maskierter Provider-Egress.
Sensible Inhalte wie vollständige Prompts, Quellen und Rohantworten müssen ausdrücklich zugeschaltet werden. Zeige dabei einen klaren Warnhinweis.
Lokale Mappingtabellen, Secrets, Zugangsdaten und andere nicht benötigte Identitätsdaten dürfen niemals exportiert werden.
### Einheitliches Datenmodell
Erzeuge ein versioniertes, kanonisches Exportformat, beispielsweise Version 3.
Eine Information soll nur einmal enthalten sein. Beziehungen werden über IDs dargestellt, nicht durch wiederholtes Einbetten desselben Laufes unter Tag, Dialog und Generierung.
Eine mögliche oberste Struktur ist:
- `manifest`,
- `selection`,
- `entities`,
- `runs`.
Die konkrete Struktur soll aus dem bestehenden Datenmodell abgeleitet werden.
Bestehende Exportwege dürfen entweder kompatibel weiterlaufen oder müssen kontrolliert auf das neue Format umgestellt werden. Dokumentiere die Entscheidung.
### Vollständige Laufhistorie
Ein diagnostischer Lauf muss möglichst ab Beginn der Anfrage eine stabile Run-ID besitzen. Auch frühe Fehler sollen nachvollziehbar sein.
Unterscheide mindestens:
- laufend,
- erfolgreich,
- vor dem Provider fehlgeschlagen,
- Providerfehler,
- Detection fehlgeschlagen,
- Validierung fehlgeschlagen,
- Timeout,
- Clientabbruch,
- unvollständig beziehungsweise verwaist.
Vorhandene Statusbezeichnungen können weiterverwendet werden, wenn sie diese Fälle eindeutig abdecken.
Kosten oder Tokenwerte, die der Provider nicht geliefert hat, müssen als „nicht verfügbar“ beziehungsweise `null` erscheinen und dürfen nicht geschätzt als tatsächliche Werte ausgegeben werden.
### Einheitliche Einstiegspunkte
Export-Schaltflächen auf Dialog-, Tages- oder Generierungsseiten sollen keine eigenen Exportlogiken mehr besitzen. Sie öffnen denselben zentralen Exportdialog mit sinnvoll vorbelegten Filtern.
### Übersichtlichkeit
Die Adminoberfläche soll zuerst eine kompakte Übersicht zeigen. Technische Details werden erst bei Bedarf aufgeklappt.
Wichtig sind insbesondere:
- Status und Abbruchgrund,
- Dauer,
- Anzahl der Provideraufrufe,
- verwendetes Modell,
- Kosten und Token,
- Generate tatsächlich aufgerufen: ja/nein,
- Fallback verwendet: ja/nein,
- sichtbare und gespeicherte Fassung identisch: ja/nein.
## Grenzen
- Keine Änderung an Journal-Prompts oder Generierungsrichtlinien.
- Keine Änderung der semantischen Detection.
- Keine Lockerung der Privacy-Regeln.
- Keine journal-spezifische Sonderarchitektur für allgemeine Runs.
- Keine zukünftige Memory-Architektur vorwegnehmen.
- Keine echten Provideraufrufe.
- Kein Commit und kein Tag.
- Bestehende uncommittete Änderungen erhalten.
## Tests und Abnahme
Ergänze Regressionstests für mindestens:
1. Export eines einzelnen Dialogs.
2. Export eines Tages mit mehreren Dialogen.
3. Auswahl mehrerer Generierungsläufe.
4. Kombination erfolgreicher und fehlgeschlagener Läufe.
5. Persistenz eines Fehlers vor dem Generate-Aufruf.
6. Exakte Anwendung aller Filter.
7. Keine doppelte Einbettung eines Runs.
8. Sensible Inhalte nur nach ausdrücklicher Auswahl.
9. Niemals Secrets oder Identitäts-Mappingtabellen im Export.
10. Nicht-Admins erhalten keinen Zugriff.
11. Seitenspezifische Schaltflächen öffnen den zentralen Export mit korrekter Vorbelegung.
12. Bestehende MVP-Tests und Frontend-Build bleiben erfolgreich.
Dokumentiere die Änderung additiv in der bestehenden technischen Diagnostik-Dokumentation.
## Abschlussbericht
Berichte anschließend:
1. bestätigte Ursachen,
2. fachliches Bedienkonzept,
3. neues Exportmodell und Versionsstrategie,
4. geänderte Dateien,
5. Behandlung erfolgreicher und fehlgeschlagener Läufe,
6. Datenschutzgrenzen,
7. ausgeführte Tests,
8. bewusst verbleibende MVP-Grenzen.
Nenne ausdrücklich, was nur durch Tests bewiesen wurde und was noch interaktiv im Browser geprüft werden sollte.
@@ -0,0 +1,229 @@
---
title: "Kanshō – Handover Dialogfähigkeit und Langzeitgedächtnis"
status: "Arbeitsauftrag für neue Konzept-Session"
date: "2026-08-31"
document_role: "ChatGPT Session Brief / Next-Slice Handover"
canonical_handover: "docs/architecture/functional/handover.md"
---
# Handover: Kanshō als persönlicher Reflexionspartner mit Langzeitgedächtnis
Wir beginnen einen neuen Entwicklungsslice für Kanshō.
Dieses Dokument ist ein thematischer Arbeitsauftrag für die nächste Session. Es ersetzt weder `docs/architecture/functional/handover.md` noch die kanonischen Fachkapitel. Bei Abweichungen haben die aktuellen kanonischen Repository-Dateien Vorrang.
## Produktverständnis
Kanshō ist kein Tagebuchtool. Die Journalgenerierung ist lediglich eine mögliche Ausgabe eines Reflexionsprozesses.
Kanshō soll ein persönlicher, langfristiger Reflexionspartner werden, der Menschen dabei unterstützt, Erlebtes wahrzunehmen, zu reflektieren, zu verstehen und einzuordnen.
Die zentrale Produktfrage lautet:
> Was bedeutet das Erlebte für die Person?
Kanshō ist ausdrücklich kein generischer Chatbot, Therapeut, Aufgabenmanager, Fitness-Tracker oder still arbeitendes Persönlichkeitsprofil.
Die Dialogfähigkeit ist die zentrale Produktschnittstelle. Langzeitgedächtnis soll der Kontinuität und Tiefe des Dialogs dienen – nicht möglichst viele alte Informationen in jeden Prompt laden.
## Bestehender Stand
Der bisherige MVP konzentrierte sich stark auf Dialogerfassung, Journalgenerierung, Writing Profile, Privacy Gateway, Provenienz und konfigurierbare Generierungsrichtlinien.
Dieser Journal-MVP wird praktisch getestet und soll durch den neuen Slice nicht destabilisiert werden.
Aus den bisherigen Arbeiten sind besonders wichtig:
- Identität bleibt lokal.
- Externe Modelle erhalten persönlichen Kontext nur über das Privacy Gateway.
- Quellen bleiben autoritativ; Zusammenfassungen und Interpretationen sind abgeleitet.
- KI-Hypothesen sind keine bestätigten Erinnerungen.
- Aktueller Zustand ist nicht automatisch stabile Identität.
- Nutzerkorrekturen müssen gespeicherte Annahmen wirksam korrigieren können.
- Kontext soll relevant und ausreichend sein, nicht maximal.
- Der Normalfall soll möglichst einen wesentlichen generativen Modellaufruf pro Dialogzug behalten.
- Reflection Spaces und Intents dürfen nicht mit der Journalfunktion gleichgesetzt werden.
## Verbindliche Dokumentationsbasis
Arbeite im Repository `C:\dev\Kansho`.
Lies zuerst vollständig:
- `docs/architecture/functional/handover.md`,
- `docs/architecture/functional/documentation_index.md`,
- bei technischer Prüfung zusätzlich `docs/architecture/technical/documentation_index.md`.
Lade danach gezielt die passenden Context Bundles. Relevant sind insbesondere:
- `produktvision_und_produktidentitaet.md`,
- `fachliche_zielarchitektur.md`,
- `dialogue_model.md`,
- `usage_situations.md`,
- `reflection_spaces.md`,
- `resurfacing_and_saturation.md`,
- `memory_and_context.md`,
- `context_fidelity_and_regrounding.md`,
- `self_model_and_lived_experience.md`,
- `guardrails.md`.
Lade nicht unkritisch den gesamten Dokumentationsbaum. Die fachliche Dokumentation ist führend. Unterscheide konsequent zwischen „Entschieden“, „Bevorzugte Richtung“, „Hypothese“, „Offen“ und „Verworfen“.
Dokumente dürfen nicht stillschweigend gekürzt oder durch neue Paralleldokumente ersetzt werden.
## Fachliches Ziel des nächsten Slices
Der nächste Slice soll erstmals belastbar zeigen, dass Kanshō über einzelne Sitzungen hinaus als persönlicher Reflexionspartner funktioniert.
Kanshō soll:
- den gegenwärtigen Reflexionsraum erkennen und halten,
- unterschiedliche Reflection Intents unterscheiden,
- frühere relevante Gedanken gezielt wieder aufnehmen,
- mehrere offene Reflexionsfäden erkennen, parken und fortsetzen,
- historische Aussagen von der heutigen Sicht unterscheiden,
- Veränderungen über die Zeit sichtbar machen,
- Unsicherheit und widersprüchliche Aussagen aushalten,
- Erinnerungen mit Herkunft und zeitlichem Bezug verwenden,
- Korrekturen des Nutzers beachten,
- und Impulse geben, die über generische Rückfragen hinausgehen.
**Additiv 2026-09-07 (Opening, Code-Stand):** Der erste Impuls eines Journal-Dialogs darf abgeschlossene Vortage nicht als offenen Faden führen. Ursache war Recency: 400-Zeichen-Prefix eines Journal-Entries plus Plan-Regex, oft nach einem nachgetragenen Morgenanker. Invariante: Vorhaben nur aus dem user-Dialog von gestern; Entries sind kein Mandat; Opening ohne Space-Recency. Der laufende Dialogzug lädt Prefix-Recency weiter – das bleibt eine Lücke für Relevanz/Memory, nicht für den Opening-Adapter. Details: `mvp.md` §6.1, `mvp_implementation.md` §17, `mvp_stand_und_abgleich.md` §6 Punkt 4.
Dabei darf das System keine künstliche Gewissheit, Diagnose oder festgeschriebene Persönlichkeit erzeugen.
## Reflection Spaces und Intents
Reflection Spaces beantworten, in welchem Lebens- oder Bedeutungskontext eine Reflexion stattfindet. Intents beschreiben, was der Nutzer in diesem Moment erreichen möchte.
Der Dialog muss unterschiedliche Formen unterstützen, beispielsweise:
- ein Erlebnis zunächst nur erzählen,
- einen spontanen Gedanken festhalten,
- ein früheres Thema fortsetzen,
- ein Erlebnis tiefer verstehen,
- wiederkehrende Muster betrachten,
- eine Entscheidung oder Orientierung reflektieren,
- mit einem Konflikt oder einer emotionalen Reaktion arbeiten,
- eine tägliche Reflexion führen,
- Meditation oder Aufmerksamkeit reflektieren.
Es darf keinen einzigen starren Dialogmodus und keinen universellen Prompt geben, der alle Situationen gleich behandelt.
Ebenso darf das System den Nutzer nicht ständig zwingen, einen Modus, Space oder Intent manuell auszuwählen. Die Adaptive Entry bleibt maßgeblich:
1. kontextuell fortsetzen, wenn der Bezug klar ist,
2. freie Reflexion ermöglichen,
3. nur bei echter Mehrdeutigkeit explizit navigieren.
Gemischte oder sich während eines Dialogs verändernde Intents müssen möglich bleiben.
## Arbeitsauftrag für diesen Chat
### Phase 1: Bestehenden Stand verstehen
Prüfe fachliche Dokumentation und aktuelle Implementierung. Untersuche insbesondere:
- aktuellen Dialogprompt und Dialog-Orchestrierung,
- Speicherung von Nachrichten, Dialogen und Reflection Spaces,
- Context Builder und Retrieval,
- vorhandene Thread-, Episoden- und Memory-Strukturen,
- Status, Provenienz und Korrekturmöglichkeiten gespeicherter Inhalte,
- Privacy-Pfad für angereicherten Kontext,
- aktuelle Tests und dokumentierte Fit-Gaps.
Trenne danach klar:
1. fachlich bereits entschiedene Zielarchitektur,
2. technisch bereits belastbar umgesetzt,
3. nur als MVP-Annäherung vorhanden,
4. offen oder widersprüchlich,
5. für den nächsten Slice wirklich erforderlich.
### Phase 2: Nächsten vertikalen Slice entwerfen
Schlage keinen vollständigen Ausbau des gesamten Langzeitgedächtnisses vor. Definiere den kleinsten vertikalen Slice, der einen echten qualitativen Fortschritt im Dialog nachweist.
Der Slice soll mindestens umfassen:
- Intent-sensitive Dialogführung,
- Fortsetzung eines früheren Reflexionsfadens,
- gezieltes lokales Retrieval relevanter Erinnerungen,
- Unterscheidung historischer und aktueller Aussagen,
- sichtbare Herkunft beziehungsweise Re-Grounding,
- Nutzerkorrektur einer früheren Annahme,
- und eine normale Unterhaltung ohne relevante Erinnerung als Kontrollfall.
Der allgemeine Kern muss intent-neutral sein. Intent-spezifische Regeln gehören in Adapter oder Policies und nicht als Sonderfälle in die allgemeine Memory-Infrastruktur.
### Phase 3: Eval- und Abnahmekonzept
Entwickle vor der Implementierung reproduzierbare Dialogszenarien für mindestens:
1. autobiografisches Erzählen ohne Reflexionsdruck,
2. spontanen Gedanken,
3. Fortsetzung eines Themas nach mehreren Tagen,
4. tiefere biografische Reflexion,
5. Entscheidung oder Orientierung,
6. Konflikt beziehungsweise emotionale Reaktion,
7. Kontrollfall ohne relevante Erinnerung.
Bewerte dabei nicht nur Faktenabruf, sondern:
- Natürlichkeit des Dialogs,
- Qualität und Tiefe der Impulse,
- passende Intensität der Reflexion,
- relevante statt maximale Erinnerung,
- keine unpassenden historischen Einwürfe,
- korrekte zeitliche Einordnung,
- Umgang mit Unsicherheit und Widerspruch,
- Reaktion auf Nutzerkorrekturen,
- Vermeidung repetitiver oder generischer Fragen,
- Datenschutz,
- Latenz und Kosten.
### Phase 4: Entscheidungsvorlage
Erstelle zunächst:
1. eine kompakte Fit-Gap-Matrix,
2. den vorgeschlagenen nächsten Slice,
3. dessen fachliche und technische Grenzen,
4. konkrete Abnahmekriterien,
5. notwendige offene Produktentscheidungen,
6. und eine empfohlene Umsetzungsreihenfolge.
Eine bereits bekannte offene Frage ist die Positionierung bei Entscheidungsdialogen: Darf Kanshō nach ausreichender Reflexion eine begründete Einschätzung oder Empfehlung geben, oder soll es bewusst neutral bleiben? Behandle dies als intent-spezifische Produktentscheidung, nicht als Grundsatz für alle Dialoge.
Beginne noch nicht mit einer großen Implementierung. Stelle zuerst den tatsächlichen Stand und den vorgeschlagenen Slice zur gemeinsamen Entscheidung vor. Frage nur bei Punkten nach, die sich weder aus Dokumentation noch Code zuverlässig beantworten lassen.
## Architekturgrenzen
Vermeide insbesondere:
- das vollständige Langzeitgedächtnis in jeden Prompt zu laden,
- semantische Ähnlichkeit mit fachlicher Relevanz gleichzusetzen,
- jeden Dialogzug durch mehrere teure Analyseaufrufe zu schicken,
- Journallogik zum allgemeinen Dialog- oder Memory-Kern zu machen,
- unbestätigte Modellinterpretationen als Nutzerwissen zu speichern,
- aus aktuellen Aussagen stabile Persönlichkeitsmerkmale abzuleiten,
- Reflection Spaces unnötig zu vervielfachen,
- für einzelne Tests hardcodierte Regeln einzubauen,
- und die bestehende Privacy-Architektur für bessere Modellqualität zu umgehen.
Der Kontextaufbau soll grundsätzlich lokal erfolgen:
> Reflection Space zuerst, Langzeitgedächtnis gezielt bei Bedarf, minimal ausreichender Kontext, danach Privacy Gateway.
## Erwartete erste Antwort
Antworte nach der Einarbeitung zunächst mit:
1. den tatsächlich gelesenen Dokumenten,
2. dem bereits entschiedenen Produkt- und Architekturstand,
3. dem ermittelten Ist-Stand der Dialog- und Memory-Implementierung,
4. den wichtigsten Lücken,
5. einem Vorschlag für den ersten vertikalen Slice,
6. den Punkten, die wir gemeinsam entscheiden müssen.
Kanshō soll in diesem neuen Slice nicht zu einem besseren Tagebuchgenerator werden, sondern erstmals erkennbar zu einem kontinuierlichen, persönlichen und verlässlichen Reflexionspartner.
+158
View File
@@ -0,0 +1,158 @@
---
title: "Kanshō – Arbeitsauftrag Heim-Entwicklung, Server, Docker, Postgres"
status: "Arbeitsauftrag für die Session nach dem Laptop-Transfer"
date: "2026-09-07"
document_role: "Cursor Implementation Brief / Home Environment Setup"
canonical_handover: "docs/architecture/technical/environment_handover.md"
---
# Arbeitsauftrag: Heim-Entwicklungsumgebung, Server und Datenübernahme
Arbeite **nicht** auf der Urlaubs-SQLite als führende Instanz. Voraussetzung: `laptop_closeout.md` ist erfüllt (Gitea aktuell, Backup und `.env` liegen vor).
Lies zuerst:
- `docs/architecture/technical/environment_handover.md`
- `docs/architecture/technical/documentation_index.md`
- `docs/architecture/technical/runtime_and_deploy.md`
- `docs/architecture/technical/product_frame_and_stack.md`
- `docs/architecture/technical/mvp_implementation.md` §1 und §4
- fachlich nur `docs/architecture/functional/guardrails.md`, falls Egress oder Mapping berührt wird
Mitai-Muster liegen unter `C:\dev\mitai` (Compose, Workflows). Kanshō-Ports, Host-Pfade und Datenbanken nicht aus Mitai kopieren.
Keine Slice-2- oder Memory-Implementierung in diesem Auftrag. Kein Commit, bis der Nutzer ihn verlangt.
---
## Offene Host-Fragen, vor Phase B klären
In `runtime_and_deploy.md` §1/§6/§7 eintragen, nicht nur im Chat lassen:
1. Derselbe Raspberry-Pi wie Mitai, eigenes Compose-Projekt?
2. Eigenes Postgres (empfohlen) oder gemeinsame Instanz mit getrennter Database?
3. Host-Pfade analog `/home/lars/docker/…` – konkrete Kanshō-Verzeichnisse?
4. Dev-/Prod-Domains und **Kanshō-Ports** (lokal bleiben 5188/8018)?
5. Welle 2 zuerst SQLite im Volume oder direkt Postgres?
Solange 1–4 offen sind: nur Phase A ausführen.
---
## Phase A – Kontinuität (SQLite, ohne Docker)
Ziel: Dieselbe Anwendung wie auf dem Laptop, mit den Urlaubsdaten, auf dem Heimrechner.
1. `git clone https://gitea.stommer.de/Lars/Kansho.git` (Windows-Pfadempfehlung `C:\dev\Kansho`, wenn frei).
2. `git log -1` muss den Opening-Fix und die Transfer-Doku enthalten. Fehlt das, zuerst Laptop-Push nachholen.
3. `.\scripts\dev-setup.ps1`
4. `backend/.env` aus der Secret-Kopie. Nicht aus dem Backup-Zip.
5. Backend aus, dann Restore:
```powershell
.\scripts\backup-local.ps1 restore -Archive <pfad>\kansho-20260907-055703.zip -Confirm -Replace
```
6. Start: Backend `--port 8018`, Frontend `npm run dev` (5188).
7. Abnahme Phase A:
- [ ] `GET /api/health`
- [ ] Login mit bestehendem Admin
- [ ] Space `Kroatien 2026` und Test-Space sichtbar
- [ ] Journal Days und mindestens ein Entry mit Medien
- [ ] Identity-Mappings unter Admin vorhanden, Keys nicht in der DB
- [ ] Ein Dialogzug: ohne gültige Policy fail-closed; mit konfiguriertem Generate über Privacy Gateway
- [ ] `.\scripts\test-mvp.ps1` grün (Temp-Isolation)
Danach ist der Laptop nicht mehr Source of Truth. Weitere Dialoge nur noch hier.
---
## Phase B – Docker-Gerüst (noch ohne fachliche Postgres-Migration, falls so entschieden)
Erst nach beantworteten Host-Fragen.
Muster Mitai, eigene Namen:
- `docker-compose.yml` (Prod-ähnlich: Frontend-Nginx, Backend, Postgres 16)
- `docker-compose.dev.yml` / `docker-compose.dev-env.yml` nach Familienbrauch
- `backend/Dockerfile`, `frontend/Dockerfile`
- Root-`.env.example` für Compose-Secrets (DB-Passwort, Provider-Keys). Bestehendes `backend/.env.example` nicht stillschweigend ersetzen.
- Volumes für App-Daten und Medien. Keine Mitai-Volume-Namen (`bodytrack_*`).
- Healthcheck Backend; Startup: DB ready → Migrationen → Uvicorn.
- Lokale Ports **nicht** 3002/8002/5173/8000.
Zwischenstand zulässig: Compose startet Backend weiterhin auf SQLite im Volume, Postgres-Container schon mitlaufen, App noch nicht umgestellt. Das muss in `runtime_and_deploy.md` explizit stehen.
Abnahme Phase B:
- [ ] `docker compose up` startet die drei Dienste
- [ ] Frontend erreicht Backend über `/api`
- [ ] Secrets nur in Host-`.env`
- [ ] Re-Restore oder Volume-Mount der Phase-A-Daten dokumentiert
- [ ] `scripts/test-mvp.ps1` bleibt der lokale Nicht-Docker-Weg
---
## Phase C – PostgreSQL als App-Persistenz
Eigene Implementierung, kein stilles Umbenennen von `db.py`.
1. Adapter oder Dual-Backend: SQLite bleibt für Laptop/Tests zulässig, bis Postgres abgenommen ist.
2. `schema.sql` und die bestehenden `schema_migrations` nach Postgres-Dialekt führen (kein `PRAGMA`, `datetime('now')` prüfen, Typen).
3. Startpfad wie entschieden: Postgres ready → nummerierte SQL-Dateien → App. Fail-fast.
4. Einmaliges Migrationsskript SQLite → Postgres (Profile, Spaces, Journal, Medien-Metadaten, Mappings, Prompts). Medien-Dateien separat ins Volume.
5. Probe auf Kopie, nicht auf dem einzigen Backup.
6. Danach Backup-Strategie für Postgres (nicht nur `backup-local.ps1`). Restore-Übung wiederholen.
Abnahme Phase C:
- [ ] Leere Instanz startet und migriert
- [ ] Übernommene Urlaubsdaten: Entry-Anzahl, Message-Anzahl, ein Medien-GET
- [ ] Privacy Gateway unverändert fail-closed
- [ ] Tests gegen Postgres oder klar getrennte SQLite-Testmatrix
- [ ] Additive Doku in `runtime_and_deploy.md`, `mvp_implementation.md` §1/§4, `data_architecture.md` nur soweit Persistenzgrenzen betroffen sind
---
## Phase D – Gitea CI/CD
Erst wenn Runner und Host-Pfade existieren (`runtime_and_deploy.md` §4).
Vorlage: `C:\dev\mitai\.gitea\workflows\` (`deploy-dev.yml`, `deploy-prod.yml`, `test.yml`).
- Branch `develop` anlegen, wenn Dev-Deploy gewünscht
- Kanshō-Pfade, nicht `/home/lars/docker/bodytrack`
- Healthcheck auf Kanshō-Ports
- Testjob: Backend-Tests + Frontend-Build; keine Live-Provider-Keys im Runner
---
## Phase E – Transfer testen (Ende-zu-Ende)
Nach Phase A zwingend, nach B/C erneut:
1. Neues Backup auf der Heiminstanz erzeugen und an einem Temp-Pfad wiederherstellen.
2. Einen Journal Day öffnen, kurzen Dialog, Generate nur wenn Keys gesetzt.
3. Opening-Invariante: abgeschlossener Vortag erzeugt keinen falschen Plan-Impuls.
4. Admin → Schnittstellen: Keys aus `.env`, nicht aus der DB.
5. Kein Klartext-Detect in `KANSHO_ENV=production`.
6. Regression: `.\scripts\test-mvp.ps1`
---
## Grenzen
- Keine Mitai-Körperlogik, keine gemeinsamen Tabellen mit Mitai.
- Keine Lockerung der Guardrails „weil Docker intern ist“.
- Keine Produktiv-Domain erfinden.
- Watchtower nicht still einschalten.
- `Idea_seconmd_sclide.md` und Memory-Handover nicht in diesem Auftrag implementieren.
## Abschlussbericht
1. Welche Phasen tatsächlich gelaufen sind
2. Gewählte Host-Pfade, Ports, Compose-Projektnamen
3. Ob Daten SQLite oder Postgres führen
4. Restore-Nachweis (Anzahlen, ein Medienbeispiel ohne Inhalt zu zitieren)
5. Offene Punkte für die nächste Session
+87
View File
@@ -0,0 +1,87 @@
---
title: "Kanshō – Arbeitsauftrag Laptop-Abschluss vor dem Heimtransfer"
status: "Arbeitsauftrag / teilweise erledigt"
date: "2026-09-07"
document_role: "Cursor Implementation Brief / Laptop Closeout"
canonical_handover: "docs/architecture/technical/environment_handover.md"
---
# Arbeitsauftrag: Laptop-Abschluss
Arbeite im Repository `C:\dev\Kansho` auf dem **Urlaubs-Laptop**. Ziel ist, alles zu sichern und nach Gitea zu bringen, was zu Hause nicht mehr aus Cursor-Sessions rekonstruierbar ist.
Dieses Dokument ersetzt nicht `docs/architecture/technical/environment_handover.md`. Docker, Postgres und Server-Deploy gehören **nicht** hierher, sondern nach `home_environment_setup.md`.
## Bereits in der Transfer-Session erledigt (2026-09-07)
- Opening-Fix gegen veraltete Recency-Impulse: Code vorhanden, `python tests/test_journal_opening.py` grün.
- Kanonische Doku nachgezogen (2026-09-07): `mvp.md` §6.1 Fehlerbild Nachsatz/Prefix, Fit-Gap `mvp_stand_und_abgleich.md`, `mvp_implementation.md` §17, `memory_storage_and_offline.md`. Bewusst offen dokumentiert: 400-Zeichen-Recency im laufenden Dialogzug.
- Inventar der lokalen SQLite-Instanz (1 Profil, 2 Spaces, 17 Days/Entries, 379 Messages).
- Inventar der lokalen SQLite-Instanz (1 Profil, 2 Spaces, 17 Days/Entries, 379 Messages).
- Lokales Backup: `local-backups/kansho-20260907-055703.zip` (~10,1 MB, SHA256 `2D1E160F6DF95FA0C46B8F3FE69C1681827DE0DF304A2E955304A5C56CC7854F`). SQLite + 70 Medien, keine Secrets.
- `.\scripts\test-mvp.ps1` Exit 0 (isolierte Temp-Daten, Produktions-SQLite unangetastet).
- Technisches Handover und Heim-Setup-Auftrag angelegt.
## Noch auf dem Laptop, bevor die Instanz aufhört führend zu sein
### 1. Keine neuen Produktfeatures
Nicht auf dem Laptop beginnen oder zu Ende bauen:
- `docs/work_orders/debug_diagnostics_perfection.md`
- `docs/work_orders/dialogue_memory_next_slice_handover.md`
- `docs/architecture/functional/Idea_seconmd_sclide.md` (Slice-2-Konzeptbrief)
Diese Dateien versionieren, nicht ausführen.
### 2. Git nach Gitea
Ohne Push bleibt `e42f751 MVP 1.0` und der Opening-Fix nur auf dem Laptop.
Vorschlag zwei Commits (dieser Abschluss darf committen, wenn der Nutzer den Transfer schließt):
1. Opening-Fix + kanonische Opening-Doku (`mvp.md`, `mvp_implementation.md`, `mvp_stand_und_abgleich.md`, `memory_storage_and_offline.md`, Tests)
2. Transfer-Dokumentation, Work Orders, Slice-2-Brief
Remote: `origin` = `https://gitea.stommer.de/Lars/Kansho.git`, Branch `main`. Nach dem Push `git status` muss „up to date with origin/main“ zeigen.
`develop` auf dem Laptop **nicht** anlegen, solange kein Dev-Host existiert.
### 3. Daten und Secrets physisch kopieren
| Artefakt | Wohin | Nicht |
|---|---|---|
| `local-backups/kansho-20260907-055703.zip` | verschlüsselter Stick / NAS / Heimrechner | Git, Chat, Cloud-Klartext |
| `backend/.env` | separate Secret-Notiz oder Passwortmanager | Backup-Zip, Git |
| Login-Passwort des Admin-Profils | Kopf / Passwortmanager | Doku-Repo |
Nach dem Kopieren Checksumme des Zip notieren (`Get-FileHash`). Restore prüft Manifest-Checksummen zusätzlich.
Wenn nach dem Backup noch Dialoge auf dem Laptop laufen: neues Backup erzeugen und **dieses** Archiv mitnehmen.
### 4. Instanz stilllegen
- Uvicorn/Vite beenden.
- Keine parallelen Schreibzugriffe Laptop + Heimrechner auf denselben persönlichen Bestand.
- Laptop-Ordner als Archive behalten, bis Welle 1 zu Hause bestätigt ist.
### 5. Kurzer lokaler Smoke (optional, wenn Zeit)
Nur wenn der Opening-Fix committet werden soll und der Dev-Server ohnehin läuft:
- Neuen Journal Day im Space `Kroatien 2026` starten: erster Impuls darf keine abgeschlossene Vortags-Episode als offenen Faden nehmen.
- `.\scripts\test-mvp.ps1` rührt die Produktions-SQLite nicht an.
Kein Live-OpenRouter-Zwang für den Abschluss.
## Abnahme Laptop
- [ ] Opening-Fix und Transfer-Doku auf `origin/main`
- [ ] Backup-Zip außerhalb des Laptops
- [ ] `.env` außerhalb des Laptops
- [ ] Slice-2 / Debug / Memory-Aufträge nur versioniert, nicht implementiert
- [ ] Persönliche SQLite nicht in Git
## Abschlussbericht
Nennen: Commit-Hashes, Backup-Dateiname, ob nach dem Backup noch geschrieben wurde, was bewusst offen bleibt.