Initial commit

CLAUDE.md

@@ -0,0 +1,44 @@
+# Shopsystem — Projektrichtlinien
+
+## Projekt
+
+Custom E-Commerce Shopsystem (B2C + B2B), weltweit einsetzbar, als verkaufbares Produkt geplant.
+
+## Architektur
+
+- **App-basiertes System**: Jede Funktion ist eine App mit Manifest (Abhängigkeiten, Konflikte, Pflicht/Optional)
+- **Core**: Minimaler Kern (Auth, API-Router, App-Loader, Event-Bus, DI-Container)
+- **Kommunikation zwischen Apps**: Events (lose Kopplung) und Dependency Injection (keine direkten Imports)
+- **Dritt-Entwickler** können eigene Apps bauen (Marketplace-Konzept)
+
+## Tech-Stack
+
+- **Backend**: Python + FastAPI
+- **Datenbank**: PostgreSQL (Write-Store) + Redis (Read-Store)
+- **Frontend**: React (Next.js) + TypeScript
+- **Suche**: Meilisearch (Standard), austauschbar per Such-Abstraktion für Enterprise-Kunden
+- **DB-Migrationen**: Alembic (SQLAlchemy)
+- **Jede App** bringt eigene Migrationen, API-Endpunkte und Frontend-Komponenten mit
+
+## Datenfluss
+
+- PostgreSQL ist die Quelle der Wahrheit (alle Schreiboperationen)
+- Redis ist die Lese-Schicht (Frontend liest NUR aus Redis)
+- Sync: Sofort-Aktualisierung bei Änderungen + Scheduler als Sicherheitsnetz
+- Frontend sieht nie die DB-Komplexität, nur schnelle Redis-Reads
+
+## Umgebungen
+
+- `APP_ENV=dev|staging|production` steuert Verhalten
+- Dev: Seed-Daten, Mock-Services, Hot-Reload, Debug-Logging
+- Staging: Stripe Testmodus, Catch-All E-Mails
+- Production: Echte Zahlungen, Caching an
+
+## Analyse-Dokument
+
+- `shopsystem-analyse.tex` — Vollständige Analyse (34 Seiten), nicht mehr anpassen
+
+## Arbeitsweise
+
+- Antworten kompakt halten
+- KI-gestützter Workflow: Prototyp → Refactoring → Refactoring