01 · Resumen ejecutivo
Un piloto FARO no se gana con pantallas, se gana con cadena dato-reporte
Este runbook (FARO-DOC-002) define el procedimiento operativo para implementar un piloto de FARO Connect en 30 a 60 días. No es un cronograma flexible: es la cadena dura que evita que el piloto arranque con entusiasmo y termine con veinte Excels, tres reuniones y cero trazabilidad.
Un piloto FARO no busca construir todo el producto. Busca demostrar, con datos reales o semirreales, que FARO puede convertir información dispersa en dirección ejecutiva accionable. La validación mínima es una cadena indivisible que cualquier dirección puede recorrer mentalmente sin saltos:
Dato entra
→
se conserva (RAW)
→
se limpia (staging)
→
se mide (KPI)
→
señal
→
tensión
→
acción
→
responsable
→
evidencia
→
Score
→
reporte ejecutivo
Si esa cadena no ocurre, no hay piloto: hay presentación. Si ocurre, FARO deja de ser “otro dashboard prometido” y se vuelve, en el lenguaje del director, “ya entiendo qué está pasando, por qué importa, quién debe actuar y cómo eso afecta la salud real de la empresa”.
El piloto debe demostrar, como mínimo, 5 tensiones ejecutivas, 1 reporte semanal completo y FARO Score calculado con su explicación. Todo lo demás es alcance opcional. La regla operativa: arrancar acotado, cerrar con evidencia. El entusiasmo del cliente es bueno; el descontrol del alcance es la receta clásica para un piloto que termina sin decisión.
Este documento se apoya sobre la guía de Workshop Discovery (entrada del flujo), el contrato de datos (qué exigir al cliente para recibir muestras), los 5 playbooks de industria (qué priorizar según vertical), el backlog MVP (qué se construye en cada fase) y el pipeline interactivo (vista visual del flujo). Cierra con comunicación de cierre del piloto.
Cliente demo usado en este runbook. Cada fase incluye un ejemplo concreto de qué se hizo en Empresa Demo Cuyo S.A. (caso de referencia anonimizado del pack NDA). Permite que el equipo de implementación vea no solo qué hacer en abstracto, sino qué quedó realmente cargado, calculado y reportado al final del piloto.
02 · Alcance MVP del piloto
Qué entra al primer piloto y qué no
FARO entra al piloto enfocado en módulos de mayor valor ejecutivo y menor complejidad técnica. Ampliar alcance es la forma más común de matar el piloto: cada módulo extra suma 1 fuente, 3 KPIs, 1 regla y al menos 1 ciclo de validación.
Objetivo mínimo demostrable
El piloto se considera técnicamente “completo” cuando al final del recorrido la dirección ve, en una sola lectura de 5 minutos:
5
Tensiones ejecutivas detectadas
8
KPIs calculados con confianza
5
Acciones generadas con responsable
1
Reporte semanal completo
1
FARO Score calculado y explicado
Si alguno de estos umbrales no se cumple, el piloto pasa a estado “extender” antes que a “cerrar”. Cerrar un piloto sin objetivo mínimo demostrable destruye credibilidad ejecutiva más rápido que cualquier otro error operativo.
03 · Participantes y responsabilidades
Quién hace qué del lado FARO y del lado cliente
Los roles se asignan antes de Fase 0. Sin sponsor interno cliente y sin líder de implementación FARO, el piloto no arranca: pausa hasta resolver.
Matriz RACI del piloto
R Responsable ejecutor · A Aprobador · C Consultado · I Informado
04 · Condiciones mínimas para iniciar
Tres bloques de pre-requisitos: comerciales, técnicos, datos
Si alguno de los pre-requisitos marcados Requerido no está cumplido, el piloto no arranca. No se compensan entre sí: no hay forma de cubrir falta de sponsor interno con mejor stack técnico, ni viceversa.
4.1 · Comerciales
Acuerdo y sponsor
- ReqSponsor interno identificado
- ReqAlcance acordado por escrito
- RecNDA o acuerdo de confidencialidad firmado
- ReqExpectativa clara de piloto (no implementación)
- ReqAprobación para usar muestras de datos
- ReqReunión de seguimiento semanal agendada
4.2 · Técnicas
Acceso y stack
- ReqInventario de fuentes iniciado (
FARO-PL-016)
- ReqAl menos 2 fuentes disponibles
- ReqExportación de ventas disponible
- ReqExportación de productos o maestro equivalente
- ReqIdentificador de fecha estable
- ReqIdentificador de documento / transacción
- ReqResponsable técnico del cliente
- ReqFormato repetible CSV / XLSX / API
- ReqAmbiente local o staging definido
4.3 · Datos
Tres dominios mínimos
- ReqMuestra de ventas (dominio 1)
- ReqMuestra de productos (dominio 2)
- RecMuestra de clientes
- RecMuestra de stock
- RecMuestra de cobranza (dominio 3 sugerido)
- IdealHistórico mínimo 3 meses
- AceptHistórico mínimo 1 mes
- ReqDatos anónimos permitidos
- ReqEstructura de columnas estable
Regla del piso. El cliente debe poder entregar muestras estables de al menos 3 dominios de datos (típicamente ventas + productos + cobranza o stock). Sin esos tres, FARO no puede demostrar la cadena dato→reporte: queda en monitoreo de una vertical, lo cual no es piloto sino prueba de concepto.
05 · 11 fases del piloto
Timeline operativa de la cadena dato a reporte
El piloto recorre 11 fases ordenadas. Cada fase tiene actividades, outputs, checklist, duración sugerida y responsables claros del lado FARO y del lado cliente. Las fases no se solapan en serio: una fase mal cerrada contamina las siguientes.
0
Preparación2-3 días
Alinear alcance, responsables, confidencialidad y entorno. Ver detalle ↓
1
Discovery1-3 días
Levantar negocio, dolores, decisiones y red flags. Ver detalle ↓
2
Inventario de fuentes2-5 días
Completar FARO-PL-016 con clasificación A/B/C/D. Ver detalle ↓
3
Recepción de muestras2-5 días
Recibir archivos, validar estructura y guardar copia RAW intacta. Ver detalle ↓
4
Diseño técnico MVP3-7 días
Definir entidades, tablas RAW / staging, KPIs y tensiones MVP. Ver detalle ↓
5
Carga RAW1-3 días
Conservar datos originales sin alterarlos, con trazabilidad de lote. Ver detalle ↓
6
Staging y normalización3-7 días
Aplicar reglas explícitas de limpieza con DQ status auditable. Ver detalle ↓
7
KPIs y señales3-5 días
Calcular KPIs MVP y detectar señales con umbrales explícitos. Ver detalle ↓
8
Tensiones y acciones3-7 días
Convertir señales en tensiones ejecutivas con responsable y workflow. Ver detalle ↓
9
Reporte y Score2-5 días
Calcular FARO Score y generar el reporte semanal ejecutivo. Ver detalle ↓
10
Validación con cliente1-2 semanas
Revisar con dirección cliente si genera lectura útil, no solo datos correctos. Ver detalle ↓
11
Cierre / expansión2-5 días
Decidir continuidad: continuar, extender, pausar, rechazar. Ver detalle ↓
Cronograma sugerido 30 días. Semana 1 cubre fases 0-3 (relevamiento + datos). Semana 2 cubre fases 4-6 (modelo + carga + staging). Semana 3 cubre fases 7-8 (KPIs + tensiones + workflow). Semana 4 cubre fases 9-11 (reporte + validación + cierre). Para 60 días, cada bloque se duplica en holgura, no en alcance.
06 · Fase 0 · Preparación
Antes de hablar de datos, ordenar la mesa
Sin sponsor interno, sin alcance preliminar y sin carpeta segura, el piloto arranca arrastrando deuda organizativa. Esta fase parece administrativa: en realidad evita el 70% de los problemas de las fases técnicas.
Fase 0
2-3 días
Preparación · alinear alcance, responsables y confidencialidad
Asegurar que el piloto no arranque desordenado. El equipo FARO no toca un dato hasta tener sponsor confirmado, responsables identificados, NDA enviado, código de cliente asignado y entorno de trabajo definido.
Actividades qué se hace
- Confirmar sponsor interno del cliente (alguien que pueda autorizar y destrabar).
- Confirmar lista de participantes (FARO + cliente).
- Confirmar confidencialidad: NDA o acuerdo equivalente firmado o enviado.
- Definir alcance preliminar v0 (módulos in / out, plazo, frecuencia de reuniones).
- Definir fechas clave: Discovery, gates de avance, presentación final.
- Crear carpeta segura de proyecto:
/clientes/{company_code}/.
- Asignar
company_code normalizado (ej. EMP001, CUYO-001).
- Definir entorno técnico: local, staging o sandbox aislado.
Outputs qué queda
- Sponsor definido + lista participantes.
- NDA enviado / firmado registrado.
- Alcance preliminar v0 escrito.
- Cronograma con fechas clave.
- Carpeta segura creada con estructura.
company_code asignado.
- Entorno técnico definido + responsable.
- Estado:
listo_para_discovery.
Checklist Fase 0 8 puntos
Sponsor interno identificado
Responsable técnico identificado
Responsable de negocio identificado
Reunión Discovery agendada
NDA enviado o firmado
Carpeta segura creada
Alcance preliminar definido
Código de cliente asignado
Responsables
FARO · Líder implementación
Cliente · Sponsor interno
Ejemplo · Empresa Demo Cuyo S.A. · qué quedó en Fase 0
Sponsor confirmado (dirección general), responsable técnico de sistemas asignado, NDA firmado a 48 horas del primer contacto, alcance v0 acotado a Comercial + Finanzas + Stock con tres sucursales activas, código CUYO-001 asignado, carpeta segura creada en drive controlado y sandbox local listo para recibir muestras. Sin nombres personales: solo roles.
07 · Fase 1 · Discovery
Levantar negocio, dolores, decisiones y red flags
El Discovery ejecuta la guía FARO-DOC-001 · Workshop Discovery MVP (PENDIENTE de publicar). El objetivo no es hacer entrevistas extensas, sino obtener una primera lectura ejecutiva del negocio que permita priorizar fuentes, KPIs y tensiones candidatas.
Fase 1
1-3 días
Discovery · primera lectura ejecutiva
Identificar las decisiones que la dirección toma tarde o a ciegas, los KPIs que existen pero no generan acción, los responsables que deberían actuar ante cada tensión y la evidencia que demostraría cierre real. Ese material alimenta todas las fases siguientes.
Actividades qué se hace
- Ejecutar workshop con dirección + responsables de área (2-4 horas).
- Identificar decisiones críticas que se toman tarde o sin información.
- Identificar dolores recurrentes por área.
- Identificar fuentes disponibles (borrador de inventario).
- Identificar responsables actuales por proceso.
- Identificar red flags iniciales (datos no disponibles, áreas sin sponsor, expectativas irreales de IA, etc.).
- Responder 6 preguntas clave: qué quiere ver la dirección, qué fuente está más disponible, qué decisión se toma tarde, qué KPI no genera acción, quién debe actuar ante cada tensión, qué evidencia demuestra cierre.
Outputs qué queda
FARO-DOC-001-R · Minuta Discovery firmada por sponsor.
FARO-PL-001 · Mapa inicial empresa / áreas / sucursales.
FARO-PL-016 · Inventario preliminar de fuentes.
FARO-KPI-MVP · Lista de KPIs candidatos MVP.
FARO-TNS-MVP · Lista de tensiones candidatas MVP.
FARO-RISK-001 · Riesgos / red flags iniciales.
- Matriz dolor → tensión preliminar.
- RACI preliminar por área.
Gate de avance · Fase 1 → 2 5 condiciones
Al menos 3 fuentes identificadas
Al menos 1 responsable técnico definido
Al menos 5 decisiones críticas relevadas
Al menos 5 tensiones candidatas
Sponsor interno activo y disponible
Responsables
FARO · Facilitador workshop + Analista
Cliente · Dirección + responsables de área
Ejemplo · Empresa Demo Cuyo S.A. · qué quedó en Fase 1
Workshop de 3 horas con dirección + responsable comercial + responsable de finanzas. Se identificaron 7 decisiones críticas (de las cuales 3 P1: política de descuentos por vendedor, priorización de cobranza, reposición de stock crítico). 6 tensiones candidatas alineadas con el catálogo MVP: TNS-001 (crecimiento no rentable), TNS-002 (descuento fuera de política), TNS-004 (venta sin caja), TNS-005 (mora crítica), TNS-006 (stock crítico) y TNS-009 (acciones vencidas). Red flag inicial: el ERP exporta ventas en XLSX pero con encabezados inconsistentes mes a mes.
08 · Fase 2 · Inventario de fuentes
Completar FARO-PL-016 con clasificación A / B / C / D
El inventario es donde se cae el optimismo de la fase Discovery: muchas fuentes prometidas no existen como archivo estable, no tienen responsable definido o están en formatos no apto para MVP. Mejor descubrirlo acá que en Fase 5.
Fase 2
2-5 días
Inventario de fuentes · clasificación operativa
Completar FARO-PL-016 con todas las fuentes relevantes del piloto, su responsable, su accesibilidad, su frecuencia, su calidad preliminar y su clasificación operativa (A automatizable / B semi / C manual controlada / D no apta).
Fuentes mínimas recomendadas prioridad
- P1 Ventas · base de facturación, margen y comercial.
- P1 Productos · permite cruzar ventas y stock.
- P1 Clientes · permite cobranza y segmentación.
- P1 Stock · permite quiebres, cobertura e inmovilizado.
- P1 Cobranza · permite caja, mora y riesgo.
- P1 Acciones actuales · permite workflow y evidencia.
- P2 Vendedores / empleados, Compras, Proveedores, Bancos.
Clasificación operativa A / B / C / D
- A · Automatizable — API, DB, export programado. Acción: preparar conector.
- B · Semi-automatizable — export manual estable. Acción: plantilla controlada.
- C · Manual controlada — se carga en Excel FARO. Acción: validar formato.
- D · No apta — incompleta o no confiable. Acción: excluir del MVP.
Actividades qué se hace
- Completar pestaña Inventario (fuente, owner, formato, periodicidad).
- Completar campos por fuente (diccionario inicial).
- Completar accesos (URL, credencial, carpeta compartida, etc.).
- Evaluar calidad preliminar (DQ score).
- Evaluar frecuencia y SLA de actualización.
- Mapear cada fuente al módulo FARO correspondiente.
- Registrar riesgos (campos faltantes, encoding, fechas inconsistentes).
Outputs qué queda
FARO-PL-016 · Inventario completo al 70% mínimo.
- Diccionario inicial por fuente.
- Mapa de acceso por fuente.
- Score DQ preliminar.
- SLA por fuente.
- Mapeo fuente → módulo FARO.
- Brechas y bloqueos registrados.
Gate de avance · Fase 2 → 3 6 condiciones
FARO-PL-016 completo al 70%
Fuente de ventas clasificada
Fuente de productos clasificada
Al menos una fuente financiera o stock
Responsable por fuente definido
Riesgos principales identificados
Responsables
FARO · Data analyst + Líder implementación
Cliente · Resp. sistemas + dueños de fuente
Ejemplo · Empresa Demo Cuyo S.A. · qué quedó en Fase 2
Inventario cerrado al 85% con 9 fuentes relevadas. Clasificación final: 3 fuentes B (ventas, productos y stock vía export XLSX semanal), 2 fuentes C (clientes y cobranza en planilla manual controlada), 1 fuente A (bancos vía API del banco), 3 fuentes D excluidas (RRHH no maduro, compras sin diccionario estable, proveedores con datos sensibles fuera de NDA). Bloqueo registrado: encabezados del export de ventas cambian de nombre mes a mes — se acordó contrato de columnas estable a partir de la Fase 4.
09 · Fase 3 · Recepción de muestras
Archivos llegan, copia RAW intacta, trabajo sobre copia de análisis
Recibir archivos parece trivial. En la práctica, el 80% de los pilotos que se complican lo hacen acá: archivos por WhatsApp con datos sensibles, versiones que se pisan, encoding roto, sin trazabilidad de quién entregó qué. Las 10 reglas de recepción no son recomendación: son política.
Fase 3
2-5 días
Recepción de muestras · validar estructura y guardar RAW
Recibir archivos de muestra para validar estructura, calidad, campos y posibilidad de carga. Cada archivo recibido genera un registro de ingestión con responsable, fecha, hash y validación inicial; copia RAW se preserva intacta, todo análisis se hace sobre copia.
10 reglas de recepción política dura
- No recibir archivos por WhatsApp si contienen datos sensibles.
- Preferir carpeta compartida controlada (drive corporativo).
- Registrar fecha de recepción y versión del archivo.
- Registrar responsable que entrega (rol, no nombre personal).
- No modificar el archivo original.
- Guardar copia RAW intacta con hash.
- Trabajar sobre copia de análisis separada.
- Anonimizar cuando sea necesario.
- No pedir datos innecesarios.
- Aplicar nomenclatura estándar.
Nomenclatura + estructura obligatoria
- Patrón:
{company_code}_{source}_{periodo}_{version}_{fecha}.{ext}
- Ejemplo:
CUYO-001_ventas_2026-01_v01_2026-05-30.xlsx
- Estructura de carpetas estándar:
/clientes/{code}/00_admin/, /01_discovery/, /02_fuentes/, /03_raw_samples/, /04_mapping/, /05_staging_tests/, /06_kpis/, /07_rules/, /08_reports/, /09_evidence/, /10_delivery/.
- Cada subcarpeta corresponde 1:1 a una fase del runbook.
Validación inicial por archivo 10 controles
- Formato (CSV, XLSX, JSON, PDF, API).
- Tamaño y peso razonable.
- Hojas identificadas (XLSX).
- Encabezados claros.
- Fechas en formato reconocible.
- IDs presentes (documento, cliente, producto, vendedor).
- Montos con moneda y separador decimal.
- Duplicados (registros repetidos).
- Vacíos en campos críticos.
- Sensibilidad (datos personales, sueldos, bancos).
Outputs qué queda
- Registro
muestras_recibidas por archivo (YAML / JSON).
- Copia RAW preservada con hash.
- Copia de análisis renombrada.
- Validación inicial documentada.
- Marca
apto_mapping: true / false por archivo.
- Riesgos de sensibilidad documentados.
Checklist por archivo 10 puntos
Archivo recibido
Nombre normalizado
Copia RAW guardada
Fuente vinculada en FARO-PL-016
Responsable registrado
Periodo identificado
Columnas principales detectadas
Riesgo de sensibilidad revisado
Calidad preliminar evaluada
Apto para mapping
Responsables
FARO · Data analyst
Cliente · Resp. sistemas (entrega) + sponsor (autoriza)
Ejemplo · Empresa Demo Cuyo S.A. · qué quedó en Fase 3
Se recibieron 6 archivos del periodo 2026-01 a 2026-04 vía drive corporativo: ventas, productos, clientes, stock, cobranza y bancos. Todos guardados como RAW con hash sha256 en /clientes/CUYO-001/03_raw_samples/. Anonimización aplicada a clientes (razón social → ID alfanumérico). Archivo de cobranza marcado warning (faltaban fechas de vencimiento en el 12% de los registros). Resto aptos para mapping. Tiempo total de recepción + validación: 3 días.
10 · Fase 4 · Diseño técnico MVP
Traducir fuentes y datos en modelo técnico mínimo viable
El diseño técnico no busca la arquitectura definitiva: busca el modelo más simple que sostenga la cadena dato → reporte. Multi-empresa desde el inicio (company_id + roles), validación en capa de schema, reglas en YAML/JSON declarativo (nunca hardcodeadas).
Fase 4
3-7 días
Diseño técnico MVP · entidades, tablas, KPIs, reglas
Definir las entidades base (companies, products, fact_sales, tensions, etc.), las tablas RAW y staging, los KPIs MVP, las tensiones MVP del catálogo canónico, el workflow de acciones y los permisos por rol.
Decisiones técnicas mínimas
Dec 01
Base de datos
PostgreSQL como estándar MVP. Soporta jsonb (RAW), arrays (códigos canónicos), tipos UUID y políticas RLS para multiempresa.
Dec 02
Storage RAW
S3 / Supabase Storage / GCS para producción; local para demo. Archivos originales preservados con hash.
Dec 03
Backend
FastAPI / Node / monolito modular según equipo. Separación clara entre capa ingestión, capa reglas y capa API.
Dec 04
Jobs
Celery / RQ / BullMQ / cron según stack. Idempotentes y reprocesables desde RAW.
Dec 05
Frontend
Next.js / React. Bandeja de tensiones, vista de KPIs y reporte semanal mínimos.
Dec 06
Validación schema
JSON Schema / Zod en API + constraints SQL. Doble capa para que ningún dato inválido llegue a staging.
Dec 07
Reglas
YAML / JSON declarativo. Prohibido hardcodear umbrales en código de aplicación.
Dec 08
IA
Explicativa controlada. No decide, no inventa, no rellena datos faltantes.
Dec 09
Seguridad
company_id en cada tabla + roles + RLS futuro. Multiempresa desde el inicio, aunque el piloto tenga una sola empresa.
Modelo mínimo de entidades
Maestros organizativos + datos
companies · empresa / cliente.
branches · sucursales.
areas · áreas funcionales.
users + roles + permissions.
products · maestro productos.
customers · maestro clientes.
suppliers · maestro proveedores.
employees · empleados / vendedores.
Operacionales datos + lógica
raw_ingestions · lotes RAW.
raw_records · registros originales.
staging_records · registros normalizados.
fact_sales, fact_stock, fact_receivables.
kpi_snapshots · KPIs calculados por período.
signal_log + rule_evaluations.
tensions + actions + evidence.
score_snapshots + reports.
Gate de avance · Fase 4 → 5 7 condiciones
Entidades MVP definidas
Tablas RAW definidas
Tablas staging definidas
KPIs MVP definidos
Tensiones MVP seleccionadas
Mapeo fuente → tabla definido
Riesgos técnicos documentados
Responsables
FARO · Data engineer + Backend + Analista
Cliente · Resp. técnico (consultado en mapeo)
Ejemplo · Empresa Demo Cuyo S.A. · qué quedó en Fase 4
Modelo SQL en PostgreSQL con 24 tablas (8 maestros + 4 RAW/staging + 5 facts + 4 reglas/tensiones/acciones + 3 reportes/score). KPIs MVP definidos: 9 (3 comerciales, 3 financieros, 3 stock). Tensiones MVP seleccionadas: 6 del catálogo canónico (TNS-001/002/004/005/006/009). Reglas escritas en YAML declarativo con umbrales explícitos. Mapeo fuente → staging definido por columna. Riesgo técnico documentado: el campo fecha del export de ventas viene como string en 3 formatos distintos.
11 · Fase 5 · Carga RAW
RAW es la verdad recibida, no la verdad corregida
La carga RAW conserva los datos originales tal cual llegaron. Nunca se modifica el archivo original; nunca se corrige el payload. Esa disciplina es la base de la trazabilidad: cualquier KPI debe poder explicar de qué lote RAW se derivó y por qué.
Fase 5
1-3 días
Carga RAW · ingestión, lote, hash, trazabilidad
Cargar cada archivo en raw_ingestions (un lote por archivo) + raw_records (un registro por fila original con payload jsonb). Generar hash, registrar usuario y timestamp, mantener trazabilidad hasta staging y facts.
10 principios RAW no negociables
- Nunca modificar el archivo original.
- Guardar
payload original en jsonb.
- Registrar fuente (
source_id).
- Registrar lote (
ingestion_id).
- Registrar usuario / responsable.
- Registrar timestamp de recepción.
- Registrar hash / checksum.
- Registrar estado de carga.
- Permitir reproceso desde RAW.
- Mantener trazabilidad hasta staging + facts.
Estados de ingesta enum auditado
received · archivo recibido.
stored · archivo almacenado en RAW storage.
parsed · archivo leído correctamente.
failed_parse · error al leer (encoding, formato, etc.).
loaded_raw · registros cargados en tabla RAW.
rejected · archivo rechazado por validación.
quarantined · aislado por riesgo de seguridad.
ready_staging · listo para pasar a staging.
Campos mínimos de tabla RAW
Checklist Fase 5 8 puntos
Archivo RAW almacenado
Hash generado
Lote creado en raw_ingestions
Registros parseados
Payload original preservado
Conteo de registros validado
Errores de parseo registrados
Listo para staging
Responsables
FARO · Data engineer + Backend
Cliente · Resp. técnico (informado)
Ejemplo · Empresa Demo Cuyo S.A. · qué quedó en Fase 5
6 lotes cargados en RAW con un total de 18.420 registros (ventas 14.200, productos 1.840, clientes 920, stock 980, cobranza 450, bancos 30). Hash sha256 generado por archivo y guardado en metadatos del lote. 12 registros marcados warning (faltan fechas de vencimiento) y 3 registros marcados fatal (monto vacío). Todo el payload original preservado en raw_records.payload. Tiempo total de carga: 2 días.
12 · Fase 6 · Staging y normalización
Transformar datos originales en datos utilizables con reglas auditables
Staging no es "limpiar a mano". Es aplicar reglas explícitas, repetibles y auditables. Toda transformación queda documentada (fecha, moneda, IDs maestros) con DQ status asignado por registro: ok, warning, error o fatal.
Fase 6
3-7 días
Staging · normalización con DQ explícito por registro
Aplicar transformaciones típicas (fechas a ISO, monedas a numérico, productos a IDs maestros, descuentos a fracción, cálculo de margen si falta) y asignar a cada registro un DQ status auditable. Los registros fatales se excluyen del cálculo; los warning se procesan con marca; los error se revisan caso por caso.
Transformaciones típicas ejemplos
- Fechas ·
30/05/2026 → 2026-05-30
- Moneda ·
$ 1.250,50 → 1250.50
- Producto ·
Cemento 50kg → product_id
- Cliente ·
JUAN PEREZ SRL → customer_id
- Vendedor ·
M. Lopez → employee_id
- Sucursal ·
SJ → branch_id
- Documento ·
F A-0001-000123 → document_number
- Descuento ·
10% → 0.10
- Margen · calcular si faltara.
- Nulos · clasificar según criticidad.
Estados DQ enum auditado
ok · registro válido → procesar.
warning · error menor no bloqueante → procesar con marca.
error · error relevante corregible → revisar o corregir.
fatal · no puede procesarse → excluir hasta resolver.
Reglas mínimas de calidad
Tablas staging típicas
staging_sales · ventas normalizadas.
staging_products · productos normalizados.
staging_customers · clientes normalizados.
staging_stock · stock normalizado.
staging_receivables · cobranzas normalizadas.
staging_purchases · compras normalizadas.
staging_employees · vendedores / empleados.
staging_suppliers · proveedores.
Checklist Fase 6 9 puntos
Campos mapeados
Fechas normalizadas
Monedas normalizadas
IDs maestros relacionados
DQ status asignado por registro
Errores registrados con detalle
Registros fatales excluidos
Registros warning procesados con marca
Resumen de calidad generado
Responsables
FARO · Data engineer + QA
Cliente · Resp. negocio (consultado en casos warning/error)
Ejemplo · Empresa Demo Cuyo S.A. · qué quedó en Fase 6
De los 18.420 registros RAW: 17.890 quedaron ok (97.1%), 480 warning (faltaba vendedor o cliente), 47 error (stock negativo o factura sin vencimiento) y 3 fatal excluidos del cálculo. Mapeo a 7 tablas staging completo. Resumen de calidad por fuente publicado y validado con responsable comercial y de finanzas. Tiempo total de staging: 5 días.
13 · Fases 7 a 11
De KPIs y señales hasta cierre y decisión de continuidad
Las últimas cinco fases consumen lo construido en 0-6 y lo transforman en lectura ejecutiva: KPIs calculados → tensiones detectadas → reporte ejecutivo con Score → validación de dirección → decisión de continuidad. Cada fase mantiene la misma estructura (actividades, outputs, checklist, gate, ejemplo Cuyo).
Fase 7
3-5 días
KPIs y señales · medir y detectar variación relevante
Un KPI es una medición. Una señal es una variación o condición que merece atención. Esta fase calcula los 8-12 KPIs mínimos del MVP por dimensión (empresa, sucursal, vendedor cuando aplica) y genera el log de señales que alimenta la Fase 8.
KPIs iniciales recomendados 12 mínimos
KPI-SAL-001 Ventas netas · KPI-SAL-002 Margen bruto · KPI-SAL-003 Descuento promedio · KPI-SAL-004 Venta por vendedor.
KPI-FIN-001 Días de cobranza · KPI-FIN-002 Mora vencida · KPI-FIN-003 Cobranza sobre facturación.
KPI-STK-001 Stock crítico · KPI-STK-002 Cobertura de stock · KPI-STK-003 Stock inmovilizado.
KPI-COM-001 Variación de costo · KPI-OPS-001 Acciones vencidas.
Señales iniciales recomendadas 8 mínimas
- Ventas suben (variación > umbral) · Margen baja (actual < referencia).
- Descuento sube · Cobranza se estira (días > umbral).
- Mora crece · Stock crítico (cobertura < mínimo).
- Stock inmovilizado (días sin rotación > umbral).
- Acción vencida (fecha < hoy y estado abierto).
Campos mínimos kpi_snapshot
Gate de avance · Fase 7 → 8 6 condiciones
Al menos 8 KPIs calculados
KPIs por empresa
KPIs por sucursal si aplica
KPIs por vendedor si aplica
Confianza calculada por KPI
Señales generadas en signal_log
Responsables
FARO · Líder implementación + Backend + Analista negocio
Cliente · Resp. negocio (validación de KPIs)
Ejemplo · Empresa Demo Cuyo S.A. · qué quedó en Fase 7
10 KPIs calculados por empresa + por sucursal (3 sucursales activas) + por vendedor en KPIs comerciales. Confianza promedio 0.86 (lastrada por la fuente cobranza con histórico parcial). 14 señales generadas en signal_log, de las cuales 9 con severidad relevante para alimentar Fase 8.
Fase 8
3-7 días
Tensiones, acciones y workflow · de señal a decisión accionable
FARO no debe alertar por cada número raro. Debe detectar combinaciones de señales que representen una tensión ejecutiva del catálogo canónico. Cada tensión disparada genera una acción con responsable, SLA, evidencia requerida e impacto en Score.
Principio clave. Ejemplo: Ventas suben + Margen baja + Descuento sube + Cobranza se estira = Tensión TNS-001 "Crecimiento no rentable". No es un alertón sobre descuento, es una lectura ejecutiva sobre la salud del crecimiento.
Tensiones MVP recomendadas para piloto
Workflow de acción
Checklist Fase 8 10 puntos
Reglas MVP cargadas en YAML
Señales vinculadas a reglas
Tensiones generadas en tabla tensions
Severidad calculada
Responsable asignado por tensión
Acción sugerida creada
SLA definido por acción
Evidencia requerida por acción
Impacto en Score definido
Workflow probado de punta a punta
Responsables
FARO · Analista FARO + Backend + Frontend
Cliente · Usuarios responsables (prueban flujo)
Ejemplo · Empresa Demo Cuyo S.A. · qué quedó en Fase 8
6 tensiones disparadas en el periodo: 2 críticas (mora crítica por cliente, caja proyectada insuficiente para una sucursal), 3 altas (crecimiento no rentable global, vendedor erosiona margen en zona norte, stock crítico en SKU rotativo), 1 media (acciones vencidas en mantenimiento). Cada tensión con responsable asignado por rol, SLA de 5-10 días y evidencia requerida. Workflow probado con 3 usuarios cliente reales.
Fase 9
2-5 días
FARO Score y reporte ejecutivo · síntesis para dirección
Sintetizar el estado del piloto en una lectura ejecutiva clara. El FARO Score no es promedio simple: refleja salud comercial, rentabilidad, caja, stock, ejecución de acciones, calidad de datos y riesgo, ponderados según contexto. El reporte semanal traduce el Score en lenguaje de dirección.
Pesos sugeridos Score v1 piloto 100%
- Salud comercial · 20%
- Rentabilidad / margen · 20%
- Caja / cobranza · 15%
- Stock / operación · 15%
- Ejecución de acciones · 15%
- Calidad y confianza de datos · 10%
- Riesgo crítico · 5%
Secciones del reporte semanal 9 bloques
- Resumen ejecutivo (lectura clara para dirección).
- FARO Score actual + variación + explicación.
- Top 3-5 tensiones principales.
- Acciones críticas (vencidas, próximas, bloqueadas).
- KPIs clave (ventas, margen, descuentos, cobranza, stock).
- Evidencia (acciones cerradas y evidencia recibida).
- Riesgos (dato, operación, responsables).
- Recomendaciones (próximas decisiones sugeridas).
- Foco ejecutivo de la próxima semana.
Checklist Fase 9 10 puntos
Score calculado
Variación explicada
Top tensiones incluidas
Acciones vencidas incluidas
Acciones cerradas incluidas
KPIs con fuente identificada
Confianza de datos visible
Recomendaciones prudentes
No se inventan datos
Dirección puede decidir con el reporte
Responsables
FARO · Líder implementación + Dirección FARO (aprueba)
Cliente · Dirección (recibe y evalúa)
Ejemplo · Empresa Demo Cuyo S.A. · qué quedó en Fase 9
Score inicial 64/100 (rojo en caja, amarillo en margen, verde en comercial volumen). Reporte semanal con 6 tensiones priorizadas, 4 acciones críticas vencidas (3 de cobranza, 1 de stock crítico), confianza promedio 0.86 explícita por sección, 3 recomendaciones de dirección (revisar política de descuentos, priorizar cobranza top-10, reasignar stock SKU rotativo a sucursal norte). Reporte entregado en PDF + vista web del producto.
Fase 10
1-2 semanas
Validación con cliente · ¿genera lectura útil, no solo datos correctos?
El piloto puede tener datos perfectos y aun así fracasar si la dirección cliente no encuentra la lectura útil. Esta fase confronta el output contra la pregunta dura: ¿esto me sirve para decidir esta semana? Sin esa validación no hay continuidad razonable.
10 preguntas de validación ejecutiva obligatorias
- ¿La tensión detectada tiene sentido?
- ¿El responsable asignado es correcto?
- ¿La acción sugerida es razonable?
- ¿La evidencia requerida es posible?
- ¿El Score refleja la realidad de la empresa?
- ¿El reporte ayuda a decidir?
- ¿Qué alerta fue ruido?
- ¿Qué alerta faltó?
- ¿Qué KPI no sirve?
- ¿Qué dato necesita más confianza?
Matriz de feedback por elemento
- Cada KPI, tensión, acción, responsable y bloque del reporte recibe marca: Correcto, Ajustar, Eliminar, con comentario libre.
- Decisiones de cambio se clasifican: corrección / ajuste menor / mejora / backlog / nuevo alcance (ver política de cambios).
- El piloto pasa a Fase 11 solo si dirección cliente marca el reporte como "sí, ayuda a decidir".
Criterios de éxito del piloto
5
Tensiones detectadas mín.
3
Responsables asignados mín.
3
Evidencias cargadas mín.
Responsables
FARO · Líder implementación + Dirección FARO
Cliente · Dirección + responsables de área
Ejemplo · Empresa Demo Cuyo S.A. · qué quedó en Fase 10
Dirección validó 5 de 6 tensiones como útiles (1 marcada para ajuste de umbral). 8 de 10 KPIs aprobados sin cambios; 2 con ajuste de fórmula (margen por familia y cobertura de stock). Score aprobado en su lógica de pesos. Reporte semanal validado como entregable directivo. Recomendación: continuar a fase paga con expansión a una sucursal adicional y conectar API del banco.
Fase 11
2-5 días
Cierre y decisión de continuidad · evidencia + aprendizajes + propuesta
Cerrar el piloto con evidencia, aprendizajes y decisión comercial / técnica. No se cierra el piloto sin propuesta de siguiente paso ni sin informe final firmado por sponsor cliente y dirección FARO.
5 decisiones posibles
Continuar a fase paga
El piloto mostró valor; cliente decide producción + expansión.
Extender piloto
Faltan datos pero hay potencial: extender 30 días con datos faltantes.
Repetir con otra fuente
Fuente inicial no alcanzó; piloto se rehace con dataset alternativo.
Pausar
Cliente no tiene madurez organizativa para usar el output.
Rechazar implementación
Datos o sponsor insuficientes; no hay base para producción.
Entregables de cierre
FARO-CLOSE-001
Informe cierre piloto
Resultado ejecutivo con métricas vs criterios de éxito.
FARO-PL-016
Matriz fuentes final
Fuentes usadas, pendientes y bloqueos remanentes.
FARO-KPI-MVP
KPIs validados
Indicadores aprobados por dirección cliente.
FARO-TNS-MVP
Tensiones validadas
Tensiones útiles + falsos positivos descartados.
FARO-ACT-MVP
Acciones ejecutadas
Seguimiento, cierre y evidencia documentada.
FARO-SCORE-001
Score evolución
Antes / después con explicación ejecutiva.
FARO-RISK-001
Riesgos remanentes
Qué falta resolver para producción.
FARO-ROAD-001
Roadmap siguiente fase
Qué construir después y en qué orden.
FARO-PROP-001
Propuesta comercial
Plan recomendado: módulos, integraciones, plazo y precio.
Responsables
FARO · Dirección + Líder implementación
Cliente · Dirección + Sponsor interno
Ejemplo · Empresa Demo Cuyo S.A. · qué quedó en Fase 11
Decisión: continuar a fase paga. Score evolucionó de 64 a 71 al cierre (acciones de cobranza top-10 cerradas, política de descuentos ajustada). Roadmap acordado: ampliar a las 5 sucursales, conectar API del banco como fuente A, agregar módulo Compras en el trimestre siguiente. Propuesta comercial firmada con plazo de implementación de 60 días para la fase 2.
14 · Casos típicos por industria
Cómo se aplica el runbook según vertical del cliente
El runbook es uniforme; los énfasis cambian. Las cinco industrias canónicas del pack tienen patrones distintos de fuentes disponibles, tensiones probables y velocidad típica del piloto. Ver detalle pleno en playbooks-5-industrias.html.
Industria 01
Servicios B2B
Fuentes
Ventas (contratos), clientes, facturación, horas / proyectos.
Tensiones
TNS-001TNS-002TNS-009TNS-010
Reto
Margen real por proyecto suele estar disperso entre ERP + planilla horas + facturación.
Duración típica
45-60 días (mucho relevamiento de datos no estructurados).
Industria 02
Manufactura
Fuentes
Producción, stock multi-depósito, compras, costos por orden.
Tensiones
TNS-006TNS-007TNS-008TNS-022
Reto
Costo unitario suele requerir ABC interno; reposición depende de SKU críticos.
Duración típica
45-60 días (datos densos + validación industrial).
Industria 03
Retail / distribución
Fuentes
Ventas POS, stock por sucursal, productos, descuentos, vendedores.
Tensiones
TNS-001TNS-002TNS-003TNS-006TNS-013
Reto
Volumen alto de transacciones + necesidad de cortar por sucursal y por vendedor.
Duración típica
30-45 días (datos limpios pero volumétricos).
Industria 04
Construcción / materiales
Fuentes
Obras / proyectos, compras de obra, stock, cobranza por avance.
Tensiones
TNS-002TNS-004TNS-018TNS-022TNS-024
Reto
Ciclo largo de obra + cobranza por certificación dificultan correlaciones temporales.
Duración típica
45-60 días (necesidad de histórico de 6+ meses para sentido).
Industria 05
Agroindustria / insumos
Fuentes
Ventas estacionales, stock multi-depósito, financiación a productor, compras a fábrica.
Tensiones
TNS-001TNS-004TNS-005TNS-006TNS-016
Reto
Estacionalidad pronunciada + crédito a productor con riesgo concentrado.
Duración típica
45-60 días (validar lectura fuera de temporada peak).
Empresa Demo Cuyo S.A. corresponde al perfil Agroindustria / insumos con presencia retail multi-sucursal, lo que explica la combinación de tensiones TNS-001 (crecimiento no rentable estacional), TNS-004 (venta sin caja por financiación a productor) y TNS-006 (stock crítico en SKU rotativo de campaña).
15 · Entregables finales · cierre · expansión
Qué se entrega al cliente y qué define la expansión post-piloto
El piloto cierra con un paquete documental y técnico unificado. Sin ese paquete, el piloto no se cierra: se diluye. Y sin opciones de expansión claras, el cliente no decide en la ventana caliente posterior al reporte final.
Entregables documentales obligatorios
FARO-DOC-001-R
Minuta Workshop Discovery
Decisiones, dolores, KPIs candidatos y red flags firmados por sponsor.
FARO-PL-016
Inventario Fuentes
Fuentes relevadas con clasificación A/B/C/D y responsable por fuente.
FARO-MAP-001
Mapa fuente → campo → tabla
Mapeo completo para reproducibilidad de la carga.
FARO-DQ-001
Diagnóstico calidad datos
Resumen por fuente: ok / warning / error / fatal por regla.
FARO-RACI-MVP
Responsables y permisos
RACI definitiva por proceso operativo.
FARO-REP-001
Reporte semanal piloto
Reporte ejecutivo entregado en el ciclo del piloto.
FARO-CLOSE-001
Informe cierre piloto
Resultados vs criterios de éxito + decisión de continuidad.
Entregables técnicos obligatorios
FARO-SQL-001
Migraciones base
DDL completo para el modelo entidades MVP.
FARO-SQL-002
Multiempresa, roles, RLS
Políticas de aislamiento por company_id.
FARO-SQL-003
Seeds empresa piloto / demo
Carga inicial reproducible para el cliente piloto.
FARO-CFG-001
Reglas MVP YAML
Reglas declarativas versionadas (no hardcodeadas).
FARO-ENG-001
Scaffold conectores
Base para conectores A/B/C de cada fuente.
FARO-ENG-003
Motor evaluador
Motor que enriquece tensiones con metadatos del catálogo canónico.
FARO-TEST-001/2
Tests KPI + reglas
Tests reproducibles sobre dataset demo + datos cliente.
FARO-DEMO-001
Dataset demo integral
Conjunto reproducible para validar regresiones futuras.
Criterios de aceptación ejecutiva
El piloto se considera exitoso ejecutivamente si la dirección puede responder, sin abrir un Excel, las 10 preguntas siguientes:
10 preguntas que la dirección debe poder responder test final
¿Qué está pasando?
¿Por qué importa?
¿Dónde está ocurriendo?
¿Quién debe actuar?
¿Qué acción se recomienda?
¿Cuándo debe cerrarse?
¿Qué evidencia se necesita?
¿Cómo impacta en el Score?
¿Qué debe decidir esta semana?
¿Qué cambió respecto a la semana anterior?
Opciones de expansión post-piloto
Cuando la decisión de Fase 11 es continuar a fase paga, las opciones de expansión se ordenan en cuatro capas. El cliente puede combinar capas, pero no debería brincar capa: cada una asume la anterior estabilizada.
Exp 01 · Cobertura
Más sucursales / áreas
Ampliar el alcance organizativo: pasar de 1-3 sucursales piloto a las 5+ activas, sumar áreas no incluidas en MVP (RRHH, mantenimiento, logística).
Exp 02 · Integración
API ERP / bancos / e-commerce
Reemplazar fuentes B (export manual estable) por fuentes A (API / DB automatizada). Reduce dependencia de personas y frecuencia de errores.
Exp 03 · Profundidad
Más KPIs, tensiones y workflow
Sumar KPIs de capas P2/P3 de las bibliotecas extendidas, ampliar el catálogo de tensiones activas y profundizar workflow (escalamiento por SLA, aprobadores múltiples).
Exp 04 · Inteligencia
IA explicativa + simulación
Una vez datos confiables y reglas estables, activar IA explicativa controlada y simulación de escenarios. Nunca antes: la IA sobre datos crudos genera humo.
16 · Cross-references
Cómo este runbook se cruza con el resto del pack
El runbook no vive solo. Estos son los puntos donde consume, alimenta o se valida contra otros documentos del pack NDA.
Runbook operativo aprobado · listo para correr un piloto sin improvisar
Este documento es la cadena dura del piloto FARO Connect. Pasá al hub para ver el resto del pack, al pipeline interactivo para la vista visual o al catálogo de tensiones MVP para ver qué se mide en cada fase.
→ Volver al hub modelos NDA