Metodologia · Rota Oncológica

Uma cadeia verificável

Fonte → curadoria → métrica → evidência → publicação → consulta → página

Indicadores são calculados por código versionado. A página mostra resultados já calculados; não preenche lacunas nem inventa relações entre as bases.

Examinar fontes e versões ↗

Seis cuidados ao ler os números

Cadastro não é operação

Um registro no CNES não comprova que o serviço funciona, que atende ou que tem vaga.

Produção não é paciente

As quantidades registradas podem conter procedimentos repetidos. Não equivalem automaticamente a pessoas únicas.

Habilitação não é oferta efetiva

Uma habilitação é um documento. Ele não confirma que o serviço esteja disponível no dia da consulta.

Ausência não é zero

Sem abrangência suficiente, o resultado fica sem dado. Zero exige um universo observado e uma regra explícita.

Sinal não é conclusão

Um sinal detectado exige investigação, contraevidências e revisão humana antes de uma conclusão validada.

Fluxo não é encaminhamento

Totais por residência e por atendimento não comprovam referência formal nem trajetória individual.

Territórios e períodos de referência

Município, região imediata do IBGE, região de saúde e agrupamento editorial são conceitos diferentes. Quando não há associação sanitária validada, o portal não a presume.

Cada fonte tem seu próprio período de referência. A data em que a publicação foi gerada não é a data de todos os dados.

Métricas desta versão

regional_resolution_rate

Pergunta: do universo observado, qual proporção foi atendida dentro do recorte regional definido? numerador = quantidade com território de atendimento dentro da região denominador = quantidade total do universo observado para residentes da região resultado = numerador / denominador Dimensões: - período; - etapa/modalidade/procedimento; - território de residência; - região analítica. Limitações: - mede registros observados, não necessidade total; - depende da qualidade da dimensão residência/atendimento; - não implica qualidade do cuidado.

external_dependency_rate

Complemento da resolutividade para o mesmo universo: quantidade atendida fora da região / quantidade total observada Não usar como sinônimo automático de “problema”: regionalização do SUS pode prever referências externas legítimas.

flow_volume

Quantidade observada entre origem e destino para período e recorte definidos. Chave lógica: period + residence_territory + care_territory + ontology_item

capacity_presence

Flag/contagem de capacidade cadastrada por competência a partir de CNES ou fonte explicitamente definida. Uso: mapa/inventário e Evidence Engine. Limitação obrigatória: cadastro não comprova funcionamento efetivo.

production_volume

Quantidade de procedimentos/atendimentos registrados para conjunto explícito de códigos e fonte. A métrica deve registrar a versão da ontologia que selecionou os códigos.

capacity_production_signal

Não é indicador de desempenho; é um sinal de investigação. Exemplo inicial: capacity_presence = true AND production_volume abaixo de limiar definido por regra → signal O limiar não pode ser escolhido ad hoc para cada município; deve ser regra versionada ou comparação transparente.

diagnosis_to_first_treatment_time

Métrica baseada na metodologia oficial do Painel-Oncologia. Objetivo: apresentar distribuição/estratos do intervalo entre diagnóstico e primeiro tratamento conforme a fonte permite. Fonte primária de metodologia: - Ministério da Saúde / CGCAN / Painel-Oncologia. Requisitos: - não reinterpretar como incidência; - manter as categorias de tempo oficiais quando possível; - declarar quais registros entram no universo; - não comparar períodos sem verificar mudanças metodológicas.

data_freshness_days

Dias entre data de referência/publicação conhecida e data corrente do produto. Uso: transparência operacional, não saúde. Estados sugeridos: - current; - delayed; - stale; - unknown. Os thresholds são específicos por fonte, porque periodicidade difere.

source_coverage

Percentual de células/entidades do recorte para as quais a fonte esperada foi carregada e passou nos quality gates. Uso: indicar completude do produto e evitar que ausência de dado seja lida como zero.

Publicação e revisão

Uma publicação ativa pode ser uma prévia de trabalho. Publicar exige uma versão autorizada, sem dados sintéticos de teste, com integridade verificada e revisão registrada. Sem essa autorização, o site não exibe os números da prévia.

Privacidade e acessibilidade

O portal trabalha com dados agregados e não solicita informações de pacientes. Gráficos oferecem alternativas em tabelas; controles mantêm navegação por teclado, foco visível e preferência por movimento reduzido.

Adotamos WCAG 2.2 AA como meta. Testes automatizados são evidência parcial e não substituem avaliação assistiva e revisão humana.

Consultar WCAG 2.2 no W3C ↗