From 7e87306c9d8671f50d3fff2fa1e7e09426bdc940 Mon Sep 17 00:00:00 2001 From: enlineawork Date: Fri, 11 Sep 2026 08:56:59 -0300 Subject: [PATCH] docs(android): document modern field release 0.18.0 --- android-app/RELEASE.md | 46 ++++++++++++++++++++++++------------------ 1 file changed, 26 insertions(+), 20 deletions(-) diff --git a/android-app/RELEASE.md b/android-app/RELEASE.md index 584d1df..3e5acfa 100644 --- a/android-app/RELEASE.md +++ b/android-app/RELEASE.md @@ -1,28 +1,40 @@ -# DH Inspección Android · release Campo Dinámico 0.17.0 +# DH Inspección Android · release Campo Moderno 0.18.0 ## Candidata vigente -- Fase funcional: **Campo Dinámico / alta rápida de Inventario**. -- `versionName`: **0.17.0**. -- `versionCode`: **26**. +- 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/`. -- Launcher de presentación: adaptación vectorial local inspirada en el escudo institucional publicado por Gobierno de Mendoza en `mendoza.gov.ar`, para reemplazar el ícono genérico del sistema. 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.17.0 +## Novedades de campo 0.18.0 -La pantalla de una Inspección incorpora un acceso destacado a **Modo campo rápido**. La carga de una Subinstalación se resuelve como flujo guiado: +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. -1. elegir la **Instalación padre** dentro del Yacimiento de la Inspección; -2. buscar y seleccionar la **clasificación técnica** compatible, identificar el elemento y completar únicamente los datos dinámicos que correspondan; -3. tocar **Guardar y tomar foto**: la APK captura GPS y abre la cámara automáticamente. +La carga de una Subinstalación mantiene la integridad del modelo físico pero reduce pasos: -Se mantienen las reglas de integridad existentes: la fotografía sigue siendo obligatoria antes de habilitar Hallazgos, el alta queda ligada al contexto de la Inspección, se conserva la posibilidad de buscar Inventario existente y el mecanismo de fusión de duplicados continúa disponible para altas de campo. +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. -La búsqueda de clasificación técnica está preparada para catálogos extensos de Subinstalaciones sin obligar al inspector a recorrer una fila horizontal completa. +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 @@ -35,13 +47,7 @@ Todo cambio Android o de API que pueda afectar al cliente móvil debe pasar `And 5. `assembleRelease` para comprobar que la variante productiva compile; 6. empaquetado del APK debug con SHA-256 y metadata de commit/versionado. -La barrera de lint exige además manejo explícito de la revocación de permisos de ubicación durante una captura GPS y declara la cámara como capacidad de hardware opcional, sin relajar permisos ni desactivar reglas globalmente. - -El artefacto de CI contiene: - -- APK debug; -- archivo `.sha256`; -- `release-metadata.txt` con fase, versión, versionCode, commit, applicationId, API base y canal. +Además, `DH V2 CI` debe mantener verdes API, WEB y contrato Docker/migraciones antes de promover el cambio. ## Firma release @@ -56,5 +62,5 @@ 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, lista de inspecciones, inicio, alta rápida de Subinstalación, GPS/foto, búsqueda de Inventario existente, Acta, Hallazgo y cierre; +- 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.