Saltar a contenido

ADR — svc-clientes

Registro de decisiones de arquitectura de svc-clientes (cartera, contactos, historial). Proviene del repositorio del servicio (crm-svc-clientes/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–0038).

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

Índice

ADR Título Estado Fecha
0001 Stack, dependencias y herramientas de calidad Propuesto 2026-09-24
0002 Estructura del proyecto: monolito modular por dominio Propuesto 2026-09-24
0003 RLS por empresa en la misma migración que su tabla Propuesto 2026-09-25
0004 Modelos ORM del servicio de clientes Propuesto 2026-09-28
0005 Contratos de API con schemas Pydantic Propuesto 2026-09-29
0006 Empresa del request provisional hasta que exista svc-identidad Propuesto 2026-09-29
0007 Errores de dominio con un handler global y formato {"detail"} Propuesto 2026-09-29
0008 CRUD de los catálogos — primer slice: canales comerciales Propuesto 2026-09-29
0009 Prefijo de versión de la API en cada router Propuesto 2026-09-29
0010 CRUD de los catálogos — segundo slice: clases de cliente Propuesto 2026-09-29
0011 CRUD de los catálogos — tercer slice: estados de prospecto Propuesto 2026-09-30
0012 CRUD de los catálogos — cuarto slice: modelos comerciales Propuesto 2026-09-30
0013 CRUD de los catálogos — quinto slice: términos de pago Propuesto 2026-09-30
0014 CRUD de los catálogos — sexto slice: unidades comerciales Propuesto 2026-09-30
0015 CRUD de los catálogos — séptimo slice: tipos de canal comercial Propuesto 2026-09-30
0016 CRUD de los catálogos — octavo slice: tipos de clientes Propuesto 2026-09-30
0017 Dominio clientes — primer slice: grupos económicos Propuesto 2026-09-30
0018 Dominio clientes — segundo slice: contactos del cliente Propuesto 2026-09-30
0019 Dominio clientes — tercer slice: clientes Propuesto 2026-09-30
0020 Dominio clientes — cuarto slice: locales del cliente Propuesto 2026-10-01
0021 Dominio clientes — quinto slice: relación cliente–contactos Propuesto 2026-10-01
0022 Dominio clientes — sexto slice: perfil financiero Propuesto 2026-10-01
0023 Dominio clientes — séptimo slice: relación cliente–promotores Propuesto 2026-10-01
0024 Dominio clientes — octavo slice: prospectos y su conversión Propuesto 2026-10-01
0025 Validar por API las referencias a svc-identidad: tipo de identificación y ciudad Propuesto 2026-10-22
0026 Validar por API el promotor contra crm-svc-fuerza-ventas Propuesto 2026-10-26
0027 Permisos por menú de identidad y root de sólo lectura Aceptado 2026-10-26
0028 Cartera del promotor: alta con promotor y transferencia dentro del alcance Aceptado 2026-10-26
0029 Cada usuario ve sólo la cartera de su alcance Aceptado 2026-10-26
0030 Auditoría propia del servicio e historial por registro Aceptado 2026-10-27
0031 Historial por rango de fechas Aceptado 2026-10-28
0032 Historial por usuario Aceptado 2026-10-29
0033 Datos comerciales del prospecto Aceptado 2026-10-29
0034 Historial del cliente que salió de la cartera Aceptado 2026-10-29
0035 Referencias para que otro servicio copie el nombre al registrar Aceptado 2026-10-31
0036 Alineación con los transversales: Python 3.14, uuidv7 y empresa del JWT Aceptado 2026-10-07
0037 Validación de referencias con el token del usuario Aceptado 2026-10-26
0038 Auditoría propia del servicio Aceptado 2026-10-27

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, el estado real es este:

ADR Tema Estado Referencia
0001, 0004, 0006 Python 3.12, UUID v4 y cabecera X-Empresa-Id provisional Resuelto en el código el 2026-10-02 y el 2026-10-07; el texto de esos ADR quedó viejo ADR 0036
— (commit 9fd639d, 2026-10-13) RLS fijada al inicio de cada transacción, no en middleware Vigente; el transversal 0012 aún describe middleware ADR 0023 de fuerza-ventas
0025, 0026 Validación de referencias con el token del usuario en vez de service account Vigente; se desvía del transversal 0012 ADR 0037
0027 root de sólo lectura en este servicio Vigente; se desvía del transversal 0006 ADR 0022 de fuerza-ventas
0030 Auditoría propia (aud_eventos/aud_cambios) en vez de audit_log Vigente; modifica el transversal 0014 ADR 0038
0004 Esquema clientes en lugar de crm.clientes Vigente; el transversal 0004 propone crm.<servicio> ADR 0024 de fuerza-ventas