--- title: PRD 覆盖映射 / PRD Coverage Map status: living owner: Product last-updated: 2026-05-17 --- # PRD → 实现产物映射 / PRD Section → Artifact Map PRD-V1.0.md 一共 23 节。这张表把每一节映射到当前实际承载它的**原型 / 文档 / 代码 / 跨服务流程**。 每行： - **PRD**：PRD 章节号 + 简称 - **承载产物**：哪些原型 / 文档真正在讲这件事 - **tech-flow**：跨服务交互流程文件（位于 `../docs/superpowers/flows/`），由 `bin/docs-prototype-alignment-check.sh` 校验存在 - **endpoints**：本章涉及的 OpenAPI 端点（` `），校验脚本检查当前 Swagger/SpringDoc 导出的 API artifact - **events**：本章涉及的 Kafka event 名，校验脚本会 grep `docs/5-contract/events.md` - **状态**：✅ 已覆盖 · 🟡 部分覆盖（缺东西见备注）· 🔴 未覆盖 · 🟦 ux-only（纯叙述章节，无后端交互，三新列豁免） - **缺什么**：还需要补的内容 --- ## 主线产品 / Main product | PRD | 主题 | 承载产物 | tech-flow | endpoints | events | 状态 | 缺什么 | |---|---|---|---|---|---|---|---| | 1 | 这是个什么产品 | hero · `index.html` · `prototype-mechanics.html` | — | — | — | 🟦 ux-only | — | | 2 | 我们卖给谁 | hero + `product-spec-V1.0.md` | — | — | — | 🟦 ux-only | — | | 3 | 整体玩法 | `prototype-V1.0.html` 主路径 + `prototype-journey.html` 用户视角 30 秒 + `prototype-journey-dev.html` 开发视角 30 秒 + `prototype-user-paths.html` 真实用户路径 | — | — | — | 🟦 ux-only | — | | 4 | 怎么登录 | `prototype-V1.0.html` 登录页 + `tech-flows.html` 1（initData 走 gateway/user-service） | ../docs/superpowers/flows/auth-tg-login.md | POST /auth/v1/tg/login, POST /auth/v1/refresh, POST /auth/v1/logout | user.registered | ✅ | — | | 5 | 如何充值 | `prototype-V1.0.html` 充值页 + `prototype-user-paths.html` 资金用户路径 + `tech-flows.html` 1 + `tg-bot-chat.html` Scene 2 | ../docs/superpowers/flows/wallet-deposit-bsc-usdt.md, ../docs/superpowers/flows/chain-deposit-confirmed-event.md | — | chain.deposit.confirmed, wallet.deposit.credited | ✅ | — | | 6 | 怎么玩 · 购票 | `prototype-V1.0.html` 大厅 + 号码池 + `prototype-large-ticket-picker.html` + `prototype-user-paths.html` 普通用户 / 异常路径 + `tech-flows.html` 2 | ../docs/superpowers/flows/game-buy-ticket.md | — | game.round.created, game.round.sold_out | ✅ | — | | 7 | 怎么开奖 | `draw-modes-explainer.html`（深度） + `prototype-mechanics.html` 01（外行向动画） + `tech-flows.html` 2 + `prototype-journey.html` Scene 6–7（用户视角）+ `prototype-journey-dev.html` Scene 6–7（开发视角） | ../docs/superpowers/flows/game-draw-backend-mode.md | — | game.draw.requested, chain.vrf.fulfilled, game.draw.completed, game.draw.timeout | ✅ | — | | 8 | 活动开奖触发条件 | `prototype-mechanics.html` 01 lead + `tech-flows.html` 2 步骤 4 | — | — | game.round.sold_out, game.round.canceled | 🟡 | 满约 vs 倒计时的 PM 触发优先级未在 prototype 中区分演示 | | 9 | 中奖类型 | `prototype-V1.0.html` 中奖页 + `prototype-journey.html` Scene 7–8 + `prototype-user-paths.html` 中奖领奖路径 | ../docs/superpowers/flows/prize-physical-claim.md | — | prize.physical.shipped, prize.physical.delivered, prize.physical.forfeited, prize.physical.refunded | 🟡 | 优惠券类奖品的差异化文案在 prototype 中不够细 | | 10 | 如何提现 | `prototype-V1.0.html` 提现页 + `prototype-user-paths.html` 资金用户路径 + `tech-flows.html` 3 + `prototype-mechanics.html` 04 | — | — | wallet.withdraw.broadcasted, wallet.withdraw.confirmed, wallet.withdraw.failed | ✅ | — | | 11 | 代理与邀请关系 | `prototype-V1.0.html` 邀请页 + `admin-agents-V1.0.md` | ../docs/superpowers/flows/agent-invite-bind.md | — | — | 🟡 | 6 级代理网络的层级展示原型仅简略 | | 12 | 用户邀请页面 | `prototype-V1.0.html` 邀请页 + `tg-bot-chat.html` Scene 5 | — | — | — | 🟦 ux-only | — | | 13 | VIP 等级 | `prototype-V1.0.html` 我的页 VIP 区 | — | — | — | 🟦 ux-only | VIP 升级机制 / 特权差异原型简略，Phase 1 是否上线未定 | | 14 | 我的页面 | `prototype-V1.0.html` 我的 Tab | — | — | — | 🟦 ux-only | — | ## 平台机制 / Platform mechanics | PRD | 主题 | 承载产物 | tech-flow | endpoints | events | 状态 | 缺什么 | |---|---|---|---|---|---|---|---| | 15 | 钱怎么分 | hub `index.html#biz` + `draw-modes-explainer.html` "5 路分账" + `prototype-economics.html` | — | — | — | 🟦 ux-only | — | | 16 | 平台资金保管 | `prototype-mechanics.html` 02 归集 + 03 冷热钱包 + `architecture.html` sign-service + `tech-flows.html` 3 | ../docs/superpowers/flows/sign-derive-addr.md | — | chain.btc.exposure.alert | ✅ | — | | 17 | 运营后台能干什么 | `prototype-admin-V1.0.html` + `admin-spec-V1.0.md` + 14 个 `admin-*.md` | ../docs/superpowers/flows/admin-withdraw-approve.md | — | — | ✅ | — | | 18 | 国际化 | `i18n-and-cdn.md` + 各原型的双语标记 | — | — | — | 🟡 | 实际 i18n 落地实现状态需在代码里查证 | | 19 | 不做什么 | hub 的 "产品边界" 决策卡 + `prototype-V1.0-decisions.md` | — | — | — | 🟦 ux-only | — | ## 路线与运维 / Roadmap & ops | PRD | 主题 | 承载产物 | tech-flow | endpoints | events | 状态 | 缺什么 | |---|---|---|---|---|---|---|---| | 20 | 上线后看什么数据 | `operations.html` SLO + `prototype-economics.html` KPI | — | — | — | 🟦 ux-only | — | | 21 | v1.x 路线图 | 13 个 `8-sprint-bXX.md` 文件 + `prototype-economics.html` | — | — | — | 🟦 ux-only | — | | 22 | 术语表 | PRD 22 内嵌（hub 没单独抽出） | — | — | — | 🟦 ux-only | 不需要独立产物 | | 23 | 文档配套 | `index.html` 的 doc-strip + footer 文件结构 | — | — | — | 🟦 ux-only | — | --- ## 关键架构决策（不在 PRD 编号内，但需追踪） / Cross-cutting decisions | 决策 | 承载产物 | 状态 | |---|---|---| | 9 服务拆分 | `architecture.html` + hub "MVP 决策" | ✅ | | DrawEngine 可插拔 | `draw-modes-explainer.html` + hub "MVP 决策" | ✅ | | env × executionChain 正交 | `architecture.html` + hub "MVP 决策" | ✅ | | 混合命名（代码英 · 文档双语） | hub "MVP 决策" + CLAUDE.md | ✅ | | 不做客服工单系统 | hub "产品边界" + `tg-bot-chat.html` Scene 6 | ✅ | | 运营 ≠ 运维边界 | hub "产品边界" + `admin-spec-V1.0.md` vs `operations.html` | ✅ | | 链支持:USDT 充值与提现均 BSC + ETH + TRON(含 TRON sweep);BTC 充值 / 提现 / 奖品 (后续开放) | hub hero + `architecture.html` + `product-spec-V1.0.md` | ✅ | --- ## 还没覆盖的灰色地带 / Gray areas not yet documented | 主题 | 现状 | 建议归属 | |---|---|---| | **TRON 上的 VRF 替代方案** | `architecture.html` 标 TBD，`prototype-mechanics.html` 01 提到 | 应在 `draw-modes-explainer.html` 加一章；产品口径需说明 TRON 下如何解释随机性 | | **冷钱包多签具体流程** | `prototype-mechanics.html` 03 概念有，无 SOP | 上线前由 SRE + 财务出 SOP，可在 `9-ops/` 加文档 | | **Bot 账号 / 频道 / 客服 ID 待定** | 所有原型用 placeholder（DuobaoBot / DuobaoSupport） | 项目负责人确认后批量替换 | | **法务区域开放清单** | 所有产物均标"待定" | 法务出清单后写进 PRD 2 或新文档 | | **钱包地址展示口径** | 暂无独立产物 | 需明确哪些地址给用户看、哪些只给后台 / SRE 看 | | **VIP 等级具体机制** | PRD 13 提到，原型简略 | Phase 1 是否上线未定；如上线，补 `prd-vip-spec.md` | | **实物履约 SOP** | `admin-fulfillment-V1.0.md` 提到，但仓库 / 物流细节未定 | Phase 1 如要上实物奖，需补 `admin-fulfillment-sop.md` | --- ## 怎么用这张表 / How to use this map **产品 / PM**： - 写新需求前先看 PRD X 是否已被覆盖； - 改原型前先确认会不会破坏其他章节的覆盖关系。 **新员工 onboarding**： - 按 PRD 顺序读，每读一节就打开对应的原型 / 文档 / tech-flow。 **Audit**： - 每月跑一遍这张表，看 🟡 / 🔴 有没有变化，新增内容是否更新到表里。 - 把"灰色地带"列里被解决的项移到上方表里。 - `bin/docs-prototype-alignment-check.sh` 会自动验证：(1) PRD 23 章是否都在表里；(2) 每行的 endpoints / events / tech-flow 引用是否真实存在；(3) 本文 `last-updated` 是否落后于 PRD git mtime 超过 14 天。 --- *这是一份 living 文档。改 PRD / 改原型时，请同步更新这里。最后更新：2026-05-17。*