Stefan Mogeritsch bf8facfa66 docs(frontend): add detailed offline-first architecture and web setup documentation

Added documentation to outline the Offline-First strategy for the KMP frontend, emphasizing the use of SQLDelight with cross-platform storage. Also included guidance for setting up Web targets, covering OPFS integration and Web Worker usage. Updated ADRs with decisions for SQLDelight and Koin adoption.

2026-01-13 15:59:25 +01:00

1.8 KiB

Raw Blame History

Start Local (Lokales Setup)

Kurzanleitung, um das Projekt lokal in wenigen Minuten zu starten.

Wichtiger Hinweis (Januar 2026): Der Build ist derzeit aufgrund eines Kotlin/Wasm-Compiler-Problems blockiert. Die Infrastruktur und die Backend-Services können jedoch unabhängig davon gestartet werden.

Voraussetzungen

Docker und Docker Compose (v2)
Java 25 (JDK)
Git

Schnellstart

# 1) Repository klonen
git clone https://github.com/StefanMoCoAt/meldestelle.git
cd meldestelle

# 2) Runtime-Environment vorbereiten
#    Kopiere die Vorlage.
cp .env.example .env

# 3) Infrastruktur starten (Postgres, Redis, Keycloak, Monitoring, Gateway)
docker compose -f docker-compose.yaml up -d

# 4) Backend-Service starten (Beispiel: Results Service)
./gradlew :backend:services:results:results-service:bootRun

Sobald die Infrastruktur läuft, erreichst du unter anderem:

Tests ausführen

# Führt alle Tests aus (Frontend-Tests könnten fehlschlagen)
./gradlew test

# Spezifisches Backend-Modul testen
./gradlew :backend:services:results:results-service:test

Troubleshooting

Dienste starten nicht? Ports belegt oder Logs prüfen:
```
docker ps
docker logs <container-name>
```

Infrastruktur neu starten:

docker compose -f docker-compose.yaml down -v
docker compose -f docker-compose.yaml up -d

Environment-Variablen: werden aus der .env-Datei im Root-Verzeichnis geladen.

Weiterführende Hinweise

Architektur: docs/01_Architecture/ARCHITECTURE.md (veraltet, siehe Reports)
ADRs: docs/01_Architecture/adr/
Aktuelle Reports: docs/90_Reports/

Stand: Januar 2026 (teilweise aktualisiert)

1.8 KiB Raw Blame History