模拟基金 · 定投系统

用真实基金数据玩模拟盘。真实 T+1 撮合、真实内扣申购费、真实 FIFO 阶梯赎回费， 每日签到领本金。部署在 Cloudflare 免费全家桶上，零成本运行。

模拟盘 · 数据来自公开接口 · 仅供学习，不构成投资建议

为什么不是又一个玩具

市面上的模拟炒股大多用随机数或简化规则。这个项目较真的地方：

• 真实数据：基金档案、费率、起购金额、历史净值全部来自东方财富公开接口
• 真实 T+1：交易日 15:00 前下单按当日净值成交，之后顺延至下一交易日； 每晚 20:30 由 Cron 拉取当日净值并撮合
• 真实内扣法申购费：净申购金额 = 申购金额 ÷ (1 + 费率)， 而不是常见的错误实现 费用 = 金额 × 费率（外扣法会多收钱）
• 真实 FIFO 阶梯赎回费：份额按批次先进先出消耗，每批按各自持有天数套费率档。 同一笔赎回可能同时按 1.5% 和 0.5% 两档计费——这就是为什么需要 share_lot 表， 只存持仓汇总是算不出正确赎回费的
• 整数存储：金额存「分」、份额/净值存 ×10000 整数，中间运算走 decimal.js。 绝不用浮点数算钱

实测数据（本地端到端验证）

申购 1000 元，费率 0.15%，确认日净值 1.3100：

净申购 = 100000 ÷ 1.0015 = 99850 分   手续费 = 150 分（1.5 元）
份额   = 998.50 ÷ 1.31 = 762.2137 份

赎回 300 份（持有 0 天，命中 <7天 档 1.5%）：

赎回总额 = 300 × 1.31 = 393.00 元
赎回费   = 39300 × 1.5% = 590 分（5.90 元）
到账     = 387.10 元

share_lot 与 holding 对账完全一致，一分不差。

权限矩阵

身份	看主理人组合	看自己组合	下单 / 定投 / 签到
游客（未登录）	✅ 只读（全部公开）	—	❌
普通用户	✅ 只读	✅ 读写	✅（仅自己的）
管理员（主理人）	✅ 读写（即自己的盘）	同上	✅

管理员由环境变量 ADMIN_USERNAME 指定，没有独立后台—— 主理人的 /me 就是那个被公开的盘，/master 只是它的只读镜像。一份代码，两种身份。

功能

• 注册即送 10 万模拟本金，用户名 + 密码，不要邮箱不要手机号
• 每日签到领本金：基础 100 元/天，每多连签一天 +50 元，封顶 500 元，断签归零
• 基金发现：搜索 + 排行榜挑热门；详情页有真实档案、费率、风险等级、 净值曲线（1 月 / 3 月 / 1 年 / 全部，可叠加沪深300 基准对比）
• 自选基金：收藏关注的基金，自选页快速看日涨跌
• 买入：抽屉内按内扣法实时预估手续费与份额
• 赎回：抽屉内按 FIFO 逐批试算，展示各批持有天数、费率与费用明细； 持仓详情页可看份额批次与待赎回占用
• 定投：支持日 / 周 / 月，Cron 每日自动扫描下单，可暂停 / 启用 / 删除
• 资产时间线：逐日重放总资产，收益趋势图 + 收益日历，签到入金不算收益
• 收益排行榜：全站用户收益率 / 总收益双榜（累计口径：清仓利润保留、 签到不算收益、pending 买单在途资金计入总资产），前三名奖牌 + 我的排名， 游客免登录围观
• 订单与流水：全部可追溯，区分手动 / 定投来源与待确认 / 已确认 / 失败状态
• 围观主理人盘：游客免登录查看管理员的持仓、定投与交易流水
• 移动端适配：响应式布局 + 底部导航栏
• 重置模拟盘：练废了一键归零，不用重新注册

技术栈

