Skip to content

O GovInsights é uma plataforma que facilita o acesso a dados financeiros públicos, com foco inicial no IPEA, usando dashboards interativos e relatórios com linguagem natural para promover transparência e apoiar decisões.

License

Notifications You must be signed in to change notification settings

unb-mds/2025-1-GovInsights

Repository files navigation

image

Git Pages
Acesse o Sistema

📚 Projeto

Desenvolvido para a disciplina Métodos de Desenvolvimento de Software - 2025/1.


O GovInsights é uma plataforma de análise e visualização de dados financeiros públicos, focada inicialmente nos dados do IPEA.
O projeto busca democratizar o acesso às informações públicas através de relatórios inteligentes e dashboards interativos, utilizando processamento de linguagem natural e visualizações dinâmicas para facilitar a tomada de decisão e promover a transparência governamental.


📌 Objetivos

  • Automatizar a coleta e análise de dados financeiros públicos.
  • Facilitar o acesso à informação através de visualizações e relatórios interativos.
  • Aplicar análise de sentimentos e identificação de tópicos em notícias relacionadas.
  • Estimular a transparência, a cidadania ativa e o uso de dados públicos.
  • Promover boas práticas de desenvolvimento ágil e colaborativo utilizando GitHub e metodologias ágeis.

⚙️ Tecnologias Utilizadas

  • Backend: Python 3.x
  • Frontend: Streamlit
  • Modelo de NLP: DeepSeek-R1-Distill-Llama-70B-free via API do Together AI
  • Bibliotecas: pandas 2.2.3, plotly 6.0.1, requests 2.32.3
  • Deploy: Streamlit Deploy, Git Pages

Collaborators

O projeto é desenvolvido pelos seguintes integrantes:

Papel Responsáveis Atividades Principais
Stakeholders Eric, Brenda e Maria Eduarda Validação dos requisitos e avaliação dos resultados
Product Owner Brenda Priorização de funcionalidades, gestão do backlog
FrontEnd Eduarda e Mayra Desenvolvimento da identidade visual, telas (Login, Exportação, Landing Page), integração Streamlit + HTML/CSS
BackEnd Marjorie, Guilherme e Gabriel Integração da API IPEA, coleta de dados, implementação dos métodos GET e POST
Gestão de Projetos Eric, Brenda e Maria Eduarda Cronograma, controle de sprints, revisão de branches e suporte de gestão ágil
Usuário Final Público geral e servidores públicos Consumo dos relatórios gerados e análise dos indicadores

Eric Gomes
Eric Gomes de Araujo
Mayra Lithuania
Mayra Lithuania
Brenda Beatriz
Brenda Beatriz
Guilherme Flyan
Guilherme Flyan
Eduarda Rodrigues
Eduarda Rodrigues
Maria Eduarda
Maria Eduarda
Gabriel Maciel
Gabriel Maciel
Marjorie Mitzi
Marjorie Mitzi

🤝 Como Contribuir

Quer contribuir? Siga os passos:

  1. Leia a documentação disponível.
  2. Crie uma issue para reportar problemas ou sugerir melhorias.
  3. Faça um fork e crie uma branch específica:
git checkout -b feature/nome-da-sua-feature
  1. Realize o desenvolvimento seguindo o padrão do projeto.
  2. Envie seu Pull Request para revisão.

Regras:

  • Siga o padrão de commits.
  • Atualize a documentação sempre que necessário.
  • Seja colaborativo e respeitoso.

Como começar

Instalando Python 3

No Windows

No Linux

  • No Linux, é necessário instalar os pacotes de desenvolvimento do Python. Utilize o seguinte comando:
sudo apt install python3-dev python3-pip python3-venv

Clonando repositório

  • Clone o repositório utilizando o comando:
git clone https://github.com/unb-mds/2025-1-GovInsights.git

Criando e ativando um ambiente virtual do Python

  • Vá a pasta do repositório
cd 2025-1-GovInsights
  • Crie um ambiente virtual do Python
python -m venv venv
  • Ative o ambiente virtual
# No Windows
venv\Scripts\activate.bat
# No Linux
source ./venv/bin/activate

Instalando pré-requisitos

  • Atualize a versão do pip
# No Windows
python -m pip install -U pip
# No Linux
python3 -m pip install --upgrade pip
  • Instale as dependências do projeto com o comando:
 pip install -r requirements.txt 
  • Execute o sistema a partir da pasta src
streamlit run .\src\main.py

📈 Dados Utilizados

Os dados utilizados no projeto GovInsights serão extraídos de fontes públicas confiáveis, como o portal oficial do IPEA e outras fontes governamentais de transparência.


🌐 Acesso ao Projeto

  • A documentação será hospedada no GitHub Pages. (Em construção)
  • O site de visualização será hospedado futuramente na ferramenta de deploy do Streamlit.

🔨 Ferramentas e Recursos

  • 🎨 Protótipos no Figma
  • 🧠 Planejamento no Notion
  • 📋 Backlog de Desenvolvimento GitHub Projects
  • 🏧 Arquitetura Técnica (em documentação)

📞 Contato

Dúvidas ou sugestões?
Entre em contato pelo e-mail: 📩 govinsights.project@gmail.com


📜 Histórico de Versões

Versão Data Descrição Autor Revisor
0.1.0 20/04/2025 Estrutura inicial do README Eric Gomes Eric Gomes
0.1.1 27/04/2025 Adição de seções e padronização Brenda Brenda
0.1.2 08/05/2025 Adição de "Como contribuir" Eric Maria Eduarda

About

O GovInsights é uma plataforma que facilita o acesso a dados financeiros públicos, com foco inicial no IPEA, usando dashboards interativos e relatórios com linguagem natural para promover transparência e apoiar decisões.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 11