dukang/docs/杜康好客-v3.4.16-门店联系电话与体验优化.md

杜康好客 · v3.4.16 门店联系电话与体验优化

2026-08-09 · PRD §3.12 · mini-user / h5-partner / admin-web / API

范围

项	交付
A. 登录号 / 联系电话分离	Store.contactPhone；合伙人入驻/编辑；HQ；C 端 publicDial
B. 取消自动技术支持工单	validation_error 不再自动建 ST；上报与人工 ST 保留
C. 套餐详情排版	套餐名 + 价格：一行能放下则同行，否则名称换行、价格次行右对齐
D. 门店详情套餐列表	套餐名称后展示价格
E. 合伙人门店列表	右上角状态；开关营业/临时闭店；永久闭店按钮；下拉筛选
F. 入驻企微客服门槛	HQ 可配二维码；勾选「已添加客服」后才可提交
G. HQ 门店列表表格	店名过长截断；操作列右侧固定；横向滚动

A. 登录号 ≠ 对外联系电话

字段	含义	用途
phone	老板主账号	门店端登录；StoreAccount.phone
contactPhone	店长/对外	C 端拨号与展示

• C 端 GET /stores、GET /stores/:id：phone = contactPhone ?? phone（兼容旧小程序）
• 未填联系电话时对外回退登录号

B. 取消 validation_error 自动 ST

• 原路径：POST /common/client-errors + category=validation_error → createFromClientValidation
• 删除自动建单；保留 client-error 落库 / WeCom 告警；HQ 手动建单与企微「创建」不变

C / D. mini-user 套餐 UI

• 套餐详情标题与门店详情「门店套餐」列表一致：名称在左可换行，价格始终居右；放不下时价格落在次行右侧

E. 合伙人门店列表

UI	行为
右上角徽标	待审核 / 审核驳回 / 营业中 / 临时闭店 / 永久闭店
开关	OPEN ↔ PAUSED；CLOSED / PENDING 禁用
永久闭店	独立按钮 + 确认 → CLOSED
筛选	下拉：全部 / 营业中 / 临时闭店 / 待审核 / 已驳回 / 永久闭店

API：PUT /partner/stores/:id/status（不变）

F. 入驻企微客服二维码门槛

配置键	说明
PARTNER_ONBOARD_CS_QR_URL	企微客服二维码图片 URL（OSS）
PARTNER_ONBOARD_CS_HINT	提示文案（默认见下）

默认提示：使用问题、提现问题等随时可联系【杜康好客】客服

• GET /common/client-config 对 PARTNER 下发 partnerOnboardCsQrUrl / partnerOnboardCsHint
• HQ 系统设置 → 微信小程序配置（与「总部客服电话」同组）：可上传二维码、编辑提示文案
• 入驻信息填完后展示二维码；须勾选「我已添加【杜康好客】客服」才可提交/跳过
• 未配置二维码：禁止提交，提示联系总部

G. HQ 门店列表页表格体验

apps/admin-web 门店列表：

点	行为
门店名	过长省略号截断，悬停可看全名；「测试」标签保留
操作列	fixed: 'right'，横向滚动时详情/评价始终可见
整表过宽	scroll.x 开启横向滚动条（列宽合计约 1720）

合伙人名、介绍、分类等长文本列同样启用 ellipsis，避免撑破布局。

ACC

• 旧门店对外拨号仍可用（回退登录号或已回填 contactPhone）
• 合伙人可分别维护登录号与联系电话
• API 400 不再产生「客户端验证错误自动上报」ST
• 套餐详情短/长标题排版符合定案
• 门店详情套餐列表可见价格
• 合伙人列表状态/开关/永久闭店/下拉筛选可用
• 无二维码不可提交；有二维码须勾选后提交
• HQ 可上传/更换入驻客服二维码
• HQ 门店列表：长店名截断、操作栏右固定、可横向滚动