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.