nuevo enfoque

1. Decisión de producto

El producto debe reorganizarse alrededor de una sola promesa:

El dueño entra y en 10 segundos sabe si su inmobiliaria está ganando, perdiendo caja o entrando en riesgo.

Por eso, la app no debe abrir en “leads” ni en “diagnóstico financiero” suelto. Debe abrir en:

Centro Ejecutivo

Con 8 cards principales:

Card	Pregunta que responde
Caja libre 90 días	¿Tengo aire financiero?
Margen forecast vs plan	¿Estoy ganando lo previsto?
Profit at Risk	¿Cuánto margen está en riesgo?
Proyecto más crítico	¿Dónde debo mirar hoy?
Partida más desviada	¿Dónde se está yendo la plata?
Ventas comprometidas	¿Cuánto tengo vendido realmente?
Cobranza vencida	¿Qué caja no está entrando?
Decisión recomendada	¿Qué acción tomo hoy?
2. Nueva navegación de la app
Sidebar final
BIMBI Developer OS

1. Centro Ejecutivo
2. Proyectos
3. Caja & Margen
4. Presupuesto vs Real
5. Gastos & Compras
6. Ventas & Unidades
7. Documentos
8. Boardroom AI
9. Configuración
Estructura de rutas sugerida
/
  landing premium

/app
  /dashboard              Centro Ejecutivo
  /projects               Portafolio de proyectos
  /projects/[id]          Vista detalle proyecto
  /cash-margin            Caja & Margen
  /budget                 Presupuesto vs Real
  /expenses               Gastos & Compras
  /sales                  Ventas & Unidades
  /documents              Documentos críticos
  /ai                     Boardroom AI
  /settings               Configuración
3. Landing premium
Hero

Título:

Sistema operativo financiero y ejecutivo para desarrolladores inmobiliarios peruanos.

Subcopy:

Caja, margen, obra, ventas, gastos, documentos y riesgos en una sola cabina con IA.

CTA principal:

Solicitar demo

CTA secundario:

Ver dashboard ejecutivo

Secciones
Problema
Tu operación vive en Excel, WhatsApp, Drive y reportes manuales.
El dueño no ve margen real, caja futura ni riesgos a tiempo.
Solución
Boardroom AI + Developer ERP.
Una sola lectura ejecutiva del negocio.
Módulos
Centro Ejecutivo
Caja & Margen
Presupuesto vs Real
Gastos & Compras
Ventas & Unidades
Documentos
Boardroom AI
Demo Urb. Alborada
Proyecto demo con data realista.
Mostrar caja, margen, ventas, partidas y alertas.
Seguridad y Huawei Cloud
Multiempresa.
Multi-RUC.
Roles por proyecto.
Preparado para infraestructura cloud segura.
SUNAT/SIRE-ready
XML/PDF/CDR.
IGV.
Detracciones.
Export contable.
Preparado para PSE/OSE/SIRE fase 2.
Pricing
Starter
Pro
Business
Enterprise
4. Diseño del Centro Ejecutivo
Layout

Arriba:

Centro Ejecutivo
Holding: GSD Inmobiliaria
Periodo: Junio 2026
Última actualización: Hoy 08:45

Luego cards principales:

[ Caja libre 90 días ] [ Margen forecast ] [ Profit at Risk ] [ Ventas comprometidas ]
[ Proyecto crítico ] [ Partida desviada ] [ Cobranza vencida ] [ Decisión del día ]

Luego tres bloques:

A. CEO Briefing
Hoy el holding mantiene caja positiva para 74 días.
El mayor riesgo está en Urb. Alborada por desviación en estructuras y cobranza atrasada.
Se recomienda revisar precios de unidades premium y bloquear nuevos descuentos bajo margen piso.

Acciones:

[Ver sustento] [Generar memo] [Simular escenario]
B. Alertas prioritarias
Alerta	Impacto	Acción
Estructuras +6.2% sobre presupuesto	S/ 184,000	Ver sustento
Cobranza vencida en 3 unidades	S/ 430,000	Revisar cobranza
Factura sin CDR cargado	Medio	Observar
Licencia vence en 21 días	Alto	Ver documentos
C. Decisiones recomendadas
Decisión	Motivo	Acción
Congelar descuentos en unidades premium	Margen piso bajo 17%	Aprobar
Reprogramar pago proveedor acero	Caja 30 días ajustada	Simular
Priorizar cobranza unidad 1203	Impacto directo en caja	Ver cliente
5. Módulos MVP — alcance exacto
A. Centro Ejecutivo / Boardroom AI

Debe leer datos de:

proyectos,
caja,
gastos,
presupuesto,
ventas,
documentos,
alertas.

No debe permitir edición masiva. El dueño decide, no registra.

Funciones:

- Ver KPIs consolidados.
- Ver alertas.
- Ver briefing diario.
- Preguntar al Boardroom AI.
- Abrir evidencia.
- Simular escenarios simples.
B. Proyectos

Vista tabla:

Proyecto	RUC	Etapa	Avance	Margen forecast	Riesgo	Acción
Urb. Alborada	20xxxx	Construcción	42%	18.7%	Alto	Abrir
Torre B	20xxxx	Preventa	18%	22.1%	Medio	Abrir

