docs(android): document modern field release 0.18.0

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.