clientes.cat_tipos_clientes¶
Propósito¶
Clasifica la naturaleza jurídica del cliente. Los valores previstos son PERSONA_NATURAL y PERSONA_JURIDICA; se configuran por empresa. No describe su canal, rol comercial, clase A/B/C ni modalidad de venta. Por tanto, DISTRIBUIDOR, MAYORISTA y DETALLISTA no pertenecen a este catálogo.
El CRM usará una sola definición de esta naturaleza jurídica. Antes de migrar datos se debe comprobar si core.identidad ya aporta este dato y acordar cuál sistema lo gobierna, para evitar discrepancias entre bases.
Estructura propuesta¶
| Columna | Tipo | Regla |
|---|---|---|
id |
uuid |
Clave primaria |
empresa_id |
bigint |
Empresa propietaria |
codigo |
varchar(30) |
Código estable, único por empresa |
nombre |
varchar(100) |
Nombre visible |
descripcion |
text |
Explicación opcional |
is_activo |
boolean |
Estado administrativo; por defecto true |
created_at / updated_at |
timestamptz |
Fechas de auditoría obligatorias |
deleted_at |
timestamptz |
Borrado lógico, opcional |
created_by / updated_by |
uuid |
Usuarios de auditoría, opcionales |
CREATE TABLE clientes.cat_tipos_clientes (
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
empresa_id BIGINT NOT NULL,
codigo VARCHAR(30) NOT NULL,
nombre VARCHAR(100) NOT NULL,
descripcion TEXT,
is_activo BOOLEAN NOT NULL DEFAULT true,
created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
updated_at TIMESTAMPTZ NOT NULL DEFAULT now(),
deleted_at TIMESTAMPTZ,
created_by UUID,
updated_by UUID,
CONSTRAINT uq_tipos_clientes_empresa_id UNIQUE (empresa_id, id),
CONSTRAINT uq_tipos_clientes_empresa_codigo UNIQUE (empresa_id, codigo)
);
ALTER TABLE clientes.cat_tipos_clientes ENABLE ROW LEVEL SECURITY;
CREATE POLICY rls_tipos_clientes_empresa
ON clientes.cat_tipos_clientes
USING (empresa_id = current_setting('app.current_empresa_id', true)::BIGINT)
WITH CHECK (empresa_id = current_setting('app.current_empresa_id', true)::BIGINT);
Contrato para clientes.mae_clientes¶
Cuando se modele la nueva mae_clientes, guardará tipo_cliente_id UUID NOT NULL con esta referencia:
CONSTRAINT fk_mae_clientes_tipo_cliente
FOREIGN KEY (empresa_id, tipo_cliente_id)
REFERENCES clientes.cat_tipos_clientes (empresa_id, id)
UNIQUE (empresa_id, id) permite crear la FK compuesta en PostgreSQL y garantiza que el tipo pertenezca a la misma empresa. La clasificación jurídica es independiente del tipo_canal_id comercial definido para el cliente.