Uma lista organizada e prática de exemplos e recursos do projeto Ninja API, uma aplicação backend desenvolvida em Spring Boot, focada em cadastro e gerenciamento de ninjas.

Este projeto está finalizado e demonstra boas práticas de arquitetura backend usando Java + Spring Boot + JPA, incluindo documentação automática com Swagger, containerização com Docker e configuração pronta para Docker Compose.

Nota Este projeto é voltado para fins educacionais, aprendizado e portfólio. Não é recomendado para uso direto em produção sem adaptações de segurança e escalabilidade.

• Visão geral do projeto
• Tecnologias utilizadas
• Estrutura do projeto
• Funcionalidades
• Endpoints principais
• Como executar o projeto
• Próximos passos

A Ninja API é uma API RESTful desenvolvida em Java utilizando Spring Boot. O objetivo do projeto é permitir o cadastro, listagem, atualização, busca e remoção de ninjas, aplicando boas práticas como separação de camadas (Controller, Service, Repository) e uso de JPA para persistência de dados.

• Java 17+
• Spring Boot
• Spring Web
• Spring Data JPA
• Hibernate
• Swagger / OpenAPI 3 (documentação da API)
• Docker
• Docker Compose
• Banco de dados: MySQL / PostgreSQL
• Maven

src/main/java
 └── com/seuprojeto/naruto
     ├── ninja
     │   ├── controller
     │   │   └── NinjaController.java
     │   ├── service
     │   │   └── NinjaService.java
     │   ├── repository
     │   │   └── NinjaRepository.java
     │   └── model
     │       └── NinjaModel.java
     │
     ├── missao
     │   ├── controller
     │   │   └── MissaoController.java
     │   ├── service
     │   │   └── MissaoService.java
     │   ├── repository
     │   │   └── MissaoRepository.java
     │   └── model
     │       └── MissaoModel.java
     │
     └── config
         └── SwaggerConfig.java

* ✅ Cadastrar ninjas

* 📋 Listar todos os ninjas

* 🔍 Buscar ninja por ID

* ✏️ Atualizar informações do ninja

* ❌ Deletar ninja

* 🎯 Cadastrar missões

* 📋 Listar missões

* 🔗 Vincular missões a ninjas

* ❌ Remover missões

* 📄 Documentação automática da API com Swagger

* 🐳 Aplicação totalmente containerizada com Docker

* 🔄 Orquestração de serviços com Docker Compose

• Docker
• Docker Compose

# Clonar o repositório
git clone https://github.com/seu-usuario/ninja-api.git

# Entrar no projeto
cd ninja-api

# Subir aplicação + banco
docker compose up -d

A aplicação ficará disponível em:

http://localhost:8080

Após subir o projeto, a documentação interativa estará disponível em:

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

• 🚀 Projeto finalizado e pronto para demonstração

• 📌 Ideal para portfólio, entrevistas e estudos avançados

• 🔐 Implementar autenticação com Spring Security

• 📦 Criar DTOs e Mappers

• 🧪 Adicionar testes unitários

• 🐳 Dockerizar a aplicação

• 📄 Criar documentação com Swagger/OpenAPI

Junte-se às nossas discussões da comunidade no GitHub para compartilhar ideias, fazer perguntas ou sugerir melhorias. Vamos construir algo incrível juntos!

Use o espaço de issues para relatar bugs, sugerir melhorias ou tirar dúvidas sobre o projeto 💬

💡 Projeto ideal para estudos, entrevistas e portfólio backend Java.