# 杜康好客 · 业务知识库

> **非需求文档**（不改规则请改 PRD）。新人/运营/客服速查。  
> 事实源：[`v3-PRD`](./杜康好客-v3-PRD.md) · 验收：[`v3编码手册`](./杜康好客-v3编码手册.md)

## 1. 概述

**链路**：购酒 → 1:1 好客权益 → 门店核销（酒+餐）。

| 角色 | 端 | 职责 |
|------|-----|------|
| C 用户 | mini-user / h5-user | 买酒、权益、核销、售后 |
| 门店 | h5-shop | 扫码核销、营业、提现 |
| 合伙人 | h5-partner | 拓店、辖区订单/账单 |
| 总部 | admin-web | 开城、审核、结算、运营 |

**常量**：权益额=`benefit_amount??price` · 门店结算=核销×**60%** · 佣金池≤**5%**(默认0%+3%) · 核销码**3min** · 同城≥**2瓶** · 跨城≥**6瓶** · 签约主体：山西领势酒业。

---

## 2. C 端（mini-user）

- 四 Tab：首页/权益/门店/我的；微信登录+7天会话
- 下单：选城→商品→地址→起购校验→微信支付→权益1:1
- 权益：直接核销(≤总余额) / 单据核销(≤单据)；出码3分钟
- 门店：仅 OPEN；详情含套餐/电话(脱敏可拨打)/两段营业时间
- 订单 Tab：待付款/已付款/已完成；物流详情(签收照/拨号/ETA)
- 售后：客服入口；发票/四类型工单按 PRD Wave 进度
- 版本：`minClientVersion` 过低强制更新或退出

## 3. 门店端（h5-shop）

- 登录绑定门店；首页扫码核销(微信 JSSDK)
- 核销记录；今日汇总；到账金额×60%展示
- 营业状态开关；Mine 门店信息
- 套餐：列表编辑→提交 HQ 审核（v3.4.10）
- iOS 微信：OAuth 后自动续扫（v3.4.13）

## 4. 合伙人端（h5-partner）

- 管理员 vs 推广员菜单裁剪；子账号 CRUD
- 拓店：基本信息→照片→结算资质→(套餐)；一号多店确认
- 门店列表/详情/套餐提审；辖区订单；账单 T+30
- 暂停账号：发码前即拦截登录（v3.4.13）

## 5. HQ（admin-web）

| 菜单域 | 要点 |
|--------|------|
| 开城 | 城市、合伙人(全城/区域+佣金)、仓库 |
| 商品 | SKU、上下架、详情模板 |
| 门店 | 审核、套餐 Tab 直存/审核、合伙人列 |
| 交易 | 订单、权益券、核销记录、推广码+metrics |
| 财务 | 门店/合伙人/酒厂/物流账单；打款确认 |
| 工单 | 售后四类型 + 技术支持(ST) + 开发计划 |
| 系统 | 账号权限、客户端配置、企微机器人/消息推送 |
| 日志 | HQ/用户/门店/合伙人/企微 |

## 6. 商品与模板

HQ 创建商品：名称/价格/权益额/箱规/香型/城市上架；详情模板(JSON 块)；资源 OSS。

## 7. 活动 / 推广码

HQ 推广码：场景/合伙人绑定/上下线；touch 归因；metrics 四指标+事件日志(v3.4.13)。

## 8. 开城

创建城市 → 绑定主账号合伙人 → 配置佣金 → 上架商品 → 仓库(可选)。

## 9. 开店

合伙人三步录入 → (负责人复核) → HQ 审核 → (试核销100) → OPEN → C 端可见。

## 10. 订单

状态机三态；支付回调幂等；同城小飞侠/跨城 HQ 填单；现场提货即完成；大单≥10箱 HQ 确认。

## 11. 财务

- **门店**：核销→store_payout T+1；未出账可提现→HQ 审→打款
- **合伙人**：T+30 月账独立确认打款
- **酒厂**：T+3 账单(v3.4.12)
- **物流**：按承运商月结(小飞侠计价见 PRD §3.7.1)

## 12. 发票

用户申请 → HQ 2 工作日处理 → 回传（Wave 3 完整）

## 13. 工单

**售后**（用户）：仅退款/补发/退货等四类型 → HQ 审 → 仓/合伙人协同  
**技术支持**（内部 ST）：BUG/建议 → 审批 → 开发任务 → 版本发布 → 工单 PUBLISHED(v3.4.13)

## 14. 配送

小飞侠推单/回调；`POST /callbacks/courier/xfx/track`；签收→订单 COMPLETED。

## 15. 好客权益

支付成功发放；FIFO 扣减；流水 `common_event(BENEFIT_LEDGER)`；核销后评价。

## 16. 系统设置

HQ 账号/角色(`hq-permissions`) · 客户端 `minClientVersion` · 运营告警走企微消息推送(DB Webhook)。

## 17. 企业微信

| 能力 | 入口 |
|------|------|
| 智能机器人 | `/wecom/bots` 长连接指令 |
| 消息推送 | `/wecom/pushes` Webhook+eventKey |
| 日志 | `/logs/wecom-bots` |

eventKey：`alert.ops` · `support_ticket.created` · `dev_plan.task_dispatch` · 支付/核销/结算告警。

---

## 附录

**端职责矩阵** → PRD §4.5  
**文档索引**：PRD · 编码手册 · 现状对照 · v3.4.x 开发文档 · 埋点规范 · 城市日志架构  
**变更**：随 v3.4.x 版本文档更新，不在此重复 ST 明细。