Lista Nominal de Citopatológico - ImpulsoGov/bd GitHub Wiki
🔗 Links Importantes:
- Indicador 4 : Proporção de mulheres com coleta de citopatológico na APS -NOTA TÉCNICA Nº 16/2022-SAPS/MS
O fluxo atual para disponibilização da Lista Nominal de Citopatológico é representado pelo fluxograma abaixo:
O resultado do código executado durante a transmissão é armazenado para cada município na tabela lista_nominal_citopatologico
No código de transmissãosão adicionadas as principais regras de negócio da Lista Nominal de Ciropatológico.
A seleção do denominador abrange os dados de todas as mulheres do município que .
São feitas duas subconsultas para compor o denominador:
-
dados_cidadao_pec
Traz os dados das mulheres do município presentes na tabela
tb_fat_cidadao_pec
-
selecao_mulheres_denominador
Traz dados das mulheres que façam parte da faixa etária do indicador durante o quadrimestre, ou seja, as mulheres cuja idade no final do quadrimestre esteja compreendida entre 25 e 64 anos.
🗨️ A idenficação de cada mulher é feita pelo campo criado chave_mulher
que agrega o nome da mulher (no_cidadao
) e sua data de nascimento (co_dim_tempo_nascimento
) presentes na tabela tb_fat_cidadao_pec
Duas subconsultas são realizadas:
- historico_exames_citopatologico
Consulta que traz todos os exames citopatológicos realizados pelas mulheres do município, a partir dos registros da tabela tb_fat_proced_atend_proced
, cujos códigos CID/CIAP (nu_cid
e nu_ciap
) registrados sejam os códigos considerados pra atendimentos de pré-natal conforme nota técnica do indicador. O mesmo vale para as famílias de CBOS dos profissionais (nu_cbo
)
-
Filtros:
Famílias CBO consideradas para o procedimento:
- enfermeiro (2235);
- médico (2251, 2252, 2253, 2231)
Código para o registro do procedimento:
- SIGTAP 02.01.02.003 -3 – Coleta de Material p/ exame citopatológico do colo uterino
- Código Rápido = ABPG010 referente ao código ativado quando o campo rápido da Ficha CDS é preenchido (conforme Guia de Qualificação Thrift.
- selecao_ultimo_exame
Seleciona a partir do histórico anterior, o último exame realizado por cada mulher.
-
cadastro_individual_recente
Traz para as mulheres do denominador os dados do cadastro individual mais recente presentes na tabela
tb_fat_cad_individual
-
visita_domiciliar_recente
Traz para as gestantes únicas identificadas os dados da visita domiciliar mais recente presentes na tabela
tb_fat_visita_domiciliar
-
cadastro_domiciliar_recente
Traz para as mulheres do denominador os dados do cadastro individual mais recente presentes na tabela
tb_fat_cad_dom_familia
-
infos_mulheres_atendimento_individual_recente
Sumariza as informações das consultas anteriores para cada mulher do denominador
A subconsulta indicador_regras_de_negocio adiciona algumas regras de negócio da Lista Nominal de Citopatológico:
-
Data projetada do próximo exame:
Campo:
ultimo_exame_mais_36_meses
Projeção da data limite de realização do próximo exame, considerando que o mesmo tem validade de 36 meses. Retorna a data de realização do último exame, somados os 36 meses.
Exemplo:
- Data de realização do último exame: 2022-12-05
- Acrescentando 36 meses: 2025-12-04
-
Data limite a realizar próximo exame:
- Caso a mulher nunca tenha realizado o exame: data limite é igual ao último dia do quadrimestre atual
- Caso a mulher esteja com o exame vencido: data limite é igual ao último dia do quadrimestre atual
- Caso a mulher esteja com o exame em dia: data limite é a data do último exame acrescidos 36 meses
- Caso a mulher esteja com o exame em dia mas o exame vença durante o quadrimestre atual: data limite é igual ao último dia do quadrimestre atual
- Caso a mulher tenha realizado o exame antes dos 25 anos (exame não contabilizado para o indicador): data limite é igual ao último dia do quadrimestre atual
-
Status do exame:
Campo
status_exame
: Indica o status atual em relação à realização do exame da mulher:-
exame_realizado_antes_dos_25
: se a mulher realizou o exame antes dos 25 anos -
exame_nunca_realizado
: se a mulher nunca realizou o exame -
exame_em_dia
: se a mulher realizou o exame nos últimos 36 meses -
exame_vencido
: se a mulher realizou o último exame há mais de 36 meses -
exame_vence_no_quadrimestre_atual
: se a mulher está com o exame em dia mas se o mesmo perde a validade no quadrimestre corrente
-
A seleção final é armazenada na tabela com a seguinte estrutura:
coluna | tipo | descrição |
---|---|---|
municipio_id_sus | varchar(6) | Identificador SUS do município |
quadrimestre_atual | text | Quadrimestre atual |
chave_mulher | varchar(500) | Chave identificadora da paciente |
paciente_nome | varchar(500) | Nome da paciente |
cidadao_cns | varchar(30) | Número de CNS da paciente |
cidadao_cpf | varchar(500) | Número de CPF da paciente |
paciente_idade_atual | int8 | Idade atual da paciente |
dt_nascimento | date | Data de nascimento da paciente |
dt_ultimo_exame | date | Data de realização do último exame citopatológico |
realizou_exame_ultimos_36_meses | bool | Se a paciente realizou ou não exame nos últimos 36 meses |
data_projetada_proximo_exame | date | Data do último exame acrescidos 36 meses |
status_exame | varchar(50) | Status atual de realização do exame da paciente |
data_limite_a_realizar_proximo_exame | date | Data limite para realizar próximo exame |
cnes_estabelecimento_exame | varchar(30) | CNES do estabelecimento do último exame realizado |
nome_estabelecimento_exame | varchar(500) | Nome do estabelecimento do último exame realizado |
ine_equipe_exame | varchar(30) | INE do estabelecimento do último exame realizado |
nome_equipe_exame | varchar(500) | Nome da equipe do último exame realizado |
nome_profissional_exame | varchar(500) | Nome do profissional que realizou o último exame |
dt_ultimo_cadastro | date | Data do último cadastro individual |
estabelecimento_nome_cadastro | varchar(500) | Nome do estabelecimento de saúde do último cadastro individual |
estabelecimento_cnes_cadastro | varchar(30) | Código CNES do estabelecimento de saúde do último cadastro individual |
equipe_ine_cadastro | varchar(30) | Código INE da equipe do último cadastro individual |
equipe_nome_cadastro | varchar(500) | Nome da equipe do último cadastro individual |
acs_nome_cadastro | varchar(500) | Nome do ACS do último cadastro individual |
dt_ultimo_atendimento | date | Data do último atendimento realizado |
estabelecimento_nome_ultimo_atendimento | varchar(500) | Nome do estabelecimento do último atendimento realizado |
estabelecimento_cnes_ultimo_atendimento | varchar(30) | Código CNES do último estabelecimento realizado |
equipe_ine_ultimo_atendimento | varchar(30) | Código INE do último estabelecimento realizado |
equipe_nome_ultimo_atendimento | varchar(500) | Nome da equipe do último atendimento realizado |
acs_nome_ultimo_atendimento | varchar(500) | Nome do ACS do último atendimento realizado |
acs_nome_visita | varchar(500) | Nome do ACS da última visita domiciliar |
criacao_data | timestamptz | Data e hora de criação do registro |
atualizacao_data | timestamptz | Data e hora de atualização da informação |
A view lista_nominal_citopatologico_unificada
unifica todas as tabelas de lista_nominal_citopatologico
por municipio
O código da view painel_citopatologico_lista_nominal
traz a estrutura da tabela final que é consumida no painel da Lista Nominal de Citopatológico (armazenada na tabela de mesmo nome em nosso banco de produção). Faz algumas transformações nos campos de status (id_status_usuario
) e faixa etária (id_faixa_etaria
) para cruzá-los con informações presentes em tabelas dimensões (representadas abaixo) com informações de status e faixa etária (visando otimizar o desenvolvimento backed da lista)
🗨️ Apesar de definir agrupamentos de faixa etária par ao indicador, atualmente não utilizamos os mesmos no painel para fazer nenhum tipo de priorização relacionada.
coluna | tipo | descrição |
---|---|---|
municipio_id_sus | varchar | Identificador SUS do município |
municipio_uf | text | Município e UF |
paciente_nome | text | Nome da paciente |
cidadao_cpf_dt_nascimento | text | CPF ou data de nascimento da paciente |
vencimento_da_coleta | text | Data de vencimento do último exame |
prazo_proxima_coleta | text | Data limite para realizar o próximo exame |
idade | int8 | Idade atual da paciente |
acs_nome | text | Nome do ACS vinculado à paciente |
estabelecimento_cnes | varchar | CNES do estabelecimento de vinculação da paciente |
estabelecimento_nome | varchar | Nome do estabelecimento de vinculação da paciente |
equipe_ine | varchar | INE de vinculação da paciente |
ine_master | text | INE criado para os municípios onde as coordenadoras precisam visualizar mais de uma equipe no painel |
equipe_nome | text | Nome da equipe de vinculação da paciente |
id_status_usuario | int4 | Id de status da paciente |
id_faixa_etaria | int4 | Id da faixa etária da paciente |
criacao_data | timestamptz | Data de criação do registro de transmissão |
atualizacao_data | timestamptz | Data de atualização da informação |
Em nosso banco de produção, consultamos as seguintes tabelas dimensão:
-
status_acompanhamento_usuario: para a lista de citopatológico utilizamos os seguintes status:
id_status_usuario status_usuario_descricao 12 Coleta em dia 13 Nunca realizou coleta 14 Coleta com menos de 25 anos 15 Vence no final do quadrimestre 16 Coleta vencida - faixa_etarias: para a lista de citopatológico utilizamos as seguintes faixas etarias:
id_faixa_etaria status_usuario_descricao 6 25 a 39 anos 7 40 a 49 anos 8 50 a 64 anos