ANEXO 34

Reportes ejecutivos FARO

Este anexo corresponde a la Fase 9 — Comunicación ejecutiva, etapa “Reportes ejecutivos”. Es la capa donde FARO Connect transforma datos, KPIs, alertas, tensiones, diagnósticos, prioridades, acciones, evidencia, seguimiento y FARO Score en informes claros para Dirección, Gerencia, Directorio o responsables de área. Hasta el Anexo 33, FARO ya sabe: qué pasó, por qué pasó, qué prioridad tiene, qué se recomendó, qué acción se creó, quién respondió, qué evidencia se cargó, si se cerró, si funcionó, qué impacto tuvo. El Anexo 34 responde: ¿Cómo se comunica todo esto de forma ejecutiva para que Dirección entienda, decida y controle sin perderse en el detalle?

1. Objetivo del anexo

El objetivo del Anexo 34 — Reportes ejecutivos FARO es definir cómo FARO genera reportes que permitan dirigir la empresa con foco. Un buen reporte ejecutivo debe responder: 1. Cómo está la empresa. 2. Qué cambió desde el último período. 3. Qué está bien. 4. Qué está mal. 5. Qué requiere decisión. 6. Qué acciones están abiertas. 7. Qué acciones vencieron. 8. Qué tensiones siguen activas. 9. Qué se resolvió. 10. Qué impacto tuvo lo ejecutado. 11. Qué debe mirar Dirección ahora. Un reporte FARO no debe ser un cementerio de gráficos.
Debe ser una lectura ejecutiva.

2. Tesis del Anexo 34

La tesis es: FARO Connect debe comunicar dirección, no solo información. Un reporte común dice: Ventas: +18%. Margen: -7 puntos. Stock crítico: 13%. Acciones vencidas: 22%. Un reporte FARO debe decir: La empresa creció en ventas, pero el crecimiento no fue sano: el margen cayó, los descuentos subieron y la cobranza se alargó. La prioridad ejecutiva es proteger rentabilidad y caja antes de seguir empujando volumen. Hay 3 acciones críticas abiertas y 1 vencida. Eso cambia la reunión.
El primero muestra datos.
El segundo dirige la conversación.

3. Qué es un reporte ejecutivo FARO

Un reporte ejecutivo FARO es una salida estructurada que resume el estado de una empresa, área, sucursal, proceso o tensión. Debe incluir: FARO Score estado general variación del período principales KPIs alertas relevantes tensiones activas diagnósticos ejecutivos prioridades P1/P2 acciones abiertas acciones vencidas acciones cerradas impacto medido decisiones pendientes riesgos próximos recomendaciones responsables evidencia relevante Ejemplo de estructura:

{
  "report_id": "REP_EXEC_2026_001",
  "report_type": "weekly_executive",
  "company_id": "COMP_001",
  "period": "2026-W22",
  "faro_score": 74,
  "score_delta": 6,
  "executive_summary": "La empresa mejoró por cierre de acciones comerciales y reducción de stock crítico, pero mantiene riesgo financiero por cobranza lenta.",
  "top_priorities": [
    "caja_debil",
    "crecimiento_no_rentable",
    "stock_critico"
  ],
  "decisions_required": [
    "revisar_politica_credito",
    "aprobar_plan_comision"
  ]
}

4. Diferencia entre dashboard, informe y reporte FARO

Concepto Qué muestra Problema habitual Dashboard Indicadores visuales. Mucho dato, poca lectura. Informe tradicional Resumen escrito. Puede ser largo y poco accionable. Reporte FARO Lectura ejecutiva + foco + acción. Diseñado para decidir. El dashboard muestra.
El informe describe.
El reporte FARO orienta.

5. Principio rector

Un reporte ejecutivo no debe contar todo. Debe contar lo que importa, en el orden correcto. Si un reporte tiene 40 páginas y Dirección no sabe qué decidir, falló. Si tiene 3 páginas y muestra: estado general, prioridades, riesgos, acciones, decisiones pendientes, entonces sirve. El reporte puede tener anexos profundos, pero la portada ejecutiva debe ser quirúrgica.

6. Tipos de reportes FARO

Tipo de reporte Uso Frecuencia Reporte diario ejecutivo Ver P1, caja, vencimientos y riesgos inmediatos. Diario Reporte semanal de dirección Control de gestión, prioridades y acciones. Semanal Reporte mensual ejecutivo Performance integral, Score, áreas y resultados. Mensual Reporte de Directorio Decisiones estratégicas, riesgos, evolución y foco. Mensual / trimestral Reporte por área Lectura específica de Comercial, Finanzas, Stock, etc. Semanal / mensual Reporte por sucursal Comparación y foco por unidad operativa. Semanal / mensual Reporte de tensiones Problemas sistémicos activos y evolución. Semanal Reporte de acciones Cumplimiento, vencimientos, responsables e impacto. Semanal Reporte de calidad de datos Confiabilidad de información y bloqueos. Semanal / mensual Reporte post-decisión Resultado de una decisión o simulación. Al cierre Reporte de excepción Se emite solo ante eventos críticos. Automático

