O que é Futuros?
Futuros é a camada de inteligência para a tecnologia de fronteira na América Latina. Reúne dados comparáveis de 25 países e 10 eixos setoriais (educação, saúde, segurança, meio ambiente, trabalho, governança democrática, infraestrutura, inovação, justiça, coesão social), vincula cada um deles à sua fonte primária e os converte em inteligência acionável para governos, instituições financeiras, empresas e sociedade civil.
A plataforma vive em futuros.xyz. Esta documentação explica como ela funciona por dentro: de onde vêm os números, como são verificados e por que a procedência é o ativo central.
O contrato de rastreabilidade
Todo número na tela remonta a um registro de fonte primária específico em dois cliques. Não há número sem fonte. Não há projeção sem sua taxa-base e sua premissa declarada. Cada afirmação carrega sua citação ou sua etiqueta [SUPUESTO].
Isto não é um slogan: é uma regra de compilação. O build falha se um link de citação aponta para uma fonte genérica em vez do registro específico de país + indicador. A rastreabilidade é o fosso competitivo da plataforma — e a restrição que a mantém honesta.
Como um número chega à tela
Cada salto do diagrama é verificável no repositório:
- Ingestão — os adaptadores (
scripts/sources/adapters.ts, viascripts/ingest-multisource.ts) são aditivos (os indicadores existentes não são tocados), idempotentes (reexecutar substitui por id estável, nunca duplica) e honestos (uma lacuna é descartada, jamais fabricada). - Célula — uma por eixo × geografia:
public/data/parameter-cache/<eixo>__<ISO>.json, 260 arquivos (10 eixos × 26 geografias: 25 países + o agregado regional). O nome do arquivo usa o slug do eixo (trabajo-economia), que é a chave de esquema e não muda. Cada indicador carregavalue,series,vintage_year,source_urle umcitation_id. - Citação — um registro por número em
public/data/citations.json(15.098 registros em ago-2026, sobre 336 fontes primárias distintas), forma fixa{id, source, title, url, retrieved_at, year}. O prefixo doid(wb-…,oecd-…) resolve a entrada do registro de fontes (src/lib/source-registry.ts), cujourl_templateconstrói o deep-link. - SPA e renderização — o frontend (
src/lib/api.ts) fazfetchsame-origin desses JSON estáticos (zero backend, zero LLM no caminho), e todo número passa por<Traced value cite>, que anexa um<CiteRef>: a cifra mesma vai sublinhada, hover = cartão com título e ano, clique = a fonte específica. Em modostrict, um id que não resolve é renderizado como marcador sem link — nunca se fabrica um registro sintético que aparente evidência.
O contrato como invariantes de build
O contrato não depende de disciplina editorial: está codificado como uma cadeia de portões no hook prebuild do package.json. A cadeia roda dois typechecks (scripts e servidor) e a suíte completa de 2.076 testes, depois vinte e um portões check-*, depois os quatro bakes de dados (bake-data-health, bake-source-ledger, bake-api, bake-feeds) e fecha verificando o resultado do bake. Qualquer violação é exit 1: build vermelho, não advertência — vite build nunca roda sobre dados que quebram um invariante.
Portão (scripts/) | Invariante que quebra o build |
|---|---|
check-traced.ts | Nenhum número nas superfícies de blocos ou de capa de país é renderizado fora de <Traced/> (grep dos formatadores fmtNumber / formatVal / toFixed; exceções só com marcador explícito, p. ex. saída de simulador). |
check-signals.ts | Cada sinal extraído tem source_url real e presente em seu documento-fonte, e seu número (figure) aparece textual no trecho do documento — sem números inventados. |
check-source-links.ts | Toda citação tem deep-link para um registro específico. Fail-closed: uma fonte nova sem url_template cai no landing genérico e o build falha; as exceções são uma allowlist curta e justificada. |
check-citations.ts | Toda citação referenciada por um piloto ou arquétipo resolve para um registro real (em citations.json, no arquétipo, ou para uma chave conhecida do registro de fontes) — zero citações mortas diante de um stakeholder. |
check-scores.ts | O índice composto (scores.json) cobre cada geografia do parameter-cache (menos quarentenas), com composto ∈ [0, 100] e sem NaN. |
check-provenance.ts | Todo valor sob chaves hash / digest / signature é um SHA-256 completo de 64 hex ou um marcador explícito de "sem digest" — nunca um hash truncado que aparente uma garantia criptográfica inexistente. |
check-catalog.ts | Cada dataset registrado para o assistente aponta para um arquivo ou diretório existente e povoado; além disso, reemite catalog.json, o inventário máquina do corpus. |
check-api.ts | A API estática re-assada espelha exatamente public/data: mesma contagem de citações, uma observação por célula do cache, bulk CSV/XLSX parseáveis e rótulos ES/EN/PT sincronizados com o registro de métricas. |
O princípio operacional
Se não pode ser rastreado até uma fonte primária, não se publica como valor. Um dado com licença de apenas-citação pode aparecer como referência, nunca como número republicado. A honestidade quando algo não está configurado ou não pode ser verificado é parte do contrato, não uma exceção.
O volante dos quatro pilares
A estratégia da plataforma é um ciclo que se reforça a si mesmo:
Dados aportados com consentimento e procedência verificável alimentam um modelo soberano regional, cujos resultados fortalecem a governança democrática e aceleram a fronteira tecnológica do setor privado — e esse valor atrai mais dados.
Nenhum público é privilegiado sobre outro: o ciclo é a história. Cada pilar é ao mesmo tempo resultado do anterior e insumo do seguinte. A ordem é causal, não arbitrária. Leia o ciclo completo em O ciclo dos quatro pilares; na própria plataforma, o volante tem sua superfície ao vivo em futuros.xyz/pilares.
Os quatro pilares estratégicos
| # | Pilar | O que é | Superfícies ao vivo |
|---|---|---|---|
| 1 | Fundo Fiduciário de Dados | Infraestrutura de contribuição: instituições, empresas e pessoas aportam dados sob consentimento granular e recebem um recibo de procedência verificável. Direitos, não propriedade. | /contribuir · /datos-abiertos · /linaje |
| 2 | Modelo Soberano | Inferência regional sobre pesos abertos, com os dados e a consulta dentro da jurisdição. Os fatos vivem em RAG com citações determinísticas — nunca embutidos nos pesos. | Assistente global — o painel de chat vive em toda a plataforma, disponível em cada rota; /sala o integra a fundo ("Aprofundar no chat") · badge "modo soberano" quando a inferência roda em um endpoint dentro da região (exige configuração explícita; sem ela o badge não aparece) |
| 3 | Governança e Democracia | Os resultados do modelo a serviço de reguladores e instituições: observatórios citados, monitoramento eleitoral, inteligência situacional auditável. | /gobernanza/observatorio · /gobernanza/regulacion · /sala |
| 4 | Inteligência de Fronteira | A camada de decisão do setor privado: terminal de mercados, análise BI com procedência determinística, lentes de economia pós-AGI e soberania de computação. | /mercados · /explorar · /economia-agi |
As superfícies listadas são uma amostra, não o inventário completo: o pilar 3 inclui também /gobernanza/elecciones, /gobernanza/transparencia, /consenso e /prioridades; o pilar 4, /soberania-computo, /dependencia, /movimientos e /alertas, além dos painéis embutíveis, do servidor MCP e da API pública. O inventário por pilar vive em seu capítulo.
Nos materiais do grant, o pilar 3 leva também o nome Motor de Governança (Governance Engine); o mapeamento completo do marco de três pilares vive em a apresentação do grant dentro do ciclo.
Os "quatro pilares estratégicos" são uma lente sobre o porquê da plataforma. São distintos dos 10 eixos setoriais (educação, saúde, segurança…), que são a taxonomia de conteúdo por baixo. "Eixo" é o substantivo canônico para cada um dos dez (state/TAXONOMY_GLOSSARY.md): substitui "dimensão", "pilar" e "parâmetro" na copy, ainda que a chave de esquema continue sendo parameter. "Pilar" fica reservado aos quatro estratégicos, que são sempre nomeados por extenso.
A quem serve
- Governos e reguladores — indicadores comparáveis entre países, observatórios de resiliência democrática e de regulação, inteligência situacional com cada alerta auditável. A região regula a partir de suas próprias tradições jurídicas, não com modelos prontos dos EUA ou da UE.
- Instituições financeiras (BID, CAF, CEPAL) — números bancáveis: um número citado é um número investível. Cadeia piloto → financiamento → tomador de decisão.
- Setor privado — terminal de mercados, exploração BI no navegador, lentes de dependência e de economia pós-AGI para decidir investimento e implantação.
- Sociedade civil e pesquisa — API pública aberta, dados abertos com licença declarada, votação anônima de consenso e a linhagem de cada número à vista.
Como navegar esta documentação
- Começar — esta página, o ciclo dos quatro pilares e um percurso pela plataforma.
- Os quatro pilares — um capítulo por pilar, com a tese, as mecânicas verificáveis e as superfícies ao vivo: Fundo Fiduciário de Dados, Modelo Soberano, Governança e Democracia, Inteligência de Fronteira.
- Como funciona — o pipeline de dados, as fontes públicas, a procedência e as citações, o roteiro de procedência, O Índice Futuros, o assistente e a metodologia e honestidade.
- Developers (EN) — a API pública v1, o servidor MCP, os embeds e white-label e o self-hosting soberano.
A documentação principal está em espanhol para o público da região; a referência técnica de integração está em inglês, seguindo as convenções do repositório.