ACTIVO FARO NECESARIO

Fórmulas FARO por KPI

Versión V1 — 1.000 fórmulas iniciales diseñadas

---

1. Objetivo del activo

Definir la biblioteca de fórmulas que FARO utiliza para calcular KPIs por:

• Empresa.
• Unidad de negocio.
• Sucursal.
• Área.
• Módulo.
• Responsable.
• Vendedor.
• Cliente.
• Producto.
• Rubro.
• Subrubro.
• Canal.
• Proveedor.
• Proyecto.
• Centro de costo.
• Industria.
• Período.

Este activo permite que FARO ejecute fórmulas simples, compuestas, comparativas, contextuales y ponderadas para alimentar:

• KPIs.
• Alertas.
• Tensiones.
• Diagnósticos.
• Recomendaciones.
• Acciones.
• Reportes.
• FARO Score.

---

2. Tesis FARO

FARO no debe tener KPIs escritos a mano como fórmulas sueltas.

Debe tener un motor de fórmulas gobernado, donde cada KPI tenga:

• Código.
• Nombre.
• Fórmula.
• Fuente de datos.
• Dimensiones de cálculo.
• Frecuencia.
• Responsable.
• Umbral.
• Contexto.
• Calidad mínima del dato.
• Impacto en alertas.
• Impacto en tensiones.
• Impacto en Score.

La regla madre:

Todo KPI FARO debe tener fórmula trazable, ejecutable, versionada y auditable.

Si no hay fórmula clara, el KPI es opinión con porcentaje. Y de eso las empresas ya tienen bastante.

---

3. Diferencia entre métrica, KPI, fórmula, alerta y tensión

---

4. Tipos de fórmulas FARO

---

5. Convenciones de fórmula FARO

Para estandarizar, FARO debería usar una sintaxis interna.

Funciones base

---

6. Dimensiones obligatorias de ejecución

Cada fórmula debe poder ejecutarse con filtros o agrupaciones.

---

7. Estructura técnica de cada fórmula

Cada fórmula FARO debe tener esta ficha.

---

8. Volumen recomendado

Decisión recomendada

Diseñar 1.000 fórmulas iniciales.
Activar 180 en MVP.
Activar 450 en Business.
Activar 800 en Enterprise.
Usar 1.000+ en Neural.

---

9. Familias de fórmulas FARO

La biblioteca V1 se organiza en 25 familias, con 40 fórmulas por familia.

---

10. Núcleo MVP — 180 fórmulas prioritarias

Para el MVP, FARO debe activar primero fórmulas que demuestren la cadena completa:

dato → KPI → alerta → tensión → acción → Score

---

10.1 Comercial / Ventas

15 fórmulas MVP

---

10.2 Margen / Rentabilidad Comercial

15 fórmulas MVP

---

10.3 Descuentos / Bonificaciones

10 fórmulas MVP

---

10.4 Clientes / CRM

10 fórmulas MVP

---

10.5 Cotizaciones / Conversión

10 fórmulas MVP

---

10.6 Caja / Bancos

10 fórmulas MVP

---

10.7 Cobranza / Cuentas por Cobrar

15 fórmulas MVP

---

10.8 Pagos / Cuentas por Pagar

10 fórmulas MVP

---

10.9 Gastos / Administración

10 fórmulas MVP

---

10.10 Compras

10 fórmulas MVP

---

10.11 Proveedores

10 fórmulas MVP

---

10.12 Stock / Inventario

15 fórmulas MVP

---

10.13 Reposición / Abastecimiento

10 fórmulas MVP

---

10.14 Logística / Entregas

10 fórmulas MVP

---

10.15 RRHH / Personas

10 fórmulas MVP

---

10.16 Comisiones

10 fórmulas MVP

---

10.17 Proyectos / Obras / Servicios

10 fórmulas MVP

---

10.18 Workflow / Acciones

10 fórmulas MVP

---

10.19 Calidad de Datos / Auditoría

10 fórmulas MVP

---

10.20 FARO Score / Dirección

10 fórmulas MVP

---

11. Fórmulas compuestas críticas

Estas fórmulas son las que hacen que FARO deje de ser tablero.

