CM-16 · Integridad de datos de mercado#

En una frase, para cualquiera: todo lo demás se apoya en los precios. Si un precio llega mal y nadie lo nota, cada decisión que se tome después estará mal aunque el sistema funcione perfectamente.

Estado real: 🟠 prototype — hay código y escenarios que se ejecutan, sin verificación en un entorno real · Módulo: crates/sandbox-markets/src/cases/market_data.rs

Por qué se realiza este caso#

Es el caso más aburrido y el más fundacional de la familia. Nadie presume de tener buenos datos de mercado; todos sufren cuando no los tienen.

Ese último es especialmente traicionero: el precio es correcto y la caída es falsa. Sin aplicar el evento, cualquier alarma de variación se dispara sin motivo.

La idea que enseña, y que ningún otro caso enseña#

Un dato tiene que llegar con su procedencia. Precio, moneda, instrumento, proveedor, marca de tiempo y qué eventos corporativos tiene ya aplicados. Un número suelto no es un precio: es un número.

Y con ello, la distinción entre corregir y sobrescribir: una corrección de precio deja rastro de cuál era el anterior, porque las decisiones que se tomaron con el precio viejo hay que poder explicarlas.

Casos de uso reales#

• Consolidar precios de varios proveedores para un mismo instrumento.
• Valorizar una cartera al cierre.
• Detectar datos obsoletos antes de usarlos para calcular márgenes.
• Formación: por qué un precio sin moneda no es un precio.

Cómo funcionará#

flowchart LR
  P1["📡 Proveedor A"] --> V
  P2["📡 Proveedor B"] --> V
  V{"⚖️ Validación"}
  V -- "rechazado" --> X["🚫 Cuarentena<br/>con motivo"]
  V -- "aceptado" --> C["📅 Calendario<br/>y eventos corporativos"]
  C --> S["✅ Precio utilizable"]
  S --> D["📊 Todos los demás casos"]
  X --> A["🚨 Alerta al operador"]

flowchart TB
  A["Dato entrante"] --> B{"¿Precio > 0?"}
  B -- no --> B1["🚫 Precio cero o negativo"]
  B -- sí --> C{"¿La moneda coincide con<br/>la del instrumento?"}
  C -- no --> C1["🚫 Moneda incorrecta"]
  C -- sí --> D{"¿El timestamp está<br/>en el futuro?"}
  D -- sí --> D1["🚫 Timestamp futuro"]
  D -- no --> E{"¿Es más viejo que el<br/>umbral de frescura?"}
  E -- sí --> E1["📣 Obsoleto: usable con marca"]
  E -- no --> F{"¿Variación anómala<br/>frente al anterior?"}
  F -- sí --> F1["📣 ¿Hay evento corporativo<br/>sin aplicar?"]
  F -- no --> G["✅ Aceptado"]

Esquemas#

{
  "quote": {
    "instrument": "ACME-SIM",
    "price": { "minorUnits": 10250, "currency": "CLP" },
    "provider": "proveedor-sim-A",
    "timestamp": "2026-08-07T13:45:00Z",
    "corporateActionsApplied": ["split-2026-05"],
    "stale": false
  }
}

La moneda va dentro del precio, no al lado. Es la misma decisión que en el tipo Money del crate sandbox-markets, ya construido: un importe sin moneda es un error esperando a ocurrir.

{
  "findings": [
    { "kind": "ZeroPrice", "instrument": "ACME-SIM", "provider": "proveedor-sim-B" },
    { "kind": "CurrencyMismatch", "instrument": "GLOBAL-SIM", "expected": "USD", "received": "CLP" },
    { "kind": "StaleData", "instrument": "ACME-SIM", "ageSeconds": 3600, "threshold": 300 }
  ]
}

Software necesario#

Sin jaula ni Linux. Los proveedores son simulados: no hay conectividad con ninguna fuente real de datos de mercado.

Instalación#

cargo build --release

Procesos que se crearán#

sandboxctl markets data --scenario proveedor-caido
  │
  └─ un proceso determinista, sin red
      ├─ proveedores simulados con fallos inyectables
      ├─ calendario de mercado
      └─ cuarentena append-only

Tiempo de carga estimado#

Qué hace falta para construirlo#

1. Modelo de dato con procedencia completa.
2. Las seis validaciones listadas, cada una con escenario.
3. Umbral de frescura configurable, con marca de obsoleto en vez de silencio.
4. Calendario de mercado: festivos y horarios.
5. Corrección con rastro, nunca sobrescritura.
6. Integración con CM-17.

Si algo falla#

El caso ya tiene código y escenarios que se ejecutan. Lo que sigue son sus fallos con la causa y la salida:

Los fallos que afectan a cualquier caso —la compilación, el catálogo, la evidencia— están resueltos uno a uno en Cuando algo falla.

Esta familia no necesita aislamiento del sistema: no ejecuta código ajeno, sino reglas de negocio deterministas. Por eso casi ningún fallo suyo viene del entorno, y casi todos vienen de los datos.

Cómo se comprueba#

cargo run -p sandboxctl -- markets check --case CM-16

Ejecuta los escenarios de este caso y compara cada uno con lo que declara de antemano que debe salir. Corre en cada commit: si el caso deja de detectar lo que dice detectar, la integración continua se pone roja.

cargo test -p sandbox-markets market_data

Los invariantes del módulo, incluidos los que ningún escenario de arriba cubre.

Sigue en prototype, no en functional. Los escenarios se ejecutan y pasan, pero el caso no emite evidencia firmada por ejecución ni se ha usado contra datos que no sean los suyos. La regla completa está en el ROADMAP.

Ver también: Catálogo completo · CM-17 · eventos corporativos · CM-14 · resiliencia