wahnsinn

CLAUDE.md

@@ -13,12 +13,35 @@ Custom E-Commerce Shopsystem (B2C + B2B), weltweit einsetzbar, als verkaufbares
 
 ## Tech-Stack
 
-- **Backend**: Python + FastAPI
+- **Backend**: Python + FastAPI — Tooling: `uv`, `ruff`, `pytest`
 - **Datenbank**: PostgreSQL (Write-Store) + Redis (Read-Store)
-- **Frontend**: React (Next.js) + TypeScript
-- **Suche**: Meilisearch (Standard), austauschbar per Such-Abstraktion für Enterprise-Kunden
+- **Frontend**: Vue 3 + Vite + TypeScript + Pinia + Vue Router — Tooling: `pnpm`, `eslint`, `prettier`, `vitest`. Nur Web, responsives Design.
+  **Zwei getrennte Vue-Apps mit separatem Build:** `shop` und `admin`.
+- **Auth**: JWT (Access + Refresh), `argon2` für Passwort-Hashing
+- **KI**: Ollama (lokal) via RAG — Standard-Modelle `llama3.1` (Chat) + `nomic-embed-text` (Embeddings), per Abstraktion austauschbar
+- **Suche**: austauschbar per Such-Abstraktion (Standard Meilisearch)
 - **DB-Migrationen**: Alembic (SQLAlchemy)
-- **Jede App** bringt eigene Migrationen, API-Endpunkte und Frontend-Komponenten mit
+- **i18n**: DE + EN initial
+- **Dev-Infrastruktur**: `docker-compose` mit Postgres, Redis, Meilisearch, Ollama
+- **Jede App** bringt Manifest (`manifest.yaml`), Migrationen, API-Endpunkte, Frontend-Komponenten, Events und Übersetzungen mit
+
+## Betrieb
+
+- **Single-Shop pro Instanz** (kein Multi-Tenant). Mehrere Shops → mehrere Deployments.
+
+## Repo-Struktur
+
+```
+/backend        FastAPI-Core + App-Loader
+/frontend/shop  Vue-App Kundensicht
+/frontend/admin Vue-App Admin
+/apps           Core-Apps und optionale Apps als Python-Packages
+```
+
+## KI-Integration
+
+- **Shop-Seite**: KI-Helfer für natürlichsprachliche Produktsuche (RAG über Produkte/Kategorien).
+- **Admin-Seite**: KI-Chatbox auf der Startseite. Befehle und JSON-Bulk-Input werden als **Vorschlags-Cards** dargestellt. Fehlende Felder sind in der Card editierbar. Ausführung erst nach Bestätigung durch den Admin — KI führt nie direkt aus.
 
 ## Datenfluss