Kansho/README.md

# Kanshō

Persönlicher KI-Reflexionsbegleiter innerhalb der Jinkendo-Produktfamilie.

> Wahrnehmen → Reflektieren → Verstehen → Einordnen

Kanshō ist **kein** Tagebuch mit KI, keine Meditations-App und kein generischer Chatbot. Die Produktidentität ist ein langfristiger, dialogischer Reflexionsbegleiter. Journaling, Achtsamkeit und Meditation sind Werkzeuge, nicht der Kern.

## Aktueller Stand

Fachliche Konzeption und technische Rahmenarchitektur plus ein **lokales Produktrahmen-Gerüst** (`frontend/`, `backend/`). Das Gerüst ist Auth, PWA-Shell und Privacy-Gateway-Stub – noch kein Reflexions-MVP.

| Bereich | Stand |
|---|---|
| Produktidentität | entschieden: Personal Reflection Companion |
| Technische Form | entschieden: PWA, Mobile First, Offline, Transkription |
| Fachliche Doku | Baseline in `docs/architecture/functional/` |
| Technische Doku | vorläufiger Rahmen in `docs/architecture/technical/` |
| App | lokaler Produktrahmen, Fachkonzept nicht eingefroren |

Remote: [gitea.stommer.de/Lars/Kansho](https://gitea.stommer.de/Lars/Kansho.git)

## Dokumentation zuerst laden

Nicht alle Kapitel gleichzeitig in den Kontext ziehen. Der Index beschreibt sinnvolle Bundles:

- `docs/architecture/functional/documentation_index.md`
- `docs/architecture/technical/documentation_index.md`

Führende Root-Dokumente:

1. `docs/architecture/functional/fachliche_zielarchitektur.md`
2. `docs/architecture/functional/produktvision_und_produktidentitaet.md`
3. `docs/architecture/functional/interview_plan.md`
4. `docs/architecture/technical/technische_zielarchitektur.md`

Nächster Konzeptblock: Abschluss und Outputs der **Tagesreflexion** (siehe Interviewplan).

## Lokal starten

Ohne Docker. SQLite lokal, PostgreSQL bleibt das spätere Ziel. Python 3.12 unter `%LOCALAPPDATA%\Programs\Python\Python312\python.exe`, falls der Store-Alias `python` stört.

```powershell
# einmalig
.\scripts\dev-setup.ps1

# Terminal 1
cd backend
.\.venv\Scripts\python -m uvicorn main:app --reload --port 8018

# Terminal 2
cd frontend
npm run dev
```

Kanshō nutzt eigene lokale Ports, nicht die Vite-/FastAPI-Defaults: Frontend **5188**, Backend **8018** (`strictPort`, kein Ausweichen auf 5173/5174). Dann http://localhost:5188 – erster Start legt das Admin-Profil an. Frame-Test:

```powershell
cd backend
.\.venv\Scripts\python tests\test_frame.py
```

## Lokal weiterarbeiten

```powershell
git pull
```

Änderungen nach Gitea:

```powershell
git add .
git commit -m "Kurze Begründung, warum die Änderung nötig ist"
git push
```

## Cursor / Vibe Coding

Projektregeln liegen in `.cursor/rules/` und in `AGENTS.md`. Sie halten Produktgrenzen, Dokumentationsprinzipien und Privacy-Guardrails im Agenten-Kontext.

Der Produktrahmen (React/Vite-PWA, FastAPI, PostgreSQL, Mitai-Auth- und Shell-Muster) ist in der technischen Zielarchitektur festgehalten und darf weitgehend von Mitai kopiert werden. Der fachliche Konzeptionsstand ist nicht final. Weiterhin nicht stillschweigend festlegen:

- Kanshō-Start-IA, Dialog- und Memory-Schemas
- Offline-Sync und konkrete Ports/Domains
- AI-Agentenzerlegung, Integrationsverträge, MVP-Schnitt