🎓 Sistema de Gerenciamento de Cursos Online (EAD)

Uma API RESTful robusta desenvolvida com Java e Spring Boot para gerenciar uma plataforma de Ensino a Distância (EAD). Permite que professores publiquem cursos e aulas, enquanto alunos podem se inscrever, assistir conteúdos e interagir com comentários.

Este projeto foi criado para consolidar conhecimentos em desenvolvimento Back-end com Java e Spring Boot, aplicando boas práticas e arquitetura em camadas.

---

🚀 Funcionalidades

👩‍🏫 Professores

• Cadastro/Login
• Criar Cursos
• Editar/Excluir Cursos
• Adicionar/Editar Aulas

👨‍🎓 Alunos

• Cadastro/Login
• Listar Cursos Disponíveis
• Inscrever-se em Cursos
• Visualizar Aulas Inscritas
• Comentar nas Aulas

🔐 Autenticação & Segurança

• Proteção de rotas com JWT
• Regras de autorização baseadas em perfis: STUDENT e TEACHER

---

🛠️ Tecnologias Utilizadas

• Java 17+
• Spring Boot (Web, Data JPA, Security)
• PostgreSQL (ou H2 para testes locais)
• Lombok
• Swagger/OpenAPI
• JWT (JSON Web Token)
• Postman
• Maven

---

⚙️ Como Configurar o Projeto

1. Pré-requisitos

• Java 17+
• Maven
• PostgreSQL

2. Clonar o Repositório

git clone https://github.com/thalesbensi/CoursesManagementAPI

3. Configurar o Banco de Dados

No arquivo src/main/resources/application.properties, configure as informações do banco:

spring.datasource.url=jdbc:postgresql://localhost:5432/ead
spring.datasource.username=seu_usuario
spring.datasource.password=sua_senha
spring.datasource.driver-class-name=org.postgresql.Driver
spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.PostgreSQLDialect

4. Executar a Aplicação

mvn spring-boot:run

A aplicação estará disponível em: http://localhost:8080

🔧 Endpoints Principais

📘 Cursos

• POST /courses – Criar novo curso (PROFESSOR)
• GET /courses – Listar cursos
• PUT /courses/{id} – Atualizar curso (PROFESSOR)
• DELETE /courses/{id} – Deletar curso (PROFESSOR)

---

🎥 Aulas

• POST /lessons/{courseId} – Adicionar aula a um curso
• GET /lessons/{courseId} – Listar aulas do curso
• PUT /lessons/{id} – Atualizar aula
• DELETE /lessons/{id} – Deletar aula

---

📝 Comentários

• POST /comments/{lessonId} – Comentar em aula (ALUNO)
• GET /comments/{lessonId} – Listar comentários da aula

---

📥 Inscrições

• POST /enrollments/{courseId} – Inscrever-se em um curso
• GET /enrollments/my – Ver cursos inscritos

---

🔐 Autenticação

• POST /auth/register – Registrar usuário (ALUNO ou PROFESSOR)
• POST /auth/login – Autenticar e receber token JWT

Payload de Registro

{
  "login": "usuario",
  "password": "senha",
  "role": "STUDENT" // ou "TEACHER"
}

Payload de Login

{
  "login": "usuario",
  "password": "senha"
}

📑 Documentação da API

A documentação dos endpoints é gerada automaticamente com Swagger.
Acesse no navegador:

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

---

🔐 Autorização JWT

A API utiliza autenticação via JWT (JSON Web Token) para proteger rotas.
Inclua o token JWT no cabeçalho das requisições autenticadas, no seguinte formato:

Authorization: Bearer {seu_token_jwt}

---

📦 Docker

A aplicação está pronta para ser executada com Docker utilizando Docker Compose, facilitando a configuração do ambiente completo com API e banco de dados PostgreSQL.

---

1. Configurar Variáveis de Ambiente

Crie um arquivo chamado .env na raiz do projeto com o seguinte conteúdo:

# Banco de Dados
POSTGRES_DB=coursesdb
POSTGRES_USER=seu_usuario
POSTGRES_PASSWORD=sua_senha

• 🔐 Substitua seu_usuario e sua_senha pelos valores desejados.
• O Docker Compose utilizará automaticamente essas variáveis ao subir os containers.

2. Subir a Aplicação com Docker

Com o .env configurado, execute:

docker-compose up --build

Isso irá:

• Subir um container PostgreSQL com os dados definidos

• Subir a API Spring Boot já conectada ao banco

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

    API: http://localhost:8080

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

3. Parar a Aplicação

Para encerrar e remover os containers:

docker-compose down

✅ Benefícios

    - Setup rápido e padronizado com .env + docker-compose

    - Sem necessidade de instalar PostgreSQL localmente