0029. Cada usuario ve sólo la cartera de su alcance¶
Estado: Aceptado Fecha: 2026-10-26 Autor: David Garcia Módulo(s) afectado(s): app/domains/clientes/, app/adaptadores/fuerza_ventas/, tests/unit/
Contexto¶
La RLS separa empresas, pero dentro de una empresa quien tiene el permiso de
listar (ADR 0027) ve todos los clientes y prospectos; ?promotor_id= es un
filtro de pantalla, no seguridad. Negocio decidió que un promotor ve sólo su
cartera y un supervisor la de su equipo. La cartera es un dato de clientes
(ADR 0028); a quiénes ve el usuario lo sabe fuerza-ventas (GET
/api/v1/alcance, su ADR 0055).
Decisión¶
- Se filtra por el alcance, que se consulta una vez por request en los endpoints del dominio de clientes:
- Clientes: los que tienen una asignación activa a un promotor del alcance.
- Lo del cliente (locales, perfiles financieros, vínculos con contactos, asignaciones): si se ve su cliente.
- Prospectos: los de un promotor del alcance.
- Contactos: los vinculados a un cliente visible. Uno sin vínculo
activo (recién creado, o al que le quitaron el último) sólo lo ve quien
lo creó (
created_by). - Por id, lo ajeno es 404, como lo inexistente; también para escribir. Un
?promotor_id=ajeno da una lista vacía. - El administrador (
promotor_ids = null) yrootven todo. Quien no es promotor no ve nada: listas vacías. - Sin filtro: los catálogos y los grupos económicos (no son de un
promotor), y los
existeque consultan otros servicios. - Para fuerza-ventas,
GET /api/v1/clientes-promotores/existe/{cliente_id}/{promotor_id}:truesi el cliente está activo y tiene asignado a ese promotor. Con?en=<fecha y hora>, si lo tenía asignado en ese momento (la asignación se creó antes y no se había borrado), para lo tomado sin conexión. Sólo pide token (SIN_PERMISO) y no se filtra por alcance: fuerza-ventas ya comprueba que el promotor es del alcance de su usuario, y filtrarlo obligaría a clientes a volver a llamar a fuerza-ventas dentro de su propia consulta.
Alternativas descartadas¶
- Copia local de promotores y supervisión por eventos — las lecturas no llamarían a nadie, pero no hay bus; es el reemplazo cuando exista.
- Caché del alcance entre requests — un equipo cambiado o un promotor borrado seguiría viendo hasta que venza (fuerza-ventas la descartó por lo mismo, su ADR 0048).
- Ocultar lo ajeno con 403 — confirmaría que existe.
Consecuencias¶
- Cada request del dominio de clientes suma una llamada a fuerza-ventas (del orden de cien milisegundos medido en local), y si fuerza-ventas cae nadie ve clientes ni prospectos (503). Es el costo mayor de esta decisión.
- Clientes sin asignación y prospectos sin promotor sólo los ve el administrador hasta que se asignen; conviene asignarlos antes de desplegar.
- Los listados filtran con un
EXISTSsobrerel_clientes_promotores; su índice(empresa_id, promotor_id)ya existe.
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.