Modelos FARO · Hub NDA

FARO Connect es una capa operativa de dirección ejecutiva (no un dashboard). Convierte datos de la empresa en tensiones detectables, acciones con responsable, evidencia y score. Estos 49 modelos definen cómo lo hace.

Qué hay acá. Este hub agrupa los 49 modelos que definen FARO Connect bajo confidencialidad. No es documentación pública: es el sistema operativo del producto. Está organizado por la cadena de valor real: dato → medición → detección → acción → evidencia → score. La v2.0 suma 24 piezas MVP canónicas que cubren motor, UI, score, IA controlada, gobierno, observabilidad, QA, deploy y documentación operativa.

Cómo usar este hub. Para un primer recorrido empezá por Modelo de Diagnóstico (el más conceptual) y seguí por Contrato de Datos MVP (qué necesita entrar). Para una revisión técnica, saltá directo a Modelo SQL, Catálogos MVP y Motor Evaluador. Para validar profundidad metodológica, abrí KPIs / Tensiones / Acciones — las tres están cruzadas con códigos canónicos sin huérfanos. Para ver el producto vivo, abrí las 5 piezas de UI MVP + Demo Ejecutable.

🔒 Recordatorio NDA

Estos modelos son IP central de FARO Dirección. Tomás Pombo los comparte para validación técnica con inversores, socios tecnológicos y empresas en pilotos estratégicos. NO se redistribuyen, NO se copian, NO se publican. Cualquier uso requiere autorización escrita (tomas@farodireccion.com).

📊 Cómo se conectan los modelos · vista de 1 minuto (capa estructural)

Los 25 modelos estructurales trabajan en 5 capas. Cada nodo se conecta con código canónico cruzado sin huérfanos. La capa MVP v2.0 (24 piezas) suma motor evaluador, UI, score, IA, gobierno, ops, QA y deploy sobre esta estructura. Los 29 activos detallados profundizan cada paso del pipeline.

Capa estructural · 25 modelos canónicos

Los modelos base del sistema: diagnóstico, contrato de datos, bibliotecas KPI/TNS/ACT, procesos por industria, SQL, diccionarios, RACI, decisiones, taxonomía, calidad, frecuencias, roadmap, plantillas, reportes, cruces, playbooks, cierre piloto, pipeline interactivo, estado de implementación y pack build. Más abajo, la nueva capa MVP v2.0 con motor, UI, IA, gobierno, ops y deploy.

01 Listo

Modelo de Diagnóstico Empresarial

Cómo FARO mide el estado de una empresa. 8 dimensiones, 64 preguntas, 16 dolores, 5 niveles de madurez. Score 0-100 con interpretación ejecutiva por banda.

Contrato de Datos MVP

Qué tiene que entrar a FARO Connect para que el sistema arranque. 3 dominios (ventas, stock, cobranza), columnas obligatorias y opcionales, alias, validaciones, dataset demo que dispara TNS-001.

400 KPIs canónicos con fórmula, fuente de datos, umbrales verde/ámbar/rojo, polaridad, responsable y dimensión Score. 60 marcados como MVP day-one.

Biblioteca de Tensiones

300 tensiones detectables por datos. Cada una con lógica de diagnóstico en pseudocódigo, KPIs reales que la disparan, umbrales ámbar/rojo, severidad y peso Score.

Biblioteca de Acciones Ejecutivas

300 acciones canónicas, mapeo 1:1 con tensiones. RACI completo, SLA, workflow 5 etapas, criterio de cierre, evidencia tipificada, impacto Score esperado.

Procesos por Industria

15 industrias × ~100-150 procesos cada una (~1.550 procesos canónicos). Comercio, Construcción, Industria, Servicios Profesionales, Salud, Agro, Logística, Hotelería, Real Estate, Energía, Educación, Finanzas, Tecnología, Gobierno, Holdings.

EXPLORAR INDUSTRIAS →

07 v1.0

Modelo SQL MVP · v2.0 UPDATE

Esquema PostgreSQL completo. 12 capas: CORE, INGESTA/RAW, STAGING, MAESTROS, FACTS, KPIs, ALERTAS, TENSIONES, ACCIONES, EVIDENCIA, FARO SCORE, AI AUDIT. Multiempresa desde día 1. v2.0: timeline migraciones V001-V031 + integra RLS (V014-V023) + parche V027.

Diccionario de Datos · 528 campos

El universo canónico de campos FARO. 44 módulos desde Empresa hasta Tensiones. El Contrato MVP es un subset de ~50 marcados con flag mvp_subset.

