# Mini curso (2 horas): Flujo de caja para programación de obra en RUM + BIM

## Objetivo
En 120 minutos, el equipo aprende a:
- Elaborar un flujo de caja básico del proyecto.
- Interpretar si el proyecto tendrá tensión de liquidez.
- Vincular el flujo de caja de obra con datos de programación y con el modelo BIM (4D/5D/8D).

## Público sugerido
- BIM Manager
- Project Manager
- Coordinación BIM
- Finanzas/Control de gestión

## Alcance y límites (criterio clave)
- Este flujo de caja es **exclusivo para programación de obra** (planificación y control económico de obra).
- **No se mezcla** con Time Tracker operativo ni con módulos/sistema de Arquitectura.
- Los módulos de Arquitectura pueden existir en paralelo, pero **no alimentan** la caja de obra en este curso.

## Resultado esperado al final
- Plantilla inicial de flujo de caja mensual (12 semanas o 6 meses).
- Mapa de variables BIM que alimentan ingresos/egresos.
- Propuesta de widget KPI para seguimiento en el dashboard.

---

## Estructura didáctica (120 min)

### Bloque 1 (0:00 - 0:20) — Fundamentos de flujo de caja
**Meta:** diferenciar utilidad vs liquidez.

1. Qué es flujo de caja (entradas - salidas reales de efectivo).
2. Diferencia entre:
   - Utilidad contable.
   - Flujo operativo.
   - Flujo de inversión.
   - Flujo financiero.
3. Riesgo principal en obra/proyecto BIM: “ser rentable y quebrar por caja”.

**Actividad rápida (5 min):**
Cada participante identifica 3 egresos fijos y 3 egresos variables de su proyecto.

---

### Bloque 2 (0:20 - 0:50) — Construcción de una plantilla práctica
**Meta:** salir con una tabla funcional.

Columnas recomendadas:
- Periodo (semana o mes)
- Saldo inicial
- Ingresos esperados
- Egresos esperados
- Flujo neto del periodo
- Saldo final

Fórmulas base:
- Flujo neto = Ingresos - Egresos
- Saldo final = Saldo inicial + Flujo neto
- Saldo inicial del periodo siguiente = Saldo final del periodo actual

**Actividad guiada (20 min):**
- Cargar hitos de cobro.
- Cargar costos de personal, subcontratos, licencias, compras críticas.
- Simular retraso de cobro de 30 días y revisar impacto.

---

### Bloque 3 (0:50 - 1:20) — Cómo leer el flujo de caja y tomar decisiones
**Meta:** interpretar alertas y palancas de control.

Señales clave:
1. Saldo final negativo por más de un periodo.
2. Alta concentración de cobros en pocos hitos.
3. Brecha entre avance físico BIM y facturación.

KPIs sugeridos:
- Caja mínima proyectada.
- Cobros pendientes / cobros del periodo.
- Burn rate semanal.
- Variación % egreso real vs egreso planificado.

Decisiones tipo:
- Reprogramar compras no críticas.
- Negociar anticipo o facturación parcial por hitos BIM.
- Priorización por paquetes de trabajo con mayor retorno de caja.

---

### Bloque 4 (1:20 - 2:00) — Integración en RUM + modelo BIM
**Meta:** conectar caja con datos operativos y de modelo.

## 1) Datos mínimos a registrar en RUM (solo obra)
Crear/usar campos por paquete de obra, partida o hito de programación:
- `cost_planned`
- `cost_actual`
- `billing_milestone`
- `invoice_date`
- `payment_due_date`
- `payment_received_date`
- `cashflow_category` (operativo/inversión/financiero)


> Regla de gobernanza: los datos de caja salen de presupuesto, valorizaciones, estados de pago y calendario de obra; no de time tracking operativo ni de ningún sistema/módulo de Arquitectura.


## Exclusiones técnicas
- No usar tablas, APIs ni catálogos del sistema de Arquitectura para calcular flujo de caja de obra.
- No importar costos/horas desde módulos de diseño arquitectónico a este tablero financiero.
- Si se requiere comparación, hacerla en reportes externos, no en el pipeline oficial de caja de obra.

## 2) Relación con BIM (modelo y coordinación)
Vincular cada paquete a:
- Disciplina BIM.
- Estado del entregable (Shared / Published / etc. según flujo CDE).
- Riesgos de coordinación (issues/clashes) que pueden generar sobrecosto o atraso de cobro.

## 3) Mapeo sugerido para dashboard (RUM)
Con la lógica actual del dashboard (widgets por `paramKey`), crear widgets:
1. **Curva S de caja planificada vs real**
   - paramKey: `cashflow_period`
   - métrica: suma de `cost_actual` e ingresos cobrados.
2. **Donut de egresos por categoría**
   - paramKey: `cashflow_category`
3. **Barra de cobros por estado**
   - paramKey: `payment_status` (pendiente / vencido / cobrado)
4. **Tarjeta de caja mínima proyectada (30/60/90 días)**

## 4) Rutina operativa semanal
- Lunes: actualizar avance físico y issues críticos BIM.
- Miércoles: actualizar cobranzas/pagos reales.
- Viernes: recalcular proyección 12 semanas + alertas.

---

## Caso express para práctica (15 min dentro del bloque 4)
- Proyecto: coordinación BIM de edificio mixto.
- Saldo inicial: USD 45,000.
- Cobro esperado semana 3: USD 30,000 (se retrasa a semana 5).
- Egresos semanales promedio: USD 14,000.

Preguntas:
1. ¿En qué semana la caja cae bajo cero?
2. ¿Qué 2 decisiones tomar para evitarlo?
3. ¿Qué indicador en el dashboard te da alerta temprana?

---

## Entregables del mini curso
1. Plantilla de flujo de caja base (semanal).
2. Diccionario de campos para integración en RUM.
3. Diseño de 3-4 widgets para monitoreo.
4. Lista de alertas con umbrales.

## Siguiente paso recomendado (implementación en proyecto)
Sprint de 1 semana:
- Día 1: validar catálogo de campos y responsables.
- Día 2-3: cargar histórico mínimo de 8-12 semanas.
- Día 4: configurar widgets y tablero ejecutivo.
- Día 5: sesión de cierre con decisiones y plan de mejora.