🚀 Exchange.API — API de Câmbio em Tempo Real

📖 Descrição

API RESTful desenvolvida em .NET para conversão de moedas em tempo real, construída com Clean Architecture e Domain-Driven Design (DDD). Utiliza Use Cases para garantir o isolamento das regras de negócio e o desacoplamento total entre as camadas, facilitando manutenção, testes e escalabilidade.

A API suporta:

• 💱 Conversão de valores entre diferentes moedas usando taxas de câmbio do Banco central brasileiro.
• 📜 Histórico de conversões realizadas para consulta com cachê para performance.
• 🔧 Extensibilidade para futuras integrações com APIs de câmbio de outras instituições, agendamento de conversões e notificações.

---

📁 Estrutura do Projeto

Exchange.sln
├── Exchange.API/                # API REST, controllers, middleware e configuração
│   ├── Controllers/
│   ├── Middleware/
│   └── Program.cs
├── Exchange.Application/        # Casos de uso, interfaces e lógica de aplicação
│   ├── Interfaces/
    ├── Dtos/
│   └── UseCases/
├── Exchange.Domain/             # Entidades do domínio, interfaces e regras de negócio puras
│   ├── Entities/
│   └── Interfaces/
├── Exchange.Infrastructure/     # Implementações dos repositórios, serviços externos e persistência
│   ├── Repositories/
│   └── Services/
└── Exchange.Unit.Test/          # Implementações dos testes unitarios
    ├── Application/
    └── API/

---

🛠️ Tecnologias Utilizadas

• .NET 8
• Clean Architecture
• Domain-Driven Design (DDD)
• ASP.NET Core Web API
• Memory cachê
• Injeção de Dependência
• Middlewares para tratamento global de erros

---

▶️ Como Rodar

1. 🔽 Clone o repositório
2. 🛠️ Abra a solução Exchange.sln no Visual Studio ou VS Code
3. 📦 Restaure as dependências e compile o projeto
4. ▶️ Execute o projeto Exchange.API
5. 🌐 Acesse a documentação Swagger em https://localhost:{porta}/swagger (se configurado)
6. 💸 Use o endpoint POST /api/currency/convert para realizar conversões

---

🔍 Endpoints Principais

Método	Endpoint	Descrição
POST	/api/currency/convert	Converte um valor de uma moeda para outra.
GET	/api/currency/history	Retorna o histórico de conversões realizadas.
POST	/api/authentication/token	Gera um token JWT para autenticação do cliente usando client_id e secret. Esse token deve ser usado para acessar endpoints protegidos da API.

---

📄 Exemplo de Requisição

POST /api/currency/convert Headers:

Authorization: Bearer {{access_token}}
Content-Type: application/json

Body:

{
  "toCurrency": "EUR",
  "amountBRL": 1000,
  "dateQuotation": "2025-08-13",
  "exchangeType": 1
}

---

📈 Exemplo de Resposta

{
    "originalAmount": 1000,
    "fromCurrency": "BRL",
    "convertedAmount": 158.75,
    "toCurrency": "EUR",
    "exchangeRate": 6.30
}

---

💡 Observações:

1. Authorization: Bearer {{access_token}} → o token deve ser obtido no endpoint de autenticação (/api/authentication/token).
2. Content-Type: application/json → necessário para que a API interprete corretamente o JSON.
3. exchangeType → pode ser usado para diferenciar tipos de câmbio (ex.: comercial, turismo).

---

🔑 Utilizando a API com ClientId e Secret de Teste

Para testar a API, você pode usar os seguintes valores fixos para se autenticar:

• client_id: 3f29b6e7-1c4b-4f9a-b8b4-2f5e2f4d5c6a
• secret: f8d9a7b6-2c3e-4f7a-8b1d-3e2f4a5b6c7d

---

⚠️ Tratamento de Erros com Middleware global

• 🚫 Valores inválidos (ex.: argumentos incorretos) resultam em resposta HTTP 400 Bad Request, com mensagens claras para facilitar o entendimento do problema.
• ❌ Erros inesperados ou internos são capturados globalmente por um middleware de tratamento de exceções, que garante o retorno de uma resposta HTTP 500 Internal Server Error padronizada e evita vazamento de detalhes sensíveis.
• 💡 Esse middleware centraliza o tratamento de erros, simplificando o código dos controllers e melhorando a manutenção da aplicação.

---

🚀 Implantação no AWS ECS

A aplicação foi implantada com sucesso no AWS ECS Fargate e está disponível através do ALB (Application Load Balancer).

🌐 Endpoint

Você pode acessar o endpoint de autenticação pelo link abaixo:

http://alb-exchange-1526545477.us-east-1.elb.amazonaws.com/api/authentication/token

📡 Exemplo de Requisição POST com curl

curl --location --request POST 'http://alb-exchange-1526545477.us-east-1.elb.amazonaws.com/api/authentication/token' \
--header 'client_id: 3f29b6e7-1c4b-4f9a-b8b4-2f5e2f4d5c6a' \
--header 'secret: f8d9a7b6-2c3e-4f7a-8b1d-3e2f4a5b6c7d'

✅ Passos realizados para a implantação

1. 🔹 Build da imagem Docker localmente.
2. 🔹 Push da imagem para o ECR (Elastic Container Registry).
3. 🔹 Configuração da Task Definition no ECS.
4. 🔹 Criação do Service com integração ao ALB.
5. 🔹 Testes e validação do endpoint.

Agora a API está rodando na nuvem com alta disponibilidade e escalabilidade! 🎉

🚀 Próximos Passos

• ✅🔗 Integrar API oficial do Banco Central do Brasil (Bacen) para obter taxas de câmbio oficiais e atualizadas (DONE).
  Fonte: Bacen - Taxas de Câmbio - Dados Abertos
  Exemplo: Bacen - Exemplo de busca
• ✅🔐 Implementar autenticação e autorização (DONE).
• ✅🧪 Adicionar testes automatizados (DONE).
• 🧩 Adicionar result pattern ao projeto
• ☁️🚀 Implantar na AWS
• ⏰ Adicionar agendamento de conversões com notificação quando taxa atingir determinado valor.

Indicadores de Conclusão

• = tarefa pendente.
• = tarefa concluída

---

✨ Made with ❤️ and ☕ by Diego Fernandes Lins ✨