🏗️ Architektur-Dokumentation

System-Architektur und Design-Entscheidungen


📋 Dokumente

System-Übersicht

High-level Architektur von WorkmateOS mit:

  • Tech Stack
  • Komponenten-Übersicht
  • Datenflüsse
  • Deployment-Architektur

🔧 Tech Stack

Frontend:

  • Vue 3 (Composition API)
  • TypeScript
  • Vite
  • Pinia (State Management)

Backend:

  • FastAPI (Python 3.13)
  • SQLAlchemy 2.0
  • PostgreSQL 16
  • Alembic (Migrations)

Authentication:

  • Zitadel (OAuth2/OIDC)

Deployment:

  • Docker
  • Docker Compose
  • GitHub Actions (CI/CD)

🌐 System-Komponenten

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
┌─────────────────────────────────────────────────────────┐
│                    WorkmateOS                           │
├─────────────────────────────────────────────────────────┤
│                                                         │
│  ┌──────────────┐         ┌──────────────┐             │
│  │              │         │              │             │
│  │   Frontend   │────────▶│   Backend    │             │
│  │   (Vue 3)    │  REST   │   (FastAPI)  │             │
│  │              │◀────────│              │             │
│  └──────────────┘         └──────┬───────┘             │
│         │                        │                     │
│         │                        ▼                     │
│         │                 ┌──────────────┐             │
│         │                 │              │             │
│         │                 │  PostgreSQL  │             │
│         │                 │              │             │
│         │                 └──────────────┘             │
│         │                                              │
│         ▼                                              │
│  ┌──────────────┐                                      │
│  │              │                                      │
│  │   Zitadel    │                                      │
│  │   (SSO)      │                                      │
│  │              │                                      │
│  └──────────────┘                                      │
│                                                         │
└─────────────────────────────────────────────────────────┘

📚 Siehe auch


Letzte Aktualisierung: 30. Dezember 2025


Table of contents