这套源码分为纯前端本地版（零服务器，电脑直接打开） 和轻量后端版（Docker 一键部署，支持多端云同步），主打低门槛上手，包含基金持仓管理、收益核算、资产看板、智能提醒，附带完整搭建文档，适合个人学习、自用记账。
⚠️风险提示：网络网盘标注免费全套源码很多是盗版，存在后门、版权隐患；开源项目务必查看开源协议，开源不等于商用授权。源码仅作为学习工具，无金融牌照，收益测算仅作参考，不构成任何投资建议；正式上线务必做代码安全审计，用户财务数据做好加密。
一、核心功能
- 基金持仓与交易流水 基金申购、赎回、分红、定投记录录入；支持 CSV 批量导入交易记录；自动计算持仓成本、浮盈浮亏、XIRR 内部收益率；可查看每笔交易历史。
- 基金资产分析看板 资产饼图、持仓盈亏曲线、基金组合收益统计；查看单只基金净值走势，快速了解组合盈亏情况。
- 定投管理 + 智能提醒 新建定投计划，设置定投周期与金额；定投到期提醒、持仓涨跌预警、分红到账提醒；支持单独开关各类提醒，防消息轰炸。
- 多账本隔离 投资账本、家庭账本相互独立，账本数据隔离；支持全局资产汇总统计，方便区分不同资金池。
- 数据备份恢复 支持导出 JSON/CSV 备份全部持仓和交易记录，备份文件可导入恢复，防止数据丢失。
- 可选会员模块（后端版） 免费用户限制持仓数量、报表导出次数；VIP 解锁无限持仓、PDF 资产报告、批量导入，后端鉴权，会员过期只收回高级功能，保留历史数据。
二、项目目录结构
①静态小白版（HTML+CSS+JS，无需数据库）
fund-static-lite/
├── index.html # 首页资产看板、基金列表
├── css/style.css # 移动端适配样式
├── js/fund.js # 盈亏计算、本地存储、图表逻辑
└── readme.md # 小白使用说明
直接双击index.html打开，数据存在浏览器本地存储，单机使用。
②轻量后端版（Docker 一键部署，云同步）
fund-lite-server/
├── h5-frontend # H5前端页面，可编译小程序
├── admin-panel # 简易管理后台
├── backend
│ ├── controller
│ ├── service
│ │ ├── fund_portfolio # 持仓、盈亏、XIRR计算
│ │ ├── alert # 定投、涨跌提醒
│ │ ├── ledger # 多账本隔离
│ │ └── member # 会员权限（可选）
│ ├── db/migration # 数据库建表SQL
│ └── task # 定时任务：净值更新、提醒扫描
├── docker-compose.yml # 一键部署配置
└── docs
└── deploy.md # 保姆级搭建教程
运行环境：服务器、MySQL、Redis；基金净值依赖第三方行情接口。
三、小白搭建教程
方案 1：静态本地版（零基础首选，不用服务器）
- 将源码解压到电脑本地文件夹。
- 直接双击
index.html，浏览器打开就能使用，无需安装任何软件。 - 录入基金买入卖出记录，验证盈亏、图表自动更新。
- 定期导出备份文件，清除浏览器缓存会丢失所有数据。
外网访问：将静态文件上传静态托管平台，设置首页
index.html，即可获得公开访问链接。
方案 2：Docker 后端一键部署（多设备云同步）
- 云服务器安装 Docker 和 Docker Compose。
- 下载源码，修改
.env配置文件，填写数据库、行情源信息。 - 执行命令：
docker-compose up -d，自动拉起服务并初始化数据库。 - 配置定时任务：
- 净值更新任务：定时拉取基金最新净值，更新持仓盈亏；
- 提醒扫描任务：触发定投提醒、涨跌预警。
- 访问网页地址，登录后台配置参数；H5 可打包部署到公众号 / 小程序。
四、上线必做测试
- 录入基金交易，验证成本、浮盈、XIRR 计算是否准确；
- 导入 CSV 交易文件，校验数据导入，重复导入不会重复生成记录；
- 测试定投提醒，验证告警触发，短时间波动不会疯狂推送消息；
- 切换多账本，确认账本数据隔离，全局资产汇总计算正确；
- 会员功能测试（后端版）：VIP 接口后端校验，无法仅前端绕过权限。
五、高频踩坑
- 行情接口有调用限额，接口失效会导致净值无法更新，需要做好缓存；
- 金额计算放在前端，刷新页面数据丢失，金融计算推荐后端处理；
- 定时任务忘记开启，净值不更新、定投提醒失效；
- 浮点数精度问题，盈亏计算出现异常多位小数；
- 网盘源码捆绑后门，不要录入真实资金信息。
六、适用场景
- 个人基金投资记账，跟踪持仓盈亏、定投计划；
- 学习前端 / 后端财务系统开发，熟悉资产收益计算逻辑；
- 二次开发，扩展消费记账、预算模块，组合成完整个人理财系统。
