Saltar a contenido

Visión — Proptech

Síntesis del proyecto PropTech Platform (prodaric) y cómo se traduce a un ensamblado Cortex HIVE.

Objetivo del producto

Plataforma PropTech para:

  • Core: autenticación (JWT / OAuth2-OIDC), multi-tenancy, API documentada, CI/CD.
  • Lease: ciclo de vida de arrendamientos (contratos, inquilinos, pagos programados, documentos).
  • Invest: motor de análisis ROI (flujo de caja, cap rate, IRR, NPV, sensibilidad).
  • Ecosistema (v0.3.0): inteligencia de mercado, property management, analytics, infraestructura cloud.

Backlog de referencia (GitHub Project #2)

# Título Módulo Milestone
1 Setup Authentication System Core v0.1.0 Core Foundation
2 Implement Multi-tenancy Core v0.1.0
3 Create API Documentation Portal Core v0.1.0
7 Setup CI/CD Pipeline DevOps v0.1.0
8 Create Getting Started Guide Docs v0.1.0
4 Design Lease Entity Model Lease v0.2.0 First Modules
5 Lease CRUD API Lease v0.2.0
6 Design ROI Calculation Engine Invest v0.2.0
10 Configure Cloud Resources Infrastructure v0.3.0 Ecosystem

Issues de comunidad (Discord #9) quedan fuera del alcance técnico HIVE.

Principios de diseño en Cortex

  1. Reutilizar plugins genéricos donde el dominio ya existe (clients = inquilinos, payments = cobros, resources = activos rentables).
  2. Plugins nuevos solo para lógica PropTech específica (lease, invest) — sin imports Python cruzados (ADR 024).
  3. Multi-tenant como capacidad de plataforma (tenant context, aislamiento PG), no embebida en cada plugin.
  4. OpenAPI en /api/docs como portal de documentación (equivalente funcional al issue #3).
  5. Composición en paquete cortex-product-proptech cuando exista código; hasta entonces este directorio es la fuente de verdad del diseño.

Paneles UI propuestos

panel_id Rol
operations Operación: propiedades, unidades, leases activos, cobros
admin Parametrización: tarifas, plantillas contrato, usuarios tenant
accounting Contabilidad y reportes financieros
invest Panel dedicado (host cortex.panels) — análisis ROI y comparativas
control Plataforma (framework)

El panel invest seguiría el mismo patrón que accounting: configure_panel + register_resources + activación en caliente (ADR 011).

Referencias externas