MathBank é uma aplicação que permite realizar transações financeiras 💵, gerenciar usuários 👥 e carteiras 💼. Desenvolvido com o framework Laravel na versão 11 em PHP 8.2, e utilizando PostgreSQL como banco de dados, o projeto oferece uma solução robusta e moderna para quem busca uma plataforma de gerenciamento financeiro. A implementação em Docker facilita a configuração e o uso da aplicação. 🚀
- Gerenciamento de Usuários: Criação, edição e exclusão de usuários.
- Gerenciamento de Carteiras: Controle de múltiplas carteiras por usuário.
- Transações Financeiras: Acompanhamento e histórico de transações, incluindo depósitos e saques.
- Backend: Laravel 11, PHP 8.2
- Banco de Dados: PostgreSQL
- Containerização: Docker
Antes de começar, assegure-se de ter as seguintes ferramentas instaladas em sua máquina:
-
Clone o repositório:
git clone https://github.com/DaviProgramming/mathbank.git
-
Navegue até o diretório do projeto:
cd mathBank -
Construa e inicie os containers Docker:
docker-compose up --build
-
Acesse o container do PHP:
docker exec -it mathbank-app bash -
🌐 Acesse a aplicação através do navegador em
http://localhost:8000.
Para garantir que tudo está funcionando corretamente, você pode rodar os testes da aplicação. Siga os passos abaixo:
-
Acesse o container do PHP:
docker exec -it app bash -
Execute os testes:
docker compose exec app php artisan test tests/feature
Você pode baixar a coleção do Postman para facilitar os testes da API através do seguinte link:
Contribuições são bem-vindas! Se você gostaria de ajudar, siga as etapas abaixo:
- Faça um fork do repositório.
- Crie sua feature branch (
git checkout -b nova-feature). - Faça suas alterações e commit (
git commit -m 'Adiciona nova feature'). - Envie para o seu repositório (
git push origin nova-feature). - Abra um Pull Request.
Para qualquer dúvida, sinta-se à vontade para abrir uma issue ou entrar em contato diretamente.