Saltar a contenido

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