feat(android): app de campo móvil+tablet (UI, mapa, fotos, auto-sync, reconciliación)

Fase 0: config Android (package, permisos, orientación), eas.json (APK), deps
  nativas (react-native-maps, image-picker, location), app.config.js para la key
  de Google Maps por secreto EAS.
Fase 1: capa responsive (useLayout) + componente MasterDetail (dos paneles en
  tablet, navegación en móvil).
Fase 2: pantallas funcionales — detalle de proyecto con secciones Fases/Features/
  Incidencias, edición de progreso/estado, formulario de inspección dinámico
  desde plantilla, incidencias maestro-detalle (checklist + comentarios), alta de
  incidencia; gating por permisos Spatie.
Fase 3: fotos (cámara/galería) → cola de media, con miniaturas pendientes/sync.
Fase 4: mapa de features (Google Maps) con geometría GeoJSON y selección.
Fase 5: auto-sync (foreground/reconexión/intervalo, con candado) + reconciliación
  de creaciones offline (id temporal negativo → server_id, remapeo de FKs hijas).
Fase 6: revisión de conflictos/errores del outbox, indicadores y APK preview.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
javier
2026-06-18 18:30:44 +02:00
co-authored by Claude Opus 4.8
parent 4e9c7d059f
commit 9bcc51e3b2
36 changed files with 2532 additions and 131 deletions
+40 -3
View File
@@ -8,18 +8,55 @@ Contrato de la API: [`docs/openapi.yaml`](docs/openapi.yaml) ·
brief: [`docs/MOBILE_APP_BRIEF.md`](docs/MOBILE_APP_BRIEF.md) ·
protocolo de sync: [`docs/MOBILE_SYNC_PROTOCOL.md`](docs/MOBILE_SYNC_PROTOCOL.md).
## Arranque
## Arranque (Android)
La app usa módulos nativos (expo-sqlite, expo-secure-store, react-native-maps) que **no
funcionan en Expo Go**: hay que usar un *development build* o un APK.
```bash
npm install
npm start # abre Expo; pulsa 'a' (Android) / 'i' (iOS) / 'w' (web)
npm run typecheck # comprobación de tipos
npm run typecheck # comprobación de tipos
# Development build (emulador o dispositivo con depuración USB):
npx expo run:android # compila e instala un dev client con hot reload
```
> **Backend local (XAMPP):** ajusta `BASE_URL` en [`src/config.ts`](src/config.ts).
> Desde emulador Android usa `http://10.0.2.2/...`; desde dispositivo físico, la IP LAN del PC.
> `localhost` apunta al propio teléfono, no al PC.
### APK para repartir (sideload)
Con [EAS Build](https://docs.expo.dev/build/introduction/) (nube de Expo, no necesita Mac):
```bash
npm i -g eas-cli # una vez
eas login # cuenta Expo
eas build -p android --profile preview # genera un .apk (distribution: internal)
```
Al terminar, EAS da un enlace de descarga del `.apk`; instálalo en el dispositivo
(habilitando "orígenes desconocidos"). Perfiles en [`eas.json`](eas.json):
`development` (dev client), `preview` (APK interno), `production` (AAB, para Play más adelante).
### Mapa (Google Maps)
La sección Features incluye un mapa (react-native-maps) que dibuja la geometría GeoJSON.
Requiere una **API key de Google Maps (Android)**, que se inyecta vía variable de entorno
`GOOGLE_MAPS_API_KEY` en [`app.config.js`](app.config.js) — **no se commitea**:
```bash
# local
export GOOGLE_MAPS_API_KEY=AIza... # (PowerShell: $env:GOOGLE_MAPS_API_KEY="AIza...")
npx expo run:android
# EAS: guárdala como secreto
eas secret:create --name GOOGLE_MAPS_API_KEY --value AIza...
```
Sin key, la app funciona pero el mapa no carga tiles (la lista de features sí). Las tiles
necesitan conexión; la geometría se dibuja también sin red.
## Arquitectura
```