feat: Fix vector indexing stability, add Gitea linking, enhance admin dashboard

HANDBUCH.md

@@ -52,7 +52,38 @@ Crumbforest ist mehr als Software – es ist eine Philosophie:
 
 ---
 
-## 🏗️ System-Architektur
+## <EFBFBD> Die 15 Crew-Rollen
+
+Crumbforest wird von einer Crew aus 15 spezialisierten KI-Agenten betrieben. Jeder hat eine eigene Persönlichkeit, Expertise und Zugriffsebene.
+
+**Sprach-Support:** Alle Rollen sprechen **Deutsch (DE)**, **Englisch (EN)** und **Französisch (FR)** (wählbar im Login/Header).
+
+### Öffentlicher Bereich (Home)
+| Rolle | Icon | Funktion | Zugriff |
+|-------|------|----------|---------|
+| **Professor Eule** | 🦉 | System Architect & Guide | Öffentlich |
+
+### Interne Crew (Login Required)
+| Rolle | Icon | Expertise | Besonderheit |
+|-------|------|-----------|--------------|
+| **FunkFox** | 🦊 | Hip Hop MC & Motivation | Rappt Antworten ("Yo!") |
+| **Schraubaer** | 🔧 | Master Mechanic | Handwerk & Konstruktion |
+| **TaichiTaube** | 🕊️ | Security Sensei | Balance & Sicherheit |
+| **DeepBit** | 🐙 | Low-Level Octopus | Assembler & Binary |
+| **SnakePy** | 🐍 | Python Expert | Geduldige Lehrmeisterin |
+| **PepperPHP** | 🌶️ | PHP Specialist | Web-Backend & Frameworks |
+| **Templatus** | 📄 | Template Master | HTML & Jinja2 |
+| **Schnippsi** | 🐿️ | UI/CSS Fee | Design & Farben (Cupcakes!) |
+| **CloudCat** | ☁️ | DevOps | Docker & K8s |
+| **GitBadger** | 🦡 | Version Control | Git & History |
+| **Bugsy** | 🐞 | QA Analyst | Testing & Debugging |
+| **DumboSQL** | 🐘 | Database Guide | SQL für Anfänger |
+| **CapaciTobi** | ⚡ | Electronics | Hardware & Physik |
+| **Schnecki** | 🐌 | Slow Tech | Achtsamkeit & Nachhaltigkeit |
+
+---
+
+## <20>🏗️ System-Architektur
 
 ### Komponenten-Übersicht
 
@@ -64,28 +95,27 @@ Crumbforest ist mehr als Software – es ist eine Philosophie:
         ┌───────────────┴───────────────┐
         │                               │
 ┌───────▼────────┐              ┌──────▼───────┐
-│   FastAPI      │              │    PHP       │
-│   (Python)     │◄─────────────┤   Backend    │
-│                │   REST/JSON   │              │
+│   FastAPI      │              │   Static     │
+│   (Python)     │◄─────────────┤   Assets     │
+│   (Jinja2)     │              │   (CSS/JS)   │
 └───────┬────────┘              └──────────────┘
         │
         ├──────────┬──────────┬──────────┐
         │          │          │          │
 ┌───────▼────┐ ┌──▼─────┐ ┌──▼─────┐ ┌─▼──────┐
-│  MariaDB   │ │ Qdrant │ │OpenAI  │ │Claude  │
-│  (SQL)     │ │(Vector)│ │  API   │ │  API   │
+│  MariaDB   │ │ Qdrant │ │OpenRouter│ │ Config │
+│  (SQL)     │ │(Vector)│ │  API     │ │ (JSON) │
 └────────────┘ └────────┘ └────────┘ └────────┘
 ```
 
 ### Datenfluss
 
 ```
-1. Markdown-Datei → DocumentIndexer
-2. DocumentIndexer → Chunking (1000 Zeichen)
-3. Chunks → EmbeddingService → OpenAI/Claude
-4. Embeddings → Qdrant (UUID-basiert)
-5. Metadata → MariaDB (post_vectors)
-6. Audit-Log → MariaDB (audit_log)
+1. Markdown-Datei → DocumentIndexer (Python Watchdog)
+2. DocumentIndexer → Chunking (Token-basiert)
+3. Chunks → EmbeddingService → OpenRouter API
+4. Embeddings → Qdrant (Vector DB)
+5. Metadata → Local Config & Cache
 ```
 
 ### DSGVO-Architektur
@@ -93,7 +123,7 @@ Crumbforest ist mehr als Software – es ist eine Philosophie:
 ```
 Kind 1 → diary_child_1 (Qdrant) ─┐
 Kind 2 → diary_child_2 (Qdrant) ─┼─→ Getrennte Collections
-Kind N → diary_child_N (Qdrant) ─┘   (keine Cross-Access)
+Kind N → diary_child_N (Qdrant) ─┘   (Isolation)
                                   
                 ↓
           audit_log (MariaDB)