# 杜康好客 · 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` 门店列表](apps/admin-web/src/pages/StoresPage.tsx)：

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

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

## ACC

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