0004. Preparada para trabajar sin conexión: repositorio como frontera, ids y horas del dispositivo¶
Estado: Propuesto
Fecha: 2026-11-02
Autor: David Garcia
Módulo(s) afectado(s): modules//
Contexto¶
En TAT el promotor pierde señal dentro de tiendas y barrios, pero la primera
versión trabaja en línea: el modo sin conexión completo necesita del backend
cosas que todavía no tiene (descarga incremental, p. ej. actualizado_desde).
El backend ya acepta lo necesario para reenviar sin duplicar: la hora del
dispositivo con zona en check-in y check-out (ADR 0031 de fuerza de ventas) y
el id del pedido enviado por la app (ADR 0041 de fuerza de ventas). Si la
app no se prepara desde el inicio, sumar el modo sin conexión obliga a
reescribir cada pantalla.
Decisión¶
- El repositorio es la única entrada a los datos de su módulo. Providers
y pantallas no saben si un dato viene de la API o, después, de la base
local; devuelve modelos del módulo, no DTO ni respuestas de
dio. - Los ids los genera la app (UUID v7) para todo lo que se crea en el teléfono, empezando por los pedidos. Un reintento con mala señal no duplica, aun con conexión.
- La hora y el
utc_offsetse toman al hacer la acción, no al enviarla, y viajan en el modelo hasta el repositorio. Con conexión se envía sólo elutc_offset(ADR 0031 de fuerza de ventas). - Gana el servidor: un 409 o un 4xx de negocio se muestra al promotor con su motivo; la app no reintenta ni corrige por su cuenta.
- Pendiente para otro ADR: base local con Drift para leer, cola de salida para escribir, motor de envío en orden y pantalla de pendientes y rechazados.
Alternativas descartadas¶
- Implementar ya el modo sin conexión completo — falta soporte en el backend y multiplica el alcance de la primera versión.
- Ignorarlo hasta que haga falta — los ids del servidor y las horas tomadas al enviar quedarían repartidos en cada pantalla.
- Cabecera
Idempotency-Key— el backend ya usa el id del recurso para reconocer el reenvío (ADR 0041 de fuerza de ventas).
Consecuencias¶
- Sin señal, la primera versión no puede trabajar: el promotor ve un aviso y reintenta. Si va a la calle con promotores reales, el modo sin conexión se adelanta.
- Al sumarlo, cambian los repositorios y
core/, no las pantallas. - Hace falta pedir a los servicios la descarga incremental antes de empezar el modo sin conexión.
Media página como máximo. Si el ADR crece más que eso, probablemente estás documentando el diseño completo del módulo, no una decisión puntual — separa.