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:
co-authored by
Claude Opus 4.8
parent
4e9c7d059f
commit
9bcc51e3b2
@@ -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
|
||||
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user