qualidade_software

Projeto de Qualidade Educacional

Este é um projeto educacional em Java usando Spring Boot e Maven para ensinar conceitos de qualidade aos alunos. O projeto implementa um sistema simples de cadastro de alunos e professores com uma interface web básica.

Funcionalidades

• Cadastro e gerenciamento de alunos
• Cadastro e gerenciamento de professores
• Interface web simples usando Thymeleaf e Bootstrap
• Banco de dados MongoDB para armazenamento de documentos

Tecnologias Utilizadas

• Java 17
• Spring Boot 3.2.0
• Maven
• Spring Data MongoDB
• Thymeleaf
• Bootstrap
• Banco de Dados MongoDB

Conexão ao Banco de Dados

Este projeto utiliza um banco de dados MongoDB hospedado remotamente para fins educacionais:

mongodb://mongo:XdnCdkmKwzJiKHiryTDzdgRGOxzNQYtA@crossover.proxy.rlwy.net:24258

Começando

Pré-requisitos

• Java 17 ou superior
• Maven 3.6.0 ou superior

Instalação do Maven

No Windows:

1. Baixe o Maven do site oficial: https://maven.apache.org/download.cgi
2. Extraia o arquivo ZIP para um diretório como C:\apache-maven-3.9.5
3. Adicione a variável de ambiente MAVEN_HOME apontando para o diretório do Maven
4. Adicione %MAVEN_HOME%\bin ao seu PATH
5. Verifique a instalação com o comando:

   mvn -version
   

No Linux (Ubuntu/Debian):

sudo apt update
sudo apt install maven

No Linux (CentOS/RHEL/Fedora):

sudo yum install maven
# ou para Fedora:
sudo dnf install maven

Executando a Aplicação

1. Clone o repositório
2. Navegue até o diretório do projeto
3. Execute a aplicação usando Maven:

./mvnw spring-boot:run

Ou construa e execute o JAR:

./mvnw clean package
java -jar target/educational-quality-project-0.0.1-SNAPSHOT.jar

Comandos úteis do Maven

• Para compilar o projeto: mvn compile
• Para executar os testes: mvn test
• Para empacotar o projeto: mvn package
• Para limpar os arquivos gerados: mvn clean
• Para executar a aplicação: mvn spring-boot:run

Acessando a Aplicação

Após iniciar a aplicação, você pode acessá-la em:

• Página principal: http://localhost:8080
• Página de alunos: http://localhost:8080/students
• Página de professores: http://localhost:8080/teachers

API Endpoints

A aplicação também disponibiliza endpoints RESTful para integração com outras aplicações:

Estudantes

• GET /api/students - Listar todos os estudantes
• GET /api/students/{id} - Obter detalhes de um estudante específico
• POST /api/students - Criar um novo estudante
• PUT /api/students/{id} - Atualizar informações de um estudante
• DELETE /api/students/{id} - Excluir um estudante

Professores

• GET /api/teachers - Listar todos os professores
• GET /api/teachers/{id} - Obter detalhes de um professor específico
• POST /api/teachers - Criar um novo professor
• PUT /api/teachers/{id} - Atualizar informações de um professor
• DELETE /api/teachers/{id} - Excluir um professor

Estrutura do Projeto

• entity/ - Entidades MongoDB para Aluno e Professor
• repository/ - Interfaces da camada de acesso a dados
• service/ - Camada de lógica de negócios
• controller/ - Controladores web
• templates/ - Templates Thymeleaf com Bootstrap

Valor Educacional

Este projeto demonstra:

• Operações CRUD básicas
• Arquitetura MVC
• Fundamentos do Spring Boot
• Uso do Spring Data MongoDB
• Injeção de dependência
• Design de API RESTful
• Integração com banco de dados NoSQL
• Template frontend com Thymeleaf