# MABEA Android-App (Flutter) – erstes Grundgerüst

Zweiter Client derselben API (Prompt 19 API-first-Prinzip) neben der React-PWA
(`frontend/`). Deckt Login, Objektliste, Kontroll-Screen (Start/Sperre-Übernahme/
Positionen/Abschluss/Abbruch) ab.

## Wichtig: Plattform-Ordner fehlen noch

Dieses Verzeichnis enthält nur `lib/`, `pubspec.yaml`, `analysis_options.yaml` -
die von `flutter create` generierten Plattform-Ordner (`android/`, `ios/`, Gradle-
Konfiguration etc.) wurden bewusst NICHT von Hand nachgebaut, da das ohne
Testlauf zu fehleranfällig wäre. Erstinbetriebnahme auf dem Zielsystem (mit
Flutter-SDK installiert):

```bash
cd flutter_app
flutter create . --platforms android --org de.perlbach24 --project-name mabea_app
# überschreibt pubspec.yaml NICHT automatisch mit *nix cp -n, ggf. lib/-Inhalt
# und pubspec.yaml-Dependencies danach gegen diese Version abgleichen
flutter pub get
flutter build apk
```

## API-Adresse

`lib/main.dart`: `kApiBaseUrl` ist aktuell fest auf den Deployment-Server
(`192.168.1.238`) gesetzt. Für Produktivbetrieb auf `--dart-define` umstellen
oder zumindest vor jedem Build prüfen/anpassen.

## Bewusst noch nicht umgesetzt (Unterschied zur React-PWA)

- **Keine Offline-Queue**: anders als die PWA (`frontend/src/offline/queue.ts`,
  IndexedDB) sendet diese erste Fassung Positionen direkt; bei Netzwerkfehler
  erscheint nur eine "erneut versuchen"-Meldung, keine automatische
  Zwischenspeicherung/Sync bei Reconnect. Nachziehen, sobald die App über das
  Grundgerüst hinauswächst - gleiches Muster wie in der PWA übertragbar
  (z. B. `sqflite` oder `hive` statt IndexedDB).
- Kein QR-/Barcode-Kamera-Scan (Karte 10, Roadmap).
- Keine Tests (Flutter-Widget-/Integrationstests) - Sprintplan sieht Testphase 4
  primär für die PWA vor (Playwright); Android-Testabdeckung ist noch offen.