Atzingen commented 12 months ago

Processo de automação do deploy da página web de documentação do modelo dimensional do powerbi da PNP.

A documentação está no repositóro wwwDocPBI e é apresentada em uma página web, contendo um arquivo principal (index.html) e os componentes estáticos (js, css e imagens) dentro da página static. Todo o conteúdo é servido via nginx, e para garantir a funcionalidade independente da plataforma onde é feito o deploy, um container docker é instanciado com as informações contidas no readme do repositório.

Todo o conteúdo web da documentação é gerado automaticamente via extração dos dados do arquivo do powerbi no formato pbit. Futuras formas de extração via .pbib e conexão xmla estão sendo estudadas. Atualmente o respositório responsável pela extração dos dados é o DocPBI e além da extração existe uma funcionalidade que alimenta automaticamente o wwwDocPBI.

Pesquisador

@Atzingen

Problema Crítico

Apresentar ao público informações sobre o modelo de dados e tabelas utilizadas nas visualizações da PNP.

Meta do Plano de Trabalho

Esta Issue está associada a meta **07 do Plano de Trabalho do Termo de Execução Descentralizada

Desenvolvimento de solução para autodocumentação de plataforma analítica.**

A meta propõe disponibilizar documentação detalhada e atualizada sobre a estrutura, origem dos dados, bem como as transformações e cálculos aplicados nas análises. Isso proporcionará maior transparência e compreensão dos dados, facilitando a colaboração e o compartilhamento de conhecimento entre equipes de trabalho, gestores da Rede Federal e usuários da plataforma.

Como pretende resolver o problema

A documentação automática já foi realizada em 2022 porém os itens abaixo são aprimoramentos para garantir a qualidade da entrega além da automatização do processo.

Documentação (DocPBI)

[ ] #66
[ ] #67
[ ] #68
[ ] #69
[x] #70
[ ] #106
[ ] #75
[ ] #72
[ ] #73
[ ] #74

chatPNP

[x] #76
[x] #107
[x] #112
[ ] #113
[ ] #114
[ ] #115
[ ] #116
[ ] #117

Monitoramento de uso

[x] #108
[x] #77
[x] #109
[x] #110
[x] #111
[x] #142
[ ] #143
[x] #144
[ ] #145
[ ] #146

Outras atividades

[ ] Avaliar viabilidade de ETL via github Actions.
[ ] Avaliar mover extração do pentaho para Python.

Recursos Necessários

Acesso a gitlab do mec.
Máquina Virtual ou Processo Serverless em um provedor de cloud (GCS, AWS ou Azure)

Entregáveis do Plano de Trabalho

[ ] 📈 ChatPNP.
[ ] 📊 Monitoramento dos acessos e experiência do usuário.
[ ] 📢 Documentação do modelo de dados da PNP via XMLA.

potyrlucena commented 12 months ago

Uoww! Muito bom. Se quiser pode alterar a lista dos entregáveis. As opções que coloquei foram somente a título de exemplo. Parabéns pela entrega!

Atzingen commented 10 months ago

Uoww! Muito bom. Se quiser pode alterar a lista dos entregáveis. As opções que coloquei foram somente a título de exemplo. Parabéns pela entrega!

Alterado. Também separei cada um deles em uma milestone, para facilidar a visualização e controle na aba do kanban do projeto.

potyrlucena commented 10 months ago

Ficou muito massa! Você tá um foguete!

Rede-DSBR / PNP

📑 Plano Individual de Trabalho - Gustavo Voltani von Atzingen #65