marniegrenat / passagexpress

Desafio proposto pelo IT Academy 17 (programa de estágio da Dell)

Desafio-Dell

Desafio proposto pelo IT Academy 17 (Programa de estágio da Dell).

Author: Gabriela Dellamora Paim

Version: V.1 - 2022.08.24

Operational System: Linux Ubuntu 22.04.1 LTS

Etapa 2 - Apresentação

OneDrive

Este projeto simula um sistema de reserva de passagens de ônibus, sendo todos os veículos da linha 160 (Porto Alegre -> Florianópolis, com parada na cidade de Criciúma) e com 46 assentos.

Rota	Horário	Valor
Porto Alegre -> Florianópolis	06 horas	R$: 19.45
Porto Alegre -> Florianópolis	16 horas	R$: 23.50
Porto Alegre -> Criciúma	06 horas	R$: 12.90
Porto Alegre -> Criciúma	16 horas	R$: 15.90
Criciúma -> Florianópolis	10 horas	R$: 07.30
Criciúma -> Florianópolis	20 horas	R$: 10.30

O sistema DEVERÁ iniciar mostrando o mapa de assentos na tela (em modo texto), com cerca de 30% dos assentos já ocupados sendo metade deles passageiros de Porto Alegre à Florianópolis e a outra metade de Porto Alegre à Criciúma, não importando se as reservas serão manuais, fixas ou aleatórias.

Funcionalidades necessárias

1. [seat map visualizer] ADD LINK

Representar em modo texto o estado de cada assento (occupied/available)

1. Para o horário das 6h
2. Para o horário das 10h
3. Para o horário das 16h
4. Para o horário das 20h

2. [ticket booking] ADD LINK

Permitir que o usuário escolha um assento livre para o horário que deseja. O programa deverá solicitar o identificador do assento (INT). Caso disponível, o programa deve assinalar o assento como occupied. Caso contrário, deverá exibir uma mensagem ao usuário e retornar ao menu.

1. Uma passagem para a rota Porto Alegre -> Florianópolis
2. Uma passagem para a rota Porto alegre -> Criciúma
3. Uma passagem para a rota Criciúma -> Florianópolis

3. [release booking] ADD LINK

O programa deverá solicitar o identificador do assento e liberá-lo.

4. [find free seats] ADD LINK

Solicitar ao usuário quantos assentos ele gostaria de reservar em um determinado horário. Nessa etapa, é necessário que seja mais de um assento e localizar a primeira sequência de assentos (assentos lado a lado) que estiver disponível e marcá-los como ocupados (para o usuário). Caso não haja uma sequência disponível, exibir uma mensagem ao usuário.

5. [statistic data] ADD LINK

Exibir o mapa de assento da rota e apresentar as seguintes informações: número de assentos total, número de assentos disponíveis, número de assentos reservados e total acumulado em reservas.

1. Uma passagem para a rota Porto Alegre -> Florianópolis
2. Uma passagem para a rota Porto alegre -> Criciúma
3. Uma passagem para a rota Criciúma -> Florianópolis

6. [break]

Permitir que usuário saia do programa/finalize o programa.

Observações do processo seletivo:

1. Sugere-se o desenvolvimento de um programa na linguagem e na interface de sua preferência, podendo ser gráfica ou textual/console, com um menu com as opções enumeradas nos requisitos;
2. Deve-se escrever o código que realiza as funções requeridas e armazena os dados lidos em memória (do jeito que quiser);
3. Não é necessário gravar dados em nenhum formato, nem usar sistemas de banco de dados;
4. O programa deverá lidar com dados de entrada inválidos e informar uma mensagem adequada caso ocorram;
5. Para facilitar, não é necessário lidar com acentuação de palavras;
6. Na escrita do relatório, apresente comentários sobre como você realizou os testes e a autoavaliação.

Observações da programadora:

O objetivo atual é construir uma lógica para inserção do código para um site e um aplicativo. A principio, a decisão inicial será fazer o código das atividades do projeto em Python3. Caso haja tempo para a HUD do projeto, tem-se com objetivo o criar com JavaScript. O programa será desenvolvido da mesma forma que proposto: a main conterá todos tópicos contidos na "Etapa 2 - Apresentação", enquanto as funcionalidades serão separadas da mesma forma que os tópicos na "Funcionalidades Necessárias", em arquivos diferentes.

