¿Qué es Futuros?
Futuros es la capa de inteligencia para la tecnología de frontera en América Latina. Reúne datos comparables de 25 países y 10 ejes sectoriales (educación, salud, seguridad, medio ambiente, trabajo, gobernanza democrática, infraestructura, innovación, justicia, cohesión social), los liga uno a uno con su fuente primaria, y los convierte en inteligencia accionable para gobiernos, instituciones financieras, empresas y sociedad civil.
La plataforma vive en futuros.xyz. Esta documentación explica cómo funciona por dentro: de dónde vienen las cifras, cómo se verifican, y por qué la procedencia es el activo central.
El contrato de trazabilidad
Toda cifra en pantalla se remonta a un registro de fuente primaria específico en dos clics. No hay número sin fuente. No hay proyección sin su tasa base y su supuesto declarado. Cada afirmación lleva su cita o su etiqueta [SUPUESTO].
Esto no es un eslogan: es una regla de compilación. El build falla si un enlace de cita apunta a una fuente genérica en vez de al registro específico de país + indicador. La trazabilidad es el foso competitivo de la plataforma — y la restricción que la mantiene honesta.
Cómo llega una cifra a la pantalla
Cada salto del diagrama es verificable en el repositorio:
- Ingesta — los adaptadores (
scripts/sources/adapters.ts, víascripts/ingest-multisource.ts) son aditivos (los indicadores existentes no se tocan), idempotentes (re-ejecutar reemplaza por id estable, nunca duplica) y honestos (un hueco se descarta, jamás se fabrica). - Celda — una por eje × geografía:
public/data/parameter-cache/<eje>__<ISO>.json, 260 archivos (10 ejes × 26 geografías: 25 países + el agregado regional). El nombre del archivo usa el slug del eje (trabajo-economia), que es la clave de esquema y no cambia. Cada indicador llevavalue,series,vintage_year,source_urly uncitation_id. - Cita — un registro por cifra en
public/data/citations.json(15.098 registros a ago-2026, sobre 336 fuentes primarias distintas), forma fija{id, source, title, url, retrieved_at, year}. El prefijo delid(wb-…,oecd-…) resuelve la entrada del registro de fuentes (src/lib/source-registry.ts), cuyaurl_templateconstruye el deep-link. - SPA y renderizado — el frontend (
src/lib/api.ts) hacefetchsame-origin de esos JSON estáticos (cero backend, cero LLM en el camino), y todo número pasa por<Traced value cite>, que anexa un<CiteRef>: la cifra misma va subrayada, hover = tarjeta con título y año, clic = la fuente específica. En modostrict, un id que no resuelve se renderiza como marcador sin enlace — nunca se fabrica un registro sintético que aparente evidencia.
El contrato como invariantes de build
El contrato no depende de disciplina editorial: está codificado como una cadena de compuertas en el hook prebuild de package.json. La cadena corre dos typechecks (scripts y servidor) y la suite completa de 2.076 tests, luego veintiuna compuertas check-*, luego los cuatro hornos de datos (bake-data-health, bake-source-ledger, bake-api, bake-feeds) y cierra verificando el horneado. Cualquier violación es exit 1: build rojo, no advertencia — vite build nunca corre sobre datos que rompen un invariante.
Compuerta (scripts/) | Invariante que rompe el build |
|---|---|
check-traced.ts | Ningún número en las superficies de bloques o de portada de país se renderiza fuera de <Traced/> (grep de los formateadores fmtNumber / formatVal / toFixed; excepciones solo con marcador explícito, p. ej. salida de simulador). |
check-signals.ts | Cada señal extraída tiene source_url real y presente en su documento fuente, y su cifra (figure) aparece textual en el fragmento del documento — sin números inventados. |
check-source-links.ts | Toda cita deep-linkea a un registro específico. Fail-closed: una fuente nueva sin url_template cae al landing genérico y el build falla; las excepciones son una allowlist corta y justificada. |
check-citations.ts | Toda cita referenciada por un piloto o arquetipo resuelve a un registro real (en citations.json, en el arquetipo, o a una clave conocida del registro de fuentes) — cero citas muertas ante un stakeholder. |
check-scores.ts | El índice compuesto (scores.json) cubre cada geografía del parameter-cache (menos cuarentenas), con compuesto ∈ [0, 100] y sin NaN. |
check-provenance.ts | Todo valor bajo claves hash / digest / signature es un SHA-256 completo de 64 hex o un marcador explícito de "sin digest" — nunca un hash truncado que aparente una garantía criptográfica inexistente. |
check-catalog.ts | Cada dataset registrado para el asistente apunta a un archivo o directorio existente y poblado; además re-emite catalog.json, el inventario máquina del corpus. |
check-api.ts | El API estático re-horneado espeja exactamente public/data: mismo conteo de citas, una observación por celda del cache, bulk CSV/XLSX parseables, y etiquetas ES/EN/PT sincronizadas con el registro de métricas. |
El principio operativo
Si no puede rastrearse hasta una fuente primaria, no se publica como valor. Un dato con licencia de solo-cita puede aparecer como referencia, nunca como cifra republicada. La honestidad cuando algo no está configurado o no puede verificarse es parte del contrato, no una excepción.
El volante de los cuatro pilares
La estrategia de la plataforma es un ciclo que se refuerza a sí mismo:
Datos aportados con consentimiento y procedencia verificable alimentan un modelo soberano regional, cuyos resultados fortalecen la gobernanza democrática y aceleran la frontera tecnológica del sector privado — y ese valor atrae más datos.
Ningún público está privilegiado sobre otro: el ciclo es la historia. Cada pilar es a la vez resultado del anterior e insumo del siguiente. El orden es causal, no arbitrario. Lee el ciclo completo en El ciclo de los cuatro pilares; en la plataforma misma, el volante tiene su propia superficie en vivo en futuros.xyz/pilares.
Los cuatro pilares estratégicos
| # | Pilar | Qué es | Superficies en vivo |
|---|---|---|---|
| 1 | Fideicomiso de Datos | Infraestructura de contribución: instituciones, empresas y personas aportan datos bajo consentimiento granular y reciben un recibo de procedencia verificable. Derechos, no propiedad. | /contribuir · /datos-abiertos · /linaje |
| 2 | Modelo Soberano | Inferencia regional sobre pesos abiertos, con los datos y la consulta dentro de la jurisdicción. Los hechos viven en RAG con citas deterministas — nunca horneados en los pesos. | Asistente global — el panel de chat vive en toda la plataforma, disponible en cada ruta; /sala lo integra a fondo ("Profundizar en el chat") · badge "modo soberano" cuando la inferencia corre en un endpoint dentro de la región (requiere configuración explícita; sin ella el badge no aparece) |
| 3 | Gobernanza y Democracia | Los resultados del modelo al servicio de reguladores e instituciones: observatorios citados, monitoreo electoral, inteligencia situacional auditable. | /gobernanza/observatorio · /gobernanza/regulacion · /sala |
| 4 | Inteligencia de Frontera | La capa de decisión del sector privado: terminal de mercados, análisis BI con procedencia determinista, lentes de economía post-AGI y soberanía de cómputo. | /mercados · /explorar · /economia-agi |
Las superficies listadas son una muestra, no el inventario completo: el pilar 3 incluye además /gobernanza/elecciones, /gobernanza/transparencia, /consenso y /prioridades; el pilar 4, /soberania-computo, /dependencia, /movimientos y /alertas, más los tableros embebibles, el servidor MCP y la API pública. El inventario por pilar vive en su capítulo.
En los materiales del grant, el pilar 3 lleva además el nombre Motor de Gobernanza (Governance Engine); el mapeo completo del marco de tres pilares vive en la presentación del grant dentro del ciclo.
Los "cuatro pilares estratégicos" son un lente sobre el porqué de la plataforma. Son distintos de los 10 ejes sectoriales (educación, salud, seguridad…), que son la taxonomía de contenido por debajo. "Eje" es el sustantivo canónico para cada uno de los diez (state/TAXONOMY_GLOSSARY.md): reemplaza a "dimensión", "pilar" y "parámetro" en la copia, aunque la clave de esquema siga siendo parameter. "Pilar" queda reservado a los cuatro estratégicos, que siempre se nombran completos.
A quién sirve
- Gobiernos y reguladores — indicadores comparables entre países, observatorios de resiliencia democrática y de regulación, inteligencia situacional con cada alerta auditable. La región regula desde sus propias tradiciones legales, no con plantillas de EE. UU. o la UE.
- Instituciones financieras (BID, CAF, CEPAL) — cifras bancables: una cifra citada es una cifra invertible. Cadena piloto → financiamiento → tomador de decisión.
- Sector privado — terminal de mercados, exploración BI en el navegador, lentes de dependencia y de economía post-AGI para decidir inversión y despliegue.
- Sociedad civil e investigación — API pública abierta, datos abiertos con licencia declarada, votación anónima de consenso, y el linaje de cada cifra a la vista.
Cómo navegar esta documentación
- Empezar — esta página, el ciclo de los cuatro pilares, y un recorrido por la plataforma.
- Los cuatro pilares — un capítulo por pilar, con la tesis, las mecánicas verificables y las superficies en vivo: Fideicomiso de Datos, Modelo Soberano, Gobernanza y Democracia, Inteligencia de Frontera.
- Cómo funciona — el pipeline de datos, las fuentes públicas, la procedencia y las citas, la hoja de ruta de procedencia, El Índice Futuros, el asistente, y la metodología y honestidad.
- Developers (EN) — la API pública v1, el servidor MCP, los embeds y white-label, y el self-hosting soberano.
Documentación en español para el público de la región; la referencia técnica de integración está en inglés, siguiendo las convenciones del repositorio.