Kansho/docs/architecture/technical/documentation_index.md

title	version	status	date	product_family	document_role	parent_document
Kanshō – Technischer Dokumentationsindex und Context Bundles	0.1	Arbeitsstand	2026-09-07	Jinkendo	Documentation Index / Technical Context Loading Guide	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.