经过长期对Beancount的使用和测试，我发现在日常记账中最烦恼的有以下几点：
- 由于记录数量太多，若每个记录都以单独条目记录则需要耗费大量时间，若以天为条目进行记账，又会导致条目的颗粒度太大；
- 我是以周为频率进行记账断言的，对于长期记账来说这个频率未免太频繁；
- 支出账户没有形成系统的规划，导致记录条目时总是要纠结选用哪个支出账户，且记录后也无法通过FAVA的试算表了解自己的各类支出情况；
针对以上记账痛点，开发出Beancount-Trans用于账单的自动解析。
上传账单，系统会根据定义好的商户和账户自动格式化输出为beancount能识别的文本。当前已支持自动更新至Beancount-Trans-Assets项目，仅支持本地部署用户启用。
例如"食物"会归类于Expense:Food账户，匹配到"晚餐"会归类与Expense:Food:Dinner账户，默认会归类于Expense:Other，默认情况可能需要手动进行归类。为了尽可能减少Expense:Other的出现，用户需要维护好自己的支出映射，这样能让自己的记账效率和准确性大大提升。
无登录解析时会使用通用映射模板。
- 根据 账单导出及查看方法 从对应平台中获取账单
- 在 https://trans.dhr2333.cn/trans 首页中上传csv或pdf文件完成解析
- 复制解析后的文本至 自己账本 或Beancount-Trans-Assets项目（提供基础的目录结构）对应的年月目录中
- 修改文本中的Expense:Other和Assets:Other的条目（没有对应的映射条目）
- 在Beancount-Trans-Assets项目中使用
fava main.bean运行程序，通过 http://127.0.0.1:5000 访问 - 根据fava提示修改错误条目
该项目默认读者有beancount的使用经验。在使用Beancount-Trans过程中，有以下几点需要注意
默认会对余额宝账户的收益进行忽略，推荐在下个月balance时以"Income:Investment:Interest"利息计入。
默认会对微信支付状态为"已全额退款"、 "对方已退还"或以"已退款"开头的条目进行忽略。
默认会对支付宝支付状态为"退款成功"、"交易关闭"、"解冻成功"、"信用服务使用成功"、"已关闭"的条目进行忽略。
选中"生成balance对账信息"时，默认忽略同一天非最晚的记录。
最终解析结果为"Expenses:Other"、"Income:Other"、"Assets:Other"时，说明无法正确解析，请手动处理或增加映射后再次解析。
当某个银行含有多张储蓄卡时，解析结果可能错误需手动处理。
由于各账单的字段是以 逗号 作为分隔，所以无法解析商家名称包含 , 的条目。
服务对三餐的判断有两种形式，一种是根据Expense中的支出映射来决定最终的条目，例如账单中含有"早餐"的备注会被匹配到"Expenses:Food:Breakfast"。
还有一种是后端的硬编码，系统在根据支出映射解析完成后得到的条目为"Expenses:Food"时，会根据账单时间对条目进行调整，例如发生在06:00到10:00之间的"Expenses:Food"条目，系统会自动修改为"Expenses:Food:BreakFast"。
早餐时间：06:00~10:00
午餐时间：10:00~14:00
晚餐时间：16:00~20:00
当支出映射与三餐时间冲突时，例如在2023-11-26 10:49:54,扫二维码付款,瑞安市暖爸副食品店,"收款方备注:二维码收款付款方留言:饮料",支出,¥3.00,零钱通,已转账,100004990123112600060327753584678844 ,10000499012023112601373972597516 ,"/"条目中
包含"饮料"和"食品"两个关键字，其中"饮料"的Expense为"Expenses:Food:DrinkFruit"，"食品"的Expense为"Expenses:Food"。虽然根据三餐判断时间为早餐"Expenses:Food:Breakfast"与"Expenses:Food:DrinkFruit"优先级一致，但实际情况归类于早餐并不合适。
所以关键字与三餐的判断规则为：先判断关键字优先级，再判断三餐时间。
通过关键字对商家和说明进行匹配难免出现重复，例如"华为"、"华为终端"和"华为软件"时应分别对应"Expenses:Shopping"、"Expenses:Shopping:Digital"和"Expenses:Culture"，所以无法单纯的使用"华为"关键字作为Expenses的判断依据。
很明显，"华为软件"及"华为终端"的优先级应大于"华为"，但他们最终又同属于"华为"商家。所以解析优先级在经过试错后最终定为：
- 计算Expenses中":"的数量，每存在一个，则按":"的数量*100
- 若"商家"不为空，则优先级+50
最终对应"华为"的优先级为100,"华为终端"的优先级为250,"华为软件"的优先级为150，用户需要根据优先级计算规则定义合适的"映射账户"和"商家"。
当选中"自动写入Beancount-Trans-Assets"后，系统会在解析完成后检查同级目录下Beancount-Trans-Assets是否有对应本年的年度账本，例如2023。如果存在，系统会将数据正常写入该账本；如果不存在，系统会自动创建年度账本，并将解析后的文本写入其中。
本地用户通过"本地账本"查看。
平台用户可通过该功能将错误条目输出至“案例账本”，作者会根据"案例账本"中的报错修改账单解析代码以求保证所有解析正常。
OwnTracks 是一款开源的位置跟踪应用程序，旨在帮助用户实时跟踪自己的位置信息并与他人共享。该应用程序可用于智能手机和其他设备，允许用户在背景中持续记录自己的位置，并将这些位置信息发送到 OwnTracks 服务器或其他支持该应用程序的服务上。
参考 https://www.dhr2333.cn/article/2022/12/16/70.html#owntracks ，当前仅支持本地容器环境部署用户访问。
效果展示：
为了方便用户使用，作者提供本地docker compose的部署方式。推荐以该方式部署，集成了fava展示、自动记录、OwnTracks轨迹记录等多项自动化功能。
若无Docker环境，可参考本地环境部署文档。
git clone https://github.com/dhr2333/Beancount-Trans.git
cd Beancount-Trans; git submodule update --init # 初始化所有子模块
# git submodule foreach git switch main # 所有子模块切换到main分支
# git submodule foreach git pull origin main # 若有需要则将所有子模块拉取main分支代码首次运行会自动创建名为mysql-data和redis-data的存储卷。
在Benacount-Trans主目录下运行
$ docker compose up # 增加 -d 参数可实现后台运行或 编译后运行
services:
beancount-trans-frontend:
# image: dhr2333/beancount-trans-frontend:latest
build:
context: ./Beancount-Trans-Frontend
dockerfile: Dockerfile
args:
- "--no-cache"
$ docker compose build # 编译
$ docker compose up
通过 http://localhost:38001/trans 进行解析，同时可以通过"我的账本"直接访问完整账本信息。
MySQL默认使用初始化数据，并不做持久化存储。若需要持久化存储需要放开以下注释：
beancount-trans-mysql:
volumes:
- mysql:/var/lib/mysql # 若需要持久存储取消该注释和volumes中的注释
volumes:
mysql:
external: true # 若已创建外部存储卷，则取消该注释(多次docker compose up可能会导致存储卷重复创建导致启动失败)
name: mysql-data
redis:
external: true # 若已创建外部存储卷，则取消该注释
name: redis-dataBeancount-Trans-Assets项目提供 Beancount账本组织结构，所有记账条目以月进行统计，以年进行存档。
账本结构说明可参考 Beancount_05_项目管理。
GitHub私有项目创建成功后，可将代码上传至私有仓库
git clone https://github.com/dhr2333/Beancount-Trans-Assets.git
cd Beancount-Trans-Assets
# 修改后
git add .
git commit -m "提交记录"
git remote add origin [你的项目链接]
git branch -M main
git push -u origin mainBeancount-Trans项目集中的后端项目，主要实现账单格式的转换功能及提供对外接口。
$ cd Beancount-Trans-Backend
$ pipenv install # 安装虚拟环境
$ pipenv shell # 使用虚拟环境
$ apt-get install -y mysql libmysqlclient mysql-clients # requirements.txt中的mysqlclient包依赖于mysql,所以需手动下载
$ pip install -r requirements.txt # 安装所需依赖修改mydemo/setting.py 修改数据库配置，如下所示：
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.mysql',
'NAME': os.environ.get('TRANS_MYSQL_DATABASE') or 'beancount-trans',
'USER': os.environ.get('TRANS_MYSQL_USER') or 'root',
'PASSWORD': os.environ.get('TRANS_MYSQL_PASSWORD') or 'root',
'HOST': os.environ.get('TRANS_MYSQL_HOST') or '127.0.0.1',
'PORT': os.environ.get('TRANS_MYSQL_PORT') or '3306',
'TIME_ZONE': 'Asia/Shanghai',
}
}
修改manage.py 配置文件使用 本地开发环境 mydemo.settings：
def main():
os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'mydemo.settings') # 本地开发环境
try:
from django.core.management import execute_from_command_line
except ImportError as exc:
raise ImportError(
"Couldn't import Django. Are you sure it's installed and "
"available on your PYTHONPATH environment variable? Did you " "forget to activate a virtual environment?" ) from exc
execute_from_command_line(sys.argv)
if __name__ == '__main__':
main()MySQL数据库中执行:
CREATE DATABASE `beancount-trans`然后终端下执行:
python manage.py makemigrations
python manage.py migrate导入提供的SQL模板，并根据自己的实际账户进行调整：
mysql -h127.0.0.1 -uroot -proot beancount-trans < fixtures/20240507-Develop.sql # 当前模板含有强烈的个人风格，建议根据自己情况修改执行： python manage.py runserver 0:8002
浏览器打开 http://127.0.0.1:8002/translate/trans 就可以完成简单的账单转换。
修改.env配置文件使用 本地开发环境 ：
运行前端程序：
$ npm install
$ npm run dev # 启动程序浏览器打开 http://localhost:5173/ ，需要Beancount-Trans-Backend及数据库服务正常运行才能实现解析功能。
如果你希望对Beancount-Trans-Backend做出贡献，请阅读我们的贡献指南。
关于Beancount-Trans及子项目有任何项目及使用上的问题，建议提issue。
捐赠收入将全部用于提高网站访问速度，并支持公众号"TC听云智能"。
微信支持标签解析，备注可添加后缀#TEST
支付宝支持信用卡及花呗支付
