Especificación Técnica: cfg_menu¶
Esquema: core.identidad
Base de Datos: core
Servicio: svc-identidad
Propósito: Menú jerárquico por empresa y módulo: hasta tres niveles de navegación.
1. Justificación y Mejoras de Arquitectura¶
- Menú con jerarquía (padre_id) y niveles 1..3 validados por CHECK.
- Unique (modulo_id, codigo) evita códigos repetidos dentro de un módulo.
- Ruta frontend e ícono para renderizado en el cliente web.
- RLS por empresa actual aísla la configuración por empresa.
2. Definiciones de Implementación¶
Table core.identidad.cfg_menu {
id uuid [pk, default: `gen_random_uuid()`]
empresa_id bigint [not null]
modulo_id uuid [not null, ref: > cfg_modulos.id]
padre_id uuid [ref: > cfg_menu.id]
nivel smallint [not null]
codigo varchar(50) [not null]
nombre varchar(150) [not null]
ruta_frontend varchar(200)
icono varchar(50)
orden int [not null, default: `0`]
is_visible boolean [default: `true`]
// 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 {
(modulo_id, codigo) [unique, name: 'uq_cfg_menu_modulo_codigo']
empresa_id [name: 'ix_cfg_menu_empresa_id']
modulo_id [name: 'ix_cfg_menu_modulo_id']
padre_id [name: 'ix_cfg_menu_padre_id']
nivel [name: 'ix_cfg_menu_nivel']
}
// RLS por empresa actual
}
CREATE TABLE IF NOT EXISTS core.identidad.cfg_menu (
id UUID NOT NULL DEFAULT gen_random_uuid() PRIMARY KEY,
empresa_id BIGINT NOT NULL,
modulo_id UUID NOT NULL,
padre_id UUID,
nivel SMALLINT NOT NULL,
codigo VARCHAR(50) NOT NULL,
nombre VARCHAR(150) NOT NULL,
ruta_frontend VARCHAR(200),
icono VARCHAR(50),
orden INTEGER NOT NULL DEFAULT 0,
is_visible BOOLEAN DEFAULT true,
-- 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_cfg_menu_modulo_codigo UNIQUE (modulo_id, codigo),
CONSTRAINT fk_cfg_menu_modulo FOREIGN KEY (modulo_id) REFERENCES core.identidad.cfg_modulos (id),
CONSTRAINT fk_cfg_menu_padre FOREIGN KEY (padre_id) REFERENCES core.identidad.cfg_menu (id),
CONSTRAINT ck_cfg_menu_nivel CHECK (nivel IN (1, 2, 3))
);
CREATE INDEX IF NOT EXISTS ix_cfg_menu_empresa_id ON core.identidad.cfg_menu (empresa_id);
CREATE INDEX IF NOT EXISTS ix_cfg_menu_modulo_id ON core.identidad.cfg_menu (modulo_id);
CREATE INDEX IF NOT EXISTS ix_cfg_menu_padre_id ON core.identidad.cfg_menu (padre_id);
CREATE INDEX IF NOT EXISTS ix_cfg_menu_nivel ON core.identidad.cfg_menu (nivel);
-- Row-Level Security
ALTER TABLE core.identidad.cfg_menu ENABLE ROW LEVEL SECURITY;
CREATE POLICY aislamiento_empresa ON core.identidad.cfg_menu
FOR ALL
USING (empresa_id = NULLIF(current_setting('app.current_empresa_id', true), '')::BIGINT);
-- Comentarios
COMMENT ON COLUMN core.identidad.cfg_menu.empresa_id IS 'Empresa configurada';
COMMENT ON COLUMN core.identidad.cfg_menu.modulo_id IS 'Módulo propietario del menú';
COMMENT ON COLUMN core.identidad.cfg_menu.padre_id IS 'Menú padre (autoreferencia)';
COMMENT ON COLUMN core.identidad.cfg_menu.nivel IS 'Nivel jerárquico (1..3)';
COMMENT ON COLUMN core.identidad.cfg_menu.codigo IS 'Código del menú';
COMMENT ON COLUMN core.identidad.cfg_menu.nombre IS 'Nombre del menú';
COMMENT ON COLUMN core.identidad.cfg_menu.ruta_frontend IS 'Ruta de la aplicación frontend';
COMMENT ON COLUMN core.identidad.cfg_menu.icono IS 'Clase o ruta del ícono';
COMMENT ON COLUMN core.identidad.cfg_menu.orden IS 'Orden de presentación';
COMMENT ON COLUMN core.identidad.cfg_menu.is_visible IS 'Visible en la navegación';