Política editorial

Esta política vale para todo o conteúdo publicado em quantoinfo.com. A página pública /politica-editorial é gerada a partir deste arquivo no build; o texto aqui é a versão canônica e todo o histórico de alterações é público no repositório do site.

1. O que o Quanto publica

O Quanto faz jornalismo de serviço sobre dinheiro e benefícios no Brasil: quanto custa, quanto vale, quando cai, quem tem direito, como pedir e se vale a pena. Cada página responde a uma pergunta concreta e mostra, ao lado de cada número, a fonte oficial de onde ele saiu.

O site é organizado em cinco seções, que correspondem às perguntas que as pessoas fazem:

2. Fluxo de produção assistido por IA

Parte do trabalho de rotina é feita por modelos de linguagem: classificar itens de fontes oficiais, extrair valores e datas para um arquivo de dados estruturado e escrever um primeiro rascunho em português a partir desse arquivo. Isso está declarado em cada página (ai_assisted: true no frontmatter é obrigatório e o template exibe o aviso).

O que a IA faz:

• lê apenas fontes oficiais previamente aprovadas;
• extrai números, datas e regras para content/data/<tema>.json, com o trecho literal da fonte que sustenta cada item;
• gera a especificação do gráfico (content/charts/<id>.json);
• escreve o rascunho do texto a partir do arquivo de dados — nunca a partir do texto bruto da fonte e nunca a partir de memória própria.

O que a IA não faz:

• não inventa, arredonda ou "atualiza" um número que não esteja no arquivo de dados;
• não cria imagens (ver §8);
• não assina textos. A responsabilidade editorial é sempre de uma pessoa real (ver §9);
• não publica uma página sem passar pelas verificações de §3.

3. Verificação antes de publicar

Uma página só entra no site depois de passar por três verificações, nesta ordem. As duas primeiras são feitas por software e a terceira por um modelo de linguagem independente do que escreveu o texto; o que nenhuma delas aprova fica retido como rascunho até que um editor decida.

1. Citação literal. Cada valor, data e regra do arquivo de dados tem de vir acompanhado de um trecho copiado literalmente da fonte oficial que o contém; o que não é encontrado na fonte é descartado antes de o texto ser escrito.
2. Números do texto. Todo valor em reais e todo percentual do texto, da tabela e do gráfico é conferido contra o arquivo de dados; um número que não está no arquivo rejeita o texto, que é reescrito uma vez e, se falhar de novo, não é publicado.
3. Revisão de fechamento. Um segundo modelo, que não participou da redação, lê a página pronta ao lado do texto oficial completo e responde a uma lista fixa de perguntas: cada número, data, prazo e regra está na fonte com o mesmo sentido? A página afirma algo que a fonte não diz? Título e descrição correspondem ao conteúdo? Há promessa, conselho ou especulação? Basta uma resposta desfavorável para a página ser retida.

Uma página aprovada nas três verificações é publicada automaticamente e traz, ao pé do texto, o aviso de que a revisão do editor responsável ainda não foi concluída. O editor pode, a qualquer momento, aprovar, corrigir, despublicar ou excluir qualquer página; a partir da aprovação o aviso é substituído pela assinatura de revisão. Páginas retidas ficam fora do site (não são listadas, indexadas nem linkadas) até a decisão do editor. Um tema que o editor rejeita não é recriado pelo sistema nos 30 dias seguintes.

O registro de cada decisão — o veredito da revisão automática, os motivos de uma retenção, quem aprovou ou rejeitou e quando — fica em content/editorial/<tema>.json, público no repositório.

O editor responsável pela página responde pelo conteúdo e aparece na página (ver §9).

4. Fontes: apenas primárias e oficiais

Só são aceitas como fonte páginas em domínios oficiais — gov.br, leg.br, jus.br, in.gov.br (Diário Oficial da União) e ebc.com.br (Agência Brasil). A regra é aplicada em código: o esquema de validação rejeita qualquer URL fora dessa lista, e o CI falha.

Consequências práticas:

• portais de notícias, blogs, redes sociais, calculadoras de terceiros e agregadores não servem como fonte, mesmo quando citam a fonte oficial;
• quando o dado existe apenas em documento (portaria, lei, resolução), a fonte é o documento no Diário Oficial ou no site do órgão, não uma reportagem sobre ele;
• toda fonte registra a data e hora em que foi consultada (fetched_at);
• links no corpo do texto para sites não oficiais geram alerta no CI e devem ser evitados.

5. Um tema = uma página viva

Cada tema tem exatamente uma URL, identificada pelo topic_slug, que nunca muda. Quando o valor é reajustado ou o calendário é atualizado, a página existente é atualizada — não é criada uma nova. O CI rejeita topic_slug duplicado.

Isso significa que:

