Crumb-Core-v.1/README.md

🦉 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

./start.sh

Startet alle Container (App, DB, Qdrant).

2. Setup (Einmalig)

python3 setup_demo_user.py

Richtet den Demo-User mit korrekter Gruppe und Theme ein.

3. Loslegen

Öffne 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:

OPENROUTER_API_KEY=sk-or-...
APP_SECRET=...
MARIADB_PASSWORD=...

📖 Dokumentation

• walkthrough.md - Detaillierte Tour durch das neue System.
• DATA_PRIVACY_LOCATION.md - Datenschutz-Infos.
• QUICKSTART.md - (Legacy) RAG API Beispiele.

🦉 Happy Coding!