EXPLORAR DICCIONARIO →

09 v3.0

Matriz RACI · 105 roles

Catálogo maestro de responsabilidades funcionales. 75 transversales + 25 verticales + 5 extensiones. Activables por empresa, sucursal, área, rubro.

Matriz de Decisiones · 345

345 decisiones ejecutivas tipificadas en 16 áreas. Cada una con impacto, frecuencia, nivel jerárquico, datos necesarios y KPIs implícitos cruzados.

EXPLORAR DECISIONES →

11 v1.0

Backlog MVP

Alcance operativo del MVP: qué entra, qué queda afuera, ciclo end-to-end (carga → Score), criterios de aceptación. La guía pragmática del primer release.

24 áreas + 42 módulos funcionales + 16 centros de costo. La estructura oficial para clasificar datos por empresa, industria, rubro, área y módulo.

Calidad de Datos · 3 sistemas

60 reglas de limpieza (CLN) + 120 reglas de calidad (DQ) + 4 estados Score Calidad con fórmula ponderada. El filtro entre dato crudo y dato confiable.

Frecuencias de Importación

10 ritmos canónicos FRE-01..10 desde tiempo real hasta manual controlada. Reglas por fuente (ERP, CRM, POS, bancos, Excel, APIs).

Frecuencias

Fuentes

Niveles

EXPLORAR FRECUENCIAS →

15 v1.0

Roadmap + Arquitectura Multiindustria

Cómo FARO escala de MVP focalizado a plataforma multiindustria. Biblioteca modular amplia + activación reducida + extensiones por rubro sin re-arquitectura.

15 Plantillas Oficiales MVP

15 plantillas Excel oficiales: Empresas, Productos, Clientes, Empleados, Proveedores, Ventas, Stock, CXC, Compras, Gastos, Bancos, Acciones, Evidencias, Objetivos + Dataset Demo.

10 Reportes Ejecutivos canónicos · v2.0 UPDATE

Reportes oficiales del MVP: diario AM/PM, semanal, mensual integral, FARO Score, tensiones activas, evidencias, calidad datos, scoreboard sucursales, drill-down causa-impacto. v2.0: cross-link a reporte-semanal-mvp-spec (TPL-002, spec técnica IA + slots).

DDL SQL ejecutable · descarga directa

FARO-Connect-MVP-completo.sql · Schema PostgreSQL listo para correr: 25 tablas core + extensiones + 21 funciones faro.fn_* + orquestador. psql -d faro_mvp -f este_archivo.sql

Matriz de cruces canónica

~1.500 cruces KPI × Tensión × Acción × Evidencia con filtros por área y severidad. Garantías de integridad cruzada cargadas desde los JSON canónicos.

Playbooks · 5 industrias piloto

Cómo se aplica el MVP a Construcción, Retail, Salud, Agro y Logística. KPIs y tensiones esperables por vertical con caso piloto narrativo.

Diccionario de términos FARO

~150 términos canónicos, técnicos, operativos, ejecutivos y de IA con definición y alias. Idioma compartido para inversores, CTOs y equipos de cliente.

EXPLORAR DICCIONARIO →

22 Operativo

Cierre piloto + Plan de comunicación

Checklist 25 ítems (calidad / tensiones / workflow / reportes / adopción) + plan 7 pasos de comunicación interna → cliente. Anti-patrones explícitos.

25 🟢 NUEVO · CAPA EJECUTABLE

Pack Build · 10 entregables construidos

Los activos técnicos que pasaron de 📄 documentado a ⚙ codificado: FARO-DOC-001/002 (workshop + runbook), FARO-SQL-001/002/003 (migrations + RLS + seeds), FARO-CFG-001 (reglas YAML), FARO-ENG-002/003 (parser + motor), FARO-TEST-002 (tests), FARO-PL-016 (inventario fuentes xlsx+csv). Capa real del sistema.

24 📊 NUEVO · TRANSPARENCIA

Estado de Implementación · pack vs build · v2.0 UPDATE

Vista única honesta del estado real de cada activo: 📄 Documentado · 🛠 Prototipado · ⚙ Codificado · 🚀 Productivo. Para planificación interna, conversación honesta con CTO/socio técnico, no inflar al inversor. ~145 activos clasificados con prioridad P1/P2/P3 y qué falta para subir de estado. v2.0: matriz extendida con SQL-003 + V027 patch.

23 ⭐ NUEVO · INTERACTIVO

Pipeline interactivo · 25 etapas explicadas

