io.github.pedropaulofernandes88-stack/saudeemdado

SITUAÇÃO ATUAL + boletim semanal. Use esta ferramenta para perguntas sobre o que está acontecendo AGORA ("como está a dengue esta semana?", "tem alerta no meu estado?") — é a única fonte de dado corrente aqui; todas as outras ferramentas são históricas (DataSUS consolidado até 2024). Campo `vigilancia_atual`: nowcasting semanal do InfoDengue (Fiocruz/FGV) para as 27 capitais — nível de alerta (1 verde, 2 amarelo, 3 laranja, 4 vermelho), Rt (>1 = transmissão crescendo), casos notificados vs. ESTIMADOS (o estimado corrige o atraso de digitação; nunca cite só o notificado da semana corrente, ele subestima). Cobre dengue e chikungunya. Traz também as seções históricas: canal endêmico Brasil, excesso de mortalidade e KPIs de internações. Sem argumento retorna a edição mais recente; edicao no formato '2026-se30' retorna uma específica. Ao citar a vigilância, credite InfoDengue (Fiocruz/FGV), não o DataSUS.

ANÁLISE: canal endêmico de dengue de uma UF (diagrama de controle). Compara os casos semanais do ano observado com a faixa esperada (quartis P25–P75 das mesmas semanas nos anos anteriores, 2015+, excluindo o ano observado). Retorna a banda semana a semana, quantas semanas ficaram acima do P75 (sinal de surto) e o status. Semanas acima ≥13 (um trimestre) = surto prolongado.

ANÁLISE: compara um município (6 dígitos) com seus PARES — municípios do mesmo arquétipo de saúde (k-means: mortalidade × vulnerabilidade × internações, 2023). Retorna, para cada métrica, o valor do município, a mediana dos pares e o percentil do município no grupo (0–100; alto = pior em mortalidade/vulnerabilidade). Comparação legítima: pares têm perfil estrutural semelhante, não só a mesma UF. Cobre ~1.700 municípios maiores; nos demais, retorna aviso.

Dengue (SINAN) por município/ano: casos prováveis, graves, óbitos, incidência/100k e letalidade. 2024 foi epidemia recorde (6,56 milhões de casos).

Dengue (SINAN) por semana epidemiológica de uma UF/ano — curvas sazonais e picos.

Descrições oficiais de categorias CID-10 de 3 caracteres (ex.: I21, C34).

COPILOTO: dado um município (6 dígitos), retorna um resumo priorizado de sinais — confiabilidade do registro, ICSAP vs. média nacional (~21%), e letalidade de dengue — para um briefing de gestor. Cada sinal traz o valor e a fonte; interprete com as regras de uso (sem causalidade; sinalizar baixa confiabilidade). O sinal `icsap` NÃO afirma nada sobre a atenção primária: ele vem acompanhado da oferta de leitos do próprio município justamente porque a associação medida entre leito local e %ICSAP é positiva e forte (§19). Relate os dois juntos ou não relate nenhum.

Excesso de mortalidade mensal (2020+) por UF ou BR (Brasil): observado, esperado (baseline por TENDÊNCIA linear 2015–2019, que capta o envelhecimento), excesso e %. Pico pandêmico Brasil 2020–2021 ≈ 643 mil; 2024 ≈ zero (preliminar).

Para onde os moradores de um município viajam para se internar (SIH 2024, fluxos ≥ 5). Revela dependência de polos regionais e evasão da rede local. Informe o código de 6 dígitos do município de residência.

Visão por estabelecimento (CNES), 2024: volume, permanência, mortalidade, custo e capítulo predominante. ordenar_por: internacoes | mortalidade_pct | permanencia_media | custo_medio. Mortalidade é BRUTA (sem ajuste de risco/case-mix) — não comparar como qualidade. Sem nome do estabelecimento (só CNES).

