_________________  __     _______________________
  ___  ____/__  /_ \/ /     ___    |__  __ \___  _/
  __  /_   __  / __  /________  /| |_  /_/ /__  /  
  _  __/   _  /___  /_/_____/  ___ |  ____/__/ /   
  /_/      /_____/_/        /_/  |_/_/     /___/   by Catmaitachi

✈️ Sobre o projeto

Fly-API é uma aplicação RESTful desenvolvida em Java com Spring Boot, que gerencia informações de aeroportos. Ao iniciar, a aplicação importa dados de aeroportos a partir de um arquivo CSV disponibilizado pela OpenFlights, normaliza os nomes dos países para seus códigos ISO2, converte altitudes de pés para metros e armazena os aeroportos únicos em um banco de dados MySQL. A API oferece operações CRUD (Create, Read, Update, Delete) para manipular os dados dos aeroportos.

Esse projeto foi desenvolvido como método de aprendizado e avaliação da diciplina de Programação Modular do curso de Engenharia de Software da PUC Minas.

🚀 Execução com Docker

Pré-requisitos

• Docker & Docker Compose
• Portas livres: 8080 (API) e 3306 (MySQL)

Passos

git clone https://github.com/catmaitachi/Fly-API.git
cd Fly-API/app
docker compose up --build -d

Verificar containers

docker compose ps

Logs

docker compose logs -f app
docker compose logs -f mysql

Acesso

http://localhost:8080

🗄️ Banco de Dados

Configuração padrão (Docker Compose):

• Banco: flyapi
• Usuário: root
• Senha: 777
• Porta: 3306

Conexão:

mysql -h 127.0.0.1 -P 3306 -u root -p
# Senha: 777

🔧 Comandos Úteis

# Parar containers
docker compose down

# Parar e remover volumes (apaga dados)
docker compose down -v

# Reconstruir após mudanças no código
docker compose up --build -d

# Reiniciar somente a aplicação
docker compose restart app

# Entrar no container da aplicação
docker compose exec app bash

# Acessar MySQL dentro do container
docker compose exec mysql mysql -u root -p

🐳 Dockerfile (Resumo)

Multi-stage:

1. test: Executa ./mvnw test (falha interrompe pipeline)
2. build: Baixa dependências + empacota
3. runtime: Copia JAR final e expõe porta 8080

📝 Desenvolvimento Local (sem Docker)

Pré-requisitos: Java 25 + Maven + MySQL.

cd app
./mvnw spring-boot:run

Variáveis e credenciais podem ser ajustadas em src/main/resources/application.properties.

⚙️ Configuração / Ambiente

• Importação CSV: arquivo src/main/resources/data/airports.csv
• Países: conversão robusta (nomes alternativos + ISO2/ISO3)
• Validações: anotadas no DTO AeroportoRequest

🔌 Endpoints REST

Base URL: http://localhost:8080/api/v1/aeroportos

Método	Rota	Descrição	Respostas
GET	/	Lista aeroportos	200 (JSON) ou 204 (sem conteúdo)
GET	/{iata}	Busca aeroporto pelo código IATA	200 (JSON) ou 404 (não encontrado)
POST	/	Cria aeroporto	200 (criado) / 400 (validação)
PUT	/{iata}	Atualiza aeroporto	200 (OK), 400 (IATA destino já existe), 404 (origem não existe)
DELETE	/{iata}	Remove aeroporto	204 (Sem conteúdo)

Exemplo de criação:

curl -X POST http://localhost:8080/api/v1/aeroportos \
  -H "Content-Type: application/json" \
  -d '{
    "nome": "Aeroporto Exemplo",
    "iata": "ABC",
    "cidade": "Cidade",
    "pais": "BR",
    "latitude": -10.0,
    "longitude": -50.0,
    "altitude": 100
  }'

📦 Modelo de Dados

{
  "id": 1,
  "nome": "Aeroporto Exemplo",
  "iata": "ABC",
  "cidade": "Cidade",
  "pais": "BR",
  "latitude": -10.0,
  "longitude": -50.0,
  "altitude": 100 // em metros
}

🧪 Testes

Estratégia dupla:

• Unitários: *Test.java (Surefire) – serviços e utilidades com Mockito/JUnit.
• Integração: *IT.java (Failsafe) – sobe contexto web e testa endpoints reais.

Comandos principais:

# Dentro do diretório app
cd app

# Somente testes unitários
./mvnw test

# Unitários + integração 
./mvnw verify

Testes via Docker

O docker compose up usa a imagem de estágio test para garantir que os testes passem antes de subir app.

🔍 Troubleshooting

# Ver processo usando porta 8080
lsof -i :8080

# Alterar porta em compose.yaml
# ports:
#   - "8081:8080"

# Ver saúde do MySQL
docker compose ps
docker compose logs mysql

# Rebuild completo
docker compose down -v
docker rmi fly-api:local
docker compose up --build -d

📁 Estrutura

app/                       # 📂 Projeto
├── Dockerfile             # 🐳 Build multi-stage
├── compose.yaml           # 🧩 Orquestração Docker
├── pom.xml                # 📦 Dependências Maven
├── src
│   ├── main
│   │   ├── java
│   │   │   └── com/example/app/
│   │   │       ├── controller/        # 🌐 Endpoints REST
│   │   │       ├── service/           # ⚙️ Regras de negócio / importação
│   │   │       ├── repository/        # 🗄️ Persistência (Spring Data JPA)
│   │   │       ├── dto/               # 🔄 Estrutura de entrada e saída + mappers
│   │   │       └── model/             # 🧱 Entidades (Aeroporto)
│   │   └── resources/
│   │       ├── application.properties # 🔧 Configurações
│   │       └── data/
│   │           └── airports.csv       # ✈️ Fonte de dados (CSV)
│   └── test/
│       └── java/                      # 🧪 Testes unitários + integração
└── target/                            # 🚀 Artefatos gerados (build)