Primeros pasos
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 exte
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
- Lee la introducción y decide qué responsabilidad tendrá tu módulo.
- Prepara la estructura del paquete y el manifest.
- Implementa vistas y acciones con permisos claros.
- Elige los mounts y extensiones que realmente necesites.
- Si tu módulo recibe tráfico externo, separa sus endpoints públicos.
- Revisa seguridad, HTMX y UI y las integraciones de IA y automatizaciones.
- 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.