Initial commit: Crumbforest Architecture Refinement v1 (Clean)

README.md

@@ -0,0 +1,73 @@
+# 🦉 Crumbforest CRM & RAG System
+
+**Multilingual CRM mit Role-Based Chat, RAG-Funktionalität und Tagebuch-System.**
+
+## ✨ Features
+
+### 🎭 Role System (Neu!)
+- **8 Unique Characters**: DumboSQL, SnakePy, KungfuTaube, etc.
+- **Role-Based Chat**: Dedizierte Chat-Interfaces für jede Rolle.
+- **Syntax Highlighting**: Code-Blöcke werden automatisch hervorgehoben.
+- **Mock Code Execution**: Simulierte Code-Ausführung für Python/PHP.
+- **History Export**: Chat-Verläufe als JSON exportieren.
+
+### 🎨 Theming & Accessibility
+- **4 Themes**: Standard, Accessible, High Contrast, Admin Dark.
+- **Settings Page**: User-spezifische Einstellungen für Schriftgröße und Animationen.
+- **Group-Based Access**: Unterschiedliche Ansichten für Home, Demo und Admin.
+
+### 🤖 RAG & Core
+- **Document Auto-Indexing**: Markdown-Dateien werden automatisch indexiert.
+- **Semantic Search**: Durchsuche Dokumentation via Embeddings.
+- **Multi-Provider**: OpenAI, Anthropic Claude, OpenRouter.
+
+## 🚀 Quick Start
+
+Das System läuft vollständig in Docker.
+
+### 1. Starten
+```bash
+./start.sh
+```
+*Startet alle Container (App, DB, Qdrant).*
+
+### 2. Setup (Einmalig)
+```bash
+python3 setup_demo_user.py
+```
+*Richtet den Demo-User mit korrekter Gruppe und Theme ein.*
+
+### 3. Loslegen
+Öffne **[http://localhost:8000](http://localhost:8000)**
+
+**Login Credentials:**
+- **User**: `demo@crumb.local`
+- **Pass**: `demo123`
+
+---
+
+## 📂 Project Structure
+
+- `crumbforest_config.json` - Zentrale Konfiguration für Rollen & Themes.
+- `app/routers/crumbforest_roles.py` - Backend Logik für das Rollensystem.
+- `app/templates/crumbforest/` - Frontend Templates (Dashboard, Chat).
+- `docs/` - Dokumentation und RAG-Quellen.
+
+## 🔧 Configuration
+
+Die Konfiguration erfolgt über `.env` (Secrets) und `crumbforest_config.json` (Logik).
+
+**Wichtige Env-Vars:**
+```bash
+OPENROUTER_API_KEY=sk-or-...
+APP_SECRET=...
+MARIADB_PASSWORD=...
+```
+
+## 📖 Dokumentation
+
+- **[walkthrough.md](walkthrough.md)** - Detaillierte Tour durch das neue System.
+- **[DATA_PRIVACY_LOCATION.md](DATA_PRIVACY_LOCATION.md)** - Datenschutz-Infos.
+- **[QUICKSTART.md](QUICKSTART.md)** - (Legacy) RAG API Beispiele.
+
+## 🦉 Happy Coding!