my-wallet: A JavaScript repository from Danilo-Couto

O Projeto

Uma carteira de controle de gastos com conversor de moedas, ao utilizar essa aplicação um usuário deverá ser capaz de:

Adicionar, remover e editar um gasto;
Visualizar uma tabelas com seus gastos;
Visualizar o total de gastos convertidos para uma moeda de escolha;

Habilidades

Store Redux em aplicações React
Reducers no Redux em aplicações React
Actions no Redux em aplicações React
Dispatchers no Redux em aplicações React
Conectar Redux aos componentes React
Criar actions assíncronas na sua aplicação React que faz uso de Redux.

Deploy

https://my-wallet-liard.vercel.app/

Documentação da API de Cotações de Moedas

Consumido os dados da API do awesomeapi API de Cotações para realizar a busca de câmbio de moedas. Para realizar essas buscas, consultar o seguinte endpoint:

https://economia.awesomeapi.com.br/json/all

O retorno desse endpoint será algo no formato:

{
   {
     "USD": {
       "code":"USD",
       "codein":"BRL",
       "name":"Dólar Comercial",
       "high":"5.6689",
       "low":"5.6071",
       "varBid":"-0.0166",
       "pctChange":"-0.29",
       "bid":"5.6173",
       "ask":"5.6183",
       "timestamp":"1601476370",
       "create_date":"2020-09-30 11:32:53"
       },
      ...
   }
}

Mais informações sobre a API, veja a documentação.

Lista de requisitos

Página de Login

Crie uma página para que a pessoa usuária se identifique, com email e senha. Esta página deve ser a página inicial de seu aplicativo.

1. Crie uma página inicial de login com os seguintes campos e características:

A rota para esta página deve ser ‘/’.
Você deve criar um local para que a pessoa usuária insira seu email e senha. Utilize o atributo data-testid="email-input" para o email e data-testid="password-input" para a senha.
Crie um botão com o texto ‘Entrar’.
Realize as seguintes verificações nos campos de email e senha, de modo que caso sejam falsas o botão fique desabilitado:
- O email está no formato válido, como 'alguem@alguem.com'.
- A senha possui 6 ou mais caracteres.
Salve o email no estado da aplicação, com a chave email, assim que a pessoa usuária logar.
A rota deve ser mudada para '/carteira' após o clique no botão 'Entrar'.

O que será verificado:

A rota para esta página deve ser "/"
Crie um local para que o usuário insira seu email e senha
Crie um botão com o texto "Entrar"
Realize as seguintes verificações nos campos de email, senha e botão:
Se é um e-mail no formato válido;
Se a senha tem 6 ou mais caracteres;
Desabilitar o botão Entrar caso e-mail e/ou senha estiverem no formato inválido
Habilitar o botão Entrar caso e-mail e senha sejam válidos
Salve o email no estado da aplicação, com a chave email, assim que o usuário logar
A rota deve ser mudada para "/carteira" após o clique no botão

Página da Carteira

Crie uma página para gerenciar a carteira de gastos em diversas moedas, e que traga a despesa total em real que é representado pelo código 'BRL'. Esta página deve ser renderizada por um componente chamado Wallet.

Configurando sua página

2. Crie uma página para sua carteira com as seguintes características:

A rota para esta página deve ser /carteira
O componente deve se chamar Wallet e estar localizado na pasta src/pages no arquivo Wallet.js

O que será verificado:

A rota para esta página deve ser "/carteira"
O componente deve se chamar Wallet e estar localizado na pasta "src/pages"

Header

3. Crie um header para a página de carteira contendo as seguintes características:

Um elemento que exiba o email da pessoa usuária que fez login.
- Adicione o atributo data-testid="email-field".

Dica: você deve pegar o email do estado global da aplicação (no Redux)

Um elemento com a despesa total gerada pela lista de gastos.
- Adicione o atributo data-testid="total-field".
- Inicialmente esse elemento deve exibir o valor 0
Um elemento que mostre qual câmbio está sendo utilizado, que será neste caso será 'BRL'.
- Adicione o atributo data-testid="header-currency-field".

O que será verificado:

Um elemento que exiba o email do usuário que fez login.
Crie um elemento com a despesa total gerada pela lista de gastos.
Crie um elemento que mostre que qual câmbio está sendo utilizado, que será neste caso "BRL"

Formulário de adição de Despesa

4. Desenvolva um formulário para adicionar uma despesa contendo as seguintes características:

