Kansho/docs/architecture/technical/documentation_index.md

---
title: "Kanshō – Technischer Dokumentationsindex und Context Bundles"
version: "0.1"
status: "Arbeitsstand"
date: "2026-09-07"
product_family: "Jinkendo"
document_role: "Documentation Index / Technical Context Loading Guide"
parent_document: "technische_zielarchitektur.md"
---
# Kanshō – Technischer Dokumentationsindex

Für technische Arbeit nur die benötigten Dateien laden. Fachliche Homes nicht durch technische Kurzfassungen ersetzen. Dialog-/MVP-Stand nicht als final behandeln. **Datenschutz und Guardrails** (`../functional/guardrails.md`) sind verbindliche Invariante. Mitai-Produktrahmen weitgehend übernehmen, Gateway nicht umgehen.

**Technische Umsetzung (kanonisches Home):** `mvp_implementation.md`. **Fit-Gap-Analyse (fachlich):** `../functional/mvp_stand_und_abgleich.md` (2026-08-25). Technische Kapitel enthalten lokale Implementierungsstände; sie ersetzen weder die Umsetzungsbeschreibung noch die Fit-Gap-Analyse.

## 1. Root-Dokumente

Technisch:

- `technische_zielarchitektur.md` – Governance, Stack, Kapitelkarte, Entscheidungsstand.
- `documentation_index.md` – dieser Index.

Fachlich zusätzlich immer bei Querschnittsentscheidungen:

- `../functional/fachliche_zielarchitektur.md`
- `../functional/produktvision_und_produktidentitaet.md`

## 2. Technische Kapitel

| Datei | Kanonisches Thema |
|---|---|
| `product_frame_and_stack.md` | 3-Tier, Stack, Mitai-Übernahme |
| `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; 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 |
| `privacy_gateway.md` | Trust Zones, Egress, Demasking |
| `provenance_verification.md` | Intent-neutrale Provenienz- und Verifikationsschicht, `VerifiedArtifact` |
| `ai_architecture.md` | Inferenzpfad, Agenten |
| `integrations_technical.md` | Technische Handoffs |
| `admin_diagnostics.md` | Diagnoseansicht |
| `voice_and_media.md` | Sprache und Transkription |
| `security.md` | Security-Baseline |
| `mvp_implementation.md` | **Kanonisches Home der technischen MVP-Umsetzung** (Laufzeit, Module, Daten, API, Pfade; Profile-Analyse Export/Import §15). Fit-Gap bleibt fachlich. Freeze Candidate: `../functional/mvp_freeze_candidate.md`. |

## 3. Empfohlene Context Bundles

### Produktrahmen / erste Shell

1. `technische_zielarchitektur.md`
2. `product_frame_and_stack.md`
3. `auth_identity_and_roles.md`
4. `frontend_pwa_shell.md`
5. `backend_and_api.md`
6. `runtime_and_deploy.md`
7. `platform_extensibility.md`
8. fachlich: `../functional/produktvision_und_produktidentitaet.md` §19 und §21

### Produktrahmen / Erweiterung

1. `technische_zielarchitektur.md`
2. `platform_extensibility.md`
3. `privacy_gateway.md`
4. `ai_architecture.md`
5. `backend_and_api.md`
6. `admin_diagnostics.md`

### Privacy / externe KI

1. `technische_zielarchitektur.md`
2. `privacy_gateway.md`
3. `platform_extensibility.md`
4. `ai_architecture.md`
5. `provenance_verification.md`
6. `security.md`
7. fachlich: `../functional/guardrails.md`
8. bei Bedarf: `../functional/self_model_and_lived_experience.md`, `../functional/memory_and_context.md`

### Dialogspeicher / Memory / Offline

1. `data_architecture.md`
2. `memory_storage_and_offline.md`
3. fachlich: `../functional/memory_and_context.md`
4. `../functional/context_fidelity_and_regrounding.md`
5. `../functional/reflection_outputs.md`
6. `../functional/resurfacing_and_saturation.md`

### Integrationen

1. `integrations_technical.md`
2. fachlich: `../functional/integrations.md`
3. `../functional/reflection_outputs.md`
4. das betroffene Fachkapitel (Kairo, mindnet, Mitai, Shinkan)

### Admin / Diagnose

1. `admin_diagnostics.md`
2. `auth_identity_and_roles.md`
3. fachlich: `../functional/fachliche_zielarchitektur.md` §2.7
4. `../functional/reflection_spaces.md` (Admin-/Developer View)

### MVP-Journal-Slice / technische Umsetzung

Kanonisches Home **wie** der Slice gebaut ist: `mvp_implementation.md`. Fachliches Fit-Gap-Home bleibt `../functional/mvp_stand_und_abgleich.md`.

1. `mvp_implementation.md`
2. `provenance_verification.md`
3. `memory_storage_and_offline.md` §6.2
4. `backend_and_api.md` §5.1
5. `privacy_gateway.md` §9.1–9.2
6. `frontend_pwa_shell.md` §6.1
7. fachlich: `../functional/mvp.md`
8. `../functional/implementation_foundation.md`
9. `../functional/mvp_stand_und_abgleich.md`
10. bei Gegenlesung gegen das Gesamtziel: `../functional/produktvision_und_produktidentitaet.md`
11. bei Bedarf: `../functional/writing_profile_and_journaling.md`, `../functional/guardrails.md`, `../functional/mvp_freeze_candidate.md`

### Voice / PWA-Offline

1. `frontend_pwa_shell.md`
2. `voice_and_media.md`
3. `memory_storage_and_offline.md`
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. Betrieb auf dem Pi: `docs/DEPLOYMENT.md`.

## 4. Ladeprinzip

> Root-Dokumente plus 2–4 betroffene Kapitel. Nicht den ganzen technischen und fachlichen Ordner gleichzeitig laden.

Vor Vereinfachungen die Invariantenliste in `technische_zielarchitektur.md` §3.6 prüfen.

## 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. **Additiv 2026-09-07:** Umgebungswechsel der Urlaubsinstanz: `environment_handover.md`.