🌦️ Weather API Wrapper Service

Um serviço fullstack moderno para consulta de previsões meteorológicas, construído com foco em Clean Code, Arquitetura Hexagonal, DDD e Qualidade de Software.

🚀 Sobre o Projeto

Este projeto evoluiu de um simples wrapper para um Coletor de Dados Automático. Ele monitora cidades estratégicas e mantém um histórico persistente e cacheado para alta performance.

---

🏗️ Arquitetura do Sistema

O backend utiliza Arquitetura Hexagonal e um agendador de tarefas em segundo plano.

graph TD
    subgraph Interface
        R[weather_router.py]
        S[scheduler.py]
    end
    subgraph Application
        UC[use_cases.py]
    end
    subgraph Domain
        E[entities.py]
        P[ports.py]
    end
    subgraph Infrastructure
        RA[redis_adapter.py]
        MA[mongo_adapter.py]
        A[weather_api_adapter.py]
    end

    R --> UC
    S --> UC
    UC --> P
    P -.-> RA
    P -.-> MA
    RA -.-> A
    A --> VC[Visual Crossing API]
    RA --> RD[Redis Cache]
    MA --> MG[MongoDB History]

Loading

---

✨ Funcionalidades em Destaque

🤖 Robô Coletor (Background Harvester) - NOVO!

• Agendamento Inteligente: O sistema utiliza APScheduler para buscar o clima de cidades pré-definidas (ex: SP, Londres, NY, Tóquio) a cada 60 minutos.
• Cache Warming: O robô mantém o cache do Redis sempre "quente", garantindo resposta instantânea para buscas populares.
• Persistência Automática: Todas as coletas são salvas automaticamente no MongoDB.

🧪 Qualidade de Software

• Testes Unitários & Integração: 100% validado via pytest.
• Pipeline CI/CD: Garantia de integridade automática no GitHub Actions.

---

🛠️ Como Executar

1. Iniciar Infraestrutura (Docker)

docker compose up -d

2. Configurar o Backend

cd backend
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
python -m uvicorn main:app --reload

---

📅 Roadmap de Evolução

• Fase 1: Interface UI/UX Animada.
• Fase 2: Estrutura Core do Backend.
• Fase 3: Cache de 12h com Redis.
• Fase 4: Histórico de Buscas com MongoDB.
• Fase 5: Qualidade & Automação (Testes & CI). ✅
• Bônus: Robô Coletor de Dados (Cronjob). ✅
• Fase 6: Observabilidade & Debugging Masterclass.
• Fase 7: Deploy na Azure.
• Fase 8: Refatoração UI com Ionic Framework.

---

Desenvolvido por Matheus como parte do aprendizado avançado em Python, DDD e Clean Code.