Saltar a contenido

clientes.mae_grupos_economicos

Propósito

Identifica los grupos económicos que reúnen clientes o razones sociales relacionadas. Origen legacy: i143t_grupo_economico. En la nueva propuesta se usa el nombre mae_ porque el grupo se tratará como una entidad de negocio con identidad propia y miembros. Sustituye el concepto del antiguo cat_grupos_economicos; no se crean ambas tablas.

El grupo no es un cliente padre y no requiere cliente_padre_id. Tampoco se almacenan aquí datos de crédito o cupo global: esos aspectos se modelarán en su contexto cuando corresponda.

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(150) Nombre del grupo
descripcion text Descripció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.mae_grupos_economicos (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    empresa_id BIGINT NOT NULL,
    codigo VARCHAR(30) NOT NULL,
    nombre VARCHAR(150) 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_grupos_economicos_empresa_id UNIQUE (empresa_id, id),
    CONSTRAINT uq_grupos_economicos_empresa_codigo UNIQUE (empresa_id, codigo)
);

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

Relación con clientes

Cada cliente puede pertenecer a cero o un grupo económico actual. mae_clientes.grupo_economico_id UUID es nullable y referencia (empresa_id, id) de esta tabla mediante una FK compuesta; UNIQUE (empresa_id, id) hace válida esa referencia y protege la tenencia. No se necesita una tabla de relación para la pertenencia actual. El cambio histórico de grupo no se almacena en esta estructura; se podrá añadir historial si el negocio lo requiere.