docs(scanner): Android-Entwicklung mit Firewall und Troubleshooting dokumentieren

frontend/apps/scanner/README.md

@@ -0,0 +1,82 @@
+# Effigenix Scanner
+
+Tauri v2 Mobile App mit QR/Barcode-Scanner für Lager- und Produktionsworkflows.
+
+## Voraussetzungen
+
+- Nix DevShell aktiv (`nix develop`)
+- Backend läuft unter `http://localhost:8080`
+
+## Desktop-Entwicklung
+
+```bash
+just dev-scanner
+```
+
+## Android-Gerät
+
+### 1. USB-Debugging aktivieren
+
+Auf dem Android-Gerät unter **Einstellungen > Entwickleroptionen > USB-Debugging** aktivieren.
+Gerät per USB anschließen und Verbindung prüfen:
+
+```bash
+adb devices
+```
+
+### 2. NixOS-Firewall öffnen
+
+Die DevShell kann Ports 1420 (Vite) und 1421 (HMR) automatisch in der NixOS-Firewall freischalten.
+Dazu die Shell mit gesetzter Env-Variable betreten:
+
+```bash
+EFFIGENIX_OPEN_FW=1 nix develop
+```
+
+Oder manuell:
+
+```bash
+sudo iptables -I nixos-fw 3 -p tcp --dport 1420 -j ACCEPT
+sudo iptables -I nixos-fw 3 -p tcp --dport 1421 -j ACCEPT
+```
+
+Prüfen ob die Regeln aktiv sind:
+
+```bash
+sudo iptables -L nixos-fw -n | grep -E '1420|1421'
+```
+
+### 3. App starten
+
+```bash
+TAURI_DEV_HOST=<LAN-IP> VITE_API_URL=http://<LAN-IP>:8080 just dev-scanner-android
+```
+
+Beispiel:
+
+```bash
+TAURI_DEV_HOST=192.168.0.166 VITE_API_URL=http://192.168.0.166:8080 just dev-scanner-android
+```
+
+- `TAURI_DEV_HOST` – teilt dem Android-Gerät mit, wo der Vite-Dev-Server läuft
+- `VITE_API_URL` – Backend-URL für API-Requests (Default: `http://localhost:8080`)
+
+### Troubleshooting
+
+| Problem | Lösung |
+|---------|--------|
+| `INSTALL_FAILED_UPDATE_INCOMPATIBLE` | Alte App deinstallieren: `adb uninstall de.effigenix.scanner` |
+| `error sending request for url` auf Port 1420 | Firewall-Ports nicht offen (siehe Schritt 2) |
+| API-Requests schlagen fehl | `VITE_API_URL` auf LAN-IP setzen, Port 8080 in Firewall freigeben |
+| Gerät nicht erkannt | `adb devices` prüfen, USB-Debugging aktiviert? |
+
+## Tech Stack
+
+| Tool | Zweck |
+|------|-------|
+| Tauri v2 | Native Mobile Shell |
+| React 18 | UI Framework |
+| Tailwind v4 | Styling |
+| Vite 6 | Build/Dev Server |
+| tauri-plugin-barcode-scanner | QR/Barcode-Scanning |
+| tauri-plugin-http | HTTP-Requests (CORS-Bypass) |