v3.0版本skills和agent

2026-07-11 11:59:57 +08:00
parent 420f1b66c3
commit 69d27c80be
15 changed files with 1236 additions and 42 deletions
@@ -39,14 +39,14 @@ Inject exported Services only:

 - `X-Client-App: USER_H5`
 - Mock pay via `integrations/pay`; real benefit grant on pay success
- Order tabs: all | pending_pay | pending_ship | pending_receive | completed
+- Order tabs (V3.0 PRD): 待付款 | 已付款 | 已完成

 ## Session start

-1. Read task card if given → `dukang-task-card` skill
+1. Read task card if given → `dukang-task-card` skill；V3.0 → `@dukang-v3` + `杜康好客-v3-PRD.md`
 2. Confirm changes stay in Owner A paths
 3. UI: `pages/user/` + `pages/ROUTE_MAP.md`
-4. API/DB: V2 manual §五/§六
+4. API/DB: v3-PRD §6 + V2 手册 §五/§六

 ## Before finishing

@@ -24,11 +24,10 @@ You are **Owner C** on the Dukang Haoke monorepo — **human owner: jacy-dukang
 | `apps/h5-user`, `modules/{iam,trade,benefit,analytics}` | jacy-dukang |
 | `callbacks/`, `jobs/`, `integrations/` | Lead |

-## preV1 scope note
+## preV1 / V3.0 scope note

- admin-web replaces HQ **mini program** for dev/demo only
- Many HQ features are **Seed-fixed** in preV1 (cities, 4 SKUs)
- Do not assume admin-web UI matches `pages/hq/` 1:1 — V2 will use Taro mini-hq
+- admin-web replaces HQ **H5** for dev/demo; V3.0 PRD targets 总部 H5 feature parity
+- V3.0 delivery waves: see `@dukang-v3` and `v3-delivery-lead` agent

 ## Module rules

@@ -38,9 +37,10 @@ You are **Owner C** on the Dukang Haoke monorepo — **human owner: jacy-dukang

 ## Session start

-1. Check preV1 §6 for what's Seed vs implemented UI
-2. Product/city rules: V2 manual §二 §6
-3. Settlement: T+1 store / T+30 partner (M5+)
+1. V3.0 rules: `杜康好客-v3-PRD.md` §3.3 结算/佣金；Wave 2+ for 提现
+2. Check preV1 §6 for what's Seed vs implemented UI
+3. Product/city rules: v3-PRD + V2 manual §二 §6
+4. Settlement: T+1 store / T+30 partner；FIN-001~003 in Wave 2

 ## Before finishing

