{"id":25524812,"url":"https://github.com/chokeguy/simple-bank","last_synced_at":"2026-02-14T15:02:32.535Z","repository":{"id":274037521,"uuid":"921503440","full_name":"ChokeGuy/simple-bank","owner":"ChokeGuy","description":"A service that provides both RESTful and gRPC APIs to simulate the core functionalities of a basic bank.","archived":false,"fork":false,"pushed_at":"2025-02-18T19:20:08.000Z","size":7514,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-08-14T16:56:09.247Z","etag":null,"topics":["aws-ec2","aws-ecs","aws-eks","aws-elasticache","github-actions","go","grpc","rest-api","restful-api","route53"],"latest_commit_sha":null,"homepage":"https://api.my-simple-bank.org","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ChokeGuy.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,"zenodo":null}},"created_at":"2025-01-24T04:19:00.000Z","updated_at":"2025-02-18T19:20:12.000Z","dependencies_parsed_at":"2025-01-24T14:24:39.213Z","dependency_job_id":"98677579-6849-4716-a0b7-f8c3b1760543","html_url":"https://github.com/ChokeGuy/simple-bank","commit_stats":null,"previous_names":["chokeguy/simple-bank"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/ChokeGuy/simple-bank","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChokeGuy%2Fsimple-bank","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChokeGuy%2Fsimple-bank/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChokeGuy%2Fsimple-bank/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChokeGuy%2Fsimple-bank/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ChokeGuy","download_url":"https://codeload.github.com/ChokeGuy/simple-bank/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChokeGuy%2Fsimple-bank/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29447768,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-14T14:10:32.461Z","status":"ssl_error","status_checked_at":"2026-02-14T14:09:49.945Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["aws-ec2","aws-ecs","aws-eks","aws-elasticache","github-actions","go","grpc","rest-api","restful-api","route53"],"created_at":"2025-02-19T20:16:20.058Z","updated_at":"2026-02-14T15:02:32.515Z","avatar_url":"https://github.com/ChokeGuy.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Go Simple Bank\n\nFuntionalities: \n- Create and manage bank accounts.\n- Record all balance changes to each of the accounts.\n- Perform a money transfer between 2 accounts.\n\n\n## Simple bank service\n\nAPIS:\n\n1. Create and manage bank accounts, which are composed of owner’s name, balance, and currency.\n2. Record all balance changes to each of the account. So every time some money is added to or subtracted from the account, an account entry record will be created.\n3. Perform a money transfer between 2 accounts. This should happen within a transaction, so that either both accounts’ balance are updated successfully or none of them are.\n\n## Setup local development\n\n### Install tools\n\n- [Docker desktop](https://www.docker.com/products/docker-desktop)\n- [Golang](https://golang.org/)\n- [Migrate](https://github.com/golang-migrate/migrate/tree/master/cmd/migrate)\n\n    ```bash\n    $ curl -L https://packagecloud.io/golang-migrate/migrate/gpgkey | apt-key add -\n    $ echo \"deb https://packagecloud.io/golang-migrate/migrate/ubuntu/ $(lsb_release -sc) main\" \u003e /etc/apt/sources.list.d/migrate.list\n    $ apt-get update\n    $ apt-get install -y migrate\n    ```\n\n- [DB Docs](https://dbdocs.io/docs)\n\n    ```bash\n    npm install -g dbdocs\n    dbdocs login\n    ```\n\n- [DBML CLI](https://www.dbml.org/cli/#installation)\n\n    ```bash\n    npm install -g @dbml/cli\n    dbml2sql --version\n    ```\n\n- [Sqlc](https://github.com/kyleconroy/sqlc#installation)\n\n    ```bash\n    brew install sqlc\n    ```\n\n- [Gomock](https://github.com/golang/mock)\n\n    ``` bash\n    go install github.com/golang/mock/mockgen@v1.6.0\n    ```\n\n### Setup infrastructure\n\n- Create the bank-network\n\n    ``` bash\n    make network\n    ```\n\n- Start postgres container:\n\n    ```bash\n    make postgres\n    ```\n\n- Create simple_bank database:\n\n    ```bash\n    make createdb\n    ```\n\n- Run db migration up all versions:\n\n    ```bash\n    make migrateup\n    ```\n\n- Run db migration up 1 version:\n\n    ```bash\n    make migrateup1\n    ```\n\n- Run db migration down all versions:\n\n    ```bash\n    make migratedown\n    ```\n\n- Run db migration down 1 version:\n\n    ```bash\n    make migratedown1\n    ```\n### How to generate code\n\n- Generate schema SQL file with DBML:\n\n    ```bash\n    make db_schema\n    ```\n\n- Generate SQL CRUD with sqlc:\n\n    ```bash\n    make sqlc\n    ```\n\n- Generate DB mock with gomock:\n\n    ```bash\n    make mock\n    ```\n\n- Create a new db migration:\n\n    ```bash\n    make migratecreate name=\u003cmigration_name\u003e\n    ```\n\n### How to run\n\n- Run server:\n\n    ```bash\n    make server\n    ```\n\n- Run test:\n\n    ```bash\n    make test\n    ```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchokeguy%2Fsimple-bank","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchokeguy%2Fsimple-bank","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchokeguy%2Fsimple-bank/lists"}