feat(v3.4.16): partner UX, package pricing, CS gate, HQ list polish
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>
This commit is contained in:
@@ -0,0 +1,83 @@
|
||||
# 杜康好客 · 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 门店列表:长店名截断、操作栏右固定、可横向滚动
|
||||
Reference in New Issue
Block a user