@@ -0,0 +1,85 @@
+---
+name: v3-delivery-lead
+description: >-
+  Dukang Haoke V3.0 delivery lead (负责人 jacy-dukang). Orchestrates Wave 1/2/3
+  gates, DLV milestones, REQ/ACC traceability, and cross-owner coordination. Use
+  when planning V3.0 scope, splitting DLV tasks, wave acceptance, or resolving
+  PRD vs codebase gaps — pair with @dukang-v3 skill.
+model: inherit
+---
+
+You are **V3.0 Delivery Lead** on the Dukang Haoke monorepo — **human owner: jacy-dukang (`jacy-dukang`)**.
+
+## Mission
+
+Drive **G1–G5** delivery through three waves (7.10 → 7.15 → 7.22) per [`杜康好客-v3-PRD.md`](../../杜康好客-v3-PRD.md). You do not override product rules; you sequence work, trace REQ/ACC IDs, and delegate implementation to Owner agents.
+
+## Session start (always)
+
+1. Read `@dukang-v3` skill → confirm **current Wave** (W1 / W2 / W3)
+2. Check [reference-waves.md](../skills/dukang-v3/reference-waves.md) for in/out of scope
+3. Map task to **DLV-W{n}-M{m}** + **REQ-*** + **ACC-***
+4. Assign Owner:
+
+| Domain | Agent | 人 |
+|--------|-------|-----|
+| C 端 / trade / benefit | `owner-a-user-trade` | jacy-dukang |
+| 总部 / catalog / settlement / ops | `owner-c-catalog-ops` | jacy-dukang |
+| 合伙人 / store 拓店 | `owner-b-partner-store` | 刘景尧 |
+| 门店 / redeem 核销 | `owner-d-shop-redeem` | 刘景尧 |
+| packages / integrations / Prisma | `backend-lead` | jacy-dukang |
+
+## Wave gate discipline
+
+**Never** mark a later Wave feature as done while earlier gates fail.
+
+| Wave | Must pass before next |
+|------|----------------------|
+| W1 | W1-S1~S4 (下单、核销、拓店、合伙人子账号) |
+| W2 | W2-S1~S5 (+ 提现、推广码、现场提货、门店子账号、多合伙人) |
+| W3 | G1–G5 + OPT-001~012 + ACC 全量 |
+
+Wave 1~2 gaps use **operational SOP** (人工补核销、人工代下单) — document in handoff, do not hack into code as permanent shortcuts.
+
+## PRD vs codebase gaps (know these)
+
+| PRD v3.0 | Code today | Lead decision |
+|----------|------------|---------------|
+| 微信小程序 C 端 | `apps/h5-user` | Track as migration; API contract first |
+| 总部 H5 | `apps/admin-web` | Feature parity in admin-web until HQ H5 |
+| 核销码 3 min | May be 5 min in old docs | Align to PRD 3 min |
+| 订单三 Tab | preV1 五 Tab | Align to 待付款/已付款/已完成 |
+
+## Cross-owner coordination
+
+- Prisma touching `store_*` / redeem → notify **刘景尧** before merge
+- Commission / settlement snapshots → `settlement` + `trade` via exported Services only
+- New enums/DTOs → `packages/shared-types` (Lead reviews breaking changes)
+
+## Output format (planning / handoff)
+
+```markdown
+## V3.0 交付 · {DLV-Wx-Mx}
+
+**Wave / 门禁**：W{x}-S{y}
+**REQ**：REQ-...
+**ACC**：ACC-...
+**Owner 分工**：（谁做什么）
+**依赖/阻塞**：（外部对接、前置 Wave、对方 Owner）
+**验收步骤**：（可演示清单）
+**风险**：R1~R8 相关项
+```
+
+## Before closing a milestone
+
+- [ ] All ACC items for this DLV demonstrable or scripted
+- [ ] No business rules invented beyond v3-PRD
+- [ ] `node scripts/smoke-v3.mjs` extended if main path touched
+- [ ] v3-PRD / v3编码手册 synced if rules changed
+- [ ] Cross-module: `boundary-reviewer` if touching 2+ OWNER modules
+
+## Forbidden
+
+- Implementing store/redeem UI in Owner A paths
+- Skipping Wave gates to "finish faster"
+- Changing business rules in code without updating `杜康好客-v3-PRD.md`
@@ -0,0 +1,60 @@
+---
+name: v3-req-reviewer
+description: >-
+  Read-only V3.0 PRD reviewer for 杜康好客. Compares requirements (REQ/ACC/Wave)
+  against code, prototypes, and coding manuals; flags gaps and conflicts. Use before
+  implementation or PR when user asks for requirement review — does not write code.
+model: inherit
+readonly: true
+---
+
+You are a **read-only V3.0 Requirements Reviewer** for Dukang Haoke.
+
+## Scope
+
+Review only — **do not edit code or change business rules**. Produce structured gap analysis.
+
+## Sources (read in order)
+
+1. [`杜康好客-v3-PRD.md`](../../杜康好客-v3-PRD.md) — V3.0 fact source
+2. `@dukang-v3` skill references (waves, REQ, ACC)
+3. [`杜康好客-v3编码手册.md`](../../杜康好客-v3编码手册.md) — implementation/acceptance
+4. `pages/{user,shop,partner,hq}/` — UI reference
+5. Target code paths per OWNER (read-only grep/read)
+
+## Review dimensions
+
+| 维度 | 检查 |
+|------|------|
+| Wave 范围 | 功能是否属于当前 Wave in-scope |
+| REQ 覆盖 | 每条 REQ 是否有 UI/API/数据支撑 |
+| ACC 可验 | 验收条件是否可演示或脚本化 |
+| 规则一致 | PRD vs 编码手册 vs 代码常量 |
+| 边界 | 是否跨 OWNER 直写 Prisma |
+| 外部依赖 | 小飞侠/微信/短信/腾讯位置是否就绪 |
+
+## Conflict priority
+
+`杜康好客-v3-PRD.md` > `杜康好客-v3编码手册.md` > V2 手册 > preV1
+
+## Output format
+
+```markdown
+## V3.0 需求审查 · {范围}
+
+**Wave**：W{n} · **REQ/ACC**：...
+### 已满足
+- ...
+### 缺口（按优先级）
+| 项 | REQ/ACC | 现状 | 建议 Owner |
+### 冲突
+| 规则 | PRD | 代码/手册 | 建议 |
+### 阻塞外部依赖
+- ...
+### 建议下一步 DLV
+- DLV-Wx-Mx：...
+```
+
+## Escalation
+
+Implementation conflicts → delegate to `v3-delivery-lead` or specific Owner agent.
@@ -16,11 +16,13 @@ alwaysApply: true

 ## 文档

- 业务事实源：`杜康好客-V2编码手册.md`
+- **V3.0 业务事实源**：`杜康好客-v3-PRD.md`
+- V3 实现验收：`杜康好客-v3编码手册.md`
+- V2 蓝图：`杜康好客-V2编码手册.md`（与 V3 冲突时 V3 PRD 优先）
 - preV1 裁剪：`杜康好客-preV1编码手册.md`
 - 协作：`conventions.md` · AI 入口：`AGENTS.md`

-**禁止**：编码时修改业务规则；需求变更只改 V2 手册。
+**禁止**：编码时修改业务规则；需求变更只改 `杜康好客-v3-PRD.md`。

 ## 边界（2 人团队）

@@ -41,8 +43,8 @@ alwaysApply: true
 ## 核心业务常量

 - 权益额 = `benefit_amount ?? price`
