45 lines
1.6 KiB
Markdown
45 lines
1.6 KiB
Markdown
# 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
|