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';