---

11.1 Crecimiento no rentable

crecimiento_no_rentable_score =
sales_growth_score * 0.25
+ margin_decline_score * 0.35
+ discount_increase_score * 0.20
+ collection_risk_score * 0.10
+ stock_pressure_score * 0.10

Lectura

Si ventas suben, margen baja, descuentos suben, cobranza empeora y stock se presiona, FARO detecta tensión de crecimiento no rentable.

---

11.2 Venta sin caja

venta_sin_caja_score =
sales_growth_score * 0.25
+ accounts_receivable_growth_score * 0.25
+ dso_increase_score * 0.25
+ cash_decline_score * 0.25

---

11.3 Stock rentable en riesgo

stock_rentable_en_riesgo =
product_margin_score * 0.30
+ product_rotation_score * 0.30
+ stockout_risk_score * 0.30
+ supplier_lead_time_risk * 0.10

---

11.4 Cliente grande riesgoso

cliente_grande_riesgoso =
customer_sales_concentration_score * 0.25
+ overdue_score * 0.30
+ margin_low_score * 0.20
+ credit_exposure_score * 0.25

---

11.5 Comisión mal alineada

comision_mal_alineada =
commission_growth_score * 0.25
+ margin_decline_score * 0.30
+ discount_increase_score * 0.25
+ collection_delay_score * 0.20

---

11.6 Diagnóstico sin ejecución

diagnostico_sin_ejecucion =
critical_alerts_open_score * 0.25
+ overdue_actions_score * 0.30
+ repeated_tensions_score * 0.25
+ evidence_missing_score * 0.20

---

12. Reglas de ejecución por alcance

La misma fórmula debe poder ejecutarse por distintos alcances.

Ejemplo: margen bruto %

margen_bruto_pct =
SAFE_DIVIDE(SUM(net_amount - cost_amount), SUM(net_amount))

Puede calcularse por:

---

13. Reglas de calidad mínima

No toda fórmula puede ejecutarse con cualquier dato.

Regla

Si la calidad de datos es menor al mínimo requerido,
FARO debe calcular con advertencia o bloquear la fórmula.

---

14. Fórmulas por industria

Algunas fórmulas cambian según industria.

Retail

venta_por_m2 =
venta_neta / superficie_m2

rotacion_stock_retail =
costo_mercaderia_vendida / inventario_promedio

Construcción / obras

margen_por_obra =
(ingreso_certificado - costo_real_obra) / ingreso_certificado

avance_fisico_vs_financiero =
avance_fisico_pct - avance_financiero_pct

Salud

ocupacion_camas =
camas_ocupadas / camas_disponibles

ausentismo_turnos =
turnos_no_asistidos / turnos_programados

Hotelería

revpar =
ingreso_habitaciones / habitaciones_disponibles

adr =
ingreso_habitaciones / habitaciones_ocupadas

SaaS

mrr =
SUM(active_subscription_monthly_amount)

churn_rate =
customers_lost / customers_start_period

Logística

costo_por_km =
costo_total_flota / kilometros_recorridos

entrega_a_tiempo_pct =
entregas_a_tiempo / entregas_totales

---

15. Tabla SQL sugerida: biblioteca de fórmulas

