henriquesebastiao/poupy repository overview

⁠Poupy

Poupy é um aplicativo web para gerenciamento de orçamento e gastos pessoais, desenvolvido com Django. Ele permite o controle financeiro completo, incluindo a gestão de contas bancárias, receitas, despesas e transferências de saldo entre contas. Com um dashboard intuitivo, o usuário pode visualizar rapidamente um resumo financeiro mensal e manter suas finanças organizadas.

Repositório: https://github.com/henriquesebastiao/poupy/⁠

⁠Deploy 🚀

Você pode acessar o aplicativo aqui⁠.

Entre na conta de demonstração clicando em Login as User Demo.

Você também pode visualizar o deploy do banco de dados usando Adminer neste link⁠.

Use a senha poupy123.

⁠Funcionalidades

• Adição de contas bancárias: Adicione e gerencie várias contas bancárias.
• Registro de receitas e despesas: Registre suas entradas e saídas de dinheiro para melhor controle.
• Transferência entre contas: Movimente saldo entre contas cadastradas.
• Dashboard completo:
  • Saldo total de todas as contas.
  • Total de entradas e saídas mensais para um resumo rápido do fluxo financeiro.
  • Saldo por conta para acompanhar a situação de cada conta individualmente.
  • Maiores movimentações: Exibe as três maiores movimentações do mês, destacando receitas e despesas mais significativas.

Tecnologias e ferramentas usadas no projeto:

• Python com Django para o backend.
• HTML5 e CSS3 para o frontend.
• PostgreSQL para armazenamento de dados.
• PyTest e Selenium para testes unitários e funcionais.
• Docker para desenvolvimento em containers.
• Ruff para formatação de código.
• GitHub Actions para execução de pipelines de CI.

⁠Executando o projeto localmente

⁠Clonando o repositório

git clone https://github.com/henriquesebastiao/poupy.git && cd poupy

⁠Criando e ativando o ambiente virtual Python

É essencial a criação um ambiente virtual exclusivo para o projeto, visando evitar eventuais conflito com outros pacotes python instalados em seu computador.

python -m venv .venv
source .venv/bin/activate

⁠Atualizando o pip e instalando as dependências do projeto

pip install --upgrade pip
pip install -r requirements.txt

⁠Configurando as variáveis de ambiente

O projeto conta com um arquivo de modelo para a criação do .env, sendo assim, basta apenas duplicá-lo com o nome .env

cp .env.example .env

⁠Reunindo arquivos estáticos e criando banco de dados

O último passo antes de executar o aplicativo, é juntar todos os arquivos estáticos responsáveis por dar estilo ao aplicativo e aplicar as migrações no banco de dados.

python manage.py collectstatic
python manage.py migrate

⁠Executando o aplicativo ✨

Agora execute o seguinte comando para executar o aplicativo:

python manage.py runserver

Acesse o aplicativo em http://localhost:8000⁠