118 lines
4.1 KiB
Markdown
118 lines
4.1 KiB
Markdown
|
---
|
|||
|
|
title: "Kanshō – Technischer Dokumentationsindex und Context Bundles"
|
|||
|
|
version: "0.1"
|
|||
|
|
status: "Arbeitsstand"
|
|||
|
|
date: "2026-08-19"
|
|||
|
|
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.
|
|||
|
|
|
|||
|
|
## 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 |
|
|||
|
|
| `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 |
|
|||
|
|
| `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 |
|
|||
|
|
|
|||
|
|
## 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. `security.md`
|
|||
|
|
6. fachlich: `../functional/guardrails.md`
|
|||
|
|
7. 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)
|
|||
|
|
|
|||
|
|
### 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
|
|||
|
|
|
|||
|
|
## 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/`. Auth, Nutzerverwaltung, Prompt-DB, Platzhalter, Feature-Check, Privacy-Gateway-Stub. **Dialog-Layer 0:** Conversations/Messages/`usage_sessions`, Thread-/Space-Identität, Derived-Hülle mit Provenance. Keine Dialog-IA, keine Domain-Prompts, kein Stripe. SQLite nur lokal.
|
|||
|
|
|