Skip to content

dingdangdog/cashbook

Repository files navigation

cashbook

cashbook

release stars dorks

issues-open issues-close license Docker Pulls GitHub Releases Download

简述(Description)

Cashbook记账本。

  • 在数据记录上追求简单、易用、自主可控;
  • 在统计分析上力求清晰、美观、简洁有效。

重要提示:如果使用docker部署到公网,请自行修改服务密钥和默认密码!!!

其他说明:

cashbook 当前功能已满足本人的基本使用,所以后续不会主动放精力在该开源软件的研发上,由于未经过完善的测试,当前软件可能存在一些未知问题,还请见谅。

如果您在使用时有任何问题或其他功能建议,可以在交流群或Github Issues中反馈。

如果反馈的是BUG,本人会尽力解决;如果是新功能,本人将酌情考虑是否采纳请求。

总之,谢谢你的使用~

开始使用(Get Started)

Docker部署

推荐使用docker-compose部署,示例如下:

services:
  cashbook:
    image: dingdangdog/cashbook:latest
    container_name: cashbook
    restart: always
    ports:
      - 880:80
    volumes:
      - ./data:/app/resources/data
    # v2.0.1新增环境变量配置
    environment:
      - TOKEN_SALT=spend-money-like-water
      - ENVIRONMENT=PRO
      # 服务密钥,请自行修改
      - SERVER_KEY=08cc0348-061d-4193-af05-b6cc02df28ea
      # 默认密码,请自行修改
      - DEFAULT_PASSWORD=cashbook

如果你不喜欢使用 docker-compose,也可以执行以下命令一件执行:

# 数据卷/环境变量等请自行修改命令
docker run -d --name cashbook -p 880:80 -v ./data:/app/resources/data dingdangdog/cashbook:latest

桌面安装

请前往Releases页面自行下载安装。

主要功能(Features)

  • 同一套代码,同样的页面,可以 Web 部署,也可以安装桌面程序;
  • 支持 Windows 安装使用;
  • 支持 Macos 安装使用(未测试);
  • 支持 Linux 安装使用(未测试);
  • 支持 Docker 部署;
  • 支持 支付宝CSV 个人账单文件导入;
  • 支持 微信CSV 个人账单文件导入;
  • 支持 京东金融CSV 个人账单文件导入;
  • 数据导入时,消费类型自动映射转换
  • 直观的消费日历看板;
  • 美观的数据分析图表:支出类型统计饼图、支付方式统计饼图、每日流水统计曲线图、每月流水统计柱状图;
  • 支持多用户模式;
  • 每个用户可以有多个账本,其账本之间数据独立;
  • 无需数据库;
  • 上传小票图片;
  • 数据快速迁移(导入/导出);
  • 主题系统;
  • 桌面端自动更新;
  • ……

类型映射

现在系统设置中可以进行交易类型的映射关系维护了,下面列出项目默认的映射关系,用户安装后可自行修改。

支付宝、微信、京东金融对应的数据导入后,会根据其字段值映射为本软件类型对应的字段值。

支出/收入类型 支付宝(交易分类 微信(交易类型 京东金融(交易分类
数码电器 数码电器 数码电器/手机通讯/电脑办公
充值缴费 充值缴费 充值缴费
美容美发 美容美发 美妆个护
转账红包 转账红包 微信红包/转账
日用百货 日用百货 清洁纸品/鞋服箱包
服饰装扮 服饰装扮 服饰内衣/钟表眼镜
文化休闲 文化休闲/运动户外 图书文娱/文体玩具
餐饮美食 餐饮美食 食品酒饮
医疗健康 医疗健康 医疗保健
亲友代付 亲友代付 亲属卡交易
家居家装 家居家装
爱车养车 爱车养车 汽车用品
投资理财 收入/投资理财 转入零钱通-来自零钱 小金库
教育培训 教育培训 教育培训
退款 退款 退款
微信交易 扫二维码付款/二维码收款/商户消费

没有出现在上述表格中的类型,系统不会处理,将会保留原类型文字进行导入。详细映射关系可查看type_convert.jsonkey是原类型,value是目标类型)。

PS:如果你还不会账单导出,这里有一个图文教程:微信/支付宝/京东金融导出账单文件

Star

Star History Chart

鸣谢(Acknowledgments)

贡献者(Contributor)

开发工具(Tools)