- 核销：直接核销 `0 < amount ≤ 全部 ACTIVE 权益总余额`；带单据核销 `0 < amount ≤ 该单据可用金额`
- 订单 Tab：`all | pending_pay | pending_ship | pending_receive | completed`
+- 核销：直接核销 `0 < amount ≤ 全部 ACTIVE 权益总余额`；带单据核销 `0 < amount ≤ 该单据可用金额`；Redis 码 3 分钟
+- 订单 Tab（V3.0）：`待付款 | 已付款 | 已完成`
 - API：`/api/v1`，响应 `{ code, message, data }`

 ## 提交
@@ -20,13 +20,13 @@ disable-model-invocation: true

 ## 会话启动（按序）

-1. 确认阶段：preV1 → 读 `杜康好客-preV1编码手册.md`；V2 能力 → 读 V2 手册对应 §
+1. 确认阶段：**V3.0** → 读 `杜康好客-v3-PRD.md` + `@dukang-v3`；preV1 → preV1 手册；V2 蓝图 → V2 手册
 2. 读 [`AGENTS.md`](../../AGENTS.md) OWNER 表 → **只改本 OWNER 路径**
 3. 有任务卡 ID → 配合 `dukang-task-card` skill 或查 preV1 §9 / V2 §七
 4. UI 任务 → `pages/ROUTE_MAP.md` + 对应 `pages/{端}/` 原型
 5. 编码前过一遍下方 Checklist

-**需求变更** → 只改 V2 手册，编码时不改业务规则。
+**需求变更** → V3.0 只改 `杜康好客-v3-PRD.md`，编码时不改业务规则。

 ## 编码前 Checklist

@@ -76,7 +76,7 @@ await this.prisma.order.update({ ... });
 2. `src/lib/api.ts` 统一 fetch + `X-Client-App`
 3. 类型从 `@dukang/shared-types` import
 4. preV1 App：`h5-user` / `h5-shop` / `h5-partner` / `admin-web`
-5. C 端订单 Tab：`all | pending_pay | pending_ship | pending_receive | completed`
+5. C 端订单 Tab（V3.0）：`待付款 | 已付款 | 已完成`

 ## 数据库变更

@@ -22,17 +22,18 @@ disable-model-invocation: true

 | 优先级 | 文档 | 用途 |
 |--------|------|------|
-| 1 | `杜康好客-V2编码手册.md` §二 | **做什么**（业务规则、状态、边界） |
-| 2 | `conventions.md` | **怎么协作**（模块边界、提交） |
-| 3 | V2 手册 §四 | **怎么架构**（NestJS 模块） |
-| 4 | V2 手册 §五 | **表结构**（Prisma / SQL） |
-| 5 | V2 手册 §六 | **接口契约**（四端 JWT） |
+| 1 | `杜康好客-v3-PRD.md` | **V3.0 做什么**（本期交付事实源） |
+| 2 | `杜康好客-v3编码手册.md` | **V3 怎么验收**（闭环、分工） |
+| 3 | `@dukang-v3` skill | Wave / REQ / ACC 索引 |
+| 4 | `conventions.md` | **怎么协作**（模块边界、提交） |
+| 5 | V2 手册 §四 §五 §六 | 架构 / DB / API（与 V3 冲突时 V3 PRD 优先） |
 | 6 | `pages/{user,shop,partner,hq}/` | **UI 参照** |
-| 7 | `杜康好客-preV1编码手册.md` | preV1 联调范围 |
+| 7 | `杜康好客-preV1编码手册.md` | preV1 联调范围（历史） |

 ## 需求变更规则

- **只改** `杜康好客-V2编码手册.md` 作为业务事实源
+- **V3.0 交付**：只改 `杜康好客-v3-PRD.md` 作为业务事实源，同步 v3编码手册
+- **V2 蓝图**：改 `杜康好客-V2编码手册.md`（与 V3 冲突时 V3 PRD 优先）
 - 编码 Agent **不得**边写代码边改业务规则
 - 改 API/表结构 → 同步手册 §五/§六 + `packages/shared-types`

@@ -11,16 +11,17 @@ description: >-
 ## 原则

 - **一次只做一个任务卡**
- 任务卡 ID 命名空间：`P1-*`（preV1）与 `M*-*`（V2）并行，勿混用验收标准
- 需求变更只改 V2 手册，不在任务实现中私改业务规则
+- 任务卡 ID 命名空间：`DLV-W*-*`（V3.0）· `P1-*`（preV1）· `M*-*`（V2）；勿混用验收标准
+- 需求变更只改 `杜康好客-v3-PRD.md`（V3.0），不在任务实现中私改业务规则

 ## 领取流程

 1. **解析 ID** → 确定里程碑与 OWNER
+   - `DLV-W1-M2` → `@dukang-v3` + [reference-waves.md](../dukang-v3/reference-waves.md)
   - `P1-M2-002` → preV1 §9 + OWNER 见卡片内容
   - `M2-BE-TRD-002` → V2 §七 附录 A
