0005. Stack y estructura modular para backend y app¶
Fecha: 2026-11-11 Estado: Propuesto Módulo(s) afectado(s): svc-tracking, módulo tracking de crm-appmovil
Contexto¶
El nuevo servicio debe alinearse con el runtime y las prácticas de prueba de CRM. La app ya usa Flutter y documenta un repositorio como frontera para una futura cola local, pero el repositorio actual sigue siendo un scaffold sin Drift instalado. No hay benchmarks que demuestren la necesidad de un runtime distinto.
Decisión¶
Se propone Python + FastAPI con routers delgados, servicios de dominio y repositorios; Poetry, Pydantic y las herramientas CRM de calidad pytest, Ruff y mypy estricto, además de OpenAPI y pruebas de aislamiento por tenant. El backend se organiza por dominios (sesiones/, puntos/) bajo app/domains/; la persistencia MongoDB se encapsula tras repositorios. La app conserva Flutter y suma un módulo tracking/ con cliente API y repositorio como frontera; la cola durable/outbox reutiliza la frontera prevista Drift/SQLite, sin elegir un paquete de ubicación.
Alternativas descartadas¶
- Go como runtime inicial — no hay mediciones de carga o SLA que justifiquen apartarse del stack común; decidir sólo ante benchmark representativo que pruebe insuficiencia de FastAPI.
- Otra persistencia móvil — duplica el límite local documentado; alinear Drift/SQLite con el repo antes de implementarlo.
Consecuencias¶
Se heredan las convenciones y herramientas ya conocidas. Antes de escalar hay que medir ingestión por lotes y consultas reales con predicados tenant y pruebas de autorización/no interferencia; si se elige la alternativa PostgreSQL, validar además RLS y su patrón transaccional. La estructura y el stack siguen siendo propuestas, no implementación aprobada.
Referencias: ADR transversal 0001, 0005, 0016 y 0017; ADR 0001 y 0002 de svc-fuerza-ventas, ADR móvil 0001, 0003 y 0004.