FARO · Connect

Arquitectura técnica
FARO Connect

Documentación de la arquitectura técnica de la plataforma.

Mayo 2026 · v1.0 · Confidencial
Tesis

FARO Connect convierte datos dispersos en decisiones trazables.

Es una arquitectura de dirección, no un dashboard. Tres capas que ninguna BI tradicional resuelve junta:

01

Motor de tensiones

Detecta contradicciones entre áreas. Ventas sube, margen baja: el sistema lo lee como una sola cosa.

02

Activos propios

11 activos propios: diccionario, taxonomía, KPIs, reglas, tensiones, alertas, acciones, playbooks, relaciones causa-impacto, score+memoria, recalibración.

03

Workflow de ejecución

Acción + responsable + vencimiento + KPI afectado + escalamiento automático.

Diferencial conceptual

Una tensión no es un dato malo. Es una contradicción entre áreas.

Esto es lo que diferencia a FARO de cualquier BI. Detecta el problema antes que el síntoma.

Ejemplo
ComercialVentas ↑ 18% (mes vs mes)
FinanzasMargen ↓ 4.1 pts
ComercialDescuento promedio ↑ 12%
FinanzasDías de cobranza ↑ 23%
Tensión detectada
Crecimiento comercial no rentable
Severidad: 87/100 Áreas: Comercial × Finanzas

Una BI muestra los 4 indicadores. FARO muestra la tensión.

Activos propios

FARO Connect no es IA improvisando. Son 11 activos propios.

Cada predicción se apoya en activos versionables, auditables y testeables. La IA es un componente, no el sistema.

Diccionario de datos

250-400
campos por módulo

Taxonomía FARO

10-12
áreas · 200-400 subrubros

Biblioteca de KPIs

300-400
esc. 1.000+

Biblioteca de reglas (DSL)

300-800
esc. 2.000+ · DSL JSON

Motor de tensiones

300-500
esc. 2.000+ patrones

Biblioteca de alertas

300-800
parametrizables

Biblioteca de acciones

300-1.000
vinculadas a tensiones

Playbooks (Action Guide)

100-300
esc. 500+

Relaciones causa-impacto

300-800
grafo dirigido

FARO Score + memoria

100%
cobertura ejecutiva

Motor de recalibración

aprende del uso

+ extensible

por industria
cada cliente hereda y extiende
Arquitectura

10 fases. Cada una con dueño, fórmula, validador y output medible.

Pipeline determinístico ETL → reglas → tensiones → tareas. Cada fase es una capa con interfaces claras.

Diagnóstico
7
Fase 0
Antes del software. Mapa de procesos, decisiones, RACI, tensiones y datos.
Datos
9
Fases 1·2·3
Captura, resguardo (RAW), validación, calidad, staging, normalización, clasificación, enriquecimiento.
Estructura
4
Fase 4
Tablas maestras, modelo ejecutivo, modelo por industria, relaciones causa-impacto.
Inteligencia
13
Fases 5·6·7
KPIs, umbrales, señales, reglas, alertas, tensiones, diagnóstico, prioridad, recomendación, simulación, playbook.
Ejecución + Mejora
12
Fases 8·9·10
Acción, responsable, workflow, escalamiento, seguimiento, score, aprendizaje, recalibración.
Alcance

FARO Connect no es para cualquier empresa.

Definir el ICP de implementación protege la calidad del modelo y la viabilidad técnica del partner.

Cuándo aplica
  • Empresa con 3+ áreas operativas activas
  • Datos existentes en ≥ 1 sistema (ERP, Excel, CRM)
  • Dirección dispuesta a ejecutar acciones sugeridas
  • Sucursales o áreas con criterios mixtos (tensiones reales)
  • Sponsor ejecutivo con poder de decisión
Cuándo NO aplica
  • Pyme menor a 10 empleados
  • Solo necesita un dashboard de KPIs
  • Sin ERP ni datos operativos digitales
  • Cultura de "que el sistema decida solo"
  • Empresa con BI maduro que solo quiere otro tablero
  • Sin sponsor con poder de implementar cambios

