Saltar a contenido

Especificación Técnica: mae_sucursales

Esquema: core.identidad
Base de Datos: core
Servicio: svc-identidad
Tabla Legacy Origen: core_sigfa.mae_sucursales
Propósito: Maestro de sucursales por empresa para la operación transaccional del núcleo.


1. Justificación y Mejoras de Arquitectura

  • Pertenece siempre a una empresa (FK obligatoria).
  • Unique (empresa_id, codigo) permite códigos repetibles entre empresas.
  • RLS por empresa actual vía política aislamiento_empresa.
  • Evolución del legacy core_sigfa.mae_sucursales en core.identidad.

2. Definiciones de Implementación

Table core.identidad.mae_sucursales {
    id                         uuid          [pk, default: `gen_random_uuid()`]
    empresa_id                 bigint        [not null, ref: > mae_empresas.id]
    codigo                     varchar(20)   [not null]
    nombre                     varchar(150)  [not null]
    ciudad_id                  uuid          [ref: > cat_ciudades.id]
    is_matriz                  boolean       [not null, default: false, note: 'Indica si es sucursal matriz']
    direccion                  varchar(300) 

    // Auditoría General
    is_activo               boolean       [not null, default: `true`, note: 'Estado lógico del registro']
    created_at              timestamptz   [not null, default: `now()`, note: 'Fecha de creación']
    updated_at              timestamptz   [not null, default: `now()`, note: 'Fecha de última actualización']
    deleted_at              timestamptz   [note: 'Fecha de eliminación lógica']
    created_by              uuid          [note: 'Usuario creador']
    updated_by              uuid          [note: 'Usuario modificador']

    Indexes {
        (empresa_id, codigo) [unique, name: 'uq_mae_sucursales_codigo']
    }

    // RLS por empresa actual
}
CREATE TABLE IF NOT EXISTS core.identidad.mae_sucursales (
    id UUID NOT NULL DEFAULT gen_random_uuid() PRIMARY KEY,
    empresa_id BIGINT NOT NULL,
    codigo VARCHAR(20) NOT NULL,
    nombre VARCHAR(150) NOT NULL,
    ciudad_id UUID,
    is_matriz BOOLEAN NOT NULL DEFAULT false,
    direccion VARCHAR(300),

    -- Auditoría General
    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_mae_sucursales_codigo UNIQUE (empresa_id, codigo),
    CONSTRAINT fk_mae_sucursales_empresa FOREIGN KEY (empresa_id) REFERENCES core.identidad.mae_empresas (id),
    CONSTRAINT fk_mae_sucursales_ciudad FOREIGN KEY (ciudad_id) REFERENCES core.identidad.cat_ciudades (id)
);

-- Row-Level Security
ALTER TABLE core.identidad.mae_sucursales ENABLE ROW LEVEL SECURITY;
CREATE POLICY aislamiento_empresa ON core.identidad.mae_sucursales
    FOR ALL
    USING (empresa_id = NULLIF(current_setting('app.current_empresa_id', true), '')::BIGINT);

-- Comentarios
COMMENT ON COLUMN core.identidad.mae_sucursales.empresa_id IS 'Empresa propietaria';
COMMENT ON COLUMN core.identidad.mae_sucursales.codigo IS 'Código interno de la sucursal';
COMMENT ON COLUMN core.identidad.mae_sucursales.nombre IS 'Nombre de la sucursal';
COMMENT ON COLUMN core.identidad.mae_sucursales.ciudad_id IS 'Ciudad donde se ubica la sucursal';
COMMENT ON COLUMN core.identidad.mae_sucursales.is_matriz IS 'Indica si la sucursal es la matriz de la empresa';
COMMENT ON COLUMN core.identidad.mae_sucursales.direccion IS 'Dirección de la sucursal';