• o título e o texto são reescritos para refletir o dado atual, e dateModified é atualizado;
• a página informa "Última atualização" de forma visível (o template insere a linha a partir do frontmatter);
• os dados anteriores continuam no histórico do repositório, que é público e auditável.

6. Correções

Erros acontecem e são corrigidos no lugar, com transparência:

• Erro factual (número, data ou regra errados): corrige-se o texto, a tabela, o gráfico e o arquivo de dados na mesma alteração; dateModified é atualizado; a mensagem do commit e o histórico editorial da página explicam o que estava errado e qual é a fonte do dado correto.
• Erro de digitação ou estilo que não muda o sentido: corrige-se sem nota.
• Mudança na regra oficial (não é erro nosso): a página é atualizada como descrito em §5.

Pedidos de correção podem ser enviados pelo canal indicado no rodapé do site. Toda correção passa pelas mesmas verificações de §3; correções feitas por um editor são registradas no histórico editorial da página.

7. Como um número é rastreado

Todo número do site tem uma trilha de auditoria de três elos:

1. Fonte — a URL oficial, a data da consulta e o hash do conteúdo extraído da fonte (título e texto; content/data/<tema>.json, campo sources). O arquivo bruto baixado fica guardado como snapshot da execução.
2. Dado extraído — o valor, a unidade, a vigência e o trecho literal da fonte que o sustenta (content/data/<tema>.json, campos values, dates e eligibility).
3. Texto publicado — o rascunho é escrito apenas a partir do arquivo de dados; o software confere que os números do texto, da tabela e do gráfico são os mesmos do arquivo, e a revisão de fechamento (§3) confere o sentido de cada afirmação contra o texto oficial.

O gráfico de cada página é gerado a partir de content/charts/<id>.json, que carrega a própria fonte; o rodapé Fonte: <órgão> é montado a partir desse arquivo, nunca digitado à mão.

8. Imagens

• Gráficos próprios: a imagem principal de cada página é um gráfico gerado pelo site a partir da especificação em content/charts/, em 1200×675, com fonte e rodapé fixos. É a única imagem gerada por software que o site usa — e é gerada a partir de dados, não por modelo de imagem.
• Fotos: aceitas apenas de Agência Brasil (EBC), Agência Senado e Agência Câmara, sob licença CC BY, sempre com crédito visível (fotógrafo/agência), licença declarada e link para a página de origem da foto, conforme o campo image.credit do frontmatter.
• Proibido: bancos de imagens (gratuitos ou pagos), imagens geradas por IA, capturas de tela de sites de terceiros e qualquer imagem sem licença verificável.

9. Autoria e credenciais

Cada página tem um editor humano responsável, identificado, com perfil em content/authors/<slug>.json contendo nome completo, função, biografia, credenciais verificáveis (formação, registro profissional, veículos anteriores), foto própria e links para perfis públicos. O template monta a caixa do autor e os dados estruturados (schema.org Person) a partir desse arquivo. Enquanto a revisão desse editor não foi concluída, a página diz isso ao leitor (§3); depois dela, a página informa quem revisou.

Perfis de exemplo ou de demonstração (como editor-exemplo) existem apenas para validar o template e devem ser substituídos por pessoas reais antes do lançamento. O site não publica sob pseudônimo nem sob "Redação".

10. O que o CI verifica

As regras desta política que podem ser verificadas por software são verificadas antes de cada publicação e em toda alteração do repositório (npm run validate:content):

• frontmatter, dados, gráficos e autores válidos contra os esquemas;
• fontes apenas em domínios oficiais — inclusive a fonte declarada no arquivo do gráfico, de onde sai o rodapé "Fonte";
• ai_assisted: true obrigatório;
• um tema por página (topic_slug único e igual ao nome do arquivo; a mesma regra vale para o slug do autor, o id do gráfico e o topic_slug do arquivo de dados);
• autor existente; gráfico existente; imagem existente; quando há gráfico, a imagem principal é a imagem gerada a partir dele (/img/charts/<id>.png);
• seção do texto igual à seção do arquivo de dados;
• título coerente com a intenção da seção (contém "quanto", "quando", "quem", "como" ou "vale a pena") e diversidade de aberturas de título dentro de cada seção: entre as páginas publicadas nos 30 dias anteriores à mais recente da seção (no mínimo três), nenhuma abertura — as duas primeiras palavras do título — pode se repetir em mais de 40% delas;
• corpo com no máximo 700 palavras e não vazio, sem componentes que o template já insere, sem expressões MDX (chaves { }, que fariam o número sumir da página em silêncio) e, quando não há gráfico, com uma tabela de valores em Markdown;
• links no corpo do texto para sites não oficiais geram alerta.

O que o software não verifica — o sentido de cada afirmação — passa pela revisão de fechamento de §3, e a palavra final é sempre do editor responsável, que pode aprovar, corrigir ou despublicar qualquer página.