jacy
46361ec713
Stop auto ST from validation_error; show package prices with right-aligned layout; partner store list status/filter and onboard CS QR gate; HQ store table truncation/fixed actions; expose CS config in wechat_mini settings; bind local servers for LAN. Co-authored-by: Cursor <cursoragent@cursor.com>
7.0 KiB
杜康好客 · V3.0 PRD
v3.0（2026-07-10）· 产品事实源 · 冲突时 V3 > V2
实现：v3编码手册· 审计：v3-现状对照
0. 说明
| 项 | 内容 |
|---|---|
| 四端 | C 小程序 · 门店/合伙人 H5 · 总部 WebAdmin（工程口径，非 H5） |
| 试点 | 郑州 · 同城小飞侠 · 跨城总部物流到付 |
| 工程差异 | C 端现 mini-user/h5-user；核销 TTL 3min；订单 Tab 三态 |
版本变更索引
| 版 | 日期 | 要点 | 开发文档 |
|---|---|---|---|
| 3.4.10 | 08-03 | 门店套餐 | 门店套餐 |
| 3.4.11 | 08-04 | 开发计划 + 企微机器人/消息推送 | 开发计划 |
| 3.4.12 | 08-04 | 退款回滚/财务/批量任务·工单/套餐 imageUrl | v3.4.12 |
| 3.4.13 | 08-05 | metrics/核销详情/版本联动 PUBLISHED/mini 体验/H5 OAuth | v3.4.13 |
| 3.4.14 | 08-06 | mini-user 门头/套餐详情；小程序可配置；统一测试白名单（不计账+限测可见+Mock旁路） | v3.4.14 |
| 3.4.15 | 08-07 | mini-user 门店列表卡片；HQ 门店照片替换/删除；套餐多图上限 20 | v3.4.15 |
| 3.4.16 | 08-09 | 联系电话分离；取消自动 ST；套餐 UI；合伙人列表/入驻客服门槛；HQ 门店列表表格 | v3.4.16 |
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。
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/