Skip to main content

Architektur

StoreStash besteht aus 4 Docker-Services hinter einem Nginx Reverse Proxy.

Übersicht​

┌─────────────────── Docker Network ───────────────────┐
│                                                       │
│  ┌─────────┐    ┌──────────┐    ┌──────────┐        │
│  │  Nginx  │───►│ Frontend │    │ Backend  │        │
│  │  :80    │    │ SvelteKit│    │ FastAPI  │        │
│  │         │───►│  :3000   │    │  :8000   │        │
│  └─────────┘    └──────────┘    └──────────┘        │
│       │                              │               │
│       │         /api/* ──────────────┘               │
│       │                              │               │
│       │                         ┌────▼────┐          │
│       │                         │   DB    │          │
│       │                         │ Postgres│          │
│       │                         │  :5432  │          │
│       │                         └─────────┘          │
│  Port 3000                  (nicht exponiert)         │
└───────┘──────────────────────────────────────────────┘

Request-Flow​

  1. Browser → Nginx (:3000)
  2. Nginx routet:
    • /api/* → Backend (FastAPI :8000)
    • /* → Frontend (SvelteKit :3000)
  3. Backend → PostgreSQL (intern :5432)

Services​

Nginx​

  • Reverse Proxy, TLS Termination (in Produktion)
  • Rate-Limiting: 30 req/s pro IP, Burst 20
  • Security Headers: CSP, X-Frame-Options, Permissions-Policy
  • Body-Size-Limit: 2 MB
  • Swagger UI blockiert in Produktion

Frontend (SvelteKit)​

  • Server-Side Rendering via adapter-node
  • Tailwind CSS mit CSS Custom Properties für Themes
  • PWA: Manifest, Service Worker, Shortcuts
  • i18n: DE + EN, erweiterbar

Backend (FastAPI)​

  • Async (asyncio + asyncpg)
  • SQLAlchemy 2.0 ORM
  • Pydantic v2 Schemas mit strikter Validierung
  • Open Food Facts Proxy

PostgreSQL​

  • Version 16 (Alpine)
  • Nur im Docker-Netzwerk erreichbar
  • Healthcheck via pg_isready
  • Volume-Mount für Persistenz

Verzeichnisstruktur​

backend/app/
├── api/v1/          # Endpoint-Router (products, stock, barcode, ...)
├── core/            # Config, Database, Seed
├── models/          # SQLAlchemy ORM Models
├── schemas/         # Pydantic Request/Response Schemas
└── services/        # Business Logic (inventory_service)

frontend/src/
├── lib/
│   ├── api/         # Typed API Client
│   ├── components/  # Svelte Components (ui/, inventory/, layout/)
│   ├── i18n/        # Translations (de.ts, en.ts)
│   ├── stores/      # Svelte Stores (state, themes, device)
│   └── types/       # TypeScript Interfaces
├── routes/          # 10 SvelteKit Pages
└── app.css          # Tailwind + CSS Variables