Files
dh-inspeccion-v2/android-app/RELEASE.md
T

3.6 KiB

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.