7. Estructura estándar de reporte ejecutivo FARO

Todo reporte ejecutivo debería tener esta arquitectura: 1. Portada ejecutiva 2. Resumen de Dirección 3. FARO Score y variación 4. Prioridades P1/P2 5. Tensiones activas 6. Diagnósticos relevantes 7. KPIs críticos 8. Acciones abiertas y vencidas 9. Acciones cerradas e impacto 10. Decisiones pendientes 11. Riesgos próximos 12. Recomendaciones 13. Evidencia clave 14. Anexos técnicos La clave es el orden. Primero foco directivo. Después detalle.

8. Campos obligatorios de un reporte FARO

Campo Para qué sirve report_id Identificador único. report_type Diario, semanal, mensual, Directorio, área, etc. company_id Empresa. branch_id Sucursal si aplica. area_id Área si aplica. period_start / period_end Período reportado. faro_score Score actual. score_delta Variación contra período anterior. executive_summary Lectura directiva. top_priorities Prioridades ejecutivas. active_tensions Tensiones abiertas. critical_alerts Alertas relevantes. open_actions Acciones abiertas. overdue_actions Acciones vencidas. closed_actions Acciones cerradas. measured_impact Impacto real. decisions_required Decisiones pendientes. generated_at Fecha de emisión. generated_by Sistema, usuario o área.

9. Reporte diario ejecutivo

Objetivo Responder: ¿Qué necesita atención hoy? No es un informe largo. Es un parte ejecutivo. Debe incluir: FARO Score actual. P1 abiertas. P1 vencidas. Caja y riesgo financiero. Acciones que vencen hoy. Alertas críticas nuevas. Decisiones urgentes. Bloqueos relevantes. Ejemplo: REPORTE DIARIO FARO

Estado general: FARO Score 68 — Riesgo medio-alto.

Atención inmediata: 1. Caja disponible en 65% del mínimo operativo. 2. Acción P1 de plan de caja vence hoy. 3. Stock crítico en producto clave con cobertura de 4 días. 4. Acción comercial de descuentos sigue sin evidencia.

Decisión requerida: Dirección debe aprobar reprogramación de pagos no críticos.

10. Reporte semanal de dirección

Objetivo Responder: Qué pasó esta semana, qué cambió y qué debe decidirse. Debe incluir: Resumen ejecutivo. Score semanal. Variación de KPIs. Prioridades P1/P2. Tensiones activas. Acciones cerradas. Acciones vencidas. Impacto medido. Decisiones pendientes. Foco de la semana próxima. Ejemplo: Lectura semanal: La empresa mejoró en ejecución: se cerraron 8 de 11 acciones prioritarias. Sin embargo, la tensión comercial-financiera sigue activa porque el margen mejoró parcialmente, pero la cobranza continúa lenta.

11. Reporte mensual ejecutivo

Objetivo Responder: Cómo evolucionó la empresa durante el mes y qué implica para la gestión. Debe incluir: FARO Score mensual. Evolución por área. KPIs principales. Alertas recurrentes. Tensiones abiertas y cerradas. Acciones efectivas e inefectivas. Impacto financiero estimado. Calidad de datos. Decisiones tomadas. Decisiones pendientes. Aprendizajes. Este reporte puede tener más profundidad y anexos.

12. Reporte de Directorio

Objetivo Responder: Qué necesita saber el Directorio para controlar, decidir y orientar. No debe entrar en detalle operativo excesivo. Debe incluir: estado general de la empresa, evolución del FARO Score, riesgos estratégicos, tensiones estructurales, decisiones relevantes, impacto económico, cumplimiento de acciones críticas, desvíos importantes, recomendaciones de Dirección, temas que requieren aprobación. Ejemplo de narrativa: Durante el período, la empresa mejoró su disciplina de ejecución, pero mantiene una tensión financiera por cobranza lenta y una tensión comercial por margen presionado. La prioridad del próximo mes debe ser sostener ventas sin deteriorar caja ni rentabilidad.

13. Reporte por área

Cada área debe tener su propio reporte. 13.1 Comercial Debe incluir: ventas, margen, descuentos, clientes, canales, vendedores, comisiones, acciones comerciales, tensiones comerciales. Lectura ejemplo: Comercial creció en volumen, pero el margen sigue presionado por descuentos. La acción de auditoría redujo parcialmente el descuento promedio, aunque todavía quedan vendedores con operaciones bajo margen mínimo.

