Este repositório apresenta uma solução de Ciência de Dados desenvolvida para o desafio de ETL do bootcamp DIO da TOTVS - Fundamentos de Engenharia de Dados e Machine Learning. Diferente do contexto bancário original, este projeto foi adaptado para a realidade cultural de Nioaque, MS, integrando o trabalho de preservação do Patrimônio Nioaque 3D.
O objetivo é transformar um inventário técnico e frio de monumentos históricos em uma experiência de Storytelling Turístico envolvente.
O problema: Dados históricos costumam ficar restritos a planilhas técnicas de difícil compreensão para o turista comum.
A solução: Um pipeline ETL que extrai dados geolocalizados, utiliza IA Generativa (Google Gemini) para criar narrativas e gera um mapa interativo para totens de autoatendimento.
| Etapa | Ferramenta | Descrição do Processo |
|---|---|---|
| Extração (E) | Pandas |
Leitura do arquivo CSV contendo coordenadas, categorias e descrições técnicas. |
| Transformação (T) | Google Gemini AI |
IA assume o papel de "Guia Historiador" para criar narrativas em storytelling. |
| Carregamento (L) | JSON / Folium |
Exportação para sistema de totem e geração de mapa interativo geoespacial. |
flowchart TD
A([📄 CSV Local: Inventário Técnico]) --> B[🛠️ Extração com Pandas]
B --> C[🤖 Transformação via Gemini AI]
C --> D[✍️ Geração de Narrativas Turísticas]
D --> E{Carregamento}
E --> F[📁 JSON: API para Totens/Web]
E --> G[🗺️ HTML: Mapa Interativo Folium]
style A fill:#4A90D9,stroke:#fff,color:#fff
style B fill:#5BA4E5,stroke:#fff,color:#fff
style C fill:#1A5FA8,stroke:#fff,color:#fff
style F fill:#28a745,stroke:#fff,color:#fff
style G fill:#28a745,stroke:#fff,color:#fff
Para elevar o projeto ao nível profissional, implementamos uma camada de Análise Geoespacial. O sistema utiliza as coordenadas de latitude e longitude para "plotar" os monumentos em um mapa interativo, permitindo que o turista clique e ouça/leia a história gerada pela IA.
- Marcador Verde: Modelo 3D Concluído.
- Marcador Laranja: Modelo 3D em Produção.
- Marcador Vermelho: Local em Pesquisa.
nioaque-3d-etl/
│
├── ETL_Nioaque_3D.ipynb # Notebook principal com a lógica do pipeline
├── pontos_historicos_nioaque.csv # Base de dados técnica (Extração)
├── nioaque_3d_tour.json # Dados processados para integração (Carregamento)
├── mapa_interativo_nioaque.html # Visualização geoespacial final
├── .env # Variáveis de ambiente (API Keys - ignore)
├── requirements.txt # Dependências para replicação do ambiente
└── README.md # Documentação do projeto
Este projeto foi desenvolvido em um ambiente isolado utilizando Miniconda.
# 1. Clone o repositório
git clone https://github.com/skyzinha-chan/nioaque-3d-etl.git
cd nioaque-3d-etl
# 2. Crie e ative o ambiente isolado (Conda)
conda create -n nioaque-3d python=3.10 -y
conda activate nioaque-3d
# 3. Instale as dependências
pip install -r requirements.txt
# 4. Configure sua API Key do Gemini no arquivo .env
# Substitua 'sua_chave_aqui' pela sua chave do Google AI Studio
echo "GEMINI_API_KEY=sua_chave_aqui" > .env
# 5. Execute o Jupyter Notebook
jupyter notebook ETL_Nioaque_3D.ipynb | Nome | GitHub | |
|---|---|---|
| Talita Mendonça Marques |  |
 |
Licenciatura em Computação
Instituto Federal de Mato Grosso do Sul — Campus Jardim
Projeto IFMAKER • Patrimônio Nioaque 3D
Este projeto foi desenvolvido com o apoio do Instituto Federal de Mato Grosso do Sul (IFMS) - Campus Jardim, através do Edital 054/2025-PROPI/IFMS (Projeto IFMaker Educador: Patrimônio de Nioaque em 3D), em colaboração com a Escola Municipal Guilherme Corrêa da Silva - Nioaque. A execução deste pipeline ETL também faz parte do desafio prático do Bootcamp TOTVS — Fundamentos de Engenharia de Dados e Machine Learning.
Este projeto está licenciado sob a Creative Commons Attribution-NonCommercial 4.0 International CC BY-NC 4.0.
Isso significa que você é livre para:
- Compartilhar: Copiar e redistribuir o material em qualquer suporte ou formato.
- Adaptar: Remixar, transformar e criar a partir do material.
Sob as seguintes condições:
- Atribuição: Você deve dar o crédito apropriado (Talita Mendonça Marques) e indicar se mudanças foram feitas.
- Não Comercial: Você não pode usar o material para fins comerciais sem autorização prévia.
⭐ Se este projeto de preservação histórica foi útil para você,
considere deixar uma estrela no repositório!