FARO no reemplaza dirección. La estructura.

Zoom · Datos

Sin trazabilidad no hay dirección confiable.

Pipeline determinístico: fuente → RAW → validación → calidad. Cada dato tiene origen rastreable hasta el archivo y el usuario.

Fuente
ERP · Excel · POS · CRM · API
RAW
PostgreSQL JSONB
Validación
50-120 reglas
Calidad
4 estados
Clean
Staging · normalizado
Fórmula ejemplo · Fase 1 · Control de origen
origen = source_id + file_name + uploaded_by + timestamp + lote + estado

INSERT INTO raw_imports(raw_payload, metadata)
VALUES (:json_original, :metadata);
Zoom · Inteligencia

La inteligencia está en la composición, no en la IA.

KPIs miden. Reglas evalúan. Alertas avisan. Tensiones cruzan. Cada capa tiene fórmula y umbral configurable.

KPIs
margen = (ventas_netas - costo) / ventas_netas
Reglas
if margen < .22 and descuento > .10: alerta = True
Alertas
severidad = impacto * urgencia * confianza
Tensiones
ventas↑ + margen↓ + cobranza↓ = tensión comercial-financiera

Cada capa es testeable y versionable.

Zoom · Decisión

80 problemas no son 80 decisiones. Son 5 prioridades y 75 ruido.

La fórmula de priorización es transparente, configurable y auditable. Cada decisión tiene justificación numérica.

Fórmula de priorización
prioridad = impacto    * 0.35
          + urgencia    * 0.25
          + riesgo      * 0.20
          + recurrencia * 0.10
          + confianza   * 0.10
#01
Crecimiento comercial no rentable
Sev 87
Crítica
#02
Stock saturado en Sucursal San Juan
Sev 74
Alta
#03
Comisión por descuento extra-norma
Sev 68
Alta
#04
Cobranza > 60 días Cliente Top 5
Sev 62
Media
#05
RRHH: rotación área Logística +18%
Sev 58
Media
+ 75 incidencias menores agrupadas por área
Zoom · Ejecución

Una recomendación sin responsable es literatura.

Cada decisión genera una acción con dueño, fecha, KPI afectado y workflow. Si vence o se bloquea, escala automáticamente.

Anatomía de una acción FARO
Tensión
Crecimiento comercial no rentable
Acción
Auditar descuentos > 10% últimos 30 días
Responsable
Gerente Comercial
Aprobador
Dirección
Vencimiento
2026-06-02 (7 días)
KPI afectado
margen_bruto
Estado
pendiente
Workflow
pendiente tomada en_proceso cerrada
Escalamiento
Si vencida + crítica → Dirección General

Aquí termina BI y empieza dirección.

Síntesis ejecutiva

Un solo número que el director recuerda. Auditable hasta la fila de cada KPI.

FARO Score combina KPIs + tensiones + alertas + ejecución + riesgo + confianza de datos. Por área, sucursal, módulo, responsable o industria.

74
FARO Score
Distribuidora cemento · Sucursal San Juan
Mayo 2026
Estado:Amarillo
Mes anterior:71
Tendencia:↑ +3 pts
Descomposición
KPIs cumplidos
82/100
+2 vs ant
Tensiones resueltas
71/100
-4 vs ant
Acciones en fecha
68/100
+8 vs ant
Confianza de datos
85/100
sin cambio
Riesgo proyectado
62/100
-5 vs ant

score = 100 - penalizaciones + bonificaciones

Decisión de arquitectura

Lo que es FARO. Lo que es estándar. Lo que decide el partner.

Activos propios (de FARO). Stack estándar (build-friendly). Decisiones abiertas para el equipo de implementación.

Activo FARO · build
  • Biblioteca de KPIs
  • Motor de tensiones
  • Biblioteca de reglas (DSL)
  • Biblioteca de acciones
  • Biblioteca de tensiones
  • FARO Score
  • Memoria de decisiones
  • Motor de recalibración
  • Playbooks
  • Diccionario de datos
  • Taxonomía por industria
Stack estándar · buy / open
  • PostgreSQL + JSONB
  • dbt para modelado
  • Airbyte o n8n (ingesta)
  • Great Expectations · dbt tests
  • FastAPI o Django REST
  • Celery + Redis (jobs)
  • Cube o Metabase (BI capa)
  • OpenAI API + RAG (recomendaciones)
  • Lucide (iconografía)
  • Sentry (observabilidad)
Decide partner
  • Workflow engine: Temporal · Camunda · propio
  • Hosting: Supabase · RDS · propio
  • Frontend: Next.js · Remix · SvelteKit
  • Modelo multi-tenancy: schema-per-tenant · row-level security
  • Auth: Clerk · Auth0 · propio
  • CDN / edge compute
  • CI/CD pipeline
  • Modelo de despliegue (SaaS · on-prem · híbrido)

La propiedad intelectual es de FARO. La infraestructura es estándar.

Próximos pasos

Cuatro semanas para validar viabilidad. Después decidimos build.

Workshop técnico → ERD + contratos → POC con caso real → decisión informada.

Semana 1

Workshop técnico (8h)

Revisar los 50 anexos críticos. Identificar bloqueantes. Acordar scope del POC.

Semana 2

ERD + contrato de datos

Definir política de unidades. Resolver inconsistencias del modelo. Mapear fuentes reales del caso.

Semana 3

POC con caso real

Fase 0 + 1 implementadas con datos reales del cliente piloto. Validar end-to-end. (En presentación se muestra prototipo · Empresa Demo)

Semana 4

Decisión build vs no build

Si build: contrato + roadmap + equipo. Si no: aprendizaje + ajuste del modelo conceptual.

Programar workshop técnico
calendly.com/farodireccion/workshop-tecnico

NDA recomendado antes de compartir anexos completos.

TABLA MAESTRA · GUÍA DE LECTURA

Cómo leer la tabla maestra.

15 columnas por etapa. Cada celda es una decisión técnica documentada. No es Excel: es la espina dorsal del sistema.

Identificación
Fase
0 a 10. Macrobloque al que pertenece.
Etapa
Nombre canónico del paso.
Objetivo ejecutivo
Para qué sirve a nivel dirección.
Áreas
Qué áreas interactúan con la etapa.
Operación
Qué entra
Input principal de la etapa.
Qué hace FARO
Acción concreta que ejecuta el sistema.
Información FARO
Activo propio (biblioteca/motor/taxonomía).
Volumen estimado
Magnitud del activo (iniciales · escalable).
Implementación
Fórmula
Pseudocódigo / DSL / SQL ejemplo.
Herramientas
Stack técnico sugerido.
Quién valida
Rol responsable de aprobar.
Nivel
Base · Pro · Enterprise · Neural.
Resultado
Riesgo si no existe
Consecuencia operativa de omitir.
Qué sale
Output medible, input del siguiente.
Anexo
Documento técnico vinculado (1 a 38).
Markers
Activo propio · NDA · Bloqueante · Pendiente.
TABLA MAESTRA · VISTA DE BOSQUE

46 etapas. 10 fases. 6 macrobloques. Un solo sistema.

Cada celda es una etapa real, documentada con 15 columnas. Las que tienen acento corresponden a activos propios de FARO.

Diagnóstico (7)
0.1Diagnóstico inicial
0.2Mapa de procesos
0.3Mapa de decisiones
0.4RACI inicial
0.5Tensiones iniciales
0.6Auditoría de datos
0.7Alcance inicial
Datos (11)
1.1Fuentes de datos
1.2Mapa de datos disp.
1.3Ingesta de datos
1.4Control de origen
2.1RAW
2.2Validación inicial
2.3Semáforo calidad
3.1Staging
3.2Normalización
3.3Clasificación FARO
3.4Enriquecimiento
Estructura (4)
4.1Tablas maestras
4.2Modelo ejecutivo
4.3Modelo por industria
4.4Relaciones
Inteligencia (13)
5.1Biblioteca KPIs
5.2Cálculo KPIs
5.3Objetivos · umbrales
5.4Señales FARO
6.1Reglas de negocio
6.2Alertas FARO
6.3Biblioteca tensiones
6.4Diagnóstico ejec.
6.5Confianza diagn.
7.1Prioridad ejecutiva
7.2Recomendaciones
7.3Simulación esc.
7.4Action Guide
Ejecución (8)
8.1Acciones FARO
8.2Responsable+venc.
8.3Workflow
8.4Escalamiento
9.1Seguimiento
9.2Medición posterior
9.3Cierre ejecutivo
9.4FARO Score
Mejora (3)
10.1Aprendizaje
10.2Recalibración
10.3Mejora externa
ZOOM · MACROBLOQUE 1 · DIAGNÓSTICO PREVIO

FARO empieza antes de conectar datos. Primero entiende la empresa.

7 etapas de diagnóstico previo. Sin esto, cualquier implementación técnica corre hacia el lugar equivocado.

FASE 0.1
Diagnóstico inicial
5-8 dimensiones · 40-80 preguntas
Sistema lindo, inútil.
FASE 0.2
Mapa de procesos
80-150 procesos por industria
Automatiza el desorden.
FASE 0.3
Mapa de decisiones
100-200 decisiones
Mucho dato, poca dirección.
FASE 0.4
RACI inicial
10-20 roles base
"Todos sabían" no es gestión.
FASE 0.5
Tensiones iniciales
300-500 · esc. 1.000+
Alertas genéricas, no problemas reales.
FASE 0.6
Auditoría de datos
250-400 campos base
KPIs imposibles. Papelón.
FASE 0.7
Alcance inicial
3-5 módulos iniciales
Demora, costo, cero adopción.
ZOOM · MACROBLOQUE 2 · DATOS

Pipeline determinístico: fuente → RAW → validación → calidad → limpieza → enriquecimiento.

11 etapas que sostienen la trazabilidad técnica. Cada dato tiene origen rastreable hasta el archivo y usuario.

FASE 1.1
Fuentes de datos
20-40 tipos
Carga manual eterna.
FASE 1.2
Mapa datos disp.
250-400 campos
Indicadores incompletos.
FASE 1.3
Ingesta de datos
5 frecuencias base
Retrovisor roto.
FASE 1.4
Control de origen
8-12 metadatos
Silencio incómodo.
FASE 2.1
RAW
100% preservado
No reconstruir error.
FASE 2.2
Validación inicial
50-120 reglas
Basura procesada.
FASE 2.3
Semáforo calidad
4 estados
Jugar a la ruleta.
FASE 3.1
Staging
30-80 reglas
No se pueden cruzar datos.
FASE 3.2
Normalización
Diccionario vivo
KPI torcido.
FASE 3.3
Clasificación FARO
10-12 áreas · 200-400 sub.
Se dirige mal.
FASE 3.4
Enriquecimiento
50-150 atributos
Número correcto, mala decisión.
ZOOM · MACROBLOQUES 3 + 4 · ESTRUCTURA + INTELIGENCIA

17 etapas que componen el corazón del sistema.

Tablas maestras, modelo ejecutivo, KPIs, reglas, tensiones, diagnóstico y decisión. La propiedad intelectual de FARO vive en este bloque.

FASE 4.1
Tablas maestras
8-12 tablas
Caos. Cada área su versión.
FASE 4.2
Modelo ejecutivo
10-12 módulos
Base técnica sin sistema.
FASE 4.3
Modelo por industria
12-20 industrias
Misma lectura, negocios distintos.
FASE 4.4
Relaciones causa-impacto
300-800 relaciones
Indicadores aislados.
FASE 5.1
Biblioteca KPIs
300-400 · esc. 1.000+
Dashboard decoración.
FASE 5.2
Cálculo KPIs
300-400 fórmulas
No auditables.
FASE 5.3
Objetivos · umbrales
Rangos por KPI
Se opina, no se dirige.
FASE 5.4
Señales FARO
80-150 señales
Detecta tarde.
FASE 6.1
Reglas de negocio
300-800 · DSL · esc. 2.000+
Opinión, no sistema.
FASE 6.2
Alertas FARO
300-800 parametriz.
Nadie se entera a tiempo.
FASE 6.3
Biblioteca tensiones
300-500 · esc. 2.000+
Pierde valor diferencial.
FASE 6.4
Diagnóstico ejecutivo
100-250 plantillas
Mucho cálculo, poca claridad.
FASE 6.5
Confianza diagnóstico
Score
Peligro gerencial.
FASE 7.1
Prioridad ejecutiva
Fórmula ponderada
Ruido corporativo.
FASE 7.2
Recomendaciones
300-1.000
"Revisar", "analizar". Nadie hace nada.
FASE 7.3
Simulación escenarios
Modelos
Decidir sin estimar = suerte.
FASE 7.4
Action Guide
100-300 playbooks
Recomienda pero no sabe cómo ejecutar.
ZOOM · MACROBLOQUES 5 + 6 · EJECUCIÓN + CONTROL + MEJORA

11 etapas donde termina BI y empieza dirección.

Acciones, responsables, workflow, escalamiento, seguimiento, score y aprendizaje. El sistema cierra el círculo y aprende del uso.

FASE 8.1
Acciones FARO
300-1.000
Otro informe en el cementerio digital.
FASE 8.2
Responsable + venc.
10-40 roles
Sin dueño: muerta.
FASE 8.3
Workflow
7-10 estados
No se sabe si avanzan.
FASE 8.4
Escalamiento
30-80 reglas
Lo crítico se atasca.
FASE 9.1
Seguimiento
20-50 KPIs ejec.
Tablero nuevo, empresa igual.
FASE 9.2
Medición posterior
Before/after
Gestión de apariencia.
FASE 9.3
Cierre ejecutivo
4 estados de cierre
"Cerrado" ≠ "resuelto".
FASE 9.4
FARO Score
Score global + parcial
Sin síntesis ejecutiva.
FASE 10.1
Aprendizaje
Memoria de decisiones
Repite sin aprender.
FASE 10.2
Recalibración
Por industria/madurez
Sistema rígido.
FASE 10.3
Mejora procesos ext.
50-150 tipos
Diagnóstico sin cirugía.
TABLA MAESTRA · QUÉ DEMUESTRA

Esto no es una idea. Es una arquitectura construible con propiedad intelectual definida.

46 etapas con fórmula, dueño, validador y output medible. 11 activos propios. 50 anexos técnicos. Stack estándar más propiedad intelectual de FARO.

46
Etapas documentadas
Cada una con 15 columnas: objetivo, áreas, qué entra, qué hace, activo, volumen, fórmula, herramientas, validador, nivel, riesgo, qué sale, anexo.
11
Activos propios
Diccionario · Taxonomía · KPIs · Reglas (DSL) · Tensiones · Alertas · Acciones · Playbooks · Relaciones causa-impacto · Score+memoria · Recalibración.
40
Anexos técnicos
Especificación detallada por etapa. 5 anexos públicos, 12 deck parcial, 9 NDA recomendado, 12 NDA obligatorio.
5
Bloqueantes POC
Etapas que hay que resolver antes de Semana 3: auditoría datos · biblioteca tensiones · umbrales · workflow engine · FARO Score.
12-20
Industrias cubiertas
Construcción, retail, salud, agro, logística, minería, hotelería, energía, shopping, servicios, real estate, educación, industria.
Escalabilidad
KPIs esc. 1.000+ · Reglas esc. 2.000+ · Tensiones esc. 2.000+ · Acciones esc. 1.000+. Sistema diseñado para crecer con la madurez del cliente.