diff --git a/docs/05_Development/05_developer_guide.md b/docs/05_Development/05_developer_guide.md index 609ad61..1bdcc87 100644 --- a/docs/05_Development/05_developer_guide.md +++ b/docs/05_Development/05_developer_guide.md @@ -14,7 +14,43 @@ context: "Umfassender Guide für Entwickler: Architektur, Modul-Interna (Deep Di Dieser Guide ist die zentrale technische Referenz für Mindnet v2.6. Er vereint das technische Verständnis der Module mit dem operativen Workflow zwischen Windows (Dev) und Linux (Runtime). --- +# Inhaltsverzeichnis +- [Mindnet Developer Guide \& Workflow](#mindnet-developer-guide--workflow) +- [Inhaltsverzeichnis](#inhaltsverzeichnis) + - [1. Einführung \& Systemüberblick](#1-einführung--systemüberblick) + - [Was ist Mindnet?](#was-ist-mindnet) + - [Kern-Philosophie](#kern-philosophie) + - [2. Architektur](#2-architektur) + - [2.1 High-Level Übersicht](#21-high-level-übersicht) + - [2.2 Datenfluss-Muster](#22-datenfluss-muster) + - [A. Ingestion (Write)](#a-ingestion-write) + - [B. Retrieval (Read)](#b-retrieval-read) + - [C. Visualisierung (Graph)](#c-visualisierung-graph) + - [3. Physische Architektur](#3-physische-architektur) + - [4. Projektstruktur \& Modul-Referenz (Deep Dive)](#4-projektstruktur--modul-referenz-deep-dive) + - [4.1 Verzeichnisbaum](#41-verzeichnisbaum) + - [4.2 Frontend Architecture (`app/frontend/`)](#42-frontend-architecture-appfrontend) + - [Frontend Design Patterns (Wichtig!)](#frontend-design-patterns-wichtig) + - [4.3 Backend Architecture (`app/`)](#43-backend-architecture-app) + - [4.4 Scripts \& Tooling (Die Admin-Toolbox)](#44-scripts--tooling-die-admin-toolbox) + - [1. Script-Übersicht](#1-script-übersicht) + - [2. Einsatzszenarien \& Bewertung](#2-einsatzszenarien--bewertung) + - [🟢 Essentiell für den Betrieb (Must-Have)](#-essentiell-für-den-betrieb-must-have) + - [🟡 Hilfreich für Entwicklung \& Debugging (Should-Have)](#-hilfreich-für-entwicklung--debugging-should-have) + - [🔵 Wartung \& Spezialfälle (Nice-to-Have)](#-wartung--spezialfälle-nice-to-have) + - [5. Maintenance \& "Kill List"](#5-maintenance--kill-list) + - [6. Lokales Setup (Development)](#6-lokales-setup-development) + - [7. Der Entwicklungs-Zyklus (Workflow)](#7-der-entwicklungs-zyklus-workflow) + - [Phase 1: Windows (Code)](#phase-1-windows-code) + - [Phase 2: Beelink (Test / Dev)](#phase-2-beelink-test--dev) + - [Phase 3: Release \& Deployment (Prod)](#phase-3-release--deployment-prod) + - [8. Erweiterungs-Guide: "Teach-the-AI"](#8-erweiterungs-guide-teach-the-ai) + - [Workflow A: Neuen Typ implementieren (z. B. `type: risk`)](#workflow-a-neuen-typ-implementieren-z-b-type-risk) + - [Workflow B: Graph-Farben ändern](#workflow-b-graph-farben-ändern) + - [9. Tests \& Debugging](#9-tests--debugging) + - [10. Troubleshooting \& One-Liners](#10-troubleshooting--one-liners) +--- ## 1. Einführung & Systemüberblick ### Was ist Mindnet?