Esquema visual end-to-end con drawer técnico por etapa: qué es, cómo se implementa, herramientas concretas, inputs/outputs y links cruzados. Navegación encadenada (← anterior · siguiente →) + tooltips hover sobre términos. Pieza diseñada para socio técnico / CTO. Cubre las 9 capas: ingesta → calidad → estructura → medición → detección → inteligencia → ejecución → resultado → aprendizaje.

Índice 29 Activos Canónicos del pipeline

Documentación completa de cada activo individual de las etapas pendientes de la tabla maestra. Combinado con los 25 modelos estructurales = cobertura 100% (46/46 etapas). Cada activo con cruces hacia los modelos relacionados.

⭐ NUEVO · v2.0 · 24 PIEZAS

MVP Canónico · Operación · Gobierno · IA

La capa que convierte el sistema documental en sistema operativo real: catálogos canónicos, motor evaluador, UI funcional, score, IA controlada, gobierno, observabilidad, QA, deploy y documentación de implementación. Cada pieza con código de origen (CAT, ENG, UI, SCORE, TPL, AI, GOV, OPS, QA, TEST, DEPLOY, DEMO, DOC) trazable contra la matriz de estado.

Piezas v2.0

Bloques

Fases dev

73 TNS+ACT+EVD

Catálogo MVP

Reglas YAML

UI MVP

Fase 1 · Fundamento SQL + Catálogos canónicos

Catálogos canónicos MVP

5 piezas · CAT-001/002/003 + SEC-001 + CFG-001

CAT-001

Catálogo Tensiones MVP

30 TNS canónicos MVP con DSL evaluable, severidad, peso Score y trazabilidad a KPIs origen.

VER CATÁLOGO →

CAT-002

Catálogo Acciones MVP

31 ACT canónicos MVP organizados en 7 familias, con RACI, SLA y criterio de cierre.

VER CATÁLOGO →

CAT-003

Catálogo Evidencias MVP

12 EVD canónicos tipificados: acta, decisión, soporte documental, validación de cierre.

VER CATÁLOGO →

SEC-001

Seguridad + RLS MVP

13 roles, políticas RLS Postgres, migraciones V014-V023, separación multiempresa hard.

VER SEGURIDAD →

CFG-001

Reglas MVP · YAML

11 reglas YAML canónicas + DSL parser TS. Configuración versionada, no código de producto.

VER REGLAS →

Fase 2 · UI + Workflow + Score + Templates

Motor + Workflow

3 piezas · ENG-002/003 + WF-001

ENG-002

Parser YAML técnico

DSL parser TypeScript: lectura, validación de tipos, expansión de operadores, errores estructurados.

VER PARSER →

ENG-003

Motor Evaluador MVP

Consolida ENG-003 + ENG-003.1. Ejecuta reglas DSL sobre KPIs, dispara TNS y abre ACT con responsable.

VER MOTOR →

WF-001

Workflow + Escalamiento MVP

Estados oficiales 10+12+5, escalamiento L0-L5 con SLA, automatización de re-asignación y cierre.

VER WORKFLOW →

UI MVP · 5 pantallas operativas

5 piezas · UI-001..005

UI-001

Bandeja de Tensiones

Primera pantalla MVP. Cola priorizada de TNS abiertas con filtros por área, severidad y responsable.

VER UI →

UI-002

Dashboard del Responsable

Vista diaria por responsable: mis acciones, SLA en riesgo, KPIs bajo mi tutela, evidencias pendientes.

VER UI →

UI-003

Workflow de Acción

Tabla única execution_events con 40 eventos canónicos. Pantalla de detalle ACT con bitácora completa.

VER UI →

UI-004

Carga de Evidencia

UI de carga + validación contra catálogo EVD. Tipos permitidos, campos requeridos, vista previa.

VER UI →

UI-005

Timeline + Auditoría

3 niveles de timeline: empresa, tensión, acción. Auditoría inmutable lectura desde execution_events.

VER UI →

Score + Templates

3 piezas · SCORE-001 + TPL-001/002

SCORE-001

Motor Score MVP

5 dimensiones, fórmula transparente, ejemplo Score 74 → 66 con drill-down a TNS contribuyentes.

VER MOTOR SCORE →

TPL-001

Alertas + Notificaciones

Templates IA con slots tipados. Canales: email + in-app. Anti-spam y agrupación por contexto.

VER TEMPLATES →

TPL-002

Reporte Semanal · spec MVP

Spec técnica del reporte ejecutivo semanal: estructura, slots IA, fuentes de datos, ejemplo render.

VER SPEC →

Fase 3 · IA + Gobierno + Ops + QA + Deploy + Docs

