Saltar a contenido

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) y root ven 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 existe que consultan otros servicios.
  • Para fuerza-ventas, GET /api/v1/clientes-promotores/existe/{cliente_id}/{promotor_id}: true si 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 EXISTS sobre rel_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.