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:
1 parent
ec0f8bad55
commit
29e3d0ff74
12 files changed
+1374
-10
No files matched your search
@@ -0,0 +1,430 @@
|
||||
Du arbeitest im Kanshō-Repository als **fachlicher Konzept-Worker**.
|
||||
|
||||
Deine Aufgabe ist ausdrücklich **nicht**, Slice 2 zu implementieren oder technische Detailarchitektur vorwegzunehmen. Du sollst auf Basis der bestehenden kanonischen Fachkonzepte einen **fachlich belastbaren Vorschlag und Anforderungsschnitt für den zweiten vertikalen Produktslice** erarbeiten, der anschließend als Grundlage für einen Coding Agent dienen kann.
|
||||
|
||||
## Ausgangslage
|
||||
|
||||
Der erste MVP-Slice ist abgeschlossen.
|
||||
|
||||
Er realisiert einen journalzentrierten Anwendungsfall innerhalb eines Reflection Space:
|
||||
|
||||
- Beispiel Reflection Space: `Veli Lošinj 2026`
|
||||
- pro Tag kann es einen Journal Day geben
|
||||
- pro Tag können mehrere Conversations/Chats geführt werden
|
||||
- der Nutzer kann entscheiden, welcher Dialog bzw. welche Dialoge als Inputquelle für die Journalgenerierung verwendet werden
|
||||
- der ausgewählte Dialog wird **nicht direkt als Tagebucheintrag übernommen**
|
||||
- aus dem Dialog wird mehrstufig mit Hilfe der KI und des persönlichen Writing Profile ein persönlicher Journal Draft generiert
|
||||
- dieser Draft kann anschließend redigiert und als Journal Entry übernommen werden
|
||||
- das Ergebnis soll insbesondere bei Reise-/Urlaubstagebüchern eine zusammenhängende, menschenlesbare autobiografische Erinnerung ergeben
|
||||
|
||||
Diese Fähigkeit ist wertvoll und darf durch Slice 2 **nicht verschlechtert oder fachlich entwertet** werden.
|
||||
|
||||
Gleichzeitig bildet dieser MVP nur eine Teilmenge des Kanshō-Zielbilds ab.
|
||||
|
||||
Kanshō soll langfristig ein **Personal Reflection Companion** sein und nicht auf Tagesjournal bzw. Tagebuch beschränkt bleiben.
|
||||
|
||||
## Bestehendes fachliches Zielbild
|
||||
|
||||
Die vorhandenen Fachkonzepte unterscheiden insbesondere:
|
||||
|
||||
### Reflection Space
|
||||
|
||||
Der Reflection Space beschreibt den Bedeutungs-, Lebens- oder Erfahrungskontext.
|
||||
|
||||
Beispiele:
|
||||
|
||||
- `Urlaub → Veli Lošinj 2026`
|
||||
- persönliche Entwicklung
|
||||
- Beruf
|
||||
- Familie
|
||||
- ein konkretes längerfristiges persönliches Thema
|
||||
|
||||
Ein Reflection Space ist kein bloßer Ordner und kein Intent. Er bildet für den Nutzer einen verständlichen Denk- und Erfahrungsraum und soll ein wesentliches menschliches Ordnungsprinzip bleiben.
|
||||
|
||||
### Nutzungssituation / Reflection Intent
|
||||
|
||||
Die bestehende Fachkonzeption beschreibt elf vorläufig vollständige Nutzungssituationen:
|
||||
|
||||
1. Erleben festhalten
|
||||
2. Tagesreflexion
|
||||
3. Spontaner Gedanke / Moment
|
||||
4. Früheren Faden fortsetzen
|
||||
5. Tiefe Reflexion / biografische Frage
|
||||
6. Entscheidung / Orientierung
|
||||
7. Inspiration / Vision / Kreativität
|
||||
8. Achtsamkeit / Meditation / Check-in
|
||||
9. Rückblick und persönliche Entwicklung
|
||||
10. Geplante Reflexionszeit / Ritual
|
||||
11. Wiederfinden und Revue passieren
|
||||
|
||||
Diese Nutzungssituationen sind **keine elf Reflection Spaces und keine Verpflichtung zu elf technischen Intent Engines**.
|
||||
|
||||
Sie beschreiben, was der Nutzer in einer konkreten Interaktion gerade erreichen möchte.
|
||||
|
||||
Der Reflection Intent kann:
|
||||
|
||||
- explizit durch den Nutzer gesetzt werden,
|
||||
- von Kanshō aus Einstieg und Kontext erkannt werden,
|
||||
- sich im Verlauf derselben Conversation verändern.
|
||||
|
||||
Ein Intent-Wechsel soll einen natürlichen Dialog nicht automatisch in mehrere Chats zerlegen.
|
||||
|
||||
### Threads
|
||||
|
||||
Eine Conversation kann mehrere Reflexionsfäden enthalten.
|
||||
|
||||
Threads dienen langfristiger inhaltlicher Kontinuität und können über Conversations, Tage und ggf. Reflection Spaces hinweg weiterlaufen.
|
||||
|
||||
Nicht jedes Seitenthema soll automatisch einen sichtbaren oder langlebigen Thread erzeugen.
|
||||
|
||||
### Memory und Context
|
||||
|
||||
Die bestehende Baseline lautet insbesondere:
|
||||
|
||||
- aktueller Dialog zuerst
|
||||
- Primary Reflection Space vor globalem Langzeitgedächtnis
|
||||
- Long-Term Memory nur bei tatsächlichem Bedarf
|
||||
- Minimum sufficient context
|
||||
- Retrieval findet Kandidaten; Context-Auswahl entscheidet Relevanz
|
||||
- semantische Ähnlichkeit allein ist kein Relevanznachweis
|
||||
- Source bleibt kanonisch
|
||||
- Derived ersetzt Source nicht
|
||||
- Current Validity und History bleiben getrennt
|
||||
- Nutzerkorrekturen haben Vorrang
|
||||
- langfristige Dialogkontinuität muss unter Kontrolle von Kanshō bleiben
|
||||
|
||||
Die bestehende fachliche Eskalation ist sinngemäß:
|
||||
|
||||
`Current Session → Primary Reflection Space → aktive Threads / offene Fragen → relevanter Reflection Context → relevantes Kanshō Long-Term Memory → mindnet → Original Sources / Re-Grounding`
|
||||
|
||||
### Reflection Outputs
|
||||
|
||||
Ein Dialog kann mehrere unterschiedliche Ergebnisse erzeugen.
|
||||
|
||||
Beispielsweise:
|
||||
|
||||
- Journal Entry
|
||||
- Reflection Memory
|
||||
- Knowledge Delta
|
||||
- Action Candidate
|
||||
- interne Kontinuitätsstrukturen wie Thread Memory oder offene Fragen
|
||||
|
||||
Nicht jede Conversation muss ein sichtbares Output-Artefakt erzeugen.
|
||||
|
||||
## Zentrale Fragestellung für Slice 2
|
||||
|
||||
Der nächste Slice soll das heute journalzentrierte System zu einem allgemeineren dialogischen Reflexionsbegleiter weiterentwickeln.
|
||||
|
||||
Dabei muss insbesondere geprüft werden:
|
||||
|
||||
> Wie kann ein Reflection Space unterschiedliche Reflection Intents und natürlich gemischte Conversations tragen, ohne dass dadurch die heute bereits gut funktionierende Fähigkeit verloren geht, aus einem oder mehreren ausgewählten Dialogen einen kohärenten persönlichen Tages- bzw. Reisetagebucheintrag zu generieren?
|
||||
|
||||
Beispiel:
|
||||
|
||||
Im Reflection Space `Veli Lošinj 2026` beginnt eine Conversation mit der Beschreibung des Urlaubstags.
|
||||
|
||||
Während des Gesprächs sagt der Nutzer beispielsweise:
|
||||
|
||||
> „Mir fällt auf, dass ich hier im Urlaub viel bewusster lebe als zu Hause.“
|
||||
|
||||
Daraus kann sich eine längere tiefere Reflexion entwickeln.
|
||||
|
||||
Danach erzählt der Nutzer möglicherweise wieder weiter vom Tagesgeschehen.
|
||||
|
||||
Die Conversation enthält damit mindestens:
|
||||
|
||||
- autobiografisches Tageserleben
|
||||
- persönliche Reflexion
|
||||
- möglicherweise einen längerfristig relevanten Reflexionsfaden
|
||||
|
||||
Trotzdem soll aus diesem Dialog weiterhin ein **guter zusammenhängender Journal Entry über den Urlaubstag** generiert werden können.
|
||||
|
||||
Dabei darf weder gelten:
|
||||
|
||||
- „der vollständige Dialog muss ungefiltert in den Journalentwurf einfließen“
|
||||
|
||||
noch:
|
||||
|
||||
- „alles, was während eines anderen Reflection Intents gesagt wurde, darf grundsätzlich nicht in das Journal“
|
||||
|
||||
Denn eine persönliche Reflexion kann sehr wohl ein wichtiger Teil der autobiografischen Erinnerung dieses Tages sein.
|
||||
|
||||
## Deine Aufgabe
|
||||
|
||||
Erarbeite daraus einen **fachlichen Vorschlag für Slice 2**.
|
||||
|
||||
Prüfe dabei insbesondere folgende Punkte.
|
||||
|
||||
### 1. Produktthese des Slices
|
||||
|
||||
Formuliere präzise:
|
||||
|
||||
- welche neue Nutzerfähigkeit Slice 2 beweisen soll,
|
||||
- warum diese nach dem Journal-MVP der sinnvollste nächste vertikale Schritt ist,
|
||||
- welche Teile des Kanshō-Zielbilds dadurch erstmals real validiert werden.
|
||||
|
||||
Vermeide einen rein technischen „Memory-Ausbau“ als Produktthese.
|
||||
|
||||
### 2. Reflection Space als Ordnungsrahmen
|
||||
|
||||
Prüfe und konkretisiere:
|
||||
|
||||
- welche Rolle Reflection Spaces im Slice spielen,
|
||||
- wie sie für den Nutzer als nachvollziehbares Ordnungsprinzip erhalten bleiben,
|
||||
- wie Conversations mit unterschiedlichen Intents innerhalb desselben Space organisiert werden,
|
||||
- wie verhindert wird, dass Threads, Memories, Intents und Derived Objects zu einer unübersichtlichen sichtbaren Struktur führen.
|
||||
|
||||
Beachte dabei die bestehende Leitlinie:
|
||||
|
||||
> interne Reichhaltigkeit darf deutlich größer sein als die sichtbare Nutzerstruktur.
|
||||
|
||||
### 3. Multi-Intent Conversation
|
||||
|
||||
Definiere fachlich:
|
||||
|
||||
- wie der initiale Reflection Intent entsteht,
|
||||
- wie expliziter Nutzer-Intent und automatische Erkennung zusammenspielen,
|
||||
- wie sich Intent innerhalb derselben Conversation verändern darf,
|
||||
- welche Auswirkungen Intent auf Dialogtiefe, Richtung, Initiative und Kontextnutzung besitzt,
|
||||
- welche Zustände tatsächlich langlebig gespeichert werden müssen und welche nur operative Dialogsteuerung sein können.
|
||||
|
||||
Lege **nicht vorschnell eine neue reduzierte Intent-Taxonomie** fest.
|
||||
|
||||
Wenn mehrere fachliche Intents dieselbe technische Dialog-/Context-Policy verwenden könnten, darfst du dies als spätere technische Verdichtung benennen. Die elf fachlichen Nutzungssituationen sollen dadurch jedoch nicht stillschweigend ersetzt werden.
|
||||
|
||||
### 4. Erhalt des Journal-Workflows
|
||||
|
||||
Dies ist ein **zentrales Acceptance-Thema des Slices**.
|
||||
|
||||
Beschreibe fachlich, wie der bestehende Workflow erhalten bleiben kann:
|
||||
|
||||
`Reflection Space → Journal Day → ein oder mehrere Dialoge als Input auswählen → mehrstufige KI-Generierung mit Writing Profile → Journal Draft → Nutzerredaktion → Journal Entry`
|
||||
|
||||
Berücksichtige dabei insbesondere gemischte Conversations.
|
||||
|
||||
Klärungsbedarf:
|
||||
|
||||
- Wie entscheidet sich fachlich, welche Inhalte eines gemischten Dialogs für einen konkreten Journal Draft relevant sind?
|
||||
- Welche Rolle spielen Reflection Intent, Tagesbezug, Ereignisbezug, Nutzerwahl und andere Signale?
|
||||
- Kann ein und derselbe Gesprächsabschnitt für mehrere fachliche Ergebnisse relevant sein?
|
||||
- Wie bleibt der Originaldialog die Quelle?
|
||||
- Welche fachliche Provenance zwischen Quelle und Output wird benötigt?
|
||||
- Muss dafür ein eigenes langlebiges Segmentobjekt entstehen oder reicht fachlich zunächst die Fähigkeit, Outputs auf relevante Message-/Source-Bereiche zurückzuführen?
|
||||
- Welche dieser Fragen muss Slice 2 tatsächlich lösen und welche darf offen bleiben?
|
||||
|
||||
Wichtig:
|
||||
|
||||
Der Nutzer soll weiterhin auf grober Ebene entscheiden können, welche Conversation(s) eines Tages als Inputquelle für den Journal Draft dienen.
|
||||
|
||||
Kanshō darf innerhalb dieser Quellen eine feinere inhaltliche Relevanzbewertung übernehmen, ohne daraus eine komplexe Segmentverwaltungsoberfläche für den Nutzer zu machen.
|
||||
|
||||
### 5. Threads und Kontinuität
|
||||
|
||||
Bestimme den minimal notwendigen Umfang für Slice 2.
|
||||
|
||||
Prüfe:
|
||||
|
||||
- wann ein Nebenfaden lediglich temporärer Gesprächskontext bleibt,
|
||||
- wann daraus ein Thread Candidate entstehen kann,
|
||||
- wann ein langlebiger Thread erforderlich ist,
|
||||
- wie ein bereits bestehender Thread später fortgesetzt werden kann,
|
||||
- welches minimale Thread Memory dafür benötigt wird.
|
||||
|
||||
Vermeide eine vollständige Thread-Ontologie oder umfangreiche automatische Thread-Verwaltung, wenn sie für diesen Slice nicht erforderlich ist.
|
||||
|
||||
### 6. Memory und Context Builder
|
||||
|
||||
Beschreibe den minimal notwendigen fachlichen Memory-Ausbau.
|
||||
|
||||
Insbesondere:
|
||||
|
||||
- welche Memory-/Context-Schichten Slice 2 tatsächlich benötigt,
|
||||
- wie der Reflection Intent die Context-Auswahl beeinflusst,
|
||||
- welche früheren Informationen bei unterschiedlichen Intents eher relevant sind,
|
||||
- wie `Reflection Space first, Long-Term Memory on demand` erhalten bleibt,
|
||||
- wie verhindert wird, dass globale autobiografische Suche zum Normalfall jedes Turns wird.
|
||||
|
||||
Prüfe ausdrücklich, welche Fähigkeiten **noch nicht** notwendig sind.
|
||||
|
||||
### 7. Persistenz und Outputs
|
||||
|
||||
Klär fachlich, welche langlebigen Ergebnisse Slice 2 benötigt.
|
||||
|
||||
Beispielsweise:
|
||||
|
||||
- Journal Entry
|
||||
- Thread Memory
|
||||
- Open Question
|
||||
- Reflection Memory / Insight
|
||||
- ggf. andere Derived Objects
|
||||
|
||||
Nicht jedes mögliche Target-Objekt soll automatisch Bestandteil des Slices werden.
|
||||
|
||||
Für jedes vorgeschlagene langlebige Objekt beantworte:
|
||||
|
||||
- Warum benötigt der aktuelle Slice dieses Objekt jetzt?
|
||||
- Würde ein späteres Nachrüsten sonst eine grundlegende Refaktierung erzwingen?
|
||||
- Ist es sichtbares Nutzerartefakt oder primär interne Kontinuitätsstruktur?
|
||||
|
||||
Beachte die Implementation Foundation:
|
||||
|
||||
> Neue Abstraktionen benötigen aktuellen Nutzen.
|
||||
|
||||
### 8. Current Validity, Correction und Provenance
|
||||
|
||||
Sobald Derived Memory produktiv für spätere Dialoge verwendet wird, müssen mindestens die bestehenden Foundation-Regeln eingehalten werden:
|
||||
|
||||
- Source bleibt kanonisch
|
||||
- Derived ersetzt Source nicht
|
||||
- Zeit und Provenance
|
||||
- Current Validity vs. History
|
||||
- User Correction > Model Inference
|
||||
|
||||
Prüfe, welcher **minimale fachliche Korrektur- und Re-Grounding-Umfang** für Slice 2 wirklich notwendig ist.
|
||||
|
||||
Baue daraus nicht automatisch eine umfangreiche Provenance- oder Memory-Administration als Produktfeature.
|
||||
|
||||
### 9. Auswahl der Nutzungssituationen für Slice 2
|
||||
|
||||
Mappe alle elf bestehenden Nutzungssituationen auf:
|
||||
|
||||
- bereits durch MVP abgedeckt / Regression Case
|
||||
- Bestandteil Slice 2
|
||||
- bewusst später
|
||||
|
||||
Begründe die Auswahl.
|
||||
|
||||
Prüfe insbesondere, ob für Slice 2 zusätzlich zum bestehenden Journalpfad folgende Situationen geeignet sind:
|
||||
|
||||
- Spontaner Gedanke / Moment
|
||||
- Früheren Faden fortsetzen
|
||||
- Tiefe Reflexion / biografische Frage
|
||||
- Entscheidung / Orientierung
|
||||
|
||||
Übernimm diese Auswahl aber nicht ungeprüft. Wenn du einen engeren oder besseren vertikalen Schnitt begründen kannst, schlage ihn vor.
|
||||
|
||||
### 10. Acceptance Scenarios
|
||||
|
||||
Definiere wenige, aber harte End-to-End-Szenarien.
|
||||
|
||||
Mindestens zu prüfen:
|
||||
|
||||
#### A. Bestehendes Reisetagebuch als Regression
|
||||
|
||||
Space `Veli Lošinj 2026`.
|
||||
|
||||
Der Nutzer führt einen überwiegend autobiografischen Tagesdialog.
|
||||
|
||||
Der bestehende Journalworkflow funktioniert weiterhin mindestens so gut wie im MVP.
|
||||
|
||||
#### B. Gemischter Urlaubsdialog
|
||||
|
||||
Ein Dialog beginnt mit Tageserleben, geht in tiefere persönliche Reflexion über und kehrt anschließend zum Tageserleben zurück.
|
||||
|
||||
Aus dem Dialog kann weiterhin ein kohärenter persönlicher Journal Draft entstehen.
|
||||
|
||||
Die tiefere Reflexion darf dabei weder ungeprüft vollständig in das Journal übernommen noch pauschal ausgeschlossen werden.
|
||||
|
||||
#### C. Freie Nicht-Journal-Reflexion
|
||||
|
||||
Der Nutzer beginnt innerhalb eines Reflection Space mit einer persönlichen Frage.
|
||||
|
||||
Kein Journal Day ist zwingend erforderlich.
|
||||
|
||||
Kanshō führt intentgerecht einen tieferen Reflexionsdialog.
|
||||
|
||||
#### D. Früheren Faden fortsetzen
|
||||
|
||||
Nach mehreren Tagen wird ein bestehender relevanter Reflexionsfaden fortgesetzt.
|
||||
|
||||
Der Nutzer muss den bisherigen Denkstand nicht erneut vollständig erklären.
|
||||
|
||||
#### E. Intent-Wechsel
|
||||
|
||||
Der Intent verändert sich innerhalb derselben Conversation, ohne dass der Nutzer einen neuen Chat starten muss.
|
||||
|
||||
#### F. Kein relevantes Memory
|
||||
|
||||
Kanshō führt einen natürlichen Dialog, ohne künstlich frühere Erinnerungen oder Zusammenhänge anzudeuten.
|
||||
|
||||
### 11. Explizite Non-Goals
|
||||
|
||||
Grenze den Slice klar gegen das spätere Zielmodell ab.
|
||||
|
||||
Prüfe insbesondere als Non-Goals:
|
||||
|
||||
- vollständiges Self Model
|
||||
- langfristige automatische Pattern-Erkennung
|
||||
- globales semantisches Retrieval über die gesamte Biografie
|
||||
- vollständiger Reflection Graph
|
||||
- komplexes Resurfacing
|
||||
- umfassende Thread-Ontologie
|
||||
- automatische Promotion jedes Gedankens
|
||||
- mindnet-/Kairo-/Obsidian-Vollintegration
|
||||
- Meditation/Achtsamkeit als eigener großer Interaction Slice
|
||||
- vollständiger Entwicklungsrückblick
|
||||
- Revue-/Recall-System
|
||||
- elf technische Intent Engines
|
||||
|
||||
### 12. Auswirkungen auf bestehende Fachkonzepte
|
||||
|
||||
Prüfe zum Abschluss:
|
||||
|
||||
- welche bestehenden Fachentscheidungen der Slice lediglich konkretisiert,
|
||||
- wo tatsächlich eine neue fachliche Entscheidung erforderlich ist,
|
||||
- welche Dokumente später additiv aktualisiert werden müssten,
|
||||
- ob irgendwo bestehende Konzepte widersprüchlich oder für den Slice noch unzureichend sind.
|
||||
|
||||
Ändere keine kanonischen Dateien in diesem Arbeitsschritt.
|
||||
|
||||
## Zu lesende kanonische Grundlage
|
||||
|
||||
Lade mindestens:
|
||||
|
||||
- `docs/architecture/functional/produktvision_und_produktidentitaet.md`
|
||||
- `docs/architecture/functional/usage_situations.md`
|
||||
- `docs/architecture/functional/reflection_spaces.md`
|
||||
- `docs/architecture/functional/dialogue_model.md`
|
||||
- `docs/architecture/functional/memory_and_context.md`
|
||||
- `docs/architecture/functional/reflection_outputs.md`
|
||||
- `docs/architecture/functional/implementation_foundation.md`
|
||||
|
||||
Zusätzlich gezielt, soweit für konkrete Entscheidungen erforderlich:
|
||||
|
||||
- `resurfacing_and_saturation.md`
|
||||
- `context_fidelity_and_regrounding.md`
|
||||
- `writing_profile_and_journaling.md`
|
||||
- `mvp.md`
|
||||
- aktuelle technische MVP-Dokumentation beziehungsweise Code nur zur Prüfung von Ist-Stand und Migrationsrisiko
|
||||
|
||||
Verwende `mvp_stand_und_abgleich.md` nur mit Vorsicht als historischen Snapshot, falls der aktuelle Repo-Stand inzwischen weiterentwickelt wurde.
|
||||
|
||||
## Erwartetes Ergebnis
|
||||
|
||||
Liefere einen strukturierten fachlichen Slice-Vorschlag mit:
|
||||
|
||||
1. Executive Summary
|
||||
2. Produktthese
|
||||
3. fachlichem Zielbild des Slices
|
||||
4. Fit-Gap zum abgeschlossenen Journal-MVP
|
||||
5. Mapping der elf Nutzungssituationen
|
||||
6. Rollen von Space, Conversation, Intent, Thread, Memory und Output
|
||||
7. Journal-Regressionsmodell einschließlich gemischter Conversations
|
||||
8. minimalem Memory-/Continuity-Umfang
|
||||
9. notwendigen fachlichen Objekten und Beziehungen
|
||||
10. Acceptance Scenarios und Acceptance Criteria
|
||||
11. expliziten Non-Goals
|
||||
12. offenen Produktentscheidungen
|
||||
13. empfohlenen Dokumentationsänderungen
|
||||
14. klarer Empfehlung, ob dieser Slice der optimale nächste vertikale Schritt ist oder ob ein kleinerer/besserer Schnitt vorzuziehen ist
|
||||
|
||||
Wichtig:
|
||||
|
||||
- Keine Implementierung beginnen.
|
||||
- Keine Dateien verändern.
|
||||
- Keine Target Capabilities allein deshalb vorbauen, weil sie im Gesamtmodell existieren.
|
||||
- Fachliche Anforderungen und technische mögliche Umsetzung klar trennen.
|
||||
- Bestehende Entscheidungen nicht stillschweigend ersetzen.
|
||||
- Bei Widersprüchen zwischen Dokumenten diese explizit benennen.
|
||||
- Den bestehenden Reisetagebuch-Workflow als harte Regression behandeln.
|
||||
- Ziel ist ein **umsetzbarer vertikaler Slice**, nicht eine neue vollständige Kanshō-Gesamtarchitektur.
|
||||
@@ -1,7 +1,7 @@
|
||||
---
|
||||
title: "Kanshō – Dokumentationsindex und Context Bundles"
|
||||
status: "Arbeitsstand"
|
||||
date: "2026-08-18"
|
||||
date: "2026-09-07"
|
||||
product_family: "Jinkendo"
|
||||
document_role: "Documentation Index / Context Loading Guide"
|
||||
parent_document: "fachliche_zielarchitektur.md"
|
||||
@@ -13,7 +13,7 @@ Dieses Dokument dient dazu, für weitere Konzeptarbeit nur die tatsächlich ben
|
||||
|
||||
## 1. Root-Dokumente
|
||||
|
||||
- `handover.md` – Session-Bootstrap für die **Konzept-/Interviewarbeit**; nicht der Code-Stand. Implementierungsstand und Fit-Gap: `mvp_stand_und_abgleich.md`.
|
||||
- `handover.md` – Session-Bootstrap für die **Konzept-/Interviewarbeit**; nicht der Code-Stand. Implementierungsstand und Fit-Gap: `mvp_stand_und_abgleich.md`. Umgebungswechsel Laptop → Heim/Server: `../technical/environment_handover.md`.
|
||||
- `fachliche_zielarchitektur.md` – Governance, Dokumentationsprinzipien, Querschnittsinvarianten, Dateistruktur.
|
||||
- `produktvision_und_produktidentitaet.md` – Vision, Identität, Scope, Produktprinzipien und Nicht-Ziele.
|
||||
- `interview_plan.md` – Kapitelplan, Interviewmethode, Fortschritt und nächster Interviewblock.
|
||||
@@ -103,6 +103,8 @@ Sie übernimmt den Produktrahmen **weitgehend von Mitai**. Datenschutz, Privacy
|
||||
|
||||
Technische Umsetzung des gebauten Journal-Slices: `../technical/mvp_implementation.md`. Fit-Gap bleibt fachlich: `mvp_stand_und_abgleich.md`.
|
||||
|
||||
Arbeitsaufträge (kein Ersatz kanonischer Kapitel): `docs/work_orders/` – Laptop-Abschluss, Heim-Setup, Debug-Export, Dialog/Memory-Slice. Slice-2-Konzeptbrief derzeit `Idea_seconmd_sclide.md`.
|
||||
|
||||
## 5. Ladeprinzip
|
||||
|
||||
> **Nicht alle Kanshō-Dokumente gleichzeitig laden.** Root-Dokumente plus die 2–4 fachlich betroffenen Dateien bilden den Standardkontext.
|
||||
|
||||
@@ -15,7 +15,9 @@ canonical_docs_path: "docs/architecture/functional/"
|
||||
|
||||
Dieses Dokument ist der **vollständige fachliche Aufsatzpunkt für eine neue Kanshō-Konzept-Session**.
|
||||
|
||||
**Implementierungsstand (Code)** steht nicht hier, sondern in `mvp_stand_und_abgleich.md` (2026-08-25): Slice gegen Foundation, MVP-Text und Gesamtziel. Dieses Handover bleibt der Konzept-/Interview-Bootstrap.
|
||||
**Implementierungsstand (Code)** steht nicht hier, sondern in `mvp_stand_und_abgleich.md` (2026-08-25, Opening-Additiv 2026-09-03/07): Slice gegen Foundation, MVP-Text und Gesamtziel. Dieses Handover bleibt der Konzept-/Interview-Bootstrap.
|
||||
|
||||
**Umgebungswechsel Laptop → Heim/Server (2026-09-07):** nicht hier, sondern `docs/architecture/technical/environment_handover.md` plus `docs/architecture/technical/runtime_and_deploy.md` §7.2. Opening-Invariante (kein Folgetag aus Entry-Prefix): `mvp.md` §6.1.
|
||||
|
||||
Es soll ermöglichen, die Arbeit ohne Rückgriff auf den langen bisherigen Chat fortzusetzen und dabei insbesondere verhindern, dass:
|
||||
|
||||
|
||||
@@ -43,7 +43,7 @@ Nicht durch Fake-Provider bewiesen:
|
||||
|
||||
Kein Codefehler des Freeze Candidate, sondern Betriebsreife:
|
||||
|
||||
- PostgreSQL, Docker/Compose, TLS, Reverse Proxy
|
||||
- PostgreSQL, Docker/Compose, TLS, Reverse Proxy — **nach** SQLite-Restore der Urlaubsdaten (`../technical/environment_handover.md`, `../technical/runtime_and_deploy.md` §7.2)
|
||||
- Gitea-Pipelines / CI
|
||||
- Ollama bzw. lokales Detect-Modell
|
||||
- Verschlüsselung at rest, DSFA, persistentes Audit ohne Prompts
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
title: "Kanshō – Technischer Dokumentationsindex und Context Bundles"
|
||||
version: "0.1"
|
||||
status: "Arbeitsstand"
|
||||
date: "2026-08-19"
|
||||
date: "2026-09-07"
|
||||
product_family: "Jinkendo"
|
||||
document_role: "Documentation Index / Technical Context Loading Guide"
|
||||
parent_document: "technische_zielarchitektur.md"
|
||||
@@ -33,7 +33,8 @@ Fachlich zusätzlich immer bei Querschnittsentscheidungen:
|
||||
| `auth_identity_and_roles.md` | Sessions, Rollen, Admin-Gate |
|
||||
| `frontend_pwa_shell.md` | PWA, Responsive Shell, Navigation |
|
||||
| `backend_and_api.md` | Router, API-First |
|
||||
| `runtime_and_deploy.md` | Migrationen, Compose, Gitea |
|
||||
| `runtime_and_deploy.md` | Migrationen, Compose, Gitea; Transfer Laptop → Heim §7.2 |
|
||||
| `environment_handover.md` | **Session-Handover Umgebungswechsel** (SQLite-Ist, Backup, zwei Wellen, offene Host-Fragen) |
|
||||
| `platform_extensibility.md` | Registry, Prompt-Engine, Konfiguration |
|
||||
| `data_architecture.md` | Persistenzgrenzen, Entitäten |
|
||||
| `memory_storage_and_offline.md` | Dialogspeicher, Sync, Offline |
|
||||
@@ -126,6 +127,18 @@ Kanonisches Home **wie** der Slice gebaut ist: `mvp_implementation.md`. Fachlich
|
||||
4. `privacy_gateway.md` (eigener Egress-Typ)
|
||||
5. fachlich: `../functional/produktvision_und_produktidentitaet.md` §19.4–19.5
|
||||
|
||||
### Umgebungswechsel Laptop → Heim / Server
|
||||
|
||||
1. `environment_handover.md`
|
||||
2. `runtime_and_deploy.md`
|
||||
3. `product_frame_and_stack.md`
|
||||
4. `mvp_implementation.md` §1 und §4
|
||||
5. `../../work_orders/laptop_closeout.md`
|
||||
6. `../../work_orders/home_environment_setup.md`
|
||||
7. fachlich: `../functional/guardrails.md` (Datenklassen beim Kopieren von Backup und `.env`)
|
||||
|
||||
Arbeitsaufträge liegen unter `docs/work_orders/`. Sie ersetzen keine kanonischen Kapitel.
|
||||
|
||||
## 4. Ladeprinzip
|
||||
|
||||
> Root-Dokumente plus 2–4 betroffene Kapitel. Nicht den ganzen technischen und fachlichen Ordner gleichzeitig laden.
|
||||
@@ -134,5 +147,5 @@ Vor Vereinfachungen die Invariantenliste in `technische_zielarchitektur.md` §3.
|
||||
|
||||
## 5. Code-Gerüst
|
||||
|
||||
Lokaler Produktrahmen in `frontend/` und `backend/`. Zusammenhängende technische Umsetzung: `mvp_implementation.md`. Auth, Nutzerverwaltung, Prompt-DB, Platzhalter, Feature-Check, Privacy Gateway. **Dialog-Layer 0:** Conversations/Messages/`usage_sessions`, Thread-/Space-Identität, Derived-Hülle mit Provenance. **MVP-Journal-Slice:** nutzersichtbare Spaces, Journal Days, Dialogzug (ein Call), explizite Draft-Generierung, versionierte Entries (Übernehmen = neue Version, Dirty-Schutz im Editor), Inline-Medien, lokale Stichpunkte ohne Egress, Writing Profile (Hülle mit dynamischen Traits, Initial Profile Build). Fit-Gap: `../functional/mvp_stand_und_abgleich.md` (2026-08-25). Konfigurierbare Prompts `mvp.dialogue_turn`, `mvp.journal_reconstruct`, `mvp.journal_generate`, `mvp.entity_detect`, `mvp.profile_review`. Persönliche Folgestufen konsumieren ein lokal erzeugtes `VerifiedArtifact` (`provenance_verification.md`); der Journal-Adapter setzt die Policy. Journal-Generate: Stufe 1 lokal (`local_source_artifact`), Stufe 2 ein Narrations-Call (Faktentreue, eigenständige Journalprosa, nicht Wortlautkopie). Journalspezifische Ausgabeeinstellungen lokal kompiliert (`journal_generation_policy.py`); Anweisungstexte in `generation_instruction_fragments`, nicht im Code; das ist keine Modelltemperatur. **Additiv 2026-08-29:** Voice-Ausprägungen tragen `style_context_json` (Freigabe von Core/Facet/Traits/Style Examples). Opt-in-Vergleich: `backend/journal_eval.py` (nicht Produktionslauf; Live nur explizit über das Privacy Gateway). Request-scoped Maskierungsmanifest und Pre-Egress: `privacy_gateway.md` §9.4. Semantische Request-Detection und bestätigte Registry: `privacy_gateway.md` §9.5. Provider-URL/Modell/Policy unter Admin → Schnittstellen; Keys nur in `backend/.env`. Schichten: Maskierung, Dialogzug, Journalentwurf, explizite Profile-Review. Admin-Testspur am Dialogzug (Egress, Antwort, Operation). **Additiv 2026-08-28:** opt-in lokale Persistenz unter `/admin/debug` (Default aus, kein Mapping). Privacy-Pfad durchgängig, Security Layer nicht vollständig (`privacy_gateway.md` §9.2). Kein Stripe, keine Threads-UI, kein semantisches Retrieval. SQLite nur lokal.
|
||||
Lokaler Produktrahmen in `frontend/` und `backend/`. Zusammenhängende technische Umsetzung: `mvp_implementation.md`. Auth, Nutzerverwaltung, Prompt-DB, Platzhalter, Feature-Check, Privacy Gateway. **Dialog-Layer 0:** Conversations/Messages/`usage_sessions`, Thread-/Space-Identität, Derived-Hülle mit Provenance. **MVP-Journal-Slice:** nutzersichtbare Spaces, Journal Days, Dialogzug (ein Call), explizite Draft-Generierung, versionierte Entries (Übernehmen = neue Version, Dirty-Schutz im Editor), Inline-Medien, lokale Stichpunkte ohne Egress, Writing Profile (Hülle mit dynamischen Traits, Initial Profile Build). Fit-Gap: `../functional/mvp_stand_und_abgleich.md` (2026-08-25). Konfigurierbare Prompts `mvp.dialogue_turn`, `mvp.journal_reconstruct`, `mvp.journal_generate`, `mvp.entity_detect`, `mvp.profile_review`. Persönliche Folgestufen konsumieren ein lokal erzeugtes `VerifiedArtifact` (`provenance_verification.md`); der Journal-Adapter setzt die Policy. Journal-Generate: Stufe 1 lokal (`local_source_artifact`), Stufe 2 ein Narrations-Call (Faktentreue, eigenständige Journalprosa, nicht Wortlautkopie). Journalspezifische Ausgabeeinstellungen lokal kompiliert (`journal_generation_policy.py`); Anweisungstexte in `generation_instruction_fragments`, nicht im Code; das ist keine Modelltemperatur. **Additiv 2026-08-29:** Voice-Ausprägungen tragen `style_context_json` (Freigabe von Core/Facet/Traits/Style Examples). Opt-in-Vergleich: `backend/journal_eval.py` (nicht Produktionslauf; Live nur explizit über das Privacy Gateway). Request-scoped Maskierungsmanifest und Pre-Egress: `privacy_gateway.md` §9.4. Semantische Request-Detection und bestätigte Registry: `privacy_gateway.md` §9.5. Provider-URL/Modell/Policy unter Admin → Schnittstellen; Keys nur in `backend/.env`. Schichten: Maskierung, Dialogzug, Journalentwurf, explizite Profile-Review. Admin-Testspur am Dialogzug (Egress, Antwort, Operation). **Additiv 2026-08-28:** opt-in lokale Persistenz unter `/admin/debug` (Default aus, kein Mapping). Privacy-Pfad durchgängig, Security Layer nicht vollständig (`privacy_gateway.md` §9.2). Kein Stripe, keine Threads-UI, kein semantisches Retrieval. SQLite nur lokal. **Additiv 2026-09-07:** Umgebungswechsel der Urlaubsinstanz: `environment_handover.md`.
|
||||
|
||||
@@ -0,0 +1,213 @@
|
||||
---
|
||||
title: "Kanshō – Handover Laptop-Instanz → Heim-Entwicklung und Server"
|
||||
status: "Aktiver Übergabestand"
|
||||
date: "2026-09-07"
|
||||
product_family: "Jinkendo"
|
||||
document_role: "Session Handover / Environment Transfer / Implementation Bootstrap"
|
||||
parent_document: "runtime_and_deploy.md"
|
||||
canonical_concept_handover: "docs/architecture/functional/handover.md"
|
||||
---
|
||||
|
||||
# Kanshō – Handover: Laptop-Urlaubsinstanz → normale Entwicklung und Server
|
||||
|
||||
Dieses Dokument ist der **technische Aufsatzpunkt** für den Umgebungswechsel. Es ersetzt weder `runtime_and_deploy.md` noch das fachliche Konzept-Handover `../functional/handover.md`.
|
||||
|
||||
**Stand:** 2026-09-07, erstellt auf dem Urlaubs-Laptop unter `C:\dev\Kansho`.
|
||||
|
||||
Ziel: Code, Dokumentation und persönliche Testdaten so übergeben, dass zu Hause weiterentwickelt und später auf Docker/PostgreSQL umgestellt werden kann, ohne die Urlaubsdaten zu verlieren.
|
||||
|
||||
---
|
||||
|
||||
## 1. Leitentscheidung für den Transfer
|
||||
|
||||
**Zwei Wellen, nicht eine.**
|
||||
|
||||
| Welle | Was | Warum |
|
||||
|---|---|---|
|
||||
| **1. Kontinuität** | Gitea-Stand klonen, lokale SQLite-Instanz wie bisher, Backup wiederherstellen, Dialog-/Journalqualität prüfen | Der gebaute Slice ist SQLite. Die persönlichen Daten liegen in `backend/data/`. Postgres ist Ziel, nicht Ist. |
|
||||
| **2. Betriebsrahmen** | Docker Compose, eigenes Postgres, Deploy-Muster analog Mitai, Gitea-Runner | Entschiedenes Ziel in `product_frame_and_stack.md`. Nicht im selben Schritt wie der erste Daten-Restore. |
|
||||
|
||||
Ein SQLite-Restore auf dem Heimrechner **vor** der Postgres-Migration ist die Restore-Übung, die `runtime_and_deploy.md` §7 Punkt 3 verlangt. Erst wenn Welle 1 grün ist, wird der Slice auf Compose/Postgres gehoben.
|
||||
|
||||
Nicht tun: Urlaubs-SQLite in ein noch nicht existierendes Postgres-Schema laden, während uncommitteter Code nur auf dem Laptop liegt.
|
||||
|
||||
---
|
||||
|
||||
## 2. Ist-Stand der Laptop-Instanz (2026-09-07)
|
||||
|
||||
### 2.1 Laufzeit
|
||||
|
||||
| Element | Ist |
|
||||
|---|---|
|
||||
| Host | Windows-Laptop, Pfad `C:\dev\Kansho` |
|
||||
| Start | ohne Docker: Uvicorn **8018**, Vite **5188** (`strictPort`) |
|
||||
| Persistenz | SQLite `backend/data/kansho.sqlite` (~11,3 MB) |
|
||||
| Medien | `backend/data/media/<profile_id>/` (70 Dateien, ~8,9 MB Nutzlast; zwei große JPEGs, viele Mini-WebM/PNG) |
|
||||
| Secrets | `backend/.env` (nicht im Git, nicht im Backup-Archiv) |
|
||||
| Python | 3.12, venv `backend/.venv` |
|
||||
| Remote | `https://gitea.stommer.de/Lars/Kansho.git` |
|
||||
|
||||
### 2.2 Git
|
||||
|
||||
| Element | Ist |
|
||||
|---|---|
|
||||
| Branch | `main` |
|
||||
| HEAD | `e42f751` Message `MVP 1.0` |
|
||||
| Remote | `origin/main` ist **einen Commit hinter** HEAD (`ahead 1`) |
|
||||
| `develop` | existiert **nicht** (Familienmuster Dev=`develop` / Prod=`main` ist entschieden, aber noch nicht angelegt) |
|
||||
|
||||
Uncommittet (muss vor dem Verlassen des Laptops nach Gitea):
|
||||
|
||||
- Opening-Fix: `backend/journal_opening.py`, `context_builder.py`, `retrieval.py`, `tests/test_journal_opening.py`
|
||||
- Opening-Doku: `mvp.md` §6.1, `mvp_implementation.md` §17, `mvp_stand_und_abgleich.md` (Tabellen 5.4, §6.4, §7, Dateikarte), `memory_storage_and_offline.md` §6.2
|
||||
- Invariante: Vorhaben nur aus dem **user-Dialog des vorigen Kalendertags**; gespeicherte Journal-Entries sind kein Opening-Mandat; Opening-Call ohne Space-Recency. Fehlerbild: Nachsatz mit Morgenuhrzeit + 400-Zeichen-Prefix. Tests 2026-09-03/07 lokal grün.
|
||||
- Transfer-Doku und Work Orders (siehe unten)
|
||||
|
||||
Bewusst **nicht** in diesem Transfer schließen: Prefix-Recency im laufenden `dialogue_turn`.
|
||||
|
||||
Unversioniert (gehören in denselben oder einen Dokumentations-Commit):
|
||||
|
||||
- `docs/architecture/functional/Idea_seconmd_sclide.md` (Konzeptbrief Slice 2, Dateiname mit Tippfehler)
|
||||
- `docs/work_orders/` (Debug-Diagnostik, Dialog/Memory-Slice, Laptop-Abschluss, Heim-Setup)
|
||||
- dieses Handover und die Runtime-Ergänzungen
|
||||
|
||||
Nicht in Git und **nicht** ins Backup: `backend/.env`.
|
||||
|
||||
### 2.3 Persönlicher Datenbestand (Inventar, kein Inhalt)
|
||||
|
||||
Ein Admin-Profil seit 2026-08-19. Zwei Spaces: `Kroatien 2026` (Urlaubsjournal) und `Test für Prosagenerierung`. 17 Journal Days, 17 Current-Entries, 20 Conversations, 379 Messages, Writing Profile vorhanden, Identity-Mappings lokal, Debug-Runs opt-in persistiert.
|
||||
|
||||
Das ist **Klasse-A/B-Material**. Es darf nicht nach Gitea, nicht an Provider, nicht unverschlüsselt in die Cloud.
|
||||
|
||||
### 2.4 Backup dieser Session
|
||||
|
||||
Erzeugt: `local-backups/kansho-20260907-055703.zip` (gitignoriert).
|
||||
|
||||
Enthält SQLite (Backup-API) + 70 Mediendateien + Manifest/Checksummen. Enthält **keine** `.env` und keine Keys. Das Archiv ist **unverschlüsselt** und persönlich.
|
||||
|
||||
Vor dem Abschalten des Laptops: Archiv auf verschlüsselten USB-Stick, NAS-Share oder den Heimrechner kopieren. Zweite Kopie getrennt halten. Nicht committen.
|
||||
|
||||
---
|
||||
|
||||
## 3. Was auf dem Laptop noch zu tun ist
|
||||
|
||||
Siehe Arbeitsauftrag `../../work_orders/laptop_closeout.md`.
|
||||
|
||||
Kurz:
|
||||
|
||||
1. Opening-Fix und diese Dokumentation committen und nach Gitea pushen.
|
||||
2. Backup-Archiv und `.env` **getrennt** physisch mitnehmen.
|
||||
3. Backend beenden, keine weiteren Dialoge mehr als „führende Instanz“ führen, sobald Welle 1 zu Hause bestätigt ist.
|
||||
4. Slice-2-Konzept, Debug-Export und Memory-Slice **nicht** auf dem Laptop zu Ende bauen.
|
||||
|
||||
---
|
||||
|
||||
## 4. Offene Cursor-Sessions (Laptop)
|
||||
|
||||
Diese Sessions sind Kontext, keine zweite Source of Truth. Kanonisch bleiben die Repository-Dateien.
|
||||
|
||||
| Session | Thema | Status für den Transfer |
|
||||
|---|---|---|
|
||||
| [Opening-Impuls](d5e159cf-4d3c-4069-95f9-123a5500b1da) | Erster Impuls zog abgeschlossene Vortage / 400-Zeichen-Entry-Prefix | **Code und kanonische Doku fertig (2026-09-07).** Invariante in `mvp.md` §6.1, Fit-Gap §6.4, `mvp_implementation.md` §17. Bewusst offen: Prefix-Recency im laufenden Dialogzug. Persönliche Dialoginhalte nicht in Doku. |
|
||||
| Diese Session | Umgebungswechsel | **Laptop-pflichtig.** Handover und Work Orders angelegt; kanonische Opening-Doku nachgezogen. Commit/Push und physisches Backup bleiben die Abnahme. |
|
||||
| `docs/work_orders/debug_diagnostics_perfection.md` | Zentraler Admin-Export | **Verschieben.** Kein Laptop-Zwang. |
|
||||
| `docs/work_orders/dialogue_memory_next_slice_handover.md` | Dialog + Langzeitgedächtnis | **Verschieben.** Konzept/Fit-Gap, keine Implementierung auf dem Laptop. |
|
||||
| `docs/architecture/functional/Idea_seconmd_sclide.md` | Fachlicher Slice-2-Brief | **Verschieben.** Keine Dateien ändern, bis eine Konzept-Session ihn abarbeitet. |
|
||||
| Ältere MVP-Sessions (Freeze, Editorial, Policy, Debug-Persistenz, Writing Style) | Journal-MVP 1.0 | **Abgeschlossen** im Commit `e42f751`, sofern nach Gitea gepusht. |
|
||||
|
||||
Ältere Transcripts lokal unter Cursor; sie müssen nicht migriert werden, wenn Gitea den Code-Stand trägt.
|
||||
|
||||
---
|
||||
|
||||
## 5. Welle 1 – Heim-Entwicklung mit SQLite
|
||||
|
||||
Auftrag: `../../work_orders/home_environment_setup.md` Phase A.
|
||||
|
||||
1. Auf dem Heimrechner (erwarteter Pfad analog `C:\dev\Kansho` oder später Linux-Checkout) `git clone https://gitea.stommer.de/Lars/Kansho.git`.
|
||||
2. `.\scripts\dev-setup.ps1` (Windows) bzw. venv + `npm install`.
|
||||
3. `backend/.env` aus der **separaten** Secret-Kopie anlegen, nicht aus dem Backup.
|
||||
4. Backend **nicht** mit Produktionsdaten starten, bevor das Restore-Ziel leer oder bewusst überschrieben wird.
|
||||
5. Restore: `.\scripts\backup-local.ps1 restore -Archive <pfad>\kansho-20260907-055703.zip -Confirm -Replace`.
|
||||
6. Start: Backend 8018, Frontend 5188. Login mit dem bestehenden Admin-Konto (Passwort-Hash steckt in der SQLite, nicht in `.env`).
|
||||
7. Smoke: Space `Kroatien 2026` sichtbar, Journal Days vorhanden, ein Entry mit Medien, ein Dialogzug fail-closed ohne Key und mit Key über Gateway, Health `GET /api/health`.
|
||||
8. `.\scripts\test-mvp.ps1` (isolierte Temp-DB, ändert die Restoredaten nicht).
|
||||
|
||||
Erst wenn das gilt, ist der Laptop nicht mehr führend.
|
||||
|
||||
---
|
||||
|
||||
## 6. Welle 2 – Docker, Postgres, Server
|
||||
|
||||
Auftrag: `../../work_orders/home_environment_setup.md` Phase B–C.
|
||||
|
||||
Mitai-Referenz auf dem Heimrechner: `C:\dev\mitai` (Compose, `.gitea/workflows/`, Hostpfade `/home/lars/docker/bodytrack` und `bodytrack-dev`).
|
||||
|
||||
**Noch nicht im Kanshō-Repo:** Dockerfiles, Compose, Gitea-Workflows, Postgres-Adapter. `backend/db.py` ist SQLite (`sqlite3`, `PRAGMA`, `datetime('now')`). Das ist eine eigene Implementierungsarbeit, kein Copy-Paste von Mitai-Fachlogik.
|
||||
|
||||
Entschieden (nicht neu verhandeln):
|
||||
|
||||
- Docker Compose: Frontend, Backend, PostgreSQL 16
|
||||
- Branches: `develop` → Dev, `main` → Prod
|
||||
- Secrets nur in Server-`.env`
|
||||
- Persönlicher LLM-Egress nur über Privacy Gateway
|
||||
- Kein Auto-Rollback der Datenbank
|
||||
- Kanshō-Ports **nicht** Mitai `3002`/`8002`/`3099`/`8099` kopieren
|
||||
|
||||
Offen, vor Compose festlegen:
|
||||
|
||||
1. Läuft Kanshō auf demselben Pi wie Mitai, als **eigenes** Compose-Projekt?
|
||||
2. Eigenes Postgres (bevorzugte Richtung: ja, eigene Instanz/DB `kansho`, kein Shared-Schema mit Mitai)?
|
||||
3. Dev-Domain / Prod-Domain / Host-Pfade (Hypothese: `dev.kansho.jinkendo.de` / `kansho.jinkendo.de`)?
|
||||
4. Dev-Ports auf dem Pi, lokal bleiben 5188/8018 für den Windows-Checkout ohne Docker.
|
||||
5. Ob Welle 2 zuerst Compose **mit SQLite-Volume** als Zwischenstand nutzt oder direkt Postgres + Migrationsadapter.
|
||||
|
||||
Empfohlene Reihenfolge in Welle 2:
|
||||
|
||||
1. Offene Host-Fragen beantworten und in `runtime_and_deploy.md` §1/§6 eintragen.
|
||||
2. `develop` anlegen, sobald Auto-Deploy gewünscht ist; bis dahin darf `main` der einzige Branch bleiben.
|
||||
3. Compose-Gerüst analog Mitai, **eigene** Container-/Volumen-/Projektnamen (`kansho-*`, keine `bodytrack/`-Pfade).
|
||||
4. Backend-Start: Postgres ready → nummerierte SQL-Migrationen → App. Fail-fast.
|
||||
5. Datenübernahme SQLite → Postgres als **eigenes** Migrationsskript mit Probe-Restore, nicht still im Alltagspfad.
|
||||
6. Gitea-Workflows erst, wenn Runner-Pfade existieren (`runtime_and_deploy.md` §4).
|
||||
7. Watchtower später prüfen, nicht in diesem Transfer.
|
||||
|
||||
---
|
||||
|
||||
## 7. Datenschutz beim Transfer
|
||||
|
||||
- Backup und `.env` nie in Git, nie in Chat-Uploads, nie an OpenRouter.
|
||||
- Identity-Mappings bleiben lokal (Klasse A).
|
||||
- Das Zip ist Klartext-Journal. Transport verschlüsseln (BitLocker-Stick, verschlüsseltes NAS, `age`/`gpg` nach Wahl).
|
||||
- Nach erfolgreichem Heim-Restore Laptop-Kopie als Archive behalten, nicht parallel weiterschreiben.
|
||||
- Debug-Traces in der DB können Prompt-Ausschnitte enthalten; sie reisen im Backup mit. Auf dem Server den Schalter `debug.persist_traces` prüfen.
|
||||
|
||||
---
|
||||
|
||||
## 8. Bewusst nicht Teil dieses Transfers
|
||||
|
||||
- Slice 2 / Memory-Continuity implementieren
|
||||
- Zentralen Debug-Export umbauen
|
||||
- Voice, semantisches Retrieval, Self Model
|
||||
- Mitai-Verzeichnisnamen, Mitai-Ports, Shared-Postgres-Schema
|
||||
- Fachliche Produktentscheidungen aus dem Konzept-Handover
|
||||
|
||||
---
|
||||
|
||||
## 9. Nächster Arbeitsschritt
|
||||
|
||||
1. Auf dem Laptop: `laptop_closeout.md` abschließen (Commit/Push, Backup kopieren).
|
||||
2. Zu Hause: neue Session mit diesem Dokument plus `runtime_and_deploy.md` und `home_environment_setup.md`.
|
||||
3. Welle 1 bis Restore-Abnahme.
|
||||
4. Erst dann Welle 2.
|
||||
|
||||
---
|
||||
|
||||
## 10. Querverweise
|
||||
|
||||
- Runtime: `runtime_and_deploy.md`
|
||||
- Stack: `product_frame_and_stack.md`
|
||||
- SQLite-Ist: `mvp_implementation.md` §1 und §4
|
||||
- Fachliches Session-Handover: `../functional/handover.md`
|
||||
- Laptop-Abschluss: `../../work_orders/laptop_closeout.md`
|
||||
- Heim-Setup: `../../work_orders/home_environment_setup.md`
|
||||
- Mitai: `C:\dev\mitai\docker-compose.yml`, `docker-compose.dev.yml`, `.gitea/workflows/`
|
||||
@@ -2,7 +2,7 @@
|
||||
title: "Kanshō – Runtime, Migrationen und Deploy"
|
||||
version: "0.1"
|
||||
status: "Arbeitsstand"
|
||||
date: "2026-08-19"
|
||||
date: "2026-09-07"
|
||||
product_family: "Jinkendo"
|
||||
document_role: "Technical Chapter / Runtime / Deploy / Migrations"
|
||||
parent_document: "technische_zielarchitektur.md"
|
||||
@@ -89,12 +89,14 @@ Kanshō-Repo liegt bereits auf Gitea (`Lars/Kansho`). HTTPS-Push ist eingerichte
|
||||
| Ports/Domains/Hostpfade | Prod offen; lokal Frontend 5188 / Backend 8018 | lokal festgelegt, Prod offen |
|
||||
| Gitea Workflows | Mitai-Muster | bevorzugte Richtung |
|
||||
| Auto-Rollback | nein | verworfen |
|
||||
| Urlaubs-Laptop ohne Docker/SQLite | Ist bis Transfer Welle 1 | dokumentiert 2026-09-07 |
|
||||
| Transfer vor Postgres | SQLite-Restore auf dem Heimrechner zuerst | entschieden als Reihenfolge |
|
||||
|
||||
## 7. Offene Fragen
|
||||
|
||||
1. Läuft Kanshō auf demselben Raspberry-Pi-Host wie Mitai, mit eigenen Compose-Projekten?
|
||||
2. Gemeinsames oder separates Postgres?
|
||||
3. Backup-Rhythmus und Restore-Übung vor erstem persönlichen Dialogdatenbestand.
|
||||
3. Backup-Rhythmus und Restore-Übung vor erstem persönlichen Dialogdatenbestand. Die Urlaubs-SQLite-Restore auf dem Heimrechner (Welle 1) ist diese Übung für den bestehenden Datenbestand; Produktions-Backup für Postgres bleibt offen.
|
||||
|
||||
### 7.1 Lokales Backup für die Urlaubs-Testphase (2026-08-25)
|
||||
|
||||
@@ -105,8 +107,20 @@ Kein Ersatz für Produktions-Backup, Docker oder Verschlüsselung.
|
||||
- Wiederherstellen: `.\scripts\backup-local.ps1 restore -Archive <pfad> -Confirm`; bestehender Stand nur mit `--replace` nach automatischem Sicherheitsbackup
|
||||
- SQLite-Backup-API, Journalmedien, Manifest mit Checksummen. Keine `.env` oder Keys. Das Archiv kann persönliche unverschlüsselte Daten enthalten.
|
||||
|
||||
### 7.2 Transfer Laptop → Heim-Entwicklung und Server (2026-09-07)
|
||||
|
||||
Die Urlaubsinstanz lief ohne Docker auf SQLite (`backend/data/kansho.sqlite`, Ports 5188/8018). Persönliche Dialog- und Journaldaten liegen nicht in Gitea.
|
||||
|
||||
**Reihenfolge entschieden:** zuerst Kontinuität (Clone + SQLite-Restore + Smoke), danach Betriebsrahmen (Compose, Postgres 16, Gitea-Runner). Postgres bleibt Ziel; `backend/db.py` ist weiterhin SQLite. Ein direkter Sprung „Laptop-SQLite nach Prod-Postgres“ ohne Zwischen-Restore ist verworfen.
|
||||
|
||||
Kanonisches Session-Handover: `environment_handover.md`. Aufträge: `../../work_orders/laptop_closeout.md`, `../../work_orders/home_environment_setup.md`.
|
||||
|
||||
Laptop-Backup dieser Session: `local-backups/kansho-20260907-055703.zip` (nur lokal, gitignoriert). `.env` reist getrennt.
|
||||
|
||||
Noch nicht im Repository: Dockerfiles, Compose, `.gitea/workflows/`, Postgres-Adapter. Mitai unter `C:\dev\mitai` bleibt Muster, nicht Quelle für Ports oder `bodytrack/`-Pfade.
|
||||
|
||||
## 8. Querverweise
|
||||
|
||||
- Technisch: `product_frame_and_stack.md`, `security.md`
|
||||
- Technisch: `product_frame_and_stack.md`, `security.md`, `environment_handover.md`, `mvp_implementation.md` §1
|
||||
- Fachlich: Offline und Sync bleiben `memory_storage_and_offline.md`; Deploy löst Offline nicht.
|
||||
- Mitai: `MIGRATIONS.md`, `.gitea/workflows/`
|
||||
Reference in new issue
Block a user