Alunos — API REST (Spring Boot)

Desafio de vaga Backend Júnior — CRUD de Alunos e Matrículas utilizando Spring Boot, JPA/Hibernate e banco H2.

✨ Visão geral

A aplicação expõe endpoints REST para cadastrar alunos e suas matrículas (relação 1:N). O projeto usa:

• Java 17+ (compatível com Spring Boot 3.5.x)
• Spring Boot 3.5.6
• Spring Web (API REST)
• Spring Data JPA / Hibernate
• H2 Database (em memória, para desenvolvimento)
• Lombok (getters/setters) — já configurado no pom.xml.

Estrutura principal (resumida):

alunos/
├─ pom.xml
├─ src/main/java/com/example/alunos
│  ├─ AlunosApplication.java
│  ├─ controller/AlunoController.java
│  ├─ dto/
│  │  ├─ AlunoRequest.java
│  │  ├─ AlunoResponse.java
│  │  └─ MatriculaDTO.java
│  ├─ entity/
│  │  ├─ Aluno.java
│  │  ├─ Matricula.java
│  │  └─ BaseEntity.java
│  ├─ mapper/AlunoMapper.java
│  ├─ repository/
│  │  ├─ AlunoRepository.java
│  │  └─ MatriculaRepository.java
│  └─ service/AlunoService.java
└─ src/main/resources/application.properties

Observação: o repositório que você enviou possui alguns trechos de código de exemplo com ... em Controller/Service/Mapper que indicam partes omitidas no vídeo/aula. As seções abaixo documentam o fluxo e como rodar o projeto; ajuste os métodos se necessário.

---

🚀 Como executar localmente

Pré-requisitos

• JDK 17+ (ou superior)
• Maven (o projeto já traz o wrapper: mvnw / mvnw.cmd)

1) Clonar e abrir

git clone <seu-repo>.git
cd alunos

2) (Opcional) Configurar H2

O projeto usa H2 em memória. Se quiser habilitar o console web e configurar explicitamente a URL/credenciais, adicione no src/main/resources/application.properties:

# Nome da aplicação (já existe)
spring.application.name=alunos

# H2 console (opcional)
spring.h2.console.enabled=true
spring.h2.console.path=/h2-console

# Datasource H2 em memória
spring.datasource.url=jdbc:h2:mem:alunosdb;DB_CLOSE_DELAY=-1;MODE=LEGACY
spring.datasource.driverClassName=org.h2.Driver
spring.datasource.username=sa
spring.datasource.password=

# JPA/Hibernate
spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true
spring.jpa.properties.hibernate.format_sql=true

Se você já tem outras configs, mantenha as suas. O trecho acima é apenas um exemplo funcional.

3) Rodar a aplicação

# usando o Maven Wrapper
./mvnw spring-boot:run          # Linux/Mac
mvnw.cmd spring-boot:run        # Windows

A aplicação sobe em: http://localhost:8080
H2 Console (se habilitado): http://localhost:8080/h2-console
JDBC URL: jdbc:h2:mem:alunosdb

---

🧠 Modelo de domínio

• Aluno (id, nome, dataNascimento, telefone)
• Matricula (id, codigoMatricula, nomeCurso, dataInicio, aluno)
  Relação: Aluno 1:N Matrícula.

Mapeamentos principais:

• Aluno → @OneToMany(mappedBy = "aluno", cascade = CascadeType.ALL, orphanRemoval = true)
• Matricula → @ManyToOne @JoinColumn(name = "aluno_id")

---

🔁 DTOs e Mapper

• AlunoRequest — payload de entrada (inclui lista de MatriculaDTO)
• AlunoResponse — payload de saída
• MatriculaDTO — dados da matrícula (sem id)
• AlunoMapper — converte AlunoRequest → Aluno e Aluno → AlunoResponse

Exemplo de mapping (trecho simplificado):

List<Matricula> matriculas = request.matriculas()
    .stream()
    .map(m -> { 
        Matricula mat = new Matricula();
        mat.setCodigoMatricula(m.codigoMatricula());
        mat.setNomeCurso(m.nomeCurso());
        mat.setDataInicio(m.dataInicio());
        mat.setAluno(aluno);
        return mat;
    }).toList();
aluno.setMatriculas(matriculas);

---

🌐 Endpoints (exemplos)

Os métodos podem variar conforme o seu AlunoController. Abaixo está o conjunto esperado para CRUD e listagem de matrículas.

• POST /alunos — cria um aluno
• GET /alunos — lista todos
• GET /alunos/{id} — busca por id
• GET /alunos/{id}/matriculas — lista matrículas do aluno
• PUT /alunos/{id} — atualiza aluno
• DELETE /alunos/{id} — remove aluno

Exemplo de requisição (IntelliJ HTTP Client)

No arquivo requisicoes.http na raiz do projeto:

### Criar novo aluno
POST http://localhost:8080/alunos
Content-Type: application/json

{
  "nome": "Murilo Albuquerque",
  "dataNascimento": "2004-07-21",
  "telefone": "(82) 99999-0000",
  "matriculas": [
    { "codigoMatricula": "MAT-001", "nomeCurso": "Engenharia de Software", "dataInicio": "2025-01-10" }
  ]
}

### Listar todos
GET http://localhost:8080/alunos

### Buscar por ID
GET http://localhost:8080/alunos/1

### Atualizar
PUT http://localhost:8080/alunos/1
Content-Type: application/json

{
  "nome": "Murilo Atualizado",
  "dataNascimento": "2004-07-21",
  "telefone": "(82) 98888-1111",
  "matriculas": [
    { "codigoMatricula": "MAT-001", "nomeCurso": "Java Avançado", "dataInicio": "2025-03-15" }
  ]
}

### Excluir
DELETE http://localhost:8080/alunos/1

---

✅ Boas práticas adotadas

• Separação por camadas (controller, service, repository, mapper, dto, entity)
• DTOs para entrada/saída (evita expor entidades)
• Mapeamento explícito entre entidades e DTOs
• JPA + H2 para desenvolvimento rápido
• Lombok para reduzir boilerplate

---

🧪 Testes

Há um skeleton de teste em src/test/java/com/example/alunos/AlunosApplicationTests.java.
Você pode rodar:

./mvnw test

---

📦 Build do JAR

./mvnw clean package
java -jar target/alunos-0.0.1-SNAPSHOT.jar

---

📝 Licença

Este projeto está licenciado sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.

---

👤 Autor

Murilo Albuquerque — foco em Backend Java com Spring Boot.