stefan
bf8facfa66
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.
64 lines
1.8 KiB
Markdown
64 lines
1.8 KiB
Markdown
# 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
|
|
|
|
```bash
|
|
# 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:
|
|
- Gateway: http://localhost:8081
|
|
- Keycloak: http://localhost:8180
|
|
- Grafana: http://localhost:3000
|
|
- Prometheus: http://localhost:9090
|
|
|
|
## Tests ausführen
|
|
```bash
|
|
# 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:
|
|
```bash
|
|
docker ps
|
|
docker logs <container-name>
|
|
```
|
|
- Infrastruktur neu starten:
|
|
```bash
|
|
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)
|