Backlog MVP — FARO Connect

Tomando como base obligatoria que el MVP debe demostrar la cadena completa carga Excel/CSV → RAW → Staging → Normalización → Maestros → KPIs → Alertas → Tensiones → Diagnóstico → Recomendación → Acción → Responsable → Workflow → Evidencia → FARO Score → Reporte ejecutivo, el backlog debe enfocarse en una cosa: probar que FARO no muestra datos; dirige la acción.

---

1. Principio rector del MVP

El MVP no tiene que tener 400 KPIs, 1000 tensiones ni integraciones sofisticadas.

Tiene que demostrar esto:

Una empresa carga datos simples.

FARO los guarda, limpia, interpreta, detecta un problema real, propone qué hacer, asigna responsables, exige evidencia, mide impacto y actualiza el Score.

Eso es producto.

Lo demás es expansión.

---

2. Alcance funcional del MVP

Incluido en MVP

---

Excluido del MVP

---

3. Roadmap del MVP por releases

Release 0 — Base técnica

Objetivo: dejar la plataforma lista para operar con usuarios, empresa, permisos y estructura modular.

Release 1 — Pipeline de datos

Objetivo: permitir cargar Excel/CSV y llevar datos desde RAW hasta Staging.

Release 2 — Normalización y maestros

Objetivo: convertir datos sucios en datos utilizables por FARO.

Release 3 — Modelo ejecutivo y KPIs

Objetivo: calcular KPIs iniciales de ventas, margen, stock y cobranza.

Release 4 — Alertas, tensiones y diagnóstico

Objetivo: detectar problemas reales y explicar causa probable.

Release 5 — Acciones, workflow y evidencia

Objetivo: convertir diagnóstico en ejecución controlada.

Release 6 — FARO Score y reporte ejecutivo

Objetivo: sintetizar estado, foco y evolución.

Release 7 — IA explicativa controlada

Objetivo: redactar explicaciones ejecutivas sin inventar datos.

---

4. Épicas principales del MVP

---

5. Backlog detallado en formato Jira / Linear

---

EPIC-01 — Fundación técnica y estructura base

Objetivo: crear la base mínima segura para operar empresas, usuarios, roles y permisos.

Roles MVP

---

EPIC-02 — Ingesta Excel / CSV

Objetivo: permitir carga manual de archivos como punto de entrada del MVP.

Estados de carga

---

EPIC-03 — RAW y trazabilidad de carga

Objetivo: guardar todo como llegó, sin modificarlo. RAW es el seguro contra el “¿quién tocó el número?”. Vieja escuela, pero funciona.

Tablas sugeridas

• `raw_imports`
• `raw_import_files`
• `raw_rows`
• `raw_errors`

---

EPIC-04 — Staging, limpieza y validación

Objetivo: transformar datos crudos en datos ordenados, pero todavía no definitivos.

Validaciones mínimas

---

EPIC-05 — Normalización y maestros básicos

Objetivo: unificar nombres, códigos, fechas, monedas, productos, clientes y sucursales.

Maestros MVP

---

EPIC-06 — Modelo ejecutivo inicial

Objetivo: construir las tablas de hechos mínimas para que FARO pueda calcular KPIs.

---

EPIC-07 — Biblioteca inicial de KPIs

Objetivo: calcular KPIs mínimos que permitan detectar la tensión demo: crecimiento no rentable.

KPIs MVP recomendados

---

EPIC-08 — Señales y reglas de negocio

Objetivo: convertir KPIs en señales interpretables.

Señales iniciales

---

EPIC-09 — Alertas MVP

Objetivo: notificar situaciones que requieren atención.

Alertas MVP mínimas

---

EPIC-10 — Tensiones MVP

Objetivo: detectar contradicciones ejecutivas. No síntomas aislados: tensiones.

10 tensiones MVP

---

EPIC-11 — Diagnóstico ejecutivo

Objetivo: convertir tensiones en lectura ejecutiva clara.

Ejemplo diagnóstico MVP

Tensión detectada: Crecimiento no rentable

Diagnóstico: La empresa está creciendo en ventas, pero deteriora margen y caja. El crecimiento parece impulsado por mayores descuentos y peor cobranza.

Confianza: 87%

Prioridad: Alta

Áreas involucradas: Comercial, Finanzas, Stock, Dirección

---

EPIC-12 — Recomendaciones FARO

Objetivo: proponer líneas de acción sin reemplazar al gerente.

Recomendaciones MVP para TNS-001