Detalle del proyecto:

Resumen
Caja
Presupuesto
Gastos
Ventas
Documentos
Alertas
C. Caja & Margen

Debe mostrar:

Caja actual
Caja comprometida
Caja libre 30/60/90 días
Cuentas por cobrar
Cuentas por pagar
Margen plan
Margen forecast
Profit at Risk

Alertas:

- Caja negativa proyectada.
- Cobranza vencida.
- Pago crítico sin aprobación.
- Margen bajo umbral.
D. Presupuesto vs Real

Tabla principal:

Partida	Presupuesto	Comprometido	Real	Variación	Estado
Estructuras	S/ 2.8MM	S/ 1.9MM	S/ 1.4MM	+6.2%	Riesgo
Acabados	S/ 1.2MM	S/ 620K	S/ 400K	-1.1%	OK

Reglas:

- Si variación > 5%, alerta amarilla.
- Si variación > 10%, alerta roja.
- Todo gasto debe tener partida.
- Todo gasto sin partida queda observado.
E. Gastos & Compras

Flujo mínimo:

Proveedor → OC simple → Comprobante → Partida → Aprobación → Pago

Estados:

Borrador
Pendiente aprobación
Observado
Aprobado
Programado para pago
Pagado

Datos obligatorios:

Proyecto
RUC
Proveedor
Monto
Moneda
Partida
Centro de costo
Tipo de comprobante
PDF/XML/CDR si aplica
IGV
Detracción
Fecha de vencimiento
F. Ventas & Unidades

Vista inventario:

Unidad	Estado	Precio lista	Última oferta	Margen piso	Cliente	Acción
1203	Disponible	S/ 690K	-	18.5%	-	Reservar
1502	Reservada	S/ 740K	S/ 720K	19.1%	Cliente A	Ver
1801	Separada	S/ 810K	S/ 780K	16.0%	Cliente B	Revisar

Estados:

Disponible
Reservada
Separada
Vendida
Bloqueada
Entregada

Alertas:

- Oferta bajo margen piso.
- Reserva sin pago.
- Cuota vencida.
- Contrato pendiente.
G. Documentos Críticos + SUNAT-ready

Tipos de documentos:

Contrato
Licencia
Certificado de parámetros
Factibilidad de servicios
Partida registral
Plano
Presupuesto
Factura PDF
XML
CDR
Comprobante de detracción
Contrato proveedor
Contrato cliente

Estados:

Pendiente
Cargado
Validado
Observado
Vencido

Regla clave:

Todo documento debe estar vinculado a RUC, proyecto, tipo documental y responsable.

6. Modelo de datos mínimo
Jerarquía
Holding
  EmpresaRUC
    Proyecto
      Etapa
        CentroCosto
          Partida
            Presupuesto
            Gasto
            Comprobante
            Pago

Proyecto
  Unidad
    Lead
    Cliente
    Contrato
    Cobranza
    Facturación

Proyecto
  Documento
  Alerta
  RecomendacionIA
Entidades base
Holding
EmpresaRUC
Proyecto
Etapa
CentroCosto
Partida
Presupuesto
Gasto
Proveedor
Comprobante
Pago
Unidad
Cliente
Lead
Contrato
Cobranza
Documento
Alerta
RecomendacionIA
Usuario
Rol
AuditLog
Campos críticos por entidad
Proyecto
{
  id,
  holdingId,
  empresaRucId,
  nombre,
  distrito,
  etapaActual,
  estado,
  fechaInicio,
  fechaEntregaEstimada,
  presupuestoTotal,
  ventaProyectada,
  margenPlan,
  margenForecast,
  riesgoActual
}
Partida
{
  id,
  proyectoId,
  centroCostoId,
  nombre,
  codigo,
  presupuestoBase,
  comprometido,
  realEjecutado,
  variacionPorcentaje,
  estado
}
Gasto
{
  id,
  proyectoId,
  empresaRucId,
  proveedorId,
  partidaId,
  centroCostoId,
  descripcion,
  monto,
  moneda,
  igv,
  detraccion,
  estadoAprobacion,
  fechaEmision,
  fechaVencimiento,
  comprobanteId,
  creadoPor
}
Unidad
{
  id,
  proyectoId,
  codigo,
  tipo,
  areaTechada,
  areaTotal,
  precioLista,
  precioOferta,
  margenPiso,
  estado,
  clienteId,
  contratoId
}
Documento
{
  id,
  holdingId,
  empresaRucId,
  proyectoId,
  tipo,
  nombre,
  url,
  version,
  estado,
  fechaEmision,
  fechaVencimiento,
  responsableId,
  metadata
}
RecomendacionIA
{
  id,
  proyectoId,
  tipo,
  titulo,
  resumen,
  impactoEstimado,
  nivelConfianza,
  evidenciaIds,
  accionSugerida,
  estado
}
7. Reglas de IA

La IA debe funcionar bajo esta regla:

No inventar datos. Solo interpreta datos existentes y muestra evidencia.

