Saltar a contenido

clientes.cat_clases_cliente

Propósito

Clasifica la cartera de clientes de cada empresa, por ejemplo en clases A, B y C. Responde «¿qué clase comercial tiene este cliente?». Es independiente del canal comercial y de la modalidad de una venta. Se mantiene un único catálogo para este concepto.

No se incluye prioridad_atencion: la clase identifica una categoría, sin imponer un orden operativo de atención. Se conservan todos los campos de auditoría, incluido is_activo.

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 Fecha de borrado lógico, opcional
created_by / updated_by uuid Usuarios de auditoría, opcionales
CREATE TABLE clientes.cat_clases_cliente (
    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_clases_cliente_empresa_id UNIQUE (empresa_id, id),
    CONSTRAINT uq_clases_cliente_empresa_codigo UNIQUE (empresa_id, codigo)
);

ALTER TABLE clientes.cat_clases_cliente ENABLE ROW LEVEL SECURITY;
CREATE POLICY rls_clases_cliente_empresa
    ON clientes.cat_clases_cliente
    USING (empresa_id = current_setting('app.current_empresa_id', true)::BIGINT)
    WITH CHECK (empresa_id = current_setting('app.current_empresa_id', true)::BIGINT);

Cuando se modele clientes.mae_clientes en propuesta-nueva, su clase_cliente_id usará la FK compuesta (empresa_id, clase_cliente_id) → clientes.cat_clases_cliente (empresa_id, id). La restricción UNIQUE (empresa_id, id) permite crearla en PostgreSQL y evita asociar clientes con clases de otra empresa.