---
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) | **唯一需求事实源** |
| 2 | [`杜康好客-v3-现状对照.md`](../../../杜康好客-v3-现状对照.md) | 已完成/冲突/缺口 |
| 3 | [`杜康好客-v3编码手册.md`](../../../杜康好客-v3编码手册.md) | 实现验收、分工 |
| 4 | [reference-waves.md](reference-waves.md) | Wave 门禁与 DLV 映射 |
| 5 | [reference-req-index.md](reference-req-index.md) | REQ-U/S/P/H 全表 |
| 6 | [reference-acc.md](reference-acc.md) | ACC 验收条件 |
| 7 | `pages/{user,shop,partner,hq}/` | UI 参照 |

> V2 / preV1 手册**不再作为需求依据**。

## 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` |