# 杜康好客 · V3.0 PRD

> **v3.0**（2026-07-10）· 产品事实源 · 冲突时 **V3 > V2**  
> 实现：[`v3编码手册`](./杜康好客-v3编码手册.md) · 审计：[`v3-现状对照`](./杜康好客-v3-现状对照.md)

## 0. 说明

| 项 | 内容 |
|----|------|
| 四端 | C 小程序 · 门店/合伙人 H5 · 总部 **WebAdmin**（工程口径，非 H5） |
| 试点 | 郑州 · 同城小飞侠 · 跨城总部物流到付 |
| 工程差异 | C 端现 `mini-user`/h5-user；核销 TTL **3min**；订单 Tab **三态** |

### 版本变更索引

| 版 | 日期 | 要点 | 开发文档 |
|----|------|------|----------|
| 3.4.10 | 08-03 | 门店套餐 | [`门店套餐`](./杜康好客-门店套餐功能开发文档-v3.4.10.md) |
| 3.4.11 | 08-04 | 开发计划 + 企微机器人/消息推送 | [`开发计划`](./杜康好客-开发计划功能开发文档-v3.4.11.md) |
| 3.4.12 | 08-04 | 退款回滚/财务/批量任务·工单/套餐 imageUrl | [`v3.4.12`](./杜康好客-v3.4.12-工单迭代开发文档.md) |
| 3.4.13 | 08-05 | metrics/核销详情/版本联动 PUBLISHED/mini 体验/H5 OAuth | [`v3.4.13`](./杜康好客-v3.4.13-体验优化开发文档.md) |
| 3.4.14 | 08-06 | mini-user 门头/套餐详情；小程序可配置；**统一测试白名单（限测可见+Mock旁路；测试流水计入结算）** | [`v3.4.14`](./杜康好客-v3.4.14-mini-user门店体验开发文档.md) |
| 3.4.15 | 08-07 | mini-user 门店列表卡片；HQ 门店照片替换/删除；套餐多图上限 20 | [`v3.4.15`](./杜康好客-v3.4.15-mini-user门店列表优化.md) |
| 3.4.16 | 08-09 | 联系电话分离；取消自动 ST；套餐 UI；合伙人列表/入驻客服门槛；HQ 门店列表表格 | [`v3.4.16`](./杜康好客-v3.4.16-门店联系电话与体验优化.md) |
| 3.5.3 | 08-20 | 门店照片/企微审核/分享；核销金额序列化与提现补建；测试流水计结算；核销浮动提示；权益金额门店图标 | [`v3.5.3`](./杜康好客-v3.5.3-开发文档.md) |

---

## 1. 背景与目标

**模型**：总部供酒 → 合伙人拓店 → 门店核销 1:1 好客权益（酒+餐）。

| 锚点 | 值 |
|------|-----|
| 酒水成本 | ~售价 3 折 |
| 门店结算 | 核销额 × **60%** |
| 合伙人佣金池 | 订单+核销 ≤ 订单额 **5%**（默认 **0%+3%**） |
| 权益 | 实付 **1:1**，永久；口径 `benefit_amount ?? price` |

**G1~G5**：四端闭环 · 购酒履约 · 权益核销结算 · 合伙人拓店对账 · 售后/发票/代下单/推广/评价。

**门禁 S1~S4**：下单+权益(W1) · 核销(W1) · 拓店(W1) · 门店提现(W2)。

---

## 2. 角色与场景

| 角色 | 端 | 诉求 |
|------|-----|------|
| C 用户 | 小程序 | 买酒、权益、核销、售后 |
| 门店/店员 | H5 | 核销、营业、提现(W2) |
| 合伙人 | H5 | 拓店、订单、账单 |
| 总部 | WebAdmin | 审核、结算、运营 |

**SC-01~09**：同城购酒 · 现场提货 · 跨城 · 核销 · 拓店 · 售后 · 代下单 · 问卷评价 · 推广归因（见 PRD 原文路径摘要）。

**权限**：合伙人平级隔离；推广员仅拓店+看自己店；手机号脱敏（门店/合伙人中间4位）。

---

## 3. 核心规则

### 3.1 五条闭环

购酒履约 · 权益核销(60%+核销佣金) · 拓店入驻 · 售后工单 · 结算提现(T+1 出账+未出账可提)。

### 3.2 订单

`待付款 → 已付款 → 已完成`；30min 未付取消。同城自动推小飞侠（有仓+API）；**≥10箱(60瓶)** 大单待 HQ 确认。跨城总部物流到付。现场提货支付即完成。

### 3.3 佣金与结算