13.2 Finanzas Debe incluir: caja, cobranza, mora, pagos, gastos, flujo operativo, deuda, canjes, riesgo financiero. Lectura ejemplo: La caja mejoró respecto de la semana anterior, pero sigue por debajo del mínimo operativo. La cobranza de clientes grandes debe seguir como prioridad P1.

13.3 Stock / Compras Debe incluir: stock crítico, stock inmovilizado, rotación, quiebres, cobertura, compras urgentes, proveedores, órdenes pendientes. Lectura ejemplo: El stock crítico bajó luego de reposiciones preventivas, pero sigue activo el riesgo de proveedor crítico en productos de alta rotación.

13.4 RRHH Debe incluir: dotación, ausentismo, productividad, comisiones, costo laboral, acciones por responsable, sobrecarga, accountability. Lectura ejemplo: La principal tensión de RRHH no es dotación sino incentivos: la comisión comercial todavía no está suficientemente alineada con margen y cobranza.

13.5 Dirección / Ejecución Debe incluir: decisiones tomadas, acciones creadas, acciones vencidas, acciones cerradas, cierres con evidencia, tensiones recurrentes, responsables sobrecargados, seguimiento de comités. Lectura ejemplo: La empresa decide, pero todavía tiene brecha de ejecución: el 18% de acciones prioritarias venció y 3 decisiones aprobadas no tienen acciones asociadas.

14. Reporte por sucursal

Debe comparar unidades operativas. Ejemplo: Sucursal Score Ventas Margen Stock crítico Acciones vencidas Lectura Mendoza 76 +8% 25% 6% 2 Estable San Juan 64 +15% 19% 14% 5 Crece con tensión Central 72 +3% 24% 8% 1 Controlada Lectura FARO: San Juan muestra crecimiento, pero con margen inferior y mayor stock crítico. Requiere foco comercial-operativo antes de escalar volumen.

15. Reporte de tensiones

Objetivo Mostrar los problemas sistémicos activos. Debe incluir: tensión, áreas afectadas, severidad, confianza, prioridad, KPIs involucrados, acciones asociadas, estado, evolución, impacto en Score. Ejemplo: Tensión Severidad Confianza Prioridad Estado Acción principal Crecimiento no rentable Alta 0.84 P2 En curso Auditar descuentos Caja débil Crítica 0.88 P1 Abierta Plan de caja Stock crítico Alta 0.81 P2 Mejorando Reposición preventiva

16. Reporte de acciones

Debe mostrar ejecución y accountability. Indicadores: acciones creadas, acciones abiertas, acciones vencidas, acciones cerradas, acciones cerradas en plazo, acciones con evidencia, acciones efectivas, acciones por responsable, acciones por área, acciones escaladas. Ejemplo: Acciones de la semana: - 18 creadas. - 11 cerradas. - 8 cerradas en plazo. - 3 vencidas. - 2 escaladas. - 6 con impacto medido. Lectura: La ejecución mejoró en volumen, pero la calidad de cierre debe reforzarse: 3 acciones cerradas todavía no tienen medición posterior.

17. Reporte de calidad de datos

Este reporte es clave para confianza. Debe incluir: calidad general de datos, fuentes críticas, KPIs con baja confianza, datos faltantes, maestros incompletos, duplicados, fuentes sin actualización, acciones de corrección, impacto sobre diagnósticos. Ejemplo: Dominio Calidad Problema Acción Ventas 0.92 Estable Sin acción Costos 0.68 Costos faltantes Completar costos Stock 0.74 Diferencias físico-sistema Conciliar stock Clientes 0.81 Duplicados menores Unificar clientes Lectura FARO: El diagnóstico de margen debe leerse con cautela porque la calidad de costos está por debajo del umbral mínimo.

18. Reporte de decisiones pendientes

Debe mostrar qué necesita aprobación. Ejemplos: aprobar cambio de política de descuentos, aprobar simulación de comisión, aprobar canje, aprobar reprogramación de pagos, aprobar proveedor alternativo, aprobar bloqueo de cliente, aprobar política de crédito. Tabla: Decisión Prioridad Responsable Aprobador Vencimiento Estado Reprogramar pagos P1 Finanzas Dirección Hoy Pendiente Nueva comisión P2 Comercial/RRHH Dirección 7 días En simulación Canje obra P2 Finanzas Directorio 72 hs Espera valuación

19. Reporte de excepción

