自动记账是这套理财系统最大亮点，区别普通记账源码，支持文件导入、AI 解析、周期记账、投资交易自动归集，搭配多账本、净值计算、预算提醒、会员权限、多端同步完整闭环。网上大量所谓 “自动记账源码” 只是前端模拟，没有后端解析引擎，无法真正自动生成账单，仅能演示。
⚠️重要风险提示：网上网盘免费全套源码很多为盗版，存在后门、版权风险；开源项目务必阅读开源协议，开源不等于商用授权。源码仅为开发底座，不具备金融资质，测算仅供参考，不构成投资建议；对外上线需要遵守监管要求，敏感财务数据做好加密保护。
一、系统核心功能
1. 自动记账核心引擎（系统重点）
- 批量文件导入解析 微信、支付宝、银行、券商 CSV 流水上传，后端解析字段，自动提取交易时间、金额、收支类型、商户；基于
时间+金额+交易对象做去重，避免重复生成账单；解析失败记录进入待审核列表，不全量报错GitHub。 - 周期自动记账 配置固定工资、房租、定投、保险扣费，到达时间自动生成账单记录，支持设置结束时间。
- AI 辅助解析（可选） 对接大模型 API，解析短信、截图 OCR 文本，提取金额、商户、类型；高置信度直接入账，低置信度进入待审核，需要用户确认后再落库，防止 AI 识别错误乱记账。
- 投资交易自动归集 基金 / 股票申购赎回、分红、股息导入自动生成投资账单，联动持仓模块自动更新成本、浮盈浮亏。
- 账单待审核队列 所有自动生成记录统一进入待办，用户确认无误正式生效；支持批量确认、批量驳回。
2. 理财配套业务模块
- 多账本隔离 个人、家庭、投资账本独立，每条账单携带
ledger_id，账本数据隔离；全局资产聚合统计，不修改原始流水。 - 资产净值计算 每个账本独立净值快照、净值曲线，后端核算 XIRR、浮盈浮亏、已实现收益；定时任务每日生成快照。
- 账户与账单管理 多账户管理，账单增删改查自动联动账户余额；转账双向变更账户金额；完整审计日志记录账单变更前后数据。
- 预算 & 攒钱目标 分类预算、超支三级告警、告警冷却防轰炸；攒钱目标测算，账单流水参与目标进度计算。
- 报表导出 收支报表、资产报表、投资分析报表，支持 Excel/PDF 导出，高级导出绑定会员权限。
- 会员权限体系 后台自定义月 / 季 / 年套餐；后端鉴权，免费用户限制账本数量、导出次数；会员解锁 AI 解析、无限账本、PDF 报告；会员到期只收回付费功能，用户账单持仓数据完整保留。
- 多端同步 Uni‑app 前端编译 H5、小程序、APP；账号统一，增量同步，弱网离线操作，网络恢复自动提交数据。
- 管理后台 用户管理、套餐配置、自动记账规则配置、待审核账单查看、系统日志、定时任务监控。
二、项目目录结构
auto‑finance‑account‑source/
├── uni‑frontend # H5/小程序/App前端
│ ├── pages/bill # 账单列表、待审核队列、导入页面
│ ├── pages/member # 会员中心、套餐购买
│ └── pages/networth # 净值、账本管理
├── admin‑frontend # PC管理后台
├── backend
│ ├── controller
│ ├── service
│ │ ├── auto_bill # 自动记账核心：导入解析、周期任务、AI解析、待审核队列
│ │ ├── ledger # 多账本隔离
│ │ ├── networth # 净值快照、收益核算
│ │ ├── member # 会员鉴权、订单处理
│ │ └── account # 账单联动账户余额
│ ├── db/migration
│ │ ├── bill.sql # 正式账单表
│ │ ├── bill_pending.sql # 待审核账单表
│ │ ├── bill_category.sql # 收支分类
│ │ ├── ledger.sql # 账本表
│ │ ├── member/package/order # 会员相关数据表
│ │ └── networth_snapshot.sql # 净值快照
│ └── task
│ ├── periodic_bill_task # 周期账单定时生成
│ └── networth_snapshot_task # 每日净值快照
├── docs # 部署文档、导入模板、AI接口配置说明
└── readme.md
运行环境：云服务器、MySQL、Redis，对外访问必须配置 HTTPS。AI 解析功能需要额外配置大模型 API 密钥。
三、完整搭建部署教程
步骤 1：源码准备
优先选择正规开源仓库，核对版权协议；拒绝来路不明网盘源码，规避后门风险。
步骤 2：后端部署
- 服务器新建数据库，导入全套数据库脚本。
- 修改
.env配置文件，填写数据库、Redis、AI 模型 API 密钥、支付商户信息。 - 上传后端代码，安装依赖，启动服务。
- 配置两组核心定时任务
periodic_bill_task：定时生成周期账单；networth_snapshot_task：每日生成各账本净值快照。
- 接口测试：上传一份账单 CSV 文件，校验解析生成待审核记录。
步骤 3：前端部署
- 修改前端接口地址为你的服务器域名。
- 编译 H5、小程序包，部署管理后台。
- 后台配置会员套餐、系统默认分类。
步骤 4：上线必做联调测试
- 文件导入测试：重复导入同一份流水，校验自动去重，不会重复生成账单。
- 周期记账测试：配置定投周期，到达时间自动生成待审核账单。
- 待审核流程：自动生成记录，确认后转为正式账单；驳回不写入正式账单。
- 余额联动：确认账单入账，账户余额同步变更；编辑、删除账单余额正确回滚。
- 会员鉴权：免费账号调用会员专属接口，后端拦截，不能绕过前端使用高级功能。
- 多账本测试：不同账本账单隔离，全局汇总数值等于各账本相加。
四、高频踩坑汇总
- 伪自动记账：仅页面模拟效果，后端没有解析逻辑，导入文件不生成真实账单。
- 缺少待审核队列：AI / 导入直接落库正式账单，识别错误直接污染财务数据，无法回滚。
- 无去重逻辑：重复导入流水产生大量重复账单，数据错乱。
- 只做前端会员鉴权：隐藏按钮，直接调用接口依旧使用 VIP 功能，严重安全漏洞。
- 定时任务漏配：周期账单不会自动生成，净值快照停止更新。
- 金额浮点数精度问题：金融运算出现多位小数，后端统一处理金额精度。
- AI 识别完全依赖大模型：无置信度判断，识别错误直接入账，必须设置待审核兜底。
五、适用落地场景
- C 端投资理财记账工具，减少用户手动录入，主打自动记账体验；
- 理财顾问工作台，批量导入客户交易流水，输出资产与收益报告；
- 二次开发底座，复用自动记账、净值、多账本、会员整套业务快速迭代项目；
- 技术学习：学习财务系统文件解析、待审核流程、定时任务、AI 辅助记账业务设计。
