Estado de implementación · pack vs build

Seeds Empresa Demo Cuyo S.A.

Empresa canónica del MVP. Comercialización de insumos para la construcción en Mendoza / San Juan, modelo mayorista-minorista con sucursales, depósito, vendedores, stock y cobranza. La narrativa elegida para la demo es "crecimiento no rentable": las ventas crecen, el margen cae, los descuentos suben, la cobranza se estira y aparecen acciones vencidas — el caso típico que FARO Connect debe detectar y bajar a foco ejecutivo.

Cantidades por entidad (V024)

IDs determinísticos principales (UUIDs fijos)

El seed usa UUIDs fijos para reproducibilidad de pruebas y demos. Esto permite que tests, fixtures y queries de validación apunten a los mismos identificadores en cualquier entorno.

Fragmento representativo del V024

Este es un extracto ilustrativo. Para el SQL verbatim completo, ver pack-build/sql/FARO-SQL-003-seeds-empresa-demo.md (725+ líneas).

-- FARO-SQL-003 · V024__seed_demo_company.sql
BEGIN;

SELECT set_config('app.company_id', '10000000-0000-0000-0000-000000000001', true);
SELECT set_config('app.user_id', '12000000-0000-0000-0000-000000000001', true);

-- 1. EMPRESA DEMO
INSERT INTO faro.companies (company_id, company_code, legal_name, ...)
VALUES (
  '10000000-0000-0000-0000-000000000001',
  'EMP_DEMO_CUYO',
  'Empresa Demo Cuyo S.A.',
  ...,
  '{"demo": true, "mvp_scope": ["sales","margin","discounts","stock","receivables","actions","score"]}'::jsonb
)
ON CONFLICT (company_id) DO UPDATE SET ...;

-- 17. KPI SNAPSHOTS · mayo 2026 vs abril referencia
INSERT INTO faro.kpi_snapshots (kpi_code, value, reference_value, delta_pct, status, ...)
VALUES
  ('KPI-SAL-002', 0.2130, 0.2800, -0.2392, 'critical', ...),  -- margen cae
  ('KPI-SAL-003', 0.1230, 0.0620,  0.9838, 'critical', ...),  -- descuentos suben
  ('KPI-FIN-002', 3800000, 1800000, 1.1111, 'critical', ...), -- mora vencida ×2
  ...;

-- 25. FARO SCORE · 74 (abril) → 66 (mayo · warning)
INSERT INTO faro.score_snapshots (period_start, score_value, previous_score_value, delta_value, ...)
VALUES
  ('2026-04-01', 74, NULL,  NULL, 'good',    ...),
  ('2026-05-01', 66,   74,    -8, 'warning', ...);

COMMIT;

Cross-references: catalogo-tensiones-mvp.html (catálogo TNS canónico) · modelo-sql.html (DDL base) · contrato-datos-mvp.html (esquema de datos)

Patch V027 · Alineación con catálogos canónicos

FARO-SQL-003 quedó con códigos provisorios de tensión (TNS-002, TNS-003, TNS-004, TNS-005) anteriores al congelamiento del Catálogo Canónico (catalogo-tensiones-mvp.html). Este patch reasigna esos códigos a los oficiales TNS-004 (Venta sin caja), TNS-006 (Stock crítico), TNS-007 (Stock inmovilizado), TNS-009 (Acciones vencidas) y agrega TNS-010 (Acciones sin evidencia), separando lo que el seed viejo mezclaba.

Mapeo antes → después

El patch también alinea action_code de ACT-001..007 a ACT-COM-001, ACT-COM-002, ACT-FIN-001, ACT-STK-001, ACT-STK-003, ACT-OPS-001, ACT-DIR-001 + nueva ACT-OPS-002.

Fragmento representativo del V027

-- FARO-SQL-003.1 · V027__patch_demo_company_align_canonical_tns.sql
BEGIN;

-- 1. PREFLIGHT (bloquea si falta FARO-SQL-004 o tension_definitions canónicas)
DO $$
BEGIN
  IF NOT EXISTS (SELECT 1 FROM information_schema.tables
                 WHERE table_schema='faro' AND table_name='tension_definitions') THEN
    RAISE EXCEPTION 'FARO-SQL-004 must be applied before FARO-SQL-003.1.';
  END IF;
  IF (SELECT COUNT(*) FROM faro.tension_definitions
      WHERE tension_code IN ('TNS-001','TNS-004','TNS-006','TNS-007','TNS-009','TNS-010')
        AND status='active') < 6 THEN
    RAISE EXCEPTION 'Canonical tension definitions required for demo patch are missing.';
  END IF;
END $$;

-- 2. UPDATE rule_definitions · reasignar códigos canónicos
UPDATE faro.rule_definitions SET rule_code='RULE-TNS-007', name='Stock inmovilizado', ...
  WHERE rule_id='20000000-0000-0000-0000-000000000004';  -- antes RULE-TNS-004

UPDATE faro.rule_definitions SET rule_code='RULE-TNS-006', name='Stock crítico...', ...
  WHERE rule_id='20000000-0000-0000-0000-000000000003';  -- antes RULE-TNS-003

UPDATE faro.rule_definitions SET rule_code='RULE-TNS-004', name='Venta sin conversión a caja', ...
  WHERE rule_id='20000000-0000-0000-0000-000000000002';  -- antes RULE-TNS-002

-- 3. INSERT nueva regla TNS-010 (Acciones sin evidencia)
INSERT INTO faro.rule_definitions (...) VALUES ('20000000-0000-0000-0000-000000000010', ...);

-- 5. UPDATE tensions · reasignar tension_code canónico + payload enriquecido
UPDATE faro.tensions SET tension_code='TNS-004', title='Venta sin conversión a caja', ...
  WHERE tension_id='22000000-0000-0000-0000-000000000002';

-- 6. UPDATE actions · canonical action_code (ACT-001 → ACT-COM-001, etc.)
-- 8. UPDATE score_snapshots · components.main_tensions = ["TNS-001","TNS-004","TNS-006","TNS-007","TNS-009","TNS-010"]
-- 9. UPDATE reports · reporte semanal con códigos canónicos · score 74 → 66

COMMIT;

Preflight check (obligatorio antes de aplicar)

El patch bloquea automáticamente la ejecución si las dependencias canónicas no están aplicadas. No requiere intervención manual.

-- Bloquea si faltan:
-- a) tabla faro.tension_definitions (creada por FARO-SQL-004)
-- b) las 6 fichas canónicas TNS-001, TNS-004, TNS-006, TNS-007, TNS-009, TNS-010 con status='active'

7 validaciones SQL posteriores

Después de aplicar V027, correr estas validaciones para confirmar consistencia. Ninguna debe devolver filas inesperadas.

Cross-references: catalogo-tensiones-mvp.html (catálogo canónico TNS-001..030) · modelo-sql.html (DDL base) · contrato-datos-mvp.html