---

EPIC-13 — Acciones, responsables y RACI simple

Objetivo: que FARO pase de “mirar” a “hacer”.

Acciones iniciales para demo

---

EPIC-14 — Workflow, vencimientos y escalamiento básico

Objetivo: controlar avance real. Una acción sin seguimiento es PowerPoint con perfume.

Estados de acción

---

EPIC-15 — Evidencia y cierre

Objetivo: ninguna acción crítica se cierra “porque sí”.

Tipos de evidencia MVP

---

EPIC-16 — FARO Score básico

Objetivo: sintetizar estado de dirección, ejecución y riesgo.

Fórmula MVP

FARO Score =
Comercial × 25%
+ Financiero × 25%
+ Stock × 20%
+ Ejecución × 20%
+ Calidad de datos × 10%

Ejemplo demo

---

EPIC-17 — Reporte ejecutivo semanal

Objetivo: generar un reporte entendible para Dirección.

Estructura reporte MVP

1. FARO Score actual

2. Variación vs período anterior

3. Tensión principal

4. Diagnóstico ejecutivo

5. Drivers positivos

6. Drivers negativos

7. Alertas críticas

8. Acciones creadas

9. Acciones vencidas

10. Evidencia pendiente

11. Foco recomendado de Dirección

---

EPIC-18 — IA explicativa controlada

Objetivo: usar IA como redactor ejecutivo, no como brujo de datos.

Payload ejemplo

{
  "company_id": "demo-company",
  "period": "2026-05",
  "diagnosis": {
    "tension_code": "TNS-001",
    "tension_name": "Crecimiento no rentable",
    "confidence": 0.87,
    "priority": "high"
  },
  "kpis": {
    "sales_growth": 0.18,
    "gross_margin_previous": 0.28,
    "gross_margin_current": 0.21,
    "discount_previous": 0.06,
    "discount_current": 0.12,
    "dso_previous": 32,
    "dso_current": 43
  },
  "allowed_output": [
    "executive_summary",
    "drivers",
    "recommended_focus"
  ],
  "forbidden_output": [
    "new_kpis",
    "new_scores",
    "unapproved_actions",
    "invented_data"
  ]
}

---

EPIC-19 — Auditoría básica

Objetivo: registrar quién hizo qué, cuándo y sobre qué dato.

---

EPIC-20 — UI ejecutiva MVP

Objetivo: interfaz sobria, clara y ejecutiva. No dashboard decorativo. Dirección no necesita una nave espacial; necesita saber dónde poner presión.

---

6. Flujo demo obligatorio del MVP

Este flujo debe funcionar de punta a punta.

Paso 1 — Carga

Usuario carga tres archivos:

1. ventas_mayo.xlsx

2. stock_mayo.xlsx

3. cobranza_mayo.xlsx

---

Paso 2 — RAW

FARO guarda todo como llegó.

Resultado esperado:

3 archivos recibidos
12.480 filas RAW guardadas
0 archivos modificados

---

Paso 3 — Staging

FARO limpia y valida.

Resultado esperado:

11.950 filas válidas
430 filas observadas
100 filas rechazadas
Calidad de datos: 91%

---

Paso 4 — Normalización

FARO unifica productos, clientes, vendedores y sucursales.

Resultado esperado:

1.240 productos identificados
860 clientes identificados
18 vendedores identificados
3 sucursales identificadas

---

Paso 5 — KPIs

FARO calcula:

Ventas: +18%
Margen: 28% → 21%
Descuento: 6% → 12%
Días de cobranza: 32 → 43
Stock crítico: 37 productos
Acciones vencidas: 24%

---

Paso 6 — Señales

FARO detecta:

Ventas suben
Margen cae
Descuento sube
Cobranza empeora
Stock crítico
Ejecución atrasada

---

Paso 7 — Tensión

FARO detecta:

TNS-001 — Crecimiento no rentable

---

Paso 8 — Diagnóstico

La empresa está creciendo en ventas, pero deteriora margen y caja.
El crecimiento parece impulsado por descuentos superiores al rango aceptable,
con deterioro simultáneo en la cobranza y riesgo operativo por stock crítico.

---

Paso 9 — Recomendaciones

1. Auditar descuentos por vendedor.
2. Priorizar cobranza vencida.
3. Revisar política de comisiones.
4. Validar stock crítico.
5. Aprobar política comercial de margen mínimo.

---

Paso 10 — Acciones

FARO crea o sugiere acciones:

---

Paso 11 — Evidencia

Cada responsable debe subir evidencia.

---

Paso 12 — Score

FARO Score inicial: 66
FARO Score posterior: 74

El sistema debe explicar por qué subió:

Mejoró ejecución.
Se redujo riesgo comercial.
Se validó stock crítico.
Se activó cobranza prioritaria.

---

7. Modelo de prioridades

Para evitar el clásico pantano de software: todo lo que no ayuda a demostrar dato → acción → Score queda fuera del MVP.

---

8. Orden recomendado de construcción

Fase 1 — Núcleo técnico

1. Auth

2. Companies

3. Users

4. Roles

5. Permissions

6. Audit básico

---

Fase 2 — Pipeline de datos

1. Ingestion

2. RAW

3. Staging

4. Validación

5. Normalización

6. Maestros

---

Fase 3 — Motor ejecutivo

1. Executive model

2. KPIs

3. Signals

4. Rules

5. Alerts

6. Tensions

7. Diagnosis

---

Fase 4 — Ejecución

1. Recommendations

2. Actions

3. RACI simple

4. Workflow

5. Evidence

6. Tracking

---

Fase 5 — Dirección

1. FARO Score

2. Reporte ejecutivo

3. IA explicativa

4. Vista ejecutiva

5. Demo completa

---

9. Definición de terminado del MVP

El MVP está terminado cuando se pueda hacer esta demo sin intervención manual escondida:

---

10. Backlog técnico mínimo de base de datos

Tablas núcleo

companies
users
roles
permissions
user_roles
branches

Tablas ingesta

raw_imports
raw_import_files
raw_rows
raw_errors
staging_sales
staging_stock
staging_receivables

Tablas maestras

master_products
master_customers
master_salespeople
master_branches

Tablas modelo ejecutivo

fact_sales
fact_stock_snapshot
fact_receivables

Tablas motor FARO

kpi_definitions
kpi_results
signal_definitions
signal_results
rule_definitions
alert_definitions
alert_results
tension_definitions
tension_results
diagnosis_results
recommendation_definitions
recommendation_results

Tablas ejecución

actions
action_comments
action_evidence
action_status_history
raci_assignments
workflow_events

Tablas Score y reportes

score_results
score_components
executive_reports
report_sections

Tablas auditoría e IA

audit_logs
ai_requests
ai_responses

---

11. Primer paquete de desarrollo recomendado

Para arrancar sin dispersión, el primer paquete debería ser este:

Sprint / Paquete 1 — Base + carga + RAW

Resultado del primer paquete

Un usuario entra,
selecciona empresa,
carga Excel,
FARO guarda archivo original,
guarda filas RAW,
muestra estado de carga,
registra auditoría.

Eso ya empieza a ser sistema. Todavía no dirige, pero ya tiene columna vertebral.

---

12. Segundo paquete recomendado

Sprint / Paquete 2 — Staging + validación + normalización

Resultado del segundo paquete

El archivo deja de ser una planilla suelta.
Pasa a ser información ordenada y utilizable por FARO.

---

13. Tercer paquete recomendado

Sprint / Paquete 3 — KPIs + señales + alertas

Resultado del tercer paquete

FARO ya no guarda datos.
FARO empieza a leer señales.

---

14. Cuarto paquete recomendado

Sprint / Paquete 4 — Tensiones + diagnóstico + acciones

Resultado del cuarto paquete

FARO detecta el problema,
lo explica,
propone acción
y asigna responsable.

Acá empieza el diferencial serio.

---

15. Quinto paquete recomendado

Sprint / Paquete 5 — Workflow + evidencia + Score + reporte

Resultado del quinto paquete

FARO cierra el ciclo:
dato → diagnóstico → acción → evidencia → medición → Score → reporte.

---

16. Riesgos del MVP y mitigación

---

17. Frase rectora para el equipo técnico

El MVP de FARO Connect no termina cuando muestra KPIs.

Termina cuando una tensión detectada genera una acción con responsable, evidencia y efecto medible en el FARO Score.

---

18. Conclusión ejecutiva

Este backlog deja el MVP en un camino serio:

1. No infla arquitectura.

2. No arranca con microservicios innecesarios.

3. No promete IA mágica.

4. No se queda en dashboard.

5. Prueba la cadena completa de dirección.

La prioridad inmediata debería ser bajar este backlog a dos piezas técnicas:

1. Modelo SQL inicial.

2. Historias P0 listas para desarrollo.