Feature/backend infrastructure

[devflima]

Descrição

Este Pull Request implementa a Camada de Infrastructure, fornecendo as implementações concretas (adaptadores) para as interfaces definidas no domínio.

Foram configurados:

• Persistência com Quarkus Panache
• Mensageria com Kafka
• Segurança com SmallRye JWT
• Demais componentes necessários para o funcionamento completo do backend

---

Mudanças Realizadas

A implementação focou em transformar os modelos de domínio em entidades persistentes e integrar os serviços do ecossistema Quarkus:

1. Persistência de Dados (persistence)

• Criação das entidades JPA (PanacheEntity) para todos os contextos:
  • Users, Stats, Stacks, Projects, etc
• Implementação dos repositórios concretos (RepositoryImpl) com Hibernate Panache
• Configuração do Flyway
• Criação da migration inicial do banco de dados

---

2. Segurança e JWT (security)

• Implementação de adaptadores para:
  • Geração de tokens JWT
  • Hashing de senhas
• Inclusão de chaves pública/privada
• Configuração completa de autenticação

---

3. Mensageria e Monitoramento (messaging, monitoring)

• Implementação do ContactMessagingAdapter integrado ao Kafka
• Configuração de:
  • Producers
  • Consumers
  • Estratégia de Dead Letter Queue (DLQ)
• Adição de HealthChecks para monitoramento do banco de dados

---

4. Gestão de Exceções (exceptions)

• Mapeamento global de:
  • Exceções de domínio
  • Exceções de banco de dados
• Conversão para respostas HTTP amigáveis
• Handlers para:
  • Violações de constraints
  • Erros de negócio

---

5. Configurações (resources, config)

• Externalização de segredos via application.properties (suporte a variáveis de ambiente / K8s)
• Criação do perfil application-development.properties para facilitar o setup local

---

Decisões de Arquitetura

• Database Mapping
  Uso do padrão Repository para desacoplar entidades Panache da lógica de aplicação.

• Segurança
  Adoção de chaves PEM e PK8, seguindo boas práticas de criptografia.

• Cloud Native
  Configurações preparadas para execução em containers, com suporte à injeção de dependências do Quarkus (Arc).

---

✅ Checklist

• O código segue a estrutura de Clean Architecture (adaptadores)
• O projeto compila com sucesso com o Quarkus
• As migrations do Flyway foram validadas
• Nenhuma senha real foi deixada fixa no código fonte