Um campo para adicionar valor da despesa.
- Adicione o atributo data-testid="value-input".
Um campo para adicionar a descrição da despesa.
- Adicione o atributo data-testid="description-input".
Um campo para selecionar em qual moeda será registrada a despesa.
- Adicione o atributo data-testid="currency-input".
Um campo para adicionar qual método de pagamento será utilizado.
- Adicione o atributo data-testid="method-input".
- Este campo deve ser um dropdown. A pessoa usuária deve poder escolher entre os campos: 'Dinheiro', 'Cartão de crédito' e 'Cartão de débito'.
Um campo para selecionar uma categoria (tag) para a despesa.
- Este campo deve ser um dropdown. a pessoa usuária deve poder escolher entre os campos: 'Alimentação', 'Lazer', 'Trabalho', 'Transporte' e 'Saúde'.
- Adicione o atributo data-testid="tag-input".

Um botão com o texto 'Adicionar despesa' que salva as informações da despesa no estado global e atualiza a soma de despesas no header.

Desenvolva a funcionalidade do botão "Adicionar despesa" de modo que ao clicar no botão, as seguintes ações sejam executadas:
Os valores dos campos devem ser salvos no estado da aplicação, na chave expenses, dentro de um array contendo todos gastos que serão adicionados:
- O id da despesa deve ser um número sequencial, começando em 0. Ou seja: a primeira despesa terá id 0, a segunda terá id 1, a terceira id 2, e assim por diante.
- Você deverá salvar a cotação do câmbio feita no momento da adição para ter esse dado quando for efetuar uma edição do gasto. Caso você não tenha essa informação salva, o valor da cotação trazida poderá ser diferente do obtido anteriormente.

Atenção nesse ponto: você deverá fazer uma requisição para API e buscar a cotação no momento que o botão de `Adicionar despesa` for apertado. Para isso você deve utilizar um thunk

Após adicionar a despesa, atualize a soma total das despesas. Essa informação deve ficar no header dentro do elemento com data-testid="total-field"

As despesas salvas no Redux ficarão com um formato semelhante ao seguinte:

expenses: [{
  "id": 0,
  "value": "3",
  "description": "Hot Dog",
  "currency": "USD",
  "method": "Dinheiro",
  "tag": "Alimentação",
  "exchangeRates": {
    "USD": {
      "code": "USD",
      "name": "Dólar Comercial",
      "ask": "5.6208",
      ...
    },
    "CAD": {
      "code": "CAD",
      "name": "Dólar Canadense",
      "ask": "4.2313",
      ...
    },
    "EUR": {
      "code": "EUR",
      "name": "Euro",
      "ask": "6.6112",
      ...
    },
    "GBP": {
      "code": "GBP",
      "name": "Libra Esterlina",
      "ask": "7.2498",
      ...
    },
    "ARS": {
      "code": "ARS",
      "name": "Peso Argentino",
      "ask": "0.0729",
      ...
    },
    "BTC": {
      "code": "BTC",
      "name": "Bitcoin",
      "ask": "60299",
      ...
    },
    "LTC": {
      "code": "LTC",
      "name": "Litecoin",
      "ask": "261.69",
      ...
    },
    "JPY": {
      "code": "JPY",
      "name": "Iene Japonês",
      "ask": "0.05301",
      ...
    },
    "CHF": {
      "code": "CHF",
      "name": "Franco Suíço",
      "ask": "6.1297",
      ...
    },
    "AUD": {
      "code": "AUD",
      "name": "Dólar Australiano",
      "ask": "4.0124",
      ...
    },
    "CNY": {
      "code": "CNY",
      "name": "Yuan Chinês",
      "ask": "0.8278",
      ...
    },
    "ILS": {
      "code": "ILS",
      "name": "Novo Shekel Israelense",
      "ask": "1.6514",
      ...
    },
    "ETH": {
      "code": "ETH",
      "name": "Ethereum",
      "ask": "5184",
      ...
    },
    "XRP": {
      "code": "XRP",
      "name": "Ripple",
      "ask": "1.4",
      ...
    }
  }
}]

O que será verificado:

Um campo para adicionar o valor da despesa
Um campo para adicionar a descrição da despesa
Um campo para selecionar em qual moeda será registrada a despesa
Um campo para selecionar qual método de pagamento será utilizado
Um campo para selecionar uma categoria (tag) para a despesa
Um botão com o texto "Adicionar despesa" que salva as informações da despesa no estado global e atualiza a soma de despesas no header

5. Implemente a lógica para preencher as opções do campo "Moedas" buscando as siglas da API

