Módulos de producto

No todas las instituciones compran lo mismo. Cada tenant tiene una lista de módulos habilitados (enabledProductModules), configurable en Institución → Capacidades, y esa lista decide tres cosas: qué se ve en la navegación, qué se ve en el portal, y qué endpoints responden.

Si un endpoint del Client API devuelve 403 MODULE_DISABLED, el token está bien: lo que falta es el módulo en la institución. Revisa platform_integrations y el módulo funcional del recurso que estás tocando.

El registro canónico

Los ids son estables y viven en packages/shared/src/product-modules/registry.ts. La API solo acepta subconjuntos de esta lista.

Capa application: funcionalidad que usa la gente.
Capa platform: capacidades transversales de las que cuelgan otras.
Por defecto: si una institución nueva lo recibe encendido (estrategia opt-out) o no (opt-in).
Configurable: si un administrador puede apagarlo desde la interfaz.

Staff — el dashboard administrativo

Módulo	Nombre	Por defecto	Configurable
`staff_students`	Estudiantes	sí	sí
`staff_courses`	Cursos	sí	sí
`staff_programs`	Programas	sí	sí
`staff_grades`	Calificaciones	sí	sí
`staff_attendance`	Asistencia	sí	sí
`staff_enrollments`	Matrículas	sí	sí
`staff_admissions`	Admisiones	sí	sí
`staff_communications`	Comunicaciones	sí	sí
`staff_scheduling`	Agenda y citas	sí	sí
`staff_vault`	Vault documental	sí	sí
`staff_payments`	Pagos	sí	sí
`staff_forms`	Formularios	sí	sí
`staff_reports`	Reportes	sí	sí
`staff_pqrs`	PQRS	no	sí
`staff_public_pages`	EdFlyer	no	sí
`staff_academy`	Academy	sí	no
`staff_support`	Soporte	sí	no

PQRS y EdFlyer son módulos especializados: se encienden en la institución que los pide. Academy y Soporte no se apagan — son parte de la plataforma.

Portal — familias y estudiantes

Todos cuelgan de portal_base. Apagar la base apaga el portal entero.

Módulo	Nombre	Requiere	Por defecto
`portal_base`	Portal estudiantil (base)	—	sí
`portal_grades`	Calificaciones	`portal_base`	sí
`portal_fees`	Cuotas	`portal_base`	sí
`portal_program`	Programa	`portal_base`	sí
`portal_attendance`	Asistencia	`portal_base`	sí
`portal_messages`	Mensajes	`portal_base`	sí
`portal_calendar`	Calendario	`portal_base`	sí
`portal_pqrs`	PQRS	`portal_base`	sí

Plataforma

Módulo	Nombre	Por defecto	Para qué
`platform_integrations`	Integraciones	no	Requisito del Client API. Sin esto no hay API keys ni webhooks.
`platform_workflows`	Automatizaciones	sí	Notificaciones, bots de conversación, tareas disparadas por evento.

Cómo lo ve tu integración

GET /api/client/v1/me devuelve enabledModules con la lista efectiva de la institución. Consúltalo al arrancar en vez de asumir: es la diferencia entre un error claro en tu despliegue y un 403 intermitente en producción.

{
  "data": {
    "tenant": { "id": "...", "slug": "colegio-abc", "name": "Colegio ABC" },
    "apiKey": {
      "id": "...",
      "name": "SIS producción",
      "scopes": ["students:read", "students:write"],
      "masterDomains": ["students"],
      "rateLimit": { "requestsPerMinute": 120 }
    },
    "productAccess": {
      "enabledModules": ["platform_integrations", "staff_students", "..."],
      "sorByDomain": { "students": "external_master", "grades": "edtools_master" }
    }
  }
}

La navegación del dashboard, la barra del portal y la paleta de comandos (⌘K) filtran contra esta misma lista. Un módulo apagado no es un enlace escondido: es una capacidad que no existe para esa institución.

Empezar

La plataforma

Client API

Módulos de producto

El registro canónico

Staff — el dashboard administrativo

Portal — familias y estudiantes

Plataforma

Cómo lo ve tu integración

​El registro canónico

​Staff — el dashboard administrativo

​Portal — familias y estudiantes

​Plataforma

​Cómo lo ve tu integración

El registro canónico

Staff — el dashboard administrativo

Portal — familias y estudiantes

Plataforma

Cómo lo ve tu integración