Saltar a contenido

ADR — svc-fuerza-ventas

Registro de decisiones de arquitectura de svc-fuerza-ventas (promotores, presupuesto de cliente). Proviene del repositorio del servicio (crm-svc-fuerza-ventas/docs/adr) y se incorpora a este sitio sin cambios de contenido: mismos textos, estados y fechas originales.

La numeración es local a este microservicio (0001–0024).

Formato oficial: template/0000-adr-template.md.

Índice

ADR Título Estado Fecha
0001 Stack, dependencias y herramientas de calidad Aceptado 2026-10-05
0002 Estructura del proyecto: monolito modular por dominio Aceptado 2026-10-05
0003 Configuración validada al arrancar y dos entornos: local y production Parcialmente reemplazado por ADR 0013 2026-10-05
0004 Base de datos: engine asíncrono perezoso y search_path del servicio Aceptado 2026-10-05
0005 Migraciones con Alembic en el esquema del servicio Aceptado 2026-10-05
0006 Esquema fuerzaventas, columnas comunes y RLS por empresa Parcialmente reemplazado por ADR 0014 2026-10-05
0007 Validación del access token de svc-identidad con su JWKS Aceptado 2026-10-05
0008 Empresa del request: sólo del token, fijada en cada transacción Aceptado 2026-10-05
0009 Autorización: root sólo lectura; permisos por endpoint pendientes Aceptado 2026-10-05
0010 Errores con un handler global y formato {"detail"} Aceptado 2026-10-05
0011 Política CORS: orígenes explícitos y sin credenciales Aceptado 2026-10-05
0012 greenlet mediante el extra sqlalchemy[asyncio] Aceptado 2026-10-05
0013 Variables de entorno desconocidas: se ignoran en vez de impedir el arranque Aceptado 2026-10-06
0014 Esquema fuerza_ventas en lugar de fuerzaventas Aceptado 2026-10-06
0015 Dominio catalogos y CRUD estándar de un catálogo Parcialmente reemplazado por ADR 0018; complementado por ADR 0016, ADR 0017, ADR 0019, ADR 0020 2026-10-06
0016 Catálogo cat_tipos_actividad: color validado y geolocalización por defecto false Aceptado 2026-10-07
0017 Catálogo cat_metodos_pago: requisitos del cobro por defecto false Aceptado 2026-10-07
0018 Listados sin borrados por defecto y filtro ?estado= Aceptado 2026-10-07
0019 Catálogo cat_estados_visita: orden como orden de presentación Aceptado 2026-10-07
0020 Catálogo cat_estados_cobro: columna tipo en vez de banderas Aceptado 2026-10-07
0021 Dominio promotores: una persona por promotor, PUT completo y restauración del borrado Aceptado 2026-10-08
0022 root de sólo lectura en los servicios de negocio Aceptado 2026-10-05
0023 RLS por dependencia y empresa fijada en cada transacción Aceptado 2026-10-05
0024 Esquema plano por servicio Aceptado 2026-10-06

Relación con los ADR transversales

Los ADR de este servicio se escribieron durante la implementación y quedan tal como están. Al contrastarlos con los ADR transversales y con identidad:

ADR Tema Estado Referencia
0009 root de sólo lectura Vigente; origen de la política, que también adoptan clientes (0027) e identidad en /admin ADR 0022
0008 Empresa del token fijada por dependencia y en after_begin, no en middleware Vigente; el transversal 0012 aún describe middleware ADR 0023
0006, 0014 Esquema fuerza_ventas en lugar de crm.fuerza_ventas Vigente; el transversal 0004 propone crm.<servicio> ADR 0024
0009 Permisos por endpoint pendientes y códigos cortos Deuda; identidad emite paths completos y clientes ya los exige ADR 0027 de clientes
0021 El promotor se identifica por persona_id Vigente; identidad expone entidad_id desde el 2026-10-22 ADR 0049 de implementación de identidad