Este projeto apresenta o novo sistema de parquímetro desenvolvido para atender às necessidades de uma cidade turística com uma população de 300.000 habitantes. Durante a alta temporada, a cidade recebe em média 250.000 visitantes adicionais, resultando em um aumento significativo no número de veículos. O sistema antigo, sendo lento, não escalável e não confiável, está sendo substituído por este novo sistema, que foi projetado para lidar com a crescente demanda de estacionamento na cidade.

O sistema de parquímetro oferece funcionalidades como:

• Registro de condutores e veículos
• Controle de tempo estacionado
• Opções flexíveis de pagamento
• Emissão de recibos

• Java Spring Boot: Framework para desenvolvimento do backend.
• MongoDB: Utilizado para o core do sistema.
• PostgreSQL: Usado para armazenar os recibos ao final de cada processo.
• Docker: Ferramenta para criar e gerenciar containers.
• Docker Compose: Orquestração de containers.

• Docker instalado na máquina.

1. Clone o repositório:

   git clone [email protected]:4adjt-group10/park-ease.git
   cd park-ease

2. Execute o projeto com Docker Compose:

   docker-compose up

Após o projeto estar em execução, você pode acessar a documentação e testar as APIs através do Swagger:

• Swagger UI

  http://localhost:8080/swagger-ui/index.html#/

1. No menu superior acesse RUN > Edit configuration;
2. Clique em "Add New Configuration";
3. Selecione a configuração (Remote JVM Debug):
   • 

• Acesse: http://0.0.0.0:8081/db/parkesase/ | http://127.0.0.1:8081/db/parkesase/
• Usuário: admin
• Senha: pass

1. Acesse: http://localhost:5050
2. Credenciais:

• Email: [email protected]
• Senha: admin

3. Configuração do Servidor:

• Clique em Add New Server
• Name: Nome à sua escolha (Ex: ParkEase)
• Connection:
  • Host name/address: postgres
  • Port: 5050
  • Maintenance database: mydatabase
  • Username: myuser
  • Password: secret
• Clique em Save

• Clique em Add New Server
  • Name: Nome à sua escolha (Ex: Postgres-ParkEase)
  • Connection:
    • Host name/address: localhost
    • Port: 5432
    • Maintenance database: mydatabase
    • Username: myuser
    • Password: secret
  • Clique em Save

• Clique em Add New Server
  • Name: Nome à sua escolha (Ex: Mongo-ParkEase)
  • Connection:
    • Host name/address: localhost
    • Port: 27017
    • User: root
    • Password: secret
  • Clique em Save

• http://localhost:8080/swagger-ui/index.html#/administrator-controller/create_1
  • O primeiro valor vigente ou current price nos informamos o valor em value, o nome em name , e currentPrice passamos como true
  • Caso queira criar mais uma tarifa , ela por default nao ficara como currentPrice(valor vigente)
  • Para Alterar o currentPrice devera ter um Update para o currentPrice desejado pela rota http://localhost:8080/swagger-ui/index.html#/administrator-controller/update_1
  • para este caso informaremos o id do preço que se deseja deixar como vigente , o valor o nome e o currentePrice devera estar como true, lembrando que se quiser alterar qualquer um desses parametros pode- se alterar tambem

obs: pode-se cadastrar o condutor junto do veiculo ou separado.

• http://localhost:8080/swagger-ui/index.html#/driver-controller/createDriver
  • Aqui criaremos nosso cadastro de motorista, contendo o primeiro nome(firstName) ,ultimo nome(lastName) ,email(email) ,telefone(phone) ,Endereço(adress) e se quiser um veiculo(vehicle)
  • Para o endereço deve-se informar o endereço(address) ,cidade(city) ,estado(state) ,cep(zipCode) e o pais(cpuntry)
  • Caso queira cadastrar o veiculo nessa parte deve-se informar os dados ,marca(brand) ,modelo(model) ,cor(color) ,ano(year) ,placa(licensePlate) e o tipo(type), neste caso o id do motorista e preenchido automaticamente

• http://localhost:8080/swagger-ui/index.html#/vehicle-controller/create
  • Para se cadastrar um carro, neste ponto primeiro temos que ter o id do motorista em mãos, caso nao tenha , exite um endpoint que lista todos os motoristas http://localhost:8080/swagger-ui/index.html#/driver-controller/listDrivers
  • Contendo o id em mãos ,iniciamos o cadastro do carro passando os parametros marca(brand) ,modelo(model) ,cor(color) ,ano(year) ,placa(licensePlate) e o tipo(type) ,id do motorista (driverId)

