Los módulos controlan qué áreas de GovFrame están disponibles para cada empresa. La configuración pertenece al tenant y se aplica en dos capas:
- Frontend: oculta rutas, accesos rápidos y componentes que no corresponden.
- Backend: rechaza consultas y mutaciones del módulo desactivado.
Los datos existentes no se eliminan automáticamente al desactivar un módulo; quedan fuera de la operación visible hasta que el módulo vuelva a activarse, según la política de la empresa.
Catálogo actual
| Módulo | Clave | Grupo | Qué habilita | Dependencias declaradas |
|---|---|---|---|---|
| Términos de negocio | businessTerms |
Gobierno | Glosario, definiciones y relaciones semánticas. | — |
| Roles de gobierno | governanceRoles |
Gobierno | Owners, Stewards y perfiles de responsabilidad del catálogo. | — |
| Reglas de calidad | qualityRules |
Gobierno | Reglas, dimensiones, validaciones y SQL SELECT generado. | Diccionario técnico, Repositorios |
| Políticas | policies |
Gobierno | Políticas, procesos, procedimientos, versiones y evidencias. | — |
| Objetivos y KPI | kpis |
Gobierno | Objetivos, KPI/Key Results, mediciones, revisiones y enlaces. | — |
| Diccionario técnico | technicalDictionary |
Arquitectura | Tablas, campos, descripciones y asociaciones con atributos. | Repositorios |
| Repositorios de datos | dataRepositories |
Arquitectura | Bases o plataformas analíticas/operacionales, conexiones y metadata. | — |
| Sistemas | systems |
Arquitectura | Sistemas de origen, consumo o soporte del ecosistema. | — |
| Datos no estructurados | unstructuredData |
Arquitectura | Fuentes y activos no estructurados asociados a la taxonomía. | — |
| Activos de datos | dataAssets |
Arquitectura | Datasets, APIs, reportes y otros activos gobernables. | — |
| Productos de datos | dataProducts |
Entrega | Productos compuestos por activos, contratos y responsabilidad. | Activos de datos, Contratos |
| Contratos de datos | dataContracts |
Entrega | Compromisos, atributos, reglas, campos, términos, sistemas y consumidores. | Activos de datos, Diccionario técnico, Reglas de calidad |
| Workflows de gobierno | workflows |
Gobierno | Casos, etapas, tareas, aprobaciones, SLA, evidencias y excepciones. | — |
| Explorador de relaciones | relationshipExplorer |
Experiencia | Panorama, Impacto y Detalle técnico del ecosistema. | Términos, Reglas de calidad, Diccionario técnico |
La configuración usa true/false por clave. Los módulos se crean activos por defecto en la configuración inicial, salvo que la empresa establezca otra política durante el alta.
Dependencias y orden recomendado
Para una implementación progresiva:
1. Taxonomía y acceso
2. Repositorios de datos
3. Diccionario técnico
4. Términos de negocio
5. Reglas de calidad
6. Activos y Productos
7. Contratos
8. Workflows y solicitudes
9. KPI, políticas y Explorador de relaciones
Relaciones importantes:
- No hay Diccionario técnico útil sin un Repositorio registrado.
- Las Reglas de calidad pueden existir sin SQL generado, pero para generar SQL requieren asociaciones válidas a campos físicos y un dialecto configurado.
- Un Contrato puede guardar atributos, reglas, campos, términos y sistemas; por eso conviene activar sus módulos relacionados.
- Un Producto se compone de Activos y puede relacionarse con Contratos.
- El Explorador puede abrirse con una taxonomía, pero su vista técnica aporta más valor cuando existen Términos, Reglas y Diccionario técnico.
Qué ocurre al desactivar un módulo
| Situación | Comportamiento esperado |
|---|---|
| Ruta directa del módulo | La aplicación muestra un estado de módulo desactivado y no permite operar. |
| Menú o acceso rápido | El acceso desaparece; no se deja un bloque vacío sin función. |
| Consulta tRPC del módulo | El backend la rechaza mediante la validación de módulo. |
| Mutación del módulo | El backend la rechaza aunque se intente invocar manualmente. |
| Datos previamente creados | Se conservan; la pantalla de administración informa el impacto antes de confirmar. |
| Dependencia desactivada | La función que depende de ella puede ocultarse, quedar limitada o rechazar operaciones según el contrato del procedimiento. |
| Reactivación | La visibilidad y operación vuelven a estar disponibles, sujetas a roles, alcance y estado de los datos. |
Desactivar un módulo no revoca por sí solo los roles tenant, pero una modificación sensible de rol o alcance sí debe invalidar sesiones conforme a la política de seguridad.
Configurar módulos
La gestión se realiza desde la administración de empresas:
- Selecciona la empresa activa.
- Abre Módulos.
- Revisa el grupo y la descripción de cada módulo.
- Consulta el impacto: la plataforma muestra cuántos registros quedarán ocultos.
- Confirma el cambio.
- Verifica menú, rutas y respuestas del módulo.
La persona que configura módulos debe tener capacidad de administración de plataforma o la autorización equivalente. El usuario final no puede activar un módulo modificando parámetros en el navegador.