0006. Esquema fuerzaventas, columnas comunes y RLS por empresa¶
Estado: Parcialmente reemplazado por ADR 0014
Fecha: 2026-10-05
Autor: David Garcia
Módulo(s) afectado(s): app/core/models.py, alembic/versions/
Modificado por: ADR 0014 — el esquema pasa a fuerza_ventas
Contexto¶
Las tablas de negocio comparten columnas (id, empresa, auditoría) y todas se
aíslan por empresa con RLS (ADR 0012 transversal). crm-svc-clientes ya fijó
el patrón de la política (su ADR 0003). Falta decidir el esquema, cómo se
genera el id y cómo se llena empresa_id sin que el service lo toque.
Decisión¶
- Un solo esquema por ahora:
fuerzaventas, como constanteESQUEMAen el código, no leída deDATABASE_SCHEMAS: el esquema es parte del modelo. EmpresaMixin:idUUID generado por la base conuuidv7()(PostgreSQL 18): ordenado por creación, el índice de la PK crece por el final.empresa_idBIGINT NOT NULLcon defaultNULLIF(current_setting('app.current_empresa_id', true), '')::BIGINT: toma la empresa del request; ni el service ni el cliente la asignan.AuditMixin:is_activo,created_at,updated_at(renovado por el ORM),deleted_at(borrado lógico),created_byyupdated_by(elsubdel token).- Los mixins son independientes: cada modelo combina los que necesita.
- RLS en la misma migración que crea la tabla, con el patrón de clientes:
ENABLE+FORCE+ políticarls_<tabla>_empresaconUSINGyWITH CHECKsobre esa misma expresión.
Alternativas descartadas¶
- Un esquema por dominio (
pedidos,visitas, ...) — más esquemas que crear y permisos que dar sin una ventaja hoy; se revisa con el modelo de datos. gen_random_uuid()(UUID v4) — inserciones dispersas en el índice.- Que el service asigne
empresa_id— basta un olvido para escribir en otra empresa; con el default, la RLS rechaza el INSERT sin empresa.
Consecuencias¶
- Exige PostgreSQL 18 (
uuidv7()). - Un superusuario o un rol con
BYPASSRLSsalta la política: la aplicación debe conectarse con un rol que no lo sea. - Un
UPDATEen SQL directo debe fijarupdated_ata mano.
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.