这套系统主打资产台账 + 自动记账双核心，打通存款、基金、股票、负债、日常收支，自动归集流水、每日生成资产净值快照，支持多账本隔离，自带智能提醒、财务报表，可选会员付费模块，支持 H5、小程序、PC 后台多端访问。
⚠️风险提示：网盘标注 “免费完整源码” 大多属于盗版，存在后门木马、版权侵权问题；开源项目务必阅读开源协议，开源不等于可以商用。源码仅学习自用，无金融牌照，资产收益测算仅参考，不构成投资建议；对外上线运营务必做代码安全审计，用户财务敏感数据加密存储。
一、核心功能
1. 自动记账引擎（核心亮点）
- CSV 流水批量导入解析：支持微信、支付宝、银行卡、券商流水上传，后端自动识别收支、转账、投资交易；基于
交易时间+金额+账户做去重，避免重复生成账单。解析失败的流水进入待审核队列，人工确认后正式入账，防止脏数据。 - 周期自动记账：工资、定投、房贷、固定消费，设置周期规则，定时任务自动生成账单。
- AI 辅助解析（可选）：对接大模型 API，解析短信、OCR 识别小票文本，提取交易信息；低置信度记录进入待审。
- 账单审计日志：新增、修改、删除账单全部留存变更前后数据，方便财务溯源。
2. 资产管理模块
- 多品类资产录入：活期存款、定期、基金、股票、理财、房产；负债录入：信用卡、房贷、消费贷；自动计算总资产、总负债、净资产。
- 投资持仓核算：申购、赎回、分红记录；自动计算持仓成本、浮盈浮亏、XIRR 年化收益率；每日定时拉取标的行情，生成资产净值快照，绘制净资产历史曲线。
- 多账本隔离：个人账本、家庭账本、投资账本，每条账单、资产记录绑定
ledger_id账本 ID，账本数据完全隔离；全局资产汇总仅做统计，不修改原始流水。
3. 预算、报表与智能提醒
- 预算管理：总预算、分类预算，月度自动重置；80% 预警、100% 耗尽、超支三级告警。
- 财务报表：收支趋势、资产配置饼图、投资收益报告；支持 Excel 导出，会员解锁 PDF 高级报告。
- 智能提醒：定投提醒、账单待审核提醒、还款到期提醒、预算超支、持仓涨跌异动、会员到期提醒；后端定时任务触发，Redis 冷却去重，避免消息轰炸；站内通知，可扩展微信服务通知。
4. 会员系统（可选商用模块）
后台自定义月 / 季 / 年套餐、试用时长；免费用户限制账本数量、报表导出次数；VIP 解锁无限账本、批量导入、PDF 报告、关闭广告。后端接口鉴权，会员到期仅收回 VIP 功能，用户资产账单数据永久保留。
5. 数据备份与多端同步
- 支持单账本 / 全量数据 JSON/CSV 备份与恢复；
- Uni-app 前端，编译 H5、微信小程序；多端账号统一，增量数据云端同步。
二、项目目录结构
asset-auto-account-source/
├── uni-frontend # H5/小程序前端
│ ├── pages/asset # 资产总览、各类资产台账
│ ├── pages/bill # 账单列表、流水导入、待审核队列
│ ├── pages/message # 消息提醒中心
│ └── pages/member # 会员套餐、我的会员
├── admin-frontend # PC管理后台
├── backend
│ ├── controller
│ ├── service
│ │ ├── auto_bill # 自动记账、CSV解析、待审核队列
│ │ ├── asset_mgr # 资产、负债、净值快照计算
│ │ ├── portfolio # 投资持仓、盈亏、XIRR核算
│ │ ├── ledger # 多账本数据隔离
│ │ ├── budget # 预算消耗与预警
│ │ ├── alert # 智能提醒引擎、冷却去重
│ │ └── member # 会员套餐、订单、鉴权
│ ├── db/migration
│ │ ├── bill.sql # 账单主表
│ │ ├── bill_pending.sql # 待审核流水表
│ │ ├── asset_account.sql # 资产账户表
│ │ ├── asset_snapshot.sql # 每日资产净值快照
│ │ ├── ledger.sql # 账本表
│ │ ├── alert_message.sql # 用户消息表
│ │ └── member、order相关数据表
│ └── task
│ ├── auto_bill_periodic_job # 周期账单自动生成
│ ├── asset_snapshot_job # 每日资产净值快照任务
│ ├── alert_scan_job # 扫描触发各类提醒
│ └── member_expire_job # 会员到期检测
├── docs
│ ├── deploy.md # 保姆级搭建文档
│ ├── api.md # 接口文档
│ └── db_doc.md # 数据库设计说明
└── readme.md
运行环境：云服务器、MySQL、Redis；行情数据依赖第三方公开 API。
三、搭建步骤（保姆级）
- 源码准备：优先 Gitee/Github 开源仓库，仔细阅读开源协议，不要下载网盘不明源码。
- 后端部署
- 新建 MySQL 数据库，导入项目 SQL 脚本初始化数据表；
- 修改
.env配置文件，填写数据库、Redis、行情源、支付密钥； - 安装项目依赖，启动后端服务；
- 配置 4 个定时任务（缺一不可）：周期账单任务、资产快照任务、提醒扫描任务、会员过期检测任务。
- 前端部署
- 修改前端接口地址为服务器域名；
- HBuilderX 编译 H5 / 小程序包，部署 PC 管理后台；
- 后台配置收支分类、会员套餐、提醒默认阈值。
- 全流程测试
- 导入银行 / 支付宝 CSV，测试自动解析、去重、待审核；
- 添加资产、投资持仓，验证净值、浮盈、XIRR 计算；
- 切换多账本，确认账本隔离，全局汇总数值正确；
- 测试预算告警、定投提醒，验证冷却防轰炸；
- 会员权限校验：免费账号访问 VIP 接口后端拦截。
四、高频踩坑清单
- 自动记账仅前端模拟，后端无解析逻辑，上传文件无法生成真实账单；
- 净值、盈亏前端计算，刷新页面数据错乱；金融金额运算后端统一处理，规避浮点数精度问题；
- 定时任务忘记配置，资产快照不更新、提醒失效；
- 会员鉴权只做前端隐藏，可直接调用接口绕过权限；
- 缺少
ledger_id隔离，跨账本越权查询，造成数据泄露； - 行情第三方接口限流 / 失效，净值不再更新，需要增加缓存降级。
五、适用场景
- 个人 / 家庭全套资产管理，收支记账 + 投资资产统一管理；
- 理财顾问工作台，批量导入客户流水，输出资产财务报告；
- 二次开发底座，自动记账 + 资产净值整套业务复用；
- 技术学习，学习财务系统自动流水解析、资产快照、定时告警开发。
