Lista Nominal de Citopatológico - ImpulsoGov/bd GitHub Wiki

🔗 Links Importantes:

O fluxo atual para disponibilização da Lista Nominal de Citopatológico é representado pelo fluxograma abaixo: image

1. Código de Transmissão

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.

Estrutura do código

Denominador

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:

  1. dados_cidadao_pec

    Traz os dados das mulheres do município presentes na tabela tb_fat_cidadao_pec

  2. 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

Histórico de exames citopatológico

Duas subconsultas são realizadas:

  1. 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.
  1. selecao_ultimo_exame

Seleciona a partir do histórico anterior, o último exame realizado por cada mulher.

Vinculação

  1. cadastro_individual_recente

    Traz para as mulheres do denominador os dados do cadastro individual mais recente presentes na tabela tb_fat_cad_individual

  2. visita_domiciliar_recente

    Traz para as gestantes únicas identificadas os dados da visita domiciliar mais recente presentes na tabela tb_fat_visita_domiciliar

  3. cadastro_domiciliar_recente

    Traz para as mulheres do denominador os dados do cadastro individual mais recente presentes na tabela tb_fat_cad_dom_familia

  4. infos_mulheres_atendimento_individual_recente

Sumariza as informações das consultas anteriores para cada mulher do denominador

Regras de negócio

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

image

  • 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

image

Seleção Final

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

2. Unificação das transmissões por município

A view lista_nominal_citopatologico_unificada unifica todas as tabelas de lista_nominal_citopatologico por municipio

3. Lista final consumida no painel

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

Tabelas dimensã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
⚠️ **GitHub.com Fallback** ⚠️