Files
timemaster/docs/ARCHITECTURE.md
T
patrickandClaude Sonnet 5.5 119b10d943
Security Audit / Python Dependency Audit (push) Canceled after 0s
Security Audit / Node.js Dependency Audit (push) Canceled after 0s
Security Audit / Frontend Build (tsc + vite) (push) Canceled after 0s
docs+chore(setup): Debian 13 statt Ubuntu, versionsneutrale Doku, unattended-upgrades
- Doku auf Debian 13 "trixie" umgestellt, Python/PostgreSQL/Redis als Debian-Standard
- setup_server.sh installiert und konfiguriert unattended-upgrades (kein Auto-Reboot)

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-15 16:18:42 +01:00

2.2 KiB
Raw Blame History

TimeMaster – Architektur

Stack

Schicht Technologie
Backend Python 3 (Debian-Standard) · FastAPI · SQLAlchemy (async)
Datenbank PostgreSQL (Debian-Standard)
Cache / Sessions Redis (Debian-Standard)
Frontend React 18 · TypeScript · Tailwind CSS
Prozess-Manager systemd
Reverse Proxy Nginx + Let's Encrypt
E-Mail Resend.com
Datei-Storage Lokales Filesystem / S3-kompatibel

Verzeichnisstruktur

/opt/timemaster/
├── backend/
│   ├── app/
│   │   ├── core/          # Config, DB, Security, Dependencies
│   │   ├── models/        # SQLAlchemy ORM Models
│   │   ├── schemas/       # Pydantic v2 Schemas
│   │   ├── routers/       # FastAPI Router (je Modul)
│   │   └── services/      # Business-Logik (je Modul)
│   ├── migrations/        # Alembic
│   └── tests/             # pytest
└── frontend/
    ├── src/
    │   ├── features/      # Auth, Zeit, Urlaub, Dashboard, Kiosk
    │   └── shared/        # Komponenten, Hooks, Utils
    └── dist/              # Build-Output (von Nginx ausgeliefert)

Rollen & Berechtigungen

SUPER_ADMIN     → Plattform-Betreiber, alle Firmen
COMPANY_ADMIN   → Vollzugriff eigene Firma
HR              → Personalakten lesen, Berichte
MANAGER         → Genehmigungen für eigenes Team
EMPLOYEE        → Eigene Daten, eigene Anträge

Authentifizierung

  • Access Token: JWT, 30 Minuten gültig
  • Refresh Token: Opaque, 30 Tage, rotation bei jedem Refresh
  • Kiosk: Eigener Token-Flow, PIN/NFC/QR/Liste

Datenbankschema (Übersicht)

companies ──< departments
companies ──< users ──< sessions
users ──< time_entries
users ──< absences ──> absence_types
users ──< vacation_balances
companies ──< kiosk_devices
companies ──< audit_logs

API-Versionierung

Alle Endpunkte unter /api/v1/. Zukünftige Breaking Changes → /api/v2/.

Deployment (nativ)

systemd → uvicorn (4 worker) → FastAPI
nginx → :443 → :8000 (API) + /opt/timemaster/frontend/dist (React)