§ catálogo · dados brutos
Dados brutos.
Públicos, versionados, com hash. Análises reprodutíveis bem-vindas.
Princípio
Todos os dados derivados deste estudo são públicos, versionados, e acompanham hash de procedência. Quem discordar de uma análise pode reproduzir o cálculo a partir do mesmo input bruto. Não há tabela escondida, fórmula proprietária ou agregado obscuro: o estudo é uma caderneta de cálculo aberta.
A licença é dupla: CC-BY 4.0 para os dados e textos derivados, MIT para o código que os produziu. Ambas permitem uso comercial e redistribuição com atribuição.
Arquivos disponíveis
A v1 do estudo distribui sete arquivos derivados · três JSON otimizados para web, três CSV auditáveis, e um manifest com checksums. Todos vivem em public/data/susep/ no repositório do site, sincronizados via scripts/sync-susep-data.sh a partir do pipeline backstage.
JSON (web · agregados)
agg_annual_uf_ramo.json· prêmio direto, sinistro ocorrido, S/P por UF × ramo × ano (655 mil linhas após union runoff)agg_annual_ramo.json· agregação nacional por ramo × ano (consolidado contra Σ_uf)agg_annual_series.json· série temporal nacional por ramo (2014→2024 quando disponível)
CSV (auditáveis · pt-BR locale)
derived_earning_ratios.csv· loss ratio derivado com runoff union, separadores;decimal,(Excel pt-BR ready)fact_ganho_uf.csv· fato granular UF × ramo × mês × empresa cogrupo (655K linhas, R$ 473 bi totalizado)tables/*.csv· 9 tabelas individuais usadas em figuras do estudo, uma por gráfico
Manifesto
MANIFEST.md· lista todos os arquivos com SHA-256, data de extração, versão do pipeline gerador, e licença individual
Como usar
Para reproduzir uma análise
# clone backstage repo (pipeline + raw)
git clone https://github.com/Natan-Cardeal/panorama-susep.git
cd panorama-susep
make reproduce
# gera public/data/susep/* idêntico aos hashes em MANIFEST.md
Para citar em paper acadêmico
A versão atual é v1.0. Use o snapshot estável (commit 1e9bbbb) e referencie via DOI quando disponível em v1.1+. Antes disso, cite o commit hash diretamente.
Para incluir num dashboard ou relatório
Os JSONs estão otimizados pra fetch direto em browser (cache-busting via filename versionado). Use:
const data = await fetch("https://natancardeal.com/data/susep/agg_annual_uf_ramo.json").then(r => r.json())
A licença CC-BY 4.0 exige atribuição visível · se possível, link para natancardeal.com/pesquisa na nota de fonte.
Atualizações da base
A SUSEP atualiza SES tipicamente em ciclos trimestrais. O pipeline backstage roda manualmente a cada release do estudo (v1.0 capturou base atualizada até 2025-04-20). Releases futuras incluem:
- v1.1 · planejada para Q3 2025 · revisão metodológica + DOI Zenodo
- v1.2 · Q4 2025 · expansão para top-15 ramos
- v2 · 2026 · resseguro local (cobertura expandida do universo SES)
§ procedência
- fonte
- SUSEP · SES (Sistema de Estatísticas de Seguros)
- extração
- 2025-04-20
- pipeline
- panorama-susep v1.0 · commit 1e9bbbb
- licença
- CC-BY 4.0 · código MIT
Como citar o estudo
Modelos de referência nos formatos BibTeX, APA e ABNT. Clique em qualquer um para copiar. A citação inclui a URL da página em que você acessou os dados.
§ como citarexpandir
@misc{cardeal_panorama_susep_2026,
author = {Cardeal, Natan},
title = {Panorama SUSEP · Dados agregados v1.0 v1.0},
year = {2026},
publisher = {natancardeal.com},
url = {https://natancardeal.com},
note = {Acessado em AAAA-MM-DD}
}Cardeal, N. (2026). Panorama SUSEP · Dados agregados v1.0 v1.0. natancardeal.com. Recuperado em AAAA-MM-DD, de https://natancardeal.com
CARDEAL, Natan. Panorama SUSEP · Dados agregados v1.0 v1.0. Curitiba: natancardeal.com, 2026. Disponível em: https://natancardeal.com. Acesso em: AAAA-MM-DD.