Stage Digger

Adventures out of the box — eine standortbasierte Abenteuer-App (Geocaching-Basis + gamifizierte „Digs"). Siehe CONCEPT.md für das Gesamtkonzept.

Dokumentation

• CONCEPT.md — Vision, Spielprinzip, Geschäftsmodell, Datenmodell, MVP.
• docs/BEDIENUNGSANLEITUNG.md — Bedienungsanleitung mit Screenshots.
• docs/ARCHITECTURE.md — Tech-Stack & Architektur.
• docs/DATA_FORMAT.md — kompaktes Datenformat & Regionalpaket.

Aufbau

frontend/   React + Vite PWA (offline-first, Leaflet-Karte, IndexedDB)
backend/    FastAPI (dünn) + SQLite/R-tree + Regionalpaket-Renderer
docs/       Architektur- & Datenformat-Spezifikation

Leitidee: Lesen ist statisch. Regionalpakete (/v1/<geohash>.json) werden vorgerendert und statisch ausgeliefert; der Server rechnet nur beim Schreiben/Prüfen.

Schnellstart (Entwicklung)

# 1. Backend-Deps + Demo-Daten erzeugen (rendert Pakete nach frontend/public/v1/)
make install-backend
make seed

# 2. Frontend starten
make install-frontend
make dev-frontend          # http://localhost:5173

# optional: dynamisches Backend (Schreib-/Prüf-Endpunkte)
make dev-backend           # http://localhost:8000/docs

Ohne Standortfreigabe nutzt das Frontend Frankfurt am Main als Fallback und zeigt die mitgelieferten Demo-Digs.

MVP-Umfang

Dig-Arten Simple / Blind / Mystery, Ausprägungen free / privat / premium / pay-to-play, regionaler Bulk-Download + Offline-Stöbern. Weitere Arten (Event, Sprint, Build, Hunt, Race) folgen später (siehe CONCEPT.md).