Skip to content

Latest commit

 

History

History
107 lines (69 loc) · 4.67 KB

README.md

File metadata and controls

107 lines (69 loc) · 4.67 KB
Raw

Banco Estrela ★

Início em 23/05/2024

Sumário

  1. Introdução
  2. Funcionalidades
  3. CPFs de teste
  4. Extrato
  5. Tecnologias Utilizadas
  6. Instalação
  7. Como Usar
  8. Contribuição

Introdução

O Banco estrela é um sistema de banco virtual desenvoldido para fins educacionais, como parte de um estudo sobre programação em C# utilizando .NET. O sistema permite que os usuários realizem operações como criação de conta, realizar login, depositar, sacar e gerenciar suas informações pessoais.

Funcionalidades

  • Cadastro de Usuário: Permite que novos usuários se cadastrem no sistema fornecendo nome, sobrenome, CPF, data de nascimento, nome de usuário, senha e resposta para uma pergunta de segurança.

  • Login: Permite que usuários cadastrados façam login no sistema usando seu nome de usuário e senha.

  • Operações Bancárias: Os usuários podem realizar as seguintes operações:

    • Depositar dinheiro em sua conta.
    • Sacar dinheiro de sua conta, desde que tenham saldo disponível.
    • Verificar saldo atual.
    • Listar todas as transações realizadas.

  • Recuperação de Senha: Os usuários podem recuperar sua senha respondendo à pergunta de segurança previamente configurada.

Testes com CPF de teste

Para testar o sistema sem a necessidade de inserir um CPF válido, foi implementada a funcionalidade de utilizar um CPF gerado automaticamente por uma API Ao digitar 'test' ou 'teste' no campo de CPF durante o cadastro, o sistema consulta essa API para obter um CPF válido, utilizando a classe CPFGenerator.cs. Esta classe possui um método assíncrono GetCpfAsync() para fazer a consulta à API e um método síncrono GetCpf() que retorna o CPF obtido como uma string, utilizando o pacote Newtonsoft.Json para manipulação dos dados JSON retornados pela API.

Extrato

O Banco Estrela também oferece uma funcionalidade de extrato que registra todas as transações financeiras realizadas pelos usuários. As transações registradas incluem depósitos, saques, transferências internas e depósitos recebidos de outros bancos. Cada transação é detalhada com informações como tipo de transação, valor, data e envolvidos na operação.

Funcionalidades:

  • Depósitos: Quando um usuário realiza um depósito em sua conta, uma entrada é registrada no extrato com o tipo de transação como "Depósito". O valor depositado é refletido no saldo da conta do usuário.

  • Saques: Um saque é registrado no extrato como uma transação do tipo "Saque". O valor retirado é reduzido do saldo da conta do usuário, desde que haja saldo disponível.

  • Transferências: As transferências entre contas são registradas no extrato com o tipo "Transferência". Cada transferência é documentada com detalhes sobre o remetente e o destinatário da transferência, além do valor transferido.

Tecnologias utilizadas:

  • C#: Linguagem de programação principal.
  • .NET Core: Plataforma utilizada para desenvolver a aplicação.
  • Entity Framework Core: Framework de mapeamento objeto-relacional (ORM) para acessar o banco de dados.
  • SQL: Banco de dados embutido utilizado para armazenar informações dos usuários.
  • Console Application: Interface de linha de comando utilizada para interação com o usuário.
  • Newtonsoft.Json: Biblioteca utilizada para manipulação de dados JSON, usada para interpretar o retorno da API de geração de CPF.

Instalação

Clone o repositório para a sua máquina:

git clone https://github.com/LXSCA7/ProjetoBanco.git

Caso tenha o make instalado:

make banco

Para testes unitários:

make tests

Caso não tenha o make:

cd BancoEstrela

Compile e execute o projeto:

dotnet run

Como usar

  1. Ao iniciar o programa, você será apresentado a um menu principal com opções numéricas.
  2. Selecione a opção desejada digitando o número correspondente e pressionando Enter.
  3. Siga as instruções na tela para cada operação específica (por exemplo, criar conta, fazer login, realizar operações bancárias).

Contribuição

Contribuições são bem-vindas! Sinta-se à vontade para abrir issues para relatar problemas, sugestões de melhorias ou para discutir novas funcionalidades que possam ser adicionadas ao projeto. Se deseja contribuir diretamente, siga estes passos:

  1. Faça um fork do projeto.
  2. Crie uma branch para sua feature
  3. Commit suas mudanças
  4. Faça o push para a branch
  5. Crie um novo Pull Request.