Ecosistema del integrador
Quién construye, dónde viven los datos y cómo se relacionan la aplicación, el núcleo y Hermes.
Alcance y estado
Esta guía recoge los diagramas y las aclaraciones de producto facilitados el 14 de septiembre de 2026. «Implementado» identifica el estado comunicado para este material; no certifica la disponibilidad en todos los entornos. Las propuestas se indican expresamente.
Abrir gráfico interactivo y ampliar · Ver imagen a tamaño completo
El texto de la guía desarrolla el gráfico para que puedas seguir el recorrido también sin utilizar el visor.
El integrador puede entregar una aplicación para personas, una skill para Hermes o una solución que combine ambas. Los tres recorridos de construcción y distribución comparten el núcleo de Pimia, pero no tienen los mismos mecanismos de acceso ni de instalación.
Actores y responsabilidades
| Pieza | Responsabilidad |
|---|---|
| Integrador | Desarrollar y desplegar su aplicación y, cuando los necesita, los datos y funciones de su módulo. |
| App de la vertical | Ofrecer la experiencia de marca del integrador y consumir Pimia mediante el SDK. |
| Núcleo Pimia | Mantener clientes, catálogo, facturas y las reglas de autorización y negocio de sus recursos. |
| Backend del módulo | Guardar los datos propios de la ampliación; el diseño mostrado utiliza InsForge. |
| Hermes del tenant | Ejecutar las skills en el contexto de la instancia de la pyme. |
| Plataforma central y marketplace airealb | Gestionar la relación con el integrador, la publicación y la distribución de las soluciones. |
Dos entregables y dos accesos
La persona utiliza la aplicación de la vertical desde el navegador. En el fork descrito, el navegador lleva la cookie de sesión y el servidor conserva los tokens: el SDK accede al núcleo con un grant OAuth del tenant.
Hermes utiliza el MCP del tenant con su propio token. Una skill queda acoplada a ese entorno, sus herramientas y sus datos; no debe presentarse como un paquete autónomo portable a cualquier agente. Este acoplamiento es lo que el material llama foso.
La vinculación comercial, la suscripción y la instalación no conceden por sí solas permisos de ejecución.
Dónde viven los datos
Los recursos de Pimia se consultan y modifican mediante sus interfaces autorizadas. InsForge conserva los datos propios del módulo; las referencias como external_ref, cuando el recurso las admite, permiten relacionarlos con Pimia.
| Enlace | Estado comunicado | Contrato |
|---|---|---|
| Servicio → Pimia con token prestado | Implementado | Reenvío por petición, sin refresco ni grant propio del servicio. |
| App → InsForge con JWT del host | Propuesta | Identidad y contexto para RLS; no transporta permisos de Pimia. |
| Hermes → herramientas del módulo | Propuesta | Integración por concretar; no se presenta como disponible. |
Los contratos se desarrollan en Crea módulos y skills.
Capture es una entrada opcional
El material sitúa Pimia Capture en desarrollo y lo describe como una fuente de oportunidades basada en metadatos del puesto. No es un requisito para crear una vertical ni una certificación de cumplimiento: el detalle de los metadatos enviados y su tratamiento necesita su propia especificación.
Elige tu recorrido
- Crea tu ERP vertical: cuenta, aplicación, despliegue y clientes.
- Crea módulos y skills: lógica sectorial, herramientas, verificación y registro.
- Publica y distribuye: catálogo, suscripción y ejecución en el tenant.