PAE es un monorepo Android multi-módulo con dos aplicaciones coordinadas:

• Machine: ejecuta entregas en campo con validaciones de peso, evidencia por cámara, verificación facial y persistencia local.
• RutaPAE: coordina operación de ruta, visibilidad de máquinas, integración P2P y soporte de sincronización con backend.

Objetivo principal: mantener una operación confiable y auditable bajo conectividad intermitente y variabilidad de hardware.

• Android + Kotlin + Gradle (KTS)
• Jetpack Compose
• Coroutines + WorkManager
• CameraX + ML Kit + ONNX Runtime
• Persistencia local basada en SQLite (+ capacidades vectoriales en VectorialDB)
• Comunicación P2P guiada por contrato (Contract, DirectLink)
• Servicios de sincronización HTTP (MachineDomain, RutaPAEDomain)

• development
• qa
• production (actualmente mapeado a dominio preproductivo en la configuración vigente)

La selección de host/ambiente se define por configuración de runtime y variables de build.

• vision-general.md
• capas-y-modulos.md
• ciclo-de-vida-de-datos.md

• bascula.md
• camara.md

• estados-de-maquina.md
• arquitectura-p2p.md
• estrategia-de-sincronizacion.md

• flujo-de-entrega.md
• flujo-de-generacion-de-embedding.md
• flujo-del-gestor-de-estados.md
• ciclo-de-vida-de-jornada.md
• flujo-de-sincronizacion-http.md
• filtrado-de-jornadas-en-shift-selection.md

• puntos-finales.md
• contratos-p2p.md
• modelo-de-errores.md

• adr-0001-secuencia-del-gestor-de-estados.md
• adr-0002-persistencia-primero-local.md

• settings.gradle.kts para límites y composición de módulos.
• gradle/libs.versions.toml para versiones de dependencias.
• MachineDomain/src/main/java/co/ada/domain/DomainManager.kt para armado del flujo y estados.
• MachineDomain/src/main/java/co/ada/domain/state/StateManager.kt para orquestación y recuperación.
• MachineDomain/src/main/java/co/ada/domain/state/states/*.kt para comportamiento de cada estado.
• MachineData/src/main/java/co/ada/data/emitters/* para señales de estado/mensaje.
• MachineData/src/main/java/co/ada/data/local/Server.kt para hosts por ambiente.

• Fecha: 2026-04-23
• Método: revisión manual de código + reconciliación de documentación.
• Alcance: estructura de docs, flujo de estados, stack base y mapeo de ambientes.

Las carpetas legadas (explicaciones/, referencia/, guias/, producto/) se mantienen para compatibilidad mientras se consolida la nueva estructura.