• http://localhost:8080/swagger-ui/index.html#/parking-meter-controller/parkin
• Para estacionar o motorista deve informar os seguintes dados
• id do motorista (driverID)
• id do veiculo (vehicleId) ,caso nao tenha pode-se conseguir pela listagem de motorista, onde volta os dados do mesmo e dos veiculos cadastrados por ele
• Selecione o tipo de parada (Fixo/Variavel)
• Selecione o tipo de pagamento (Pix/Cartão) ,sendo pix somente aceito na modalidade de tempo fixo
• Para o caso de tempo fixo , temos que preencher a variavel de tempo estacionado(timeParking), este valor e um numerico sem casas decimais, que sera o total de horas estacionado

• Os avisos de monitoramento são exibidos no terminal da aplicação.

• Cenários:

  • Cenário 1: Selecionada saída para tipo de parada fixa, com permanência apenas no tempo estipulado na entrada http://localhost:8080/swagger-ui/index.html#/parking-meter-controller/leaving:

    • Passado o id do 'arriving' serão apresentadas as seguintes informações:

      • Valor: referente ao cálculo de horas previstas inicialmente * tarifa corrente inicial;
      • Data e horário: De chegada e de saída;
      • Tempo total estacionado: Cálculo de horas entre o momento de entrada e de saída (dentro do intervalo estipulado no momento de entrada);
      • Tarifa corrente: Valor da tarifa corrente no momento de entrada;
      • Valor total pago: Cálculo de horas X tarifa corrente;
      • Os campos de valor extra e tarifa extra deverão estar zerados, já que só foi utilizado o valor estipulado inicialmente;
      • Nome do motorista;
      • Placa do veículo.

    • Durante a saída, serão gerados o pagamento e o 'invoice' com as informações referentes ao pagamento, com informações do motorista e do veículo, o valor, o método de pagamento selecionado e o status do pagamento. Também são apresentadas as datas de criação e processamento.

    • E, por fim, será gerado o voucher com as informações de chegada, saída, tarifas correntes e extra, tempo de permanência, valor pago e id do veículo.

  • Cenário 2: Selecionada saída para tipo de parada fixa, com permanência em tempo superior ao estipulado no momento de entrada http://localhost:8080/swagger-ui/index.html#/parking-meter-controller/leaving:

    • Passado o id do 'arriving' serão apresentadas as seguintes informações:
      • Valor: referente ao cálculo de horas previstas inicialmente * tarifa corrente inicial;
      • Valor extra: valor referente ao cálculo de horas extras * tarifa extra;
      • Data e horário: De chegada e de saída;
      • Tempo total estacionado: Número total de horas de permanência no estacionamento;
      • Tarifa aplicada: Valor da tarifa corrente no momento de entrada;
      • Tarifa extra: Valor da tarifa no momento de saída (aplicada as horas extras de permanência);
      • Valor total pago: Cálculo de: horas previstas inicialmente * tarifa corrente inicial (horas extras * tarifa extra);
      • Nome do motorista;
      • Placa do veículo.
    • Durante a saída, serão gerados o pagamento e o 'invoice' com as informações referentes ao pagamento, com informações do motorista e do veículo, o valor, o método de pagamento selecionado e o status do pagamento. Também são apresentadas as datas de criação e processamento.
    • E, por fim, será gerado o voucher com as informações de chegada, saída, tarifas correntes e extra, tempo de permanência, valor pago e id do veículo.

  • Cenário 3: Selecionada saída para tipo de parada variável http://localhost:8080/swagger-ui/index.html#/parking-meter-controller/leavingVariableTime:

    • Passado o id do 'arriving' serão apresentadas as seguintes informações:
      • Valor: referente ao cálculo de horas estacionadas * tarifa corrente;
      • Data e horário: De chegada e de saída;
      • Tempo total estacionado: Cálculo de horas entre o momento de entrada e de saída;
      • Tarifa corrente: Valor da tarifa corrente;
      • Valor total pago: Cálculo de horas X tarifa corrente;
      • Os campos de valor extra e tarifa extra deverão estar zerados, já que no tipo variável não tem quantidade de horas pré estipulada;
      • Nome do motorista;
      • Placa do veículo.
    • Durante a saída, serão gerados o pagamento e o 'invoice' com as informações referentes ao pagamento, com informações do motorista e do veículo, o valor, o método de pagamento selecionado e o status do pagamento. Também são apresentadas as datas de criação e processamento.
    • E, por fim, será gerado o voucher com as informações de chegada, saída, tarifas correntes e extra, tempo de permanência, valor pago e id do veículo.