TRADUÇÃO: converte o indicador ICSAP na pergunta do gestor — "quanto meu município está acima de municípios COMPARÁVEIS em internações evitáveis, e o que isso representa?". Informe municipio_cod (6 dígitos) OU uf (ranking dos maiores). Retorna: pct_icsap do município, mediana dos pares, diferença em pontos percentuais, e a tradução — internacoes_acima_pares, leitos_equivalentes_ano (leitos que ficariam ocupados o ano inteiro) e custo_associado_reais. Pares = municípios do mesmo arquétipo k-means; sem arquétipo, mesma faixa populacional e região. Comparar com a média nacional seria injusto. AO RELATAR, estas ressalvas são obrigatórias — sem elas o número engana: 1. NÃO é economia disponível. Chegar à mediana exige INVESTIR em atenção primária, não cortar; o valor mede o tamanho do problema, não caixa a resgatar. 2. Nem toda ICSAP é evitável — a Lista Brasileira reúne condições SENSÍVEIS à atenção primária; boa cobertura reduz, não zera. Por isso a referência é a mediana dos pares, nunca zero. 3. Associação ECOLÓGICA (municipal): não é risco individual nem prova de causa. 4. O %ICSAP responde à OFERTA HOSPITALAR LOCAL, e o efeito é grande — medido, não suposto (§19). Esta ressalva já foi o oposto disto ("onde falta leito, a eletiva some e a fatia de ICSAP sobe"); a hipótese foi testada contra os leitos do CNES e REFUTADA na direção e no mecanismo. O que vale: municípios SEM leito local têm %ICSAP MENOR (17,7% vs. 21,4%), e a presença de leito aumenta a internação por ICSAP em +51% a +85% conforme o porte, sem alterar as demais — é o numerador que cresce. Quem abre um hospital pequeno vê o %ICSAP SUBIR sem ter piorado a APS. Nunca conclua "atenção primária frágil" a partir deste número; cruze com oferta hospitalar, porte e cobertura privada antes de qualquer leitura. 5. O custo em reais é TETO: deriva de 6 agravos traçadores que pendem para o lado caro da lista (AVC e ICC), sem as condições baratas (gastroenterite, infecção urin…

ICSAP — internações por condições sensíveis à atenção primária, por município (2024): total, ICSAP, % e por 100k hab. NÃO LEIA %ICSAP COMO QUALIDADE DA ATENÇÃO BÁSICA. Medido nesta plataforma (§19 da metodologia, 5.570 municípios, 2024): a correlação com leitos SUS/mil é POSITIVA (ρ=+0,32), e municípios sem leito local têm %ICSAP MENOR (17,7%) que os com leito (21,4%) — ter leito local aumenta a internação sensível em +51% a +85% conforme o porte, sem mexer nas demais. O indicador mede, em parte relevante, a EXISTÊNCIA DE LEITO na cidade. Proporção alta é sinal que exige comparação com oferta hospitalar, porte, cobertura privada e pares — nunca conclusão sobre a APS. É indicador de sistema, não de 'má gestão' local.

Internações SUS (SIH/AIH) por município: volume, permanência média, mortalidade intra-hospitalar (%) e custo médio (R$). Cobre só a rede SUS. AIH != internacao != paciente: `internacoes` conta AIHs APROVADAS (producao), incluindo a AIH de continuacao emitida quando a internacao se prolonga. `permanencia_media` e `custo_medio` sao por EPISODIO, calculados sobre `aih_normal` (= internacoes - aih_continuacao). Nos capitulos V (transtornos mentais, 25% de continuacao) e VI (sistema nervoso, 10%) os dois numeros divergem muito; nos outros, quase nada.

Internações por agravo traçador (CID-3), por município (2024): diabetes, avc, iam, icc, asma, dpoc, pneumonia, depressao, esquizofrenia, alcool_drogas, tce. agravo vazio = todos. Traz permanência, mortalidade e custo por agravo. ATENÇÃO nos agravos de saúde mental (depressao, esquizofrenia, alcool_drogas): são do capítulo V, onde 25% das AIHs são de CONTINUAÇÃO de uma internação longa. `internacoes` conta AIHs aprovadas; `permanencia_media` e `custo_medio` usam `aih_normal`. Não apresente `internacoes` como número de pacientes nem como número de episódios.

Fontes, metodologia resumida, exclusões, licença, DOI e versão do dataset.

Indicadores municipais: óbitos, taxa bruta/100k com IC95% e taxa padronizada por idade (taxa_padronizada_100k — use esta para comparar municípios).

Principais causas básicas de óbito (CID-10, 3 caracteres) no Brasil (uf vazio) ou UF. Atenção: R99 = causa mal-definida (ausência de diagnóstico), não é doença.

CONFIABILIDADE do registro de óbitos (2022–2024): % de causas mal-definidas e classe (Bom <5% | Regular 5–10% | Ruim >10%). Consulte ANTES de afirmar causas de morte de um município. Informe municipio_cod (6 dígitos) OU uf.

Série mensal de óbitos 2015–2024. uf vazio = todas as UFs (some para o Brasil). capitulo_cid: I a XXII ou TOTAL (IX = circulatório, X = respiratório, II = neoplasias).