Desafio criado por Lucas Carrilho - @devmagro
Twitter: @devmagro 🐦
Instagram: @devmagro 📸
YouTube: @devmagro 🎥
Você chegou ao primeiro grande desafio do guia! 😎 Agora, é hora de colocar a mão na massa e aplicar seus conhecimentos na prática, criando um Sistema de Adoção para Pets!
Leia TODO o desafio com ATENÇÃO antes de começar a faze-lo e respeite as regras, evite o uso do GPT ao máximo e use-o com sabedoria quando necessário!
Neste desafio, você será desafiado a criar um sistema de cadastro via CLI (interface de linha de comando), para nossos futuros adotantes poderem escolher o seu animalzinho.
O dono do abrigo de animais que será o usuário do seu programa será capaz de:
- Cadastrar um novo pet
- Buscar dados do pet cadastrado
- Deletar um pet cadastrado
- Listar todos os pets cadastrados
- Listar pets por algum critério (idade, nome, raça)
- E muito mais!
O sistema deve ser implementado utilizando conceitos de Orientação a Objetos e outras boas práticas de programação. 🚀
- Orientação a Objetos (OO)
- Manipulação de arquivos e arrays
- Java IO
- Exceções
- Boas práticas de código
- File Systems
O desafio será organizado em PASSOS em que você irá desenvolver novas funcionalidades para nossa aplicação CLI.
Fique a vontade para criar e organizar entidades, serviços, utils e como desejar para este projeto!
Para iniciar, crie um Fork deste repositório e clone-o em sua máquina local, e também deixe sua ⭐ no repositório.
Crie um arquivo chamado formulario.txt, que deverá conter as seguintes perguntas:
1 - Qual o nome e sobrenome do pet?
2 - Qual o tipo do pet (Cachorro/Gato)?
3 - Qual o sexo do animal?
4 - Qual endereço e bairro que ele foi encontrado?
5 - Qual a idade aproximada do pet?
6 - Qual o peso aproximado do pet?
7 - Qual a raça do pet?
Sua aplicação deve ler o conteúdo desse arquivo .txt e exibir as perguntas no terminal.
Não é permitido usar o "print" nas perguntas no código, você deverá LER o arquivo!
Após o arquivo estar printando o conteúdo do formulario.txt no terminal, você deverá criar um menu inicial com as seguintes opções:
- Cadastrar um novo pet
- Alterar os dados do pet cadastrado
- Deletar um pet cadastrado
- Listar todos os pets cadastrados
- Listar pets por algum critério (idade, nome, raça)
- Sair
O menu deve ser exibido no terminal e o usuário deve poder escolher uma opção digitando o número correspondente.
- O usuário não poderá usar 0 ou números negativos.
- Caso o usuário digite um número inválido, o menu deve ser exibido novamente.
- O usuário só poderá digitar números, não podendo digitar letras ou caracteres especiais.
O usuário, ao selecionar a opção 1, deve ser capaz de cadastrar um novo pet.
Neste momento, você deverá ler as PERGUNTAS do arquivo formulario.txt e armazenar as respostas em um objeto do tipo Pet.
- O usuário obrigatoriamente deverá cadastrar um pet com nome e sobrenome, caso contrário, lance uma exceção.
- O nome completo NÃO poderá conter caracteres especiais, somente letras de A-Z.
- Para o TIPO e SEXO do pet, você deverá usar ENUM.
- Na pergunta sobre o endereço, você deverá perguntar:
- Número da casa
- Cidade
- Rua
- Na idade e peso aproximados do pet, o usuário poderá digitar números com vírgulas ou ponto, mas somente números.
- Caso o usuário digite um peso maior que 60kg ou um peso menor que 0.5kg, lance uma exceção.
- Caso o usuário digite uma idade maior que 20 anos, lance uma exceção.
- Caso o usuário digite uma idade menor que 1 ano (idade em meses), transforme em 0.x anos.
- No campo raça o usuário não poderá usar números nem caracteres especiais.
- Nas perguntas sobre NOME, RAÇA, PESO, IDADE e ENDEREÇO (somente o campo número), caso o usuário NÃO INFORME ou deixe em branco, você deverá preencher com NÃO INFORMADO (deve ser uma constante)!
Agora, ao salvar o PET em um objeto, você deverá salvar as respostas em um arquivo .txt com o nome formatado da seguinte maneira:
20231101T1234-FLORZINHADASILVA.TXT.
- O nome do arquivo deverá seguir o formato: ano, mês, dia,T, hora, minuto - NOME+SOBRENOME em maiúsculo.
- O arquivo deverá ser salvo na pasta
petsCadastradosna raiz do projeto. - O conteúdo do arquivo deverá conter TODAS AS RESPOSTAS POR LINHA, ou seja, cada resposta deverá estar em uma linha diferente.
- O campo endereço deverá ser salvo todo na mesma linha.
- O arquivo somente conterá RESPOSTAS, PERGUNTAS NÃO!
Exemplo de arquivo salvo:
1 - Florzinha da Silva
2 - Gato
3 - Femea
4 - Rua 2, 456, Seilandia
5 - 6 anos
6 - 5kg
7 - Siames
O usuário, ao selecionar a opção 2, deverá ser capaz de buscar o pet usando determinados dados. O usuário poderá buscar o pet por:
- Nome ou sobrenome
- Sexo
- Idade
- Peso
- Raça
- Endereço
Além disso, o usuário poderá combinar de 1 a 2 critérios de busca, ou seja:
- Nome e / ou sobrenome E IDADE
- Idade E peso
Então, neste momento, você deverá EXIBIR um novo menu perguntando sobre quais critérios o usuário desejará usar para buscar o pet.
Após o usuário selecionar os critérios, você deverá printar no terminal os pets que correspondem aos critérios de busca, podendo ser 1 ou mais, neste formato:
- O usuário PRIMEIRAMENTE e SEMPRE deverá escolher o critério TIPO DE ANIMAL.
- O formato de resposta, deverá exibir SEMPRE uma lista de possiveis resultados, por exemplo:
1. Rex - Cachorro - Macho - Rua 1, 123 - Cidade 1 - 2 anos - 5kg - Vira-lata
2. Florzinha da Silva - Gato - Femea - Rua 2, 456 - Seilandia - 6 anos - 5kg - Siames
- Caso o usuário escolha por exemplo, NOME, os resultados da busca devem trazer PARTES do nome, por exemplo, caso ele pesquise por FLOR, deverá trazer o caso 2 citado anteriormente.
- Toda busca deverá ser case-sensitive, ou seja, ignorar maiuscula e minuscula (tratando como iguais) e acentos.
- Permitir que o usuário busque por DATA de CADASTRO no sistema, por exemplo, você informa mês e ano (+ 1 ou 2 critérios) e ele traz essas informações
- Ao imprimir os resultados encontrados, colocar em NEGRITO o termo da pesquisa utilizado quando for encontrado na resposta. (Exemplo: Se ele pesquisar por FLOR, o nome do pet deverá ser impresso em NEGRITO)
Permitir que o usuário altere os dados de um pet cadastrado.
- O usuário deverá BUSCAR seguindo os critérios da resposta anterior.
- Caso o usuário digite um número de busca inválido, o menu de busca deverá ser exibido novamente.
- O usuário receberá uma LISTA (igual a exibição anterior) com os resultados da busca, e deverá escolher o número do pet que deseja alterar.
- O usuário poderá alterar TODOS os dados do pet, EXCETO o TIPO E SEXO
O usuário, ao selecionar a opção de 4, deverá ser capaz de deletar o pet.
- O usuário deverá BUSCAR seguindo os critérios da resposta anterior.
- Caso o usuário digite um número de busca inválido, o menu de busca deverá ser exibido novamente.
- O usuário receberá uma LISTA (igual a exibição anterior) com os resultados da busca, e deverá escolher o número do pet que deseja deletar.
- O usuário deverá confirmar a exclusão do pet, digitando SIM ou NÃO.
- Só poderá ser deletado um pet por vez.
- Caso o usuário digite SIM, o pet deverá ser deletado e uma mensagem de sucesso deverá ser exibida.
Ao selecionar a opção 5, o programa deverá ser encerrado.
Caso você tenha concluído todos os passos anteriores, você poderá implementar uma funcionalidade extra para o seu programa.
Você irá criar na tela inicial, uma nova tela de opções, sendo:
1 - Iniciar o sistema para cadastro de PETS
2 - Iniciar o sistema para alterar formulário
Caso o usuário escolha a opção 2, você deverá exibir um novo menu com as seguintes opções:
- Criar nova pergunta
- Alterar pergunta existente
- Excluir pergunta existente
- Voltar para o menu inicial
- Sair
- O usuário deverá digitar a nova pergunta, e você deverá salvar no arquivo
formulario.txta nova pergunta - A pergunta deverá SEGUIR a ordem com a númeração obrigatória, ou seja, ele deverá olhar para a pergunta ANTERIOR e adicionar +1 na númeração.
- Novas perguntas não tem obrigatoriedade de resposta, mas caso o usuário NÃO responda, coloque um NÃO INFORMADO.
- O usuário NÃO PODERÁ modificar as perguntas ORIGINAIS (de 1 a 7), somente as perguntas que ele adicionou.
- O usuário deverá digitar o número da pergunta que deseja alterar,então você deverá printar na tela e oferecer a opção a ser alterada.
- O usuário poderá alterar a pergunta, mas não a resposta, ou seja, você deverá perguntar a nova pergunta e salvar no arquivo.
- O usuário NÃO PODERÁ deletar as perguntas ORIGINAIS (de 1 a 7), somente as perguntas que ele adicionou.
- O usuário deverá digitar o número da pergunta que deseja deletar, então você deverá printar na tela e oferecer a opção a ser deletada.
- O usuário deverá confirmar a exclusão da pergunta, digitando SIM ou NÃO.
- Caso existam 9 perguntas (2 adicionadas), e o usuário DELETE A PERGUNTA 8, a pergunta 9 deverá tomar o lugar da 8.
- Não deixe NENHUMA LINHA VAZIA no arquivo de perguntas ou de respostas, sempre reorganize-os
- Ao perguntar uma das novas PERGUNTAS adicionadas (caso existam), você deverá ler o arquivo de perguntas e exibir as perguntas adicionadas normalmente.
- Caso o usuário RESPONDA, o arquivo salvo com o pet deverá conter a resposta da pergunta adicionada no seguinte formato:
1 - Florzinha da Silva
2 - Gato
3 - Femea
4 - Rua 2, 456, Seilandia
5 - 6 anos
6 - 5kg
7 - Siames
8 - [EXTRA - PERGUNTA NOVA ADICIONADA] - RESPOSTA DO USUÁRIO
9 - [EXTRA - PERGUNTA NOVA ADICIONADA] - RESPOSTA DO USUÁRIO
-
Siga implementando o projeto e fazendo commits à medida que for concluindo as funcionalidades, seguindo o padrão sempre de Conventional commits
-
Crie um arquivo README.md com uma descrição do seu projeto e instruções de como executá-lo.
Se você chegou até aqui, parabéns! Você concluiu o primeiro grande desafio do guia. 🚀