Se genera automáticamente ante eventos críticos. Ejemplos: FARO Score cae más de 10 puntos. Caja baja de mínimo. Acción P1 vencida. Tensión crítica recurrente. Stock crítico en producto clave. Diagnóstico de baja confianza usado para decisión sensible. Canje de alto monto pendiente sin evaluación. Código conceptual:

def generar_reporte_excepcion(evento):
    condiciones = [
        evento.get("priority_level") == "P1",
        evento.get("score_delta", 0) <= -10,
        evento.get("critical_cash_risk", False),
        evento.get("critical_action_overdue", False)
    ]

    if any(condiciones):
        return {
            "report_type": "exception_report",
            "title": evento["title"],
            "requires_immediate_attention": True
        }

    return None

20. Fórmula de salud del reporte

FARO puede evaluar si el reporte es sólido. Calidad del reporte = cobertura de KPIs × 20% + calidad de datos × 20% + evidencia disponible × 20% + actualización × 15% + claridad de prioridades × 15% + decisiones identificadas × 10% Código:

def calidad_reporte(
    cobertura_kpis,
    calidad_datos,
    evidencia_disponible,
    actualizacion,
    claridad_prioridades,
    decisiones_identificadas
):
    return round(
        cobertura_kpis * 0.20 +
        calidad_datos * 0.20 +
        evidencia_disponible * 0.20 +
        actualizacion * 0.15 +
        claridad_prioridades * 0.15 +
        decisiones_identificadas * 0.10,
        2
    )
Lectura:
Score
Calidad
0.85 - 1.00
Reporte fuerte
0.70 - 0.84
Reporte confiable
0.50 - 0.69
Reporte con observaciones
< 0.50
No usar para decisiones fuertes

21. Fórmula de resumen ejecutivo

FARO puede construir un resumen priorizando: Resumen ejecutivo = estado general + variación de Score + principales mejoras + principales riesgos + decisiones requeridas + foco recomendado Código conceptual:

def generar_resumen_ejecutivo(score, score_delta, mejoras, riesgos, decisiones, foco):
    tendencia = "mejoró" if score_delta > 0 else "empeoró" if score_delta < 0 else "se mantuvo"

    return {
        "summary": (
            f"El FARO Score {tendencia} a {score}. "
            f"Mejoras principales: {', '.join(mejoras)}. "
            f"Riesgos principales: {', '.join(riesgos)}. "
            f"Decisiones pendientes: {', '.join(decisiones)}. "
            f"Foco recomendado: {foco}."
        )
    }

22. Fórmula de ranking de temas para reporte

No todo entra en portada. FARO debe elegir. Ranking de reporte = prioridad × 30% + impacto en Score × 20% + urgencia × 20% + impacto económico × 15% + recurrencia × 10% + confianza × 5% Código:

def ranking_tema_reporte(
    prioridad,
    impacto_score,
    urgencia,
    impacto_economico,
    recurrencia,
    confianza
):
    return round(
        prioridad * 0.30 +
        impacto_score * 0.20 +
        urgencia * 0.20 +
        impacto_economico * 0.15 +
        recurrencia * 0.10 +
        confianza * 0.05,
        2
    )

23. Reporte FARO Score

El reporte debe explicar el Score. Debe mostrar: score actual, score anterior, variación, drivers positivos, drivers negativos, confianza del score, áreas que más impactan, tensiones que explican el movimiento, acciones que ayudaron o perjudicaron. Ejemplo: FARO Score: 74 Variación: +6

Sube por: + cierre de acciones P1, + reducción de stock crítico, + baja de descuento promedio.

Baja por: - cobranza lenta, - acción financiera vencida, - calidad de datos de costos todavía media.

24. Reporte de impacto económico

Debe traducir gestión a dinero cuando sea posible. Ejemplos: margen recuperado, ventas perdidas evitadas, capital liberado, caja recuperada, costo financiero reducido, stock inmovilizado reducido, costo evitado por proveedor alternativo. Código:

def impacto_economico_total(impactos):
    return sum(i.get("amount", 0) for i in impactos)
Ejemplo:
{
  "impact_summary": {
    "gross_margin_recovered": 2750000,
    "cash_recovered": 9000000,
    "stock_capital_released": 4500000,
    "estimated_total_impact": 16250000
  }
}

25. Reporte de riesgos próximos

FARO debe mirar hacia adelante. Riesgos típicos: stock que quedará crítico, caja proyectada bajo mínimo, acciones próximas a vencer, proveedor con demora, cliente grande con mora creciente, tensión recurrente, decisión sensible sin aprobar, calidad de datos que bloquea diagnóstico. Código:

def detectar_riesgos_proximos(eventos):
    riesgos = []

    for e in eventos:
        if e.get("forecast_risk") == "high":
            riesgos.append(e)

        if e.get("due_soon") and e.get("priority_level") in ["P1", "P2"]:
            riesgos.append(e)

    return riesgos