A pessoa usuária deve poder escolher entre os campos: 'USD', 'CAD', 'EUR', 'GBP', 'ARS', 'BTC', 'LTC', 'JPY', 'CHF', 'AUD', 'CNY', 'ILS', 'ETH' e 'XRP'.
Os valores do campo de moedas devem ser puxados através da requisição à API.
- Adicione um atributo data-testid para cada uma das opções acima com o câmbio correspondente, como por exemplo data-testid="USD".
- O endpoint utilizado deve ser: https://economia.awesomeapi.com.br/json/all .
- Remova das informações trazidas pela API a opção 'USDT' (Dólar Turismo).

O que será verificado:

O campo para selecionar em qual moeda será registrada a despesa tem as opções corretas

Tabela de Gastos

6. Desenvolva uma tabela com os gastos contendo as seguintes características:

A tabela deve possuir um cabeçalho exatamente com os campos Descrição, Tag, Método de pagamento, Valor, Moeda, Câmbio utilizado, Valor convertido e Moeda de conversão

O que será verificado:

A tabela deve possuir um cabeçalho com os campos Descrição, Tag, Método de pagamento, Valor, Moeda, Câmbio utilizado, Valor convertido e Moeda de conversão.

7. Implemente a lógica para que a tabela seja alimentada pelo estado da aplicação

A tabela deve ser alimentada pelo estado da aplicação, que estará disponível na chave expenses que vem do reducer wallet.
- O campo de Moeda e Moeda de Conversão deverão conter o nome da moeda. Portanto, ao invés de 'USD' ou 'EUR', deve conter "Dólar Comercial" e "Euro", respectivamente
- Por padrão, o elemento que exibe a 'Moeda de conversão' deverá ser sempre 'Real'.
- Atenção também às casas decimais dos campos. Como são valores contábeis, eles devem apresentar duas casas após a vírgula. Arredonde sua resposta somente na hora de renderizar o resultado, e para os cálculos utilize sempre os valores vindos da API (utilize o campo ask que vem da API).
- Utilize sempre o formato 0.00 (número - ponto - duas casas decimais)
O que será verificado:
- A tabela deve ser alimentada pelo estado da aplicação, que estará disponível na chave expenses que vem do reducer wallet.

8. Crie um botão para deletar uma despesa da tabela contendo as seguintes características:

![image](btnExcluir.gif)

O botão deve ser o último item da linha da tabela e deve possuir data-testid="delete-btn".
Ao ser clicado, o botão deleta a linha da tabela, alterando o estado global e o header.

O que será verificado:

O botão deve estar dentro do último item da linha da tabela e deve possuir data-testid="delete-btn"
Ao ser clicado, o botão deleta a linha da tabela, alterando o estado global
Ao clicar no botão para remover uma despesa, o valor correspondente deve ser subtraído e a despesa total deve ser atualizada no header

Bônus

9. Crie um botão para editar uma despesa da tabela contendo as seguintes características:

![image](btnEditar.gif)

O botão deve estar dentro do último item da linha da tabela e deve possuir data-testid="edit-btn"
Ao ser clicado, o botão habilita um formulário para editar a linha da tabela. Ao clicar em "Editar despesa" ela é atualizada, alterando o estado global.
- O formulário deverá ter os mesmos data-testid do formulário de adicionar despesa. Você pode reaproveitá-lo.
- O botão para submeter a despesa para edição deverá conter exatamente o texto "Editar despesa"
Atenção: o câmbio utilizado na edição deve ser o mesmo do cálculo feito na adição do gasto.

O que será verificado:

O botão deve estar dentro do último item da linha da tabela e deve possuir `data-testid="edit-btn"
Ao ser clicado, o botão habilita um formulário para editar a linha da tabela. Ao clicar em "Editar despesa" ela é atualizada, alterando o estado global

Danilo-Couto/my-wallet

O Projeto

Habilidades

Deploy

Documentação da API de Cotações de Moedas

Lista de requisitos

Página de Login

1. Crie uma página inicial de login com os seguintes campos e características:

Página da Carteira

Configurando sua página

2. Crie uma página para sua carteira com as seguintes características:

Header

3. Crie um header para a página de carteira contendo as seguintes características:

Formulário de adição de Despesa

4. Desenvolva um formulário para adicionar uma despesa contendo as seguintes características:

5. Implemente a lógica para preencher as opções do campo "Moedas" buscando as siglas da API

Tabela de Gastos

6. Desenvolva uma tabela com os gastos contendo as seguintes características:

7. Implemente a lógica para que a tabela seja alimentada pelo estado da aplicação

8. Crie um botão para deletar uma despesa da tabela contendo as seguintes características:

Bônus

9. Crie um botão para editar uma despesa da tabela contendo as seguintes características: