====== Visión general de arquitectura ======

===== Propósito =====

Explicar la arquitectura de alto nivel de PAE y cómo se coordinan sus módulos principales durante la operación en campo.

===== Forma del sistema =====

PAE es un monorepo Android multi-módulo con dos apps y capas de dominio/datos compartidas.

  * ''Machine'': ejecuta el flujo de entrega en el dispositivo.
  * ''RutaPAE'': coordina visibilidad operativa y sincronización por ruta.
  * Módulos compartidos: contrato, utilidades, visión por computador y persistencia especializada.

===== Principios de diseño =====

  * Operación primero-local y resiliente sin conectividad estable.
  * Persistencia local antes de sincronización remota.
  * Orquestación explícita por máquina de estados.
  * Contratos compartidos para evitar acoplamientos implícitos.
  * Recuperación automática ante fallos de dispositivos/red.

===== Fuentes de verdad =====

  * ''settings.gradle.kts''
  * ''MachineDomain/src/main/java/co/ada/domain/DomainManager.kt''
  * ''MachineDomain/src/main/java/co/ada/domain/state/StateManager.kt''
  * módulos ''Contract'' y ''DirectLink''

===== Ultima verificacion =====

  * Fecha: ''2026-04-23''
  * Verificado contra estructura de módulos y código de orquestación vigente.