Saltar a contenido

ADR — app móvil CRM (TAT)

Registro de decisiones de arquitectura de la app móvil del CRM, enfocada en el canal TAT (tienda a tienda). Un ADR documenta una decisión puntual (no el diseño completo de un módulo): el problema, qué se eligió, qué alternativas se descartaron y qué consecuencias trae. Se escriben en español.

El formato sigue el modelo oficial del proyecto, definido en el repositorio docs-site: template/0000-adr-template.md, el mismo que usan los servicios.

La numeración es local a este repositorio y arranca en 0001. Las referencias a ADR de docs-site se citan siempre como «ADR 000N transversal», y las de otros repositorios con su nombre («ADR 0031 de fuerza de ventas», «ADR 0004 del frontend»), para no confundirlas con los de este repositorio.

Índice

ADR Título Estado Fecha
0001 Stack, dependencias y herramientas de calidad de la app móvil Propuesto; complementado por 0006 2026-11-02
0002 Arquitectura: modular por dominio, con las reglas de dependencia del frontend Propuesto; complementado por 0003, 0004 2026-11-02
0003 Estructura de carpetas de lib/ y test/ Propuesto; complementado por 0006 2026-11-02
0004 Preparada para trabajar sin conexión: repositorio como frontera, ids y horas del dispositivo Propuesto 2026-11-02
0005 Configuración por archivo de entorno, validada al arrancar Propuesto 2026-11-02
0006 DTO generados desde una copia versionada del contrato OpenAPI Propuesto 2026-11-02
0007 Login en dos pasos y acceso sólo para promotores vigentes Propuesto; complementado por 0008 2026-11-02
0008 Un Dio por servicio, tokens en almacenamiento seguro y una sola renovación de sesión Propuesto 2026-11-02
0009 Tests: unidad y widgets con el borde HTTP simulado, sin servicios reales Propuesto 2026-11-02
0010 Navegación fija con barra inferior, no dirigida por el backend Propuesto 2026-11-02
0011 Agenda propia y ejecución de visitas: check-in sólo hasta hoy y ubicación según el tipo de actividad Propuesto; parcialmente reemplazado por 0014 (sólo tracking de ruta) 2026-11-02
0012 Cartera propia de sólo lectura, buscada en el teléfono Propuesto 2026-11-03
0013 Toma de pedidos: borrador en el servidor con id del teléfono y precio escrito a mano Propuesto 2026-11-02
0014 GPS en segundo plano durante una ruta activa y dentro de la jornada autorizada Propuesto 2026-11-11

Cómo agregar un ADR

  1. Copie el formato oficial y numere el archivo con el último número + 1: NNNN-titulo-corto.md.
  2. Complete contexto, decisión, alternativas descartadas y consecuencias. Media página como máximo: si crece más, son dos decisiones.
  3. Agregue su fila al índice de este README.
  4. Si un ADR posterior modifica o acota una decisión anterior, el ADR previo no se borra:
  5. Lo reemplaza en parte: el nuevo lleva **Modifica a:** y el anterior pasa a **Estado:** Parcialmente reemplazado por [ADR NNNN] con **Modificado por:**.
  6. Lo amplía sin cambiar lo decidido: el nuevo lleva **Complementa a:** y el anterior pasa a **Estado:** Complementado por [ADR NNNN] con **Complementado por:**. En ambos casos se actualiza el estado en el índice.