Módulos de dominio — Proptech¶

Detalle funcional por módulo del backlog PropTech Platform y encaje en Cortex HIVE.

Core (v0.1.0)¶

Requisito Proptech	Cortex HIVE
JWT + refresh	Middleware JWT (`CORTEX_AUTH_MODE`), sesión panel
OAuth2 / OIDC (Google, Microsoft, GitHub)	ADR 005 — parcial
RBAC, scopes por panel	`PanelAuthPolicy`, scopes en manifests
Audit log auth	Planificado en framework IO

Requisito Proptech	Cortex HIVE
Identificación tenant (subdominio / header)	Diseño: middleware + `CORTEX_*` settings
Aislamiento datos (schema-per-tenant)	PostgreSQL 16, migraciones por plugin (ADR 007)
Provisioning tenant	API control / futuro endpoint admin

Entidades propuestas para plugin lease:

Entidad	Descripción	Relación Cortex
`Lease`	Agregado raíz: términos, estado, fechas	Nuevo dominio
`Tenant`	Inquilino del contrato	Referencia `clients` vía `client_ref`
`Unit`	Unidad dentro de propiedad	Extensión o tipo en `resources`
`LeaseTerms`	Canon, depósito, fees, calendario pagos	Value object
`LeaseDocument`	Contrato, anexos	Upload S3 (ADR 020b)

Estados: draft → active → expired | terminated.

Namespace propuesto: /api/v1/lease

Integración: POST /api/v1/payments/payments para cobros; GET /api/v1/clients/clients/{id} para inquilino.

Plugin propuesto invest, namespace /api/v1/invest:

Capacidad	Descripción
Proyección cash flow	Multi-año, ingresos/gastos
Cap rate	Ingreso neto / valor propiedad
IRR / NPV	Newton-Raphson, tasas descuento configurables
Sensibilidad	Variables clave (vacancia, rent growth)
Comparativa	Escenarios lado a lado

Entrada: referencia a resource_id (propiedad en resources). Sin duplicar catálogo inmobiliario.

Issue	Enfoque HIVE
#7 CI/CD	`.github/workflows/python-ci.yml`, wheels, smoke pip (ADR 022)
#10 Cloud	Docker/Coolify, PostgreSQL, Redis (ADR 009)