Respuestas válidas
Según la información registrada...
No tengo datos suficientes para responder eso.
La evidencia disponible muestra...
Esta recomendación se basa en estos documentos/transacciones...
Respuestas prohibidas
Asumo que...
Probablemente el costo real sea...
Te recomiendo aprobar sin revisar...
Voy a modificar el precio automáticamente...
Endpoint MVP
POST /api/ai/briefing

Input:

{
  "holdingId": "gsd",
  "period": "today"
}

Output:

{
  "summary": "El holding mantiene caja positiva para 74 días...",
  "topRisks": [],
  "recommendedActions": [],
  "evidence": []
}
8. Arquitectura técnica MVP
Stack recomendado
Frontend:
Next.js + React + TypeScript + Tailwind + shadcn/ui

Backend:
NestJS o FastAPI

DB:
PostgreSQL

ORM:
Prisma si usan Node/NestJS
SQLAlchemy si usan FastAPI

Storage:
Compatible OBS/S3

Auth:
NextAuth/Auth.js o Clerk para prototipo
Luego auth propia enterprise con RBAC/ABAC

Charts:
Recharts o Tremor

AI:
Endpoint mockeado primero
Luego RAG + SQL tools controlados

CI/CD:
GitHub Actions

Deploy inicial:
Vercel frontend + backend cloud
Luego Huawei Cloud
9. Estructura de carpetas sugerida
bimbi-developer-os/
  apps/
    web/
      app/
        page.tsx
        app/
          dashboard/
          projects/
          cash-margin/
          budget/
          expenses/
          sales/
          documents/
          ai/
          settings/
      components/
        layout/
        dashboard/
        cards/
        tables/
        charts/
        ai/
      lib/
        api.ts
        format.ts
        permissions.ts
      styles/

    api/
      src/
        modules/
          holdings/
          companies/
          projects/
          budget/
          expenses/
          sales/
          documents/
          ai/
          auth/
          audit/
        common/
        database/
        main.ts

  packages/
    database/
      prisma/
        schema.prisma
        seed.ts
    ui/
    types/

  docs/
    product-spec.md
    data-model.md
    api-contracts.md
10. Sprint plan recomendado
Sprint 0 — Fundaciones

Duración: 1 semana.

Construir:

- Diseño base visual.
- Sidebar.
- Layout interno.
- Design system.
- Modelo de datos inicial.
- Seed data Urb. Alborada.

Resultado:

App navegable con data mock realista.

Sprint 1 — Centro Ejecutivo

Duración: 1-2 semanas.

Construir:

- Dashboard CEO.
- 8 cards principales.
- CEO Briefing mock.
- Alertas prioritarias.
- Decisiones recomendadas.

Resultado:

Demo vendible para dueño/inversionista.

Sprint 2 — Proyectos + Presupuesto

Duración: 2 semanas.

Construir:

- CRUD proyectos.
- CRUD etapas.
- CRUD centros de costo.
- CRUD partidas.
- Presupuesto vs real.
- Alertas por desviación.

Resultado:

Control básico de obra y margen.

Sprint 3 — Gastos + Proveedores

Duración: 2 semanas.

Construir:

- CRUD proveedores.
- Registro de gastos.
- Asociación gasto-proyecto-partida.
- Estado de aprobación.
- Upload PDF/XML/CDR básico.

Resultado:

Primer circuito financiero operativo.

Sprint 4 — Ventas + Unidades

Duración: 2 semanas.

Construir:

- CRUD unidades.
- Estados de unidad.
- Leads/clientes básicos.
- Reservas.
- Cobranza simple.
- Alertas por cobranza vencida.

Resultado:

Ventas conectadas a caja y margen.

Sprint 5 — Boardroom AI básico

Duración: 1-2 semanas.

Construir:

- Endpoint /api/ai/briefing.
- Generación de briefing con datos reales.
- Evidencia por alerta.
- Chat ejecutivo limitado.

Resultado:

IA útil sin riesgo de alucinación.

11. Criterios de aceptación del MVP

El MVP está listo cuando un dueño puede entrar y responder:

1. ¿Cuánta caja libre tengo a 90 días?
2. ¿Qué proyecto está en mayor riesgo?
3. ¿Qué partida se desvió más?
4. ¿Qué gastos están pendientes de aprobación?
5. ¿Qué unidades están disponibles/reservadas/vendidas?
6. ¿Qué cobranzas están vencidas?
7. ¿Qué documentos críticos faltan?
8. ¿Qué decisión debo tomar hoy?

Si la app no responde esas 8 preguntas, todavía no es MVP.

12. Qué debe hacer el equipo ahora

Orden de construcción:

1. Rediseñar landing.
2. Crear layout interno premium.
3. Construir Centro Ejecutivo con data mock realista.
4. Crear modelo PostgreSQL.
5. Cargar seed Urb. Alborada.
6. Conectar dashboard a datos reales.
7. Construir proyectos/presupuesto/gastos/unidades/documentos.
8. Crear AI briefing basado en consultas internas.

La prioridad no es tener muchas pantallas. La prioridad es que la demo se sienta como:

“Este sistema me dice dónde estoy perdiendo plata y qué decisión debo tomar hoy.”