{"id":15096004,"url":"https://github.com/baoxuebin/beancount-gs","last_synced_at":"2025-05-16T05:03:19.977Z","repository":{"id":37704612,"uuid":"409127788","full_name":"BaoXuebin/beancount-gs","owner":"BaoXuebin","description":"基于 beancount 提供个人记账财务管理的 RESTful API 服务（包含前端页面）","archived":false,"fork":false,"pushed_at":"2025-01-12T02:10:53.000Z","size":23940,"stargazers_count":347,"open_issues_count":32,"forks_count":47,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-04-08T15:06:44.785Z","etag":null,"topics":["beancount","docker","gin-gonic","go","golang"],"latest_commit_sha":null,"homepage":"https://www.yuque.com/chuyi-ble7p/beancount-gs","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/BaoXuebin.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":"2021-09-22T08:43:52.000Z","updated_at":"2025-04-03T16:00:42.000Z","dependencies_parsed_at":"2024-07-08T20:09:58.505Z","dependency_job_id":"ae442837-bd14-4901-a995-b57e8e4c669b","html_url":"https://github.com/BaoXuebin/beancount-gs","commit_stats":{"total_commits":201,"total_committers":8,"mean_commits":25.125,"dds":"0.14427860696517414","last_synced_commit":"02d644fe96673f805fba3ea629e0e652c4abbe19"},"previous_names":[],"tags_count":26,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BaoXuebin%2Fbeancount-gs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BaoXuebin%2Fbeancount-gs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BaoXuebin%2Fbeancount-gs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BaoXuebin%2Fbeancount-gs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BaoXuebin","download_url":"https://codeload.github.com/BaoXuebin/beancount-gs/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247867361,"owners_count":21009240,"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":["beancount","docker","gin-gonic","go","golang"],"created_at":"2024-09-25T15:44:47.885Z","updated_at":"2025-04-08T15:06:55.212Z","avatar_url":"https://github.com/BaoXuebin.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# beancount-gs\n\n![license](https://img.shields.io/github/license/BaoXuebin/beancount-gs)\n[![docker image size](https://img.shields.io/docker/image-size/xdbin/beancount-gs/latest?label=docker-image)](https://hub.docker.com/repository/docker/xdbin/beancount-gs/general)\n[![docker pulls](https://img.shields.io/docker/pulls/xdbin/beancount-gs)](https://hub.docker.com/repository/docker/xdbin/beancount-gs/general)\n\n[前端项目地址](https://github.com/BaoXuebin/beancount-web)\n[演示地址](https://beancount.xdbin.com/)\n[使用文档](https://www.yuque.com/chuyi-ble7p/beancount-gs)\n\n## 介绍\n\n[beancount](https://github.com/beancount/) 是一个优秀的开源复式记账工具，因为其基于文本记录的特性，难以拓展到移动端；本项目旨在将常见的记账行为封装为 RESTful API。\n\n本仓库使用 `Golang` 进行文本的读写和接口服务支持，利用 `bean-query` 获取内容并解析，以 Json 格式返回。并基于已实现的接口内置实现了前端页面（适配移动端）。\n\n![snapshot](./snapshot.png)\n\n## 特性\n\n- [X] 私有部署\n- [X] 多账本\n- [X] 账户，资产管理\n- [X] 统计图表\n- [X] 多币种\n- [X] 标签\n- [X] 投资管理(FIFO)\n- [X] 第三方账单导入(支付宝，微信，工商银行，农业银行)\n- [X] 分期记账\n- [X] 事件\n\n## 如何使用\n\n**本地打包**\n\n1. 克隆本项目到本地\n2. 根目录执行 `go build`\n3. 执行 `./beancount-gs` (`-p` 指定端口号，`-secret` 指定配置密钥)\n\n**release**\n\n1. 下载并解压项目的 `release` 包\n2. 执行根目录下的 `./beancount-gs.exe`\n\n**docker**\n\n```shell\ndocker run --name beancount-gs -dp 10000:80 \\\n-w /app \\\n-v \"/data/beancount:/data/beancount\" \\\n-v \"/data/beancount/icons:/app/public/icons\" \\\n-v \"/data/beancount/config:/app/config\" \\\n-v \"/data/beancount/bak:/app/bak\" \\\nxdbin/beancount-gs:latest\n```\n\n**docker-compose**\n\n在指定目录创建文件 `docker-compose.yml`，然后复制下面内容到这个文件，执行 `docker-compose up -d`\n\n```yaml\nversion: \"3.9\"\nservices:\n  app:\n    container_name: beancount-gs\n    image: xdbin/beancount-gs:${tag:-latest}\n    ports:\n      - \"10000:80\"\n    volumes:\n      - \"${dataPath:-/data/beancount}:/data/beancount\"\n      - \"${dataPath:-/data/beancount}/icons:/app/public/icons\"\n      - \"${dataPath:-/data/beancount}/config:/app/config\"\n      - \"${dataPath:-/data/beancount}/bak:/app/bak\"\n      - \"${dataPath:-/data/beancount}/logs:/app/logs\"\n```\n\n默认的文件存储路径为 `/data/beancount`，如果你想更换其他路径，可以在当前目录下新建 `var.env`，然后将下面内容复制到这个文件\n\n```properties\ntag=latest\ndataPath=自定义的目录\n```\n\n执行 `docker-compose --env-file ./var.env up -d` 即可\n\n## 项目负责人\n\n[@BaoXuebin](https://github.com/BaoXuebin)\n\n## 开源协议\n\n[MIT](https://github.com/BaoXuebin/beancount-gs/blob/main/License) @BaoXuebin\n\n## 感谢️\n\n[赞助地址](https://xdbin.com/sponsor)\n\n感谢 **@Cabin**，**@潇** 两位朋友的赞助支持❤️","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbaoxuebin%2Fbeancount-gs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbaoxuebin%2Fbeancount-gs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbaoxuebin%2Fbeancount-gs/lists"}