Autor: Renan Santa Rosa Xavier — RM566997 | 🌐 Portfólio: renan-xavier.vercel.app
Esta API RESTful foi desenvolvida em Java 21 com Spring Boot 3 para rastreamento de emissões de carbono de Escopo 3 e auditoria automatizada de conformidade ESG em fornecedores corporativos.
O sistema recebe relatórios periódicos de emissões, compara os volumes auditados com as metas contratuais de cada fornecedor e calcula automaticamente o status de conformidade (EM_CONFORMIDADE, ALERTA ou NAO_CONFORME).
A API conta com um simulador web interativo para testes visuais e validação dos fluxos de cadastro, envio de relatórios e auditoria em tempo real:
| Arquitetura & Regras ESG | Dockerfile & Orquestração | Validação dos Endpoints via Postman/Maven |
|---|---|---|
![]() |
![]() |
![]() |
O projeto segue arquitetura em camadas desacopladas com isolamento de responsabilidades:
flowchart LR
Client["Cliente Web / Postman\n(HTTP Basic Auth)"] --> Security["Spring Security\nConfiguracaoSeguranca"]
Security --> Ctrl["REST Controllers\nFornecedorController / EmissaoController"]
Ctrl --> Svc["Service Layer\nRegras de Negócio & Cálculo de Conformidade"]
Svc --> DTO["Mapeamento DTO / Model\nBean Validation (@Valid)"]
Svc --> Repo["Spring Data JPA\nFornecedorRepository / EmissaoRepository"]
Repo --> DB[("Oracle Database\nMigrações V1 & V2 via Flyway")]
| Tecnologia | Finalidade no Projeto |
|---|---|
| Java 21 (LTS) | Linguagem base com recursos modernos (Records, Pattern Matching e novas APIs). |
| Spring Boot 3.x | Framework para estruturação da API REST, injeção de dependências e configuração. |
| Spring Data JPA & Hibernate | Abstração da camada de persistência e mapeamento objeto-relacional. |
| Oracle Database | SGBD relacional corporativo utilizado para armazenamento seguro das entidades. |
| Flyway | Versionamento e execução automática de scripts SQL (V1__criar_tabelas e V2__dados_iniciais). |
| Spring Security | Autenticação HTTP Basic protegendo endpoints sensíveis de escrita e auditoria. |
| Bean Validation & ProblemDetail | Validação de payloads e tratamento global de erros no padrão RFC 7807. |
| Docker & Docker Compose | Containerização da aplicação com build multi-stage e provisionamento do banco. |
| Método | Endpoint | Descrição |
|---|---|---|
GET |
/fornecedores |
Lista fornecedores cadastrados na cadeia de suprimentos |
POST |
/fornecedores |
Cadastra novo fornecedor com meta anual (tCO2e) |
GET |
/fornecedores/{id}/conformidade |
Calcula conformidade comparando emissões auditadas com a meta |
POST |
/emissoes |
Registra novo relatório de emissão de Escopo 3 |
GET |
/emissoes/{id} |
Consulta detalhes de um relatório de emissão |
PUT |
/emissoes/{id} |
Atualiza dados e avança auditoria (PENDENTE → AUDITADO) |
DELETE |
/emissoes/{id} |
Invalida/remove um relatório de emissão |
- Docker e Docker Compose instalados (ou JDK 21 + Maven caso execute sem Docker).
# Constrói a imagem da aplicação e sobe os containers da API e do banco
docker compose up --buildmvn clean test- Usuário:
admin - Senha:
esg123



