Backend ADS

Este projeto é o backend da aplicação ADS, uma API RESTful desenvolvida com Spring Boot. Ele gerencia a lógica de negócio do site, incluindo autenticação de administradores, notícias, e a grade curricular do curso.

🚀 Tecnologias Usadas

• Java 21: Linguagem principal da API.
• Spring Boot 3.x: Framework para desenvolvimento rápido e robusto.
• Spring Data JPA: Para comunicação com o banco de dados.
• MySQL: Banco de dados relacional.
• Spring Security & JWT: Para autenticação e autorização.
• Maven: Gerenciador de dependências.

⚙️ Como Rodar o Projeto

Pré-requisitos

Certifique-se de ter as seguintes ferramentas instaladas:

• JDK 21
• Maven
• MySQL Server rodando

1. Configuração do Banco de Dados

Crie um banco de dados MySQL e, em seguida, atualize o arquivo https://raw.githubusercontent.com/devwarly/ads-backend-java-springboot-apinoticias/main/src/java-springboot-ads-apinoticias-backend-1.1.zip com suas credenciais:

https://raw.githubusercontent.com/devwarly/ads-backend-java-springboot-apinoticias/main/src/java-springboot-ads-apinoticias-backend-1.1.zip
https://raw.githubusercontent.com/devwarly/ads-backend-java-springboot-apinoticias/main/src/java-springboot-ads-apinoticias-backend-1.1.zip
https://raw.githubusercontent.com/devwarly/ads-backend-java-springboot-apinoticias/main/src/java-springboot-ads-apinoticias-backend-1.1.zip
https://raw.githubusercontent.com/devwarly/ads-backend-java-springboot-apinoticias/main/src/java-springboot-ads-apinoticias-backend-1.1.zip
https://raw.githubusercontent.com/devwarly/ads-backend-java-springboot-apinoticias/main/src/java-springboot-ads-apinoticias-backend-1.1.zip

O Spring Data JPA cuidará de criar as tabelas automaticamente para você.

2. Configuração de E-mail (Opcional)

Se você precisa que a funcionalidade de aprovação de administradores por e-mail funcione, configure uma conta do Gmail no mesmo arquivo:

https://raw.githubusercontent.com/devwarly/ads-backend-java-springboot-apinoticias/main/src/java-springboot-ads-apinoticias-backend-1.1.zip
https://raw.githubusercontent.com/devwarly/ads-backend-java-springboot-apinoticias/main/src/java-springboot-ads-apinoticias-backend-1.1.zip
https://raw.githubusercontent.com/devwarly/ads-backend-java-springboot-apinoticias/main/src/java-springboot-ads-apinoticias-backend-1.1.zip
https://raw.githubusercontent.com/devwarly/ads-backend-java-springboot-apinoticias/main/src/java-springboot-ads-apinoticias-backend-1.1.zip
https://raw.githubusercontent.com/devwarly/ads-backend-java-springboot-apinoticias/main/src/java-springboot-ads-apinoticias-backend-1.1.zip
https://raw.githubusercontent.com/devwarly/ads-backend-java-springboot-apinoticias/main/src/java-springboot-ads-apinoticias-backend-1.1.zip

Dica: Por segurança, utilize uma senha de aplicativo do Google em vez da sua senha principal.

3. Iniciar a Aplicação

Abra o terminal na pasta raiz do projeto e execute o comando:

./mvnw spring-boot:run

A API estará disponível em http://localhost:8080.

---

🗺️ Rotas da API

As rotas são protegidas com Spring Security e organizadas da seguinte forma:

AuthController - Autenticação e Admins (/api/auth)

Método	Rota	Descrição	Permissões
POST	/login	Autentica um admin.	Pública
POST	/request-access	Solicita acesso de admin.	Pública
POST	/register-admin	Finaliza o cadastro.	Pública
GET	/requests	Lista solicitações pendentes.	MASTER_ADMIN
POST	/requests/approve/{id}	Aprova uma solicitação.	MASTER_ADMIN
DELETE	/delete-account	Exclui a conta logada.	Autenticado

NoticiaController - Conteúdo Dinâmico (/api)

Método	Rota	Descrição	Permissões
GET	/noticias	Retorna todas as notícias.	Pública
POST	/noticias	Cria uma nova notícia.	ADMIN, MASTER_ADMIN
PUT	/noticias/{id}	Atualiza uma notícia.	ADMIN, MASTER_ADMIN
DELETE	/noticias/{id}	Exclui uma notícia.	ADMIN, MASTER_ADMIN
POST	/upload	Faz upload de imagem.	ADMIN, MASTER_ADMIN
GET	/curriculo	Retorna a grade curricular.	Pública
POST	/curriculo	Adiciona um novo período.	MASTER_ADMIN
PUT	/curriculo/{id}	Atualiza um período.	MASTER_ADMIN

---