Update .gitignore to exclude Python-related files and directories. Enhance AGENTS.md and README.md with clarifications on documentation structure and product identity. Add technical architecture references and local setup instructions. Revise privacy guardrails and product identity documents for consistency. Remove obsolete memory and context documentation. Expand reflection spaces documentation to define context boundaries and lifecycle. Ensure all changes align with the ongoing development of the Kanshō project.
This commit is contained in:
1 parent
3a367b7bcc
commit
d62673e48b
89 files changed
+13463
-241
No files matched your search
@@ -0,0 +1,117 @@
|
||||
---
|
||||
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.
|
||||
|
||||
Reference in new issue
Block a user