Plugin Developer Handbook¶
Documentación para construir módulos de negocio en HIVE: API REST, UI declarativa y registro en namespaces de panel.
Empieza por Introducción si es tu primera vez.
Fundamentos¶
-
Por qué extender vía plugins y mapa del handbook.
-
SPI, descriptor, hooks y diferencia con
cortex.panels. -
Carpetas, archivos y responsabilidades.
-
Discovery, activación, paneles generativos y namespaces.
-
Tutorial paso a paso desde
_template. -
Bootstrap vs runtime, orden de hooks.
Referencia API y CUS¶
-
ResourceBuilder, FormBuilder y SPI del sandbox
helloworld. -
Contratos de listados y convenciones HTTP.
-
CRUD con
ResourceBuilderyregister_resources. -
Tipos de campo, validación y JSON Forms.
-
Listados, filtros, orden y paginación.
-
Botones de cabecera, fila y operaciones masivas.
-
Vista de solo lectura de un registro.
-
Registros relacionados en edición.
-
Composición de pantallas por plugin.
-
Catálogo CUS y contrato de configuración.
-
Segmentos de ajustes por panel.
-
Contribuir un módulo a un namespace.
-
Namespaces y paneles generativos
operations,admin,ensure_panelycortex.panelsopcional. -
Tools para agentes y namespaces WS.
-
Listeners, observers y broadcasting.
-
PostgreSQL, Alembic y aprovisionamiento.
-
Integración con facturación electrónica.
Operación y calidad¶
-
Un repo GitHub por plugin; submódulo en
cortex-hive. -
/control/pluginsy state store PostgreSQL. -
Wheels Cloudsmith, extras y catálogo.
-
requires,providese índice del grafo global. -
Checklist Fase 0 antes de producción.
Catálogo de plugins first-party¶
La documentación de dominio vive en cada repo cortex-plugin-*. El catálogo centraliza categorías, metadata y enlaces:
Plugins — catálogo (Fundación, Operaciones, Finanzas, Hosts, Muestras).
Índice grafo sandbox: casos-de-uso/reservas. Operación/CI: Desarrollo y CI.
Guía para autores: Estilo y voz. Frontera framework/plugin: Documentación framework vs plugins. Runtime del shell: Cortex Panel.