Aplicativo de Caronas Compartilhadas

Introdução

• Plataforma de intermediação entre motoristas e passageiros, focada em mobilidade sustentável e redução de custos de deslocamento.
• O aplicativo de caronas compartilhadas é uma solução digital que conecta motoristas com vagas disponíveis em seus veículos a passageiros que desejam compartilhar uma rota em comum.
  
• O objetivo principal é promover a mobilidade sustentável, reduzir custos de deslocamento e minimizar o impacto ambiental ao diminuir o número de veículos em circulação.

Estrutura do Projeto

Camada	Elementos
Model	Usuário, ViagemModel, CategoriaModel
Repository	UsuarioRepository, ViagemRepository, CategoriaRepository
Service	UsuarioService, ViagemService, CategoriaService
Controller	UsuarioController, ViagemController, CategoriaController,

Documentação de Testes de API - Sistema de Viagens

Este repositório contém os testes realizados para a API de gerenciamento de viagens. A API oferece diversas funcionalidades para gerenciar viagens, como visualizar viagens por destino, por ID, criar novas viagens, atualizar e cancelar viagens. Abaixo estão os testes realizados para garantir que cada endpoint da API esteja funcionando corretamente.

Testes Realizados

1. Visualizar Viagens por Destino (GET)

Teste	Descrição	Resultado Esperado
Destino válido	Verificar se o sistema retorna viagens válidas para um destino válido.	Status HTTP 200 e lista de viagens para o destino.
Destino inválido	Verificar se o sistema retorna erro quando o destino não existe.	Status HTTP 404 e mensagem de erro adequada.
Destino sem viagens	Verificar se o sistema retorna uma lista vazia quando o destino não tem viagens.	Status HTTP 200 e lista vazia de viagens.

2. Visualizar Todas as Viagens (GET)

Teste	Descrição	Resultado Esperado
Ver todas as viagens	Verificar se o sistema retorna todas as viagens cadastradas.	Status HTTP 200 e lista completa de viagens.
Formato da lista de viagens	Verificar se a lista de viagens é retornada no formato correto.	Status HTTP 200 e formato JSON adequado.

3. Visualizar Viagem por ID (GET)

Teste	Descrição	Resultado Esperado
ID válido	Verificar se a viagem é retornada corretamente quando um ID válido é fornecido.	Status HTTP 200 e dados da viagem correspondentes ao ID fornecido.
ID inválido	Verificar se o sistema retorna erro quando o ID não existe.	Status HTTP 404 e mensagem de erro adequada.

4. Nova Viagem (POST)

Teste	Descrição	Resultado Esperado
Viagem válida	Verificar se o sistema cria uma viagem com dados válidos.	Status HTTP 201 (Criado) e dados da viagem criada.
Dados inválidos	Verificar se o sistema retorna erro quando dados inválidos são fornecidos.	Status HTTP 400 (Bad Request) e mensagem de erro adequada.

5. Atualizar Viagem (PUT)

Teste	Descrição	Resultado Esperado
Atualização válida	Verificar se o sistema atualiza corretamente os dados de uma viagem existente.	Status HTTP 200 (OK) e dados atualizados da viagem.
ID não encontrado	Verificar se o sistema retorna erro quando o ID da viagem não existe.	Status HTTP 404 (Not Found) e mensagem de erro adequada.

6. Cancelar Viagem (DELETE)

Teste	Descrição	Resultado Esperado
Cancelamento válido	Verificar se a viagem é cancelada corretamente com ID válido.	Status HTTP 200 (OK) e confirmação de cancelamento.
ID não encontrado	Verificar se o sistema retorna erro quando o ID da viagem não existe.	Status HTTP 404 (Not Found) e mensagem de erro adequada.

UML - Diagrama de Classes

Stack utilizada

Back-end:

• Java 17
• Spring Boot API REST
• Spring Web
• Spring Boot Dev Tools
• Validation
• Spring Data JPA
• MySQL Driver

Autores

• @Martinelii
• @biancasuarz
• @Kagradiel
• @DandaraaAfroo
• @GabrielJonatas