Wiki

Has cargado una revisión vieja del documento! Si la guardas crearás una versión nueva con estos datos.

====== Índice de documentación de PAE ======

===== Qué es este repo =====

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.

===== Stack =====

* 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'')

===== Ambientes =====

* ''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.

===== Mapa de documentación =====

==== ''arquitectura/'' ====

* [[ada:howto:sicoferp:factory:new-migracion-sicoferp:machine:arquitectura:vision-general|Vision General]]
  * [[ada:howto:sicoferp:factory:new-migracion-sicoferp:machine:arquitectura:capas-y-modulos|Capas Y Modulos]]
  * [[ada:howto:sicoferp:factory:new-migracion-sicoferp:machine:arquitectura:ciclo-de-vida-de-datos|Ciclo De Vida De Datos]]

==== ''dispositivos/'' ====

* [[ada:howto:sicoferp:factory:new-migracion-sicoferp:machine:dispositivos:bascula|Bascula]]
  * [[ada:howto:sicoferp:factory:new-migracion-sicoferp:machine:dispositivos:camara|Camara]]

==== ''operacion-sin-conexion/'' ====

* [[ada:howto:sicoferp:factory:new-migracion-sicoferp:machine:operacion-sin-conexion:estados-de-maquina|Estados De Maquina]]
  * [[ada:howto:sicoferp:factory:new-migracion-sicoferp:machine:operacion-sin-conexion:arquitectura-p2p|Arquitectura P2p]]
  * [[ada:howto:sicoferp:factory:new-migracion-sicoferp:machine:operacion-sin-conexion:estrategia-de-sincronizacion|Estrategia De Sincronizacion]]

==== ''flujos-clave/'' ====

* [[ada:howto:sicoferp:factory:new-migracion-sicoferp:machine:flujos-clave:flujo-de-entrega|Flujo De Entrega]]
  * [[ada:howto:sicoferp:factory:new-migracion-sicoferp:machine:flujos-clave:flujo-de-generacion-de-embedding|Flujo De Generacion De Embedding]]
  * [[ada:howto:sicoferp:factory:new-migracion-sicoferp:machine:flujos-clave:flujo-del-gestor-de-estados|Flujo Del Gestor De Estados]]
  * [[ada:howto:sicoferp:factory:new-migracion-sicoferp:machine:flujos-clave:ciclo-de-vida-de-jornada|Ciclo De Vida De Jornada]]
  * [[ada:howto:sicoferp:factory:new-migracion-sicoferp:machine:flujos-clave:flujo-de-sincronizacion-http|Flujo De Sincronizacion Http]]
  * [[ada:howto:sicoferp:factory:new-migracion-sicoferp:machine:flujos-clave:filtrado-de-jornadas-en-shift-selection|Filtrado De Jornadas En Shift Selection]]

==== ''api/'' ====

* [[ada:howto:sicoferp:factory:new-migracion-sicoferp:machine:api:puntos-finales|Puntos Finales]]
  * [[ada:howto:sicoferp:factory:new-migracion-sicoferp:machine:api:contratos-p2p|Contratos P2p]]
  * [[ada:howto:sicoferp:factory:new-migracion-sicoferp:machine:api:modelo-de-errores|Modelo De Errores]]

==== ''decisiones/'' ====

* [[ada:howto:sicoferp:factory:new-migracion-sicoferp:machine:decisiones:adr-0001-secuencia-del-gestor-de-estados|Adr 0001 Secuencia Del Gestor De Estados]]
  * [[ada:howto:sicoferp:factory:new-migracion-sicoferp:machine:decisiones:adr-0002-persistencia-primero-local|Adr 0002 Persistencia Primero Local]]

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

* ''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.

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

* 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.

===== Nota =====

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

Resumen de la edición

Wiki

Herramientas de usuario

Herramientas del sitio

Herramientas de la página