-2. **读验收标准** → 手册中该 ID 的「验收」列
-3. **读依赖** → PRD §、API 路径、DB 表、原型路径
+2. **读验收标准** → ACC-ID（V3）或手册中该 ID 的「验收」列
+3. **读依赖** → REQ-ID、API 路径、DB 表、原型路径
 4. **确认边界** → 只改 [`AGENTS.md`](../../AGENTS.md) OWNER 表内路径
 5. **实现** → 配合 `dukang-coding` skill
 6. **自验 DoD** → 下方清单
@@ -65,9 +66,17 @@ description: >-
 - [ ] pnpm lint 无新增错误
 ```

-## 里程碑顺序
+## V3.0 DLV 顺序（当前交付）

-**preV1**：P1-M0 → P1-M1 → P1-M2 → P1-M3 → P1-M4 → P1-M5 → P1-M6
+**Wave 1**：DLV-W1-M1 → M2 → M3 → M4（门禁 W1-S1~S4）
+
+**Wave 2**：DLV-W2-M1 → M2 → M3 → M4（门禁 W2-S1~S5）
+
+**Wave 3**：DLV-W3-M1 → M2 → M3 → M4 → M5（全量 ACC）
+
+## 历史里程碑
+
+**preV1**：P1-M0 → … → P1-M6

 **V2**：M0 → M1 → … → M6 → 上线

@@ -0,0 +1,117 @@
+---
+name: dukang-v3
+description: >-
+  Manages 杜康好客 V3.0 PRD (v3-PRD), three-wave delivery (W1/W2/W3), REQ/ACC
+  IDs, and requirements review. Use when implementing V3.0 features, reviewing
+  PRD v1.3 scope, planning Wave gates, or user @dukang-v3. Not for preV1 Mock
+  (use @dukang-prev1) or daily coding alone (pair with @dukang-coding).
+disable-model-invocation: true
+---
+
+# 杜康好客 · V3.0 需求 Skill
+
+## 何时启用
+
+- 读/改 V3.0 业务规则与交付范围
+- 评审需求、对照 PRD REQ-ID / ACC-ID
+- 规划或验收 Wave 1/2/3 门禁
+- 用户 @dukang-v3 或提到「v3.0 PRD」「三波交付」「W1-S1」
+
+**不用于**：preV1 Mock 联调（@dukang-prev1）、纯编码实现（@dukang-coding）
+
+## 文档阅读顺序
+
+| 优先级 | 文档 | 用途 |
+|--------|------|------|
+| 1 | [`杜康好客-v3-PRD.md`](../../../杜康好客-v3-PRD.md) | **做什么**（V3.0 业务事实源） |
+| 2 | [`杜康好客-v3编码手册.md`](../../../杜康好客-v3编码手册.md) | **怎么验收**（闭环、核销、分工） |
+| 3 | [reference-waves.md](reference-waves.md) | Wave 门禁与 DLV 映射 |
+| 4 | [reference-req-index.md](reference-req-index.md) | REQ-U/S/P/H 全表 |
+| 5 | [reference-acc.md](reference-acc.md) | ACC 验收条件 |
+| 6 | V2 手册 §四 §五 §六 | 架构 / DB / API（V3 冲突时 V3 PRD 优先） |
+| 7 | `pages/{user,shop,partner,hq}/` | UI 参照 |
+
+## V3.0 不可偏离常量
+
+```
+权益额 = 订单实付 1:1（永久）
+同城起购 2 瓶 / 跨城 1 箱(6瓶)
+门店结算 = 核销额 × 60%
+单合伙人：订单佣金 + 核销佣金 ≤ 5%（默认 0% + 3%）
+核销码 TTL = 3 分钟；试核销固定 ¥100
+订单 Tab：待付款 | 已付款 | 已完成
+C 端门店仅 status=OPEN 且审核通过
+```
+
+## 三波交付（严格顺序）
+
+```
+Wave 1 (7.10) → Wave 2 (7.15) → Wave 3 (7.22)
+```
+
+实现前**必须确认当前 Wave**；不得提前做后续 Wave 功能（除非用户明确要求）。
+
+| Wave | 门禁 | 一句话 |
+|------|------|--------|
+| W1 | W1-S1~S4 | 下单+核销+拓店+合伙人子账号 |
+| W2 | W2-S1~S5 | 提现+推广码+现场提货+门店子账号+多合伙人 |
+| W3 | 全量 G1~G5 | 代下单+弱网+多仓+跨城+工单+发票+增长 |
+
+详情：[reference-waves.md](reference-waves.md)
+
+## 需求变更规则
+
+- **只改** `杜康好客-v3-PRD.md` 作为 V3.0 业务事实源
+- 同步 `杜康好客-v3编码手册.md` + `packages/shared-types` + `packages/domain`
+- V2/preV1 与 V3.0 冲突时 **V3.0 PRD 优先**
+- 编码 Agent 不得边写代码边改业务规则
+
+## 原型 → 模块映射
+
+| 端 | PRD 形态 | 当前代码 | 后端 Module |
+|----|----------|----------|-------------|
+| C 端 | 微信小程序 | `apps/h5-user`（过渡） | iam, catalog, trade, benefit |
+| 门店 | H5 | `apps/h5-shop` | iam, redeem, store |
+| 合伙人 | H5 | `apps/h5-partner` | iam, store, trade, settlement |
+| 总部 | H5 | `apps/admin-web`（过渡） | catalog, store, trade, settlement, ops |
+
+## 任务卡命名（V3.0）
+
+- **DLV-W{n}-M{m}**：阶段交付（如 `DLV-W1-M2`）
+- **REQ-{U|S|P|H}-{nnn}**：功能需求 ID
+- **ACC-{nnn}** / **ACC-P{nn}** / **ACC-W{nn}**：验收 ID
+- preV1 `P1-*` 与 V2 `M*-*` 为历史命名，V3.0 新任务以 DLV/REQ/ACC 为准
+
+领取 DLV 任务时配合 `@dukang-coding` + 对应 Owner agent。
+
+## 团队 OWNER（2 人）
+
+| 负责人 | 前端 | 后端 Module |
+|--------|------|-------------|
+| jacy-dukang | h5-user/mini-user, admin-web | iam, trade, benefit, catalog, settlement, ops, analytics |
+| 刘景尧 | h5-shop, h5-partner | store, redeem |
+
+## 需求评审输出格式
+
+```markdown
+## V3.0 需求评审 · {主题}
+
+**关联**：REQ-xxx / ACC-xxx / Wave N
+**影响模块**：（NestJS module + app）
+**Owner**：jacy-dukang | 刘景尧 | 双方
+**与现状差异**：（代码/手册冲突点）
+**建议任务**：DLV-Wx-Mx
+**阻塞/依赖**：（外部对接、前置 Wave）
+```
+
+## 子 Agent 选用
+
+| 场景 | Agent |
+|------|-------|
+| V3 波次统筹、跨 Wave 排期 | `v3-delivery-lead` |
+| C 端下单/权益/支付 | `owner-a-user-trade` |
+| 总部开城/结算/运营 | `owner-c-catalog-ops` |
+| 合伙人拓店 | `owner-b-partner-store` |
+| 门店核销 | `owner-d-shop-redeem` |
+| packages/integrations/Prisma | `backend-lead` |
+| PR 边界审查 | `boundary-reviewer` |
@@ -0,0 +1,72 @@
+# V3.0 ACC 验收标准索引
+
+> 事实源：[`杜康好客-v3-PRD.md`](../../../杜康好客-v3-PRD.md) §8
+
+## 交易与履约
+
+| ACC | 关联 | 验收条件 |
+|-----|------|----------|
+| ACC-001 | S1 | 访客可浏览；下单须登录；支付成功→权益 1:1 |
+| ACC-002 | 同城 | ≥2 瓶免运费；小飞侠；取送拍照；24h 自动完成 |
+| ACC-003 | 现场提货 | 隐藏入口；支付即完成；有码归码/无码归总部 |
+| ACC-004 | 跨城 | 未开通城市≥1箱；总部物流到付；佣金归总部 |
+| ACC-015 | 锁单 | 30 分钟取消；7 天免登 |
+
+## 核销与门店账号
+
+| ACC | 关联 | 验收条件 |
+|-----|------|----------|
+| ACC-005 | S2 | 扫码+手机号两通道；码/验证码 3 分钟；成功短信 |
+| ACC-006 | 多店子账号 | W2：一号多店；主账号唯一；店员权限隔离 |
+| ACC-006a | 门店登录 | 单店直达；多店含角色；记住所选 |
+| ACC-017 | 弱网 | W1~2 重试+人工；W3 5次拍照兜底；不重复扣款 |
+| ACC-017a | 弱网 SLA | W3：总部 T+0 处理；超时预警 |
+
+## 拓店与 SOP
+
+| ACC | 关联 | 验收条件 |
+|-----|------|----------|
+| ACC-007 | S3 | 合伙人三步提交；总部审；C 端营业中可见 |
+| ACC-019 | SOP | 筛选字段；附件一一致；试核销100；负责人复核；合同同日 |
+| ACC-020 | 结算细则 | T+1 顺延；异议3日；店内公示；签约主体 |
+
+## 资金与佣金
+
+| ACC | 关联 | 验收条件 |
+|-----|------|----------|
+| ACC-008 | S4 | 未出账可提；总部打款；FIN 护栏；T+0 审 |
+| ACC-009 | 佣金 | 默认 0%+3%；门店结算×60%；§4.3 归属 |
+| ACC-P21 | 多合伙人 | 区域区县互斥；全城唯一 |
+| ACC-P22 | 佣金配置 | 独立配置；≤5%；快照 |
+| ACC-P23 | 订单佣金 | 同城区县解析；余量归总部/全城 |
+| ACC-P24 | 核销佣金 | 归门店归属合伙人；变更不溯及 |
+| ACC-P25 | 独立账单 | T+30 独立确认打款 |
+| ACC-P26 | 数据隔离 | 仅本管辖；推广员仅自己的店 |
+| ACC-P27 | 推广码 | 绑定合伙人；现场有码归码 |
+| ACC-P28 | 审计 | 管辖/比例/归属变更留痕 |
+
+## 售后与增长
+
+| ACC | 关联 | 验收条件 |
+|-----|------|----------|
+| ACC-010 | 工单 | 四类型；总部决策；补发/退款流转 |
+| ACC-011 | 发票 | 四组合申请；2 工作日回传；可下载 |
+| ACC-012 | 代下单 | W3：手机号建用户；权益自动发 |
+| ACC-013 | 问卷评价 | 成交问卷无激励；核销评价；总部可看 |
+| ACC-014 | 推广分享 | 推广码归因；商品分享带渠道 |
+| ACC-018 | 话术 | OPT-012 3 日内对齐 |
+| ACC-021 | 热力图 | 腾讯位置服务按城市 |
+
+## 多仓（Wave 3）
+
+| ACC | 关联 | 验收条件 |
+|-----|------|----------|
+| ACC-W01 | 多仓 | 同城多仓；启停 |
+| ACC-W02 | 仓-合伙人 | 一仓一合伙人；未关联总部直管 |
+| ACC-W03 | 管仓协同 | 管仓合伙人只读仓+工单协同 |
+
+## UI 与隐私
+
+| ACC | 关联 | 验收条件 |
+|-----|------|----------|
+| ACC-016 | UI/隐私 | §8 规范；按角色脱敏 |
@@ -0,0 +1,124 @@
+# V3.0 REQ 需求索引
+
+> 事实源：产品 PRD v1.3 → [`杜康好客-v3-PRD.md`](../../../杜康好客-v3-PRD.md)
+
+## 用户端 REQ-U
+
+| ID | 模块 | 结论摘要 |
+|----|------|----------|
+| REQ-U-001 | 导航 | 首页/门店/好客权益/个人中心 |
+| REQ-U-002 | 登录 | 无感登录；下单强制手机号；微信/短信；7 天免登 |
+| REQ-U-003 | 支付 | 仅微信支付 |
+| REQ-U-004 | 定位 | 右上角市区；默认 IP；可授权精确定位 |
+| REQ-U-005 | 首页商品 | 4 款酒祖杜康；大图、标题加粗、价格标红、权益金额 |
+| REQ-U-006 | 商品详情 | 规格瓶/箱、度数、价格、权益、详情图 |
+| REQ-U-007 | 同城 | 小飞侠；≥2 瓶免运费；物流节点+拍照；24h 自动完成 |
+| REQ-U-008 | 现场提货 | 隐藏入口；支付即完成；强提示在现场 |
+| REQ-U-009 | 跨城 | 未开通城市；≥1 箱；总部物流到付 |
+| REQ-U-010 | 锁单 | 待付款 30 分钟取消 |
+| REQ-U-011 | 权益 | 支付成功 1:1 永久 |
+| REQ-U-012 | 客服 | 已付款起电话/微信客服 |
+| REQ-U-013 | 门店列表 | 营业中；搜索；省市区筛选；立即核销 |
+| REQ-U-014 | 门店详情 | 门头/电话/星级/地址/营业时间/规则/相册 |
+| REQ-U-015 | 核销页 | 剩余总额；输入金额；码 3 分钟有效 |
+| REQ-U-016 | 规则弹窗 | 核销前展示（OPT-011） |
+| REQ-U-017 | 评价 | 核销后引导门店评价 |
+| REQ-U-018 | 权益页 | 待使用总额；Tab 待使用/已使用；明细 |
+| REQ-U-019 | 个人中心 | 手机号、权益总额、订单入口 |
+| REQ-U-020 | 订单 | 待付款/已付款/已完成；物流时间线 |
+| REQ-U-021 | 发票 | 四组合；总部 2 工作日回传（OPT-001） |
+| REQ-U-022 | 工单 | 四类型；客服引导建单 |
+| REQ-U-023 | 问卷 | 支付成功引导；无激励（OPT-004） |
+| REQ-U-024 | 推广码 | 扫码归因；现场提货有码归码 |
+| REQ-U-025 | 分享 | 微信商品分享+渠道参数 |
+| REQ-U-026 | 门店规则 | 附件一完整展示 |
+
+## 门店端 REQ-S
+
+| ID | 模块 | 结论摘要 |
+|----|------|----------|
+| REQ-S-001 | 导航 | 首页/核销记录/门店信息 |
+| REQ-S-002 | 登录 | 主账号/店员；§4.6 流程；7 天免登 |
+| REQ-S-003 | 多店 | 一号多店选店（Wave 2） |
+| REQ-S-004 | 扫码核销 | 大按钮；确认即成功 |
+| REQ-S-005 | 手机号核销 | 查余额→用户验证码→确认 |
+| REQ-S-006 | 短信 | 核销中/成功文案 |
+| REQ-S-007 | 今日汇总 | 首页今日核销总金额 |
+| REQ-S-008 | 弱网 | W1~2 重试；W3 §4.8 |
+| REQ-S-008a | 弱网弹窗 | W3 拍照兜底文案 |
+| REQ-S-009 | 核销记录 | 筛今日/7日/1月/全部；到账×60% |
+| REQ-S-010 | 门店信息 | 营业状态；结算入口；切换门店 |
+| REQ-S-011 | 结算信息 | T+1；核销额/结算额/状态 |
+| REQ-S-012 | 提现 | 未出账可提（Wave 2）；FIN 护栏 |
+| REQ-S-013 | 提现记录 | 待审/已打款/驳回 |
+| REQ-S-014 | 结算异议 | 3 工作日 |
+| REQ-S-015 | 店内公示 | 模板下载 |
+| REQ-S-016 | 提现护栏 | 白名单/单日上限提示 |
+| REQ-S-017 | 子账号 | 创建/停用店员（Wave 2） |
+| REQ-S-018 | 权限 | §4.6 矩阵 |
+| REQ-S-019 | 多店选店 | 记住上次所选 |
+| REQ-S-020 | 待处理核销 | Wave 3 弱网单 |
+
+## 合伙人端 REQ-P
+
+| ID | 模块 | 结论摘要 |
+|----|------|----------|
+| REQ-P-001 | 导航 | 首页/门店管理/合伙人中心 |
+| REQ-P-002 | 登录 | 7 天免登 |
+| REQ-P-003 | 推广员 | 菜单裁剪；仅本管辖范围 |
+| REQ-P-004 | 管理员 | 完整能力 |
+| REQ-P-005 | 子账号 | 管理员·推广员 |
+| REQ-P-006 | 门店管理 | 筛审核/营业/区县/创建人 |
+| REQ-P-007 | 列表字段 | 名称/地址/状态/录入 |
+| REQ-P-008 | 一号多店 | 创建时二次确认 |
+| REQ-P-009 | 创建三步 | 基础/证照+附件一/结算 |
+| REQ-P-010 | 编辑规则 | 待审可改；通过后改资料再审 |
+| REQ-P-011 | 试核销 | 100 元激活（OPT-009） |
+| REQ-P-012 | 入驻短信 | OPT-008 |
+| REQ-P-013 | 首页数据 | GMV/核销/订单三卡 |
+| REQ-P-014 | 功能区 | 子账号/订单/权益/工单/代下单 |
+| REQ-P-015 | 排行 | 核销/订单 Top10 |
+| REQ-P-016 | 订单管理 | 筛时间状态 |
+| REQ-P-017 | 订单详情 | 佣金快照下钻 |
+| REQ-P-018 | 好客权益 | 送出/已核销/待核销 |
+| REQ-P-019 | 工单 | 只读 |
+| REQ-P-020 | 财务对账 | 本合伙人月账 |
+| REQ-P-021 | 代下单 | Wave 3 |
+| REQ-P-022 | 筛选校验 | 不达标标黄 |
+| REQ-P-023 | 附件一 | 结构化录入 |
+| REQ-P-024 | 负责人复核 | 待复核→待总部审 |
+| REQ-P-025 | 合同同日 | 同日提交校验 |
+| REQ-P-026 | 我的仓库 | Wave 3 管仓只读 |
+
+## 总部端 REQ-H
+
+| ID | 模块 | 结论摘要 |
+|----|------|----------|
+| REQ-H-001 | 登录 | 权限账户；7 天免登 |
+| REQ-H-002 | 商品 | 增删改；上下架排序 |
+| REQ-H-003 | 营销 | 1:1 权益永久 |
+| REQ-H-004 | 开通城市 | 省/市/配送/是否开通 |
+| REQ-H-004a | 创建合伙人 | 全城/区域+佣金；W3 管仓 |
+| REQ-H-004b | 仓库 | Wave 3 多仓 |
+| REQ-H-005 | 门店管理 | +归属合伙人筛选 |
+| REQ-H-006 | 门店审核 | 通过/失败；改归属 |
+| REQ-H-007 | 管辖佣金 | 区县全覆盖校验 |
+| REQ-H-008 | 订单 | 全量+佣金快照 |
+| REQ-H-009 | 权益 | 全量+合伙人筛 |
+| REQ-H-010 | 工单 | 同意/拒绝+备注+日志 |
+| REQ-H-011 | 发票 | 2 工作日；上传回传 |
+| REQ-H-012 | 代下单 | 同合伙人 |
+| REQ-H-013 | 结算 | 门店+合伙人双 Tab |
+| REQ-H-014 | 提现审 | T+0；FIN-003 |
+| REQ-H-014a | 白名单 | FIN-001/002 |
+| REQ-H-015 | 合伙人账单 | 待确认/待打款 |
+| REQ-H-016 | 报表 | 城市/合伙人/区县+热力图 |
+| REQ-H-017 | 推广码 | 绑定合伙人+统计 |
+| REQ-H-018 | 问卷 | 回收看板 |
+| REQ-H-019 | 门店评价 | 查看数据 |
+| REQ-H-020 | 核销异常 | W1~2 人工；W3 列表 |
+| REQ-H-020a | 待处理核销审 | W3 补核销/驳回 |
+| REQ-H-021 | 话术 | OPT-012 |
+| REQ-H-022 | 签约主体 | 山西领势酒业 |
+| REQ-H-023 | 热力图 | 腾讯位置服务 |
+| REQ-H-024 | 结算异议 | 门店 3 日异议处理 |
@@ -0,0 +1,109 @@
+# V3.0 三波交付参考
+
+> 事实源：[`杜康好客-v3-PRD.md`](../../../杜康好客-v3-PRD.md) §9
+
+## Wave 1 — 核心交易 + 拓店（2026-07-10）
+
+### 门禁
+
+| 门禁 | 能力 | ACC |
+|------|------|-----|
+| W1-S1 | 用户下单支付，权益 1:1 到账 | ACC-001 |
+| W1-S2 | 门店核销（扫码 + 手机号） | ACC-005、OPT-007、OPT-011 |
+| W1-S3 | 合伙人子账号 | REQ-P-005 |
+| W1-S4 | 合伙人创建门店 → 总部审核 → C 端可见 | ACC-007、OPT-009、OPT-008 |
+
+### 纳入
+
+四端登录 7 天免登、商品、**同城**下单支付、小飞侠履约、出码/扫码/手机号核销、规则弹窗、合伙人子账号、门店三步录入、负责人复核、总部审核、试核销 100 元、登录短信。
+
+### 不含
+
+提现/打款、推广码、现场提货、代下单、弱网拍照、多合伙人、门店子账号、**跨城**、工单、发票。
+
+### DLV 拆分
+
+| ID | 内容 |
+|----|------|
+| DLV-W1-M1 | 四端登录、权限、UI Token、商品管理/展示 |
+| DLV-W1-M2 | 支付、锁单 30 分、同城小飞侠、权益 1:1 |
+| DLV-W1-M3 | 出码/扫码/手机号核销、规则弹窗 OPT-011 |
+| DLV-W1-M4 | 合伙人子账号、门店三步、负责人复核、审核、试核销 OPT-009、短信 OPT-008 |
+
+### Wave 1 弱网/代下单 SOP
+
+- 弱网：重试 + 总部人工补核销（OPT-006 完整版在 W3）
+- 代下单：运营人工 SOP（系统能力在 W3 OPT-002）
+
+---
+
+## Wave 2 — 资金 + 品鉴会 + 组织扩展（2026-07-15）
+
+### 门禁
+
+| 门禁 | 能力 | ACC |
+|------|------|-----|
+| W2-S1 | 未出账可手动提现 + FIN 护栏 | ACC-008、OPT-010、FIN-001~003 |
+| W2-S2 | 总部审核打款 | REQ-H-014 |
+| W2-S3 | 推广码 + 现场提货 | ACC-003/014、OPT-005 |
+| W2-S4 | 门店主子账号 + 一号多店选店 | REQ-S-017~019、ACC-006 |
+| W2-S5 | 多合伙人管辖/佣金/数据隔离 | ACC-P21~P28 |
+
+### 不含
+
+代下单、弱网 5 次拍照、一城多仓、跨城、工单、发票、问卷、热力图。
+
+### DLV 拆分
+
+| ID | 内容 |
+|----|------|
+| DLV-W2-M1 | T+1 出账、未出账提现 OPT-010 + FIN、总部审打款 |
+| DLV-W2-M2 | 现场提货 OPT-005、推广码 REQ-H-017 |
+| DLV-W2-M3 | 多合伙人 REQ-H-004a/007、区县互斥、佣金快照 |
+| DLV-W2-M4 | 门店子账号 REQ-S-017~019、多店选店 |
+
+---
+
+## Wave 3 — 旁路 + 弱网 + 本期全量（2026-07-22）
+
+### 门禁
+
+| 门禁 | 能力 | ACC |
+|------|------|-----|
+| W3-S1 | 代下单（总部/合伙人） | ACC-012、OPT-002 |
+| W3-S2 | 弱网 5 次拍照兜底 + 总部补核销 | ACC-017、OPT-006 |
+| W3-S3 | 一城多仓 + 合伙人管仓 | ACC-W01~W03 |
+| W3-S4 | 跨城、工单、发票、合伙人 T+30 对账、问卷/评价/热力图 | G5、OPT-001/003/004/012 |
+
+### 完成定义
+
+G1–G5 + OPT-001～012 + 门店签约 SOP S1–S12 全部勾选。
+
+### DLV 拆分
+
+| ID | 内容 |
+|----|------|
+| DLV-W3-M1 | 代下单 OPT-002 |
+| DLV-W3-M2 | 弱网 OPT-006 完整版 |
+| DLV-W3-M3 | 多仓、跨城、工单 OPT-003、发票 OPT-001 |
+| DLV-W3-M4 | 合伙人月账、问卷/评价/热力图、OPT-012 |
+| DLV-W3-M5 | ACC 全量回归 |
+
+---
+
+## OPT 波次对照
+
+| OPT | 名称 | 波次 |
+|-----|------|------|
+| OPT-001 | 发票 | W3 |
+| OPT-002 | 代下单 | W3 |
+| OPT-003 | 工单 | W3 |
+| OPT-004 | 问卷 | W3 |
+| OPT-005 | 现场提货 | W2 |
+| OPT-006 | 弱网兜底 | W3（W1~2 简化版） |
+| OPT-007 | 手机号核销 | W1 |
+| OPT-008 | 入驻成功短信 | W1 |
+| OPT-009 | 试核销 100 元 | W1 |
+| OPT-010 | 未出账提现 | W2 |
+| OPT-011 | 核销规则弹窗 | W1 |
+| OPT-012 | 话术对齐 | W3 |