120 lines
4.3 KiB
Markdown
120 lines
4.3 KiB
Markdown
---
|
||
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` |
|