Todo projeto será desenvolvido usando as seguintes ferramentas:

• GitHub
• Git
• Jupyter Notebook / Jupyter Lab

Anotações:

Aprofundar programação orientada a objetos. Aprender a criar projetos em python.

Main

Linguagem: Java

Na main, vou fazer uso dos métodos criados para cada uma das funcionalidades necessárias (cada uma em um arquivo diferente). Todas variáveis serão inseridas neste código. O objetivo da apresentação dos assentos será fazer apresentação de 5 colunas, sendo a mediana vazia para simular o corredor. (a lógica é: index começa em zero, portanto as duas primeiras colunas da esquerda sempre serão ímpares, então se "index % 2 !=0, imprimir o corredor") a letra "O" significará assento livre, enquanto a letra "X" significará assento ocupado.

LEMBRANDO QUE

O programa deve OBRIGATORIAMENTE apresentar 30% dos assentos já ocupados, sendo metade desses com destino à Florianópolis e a outra metade para Criciúma. A primeira versão do programa selecionará os assentos ocupados de forma fixa, para evitar desperdício de tempo em assets detalhistas.

Explicando o código Main.java:

• importando bibliotecas java (Scanner e Locale);
• criando classes Main / main;
• instanciando objetos e variaveis;
• settando onibus info: quais assentos, quais são ocupados (de forma randômica);
• saudação ao usuário;
• primeiro contato com user (Scanner in);
• define local inicial(STRING) ("Cidade Inicial" do OBJ usuario);
• checa local inicial (se válido);
• testa se local inicial == Criciúma. Caso sim, destino == Florianópolis;
• se local inicial != Criciúma, perguntar destino;
• define destino(STRING);
• checa destino (se válido);
• saindo do loop "checa destino", decide tabela usando local (inicial) + destino;
• apresenta tabela de horarios, preços e digitos específico do local inicial + destino;
• pergunta ao usuario qual horário da viagem;
• pergunta ao usuario quantos passageiros; (sempre menor que 15);
• apresenta busvisualizer;
• pergunta ao usuário quais assentos deseja ocupar;
• testa se assentos escolhidos já estão ocupados ou se são válidos;
• se nenhum problema, setta assentos escolhidos como assentos ocupados; (fazer ainda);
• apresenta info sobre a compra ao usuário e pede confirmação;
• se sim, retorna true, se não, retorna false e (deve) reinicializar a operação.

Métodos

No programa, desenvolve-se dois objetos: Onibus e Usuario. O objetivo é que cada um tenha seu próprio databank para controle tanto do usuário quanto da empresa. #Objeto - Onibus Aqui, vai ser listado os métodos implementados na classe Onibus e suas utilidades.

getOcupacao()

• return ocupacao;
• serve para acessar o atributo privado ocupacao; setOcupacao(String[] o)
• no return;
• serve para settar todos os valores dentro do array o(ocupacao) em "O", que significa desocupado no nosso código.

ranOcupacao(String[] o)

• no return;
• serve para randomizar assentos ocupados (referenciados por "X" dentro do array);
• separam os assentos randomizados em 2 grupos, cada um é referenciado em um dos dois arrays que representam o destino do usuário.

getAssentos()

• return assentos;
• serve para acessar o atributo privado assentos;

setAssentos(int[] a)

• no return;
• serve para settar todos valores dentro do array a(assentos) de 1 até 46, de forma sequencial e ordenada.

busVisualizer()

• no return;
• É um método para representar graficamente o ônibus para facilitar o uso do usuário.

testOcupacao(int i)

• return boolean;
• testa se o assento está ocupado ou não.

**testIndex(int user, int index, String destino){ ##BUGS: O que devo resolver:

• método Onibus.procuraPassagem (não retorna valor válido.)
• método Usuario.confirmaUser (viagem termina em NULL, compra-se 0 passagens, valor total = 0.00. Nao aceita valor válido).