{"id":37167471,"url":"https://github.com/beka-birhanu/finance-go","last_synced_at":"2026-01-14T19:49:09.731Z","repository":{"id":249240227,"uuid":"830686931","full_name":"beka-birhanu/finance-go","owner":"beka-birhanu","description":"The Financial Tracker Backend is an educational project designed to teach Clean Architecture and Domain-Driven Design (DDD) using vanilla Go. ","archived":false,"fork":false,"pushed_at":"2024-08-14T13:53:10.000Z","size":1598,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-09-15T08:53:17.917Z","etag":null,"topics":["air","clean-architecture","docker","golang","makefile","postgresql"],"latest_commit_sha":null,"homepage":"","language":"Go","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/beka-birhanu.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":"2024-07-18T19:14:46.000Z","updated_at":"2024-08-18T03:23:41.000Z","dependencies_parsed_at":null,"dependency_job_id":"55d67e98-8d74-4afe-8600-73329ec2462f","html_url":"https://github.com/beka-birhanu/finance-go","commit_stats":null,"previous_names":["beka-birhanu/finance-go"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/beka-birhanu/finance-go","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beka-birhanu%2Ffinance-go","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beka-birhanu%2Ffinance-go/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beka-birhanu%2Ffinance-go/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beka-birhanu%2Ffinance-go/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/beka-birhanu","download_url":"https://codeload.github.com/beka-birhanu/finance-go/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beka-birhanu%2Ffinance-go/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28433079,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T18:57:19.464Z","status":"ssl_error","status_checked_at":"2026-01-14T18:52:48.501Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: 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":["air","clean-architecture","docker","golang","makefile","postgresql"],"created_at":"2026-01-14T19:49:09.063Z","updated_at":"2026-01-14T19:49:09.718Z","avatar_url":"https://github.com/beka-birhanu.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Go Backend Clean Architecture (Financial Tracker)\n\nThis is a back-end for a Financial Tracker app, built to learn GraphQL, Clean Architecture and Domain-Driven Design using vanilla Go. Feel free to use this project as a template for your own Go backend projects.\n\nI appreciate any feedback on the project; it helps everyone, especially me.\n\n## Technologies\n\n- Go\n- Postgres\n- Docker\n- gqlgen\n\n## About Me\n\nHi, I’m Beka Birhanu. I’m currently part of the A2SV training program and work with Clean Architecture on a daily basis.\n\n### How to Run This Project\n\nYou can run this Go Backend Clean Architecture project with or without Docker. Here’s how to do both:\n\n- **Clone the project**\n\n```bash\n# Move to your workspace\ncd your-workspace\n\n# Clone this project into your workspace\ngit clone https://github.com/beka-birhanu/finance-go.git\n\n# Move to the project root directory\ncd finance-go\n```\n\n#### Run Without Docker\n\n1. Install Go and Postgres if not already installed on your machine.\n2. Edit a `.env` with your configuration.\n3. Run `go mod tidy`.\n4. Run `make run`.\n5. Access the API at `http://localhost:8080`.\n\n#### Run With Docker\n\n1. Install Docker and Docker Compose.\n2. Run `docker-compose up -d`.\n3. Access the API at `http://localhost:8080`.\n\n### How to Run Tests\n\n```bash\n# Run all tests\nmake test\n```\n\n## File Structure\n\n![file structure](./assets/file_structure_v2.png)\n\n### API Documentation\n\n[RESTful APIs docs](./docs/API_DEFINITION.md)\n[GraphQL APIs docs](./docs/GRAPH_API_SCHEMA.md)\n\n### TODO\n\n- Improve based on feedback.\n- Add more test cases.\n- Collect mocks into a dedicated directory.\n\nIf this project helps you in any way, show your support ❤️ by starring this project ✌️\n\n### License\n\n```\nMIT License\n\nCopyright (c) 2024 Beka Birhanu\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n```\n\n### Contributing to Finance-Go\n\nAll pull requests are welcome.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbeka-birhanu%2Ffinance-go","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbeka-birhanu%2Ffinance-go","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbeka-birhanu%2Ffinance-go/lists"}