{"id":20648459,"url":"https://github.com/henriquesebastiao/poupy","last_synced_at":"2025-04-16T14:54:04.561Z","repository":{"id":207837534,"uuid":"720218095","full_name":"henriquesebastiao/poupy","owner":"henriquesebastiao","description":"Um  aplicativo web para gerenciamento de orçamento e gastos pessoais, desenvolvido com Django.","archived":false,"fork":false,"pushed_at":"2024-12-26T21:34:34.000Z","size":52814,"stargazers_count":4,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-16T05:58:06.926Z","etag":null,"topics":["ci","css","django","docker","docker-compose","gunicorn","html","postgresql","pytest","python","selenium"],"latest_commit_sha":null,"homepage":"https://poupy.henriquesebastiao.com","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/henriquesebastiao.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-11-17T21:05:05.000Z","updated_at":"2025-02-24T03:06:07.000Z","dependencies_parsed_at":"2024-01-26T12:13:52.735Z","dependency_job_id":"b99dae54-8fe7-406d-b3a0-ae8aca5ff276","html_url":"https://github.com/henriquesebastiao/poupy","commit_stats":null,"previous_names":["henriquesebastiao/poupy"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/henriquesebastiao%2Fpoupy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/henriquesebastiao%2Fpoupy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/henriquesebastiao%2Fpoupy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/henriquesebastiao%2Fpoupy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/henriquesebastiao","download_url":"https://codeload.github.com/henriquesebastiao/poupy/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249252542,"owners_count":21238210,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ci","css","django","docker","docker-compose","gunicorn","html","postgresql","pytest","python","selenium"],"created_at":"2024-11-16T17:08:36.358Z","updated_at":"2025-04-16T14:54:04.519Z","avatar_url":"https://github.com/henriquesebastiao.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\n    \u003cimg src=\"project/utils/img/bitmap.png\" alt=\"Poupy\" width=\"150\"/\u003e\u003cbr\u003e\n\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\u003cstrong\u003eManage your personal budget.\u003c/strong\u003e\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://github.com/henriquesebastiao/poupy/actions/workflows/ci.yml\"\u003e\n        \u003cimg src=\"https://github.com/henriquesebastiao/poupy/actions/workflows/ci.yml/badge.svg\" alt=\"CI status\"/\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://coverage-badge.samuelcolvin.workers.dev/redirect/henriquesebastiao/poupy\" \u003e \n        \u003cimg src=\"https://coverage-badge.samuelcolvin.workers.dev/henriquesebastiao/poupy.svg\" alt=\"Codecov status\"/\u003e \n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/henriquesebastiao/poupy/blob/main/LICENSE\"\u003e\n        \u003cimg alt=\"LICENSE\" src=\"https://img.shields.io/github/license/henriquesebastiao/poupy\"/\u003e\n    \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"project/utils/img/screenshot.png\" alt=\"Preview\"/\u003e\n\u003c/p\u003e\n\nPoupy é 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.\n\n## Deploy 🚀\n\nVocê pode acessar o aplicativo [aqui](https://poupy.henriquesebastiao.com/app/login).\n\nEntre na conta de demonstração clicando em `Login as User Demo`.\n\nVocê também pode visualizar o deploy do banco de dados usando **Adminer** neste [link](https://adminer.henriquesebastiao.com/?pgsql=projects_postgres\u0026username=poupy\u0026db=poupy\u0026ns=public).\n\nUse a senha `poupy123`.\n\n\u003e Este usuário é apenas para leitura, fique a vontade para bisbilhotar :)\n\n## Funcionalidades\n\n- **Adição de contas bancárias**: Adicione e gerencie várias contas bancárias.\n- **Registro de receitas e despesas**: Registre suas entradas e saídas de dinheiro para melhor controle.\n- **Transferência entre contas**: Movimente saldo entre contas cadastradas.\n- **Dashboard completo:**\n    - Saldo total de todas as contas.\n    - Total de entradas e saídas mensais para um resumo rápido do fluxo financeiro.\n    - Saldo por conta para acompanhar a situação de cada conta individualmente.\n    - Maiores movimentações: Exibe as três maiores movimentações do mês, destacando receitas e despesas mais significativas.\n\nTecnologias e ferramentas usadas no projeto:\n\n- **Python** com **Django** para o backend.\n- **HTML5** e **CSS3** para o frontend.\n- **PostgreSQL** para armazenamento de dados.\n- **PyTest** e **Selenium** para testes unitários e funcionais.\n- **Docker** para desenvolvimento em containers.\n- **Ruff** para formatação de código.\n- **GitHub Actions** para execução de pipelines de CI.\n\n\u003e [!TIP]\n\u003e Você pode ver a cobertura dos testes [aqui](https://coverage-badge.samuelcolvin.workers.dev/redirect/henriquesebastiao/poupy).\n\n## Executando o projeto localmente\n\n\u003e [!NOTE]\n\u003e Os passos listados abaixo são baseados em sistemas Unix, podendo para variar para outros sistemas operacionais. No passa a passo é exemplificada a execução com SQLite com banco de dados, mas o projeto usa PostgreSQL e Docker para deploy.\n\n\u003e [!IMPORTANT]\n\u003e Para executar o projeto você deve ter o [Python](https://www.python.org/) e [Git](https://git-scm.com/) instalados em seu computador.\n\n### Clonando o repositório\n\n```shell\ngit clone https://github.com/henriquesebastiao/poupy.git \u0026\u0026 cd poupy\n```\n\n## Criando e ativando o ambiente virtual Python\n\nÉ essencial a criação um ambiente virtual exclusivo para o projeto, visando evitar eventuais conflito com outros pacotes python instalados em seu computador.\n\n```shell\npython -m venv .venv\nsource .venv/bin/activate\n```\n\n### Atualizando o `pip` e instalando as dependências do projeto\n\n```shell\npip install --upgrade pip\npip install -r requirements.txt\n```\n\n### Configurando as variáveis de ambiente\n\nO projeto conta com um arquivo de modelo para a criação do `.env`, sendo assim, basta apenas duplicá-lo com o nome .env\n\n```shell\ncp .env.example .env\n```\n\n### Reunindo arquivos estáticos e criando banco de dados\n\nO ú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.\n\n```shell\npython manage.py collectstatic\npython manage.py migrate\n```\n\n### Executando o aplicativo ✨\n\nAgora execute o seguinte comando para executar o aplicativo:\n\n```shell\npython manage.py runserver\n```\n\nAcesse o aplicativo em [http://localhost:8000](http://localhost:8000)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhenriquesebastiao%2Fpoupy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhenriquesebastiao%2Fpoupy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhenriquesebastiao%2Fpoupy/lists"}