{"id":16421853,"url":"https://github.com/aybruhm/fastapi-ledger-system","last_synced_at":"2025-09-06T09:33:13.580Z","repository":{"id":90039450,"uuid":"573748889","full_name":"aybruhm/fastapi-ledger-system","owner":"aybruhm","description":"Have you ever been curious as to how fintech applications are built? This system demonstrates the basic functionalities of a fintech product.","archived":false,"fork":false,"pushed_at":"2023-05-28T13:13:43.000Z","size":139,"stargazers_count":14,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-12-30T15:17:13.968Z","etag":null,"topics":["docker","docker-compose","fastapi","fastapi-sqlalchemy","postgres","python3"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc0-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aybruhm.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":"2022-12-03T10:02:21.000Z","updated_at":"2023-12-15T21:05:21.000Z","dependencies_parsed_at":"2024-10-28T15:28:39.808Z","dependency_job_id":"6f5e7c16-1a05-4db1-a7bf-2173e459f6f7","html_url":"https://github.com/aybruhm/fastapi-ledger-system","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aybruhm%2Ffastapi-ledger-system","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aybruhm%2Ffastapi-ledger-system/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aybruhm%2Ffastapi-ledger-system/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aybruhm%2Ffastapi-ledger-system/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aybruhm","download_url":"https://codeload.github.com/aybruhm/fastapi-ledger-system/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":232110873,"owners_count":18474031,"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":["docker","docker-compose","fastapi","fastapi-sqlalchemy","postgres","python3"],"created_at":"2024-10-11T07:35:00.160Z","updated_at":"2025-01-01T18:18:18.059Z","avatar_url":"https://github.com/aybruhm.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# FastAPI-Ledger\n\nHave you ever been curious as to how fintech applications are built? This system demonstrates the basic functionalities of a fintech product.\n\n## Technologies\n\n- FastAPI\n- PostgreSQL\n- SQLAlchemy (ORM)\n- Docker and Docker-compose\n- Alembic (Database migrations)\n- Pytest (Unit testing)\n\n## Problem Statement\n\nBuild a ledger system with the following functionalities: \n\n- [x] ( Deposit Money ) Credit X amount to one of the user’s account\n- [x] ( Withdraw Money ) Debit X amount from one of the user’s account\n- [x] Transfer money from one account to another account for a single user\n- [x] Transfer money from one account of one user to another user\n- [x] Get balance for a user\n- [x] Get balance for an account of a user\n- [x] User can have (10) maximum wallets\n\n## Getting Started\n\nTo get the service up and running, follow the steps below:\n\n1). Run the commands below in your terminal:\n\n```bash\ngit clone git@github.com:aybruhm/fastapi-ledger-system.git\n```\n\n2). Change directory to fastapi-ledger-system:\n\n```bash\ncd fastapi-ledger-system\n```\n\n3). Rename the `.env.template` file to `.env` and update the values.\n\n4). Build and run the service with:\n\n```bash\ndocker-compose up --build\n```\n\nThe service will build and run on port `8080`.\n\n5). Launch a new terminal session and run the following commands:\n\n```bash\nchmod +x run-migrations.sh\n```\n\n```bash\n./run-migrations.sh\n```\n\nThe above commands would activate the script file and when ran- will make database migrations for you automatically.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faybruhm%2Ffastapi-ledger-system","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faybruhm%2Ffastapi-ledger-system","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faybruhm%2Ffastapi-ledger-system/lists"}