📚 Pré-requisitos Teóricos: Este projeto prático aplica os fundamentos do padrão arquitetural MVC, mapeamento objeto-relacional com Spring Data JPA e renderização com Thymeleaf ensinados na Especialização em Backend com Java e Spring Boot.

A Biblioteca de Jogos (v1) estabelece a fundação do desenvolvimento web corporativo com Spring Boot 3. O projeto implementa um catálogo completo de jogos digitais abrangendo as operações de cadastro, listagem dinâmica, alternância de status de conclusão (“zerado”) e exclusão de registros, utilizando banco de dados H2 em desenvolvimento e persistência relacional.

🏛️ Arquitetura da Solução MVC

O diagrama a seguir descreve o fluxo de requisições web entre a camada de visualização Thymeleaf, o controlador Spring MVC e o repositório JPA:

📁 Estrutura de Pastas Padronizada

A base de código segue o padrão canônico com nomenclatura anti-colisão:

catalogo_projetos/javaweb_jogos_01_crud/
├── assets/                   # Galeria de diagramas visuais e arquitetura
│   └── arquitetura_jogos_crud.svg
├── web-spring/               # Aplicação Spring Boot 3 MVC
│   ├── src/
│   │   ├── main/
│   │   │   ├── java/br/com/bibliotecajogos/
│   │   │   │   ├── controller/   # JogoController (rotas web /jogos)
│   │   │   │   ├── entity/       # Jogo (Entidade JPA)
│   │   │   │   └── repository/   # JogoRepository (Spring Data JPA)
│   │   │   └── resources/
│   │   │       ├── templates/
│   │   │       │   └── index.html # View Thymeleaf com Bootstrap 5
│   │   │       └── application.properties
│   │   └── test/                 # Testes unitários do contexto
│   ├── Dockerfile
│   ├── pom.xml
│   ├── mvnw
│   └── mvnw.cmd
└── index.md                  # Especificação executiva e Padrão Ouro

🧑‍💼 Engenharia de Software & Requisitos

1. Histórias de Usuário (US)

2. Requisitos Funcionais (RF)

3. Requisitos Não-Funcionais (RNF)

4. Diagrama de Casos de Uso

flowchart TD
    subgraph Ator
        USR["Gamer / Usuário"]
    end

    subgraph "Biblioteca de Jogos v1 (web-spring)"
        UC1["Visualizar Lista de Jogos (GET /)"]
        UC2["Cadastrar Novo Jogo (POST /jogos)"]
        UC3["Marcar como Concluído (POST /{id}/concluir)"]
        UC4["Remover Jogo (POST /{id}/apagar)"]
    end

    USR --> UC1
    USR --> UC2
    USR --> UC3
    USR --> UC4

5. Matriz de Rastreabilidade (RTM)

🛠️ Implementação do Controlador e Modelo

1. Entidade JPA (Jogo.java)

@Entity
@Table(name = "jogos")
public class Jogo {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    
    private String titulo;
    private String plataforma;
    private boolean concluido;

    public Long getId() { return id; }
    public void setId(Long id) { this.id = id; }
    public String getTitulo() { return titulo; }
    public void setTitulo(String titulo) { this.titulo = titulo; }
    public String getPlataforma() { return plataforma; }
    public void setPlataforma(String plataforma) { this.plataforma = plataforma; }
    public boolean isConcluido() { return concluido; }
    public void setConcluido(boolean concluido) { this.concluido = concluido; }
}

2. Endpoints do Controlador (JogoController.java)

📄 web-spring/src/main/java/br/com/bibliotecajogos/controller/JogoController.java (arquivo real do projeto)

package br.com.bibliotecajogos.controller;

import br.com.bibliotecajogos.entity.Jogo;
import br.com.bibliotecajogos.repository.JogoRepository;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.*;

@Controller
public class JogoController {

    @Autowired
    private JogoRepository jogoRepository;

    @GetMapping("/")
    public String listar(Model model) {
        model.addAttribute("jogos", jogoRepository.findAll());
        model.addAttribute("novoJogo", new Jogo());
        return "jogos";
    }

    @PostMapping("/jogos")
    public String adicionar(@ModelAttribute Jogo novoJogo) {
        jogoRepository.save(novoJogo);
        return "redirect:/";
    }

    @PostMapping("/jogos/{id}/concluir")
    public String marcarConcluido(@PathVariable Long id) {
        jogoRepository.findById(id).ifPresent(jogo -> {
            jogo.setConcluido(!jogo.isConcluido());
            jogoRepository.save(jogo);
        });
        return "redirect:/";
    }

    @PostMapping("/jogos/{id}/apagar")
    public String apagar(@PathVariable Long id) {
        jogoRepository.deleteById(id);
        return "redirect:/";
    }
}

🚀 Roteiro de Execução

1. Iniciar a Aplicação com o Maven Wrapper

cd catalogo_projetos/javaweb_jogos_01_crud/web-spring
./mvnw spring-boot:run

No Windows (PowerShell):

cd catalogo_projetos\javaweb_jogos_01_crud\web-spring
.\mvnw.cmd spring-boot:run

2. Validar no Navegador

• Acesse http://localhost:8080/.
• Preencha os campos de título e plataforma e envie o formulário.
• Clique em “Concluir” para alternar o status do jogo.
• Exclua um item para testar a remoção do banco.

🎯 Matriz de Checkpoints de Entrega