层	选型
框架	React Router v8（framework mode）+ Vite 8
运行时	Cloudflare Workers
UI	Ant Design v6 + @ant-design/charts
数据库	Cloudflare D1（SQLite）+ Drizzle ORM
缓存	Cloudflare KV
定时	Cloudflare Cron Triggers
密码	PBKDF2（Web Crypto，Workers 跑不了 bcrypt）
工具	Zod + dayjs + decimal.js
测试	Vitest + @cloudflare/vitest-pool-workers（真实 workerd + 真实 D1）
包管理	pnpm

快速开始

pnpm install
pnpm db:migrate:local    # 建本地 D1 表（首次必须）
pnpm dev

打开输出的 localhost 地址，注册一个账号即可开玩。 要成为「主理人」，用 wrangler.jsonc 里 ADMIN_USERNAME 指定的用户名注册。

线上环境

D1 数据库与 KV 已在 Cloudflare 上创建好，wrangler.jsonc 里的 id 已填实：

资源	名称 / id
D1	fund-plan-db（区域 WNAM）
KV	binding KV

线上库已跑完迁移（12 张业务表）。合并到 main 后 GitHub Actions 自动执行 「测试 → 全绿 → 部署到 Cloudflare」流水线（含幂等 D1 迁移， 见 .github/workflows/deploy.yml）；需要时也可本地手动 pnpm deploy。 本地开发用的是 miniflare 模拟的独立数据库（.wrangler/state/），与线上互不影响。

完整部署步骤见 docs/deployment.md。 开发约定与踩坑记录见 docs/development.md。

测试

pnpm test          # 领域层单测（纯函数，毫秒级）
pnpm test:workers  # 应用层集成测试（真实 workerd + 真实 D1）
pnpm test:all      # 全部
pnpm lint          # 代码规范检查
pnpm verify        # lint + typecheck + test，提交前全量校验

提交时 git 钩子会自动跑：pre-commit 对暂存文件跑 eslint --fix， pre-push 跑 typecheck 与全部测试。

测试覆盖的关键场景：

• 申购内扣法（含「净申购 + 费用 === 申购金额」一分不丢的守恒校验）
• FIFO 阶梯赎回费（跨档位、乱序入参、碎渣份额）
• 交易日历 T+1（15:00 cutoff、周末节假日、跨 UTC 日界）
• 撮合幂等（Cron 重试不产生重复成交）
• 净值缺失时订单顺延而非误判失败
• share_lot 与 holding 对账一致性
• 连签奖励递增 / 封顶 / 断签归零
• 排行榜口径（清仓利润保留、签到不算收益、在途资金计入总资产、 收益率与总收益两维排序互不可推）
• 无净值兜底估值回归钉（costBasisNavScaled，曾因缺 ×100 被低估百倍）
• 越权防护（不能操作他人的定投计划）

项目结构

app/
  domain/       纯函数领域层（撮合、赎回、定投、签到、估值、排行榜、资产时间线、交易日历）
  services/     应用层（数据接入、认证、下单、撮合、组合读取、排行榜聚合）
  routes/       页面与 loader/action
  components/   复用 UI（净值图、买入/赎回抽屉、组合视图、收益日历）
  db/           Drizzle schema 与 client
workers/app.ts  Worker 入口（fetch + scheduled）
drizzle/        迁移 SQL
tests/          单元测试与集成测试
docs/           部署与开发指南（设计文档与实施计划为本地工作文档，不入库）

已知限制

• 不发邮件：CF 免费版无 SMTP，故无邮箱验证与邮件找回密码，忘密码需管理员手动重置
• 无盘中实时估值：fundgz 接口从服务器直连被挡；T+1 撮合本身用收盘净值，不受影响
• 节假日表需每年更新：见 app/domain/trading-calendar.ts，有净值日反向校正作为兜底

文档

• 部署指南
• 开发指南
• 搜索引擎收录（SEO）