净值理财工具核心是资产净值快照、持仓收益核算、多账本隔离，搭配完整会员付费体系，实现免费用户、付费会员功能权限隔离。网上大量所谓 “热门全套源码”，会员仅做前端页面展示，后端没有鉴权；净值计算只统计本金，浮盈浮亏不参与核算，只能演示，无法商用落地。
⚠️重要提醒：网络网盘免费下载的源码很多是盗版泄露，藏后门、恶意代码；开源项目务必阅读开源协议，开源不等于允许商用；源码只是开发底座，不具备金融业务资质，对外上线需要遵守监管法规，测算数据仅供参考，不构成投资建议。
一、核心功能总览
1. 净值理财核心模块
- 多账本净值引擎 每个账本独立计算总资产、负债、净资产；定时生成每日净值快照，输出净值历史曲线；浮盈浮亏、已实现收益、XIRR 收益率全部后端运算；支持全局跨账本资产汇总统计，不修改原始流水数据。
- 持仓与交易管理 基金、股票、存款、理财资产录入；申购、赎回、分红、定投流水记录；支持 CSV 批量导入交易记录；成本、盈亏自动核算。
- 账单 & 预算模块 收支账单录入、分类统计；分类预算、超支预警；账单变更联动账户余额变动。
- 报表导出 资产报告、收益分析、账本报表，高级 PDF / 批量导出权限绑定会员。
- 多端同步 H5、小程序、Web 共用一套后端，持仓、账本、会员状态多端互通。
2. 齐全会员系统（商用关键）
- 会员套餐配置 后台自定义套餐：月卡、季卡、年卡、永久会员；设置价格、有效期、7 天试用；可开关各个功能权限。
- 免费用户：基础账本、简单净值查看、有限报表导出次数；
- VIP 会员：无限账本、完整净值历史曲线、XIRR 分析、批量报表 PDF 导出、多情景测算、无广告；
- 订单与支付回调 用户下单生成订单，支付回调自动开通会员；会员到期自动降级；到期前站内消息提醒续费；完整订单流水记录。
- 后端接口鉴权（重中之重） 禁止只做前端隐藏按钮，高级功能接口后端强制校验会员等级与到期时间；非会员直接访问高级接口返回权限不足；会员过期自动收回付费功能，用户原始账本、持仓、账单数据保留不删除。
- 后台会员运营 后台手动给用户开通 / 延期 / 取消会员；统计会员付费、续费率；完整操作日志，会员变更全部留痕。
二、项目目录结构
networth‑vip‑finance‑source/
├── uni‑frontend # H5/小程序前端，净值看板、会员中心、账本管理
│ ├── pages/member # 会员购买、我的会员、套餐页面
│ └── pages/networth # 净值总览、持仓、账本切换
├── admin‑frontend # 管理后台：会员、订单、套餐、用户统计
├── backend
│ ├── controller
│ ├── service
│ │ ├── networth # 净值快照、收益率计算
│ │ ├── ledger # 多账本数据隔离
│ │ ├── member # 会员业务逻辑、权限鉴权
│ │ └── order # 会员订单、支付回调处理
│ ├── db/migration
│ │ ├── member.sql # 会员表
│ │ ├── member_package.sql # 会员套餐表
│ │ ├── member_order.sql # 会员订单表
│ │ ├── ledger.sql # 多账本表
│ │ └── networth_snapshot.sql # 净值快照表
│ └── task # 定时任务：生成净值快照、会员到期检测
├── docs # 部署文档、接口文档、会员权限配置说明
└── readme.md
运行环境：云服务器、MySQL，推荐 Redis；对外访问必须配置 HTTPS。
三、完整搭建部署教程
步骤 1：源码准备
优先选择正规开源仓库，核对版权协议；不要使用来路不明的网盘源码，规避后门与版权纠纷。
步骤 2：后端部署
- 服务器新建数据库，导入全套数据库脚本。
- 修改
.env配置文件，填写数据库账号、支付商户密钥、行情源配置。 - 上传后端代码，安装依赖，启动服务。
- 配置两套定时任务：①每日生成各账本净值快照；②定时检测会员到期，自动回收会员权限。
- 配置支付回调地址，先用测试模式调试下单流程。
步骤 3：前端部署
- 修改前端接口地址为你的服务器域名。
- 编译 H5、小程序代码包，部署管理后台。
- 登录管理后台，添加会员套餐，配置每个套餐对应的功能权限。
步骤 4：上线必做联调测试
- 测试会员流程：测试支付下单，校验会员自动开通、到期时间正确；模拟会员过期，高级功能无法访问，基础账本数据保留。
- 净值校验：录入持仓产生盈亏，验证账本净值、快照数据同步更新。
- 权限校验：免费账号调用会员专属接口，后端拦截，不能绕过前端直接拿到高级数据。
- 多账本测试：账本之间数据隔离，全局汇总统计数值正确。
- 报表导出：会员可批量导出 PDF，免费用户限制导出次数。
四、高频踩坑汇总
- 会员仅前端控制：页面隐藏 VIP 功能，直接调用接口依旧可以使用，属于严重安全漏洞，鉴权必须放在后端。
- 净值计算只统计本金：持仓浮盈浮亏不参与净值计算，净值曲线完全失真。
- 会员到期删除用户数据：过期只收回付费权限，账本、账单、持仓数据必须完整保留。
- 定时任务漏配：净值快照不生成、会员到期不会自动降级。
- 支付回调异常：网络波动回调丢失，订单状态与会员状态不一致，需要补单机制。
- 缺少 ledger_id 隔离：账本之间数据混淆，越权可以查看他人账本数据。
五、适用落地场景
- C 端净值理财工具：多账本资产管理，免费 + 会员付费变现模式；
- 理财顾问工作台：给客户做资产净值分析，输出付费财务报告；
- 二次开发底座：复用净值核算、多账本、整套会员付费模块快速迭代项目；
- 技术学习：学习理财净值计算、订阅会员鉴权、订单支付回调整套业务逻辑。
