Template de Projeto Fullstack com Spring Boot e Next.js

Este projeto representa um template para o desenvolvimento de aplicações web fullstack modernas utilizando Spring Boot no backend e Next.js no frontend. Ele foi criado como base para aplicações que utilizam boas práticas de engenharia de software, escalabilidade e integração entre Java e TypeScript.

Visão Geral

A aplicação é dividida em dois componentes principais:

1. Backend (API RESTful):

   • Construído com Spring Boot, um framework amplamente utilizado na comunidade Java para o desenvolvimento de aplicações robustas e performáticas.
   • Implementa uma arquitetura RESTful para expor endpoints que servirão como interface de comunicação com o frontend.
   • Inclui configurações para persistência de dados, segurança, e boas práticas de design de API.

2. Frontend (Interface de Usuário):

   • Desenvolvido em Next.js, um framework React para renderização híbrida (client-side e server-side) de aplicações web.
   • Integra totalmente com o backend, consumindo as APIs REST disponibilizadas pelo Spring Boot.
   • Utiliza Tailwind CSS como ferramenta para estilização baseada em classes utilitárias.

O objetivo deste template é acelerar o desenvolvimento de aplicações fullstack modernas que priorizam desempenho, escalabilidade e experiência do usuário.

Estrutura do Projeto

Abaixo, você encontrará a organização geral dos arquivos do projeto:

root/
├── backend/
│   ├── src/
│   │   ├── main/
│   │   │   ├── java/          # Código fonte Java
│   │   │   ├── resources/     # Arquivos de configuração (application.properties, etc.)
│   │   ├── test/              # Testes automatizados para o backend
│   └── pom.xml                # Configuração do Maven para dependências do backend
├── frontend/
│   ├── components/            # Componentes React reutilizáveis
│   ├── pages/                 # Arquivos para rotas do Next.js
│   ├── public/                # Arquivos estáticos (imagens, fontes, etc.)
│   ├── styles/                # Estilos globais ou específicos
│   ├── tailwind.config.js     # Configuração do Tailwind CSS
│   └── package.json           # Configuração de dependências e scripts do frontend
├── .gitignore                 # Arquivos e pastas ignorados pelo Git
└── README.md                  # Documentação do projeto

Pré-requisitos

Antes de começar, é fundamental garantir que todas as ferramentas requeridas estejam instaladas. Abaixo, a lista de tecnologias necessárias:

Ferramentas Necessárias

• Java 21 ou superior (JDK)
• Gradle (Gerenciador de dependências para o backend)
• Node.js (versão 22 ou superior)
• npm (gerenciador de pacotes Node.js)
• IDE: IntelliJ IDEA ou VS Code

Configuração do Ambiente de Desenvolvimento

Passo 1: Clonando o Repositório

git clone <url_do_repositorio>
cd <nome_do_projeto>

Passo 2: Configurando o Backend (Spring Boot)

1. Abra a pasta backend no IntelliJ IDEA ou na sua IDE favorita.

2. Certifique-se de que o arquivo application.properties contenha informações atualizadas sobre banco de dados, portas, etc. Será necessário configurar:

   • Hibernate para a persistência de dados.
   • JPA para operações no banco de dados.
   • Uma biblioteca de segurança como Spring Security, se aplicável.

3. Execute o seguinte comando para assegurar que todas as dependências sejam baixadas:

   ./gradlew build

1. Inicie o servidor backend com:

   ./gradlew bootRun

Por padrão, a API será exposta na porta http://localhost:8080.

Passo 3: Configurando o Frontend (Next.js)

2. Abra a pasta frontend no seu editor de texto favorito, como VS Code.
3. Instale as dependências necessárias:

   npm install

1. Execute o servidor frontend:

   npm run dev

O frontend estará disponível em http://localhost:3000 por padrão.

Referências

• Documentação Oficial do Spring Boot
• Documentação do Next.js

Com isso, o modelo está pronto para sua evolução. 🚀 Se houver dúvidas, consulte a documentação ou entre em contato com seu instrutor, ou a equipe!