67 lines
3.6 KiB
Markdown
67 lines
3.6 KiB
Markdown
# DH Inspección Android · release Campo Moderno 0.18.0
|
|
|
|
## Candidata vigente
|
|
|
|
- Fase funcional: **Campo Moderno / UX dinámica de Inventario y Actas**.
|
|
- `versionName`: **0.18.0**.
|
|
- `versionCode`: **27**.
|
|
- Application ID release: `com.korexlabs.dhinspeccion`.
|
|
- Application ID debug/QA: `com.korexlabs.dhinspeccion.debug`.
|
|
- API: `https://dhv2.korexlabs.com/api/v3/`.
|
|
|
|
La variante debug es independiente de la app productiva y puede instalarse para QA/presentación sin sobrescribir una instalación release histórica.
|
|
|
|
## Novedades de campo 0.18.0
|
|
|
|
La APK adopta una capa visual Material 3 propia de DH: superficies más limpias, jerarquía visual más clara, botones y estados más legibles, tarjetas con menor ruido y una navegación consistente entre Inspección, Actas e Inventario.
|
|
|
|
La carga de una Subinstalación mantiene la integridad del modelo físico pero reduce pasos:
|
|
|
|
1. el buscador de **Instalaciones padre** ahora consulta mientras el inspector escribe;
|
|
2. cada coincidencia aparece como tarjeta seleccionable y tocarla avanza directamente a la identificación de la Subinstalación;
|
|
3. la clasificación técnica continúa filtrada por compatibilidad con la Instalación elegida;
|
|
4. **Guardar y tomar foto** captura GPS y abre la cámara automáticamente.
|
|
|
|
Se conserva la regla de que un elemento nacido en campo no puede recibir Hallazgos hasta contar con GPS y fotografía.
|
|
|
|
## Actas en Android
|
|
|
|
El espacio de Actas fue rediseñado para mostrar con claridad:
|
|
|
|
- contexto de la Inspección y Yacimiento;
|
|
- estado de cada Acta y cantidad de Hallazgos;
|
|
- urgencia mediante selección explícita;
|
|
- responsable de empresa, bloqueo, firmas, manifestación y sellado;
|
|
- condición necesaria para cerrar la Inspección.
|
|
|
|
El listado que consume Android usa un read-model móvil liviano (`/inspection-visits/:visitId/acts/mobile`). Esta lectura no depende del módulo documental de oficina ni de `inspection_reports`, de modo que entrar a una Inspección en campo no queda acoplado a la proyección de Informes/GEDO.
|
|
|
|
## Barrera obligatoria
|
|
|
|
Todo cambio Android o de API que pueda afectar al cliente móvil debe pasar `Android CI / RC`:
|
|
|
|
1. validación de identidad, HTTPS y políticas básicas del manifest;
|
|
2. Android lint;
|
|
3. unit tests Android reales, con verificación de que exista al menos una prueba ejecutada;
|
|
4. `assembleDebug`;
|
|
5. `assembleRelease` para comprobar que la variante productiva compile;
|
|
6. empaquetado del APK debug con SHA-256 y metadata de commit/versionado.
|
|
|
|
Además, `DH V2 CI` debe mantener verdes API, WEB y contrato Docker/migraciones antes de promover el cambio.
|
|
|
|
## Firma release
|
|
|
|
La clave histórica de firma **no se versiona ni se reemplaza**. La CI compila la variante release para detectar roturas, pero la APK productiva final debe firmarse con la clave histórica antes de instalarse como actualización de `com.korexlabs.dhinspeccion`.
|
|
|
|
No se debe crear una clave nueva para resolver una falta de acceso: eso rompería la continuidad de actualización de tablets que ya tengan una versión firmada con la clave anterior.
|
|
|
|
## Criterio de distribución
|
|
|
|
Antes de distribuir una APK productiva:
|
|
|
|
- todas las barreras de CI del SHA exacto deben estar verdes;
|
|
- comprobar certificado/huella de firma contra la versión histórica;
|
|
- realizar actualización sobre al menos una tablet con la versión productiva anterior;
|
|
- ejecutar smoke funcional contra el entorno objetivo: login, abrir Inspección, abrir Actas sin error, crear Acta, búsqueda dinámica de Instalación, selección de padre, alta de Subinstalación, GPS/foto, Hallazgo y cierre;
|
|
- registrar el SHA Git y SHA-256 de la APK distribuida.
|