---
title: Módulos y dependencias
slug: modulos-y-dependencias
description: Catálogo de módulos configurables por empresa, objetos habilitados y dependencias operativas.
audiencia: Administrador | Superadministrador | Data Owner | Data Steward | Ingeniero de datos
roles: Superadministrador o Administrador para cambiar módulos; consulta para otros perfiles
modulo: Administración de empresa
estado: Comportamiento actual validado
revision: "2026-10-19"
section: referencia
order: 20
sources:
  - "Módulosydependencias.md"
---

# Módulos y dependencias

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:

```text
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:

1. Selecciona la empresa activa.
2. Abre **Módulos**.
3. Revisa el grupo y la descripción de cada módulo.
4. Consulta el impacto: la plataforma muestra cuántos registros quedarán ocultos.
5. Confirma el cambio.
6. 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.

## Contenido relacionado

- [Roles, capacidades y alcance](/es/referencia/roles-capacidades-y-alcance/)
- [Modelo de objetos y relaciones](/es/explicaciones/modelo-de-objetos-y-relaciones/)
- [Cómo leer el mapa de relaciones](/es/guias/como-leer-mapa-de-relaciones/)
- [Configurar una empresa](/es/administrar-empresa/configurar-empresa/)