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.