🔒 Pack Build · Entregables construidos  ·  NDA OBLIGATORIO
← hub modelos
Capa ejecutable real · v1.0 · 2026-05-30

Pack Build · entregables construidos

25 activos técnicos que pasan de "📄 documentado" a "⚙ codificado" en el pack FARO Connect: 2 documentos operativos, 16 plantillas Excel/CSV con datos reales (53 archivos), 3 SQL migrations ejecutables, 1 catálogo de reglas YAML, 2 módulos engineering, 1 framework de tests. Cada uno con código canónico FARO-XXX-NNN y dependencias cruzadas.

25
Artefactos build
6
Categorías
16
Plantillas PL
3
SQL migrations
2+2
DOC + ENG
1+1
CFG + TEST
🟢 Estos artefactos son código, no spec
A diferencia del resto del pack (que es documentación arquitectónica), estos 10 artefactos son código y configuraciones reales: documentos operativos para correr workshops, migrations SQL ejecutables en PostgreSQL, parser TypeScript de reglas, motor evaluador en Node.js, tests Vitest, plantillas Excel con datos reales.

En la matriz de estado: cada uno de estos pasó de 📄 doc → ⚙ codificado. La pieza siguiente (Tarea 46A · Dataset Demo Ejecutable) los integra todos en un docker-compose corriendo end-to-end.

Cadena que cubren: Workshop → Inventario fuentes → Migrations DB → Catálogo reglas YAML → Parser → Motor → Tests → Runbook piloto.
DOC

Documentos operativos

Documentación operacional para correr el ciclo FARO con un cliente real: workshop estructurado y runbook de piloto end-to-end.

FARO-DOC-001 ⚙ Codificado
Script Workshop Discovery
Cuestionario semi-estructurado de 90-120 min para entrevistar al cliente: empresa, sucursales, sistemas, decisiones, datos, tensiones reales, responsables, evidencia, score esperado. Output: foto del estado actual + primer mapa de implementación.
P1 · día 1 MVP 67 KB v1.0
PL-016 SQL-001 CFG-001
FARO-DOC-002 ⚙ Codificado
Runbook de Implementación Piloto
Procedimiento operativo de 30-60 días para implementar un piloto FARO en empresa real o demo controlada. De Workshop a Score con trazabilidad, evitando improvisación y "todos diciendo lo vemos la semana que viene".
P1 · piloto 62 KB v1.0
DOC-001 SQL-001/2 CFG-001
PL

16 Plantillas Excel oficiales

16 plantillas · 4 variantes c/u (MVP · v1.xlsx · v1.csv · template.csv) · ~53 archivos totales

Plantillas Excel completadas por el cliente o el equipo FARO en el Workshop. Cada una con catálogos, hojas operativas y resumen ejecutivo. MVP = versión con datos reales de Empresa Demo. v1.xlsx = workbook completo. v1.csv = sheet principal como CSV. template.csv = encabezados vacíos para cargar al cliente.

SQL

SQL Migrations ejecutables

Migrations versionadas para PostgreSQL 15+. Bloqueantes para piloto ejecutable: estructura base + multitenant + seeds demo.

FARO-SQL-001 ⚙ Codificado
Migraciones Base MVP
Estructura completa de BD para el flujo MVP: empresas → fuentes → ingesta → RAW → staging → maestros → facts → KPIs → señales → reglas → tensiones → acciones → evidencia → score → reporte → auditoría. Multiempresa desde día 1.
P1 · bloqueante 62 KB V001..V0NN
SQL-002 SQL-003
FARO-SQL-002 ⚙ Codificado
Multiempresa, Roles y RLS
Row-Level Security en PostgreSQL para multi-tenant: policies por tabla, contexto de sesión app.company_id, tests con 2 tenants. Sin esto NO se puede tener 2 clientes en paralelo.
P1 · seguridad 78 KB v1.0
SQL-001 RACI-105
FARO-SQL-003 ⚙ Codificado
Seeds Empresa Demo
Datos sintéticos coherentes de Empresa Demo (Distribuidora Premium SA · 3 sucursales · 65 empleados · USD 2.4M). Carga inicial para que el motor evaluador tenga sobre qué correr.
P1 · demo 76 KB v1.0
SQL-001 SQL-002
CFG

Configuración declarativa

Reglas como configuración, no como código. Permite que la dirección audite qué regla disparó qué tensión y por qué.

FARO-CFG-001 ⚙ Codificado
Reglas MVP en YAML
Estándar oficial para escribir reglas FARO en YAML. JSON Schema conceptual + tests declarativos. Cada regla mapea KPIs → condiciones → tensiones → acciones → responsables → evidencia → impacto Score.
P1 · catálogo 56 KB v1.0
ENG-002 ENG-003 TEST-002
ENG

Engineering · motor de reglas

Parser + motor evaluador en TypeScript/Node.js. Toman reglas YAML, las validan, las persisten y las ejecutan sobre los KPIs reales.

FARO-ENG-002 ⚙ Codificado
DSL Parser Reglas YAML
Parser TypeScript: YAML → validación estructura/operadores/KPIs/acciones/roles/evidencia/tests → JSON normalizado → persistencia en faro.rule_definitions → reporte errores. Scaffold técnico inicial.
P1 · crítico 55 KB v1.0
CFG-001 SQL-001/2/3
FARO-ENG-003 ⚙ Codificado
Motor Evaluador MVP
Spec + scaffold del motor que toma kpi_snapshots + rule_definitions + contexto y produce rule_evaluations → tensions → actions → evidence requirements. Crítico para que FARO funcione como sistema.
P1 · crítico 72 KB v1.0
ENG-002 CFG-001 SQL-001/2/3
TEST

Tests automatizados

Framework de QA con Vitest. Valida que YAML válido → parser válido → regla importada → motor evalúa bien → tensión correcta.

FARO-TEST-002 ⚙ Codificado
Tests Reglas MVP
Framework Vitest + PostgreSQL para validar las reglas MVP completas. Casos pass/fail por regla, fixtures, assertions semánticas. Crítico antes de demo ejecutable.
P1 · QA 46 KB v1.0
CFG-001 ENG-002/3 SQL-001/2/3
🔗 Cómo se conectan los 10 artefactos build
DOC-001 Workshop PL-016 Inventario fuentes SQL-001/2/3 Base + RLS + Seeds CFG-001 Reglas YAML ENG-002 DSL Parser ENG-003 Motor evaluador DOC-002 Runbook piloto orquesta TEST-002 Tests reglas valida Cadena lineal: del workshop con cliente al motor que evalúa reglas. DOC-002 orquesta el ciclo. TEST-002 valida el flujo.

🎯 Próximos artefactos a construir

Para llegar al Pack Demo Ejecutable (ver spec 46A) faltan estos artefactos identificados en los archivos build con "Conecta con":

Ver Estado de Implementación para el roadmap completo · Pipeline interactivo para el contexto de cada artefacto.