# RF-PROG-004: Dashboard y Reportes de Avances **Épica:** MAI-005 - Control de Obra y Avances **Versión:** 1.0 **Fecha:** 2025-11-17 --- ## 1. Descripción General Dashboard ejecutivo y reportes especializados para visualización de avance físico-financiero, proyecciones, análisis de productividad y reportes para clientes, dirección e INFONAVIT. --- ## 2. Objetivos de Negocio - **Visibilidad:** Estado de obra en tiempo real - **Toma de decisiones:** KPIs y métricas clave - **Comunicación:** Reportes para stakeholders - **Cumplimiento:** Documentación para INFONAVIT y clientes --- ## 3. Alcance Funcional ### 3.1 Dashboard Ejecutivo de Proyecto **Vista Principal:** ``` ┌─────────────────────────────────────────────────────────┐ │ DASHBOARD - Fracc. Los Pinos Etapa 1 │ │ Actualizado: 15/Feb/2025 18:00 hrs │ ├─────────────────────────────────────────────────────────┤ │ │ │ ■ Estado General │ │ ┌──────────────┬──────────────┬─────────────────┐ │ │ │ Avance Físico│Avance Financ│Tiempo Transcurrido │ │ │ │ │ │ │ │ │ 85% │ 82% │ 45% │ │ │ │ 🟡 -7% │ ✓ -3% │ ✓ OK │ │ │ └──────────────┴──────────────┴─────────────────┘ │ │ │ │ ■ Curva S (Programado vs Real) │ │ ┌─────────────────────────────────────────────────┐ │ │ │100│ ╱──── │ │ │ │ 90│ ╱─── │ │ │ │ 80│ ╱───── │ │ │ │ 70│ ╱──── ■ Programado │ │ │ │ 60│ ╱──── ■ Real (85%) │ │ │ │ 50│ ╱───── │ │ │ │ 40│ ╱──── Desv: -7% │ │ │ │ └──────────────────────────────────────────→ │ │ │ │ Ene Feb Mar Abr May Jun Jul Ago Sep │ │ │ └─────────────────────────────────────────────────┘ │ │ │ │ ■ Partidas Críticas │ │ 🔴 Rellenos: -30% (60% vs 90% programado) │ │ 🟡 Muros PB: -15% (35% vs 50% programado) │ │ ✓ Cimentación: +2% (adelantada) │ │ │ │ ■ Próximos Hitos │ │ 18/Feb Fin cimentación (3 días) 🟡 Riesgo │ │ 30/Abr Fin estructura (74 días) ✓ OK │ │ 15/May 50% avance (ministrac.) (89 días) ✓ OK │ │ │ │ ■ Recursos en Obra Hoy │ │ Cuadrillas activas: 8 │ │ Trabajadores: 78 │ │ Viviendas activas: 23 (de 50) │ │ │ │ ■ Evidencias Capturadas │ │ Fotos hoy: 45 │ │ Checklists hoy: 3 │ │ Última actualización: Hace 15 minutos │ └─────────────────────────────────────────────────────────┘ ``` ### 3.2 Vista Detallada por Partida **Análisis de Partida:** ``` ANÁLISIS DETALLADO: 02 - Cimentación ┌──────────────────────────────────────────────────────┐ │ ■ Resumen │ │ Status: 🟡 Retraso leve │ │ Programado: 92% │ │ Real: 85% │ │ Desviación: -7 puntos │ │ Duración plan: 6 semanas │ │ Duración real: 6.8 semanas (+0.8 sem) │ │ │ │ ■ Desglose por Subconcepto │ │ ┌─────────────────┬─────┬──────┬──────┬──────────┐ │ │ │ Concepto │ Plan│ Real │ Desv │ Status │ │ │ ├─────────────────┼─────┼──────┼──────┼──────────┤ │ │ │ Excavación │100% │ 100% │ 0% │ ✓ │ │ │ │ Plantilla │100% │ 100% │ 0% │ ✓ │ │ │ │ Cimentación │ 95% │ 90% │ -5% │ 🟡 │ │ │ │ Rellenos │ 90% │ 60% │-30% │ 🔴 │ │ │ └─────────────────┴─────┴──────┴──────┴──────────┘ │ │ │ │ ■ Productividad │ │ Rendimiento real: 12.8 m³/día │ │ Rendimiento plan: 14.2 m³/día │ │ Eficiencia: 90% 🟡 │ │ │ │ Horas-hombre total: 1,245 h │ │ Horas-hombre plan: 1,180 h │ │ Sobrecosto MO: +5.5% │ │ │ │ ■ Materiales Consumidos │ │ Cemento: 85.2 ton (vs 82.0 plan) +3.9% │ │ Acero: 4.8 ton (vs 4.5 plan) +6.7% │ │ Grava: 125.5 m³ (vs 128.0 plan) -2.0% │ │ │ │ ■ Causas de Desviación │ │ 1. Lluvia (5 días perdidos) │ │ 2. Material húmedo en rellenos │ │ 3. Falta de cuadrilla adicional │ │ │ │ ■ Plan de Acción │ │ ✓ Contratada cuadrilla extra (Implementado) │ │ ⏳ Aceleración en rellenos (En proceso) │ │ ⏳ Turno extra sábados (Pendiente aprobación) │ └──────────────────────────────────────────────────────┘ ``` ### 3.3 Mapa de Calor de Avances **Vista por Lotes:** ``` MAPA DE CALOR - Avance por Vivienda Fracc. Los Pinos - Etapa 1 (50 viviendas) Manzana 1: ┌────┬────┬────┬────┬────┬────┬────┬────┬────┬────┐ │ 01 │ 02 │ 03 │ 04 │ 05 │ 06 │ 07 │ 08 │ 09 │ 10 │ │100%│100%│100%│ 95%│ 92%│ 88%│ 85%│ 82%│ 78%│ 75%│ │ 🟢 │ 🟢 │ 🟢 │ 🟢 │ 🟢 │ 🟡 │ 🟡 │ 🟡 │ 🟡 │ 🟡 │ └────┴────┴────┴────┴────┴────┴────┴────┴────┴────┘ Manzana 2: ┌────┬────┬────┬────┬────┬────┬────┬────┬────┬────┐ │ 11 │ 12 │ 13 │ 14 │ 15 │ 16 │ 17 │ 18 │ 19 │ 20 │ │ 72%│ 68%│ 65%│ 62%│ 58%│ 55%│ 52%│ 48%│ 45%│ 42%│ │ 🟡 │ 🟡 │ 🟡 │ 🟡 │ 🟠 │ 🟠 │ 🟠 │ 🟠 │ 🟠 │ 🟠 │ └────┴────┴────┴────┴────┴────┴────┴────┴────┴────┘ Manzana 3: ┌────┬────┬────┬────┬────┬────┬────┬────┬────┬────┐ │ 21 │ 22 │ 23 │ 24 │ 25 │ 26 │ 27 │ 28 │ 29 │ 30 │ │ 38%│ 35%│ 32%│ 28%│ 25%│ 22%│ 18%│ 15%│ 12%│ 8%│ │ 🟠 │ 🟠 │ 🔴 │ 🔴 │ 🔴 │ 🔴 │ 🔴 │ 🔴 │ 🔴 │ 🔴 │ └────┴────┴────┴────┴────┴────┴────┴────┴────┴────┘ Manzana 4-5: Pendientes (Lotes 31-50) → Inicio: Mar/2025 Leyenda: 🟢 >80% Avanzado 🟡 60-80% En tiempo 🟠 40-60% Atrasado 🔴 <40% Crítico [Vista por Partida] [Vista 3D] [Exportar] ``` ### 3.4 Análisis de Productividad **Dashboard de Eficiencia:** ``` ┌──────────────────────────────────────────────────────┐ │ ANÁLISIS DE PRODUCTIVIDAD - Febrero 2025 │ ├──────────────────────────────────────────────────────┤ │ ■ Rendimientos por Partida │ │ ┌──────────────┬──────┬──────┬────────┬─────────┐ │ │ │ Partida │ Real │ Plan │ Efic. │ Unidad │ │ │ ├──────────────┼──────┼──────┼────────┼─────────┤ │ │ │ Excavación │ 28.5 │ 30.0 │ 95% ✓ │ m³/día │ │ │ │ Cimentación │ 12.8 │ 14.2 │ 90% 🟡│ m³/día │ │ │ │ Muros block │ 45.2 │ 48.0 │ 94% ✓ │ m²/día │ │ │ │ Colado losa │ 3.2 │ 3.5 │ 91% 🟡│ viv/día │ │ │ │ Inst. hidráu │ 2.8 │ 3.0 │ 93% ✓ │ viv/día │ │ │ └──────────────┴──────┴──────┴────────┴─────────┘ │ │ │ │ ■ Eficiencia por Cuadrilla │ │ Cuadrilla A (Cimentación): 94% ✓ Excelente │ │ Cuadrilla B (Block): 91% 🟡 Bueno │ │ Cuadrilla C (Acabados): 88% 🟡 Aceptable │ │ Cuadrilla D (Instalaciones): 96% ✓ Excelente │ │ │ │ ■ Horas-Hombre │ │ Total del mes: 8,450 h │ │ Productivas: 7,250 h (85.8%) │ │ No productivas: 1,200 h (14.2%) 🟡 │ │ Lluvia: 720 h (60%) │ │ Falta material: 280 h (23%) │ │ Otros: 200 h (17%) │ │ │ │ ■ Tendencia Mensual │ │ Efic │ │ 100│ ●───● ●─────● │ │ 95│ ●─── │ │ 90│●─ │ │ 85│ │ │ └─────────────────────────────────────→ │ │ Ene Feb Mar Abr May Jun │ │ │ │ Mejora continua: +2% mensual ✓ │ └──────────────────────────────────────────────────────┘ ``` ### 3.5 Reporte para Cliente/INFONAVIT **Reporte Oficial:** ``` ╔══════════════════════════════════════════════════════╗ ║ REPORTE DE AVANCE MENSUAL - FEBRERO 2025 ║ ║ ║ ║ PROYECTO: Fraccionamiento Los Pinos - Etapa 1 ║ ║ CLIENTE: INFONAVIT (Convenio IF-2025-001) ║ ╠══════════════════════════════════════════════════════╣ ║ ║ ║ 1. AVANCE FÍSICO ACUMULADO ║ ║ ║ ║ Avance al inicio del mes: 32.5% ║ ║ Avance al final del mes: 38.2% ║ ║ Incremento del mes: +5.7 puntos ║ ║ ║ ║ Meta contractual: 38.0% ║ ║ Cumplimiento: ✓ 100.5% ║ ║ ║ ║ 2. AVANCE POR PARTIDA ║ ║ ║ ║ Partida Programado Real Status ║ ║ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ║ ║ Preliminares 100.0% 100.0% ✓ ║ ║ Cimentación 92.0% 85.0% 🟡 ║ ║ Estructura 12.0% 12.0% ✓ ║ ║ Instalaciones 0.0% 0.0% - ║ ║ Acabados 0.0% 0.0% - ║ ║ Urbanización 0.0% 0.0% - ║ ║ ║ ║ 3. AVANCE POR VIVIENDA ║ ║ ║ ║ Estado Cantidad %Total ║ ║ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ║ ║ 100% terminadas 10 20.0% ║ ║ 80-99% avanzadas 12 24.0% ║ ║ 50-79% en proceso 15 30.0% ║ ║ 20-49% iniciadas 13 26.0% ║ ║ <20% sin iniciar 0 0.0% ║ ║ ║ ║ 4. HITOS CUMPLIDOS ║ ║ ║ ║ ✓ Trazo y nivelación (14/Ene) ║ ║ ✓ 30% avance físico (28/Feb) ║ ║ ║ ║ 5. PRÓXIMOS HITOS ║ ║ ║ ║ • Fin cimentación (18/Feb) - En riesgo ║ ║ • Fin estructura (30/Abr) - Programado ║ ║ • 50% avance (15/May) - Programado ║ ║ ║ ║ 6. EVIDENCIAS FOTOGRÁFICAS ║ ║ ║ ║ Total de fotografías del mes: 1,247 ║ ║ Checklists de calidad: 150 ║ ║ No conformidades: 12 (resueltas) ║ ║ ║ ║ [Ver anexo fotográfico adjunto] ║ ║ ║ ║ 7. OBSERVACIONES Y COMENTARIOS ║ ║ ║ ║ • Retraso leve en cimentación por lluvias ║ ║ • Plan de recuperación implementado ║ ║ • Proyección de término: En tiempo ║ ║ ║ ╠══════════════════════════════════════════════════════╣ ║ ELABORÓ: AUTORIZÓ: ║ ║ ║ ║ _____________________ _____________________ ║ ║ Ing. Pedro Ramírez Ing. Juan Director ║ ║ Residente de Obra Director de Proyectos ║ ║ ║ ║ Fecha: 28/Febrero/2025 ║ ╚══════════════════════════════════════════════════════╝ Anexos: - Anexo A: Curva S (programado vs real) - Anexo B: Evidencias fotográficas (100 fotos) - Anexo C: Checklists de calidad - Anexo D: Reporte de no conformidades [Generar PDF] [Firmar Digitalmente] [Enviar] ``` ### 3.6 Alertas y Notificaciones **Panel de Alertas:** ``` ┌──────────────────────────────────────────────────────┐ │ ALERTAS Y NOTIFICACIONES │ │ Proyecto: Fracc. Los Pinos │ ├──────────────────────────────────────────────────────┤ │ 🔴 CRÍTICAS (2) │ │ • Rellenos con retraso >20% │ │ Acción: Plan de recuperación aprobado │ │ [Ver detalles] │ │ │ │ • Hito "Fin cimentación" en riesgo (3 días) │ │ Acción: Turno extra aprobado │ │ [Ver plan] │ │ │ │ 🟡 WARNINGS (5) │ │ • Muros PB con retraso -15% │ │ • Eficiencia cuadrilla C: 88% (meta >90%) │ │ • Sobreconsumo cemento +3.9% │ │ • 12 viviendas sin avance en 7 días │ │ • Checklist pendiente: Lote 45 │ │ │ │ 🟢 LOGROS (3) │ │ ✓ Hito 30% avance cumplido │ │ ✓ Cuadrilla D eficiencia 96% │ │ ✓ Frente A adelantado +2% │ │ │ │ ⏰ PRÓXIMOS (3) │ │ → Reporte mensual vence en 2 días │ │ → Visita INFONAVIT programada: 20/Feb │ │ → Estimación #3 disponible: 25/Feb │ └──────────────────────────────────────────────────────┘ Notificaciones configuradas: ☑ Email diario resumen (8:00 am) ☑ WhatsApp alertas críticas (inmediato) ☑ Dashboard push (tiempo real) ☐ SMS para hitos (deshabilitado) ``` ### 3.7 Exportaciones y Reportes **Catálogo de Reportes:** ``` ┌──────────────────────────────────────────────────────┐ │ GENERADOR DE REPORTES │ ├──────────────────────────────────────────────────────┤ │ Tipo de reporte: │ │ (●) Avance mensual oficial │ │ ( ) Curva S comparativa │ │ ( ) Productividad por cuadrilla │ │ ( ) Consumo de materiales │ │ ( ) Evidencias fotográficas │ │ ( ) Checklists de calidad │ │ ( ) Reporte ejecutivo │ │ │ │ Período: │ │ Desde: [01/Feb/2025] Hasta: [28/Feb/2025] │ │ │ │ Incluir: │ │ ☑ Curva S gráfica │ │ ☑ Tabla de avances por partida │ │ ☑ Top 10 fotografías │ │ ☑ Resumen de checklists │ │ ☐ Análisis de desviaciones │ │ ☐ Plan de recuperación │ │ │ │ Formato de salida: │ │ (●) PDF ( ) Excel ( ) PowerPoint │ │ │ │ Plantilla: │ │ [INFONAVIT Oficial ▼] │ │ │ │ Idioma: [Español ▼] │ │ │ │ ☑ Incluir firma digital │ │ ☑ Marca de agua en fotos │ │ │ │ [Vista Previa] [Generar Reporte] │ └──────────────────────────────────────────────────────┘ Reportes recientes: 📄 Avance Mensual Ene-2025.pdf (28/Ene, 2.3 MB) 📄 Reporte INFONAVIT Dic-2024.pdf (30/Dic, 5.1 MB) 📊 Análisis Productividad Q4-2024.xlsx (31/Dic, 850 KB) ``` --- ## 4. Modelo de Datos ```typescript // dashboard_widgets (configuración de dashboard) { id: UUID, userId: UUID, widgetType: VARCHAR(50), position: INTEGER, size: VARCHAR(20), // 'small', 'medium', 'large' config: JSONB, isVisible: BOOLEAN DEFAULT true } // kpi_metrics (métricas calculadas) { id: UUID, projectId: UUID, metricDate: DATE, physicalProgress: DECIMAL(5,2), financialProgress: DECIMAL(5,2), timeElapsed: DECIMAL(5,2), spi: DECIMAL(5,3), // Schedule Performance Index cpi: DECIMAL(5,3), // Cost Performance Index productiveHours: DECIMAL(10,2), nonproductiveHours: DECIMAL(10,2), efficiency: DECIMAL(5,2), criticalAlerts: INTEGER, warningAlerts: INTEGER, createdAt: TIMESTAMP } // reports_generated (reportes generados) { id: UUID, reportType: VARCHAR(50), projectId: UUID, periodStart: DATE, periodEnd: DATE, template: VARCHAR(100), format: ENUM('pdf', 'excel', 'pptx'), filePath: VARCHAR(512), fileSize: INTEGER, includedSections: VARCHAR[], generatedBy: UUID, generatedAt: TIMESTAMP, digitallySigned: BOOLEAN DEFAULT false, signedBy: UUID NULLABLE, signedAt: TIMESTAMP NULLABLE, sentTo: VARCHAR[], // emails sentAt: TIMESTAMP NULLABLE } // productivity_metrics (métricas de productividad) { id: UUID, projectId: UUID, activityId: UUID, crewId: UUID, periodStart: DATE, periodEnd: DATE, plannedRate: DECIMAL(10,4), // unidades/día actualRate: DECIMAL(10,4), efficiency: DECIMAL(5,2), unit: VARCHAR(20), laborHours: DECIMAL(10,2), quantityProduced: DECIMAL(12,4), createdAt: TIMESTAMP } // alerts_config (configuración de alertas) { id: UUID, projectId: UUID, alertType: VARCHAR(50), threshold: DECIMAL(10,2), severity: ENUM('info', 'warning', 'critical'), notificationChannels: VARCHAR[], // ['email', 'whatsapp', 'push'] recipients: UUID[], isActive: BOOLEAN DEFAULT true, createdAt: TIMESTAMP } ``` --- ## 5. Criterios de Aceptación - [ ] Dashboard ejecutivo con KPIs en tiempo real - [ ] Curva S programado vs real - [ ] Mapa de calor de avances por lote - [ ] Análisis de productividad por cuadrilla - [ ] Alertas automáticas (críticas, warnings, logros) - [ ] Reporte mensual oficial (PDF) - [ ] Generador de reportes configurables - [ ] Exportación a PDF, Excel, PowerPoint - [ ] Firma digital en reportes - [ ] Notificaciones multicanal (email, WhatsApp, push) - [ ] Widgets personalizables por usuario - [ ] Histórico de métricas y KPIs --- **Estado:** ✅ Ready for Development