POS System - CashCardRegister

Ein modulares Point-of-Sale System mit pluggable Payment Providern.

Features

• Product Management: Produkte mit Barcode, Name, Preis verwalten
• Checkout Flow: Barcode-Scanner → Warenkorb → Zahlung
• Payment Providers: Pluggable Architecture (Cash, SumUp, erweiterbar)
• Real-time Updates: WebSocket für Live-Warenkorb
• Admin UI: Produktverwaltung

Docs

• Andere Anbieter: Kosten & Empfehlungen für Kartenzahlungsterminals
• Ideen & ToDos: Ideen, ToDos & Anforderungen

Quick Start (Docker)

cp .env.example .env
# Edit .env with your credentials
docker compose -f docker/docker-compose.yml up --build

• Frontend: http://localhost:3000
• Backend API: http://localhost:8000
• API Docs: http://localhost:8000/docs

Development

Backend

cd backend
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
uvicorn app.main:app --reload

Frontend

cd frontend
npm install
npm run dev

Tests

cd backend
pytest tests/ -v

Tests in Docker (like CI)

docker compose -f docker/docker-compose.test.yml up --build --abort-on-container-exit

Architecture

Payment Provider Pattern

Adding a new payment provider requires only:

1. Create backend/app/payments/providers/newprovider.py
2. Register in backend/app/payments/factory.py

No other code changes needed.

Demo Data

Demo products are seeded on first startup. To reset:

# Delete the database and restart
rm backend/pos.db