Saltar a contenido

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_id exista en core.identidad.cat_ciudades y 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_id referencia (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 de trx_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.