| 类型 | 默认 | 释放 |
|------|------|------|
| 订单佣金 | 配置(0%) | 支付快照 |
| 核销佣金 | 配置(3%) | 核销时按门店归属合伙人 |
| 门店结算 | 60% | T+1；未出账可提现 |

**多合伙人**：全城/区域管辖；同城订单佣金按收货区县解析；核销佣金归拓店合伙人。  
**FIN-001~003**：白名单未出账提现 · 单店日限 ¥5000 · T+0 审完预警。  
合伙人 **T+30** 独立月账/打款。

### 3.4~3.8 Wave 能力

- **3.4** 门店一号多店、主账号、店员子账号(W2)
- **3.5** 拓店三步 + SOP + 试核销100
- **3.6** 工单四类型：仅退款/破损补发/破损退货/退货退款
- **3.7** 多仓、承运商、物流月结对账（小飞侠：2瓶6元 +2/瓶，6瓶箱14元）
- **3.8** 弱网5次拍照兜底(W3)

### 3.9~3.11 增量（详开发文档）

| § | 主题 | 文档 |
|---|------|------|
| 3.9 | 门店套餐 ≤10 条、独立审核 | v3.4.10 |
| 3.10 | 开发计划/任务/版本/技术支持联动 | v3.4.11 |
| 3.11 | 企微智能机器人 + 消息推送 Webhook | v3.4.11 |
| 3.12 | **登录手机号 ≠ 对外联系电话**；体验优化 | v3.4.16 |

### 3.12 门店登录号与体验增量（v3.4.16）

| 字段 | 含义 | 用途 |
|------|------|------|
| `phone` / 门店登录手机号 | 老板主账号 | 门店端短信登录；`StoreAccount.phone` |
| `contactPhone` / 联系电话 | 店长等对外号码 | C 端门店详情拨号与展示 |

- 合伙人拓店入驻、门店资料修改均须采集 **联系电话**（可与登录号不同）。
- 未填联系电话时，对外展示回退登录手机号（兼容旧数据）。
- **不**再因客户端 `validation_error` 自动创建技术支持工单。
- 合伙人入驻提交前须展示 HQ 可配企微客服二维码，并确认已添加客服。
- HQ 门店列表：长店名截断、操作列右固定、表过宽可横向滚动。
- 详 [`v3.4.16`](./杜康好客-v3.4.16-门店联系电话与体验优化.md)。

---

## 4. REQ 索引

> 完整 REQ：`.cursor/skills/dukang-v3/reference-req-index.md`

| 端 | ID 范围 | 模块要点 |
|----|---------|----------|
| 用户 | U-001~027 | 四Tab/支付/权益3min/门店/套餐/工单/发票/推广/评价 |
| 门店 | S-001~021 | 核销双通道/记录×60%/提现/子账号/套餐提审 |
| 合伙人 | P-001~027 | 子账号/拓店+套餐/订单账单/代下单(W3) |
| 总部 | H-001~028 | 开城/审核/结算/推广/套餐/开发计划 |

**SKU 锚价**：128/168/298/498（瓶）· 768/1008/1788/2988（箱6瓶）。

---

## 5. 非功能 NFR-001~010

7天免登 · 微信单支付 · 验证码3min · 脱敏鉴权 · 幂等 · 弱网/兜底 · 兼容 · 审计 · 24h履约 · 推广归因落库。

---

## 6. 数据与集成

**实体**：用户/商品/订单(佣金快照)/权益/门店/套餐/核销/工单/结算/合伙人/推广/仓(W3)/待处理核销(W3)。

| TECH | 系统 |
|------|------|
| 011~012 | 微信支付/短信 |
| 013 | 小飞侠 |
| 014~016 | 微信能力/分享/腾讯位置 |

**金额**：权益=实付1:1 · 门店结算=核销×60% · 试核销=**100元** · 码TTL=**3min**。

---

## 7~8. UI 与 ACC

主色杜康红 `#8B1E1E` · 权益金 `#C4A35A` · 空态人话+下一步。  
ACC 全量：`.cursor/skills/dukang-v3/reference-acc.md`

---

## 9. 三波交付

| 波 | 日期 | 门禁 | 含 | 不含 |
|----|------|------|-----|------|
| W1 | 7.10 | S1~S4 | 登录商品支付核销拓店子账号 | 提现推广现场跨城工单发票 |
| W2 | 7.15 | S1~S5 | 提现FIN推广现场门店子账号多合伙 | 代下单弱网多仓跨城发票问卷 |
| W3 | 7.22 | 全量 | 代下单弱网多仓跨城工单发票看板 | — |

DLV 任务卡：`.cursor/skills/dukang-task-card/`