clientes.trx_perfil_financiero_cliente¶
Propósito¶
Conserva el perfil financiero y operativo anual declarado por un cliente. Es un registro histórico por año, separado de mae_clientes, porque sus valores pueden cambiar entre períodos. No depende del módulo de encuestas configurables. Origen legacy: campos financieros de i133t_cartera_clientes.
Esta versión supone un único perfil consolidado por cliente y año calendario. Una corrección actualiza ese registro y deja rastro en la auditoría; no se crean versiones mientras no exista un requisito legal o de auditoría que las exija.
Estructura propuesta¶
| Columna | Tipo | Regla |
|---|---|---|
id |
uuid |
Clave primaria |
empresa_id |
bigint |
Empresa propietaria |
cliente_id |
uuid |
Cliente al que corresponde el perfil |
anio |
smallint |
Año calendario de los datos |
fecha_declaracion |
date |
Fecha de captura o declaración, opcional |
ingreso |
numeric(16,2) |
Ingreso anual declarado, opcional |
egreso |
numeric(16,2) |
Egreso anual declarado, opcional |
utilidad_bruta |
numeric(16,2) |
Utilidad bruta declarada; puede ser negativa |
utilidad_operativa |
numeric(16,2) |
Utilidad operativa declarada; puede ser negativa |
anios_operaciones |
smallint |
Años de operación declarados, no negativo |
anios_comerciales |
smallint |
Años de actividad comercial declarados, no negativo |
cantidad_empleados |
integer |
Cantidad declarada, no negativa |
cantidad_sucursales |
integer |
Cantidad declarada del negocio del cliente, no negativa |
cantidad_vendedores |
integer |
Cantidad declarada del negocio del cliente, no negativa |
cantidad_clientes |
integer |
Cantidad declarada del negocio del cliente, no negativa |
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.trx_perfil_financiero_cliente (
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
empresa_id BIGINT NOT NULL,
cliente_id UUID NOT NULL,
anio SMALLINT NOT NULL,
fecha_declaracion DATE,
ingreso NUMERIC(16,2),
egreso NUMERIC(16,2),
utilidad_bruta NUMERIC(16,2),
utilidad_operativa NUMERIC(16,2),
anios_operaciones SMALLINT,
anios_comerciales SMALLINT,
cantidad_empleados INTEGER,
cantidad_sucursales INTEGER,
cantidad_vendedores INTEGER,
cantidad_clientes INTEGER,
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_trx_perfil_financiero_empresa_id UNIQUE (empresa_id, id),
CONSTRAINT uq_trx_perfil_financiero_cliente_anio
UNIQUE (empresa_id, cliente_id, anio),
CONSTRAINT fk_trx_perfil_financiero_cliente
FOREIGN KEY (empresa_id, cliente_id)
REFERENCES clientes.mae_clientes (empresa_id, id),
CONSTRAINT ck_trx_perfil_financiero_anio
CHECK (anio BETWEEN 1900 AND 2100),
CONSTRAINT ck_trx_perfil_financiero_ingreso
CHECK (ingreso IS NULL OR ingreso >= 0),
CONSTRAINT ck_trx_perfil_financiero_egreso
CHECK (egreso IS NULL OR egreso >= 0),
CONSTRAINT ck_trx_perfil_financiero_anios_operaciones
CHECK (anios_operaciones IS NULL OR anios_operaciones >= 0),
CONSTRAINT ck_trx_perfil_financiero_anios_comerciales
CHECK (anios_comerciales IS NULL OR anios_comerciales >= 0),
CONSTRAINT ck_trx_perfil_financiero_cantidad_empleados
CHECK (cantidad_empleados IS NULL OR cantidad_empleados >= 0),
CONSTRAINT ck_trx_perfil_financiero_cantidad_sucursales
CHECK (cantidad_sucursales IS NULL OR cantidad_sucursales >= 0),
CONSTRAINT ck_trx_perfil_financiero_cantidad_vendedores
CHECK (cantidad_vendedores IS NULL OR cantidad_vendedores >= 0),
CONSTRAINT ck_trx_perfil_financiero_cantidad_clientes
CHECK (cantidad_clientes IS NULL OR cantidad_clientes >= 0)
);
CREATE INDEX ix_trx_perfil_financiero_empresa_cliente_anio
ON clientes.trx_perfil_financiero_cliente (empresa_id, cliente_id, anio);
ALTER TABLE clientes.trx_perfil_financiero_cliente ENABLE ROW LEVEL SECURITY;
CREATE POLICY rls_trx_perfil_financiero_empresa
ON clientes.trx_perfil_financiero_cliente
USING (empresa_id = current_setting('app.current_empresa_id', true)::BIGINT)
WITH CHECK (empresa_id = current_setting('app.current_empresa_id', true)::BIGINT);
Reglas de interpretación¶
- Los importes se almacenan según la convención monetaria acordada por cada empresa. Esta tabla no guarda
moneda_codigo; no se deben comparar importes entre empresas sin una conversión externa definida. cantidad_sucursales,cantidad_vendedoresycantidad_clientesson cifras declaradas del negocio del cliente. No son conteos automáticos demae_locales_cliente,rel_clientes_promotoresni de otras tablas CRM.- Las utilidades pueden ser negativas cuando representan pérdidas. No se calculan automáticamente a partir de ingreso y egreso, porque sus definiciones contables no están establecidas.
- No se incluyen
facturacion_externa,tiene_instalaciones_propias,tiene_distribucion_propianicliente_vigente. El primer campo no tiene una definición verificable y los dos siguientes son banderas de negocio aún no modeladas; el último duplicaría el estado del cliente. - La FK comprueba existencia y misma empresa, pero no que el cliente siga activo. La operación de alta debe impedir perfiles nuevos para clientes inactivos o borrados lógicamente; los perfiles históricos se conservan si el cliente cambia de estado.
- Las correcciones actualizan la fila del año y sus campos de auditoría. Si el negocio necesita conservar declaraciones sucesivas, habrá que añadir un modelo de revisiones en una etapa posterior.