Cria tabela de referência para listagem de períodos ausentes no painel

[fernandesbrun]

Descrição de contexto

É comum que municípios possuam problemas de registro em meses específicos, realizando o envio de dados com algum estabelecimento faltante ou não realizando o envio, resultando na ausência completa de um ou mais estabelecimentos nas tabelas baixadas via ETL e armazenadas em dados_publicos.

Ao executar o DBT para gerar as tabelas de indicadores, utilizando como fonte de dados as tabelas armazenadas em dados_publicos, o resultado final apresenta a total ausência de competências inteiras, quando o caso é o mencionado anteriormente (ausência completa de envio de dados naquele mês específico). Quando isso acontece, a competência em questão por completo não aparece no painel de indicadores

Por que isso é um problema?

A primeira vista, a ausência de competências deixa ao usuário final a percepção de que o painel está incompleto, que essas competências não foram inseridas no site pela Impulso.

Manter sempre visível todas as competências, mesmo quando zeradas, devolve o problema ao usuário final: se o dado está zerado na plataforma, fica mais fácil entender que ele é um problema de registro e não da plataforma em si.

Apesar do problema ter sido observado durante teste para liberação da plataforma ao município de Monteiro, é imprescindível entender que esse comportamento de dados pode estar ocorrendo para qualquer município/estabelecimento em qualquer competência passada, e pode vir a ocorrer em qualquer competência futura, uma vez que o que gera a ausência completa de uma competência no indicador final é fruto da ausência total de registros baixados para aquela mesma competência.

Objetivo

O objetivo desse PR consiste na criação de uma tabela de referência (TR) que contem o indicativo (para cada uma das tabelas de indicadores utilizada pela API para preencher os filtros de períodos) de qual o município, estabelecimento e período que falta dados.

• Para a listagem de períodos que deveriam ter dados por município/estabelecimento (independente de terem tido envios de dados ou não) foi utilizado como referência os estabelecimentos habilitados como CAPS para cada competência, em conjunto com a listagem de unidades federativas que tiveram ao menos um procedimento registrado em RAAS.

Obs: É a partir da TR que será inserido via modificações no front o estabelecimento e a competência nos filtros do painel, além de um texto indicativo quando essa combinação estabelecimento x filtro for selecionada.

feat: ✨ Cria modelo que identifica competências sem registro por município, estabelecimento e período

feat: ✨ Adiciona fonte de dados de habilitações

Objetivos secundários

• Garantir que a TR mostre texto de Último período na coluna periodo sempre que realmente for o último período de dados que está faltando para aquele município (ou seja, que o pacote estadual de dados mais recente foi baixado, mas o município em questão não apresentou produção na competência).
• Garantir que as Tabelas de Indicadores (TI) mostrem o texto Último período apenas quando realmente for o último período real (considerando o último processamento de dados estatal).
  • No formato anterior, o texto Último período era inserido nas TIs selecionando o último período presente na tabela, por município. Ou seja, antes da modificação, caso a última competência estatal fosse fev/24, mas o município tivesse deixado de enviar dados em fev/24 e jan/24, o texto Último período apareceria no mês de dez/23. Com a alteração, o texto não aparecerá para esses casos.

fix: ✨ Altera macros para inserir texto 'Último período' apenas quando for o real último período do estado

refactor: ♻️ Altera modelo de resumo de CAPS para não utilizar como critério de filtragem texto de período

fix: 🐛 Remove trecho de código que limita municípios/remove estabelecimentos para evitar bug em indicador de internação

fix: 🐛 Corrige bug para tabelas de coortes de adesão