26. Reporte por responsable

Debe mostrar accountability. Ejemplo: Responsable Abiertas Vencidas Cerradas en plazo Efectivas Riesgo Finanzas 8 2 70% 60% Alto Comercial 10 1 80% 72% Medio Stock 6 0 90% 75% Bajo Lectura FARO: Finanzas concentra acciones P1 y muestra riesgo de sobrecarga. Conviene reasignar tareas operativas o reforzar seguimiento.

27. Reporte de comités

FARO puede generar agenda de comité. Comité de Dirección 1. FARO Score y variación. 2. P1 abiertas y vencidas. 3. Tensiones estructurales. 4. Decisiones pendientes. 5. Acciones críticas. 6. Riesgos próximos. 7. Seguimiento de decisiones anteriores. Comité Comercial 1. Ventas y margen. 2. Descuentos. 3. Clientes poco rentables. 4. Comisiones. 5. Acciones comerciales. Comité Financiero 1. Caja. 2. Cobranza. 3. Mora. 4. Pagos. 5. Canjes. 6. Riesgo financiero.

28. Plantilla de reporte ejecutivo semanal

REPORTE EJECUTIVO FARO — SEMANAL

Empresa: [Nombre]

Período: [Desde / hasta]

FARO Score: [Score actual] / Variación: [delta]

Resumen ejecutivo: [Lectura directiva en 5-8 líneas]

Prioridades: 1. [P1/P2 + tema + responsable] 2. [P1/P2 + tema + responsable] 3. [P1/P2 + tema + responsable]

Tensiones activas: - [Tensión + severidad + estado] - [Tensión + severidad + estado]

KPIs críticos: - [KPI + valor + variación + lectura] - [KPI + valor + variación + lectura]

Acciones: - Abiertas: - Vencidas: - Cerradas: - Efectivas:

Decisiones pendientes: - [Decisión + aprobador + vencimiento]

Riesgos próximos: - [Riesgo + fecha estimada + responsable]

Foco recomendado: [Qué debería mirar Dirección esta semana]

29. Plantilla de reporte de Directorio

REPORTE FARO PARA DIRECTORIO

1. Estado general
2. Evolución FARO Score
3. Lectura de rentabilidad, caja y ejecución
4. Tensiones estructurales
5. Riesgos relevantes
6. Decisiones tomadas
7. Decisiones pendientes de aprobación
8. Impacto económico estimado
9. Calidad de datos y confianza
10. Foco recomendado para el próximo período
11. Anexos técnicos Este reporte debe ser sobrio, claro y defendible. Nada de “semáforos navideños”.

30. Anexos dentro del reporte

El reporte ejecutivo puede tener anexos: Anexo A — KPIs completos Anexo B — Alertas Anexo C — Tensiones Anexo D — Acciones abiertas Anexo E — Acciones vencidas Anexo F — Evidencia relevante Anexo G — Simulaciones Anexo H — Calidad de datos Anexo I — FARO Score detallado La portada debe ser ejecutiva.
Los anexos deben sostener técnicamente la lectura.

31. Reporte y niveles de audiencia

Audiencia Necesita ver Dueño / Directorio Score, riesgos, decisiones, impacto, foco. Gerente General Prioridades, acciones, responsables, tensiones. Gerente de área KPIs del área, acciones, vencimientos, impacto. Responsable operativo Tareas, evidencia, vencimientos. Data / Sistemas calidad de datos, integraciones, errores. Socio técnico trazabilidad, reglas, SQL, modelos, auditoría. FARO debe adaptar reporte según audiencia.

32. Reporte y lenguaje ejecutivo

Mala salida RULE_MARGIN_DROP activated. Salida aceptable Margen bruto por debajo del umbral. Salida FARO El margen bruto cayó por debajo del objetivo y la caída coincide con aumento de descuentos. La lectura sugiere tensión de crecimiento no rentable. Requiere revisión comercial y financiera. Regla: El reporte debe hablar idioma dirección, no idioma base de datos.

33. Reporte y confianza

Todo reporte debe mostrar confianza cuando sea relevante. Ejemplo: Diagnóstico: Margen deteriorado.

Confianza: Media — 0.68.

Motivo: Costos incompletos en 18% de productos vendidos. Esto evita que Dirección tome una decisión fuerte con datos débiles.

34. Reporte y evidencia

El reporte debe indicar si las acciones cerradas tienen evidencia válida. Ejemplo: Acciones cerradas esta semana: 11

Con evidencia validada: 8

Sin evidencia suficiente: 3

Lectura: La tasa de cierre mejoró, pero la calidad de cierre todavía requiere control.

