Módulos externos

Los módulos externos amplían NexGestión para un sector, proceso o integración concreta sin modificar el núcleo del CRM. Esta sección está dirigida a proveedores, partners y equipos que construyen extensiones instalables para clientes.

Qué aprenderás

• cómo organizar y empaquetar un módulo;
• cómo declarar su contrato en manifest.json;
• cómo añadir vistas, acciones y puntos de extensión;
• cómo proteger operaciones de equipo y endpoints públicos;
• cómo integrar tareas, calendario, notificaciones, automatizaciones y agentes IA;
• cómo preparar una versión publicable y mantenible.

Contrato público v1. Los ejemplos son genéricos y usan valores ficticios. No incluyen código del núcleo, rutas privadas, credenciales ni procedimientos de despliegue interno.

Recorrido recomendado

1. Lee la introducción y decide qué responsabilidad tendrá tu módulo.
2. Prepara la estructura del paquete y el manifest.
3. Implementa vistas y acciones con permisos claros.
4. Elige los mounts y extensiones que realmente necesites.
5. Si tu módulo recibe tráfico externo, separa sus endpoints públicos.
6. Revisa seguridad, HTMX y UI y las integraciones de IA y automatizaciones.
7. Termina con la guía de publicación y mantenimiento.

Principios de diseño

Principio	Aplicación práctica
Una responsabilidad	El módulo resuelve un problema reconocible y no duplica todo el CRM.
Contrato explícito	Las vistas, acciones, permisos, mounts y dependencias se declaran.
Seguridad por defecto	El módulo valida el contexto, los datos y el método HTTP en cada operación.
Evolución compatible	Los cambios de contrato se versionan y se documentan.
Integración nativa	Se reutilizan capacidades de clientes, tareas, calendario y notificaciones.

Qué no pertenece a esta guía

No se publica aquí código del core, esquema interno de base de datos, credenciales, infraestructura, migraciones privadas, rutas administrativas del servidor ni procedimientos de soporte interno. Para integrar sistemas externos consulta también Integraciones.