IA controlada

1 pieza · AI-001

AI-001

AI Gateway MVP

Gateway IA con 8 casos de uso oficiales, 6 tablas SQL de control, audit central, fallback determinístico.

VER GATEWAY →

Gobierno + Seguridad

1 pieza · GOV-001

GOV-001

Gobierno + Seguridad MVP

12 roles operativos, 28 permisos granulares, tabla audit central, separación de funciones, retención.

VER GOBIERNO →

Observabilidad + Ops

1 pieza · OPS-001

OPS-001

Observabilidad + Ops MVP

13 jobs orquestados, schema ops con 8 tablas, 5 runbooks operativos, métricas, alertas, SLO.

VER OPS →

QA + Testing

2 piezas · QA-001 + TEST-002

QA-001

Estrategia QA MVP

12 capas de testing, 13 quality gates antes de release, cobertura mínima y criterios de aceptación.

VER QA →

TEST-002

Tests canónicos

Consolida TEST-002 + TEST-002.1. Suite de tests sobre catálogos, motor, workflow y score.

VER TESTS →

Deploy + Demo

2 piezas · DEPLOY-001 + DEMO-001

DEPLOY-001

Deploy + Ambientes MVP

5 ambientes (dev/test/stg/preprod/prod), GitHub Actions, rollback, migrations gateadas, secrets management.

VER DEPLOY →

DEMO-001

Demo Ejecutable MVP

Empresa Demo Cuyo con 4 storyboards reproducibles end-to-end. Dataset cargado, reglas activas, score real.

VER DEMO →

B10

Documentación operativa

2 piezas · DOC-001 + DOC-002

DOC-001

Workshop Discovery MVP

Agenda + 8 bloques del workshop de descubrimiento previo al piloto. Outputs claros y plantillas anexas.

VER WORKSHOP →

DOC-002

Runbook Implementación Piloto

11 fases del piloto end-to-end con checklist por fase, responsables, criterios de salida y riesgos.

VER RUNBOOK →

Cadena canónica del sistema

Así se conectan los 25 modelos estructurales. Cada eslabón cita el anterior por código (sin huérfanos cruzados validados). La capa MVP v2.0 se monta sobre esta estructura.

Procesos IND

PRC-INDxx-xxx

Contrato Datos

3 dominios

Modelo SQL

12 capas

KPIs

KPI-001..400

Tensiones

TNS-001..300

Acciones

ACT-001..300

Evidencia

EVD-001..012

FARO Score

DIM-01..10

Diccionario

528 campos

RACI

ROL-001..105

Decisiones

DEC-AAA-NNN

Taxonomía

ARE+MOD

Calidad

CLN+DQ+Score

Frecuencias

FRE-01..10

Convención de codificación canónica

Todos los activos usan códigos sin áreas embebidas. El área queda como metadata. Permite reasignar entre dominios sin renumerar y mantiene namespace simple para citación cruzada.

Activo	Patrón	Rango	Ejemplo
KPI	`KPI-NNN`	001..400	`KPI-001` Ventas netas
Tensión	`TNS-NNN`	001..300	`TNS-001` Crecimiento no rentable
Acción	`ACT-NNN`	001..300	`ACT-001` Recuperar resultado
Evidencia	`EVD-NNN`	001..012	`EVD-001` Acta + decisión
Dimensión Score	`DIM-XX`	01..10	`DIM-05` Ejecución
Proceso	`PRC-INDxx-FAM-NNN`	15 industrias	`PRC-IND01-DIR-001` Definición objetivos comerciales
Campo dato	`XXX-NNN`	528 (44 prefijos)	`CLI-001` customer_id, `STO-007` quantity_available
Rol RACI	`ROL-NNN`	001..105	`ROL-026` Gerente Comercial, `ROL-061` Responsable de Logística
Decisión	`DEC-AREA-NNN`	345 (16 áreas)	`DEC-DIR-001` Definir prioridades ejecutivas
Área canónica	`ARE-XXX`	24 áreas	`ARE-COM` Comercial, `ARE-FIN` Finanzas
Módulo funcional	`MOD-XXX`	42 módulos	`MOD-DIR` Dirección General, `MOD-SCORE` FARO Score
Regla limpieza	`CLN-NNN`	60 reglas	`CLN-001` Fechas formato ISO YYYY-MM-DD
Regla calidad	`DQ-NNN`	120 reglas	`DQ-001` Todo registro debe tener company_id
Frecuencia	`FRE-NN`	10 frecuencias	`FRE-01` Tiempo real, `FRE-08` Mensual