Termos e acordos

Ao iniciar este projeto, você concorda com as diretrizes do Código de Ética e Conduta e do Manual da Pessoa Estudante da Trybe.

---

Boas vindas ao repositório do desafio da Aceleração Java!

Você já usa o GitHub diariamente para desenvolver os exercícios, certo? Agora, para desenvolver o desafio, você deverá seguir as instruções a seguir. Fique atento a cada passo, e se tiver qualquer dúvida, nos envie por Slack! #vqv 🚀

Aqui você vai encontrar os detalhes de como estruturar o desenvolvimento do seu desafio a partir deste repositório, utilizando uma branch específica e um Pull Request para colocar seus códigos.

---

Instruções para entregar seu projeto

Não se esqueça de consultar as documentações!

⚠️ Importante:

Esse projeto tem como intuito te treinar para ter mais familiaridade com a documentação de aplicações, por tanto, poderão haver alguns comandos ou atributos que não estão no curso, mas que devem ser descritos no decorrer dos requisitos.

Nesses casos, é importante se atentar a aquilo que o requisito pede, e lembrar sempre de utilizar a documentação oficial do Java para pesquisar detalhes sobre comandos.

Antes de começar a desenvolver

Lembre-se que você pode consultar nosso conteúdo sobre Git & GitHub sempre que precisar!

1. Clone o repositório

• Por exemplo: git clone git@github.com:tryber/desafio-aceleracao.git
• Entre no diretório do repositório que você acabou de clonar:
  • neste caso cd desafio-aceleracao

2. Instale as dependências:

   • mvn install

3. Crie uma branch a partir da branch main

• Verifique que você está na branch main
  • Exemplo: git branch
• Se não estiver, mude para a branch main
  • Exemplo: git checkout main
• Agora, crie uma branch onde você vai guardar os commits do seu desafio
  • Você deve criar uma branch no seguinte formato: nome-de-usuario-nome-do-desafio
  • Exemplo:
    • git checkout -b joaozinho-acc-java-sample

4. Adicione a sua branch com o novo commit ao repositório remoto

• Usando o exemplo anterior:
  • git push -u origin joaozinho-acc-java-sample

5. Crie um novo Pull Request (PR)

• Vá até a aba de Pull Requests deste repositório no GitHub
• Clique no botão verde "New pull request"
• Clique na caixa de seleção "Compare" e escolha a sua branch com atenção
• Clique no botão verde "Create pull request"
• Adicione uma descrição para o Pull Request e clique no botão verde "Create pull request"
• Não se preocupe em preencher mais nada por enquanto!
• Volte até a página de Pull Requests do repositório e confira que o seu Pull Request está criado

⚠️ Lembre-se do CheckStyle! Deixe seu Eclipse configurado para arrumar o estilo automaticamente. Qualquer dúvida, volte no conteúdo.

---

Durante o desenvolvimento

• ⚠ PULL REQUESTS COM ISSUES NO CHECKSTYLE NÃO SERÃO AVALIADAS, ATENTE-SE PARA RESOLVÊ-LAS ANTES DE FINALIZAR O DESENVOLVIMENTO! ⚠

• Faça commits das alterações que você fizer no código regularmente

• Lembre-se de sempre após um (ou alguns) commits atualizar o repositório remoto

• Os comandos que você utilizará com mais frequência são:

  1. git status (para verificar o que está em vermelho - fora do stage - e o que está em verde - no stage)
  2. git add (para adicionar arquivos ao stage do Git)
  3. git commit (para criar um commit com os arquivos que estão no stage do Git)
  4. git push -u origin nome-da-branch (para enviar o commit para o repositório remoto na primeira vez que fizer o push de uma nova branch)
  5. git push (para enviar o commit para o repositório remoto após o passo anterior)

---

Depois de terminar o desenvolvimento (opcional)

Para "entregar" seu projeto, siga os passos a seguir:

• Vá até a página DO SEU Pull Request, adicione a label de "code-review" e marque seus colegas
  • No menu à direita, clique no link "Labels" e escolha a label code-review
  • No menu à direita, clique no link "Assignees" e escolha o seu usuário
  • No menu à direita, clique no link "Reviewers" e digite students, selecione o time tryber/students-sd-0x

Se ainda houver alguma dúvida sobre como entregar seu projeto, aqui tem um video explicativo.

---

Requisitos do desafio

Fazer uma conta poupança

Suponha que você está trabalhando em uma equipe responsável pela construção de um sistema bancário e deve desenvolver a classe que representa a conta poupança. Como missão dada é missão cumprida, crie um novo projeto Java no Eclipse nomeado Banco. Dentro desse projeto, crie uma classe ContaPoupanca, que deve contemplar os seguintes aspectos:

• Atributos:

  • saldo: atributo do tipo double para armazenar o valor em dinheiro que a conta possui;
  • titularConta: atributo do tipo String para armazenar o nome da pessoa portadora da conta.

• Métodos:

  • depositar: esse método é responsável por receber um valor do tipo double e somá-lo ao saldo da conta;
  • sacar: esse método é responsável por receber um valor do tipo double e subtraí-lo do saldo da conta;
  • mostrarSaldo: esse método deve retornar um valor do tipo double representando o saldo da conta.
  • mostrarTitularConta: esse método deve retornar o nome da pessoa titular da conta.

Essa conta poupança tem duas restrições a serem levadas em conta no seu projeto:

• ela só pode ser aberta se um depósito for feito no momento da sua abertura;
• ela deve ter o nome da pessoa titular da conta.

Dica: use o construtor para adicionar o valor do depósito inicial ao saldo na abertura da conta e o nome da pessoa titular da conta.

Exemplo

Considerando que uma pessoa abra a conta poupança com o valor inicial de R$ 50, cada método deve se comportar da seguinte maneira:

• depositar: supondo que o saldo da conta seja R$ 50 e na chamada do método depositar seja passado o valor de R$ 100 como argumento, o método deve somar o valor 100 ao saldo, fazendo o valor do saldo ser atualizado para 150;
• sacar: supondo que o saldo da conta seja R$ 50 e na chamada do método sacar seja passado o valor de R$ 30 como argumento, o método deve subtrair o valor 30 do saldo, fazendo o valor do saldo ser atualizado para 20;
• mostrarSaldo: supondo que o saldo da conta seja R$ 50, então o retorno desse método deve ser 50.
• mostrarTitularConta: supondo que o nome da pessoa dona da conta seja Carla Pereira, esse método deve retornar um valor do tipo String contendo Carla Pereira.

---

Avisos Finais

Ao finalizar e submeter o desafio, não se esqueça de avaliar sua experiência preenchendo o formulário. Leva menos de 3 minutos!

Link: Formulário

O avaliador automático não necessariamente avalia seu projeto na ordem em que os requisitos aparecem no readme. Isso acontece para deixar o processo de avaliação mais rápido. Então, não se assuste se isso acontecer, ok?

---