Kansho/docs/architecture/technical/documentation_index.md

4.1 KiB
Raw Blame History

title version status date product_family document_role parent_document
Kanshō Technischer Dokumentationsindex und Context Bundles 0.1 Arbeitsstand 2026-08-19 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.

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.419.5

4. Ladeprinzip

Root-Dokumente plus 24 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.