🏟️ Sistema IoT de Monitoramento para Campos de Futebol

Sistema completo de monitoramento de condições ambientais utilizando ESP32, FIWARE e Dashboard React

---

💡 Sobre o Projeto

Sistema IoT que monitora em tempo real as condições ambientais de campos de futebol (temperatura, umidade e luminosidade) para determinar se estão aptos para jogos, garantindo segurança dos atletas e conformidade com normas esportivas.

✨ Funcionalidades Principais

Recurso	Descrição
🌡️ Temperatura	Monitoramento via DHT22 (15-28°C ideal)
💧 Umidade	Controle de umidade relativa (40-70% ideal)
💡 Luminosidade	Medição de iluminação via LDR (>50% ideal)
🚦 Status Automático	🟢 Apto / 🟡 Atenção / 🔴 Inadequado
🔄 Controle Remoto	Comandos MQTT bidirecionais
📊 Dashboard	Visualização React em tempo real

🔁 Link do circuito

---

🎥 Demonstração

Vídeo Completo da Solução

🎬 Assistir demonstração no YouTube

---

🎯 Resultados da PoC

✅ Cenários Validados

#	Cenário	Status	Evidência
1	Coleta e transmissão MQTT	✅ Funcionando
2	Processamento FIWARE	✅ Funcionando
3	Dashboard em tempo real	✅ Funcionando	Vídeo
4	Comandos bidirecionais	✅ Funcionando
5	Persistência histórica	✅ Funcionando

📊 Métricas Obtidas

Latência média:        2-3 segundos (ESP32 → Dashboard)
Taxa de perda:         < 1%
Uptime infraestrutura: 99.9%
Precisão DHT22:        ±0.5°C / ±2% umidade

🏆 Conclusões

• ✅ Arquitetura MQTT + FIWARE validada
• ✅ Sistema pronto para produção
• ✅ Escalável para múltiplos campos
• ✅ Interface intuitiva e responsiva

---

🏗️ Arquitetura

🐳 Componentes FIWARE (AWS EC2)

Componente	Porta	Função
Orion Context Broker	1026	Gerenciamento de contexto
STH-Comet	8666	Dados históricos
IoT Agent MQTT	4041	Ponte MQTT ↔ FIWARE
Mosquitto Broker	1883	Servidor MQTT
MongoDB	27017	Banco de dados

---

🛠️ Tecnologias

Hardware

• ESP32 (Wokwi ou físico)
• DHT22 - Temperatura/Umidade
• LDR - Luminosidade
• LED - Indicador visual

Software

• FIWARE - Plataforma IoT
• MQTT - Protocolo de comunicação
• React + Vite - Dashboard
• Docker - Containerização
• AWS EC2 - Cloud hosting

---

🚀 Quick Start

1️⃣ Clone o Repositório

git clone https://github.com/Otaaviio/sprint3edge.git
cd sprint3edge

2️⃣ Configure a Infraestrutura FIWARE

# Na sua VM AWS (Ubuntu 22.04)
git clone https://github.com/fabiocabrini/fiware.git
cd fiware
sudo docker compose up -d

3️⃣ Configure o ESP32

// Em devices/sketch.ino, ajuste:
const char* BROKER_MQTT = "SEU_IP_AWS";
const char* SSID = "SEU_WIFI";
const char* PASSWORD = "SUA_SENHA";

4️⃣ Execute o Dashboard

cd dashboard
npm install
npm run dev

5️⃣ Provisione o Dispositivo

Use o Postman com a collection do FIWARE Descomplicado:

• Importe a collection
• Execute "Provisionar Dispositivo"
• Registre os comandos ON/OFF

---

📚 Documentação Completa

📁 Guias Técnicos

• Instalação Detalhada - Setup completo passo a passo
• Configuração ESP32 - Pinout, código e WiFi
• Configuração FIWARE - Docker, Postman e APIs
• Dashboard React - Frontend e integração
• Protocolo MQTT - Tópicos e payloads

🔧 Referências

• Troubleshooting - Resolução de problemas
• API Reference - Endpoints FIWARE
• Resultados da PoC - Análise completa

📦 Estrutura do Projeto

📦 projeto-campo-futebol-iot/
├── 📁 devices/
│   ├── sketch.ino          # Código do ESP32
│   └── diagram.json        # Circuito Wokwi
├── 📁 dashboard/
│   ├── src/
│   │   ├── App.jsx         # Componente principal
│   │   └── components/     # Componentes React
│   └── package.json
├── 📁 docs/
│   ├── images/             # Screenshots e diagramas
│   ├── tutorial.md          # Tutoriais e guias
│   └── arquitetura         # Documentação da arquitetura
├── 📄 README.md
└── 📄 LICENSE

---

📄 Licença

Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.

---

🔗 Links Úteis

• FIWARE Documentation
• FIWARE Descomplicado
• ESP32 Documentation
• MQTT Protocol