clientes.mae_locales_cliente¶
Propósito¶
Registra los locales o sucursales físicas de cada cliente. Un cliente puede tener varios locales; cada uno conserva su nombre, código, dirección, ciudad y coordenadas. La dirección y ubicación se guardan aquí, no en mae_clientes. Origen legacy: i339t_local_cliente / i339t_locales_cliente, según la documentación consultada; confirmar el nombre físico al preparar la migración.
ciudad_id corresponde al id UUID de core.identidad.cat_ciudades, documentado en la base física core. Es una referencia lógica: PostgreSQL no puede declarar una FK normal entre esa base y CRM. No se crea una proyección de ciudades solo para almacenar el identificador.
Estructura propuesta¶
| Columna | Tipo | Regla |
|---|---|---|
id |
uuid |
Clave primaria |
empresa_id |
bigint |
Empresa propietaria |
cliente_id |
uuid |
Cliente propietario, obligatorio |
codigo |
varchar(30) |
Código único dentro del cliente |
nombre |
varchar(150) |
Nombre del local |
direccion |
text |
Dirección física detallada, obligatoria |
ciudad_id |
uuid |
Ciudad en core, opcional y sin FK física |
latitud / longitud |
numeric(9,6) |
Coordenadas opcionales, juntas y en rango |
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_locales_cliente (
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
empresa_id BIGINT NOT NULL,
cliente_id UUID NOT NULL,
codigo VARCHAR(30) NOT NULL,
nombre VARCHAR(150) NOT NULL,
direccion TEXT NOT NULL,
ciudad_id UUID,
latitud NUMERIC(9,6),
longitud NUMERIC(9,6),
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_locales_cliente_empresa_id UNIQUE (empresa_id, id),
CONSTRAINT uq_locales_cliente_empresa_cliente_codigo
UNIQUE (empresa_id, cliente_id, codigo),
CONSTRAINT fk_locales_cliente
FOREIGN KEY (empresa_id, cliente_id)
REFERENCES clientes.mae_clientes (empresa_id, id),
CONSTRAINT ck_locales_cliente_coordenadas_pareja
CHECK ((latitud IS NULL) = (longitud IS NULL)),
CONSTRAINT ck_locales_cliente_latitud
CHECK (latitud BETWEEN -90 AND 90),
CONSTRAINT ck_locales_cliente_longitud
CHECK (longitud BETWEEN -180 AND 180)
);
CREATE INDEX ix_locales_cliente_empresa_cliente
ON clientes.mae_locales_cliente (empresa_id, cliente_id);
CREATE INDEX ix_locales_cliente_empresa_ciudad
ON clientes.mae_locales_cliente (empresa_id, ciudad_id);
ALTER TABLE clientes.mae_locales_cliente ENABLE ROW LEVEL SECURITY;
CREATE POLICY rls_locales_cliente_empresa
ON clientes.mae_locales_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 integración¶
- La FK al cliente comprueba existencia y misma empresa. No se guarda
cliente_vigente, porque duplicaría un estado derivado del cliente y añadiría otra bandera booleana. El siguiente trigger impide crear, reasignar o reactivar un local si el cliente está inactivo o borrado lógicamente. Los locales ya existentes permanecen como historial cuando el cliente se desactiva después. - La integración con core debe validar que
ciudad_idexista encore.identidad.cat_ciudadesy definir qué hacer si la ciudad se desactiva. Si más adelante se necesita una FK física o consultas sin core, se podrá crear una proyección local que conserve el UUID original y sincronice las ciudades. trx_visitas.local_idreferencia(empresa_id, id)de este maestro. La comprobación de que el local pertenezca al cliente de la actividad, y la protección ante cambios posteriores de dueño, se implementan en la sección de pertenencia detrx_visitas.
CREATE OR REPLACE FUNCTION clientes.fn_validar_cliente_de_local()
RETURNS trigger
LANGUAGE plpgsql
AS $$
DECLARE
v_activo BOOLEAN;
v_deleted_at TIMESTAMPTZ;
BEGIN
IF TG_OP = 'UPDATE' THEN
IF NEW.empresa_id IS NOT DISTINCT FROM OLD.empresa_id
AND NEW.cliente_id IS NOT DISTINCT FROM OLD.cliente_id
AND NOT (NEW.is_activo AND NOT OLD.is_activo)
AND NOT (NEW.deleted_at IS NULL AND OLD.deleted_at IS NOT NULL) THEN
RETURN NEW;
END IF;
END IF;
SELECT c.is_activo, c.deleted_at
INTO v_activo, v_deleted_at
FROM clientes.mae_clientes AS c
WHERE c.empresa_id = NEW.empresa_id
AND c.id = NEW.cliente_id
FOR SHARE;
IF NOT FOUND OR NOT v_activo OR v_deleted_at IS NOT NULL THEN
RAISE EXCEPTION 'El local requiere un cliente activo y vigente';
END IF;
RETURN NEW;
END;
$$;
CREATE TRIGGER trg_validar_cliente_de_local
BEFORE INSERT OR UPDATE ON clientes.mae_locales_cliente
FOR EACH ROW EXECUTE FUNCTION clientes.fn_validar_cliente_de_local();
La aplicación debe mostrar un mensaje claro antes de enviar el alta; el trigger mantiene la regla aunque otro proceso escriba directamente en CRM. La comprobación con FOR SHARE evita que se desactive al cliente en paralelo mientras se confirma el alta. La validación de pertenencia entre visita y local se define junto a trx_visitas.