35. Reporte y simulaciones

Cuando haya decisiones sensibles, el reporte debe incluir resumen de simulación. Ejemplo: Decisión: Cambiar fórmula de comisión.

Simulación: Escenario recomendado: piloto por 30 días. Impacto esperado: margen +2 a +4 puntos. Riesgo: resistencia comercial media. Confianza: 0.76. Estado: pendiente aprobación Dirección.

36. Reporte y aprendizaje

El reporte debe mostrar qué aprendió FARO. Ejemplo: Aprendizajes del período: 1. La auditoría de descuentos fue efectiva para recuperar margen. 2. La reposición preventiva redujo quiebres en productos críticos. 3. La simulación de canje fue optimista; se debe ajustar factor de liquidez. 4. Las acciones de cobranza requieren seguimiento más corto.

37. Reporte generado automáticamente vs curado

FARO puede tener dos tipos de reportes: Tipo Uso Automático Se genera desde datos, reglas y plantillas. Curado Un gerente agrega comentario o validación. Modelo recomendado: FARO genera automáticamente. Responsable valida o comenta. Dirección recibe versión ejecutiva. Esto evita reportes manuales eternos, pero mantiene juicio humano.

38. Tabla SQL de reportes

CREATE TABLE reports (
    report_id TEXT PRIMARY KEY,
    report_type TEXT NOT NULL,
    company_id TEXT,
    branch_id TEXT,
    area_id TEXT,
    period_start DATE,
    period_end DATE,
    title TEXT,
    executive_summary TEXT,
    faro_score NUMERIC,
    faro_score_delta NUMERIC,
    confidence NUMERIC,
    report_quality_score NUMERIC,
    status TEXT DEFAULT 'draft',
    generated_by TEXT,
    generated_at TIMESTAMP DEFAULT now(),
    validated_by TEXT,
    validated_at TIMESTAMP,
    published_at TIMESTAMP
);

39. Tabla SQL de secciones de reporte

CREATE TABLE report_sections (
    section_id TEXT PRIMARY KEY,
    report_id TEXT NOT NULL,
    section_order INTEGER,
    section_type TEXT NOT NULL,
    title TEXT,
    content JSONB,
    narrative TEXT,
    confidence NUMERIC,
    created_at TIMESTAMP DEFAULT now()
);

Tipos de sección: executive_summary faro_score priorities kpis alerts tensions diagnoses actions decisions risks evidence learning annex

40. Tabla SQL de distribución de reportes

CREATE TABLE report_distribution (
    distribution_id TEXT PRIMARY KEY,
    report_id TEXT NOT NULL,
    recipient_user_id TEXT,
    recipient_role TEXT,
    channel TEXT,
    sent_at TIMESTAMP,
    opened_at TIMESTAMP,
    acknowledged_at TIMESTAMP,
    status TEXT DEFAULT 'pending'
);

Canales: FARO Connect email PDF WhatsApp ejecutivo board_pack API

41. Tabla SQL de plantillas de reporte

CREATE TABLE report_templates (
    template_id TEXT PRIMARY KEY,
    report_type TEXT NOT NULL,
    title TEXT NOT NULL,
    audience TEXT,
    required_sections JSONB,
    optional_sections JSONB,
    default_frequency TEXT,
    output_format TEXT,
    active BOOLEAN DEFAULT true,
    version TEXT DEFAULT '1.0',
    created_at TIMESTAMP DEFAULT now(),
    updated_at TIMESTAMP DEFAULT now()
);

42. Tabla SQL de agenda ejecutiva

CREATE TABLE executive_agendas (
    agenda_id TEXT PRIMARY KEY,
    company_id TEXT,
    report_id TEXT,
    meeting_type TEXT,
    period_start DATE,
    period_end DATE,
    agenda_items JSONB,
    decisions_required JSONB,
    actions_to_review JSONB,
    created_at TIMESTAMP DEFAULT now()
);

43. Motor de generación de reportes

Flujo recomendado: definir período → recolectar KPIs → calcular FARO Score → seleccionar alertas relevantes → seleccionar tensiones activas → seleccionar diagnósticos → ordenar prioridades → traer acciones y seguimiento → traer evidencia y cierres → identificar decisiones pendientes → calcular impacto → redactar resumen ejecutivo → generar reporte → validar → distribuir Código conceptual:

