Casos de uso¶

Ejemplos de ensamblados documentados sobre Cortex HIVE: composición de plugins, bundles pip, contratos HTTP y convenciones de panel para un vertical concreto.

No confundir con la plataforma (SPI, loader, paneles generativos) — ver handbook de plugins y ADR 025.

Relación técnica con el framework¶

Concepto	Comportamiento
`products/{id}/composition.py`	Grafo y bundles pip; no leído por `load_plugins()` en runtime
Activación real	`/control/plugins` + entry points instalados
Panels activos	Unión de `contributes_panels` de plugins habilitados + hosts `cortex.panels`
Tests `product_composition`	Validan coherencia del grafo documentado vs descriptores de plugins
Paquete pip producto	Extras de dependencias (`operations-core`, …); alias en meta-paquete `cortex`

La carpeta products/ expresa el nivel de extensibilidad esperado hacia el PMV, no una capa runtime adicional.

Catálogo¶

Caso de uso	Vertical	Implementación en monorepo	Estado
Reservas	Operación con slots, clientes y cobro	`products/unosportclub` — sandbox PMV	Grafo + CI composición; valida framework
Proptech	Arrendamiento, inversión inmobiliaria, multi-tenant	Solo `docs/casos-de-uso/proptech/`	Diseño — sin código ni `products/proptech/`

Cada caso de uso puede tener:

Grafo requires / optional_requires / provides
Perfiles pip (operations-core, …)
Convención de namespaces (operations, admin, paneles dedicados)
Contratos HTTP entre dominios

Añadir un caso de uso¶

Carpeta docs/casos-de-uso/{id}/ con index.md, composition.md, bundles.md, dependency-contracts.md.
Paquete products/{id}/ con composition.py (REFERENCE_GRAPH, BUNDLE_PROFILES) y tests product_composition.
Entrada en este índice y en mkdocs.yml.
Actualizar ADR 025 solo si cambia el patrón de plataforma; el detalle del vertical vive en el caso de uso.