CREATE TABLE faro_kpi_formulas (
    formula_id UUID PRIMARY KEY,
    formula_code VARCHAR(80) UNIQUE NOT NULL,
    kpi_code VARCHAR(80) NOT NULL,

    formula_name VARCHAR(240) NOT NULL,
    formula_type VARCHAR(80) NOT NULL,

    expression TEXT NOT NULL,
    expression_language VARCHAR(40) DEFAULT 'FARO_DSL',

    output_type VARCHAR(60),
    aggregation_level VARCHAR(80),
    allowed_dimensions JSONB,

    required_tables JSONB,
    required_fields JSONB,
    required_data_quality_score NUMERIC(5,2),

    frequency_code VARCHAR(40),
    module_code VARCHAR(80),
    area_code VARCHAR(80),

    applies_to_industries JSONB,
    applies_to_company_types JSONB,

    threshold_rules JSONB,
    alert_codes JSONB,
    tension_codes JSONB,
    action_codes JSONB,

    score_impact_direction VARCHAR(40),
    score_impact_weight NUMERIC(6,4),

    formula_status VARCHAR(40) DEFAULT 'ACTIVE',
    version VARCHAR(40) DEFAULT 'V1',

    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

---

16. Tabla SQL sugerida: ejecuciones de fórmulas

CREATE TABLE faro_formula_executions (
    formula_execution_id UUID PRIMARY KEY,
    company_id UUID NOT NULL,

    formula_code VARCHAR(80) NOT NULL,
    kpi_code VARCHAR(80),

    period_id VARCHAR(80) NOT NULL,
    execution_scope JSONB,

    result_value NUMERIC(18,6),
    result_text TEXT,
    result_status VARCHAR(40),

    data_quality_score NUMERIC(5,2),
    confidence_score NUMERIC(5,2),

    records_used INTEGER,
    source_batches JSONB,

    alerts_triggered JSONB,
    tensions_triggered JSONB,
    actions_suggested JSONB,

    executed_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

---

17. Tabla SQL sugerida: dependencias de fórmulas

CREATE TABLE faro_formula_dependencies (
    dependency_id UUID PRIMARY KEY,

    formula_code VARCHAR(80) NOT NULL,
    depends_on_formula_code VARCHAR(80) NOT NULL,

    dependency_type VARCHAR(60),
    required BOOLEAN DEFAULT TRUE,

    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

---

18. Reglas FARO para fórmulas

---

19. Output esperado en FARO

FARO debe poder mostrar el resultado así:

KPI:
Margen bruto %

Resultado:
21%

Alcance:
Sucursal San Juan / Rubro Cemento / Mayo 2026

Fórmula:
SUM(venta_neta - costo) / SUM(venta_neta)

Datos usados:
1.248 líneas de venta

Fuente:
Excel ventas + maestro productos + costos ERP

Calidad del dato:
92%

Comparación:
Período anterior: 28%

Alerta:
Margen cayó 7 puntos.

Tensión:
Crecimiento no rentable.

Acción sugerida:
Revisar descuentos por vendedor y bloquear operaciones bajo margen mínimo.

---

20. Relación con alertas, tensiones y acciones

---

21. Definición oficial del activo

Nombre

Fórmulas FARO por KPI

Objetivo

Definir una biblioteca gobernada de fórmulas ejecutables por empresa, sucursal, área, módulo, responsable, cliente, producto, proveedor, canal, rubro, industria y período, permitiendo calcular KPIs simples, compuestos, contextuales y ponderados para alimentar alertas, tensiones, acciones, reportes y FARO Score.

Volumen estimado V1

---

22. Frase para explicar

FARO tiene una biblioteca de fórmulas por KPI. Cada fórmula puede ejecutarse por empresa, sucursal, área, responsable, cliente, producto, canal, rubro, industria y período. Así calcula indicadores simples y compuestos, detecta alertas, activa tensiones, recomienda acciones y actualiza FARO Score con trazabilidad.

---

23. Decisión recomendada

Para MVP:

Diseñar 1.000 fórmulas.
Activar 180 fórmulas críticas.
Priorizar ventas, margen, descuentos, cobranza, caja, stock, compras, gastos, RRHH, logística, acciones, calidad de datos y Score.

Para Business:

Activar 450 fórmulas.
Sumar comisiones avanzadas, clientes, proveedores, centros de costo, sucursales, flujo financiero, proyectos y calidad.

Para Enterprise:

Activar 800 fórmulas.
Sumar presupuesto, contratos, producción, mantenimiento, industria, benchmark, riesgo y auditoría avanzada.

Para Neural:

Usar 1.000+ fórmulas con pesos dinámicos por industria, contexto, confianza de datos, aprendizaje y simulación.

---

24. Cadena correcta dentro de FARO

Dato validado
→ maestro
→ contexto
→ fórmula KPI
→ resultado
→ umbral
→ alerta
→ relación causal
→ tensión
→ recomendación
→ acción
→ evidencia
→ impacto FARO Score

La fórmula es el puente entre el dato y la dirección. Si la fórmula está mal, todo lo demás queda elegante pero torcido.