def motor_reportes(contexto):
    prioridades = sorted(
        contexto["priorities"],
        key=lambda x: x["priority_score"],
        reverse=True
    )[:5]

    reporte = {
        "report_type": contexto["report_type"],
        "period": contexto["period"],
        "faro_score": contexto["faro_score"],
        "score_delta": contexto["score_delta"],
        "top_priorities": prioridades,
        "active_tensions": contexto["active_tensions"],
        "critical_actions": contexto["critical_actions"],
        "decisions_required": contexto["decisions_required"],
        "executive_summary": generar_resumen_ejecutivo(
            score=contexto["faro_score"],
            score_delta=contexto["score_delta"],
            mejoras=contexto["improvements"],
            riesgos=contexto["risks"],
            decisiones=contexto["decisions_required"],
            foco=contexto["recommended_focus"]
        )["summary"]
    }

    return reporte

44. Motor de selección de contenido

FARO no debe meter todo en el reporte. Código:

def seleccionar_temas_reporte(eventos, limite=10):
    eventos_rankeados = sorted(
        eventos,
        key=lambda e: ranking_tema_reporte(
            prioridad=e.get("priority_score", 0),
            impacto_score=e.get("score_impact", 0),
            urgencia=e.get("urgency_score", 0),
            impacto_economico=e.get("economic_impact_score", 0),
            recurrencia=e.get("recurrence_score", 0),
            confianza=e.get("confidence_score", 0)
        ),
        reverse=True
    )

    return eventos_rankeados[:limite]

45. Motor de distribución

def distribuir_reporte(reporte, audiencia):
    canales = []

    if audiencia == "directorio":
        canales = ["FARO Connect", "PDF", "email"]

    elif audiencia == "gerencia_general":
        canales = ["FARO Connect", "email"]

    elif audiencia == "p1_exception":
        canales = ["FARO Connect", "email", "WhatsApp ejecutivo"]

    return {
        "report_id": reporte["report_id"],
        "audience": audiencia,
        "channels": canales
    }

46. Ejemplo completo: reporte semanal ejecutivo

Datos FARO Score anterior: 68 FARO Score actual: 74

Acciones: 18 creadas 11 cerradas 3 vencidas 6 medidas

Tensiones: crecimiento no rentable — mejorando caja débil — activa stock crítico — reducida Reporte FARO Resumen ejecutivo: La empresa mejoró su FARO Score de 68 a 74 por mayor disciplina de ejecución, reducción de stock crítico y baja del descuento promedio. Sin embargo, la caja continúa bajo presión por cobranza lenta y quedan 3 acciones prioritarias vencidas.

Prioridad de Dirección: 1. Normalizar caja. 2. Cerrar acciones financieras vencidas. 3. Sostener mejora de margen sin frenar ventas sanas.

47. Ejemplo completo: reporte de Directorio

Estado general: La empresa muestra mejora operativa, pero mantiene tensión financiera.

FARO Score: 74, +6 puntos respecto al período anterior.

Riesgos: - caja todavía debajo del mínimo, - cobranza lenta, - comisiones pendientes de recalibración.

Decisiones requeridas: - aprobar política de descuentos, - definir piloto de comisión, - aprobar plan de cobranza intensiva.

Conclusión: La empresa está mejorando, pero la prioridad no debe ser solo crecimiento. Debe proteger caja, margen y ejecución.

48. Ejemplo completo: reporte de calidad de datos

Calidad general: 0.78 — confiable con observaciones.

Problemas: - costos incompletos en 12% de productos, - stock físico pendiente de conciliación en 2 sucursales, - clientes duplicados afectan mora.

Impacto: Los diagnósticos de margen y mora deben leerse con confianza media hasta corregir datos.

49. Uso de IA en reportes

La IA puede ayudar a: redactar resumen ejecutivo, ordenar narrativa, traducir KPIs a lenguaje directivo, generar lectura por área, explicar variación de Score, resumir riesgos, preparar agenda de comité. Pero no debe: inventar datos, inventar causas, ocultar baja confianza, exagerar impacto, atribuir resultados sin medición, crear decisiones no aprobadas. Prompt interno: Actúa como analista ejecutivo FARO.

Con base únicamente en el payload estructurado recibido, redacta un reporte ejecutivo claro, sobrio y accionable.

No inventes datos. No agregues causas no sustentadas. Distingue hechos, hipótesis y decisiones pendientes. Incluye: 1. estado general, 2. FARO Score y variación, 3. prioridades, 4. tensiones, 5. acciones, 6. decisiones pendientes, 7. riesgos, 8. foco recomendado.

Payload: {executive_report_payload} Regla: La IA redacta. FARO calcula, filtra y gobierna.

50. Testing de reportes

Test calidad de reporte

def test_calidad_reporte_alta():
    score = calidad_reporte(
        cobertura_kpis=0.90,
        calidad_datos=0.85,
        evidencia_disponible=0.90,
        actualizacion=0.95,
        claridad_prioridades=0.90,
        decisiones_identificadas=0.80
    )

assert score >= 0.85

Test reporte de excepción

