这套系统最大特点：基金投资分析 + 个人消费记账分析二合一，一边做基金持仓、组合收益、风险测评；一边做收支账单、预算管控、消费画像分析，打通投资资产与日常消费数据流，输出完整个人财务报告。网上很多所谓 “全套源码” 只做投资模块，消费分析只是简单静态图表，两边数据割裂，不能联动计算可投资结余。
⚠️风险提示：网络网盘 “免费完整版” 大多盗版，存在后门、版权风险；开源项目务必阅读开源协议，开源不等于允许商用。源码仅工具底座，无金融牌照，所有测算仅供参考，不构成投资建议；对外上线务必做代码审计，财务敏感数据加密存储。
一、系统核心功能
1. 基金投资分析模块
- 持仓与交易管理 基金买入、卖出、分红、定投流水录入；支持券商 CSV 导入；自动计算持仓成本、浮盈浮亏、XIRR 年化收益率；按账本隔离投资持仓。
- 基金数据与筛选 基金搜索、基金对比；4433 法则、夏普比率、最大回撤多条件筛选；基金档案、历史净值、持仓穿透查看。
- 组合分析 资产配置饼图、行业集中度分析、组合风险指标（波动率、最大回撤）；定投策略回测；输出组合诊断报告。
- 投资智能提醒 持仓涨跌异动提醒、定投到期提醒、分红提醒、估值高低预警；Redis 冷却防消息轰炸。
2. 消费账单 & 财务分析模块（和投资打通）
- 账单管理 收支、转账记录；CSV 批量导入微信 / 支付宝账单；编辑删除账单自动联动账户余额；账单审计日志。
- 预算管控 总预算、分类预算；月度周期自动重置；80%/100%/ 超支三级告警提醒。
- 消费画像分析 消费分类占比、月度消费趋势、消费排行；统计每月可结余资金，联动定投，测算每月可用于投资的闲钱。
- 攒钱目标 设置存钱目标，流水自动更新进度。
3. 全局财务总览（核心亮点）
- 总资产 = 现金存款 + 基金理财资产 − 负债；
- 同时展示：投资收益、本期收支结余、每月可投资闲钱；
- 多账本隔离：个人消费账本、投资账本、家庭账本完全隔离，支持全局聚合统计。
4. 报表、会员、消息中心
- 财务报告：投资组合报告、消费分析报告，支持 Excel/PDF 导出，PDF 导出绑定会员权限。
- 会员系统：后台配置月 / 季 / 年套餐；后端鉴权，免费用户限制报表次数、基金对比数量；会员到期只收回付费能力，用户原始数据保留。
- 消息中心：投资提醒、预算超支提醒、账单待审核、会员到期提醒；多端同步已读状态。
- 多端适配：Uni‑app 编译 H5、小程序；管理后台 PC 端。
5. 定时任务
- 每日拉取基金净值，生成账本净值快照；
- 周期定投 / 周期账单自动生成；
- 定时扫描触发各类智能提醒；
- 预算周期重置任务。
二、项目目录结构
fund‑consume‑analyse‑source/
├── uni‑frontend # H5/小程序前端
│ ├── pages/fund # 基金持仓、基金分析、组合报告
│ ├── pages/bill # 账单、消费分析看板
│ ├── pages/message # 消息提醒中心
│ └── pages/member # 会员中心
├── admin‑frontend # PC管理后台
├── backend
│ ├── controller
│ ├── service
│ │ ├── fund_portfolio # 基金持仓、收益计算、回测
│ │ ├── fund_data # 基金数据拉取、筛选、对比
│ │ ├── consume_analyse# 消费画像、结余测算
│ │ ├── bill # 账单、账户余额联动
│ │ ├── budget # 预算告警逻辑
│ │ ├── ledger # 多账本数据隔离
│ │ ├── alert # 智能提醒引擎、冷却去重
│ │ └── member # 会员鉴权、订单处理
│ ├── db/migration
│ │ ├── fund_position.sql # 基金持仓表
│ │ ├── fund_transaction.sql # 基金交易流水
│ │ ├── bill.sql # 收支账单
│ │ ├── ledger.sql # 多账本
│ │ ├── alert_message.sql # 消息提醒
│ │ └── member相关数据表
│ └── task
│ ├── fund_net_task # 更新基金净值、生成净值快照
│ ├── alert_scan_task # 扫描触发各类提醒
│ ├── periodic_task # 周期定投、周期账单
│ └── budget_reset_task # 预算周期重置
├── docs
│ ├── deploy.md # 完整搭建部署文档
│ ├── api.md # 接口文档
│ └── analysis_doc.md # 基金&消费分析模块配置文档
└── readme.md
运行环境：云服务器、MySQL、Redis；对外访问必须配置 HTTPS；基金行情依赖第三方公开数据源。
三、部署文档核心步骤
步骤 1：源码准备
优先 GitHub 正规开源仓库，核对开源协议；拒绝来路不明网盘源码，规避后门风险。
步骤 2：后端部署
- 创建数据库，导入全套数据库脚本。
- 修改
.env配置文件：数据库、Redis、行情源、支付密钥。 - 上传后端代码，安装依赖，启动服务。
- 配置 4 个必须开启的定时任务
fund_net_task：拉取基金净值，生成账本净值快照；alert_scan_task：扫描触发投资、预算各类提醒；periodic_task：周期定投、周期账单生成；budget_reset_task：预算周期自动重置。
- 接口测试：导入基金交易记录，验证收益计算；导入消费账单，验证消费分析报表输出。
步骤 3：前端部署
- 修改前端接口地址为自己服务器域名。
- 编译 H5、小程序包，部署管理后台。
- 后台配置会员套餐、系统收支分类。
步骤 4：上线必做测试
- 基金模块：录入基金买卖分红，校验成本、浮盈浮亏、XIRR 计算正确；测试涨跌提醒触发、冷却去重。
- 消费分析：录入多笔收支，验证消费分类占比、每月可投资结余测算准确。
- 数据联动：投资资产 + 消费账单共同汇总出全局净资产。
- 多账本：投资账本、消费账本数据隔离，全局汇总等于各账本相加。
- 会员鉴权：后端拦截 VIP 接口，不能只靠前端隐藏按钮。
- 报表导出：校验投资报告、消费分析报告数据口径与页面一致。
四、高频踩坑汇总
- 投资模块与消费模块数据割裂：两套数据互不感知，算不出每月可投资闲钱，失去系统核心价值。
- 行情源依赖第三方接口：第三方接口变更、限流会导致基金净值停止更新，需要做好异常捕获、缓存降级。
- 提醒写在前端：关闭页面就收不到提醒，提醒逻辑全部后端定时任务执行。
- 金额浮点数精度丢失：基金盈亏、账单金额运算出现多位小数，后端统一做金额精度处理。
- 缺少 ledger_id 账本 ID 隔离：投资持仓、账单跨账本越权查询，数据错乱泄露。
- 会员只做前端控制：直接调用接口可绕过权限，高级功能接口后端强制鉴权。
- 定时任务漏配：净值不更新、提醒不触发、预算不重置。
五、适用落地场景
- C 端个人财务工具：同时管理基金投资和日常消费，分析可投资闲钱，做完整个人财务复盘；
- 理财顾问工作台：给客户同时输出消费分析 + 基金组合诊断报告；
- 二次开发底座，复用基金分析、消费画像、多账本、智能提醒整套业务快速迭代；
- 技术学习：学习投资组合计算、消费大数据分析、多模块财务系统业务设计。
