AntaresCode Spring Boot MVC Template

Template reutilizável para criação de APIs Java com Spring Boot, seguindo boas práticas e estrutura modular com arquitetura MVC.

Desenvolvido e mantido por AntaresCode Soluções em Tecnologia.

---

🚀 Tecnologias

• Java 21
• Spring Boot 3
• Spring Security + JWT
• Spring Data JPA
• PostgreSQL
• Flyway
• MapStruct
• OpenFeign
• Swagger (springdoc-openapi)
• Docker + Docker Compose
• Arquitetura MVC

---

📁 Estrutura base

src/
 └── main/
     ├── java/tech/antarescode/springbootmvctemplate/
     └── resources/
         ├── application.yml
         ├── db/migration/
         └── templates/

---

⚙️ Como usar este template

1. Crie seu novo projeto No GitHub, clique em Use this template ou clone diretamente:

git clone https://github.com/antarescode/antarescode-springboot-mvc-template.git meu-novo-projeto
cd meu-novo-projeto

2. Renomeie o pacote base e a classe principal tech.antarescode.springbootmvctemplate → com.suaempresa.seuprojeto

SpringbootMvcTemplateApplication → SeuProjetoApplication

Você pode fazer isso manualmente ou com um script de refatoração.

3. Configure variáveis de ambiente Renomeie o arquivo .env.example para .env e edite os valores:

cp .env.example .env

4. Execute com Docker Compose

docker-compose up -d

Ou apenas rode com Maven:

./mvnw spring-boot:run

---

🔒 Autenticação

Este template já está pronto para autenticação via JWT. Basta configurar o JWT_SECRET no .env e seguir com a implementação dos endpoints.

---

📄 Documentação Swagger

Após subir a aplicação, acesse:

http://localhost:8080/swagger-ui.html

---

🧪 Testes

Execute os testes com:

./mvnw test

---

🛠️ Personalização recomendada

Execute os testes com:

• Atualizar application.yml com seu context-path
• Configurar domínios reais no Flyway
• Substituir entidades e pacotes genéricos por suas implementações

---

📜 Licença

Este projeto está licenciado sob a MIT License.