README.md

Projeto de Integração de Dados do IBGE e InfoDengue

Este projeto consiste em uma aplicação Python para extrair dados de municípios brasileiros do Instituto Brasileiro de Geografia e Estatística (IBGE) e dados de casos de dengue do sistema InfoDengue. Os dados são então transformados e carregados em um banco de dados PostgreSQL para análise posterior e criação de um dashboard. Foi utilizado o Streamlit para criar um dashboard interativo para monitoramento epidemiológico no Brasil.

Diagrama

Referência

• Municipios IBGE
• InfoDengue

Estrutura

- src
    - img
      - dengue.png
    - pipeline
      - extract.py
      - load.py
      - main.py
      - transform.py
  - app.py
  - charts.py
  - load_app.py
- .env
- .python-version
- docker-compose.yml
- Dockerfile
- poetry.lock
- pyproject.toml

Funcionalidades

• Extrair dados do IBGE: Busca dados de municípios brasileiros na API do IBGE.
• Extrair dados de dengue: Busca dados de casos de dengue para cada município na API do InfoDengue.
• Transformar dados: Transforma os dados brutos em estruturas de dados adequadas para análise.
• Carregar dados: Carrega os dados transformados em um banco de dados PostgreSQL.
• Pipeline: Faz o processo de Extração, Transformação e Carga dos dados (ETL).
• Dashboard: Visualização dos dados epidemiológicos de dengue.

Requisitos

• Python
• Poetry
• Docker

Instalação

1. Clone este repositório:

   git clone https://github.com/rhanyele/ibge-dengue-data-integration.git

2. Acesse o diretório do projeto:

   cd ibge-dengue-data-integration

3. Instale as dependências usando Poetry:

   poetry install

4. Configure as variáveis de ambiente no arquivo .env com as informações do seu banco de dados PostgreSQL:

   DB_HOST=seu_host
   DB_PORT=sua_porta
   DB_NAME=seu_banco_de_dados
   DB_USER=seu_usuario
   DB_PASS=sua_senha
   

Uso

Execute o pipeline ETL:

poetry run python .\src\pipeline\main.py

Executando o dashboard:

Executando via poetry:

poetry run streamlit run .\src\app.py

ou

Executando via docker compose:

docker compose up

Demonstração do dashboard

Contribuição

Sinta-se à vontade para contribuir com novos recursos, correções de bugs ou melhorias de desempenho. Basta abrir uma issue ou enviar um pull request!

Autor

Rhanyele Teixeira Nunes Marinho

Licença

Este projeto está licenciado sob a MIT License.