这套系统主打个人消费多维分析 + 完整会员付费权限体系，用于记录收支、自动生成消费画像、预算管控，搭配智能提醒、多账本隔离、数据报表导出，采用 Uni-app 跨端开发，支持 H5、微信小程序、PC 管理后台，适合个人财务分析学习或二次开发。
⚠️风险提示：网上网盘 “免费完整版源码” 大多属于盗版，存在后门木马、版权侵权问题；开源项目务必阅读开源协议，开源不等于可以商用。源码仅作学习自用，所有财务测算仅参考，不构成任何理财建议；对外上线运营务必做代码安全审计，用户财务敏感数据加密存储。
一、核心功能
1. 消费分析核心模块
- 账单管理与批量导入 收支、转账记录录入；支持微信、支付宝、银行卡 CSV 流水上传，后端自动解析交易信息；重复流水自动去重，识别失败流水进入待审核队列，人工确认后入账；账单修改、删除留存审计日志。
- 多维消费画像分析 消费分类占比、月度 / 季度消费趋势、高频商户统计、大额消费标记；自动区分刚性支出和弹性消费，统计每月结余，生成消费诊断；图表可视化展示，定位不必要开销。
- 预算管控 自定义分类预算、总预算，支持按月自动重置；80% 预警、100% 耗尽、超支三级告警，Redis 冷却防止消息轰炸。
- 数据备份与导入导出 支持 JSON/CSV 全量账单备份恢复；会员解锁 PDF 消费复盘报告。
2. 会员系统（变现核心）
- 套餐自定义配置 后台可新建月卡、季卡、年卡、永久会员，可开启 7 天试用。
- 免费用户：最多 1 个账本、基础账单录入、简易消费统计、有限导出次数；
- VIP 会员：无限账本、全维度消费画像分析、PDF 报告、批量流水导入、关闭广告、高级数据筛选。
- 订单与支付回调 用户下单生成订单，支付回调自动开通会员；会员到期自动降级，到期前推送续费提醒；订单、支付记录完整留存。
- 后端鉴权 高级分析报表、批量导入接口后端强制校验会员有效期，不只是前端隐藏按钮；会员过期后，用户所有账单、消费数据全部保留，仅收回 VIP 功能。
- 后台会员运营面板 后台手动开通 / 延期 / 取消会员；会员付费、续费率统计；会员权限变更操作日志留痕。
3. 智能提醒模块
- 预算超支提醒、大额消费提醒；
- 周期性固定支出（房租、月供）到期提醒；
- 账单待审核通知、会员到期续费提醒；
- 用户可单独开关各类提醒；多端消息已读状态云端同步。
4. 多账本隔离
个人账本、家庭账本相互独立，账单绑定ledger_id账本 ID；支持全局汇总所有账本的收支与消费统计，数据互不干扰。
5. 多端适配
Uni-app 前端，一套代码编译 H5、微信小程序；PC 管理后台用于用户、会员套餐、系统参数、日志管理；账号云端同步账单数据。
二、项目目录结构
consume-analysis-member-source/
├── uni-frontend # H5/小程序前端
│ ├── pages/bill # 账单录入、流水导入、待审核队列
│ ├── pages/analysis # 消费分析看板、各类图表
│ ├── pages/member # 会员套餐、我的会员
│ └── pages/message # 消息提醒中心
├── admin-frontend # PC管理后台（Vue+ElementUI）
├── backend
│ ├── controller
│ ├── service
│ │ ├── bill_parse # CSV流水解析、待审核账单
│ │ ├── consume_analysis # 消费画像、趋势、预算计算
│ │ ├── ledger # 多账本数据隔离
│ │ ├── member # 会员套餐、权限鉴权
│ │ ├── order # 会员订单、支付回调处理
│ │ └── alert # 智能提醒引擎、冷却去重
│ ├── db/migration
│ │ ├── bill.sql # 账单主表
│ │ ├── bill_pending.sql # 待审核流水表
│ │ ├── consume_category.sql # 收支分类表
│ │ ├── ledger.sql # 账本表
│ │ ├── member_package.sql # 会员套餐
│ │ ├── member_order.sql # 会员订单
│ │ └── alert_message.sql # 用户消息提醒表
│ └── task
│ ├── alert_scan_job # 定时扫描触发各类提醒
│ ├── budget_reset_job # 每月预算自动重置
│ └── member_expire_job # 会员到期检测自动降级
├── docs
│ ├── deploy.md # 完整搭建部署文档
│ ├── api.md # 接口文档
│ └── analysis_cfg.md # 消费分析指标配置说明
└── readme.md
运行环境：云服务器 + MySQL + Redis，对外访问必须配置 HTTPS。
三、保姆级搭建教程
- 源码准备 优先选择 Gitee/Github 正规开源仓库，仔细阅读开源协议，不要下载网盘来路不明源码。
- 后端部署
- 新建 MySQL 数据库，导入项目 SQL 脚本，初始化数据表；
- 修改
.env配置文件，填写数据库账号密码、Redis、支付商户密钥； - 安装项目依赖，启动后端服务；
- 开启 3 个定时任务（缺一不可）
alert_scan_job：扫描触发预算、会员到期等提醒；budget_reset_job：每月自动重置预算额度；member_expire_job：定时检测会员过期，回收 VIP 权限。
- 测试支付回调，验证支付成功后会员自动开通。
- 前端部署
- 修改前端接口地址为你的服务器域名；
- HBuilderX 编译 H5 / 微信小程序代码包；
- 登录 PC 管理后台，配置收支分类、会员套餐、免费用户权限上限。
- 上线全流程测试
- 导入支付宝 / 银行 CSV 流水，验证自动解析、去重、待审核功能；
- 录入多笔收支，校验消费分析图表、预算消耗、结余统计；
- 会员权限测试：免费账号调用 VIP 分析接口，后端返回无权限；
- 提醒测试：录入大额支出，验证预算告警，短时间多笔支出不会消息轰炸；
- 多账本测试：账本之间账单隔离，全局汇总统计数值正确。
四、高频踩坑汇总
- 消费分析图表仅前端静态展示，刷新页面统计数据丢失，统计计算逻辑需要放在后端；
- 会员鉴权只做前端隐藏按钮，可直接调用接口绕过 VIP 权限，存在安全漏洞；
- 定时任务忘记配置，预算每月不会重置、提醒失效、会员到期不会自动降级；
- 缺少
ledger_id账本隔离，跨账本越权查询，造成用户消费数据泄露； - 金额浮点数精度问题，收支金额运算出现多余小数；
- CSV 解析规则单一，不同银行账单格式无法适配，缺少解析失败兜底待审核队列。
五、适用场景
- 个人 / 家庭收支记账，自动做消费分析，优化消费结构；
- 公众号 H5 财务工具，搭配会员套餐做变现；
- 学习项目：学习流水解析、消费数据统计、会员订阅、消息告警业务逻辑；
- 二次开发，可以接入资产、投资模块，组合成完整个人财务管理平台。
