Saltar a contenido

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 constante ESQUEMA en el código, no leída de DATABASE_SCHEMAS: el esquema es parte del modelo.
  • EmpresaMixin:
  • id UUID generado por la base con uuidv7() (PostgreSQL 18): ordenado por creación, el índice de la PK crece por el final.
  • empresa_id BIGINT NOT NULL con default NULLIF(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_by y updated_by (el sub del 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ítica rls_<tabla>_empresa con USING y WITH CHECK sobre 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 BYPASSRLS salta la política: la aplicación debe conectarse con un rol que no lo sea.
  • Un UPDATE en SQL directo debe fijar updated_at a 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.