def test_generar_reporte_excepcion_por_p1():
    evento = {
        "priority_level": "P1",
        "title": "Caja bajo mínimo"
    }

    reporte = generar_reporte_excepcion(evento)

assert reporte is not None
assert reporte["requires_immediate_attention"] is True

Test selección de temas

def test_seleccionar_temas_reporte():
    eventos = [
        {"priority_score": 90, "score_impact": 80, "urgency_score": 90, "economic_impact_score": 70, "recurrence_score": 50, "confidence_score": 80},
        {"priority_score": 40, "score_impact": 20, "urgency_score": 30, "economic_impact_score": 20, "recurrence_score": 20, "confidence_score": 90}
    ]

    temas = seleccionar_temas_reporte(eventos, limite=1)

assert len(temas) == 1
assert temas[0]["priority_score"] == 90

51. Errores comunes en reportes ejecutivos

Error Consecuencia Mostrar demasiados KPIs Dirección pierde foco. No explicar el Score El número parece arbitrario. No separar hechos de hipótesis Se decide con falsa seguridad. No mostrar prioridades Todo parece igual de importante. No mostrar responsables No hay accountability. No mostrar acciones vencidas Se oculta falta de ejecución. No mostrar decisiones pendientes La reunión no decide nada. No incluir evidencia El reporte pierde defensa técnica. No adaptar audiencia Directorio recibe detalle operativo innecesario. Reporte lindo pero no accionable Mucho diseño, poca dirección.

52. Riesgos si no existe esta capa

Riesgo Consecuencia FARO detecta pero no comunica bien Baja adopción directiva. Dirección recibe demasiado detalle Pierde foco. No se ven decisiones pendientes La gestión se demora. No se ven acciones vencidas Se normaliza incumplimiento. Score no se entiende Pierde credibilidad. Reportes manuales eternos Se vuelve caro y lento. Información sin narrativa No orienta decisiones. No hay versión para Directorio Difícil vender FARO como sistema ejecutivo.

53. Output final del Anexo 34

Al finalizar este anexo, FARO debe tener definido: 1. Tipos de reportes ejecutivos. 2. Reporte diario. 3. Reporte semanal. 4. Reporte mensual. 5. Reporte de Directorio. 6. Reporte por área. 7. Reporte por sucursal. 8. Reporte de tensiones. 9. Reporte de acciones. 10. Reporte de calidad de datos. 11. Reporte de decisiones pendientes. 12. Reporte de excepción. 13. Plantillas por audiencia. 14. Estructura estándar de reporte. 15. Métrica de calidad del reporte. 16. Selección automática de temas relevantes. 17. Explicación del FARO Score. 18. Resumen ejecutivo automatizado. 19. Agenda de comité. 20. Impacto económico reportable. 21. Riesgos próximos. 22. Evidencia vinculada. 23. Distribución por canal. 24. Tablas SQL de reportes. 25. Motor de generación de reportes. 26. Motor de selección de contenido. 27. Motor de distribución. 28. Testing de reportes. 29. Uso controlado de IA explicativa. 30. Aprendizaje a partir de reportes y decisiones.

54. Conexión con otros anexos

Próximo anexo Qué recibe desde Anexo 34 Anexo 17 — Biblioteca de KPIs KPIs mostrados en reportes. Anexo 21 — Alertas FARO Alertas relevantes para comunicar. Anexo 22 — Biblioteca de tensiones Tensiones activas y resueltas. Anexo 23 — Diagnóstico ejecutivo Lecturas ejecutivas del reporte. Anexo 24 — Confianza del diagnóstico Nivel de confianza comunicado. Anexo 25 — Priorización ejecutiva Orden de temas en el reporte. Anexo 26 — Recomendaciones FARO Recomendaciones comunicadas. Anexo 27 — Simulación de escenarios Simulaciones resumidas para decisión. Anexo 29 — Biblioteca de acciones Acciones abiertas, cerradas y vencidas. Anexo 30 — Responsables y RACI Responsables y aprobadores del reporte. Anexo 31 — Workflow y escalamiento Estados, vencimientos y bloqueos. Anexo 32 — Evidencia y cierre Evidencia de acciones cerradas. Anexo 33 — Seguimiento y medición Impacto real y efectividad. Anexo 35 — FARO Score Score explicado y reportado. Anexo 36 — Aprendizaje Aprendizajes del período. Anexo 37 — Recalibración Ajustes sugeridos desde resultados.

Los Reportes Ejecutivos FARO transforman KPIs, alertas, tensiones, diagnósticos, prioridades, acciones, evidencia, seguimiento y FARO Score en una lectura clara para Dirección. No son reportes de datos: son reportes de gestión, decisión y control.