https://github.com/unb-mds/2025-1-govinsights
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.
https://github.com/unb-mds/2025-1-govinsights
dados ipea opensource python streamlit
Last synced: 8 months ago
JSON representation
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.
- Host: GitHub
- URL: https://github.com/unb-mds/2025-1-govinsights
- Owner: unb-mds
- License: mit
- Created: 2025-03-29T12:14:58.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-07-07T13:16:58.000Z (11 months ago)
- Last Synced: 2025-07-07T13:55:00.506Z (11 months ago)
- Topics: dados, ipea, opensource, python, streamlit
- Language: Python
- Homepage: https://unb-mds.github.io/2025-1-GovInsights/
- Size: 36.7 MB
- Stars: 3
- Watchers: 2
- Forks: 2
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## 📚 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 de Araujo
Mayra Lithuania
Brenda Beatriz
Guilherme Flyan
Eduarda Rodrigues
Maria Eduarda
Gabriel Maciel
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:
```bash
git checkout -b feature/nome-da-sua-feature
```
4. Realize o desenvolvimento seguindo o padrão do projeto.
5. 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
- Baixe e instale o [Python 3]([Download Python | Python.org](https://www.python.org/getit/)).
### 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](https://www.figma.com/team_invite/redeem/JtjJg0xfYUI6RE1FBSzOlM)
- 🧠 Planejamento no [Notion](https://www.notion.so/invite/6e431a0cfdbcdfadde473e1e02023c52e89070ee)
- 📋 Backlog de Desenvolvimento [GitHub Projects](https://github.com/unb-mds/2025-1-Squad10/projects?query=is%3Aopen)
- 🏧 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 |
---