shop/CLAUDE.md

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