Como contribuir
Toda colaboração passa pelo repositório público. Casos precisam de fontes verificáveis; hipóteses não viram fato sem prova. Prefira os modelos de issue — depois PR com JSON.
Modelos de issue
.github/ISSUE_TEMPLATEEscolha o modelo certo em issues/new/choose ou abra diretamente abaixo. Labels são aplicadas automaticamente.
Propor novo caso
Sugestão para Brasil, globais ou custódia — dataset, taxonomia, resumo factual e mínimo 2 fontes independentes.
Abrir modelo → correção · editorialCorrigir ou atualizar caso
Erro factual, fonte nova, status processual, taxonomia ou nota de contexto — indique id/slug e dataset.
Abrir modelo → bug · siteBug no site
Interface, dados que não carregam, link partido, filtro ou ficha. Inclua URL e passos para reproduzir.
Abrir modelo → melhoriaMelhoria técnica
CI, schema, UI, scripts da fila (fila:process), acessibilidade ou documentação.
Abrir modelo → editorial · discussãoDiscussão editorial
Critérios de inclusão, candidatos com nota de contexto, novo failure_type, lacunas da fila ou ética de redação. Hipótese ≠ fato.
Abrir modelo →Fluxo recomendado
issue → JSON → PR-
Abrir issue com o modelo certo Casos incompletos ou controversos começam como discussão. Casos prontos podem ir direto a PR.
-
Preparar o JSON Editar o dataset na raiz (state-victims-brazil.json, casos globais ou custódia) ou deixar batch em data/_fila/ para npm run fila:process.
-
Validar e sincronizar Correr npm run sync-data (ou deixar o processar da fila fazê-lo). Conferir no painel e em Brasil.
-
Abrir pull request Descrição clara, ligação à issue, fontes no corpo do PR. Schema em SCHEMA.md.
Adicionar caso
mín. 2 fontesFaça fork, use o modelo Propor novo caso ou envie PR com o objeto no array correto casos_individuais / cases / casos_individuais_verificados. Cada registo deve poder ser verificado por terceiros — links primários ou documentos públicos.
Schema JSON
SCHEMA.mdCampos obrigatórios incluem identificador, slug, narrativa e lista de fontes com URL. Taxonomia failure_type em SCHEMA.md §5. Documentação completa: SCHEMA.md no repositório.
Diretrizes
não negociáveis- Sem anonimato editorial — o contribuidor assina o registo (issue ou PR).
- Sem acusações sem fonte: cada afirmação grave aponta para evidência.
- Respeito às vítimas e famílias — linguagem factual, sem sensacionalismo.
- Hipótese ≠ fato — pontos contestados ficam explícitos (nota editorial / ev-contested).
Adicionar país ou dataset
registry.jsonAbra uma discussão editorial ou melhoria técnica com contexto jurídico e fontes sobre o sistema estatal do país. O manifest registry.json lista os datasets e páginas associadas.