Saltar a contenido

Especificación Técnica: cfg_modulos

Esquema: core.identidad
Base de Datos: core
Servicio: svc-identidad
Propósito: Configuración de módulos por empresa y aplicación para la navegación del núcleo.


1. Justificación y Mejoras de Arquitectura

  • Configuración por empresa y aplicación: un módulo puede activarse en unas empresas y no en otras.
  • Unique (empresa_id, aplicacion_id, codigo) evita duplicados por contexto.
  • Índices en empresa y aplicación aceleran el armado de la navegación.
  • RLS por empresa actual aísla la configuración.

2. Definiciones de Implementación

Table core.identidad.cfg_modulos {
    id                         uuid          [pk, default: `gen_random_uuid()`]
    empresa_id                 bigint        [not null]
    aplicacion_id              uuid          [not null, ref: > cat_aplicaciones.id]
    codigo                     varchar(50)   [not null]
    nombre                     varchar(150)  [not null]
    descripcion                text         
    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 {
        (empresa_id, aplicacion_id, codigo) [unique, name: 'uq_cfg_modulos_empresa_aplicacion_codigo']
        empresa_id [name: 'ix_cfg_modulos_empresa_id']
        aplicacion_id [name: 'ix_cfg_modulos_aplicacion_id']
    }

    // RLS por empresa actual
}
CREATE TABLE IF NOT EXISTS core.identidad.cfg_modulos (
    id UUID NOT NULL DEFAULT gen_random_uuid() PRIMARY KEY,
    empresa_id BIGINT NOT NULL,
    aplicacion_id UUID NOT NULL,
    codigo VARCHAR(50) NOT NULL,
    nombre VARCHAR(150) NOT NULL,
    descripcion TEXT,
    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_modulos_empresa_aplicacion_codigo UNIQUE (empresa_id, aplicacion_id, codigo),
    CONSTRAINT fk_cfg_modulos_aplicacion FOREIGN KEY (aplicacion_id) REFERENCES core.identidad.cat_aplicaciones (id)
);
CREATE INDEX IF NOT EXISTS ix_cfg_modulos_empresa_id ON core.identidad.cfg_modulos (empresa_id);
CREATE INDEX IF NOT EXISTS ix_cfg_modulos_aplicacion_id ON core.identidad.cfg_modulos (aplicacion_id);

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

-- Comentarios
COMMENT ON COLUMN core.identidad.cfg_modulos.empresa_id IS 'Empresa configurada';
COMMENT ON COLUMN core.identidad.cfg_modulos.aplicacion_id IS 'Aplicación propietaria del módulo';
COMMENT ON COLUMN core.identidad.cfg_modulos.codigo IS 'Código del módulo';
COMMENT ON COLUMN core.identidad.cfg_modulos.nombre IS 'Nombre del módulo';
COMMENT ON COLUMN core.identidad.cfg_modulos.descripcion IS 'Descripción del módulo';
COMMENT ON COLUMN core.identidad.cfg_modulos.icono IS 'Clase o ruta del ícono';
COMMENT ON COLUMN core.identidad.cfg_modulos.orden IS 'Orden de presentación';
COMMENT ON COLUMN core.identidad.cfg_modulos.is_visible IS 'Visible en la navegación';