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. Alterações passam por pull request, como qualquer outro conteúdo 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 publica nada. Todo rascunho nasce como pull request e só entra no site depois de revisão humana;
• 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 autoria é sempre de uma pessoa real (ver §9).

3. Revisão humana obrigatória

Nenhuma página é publicada ou alterada sem que um editor com perfil cadastrado em content/authors/ tenha:

1. conferido cada número do texto contra a fonte oficial citada;
2. conferido que a tabela e o gráfico repetem os mesmos valores do texto;
3. lido o texto inteiro em busca de afirmações sem fonte, linguagem especulativa ou promessas ("você vai receber");
4. aprovado o pull request. A proteção de branch impede merge sem essa aprovação (Fase 5).

O editor que aprova responde pelo conteúdo e aparece como autor da página.

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 a descrição do pull request 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 pelo mesmo fluxo de revisão de §3.

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, e o revisor confere que os números do texto, da tabela e do gráfico são os mesmos do arquivo.

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 autor humano 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.

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 em todo pull request (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 não pode ser verificado por software — a exatidão de cada número — é responsabilidade do revisor humano (§3).