65 lines
3.2 KiB
Markdown
65 lines
3.2 KiB
Markdown
# 杜康好客 · v3.4.13 体验优化开发文档
|
||
|
||
> 版本：**v3.4.13** · 日期：2026-08-05
|
||
> 需求源：20 条 ST 工单（体验优化 / Bug / 客户端验证）
|
||
|
||
## 1. 范围
|
||
|
||
| 模块 | 内容 |
|
||
|------|------|
|
||
| admin-web | 推广码 attributionCount；核销记录用户信息；技术支持工单优先级 |
|
||
| mini-user | 门店电话脱敏+拨打埋点；门头/套餐展示；商品去分享+首图 preview；提货确认弹框；版本更新提示；物流追踪页 |
|
||
| h5-partner / h5-shop | 登录 phone/code 前端校验 |
|
||
| 后端 | 工单 priority 字段；client-config minClientVersion；合伙人微信登录暂停拦截 |
|
||
|
||
## 2. ST 映射
|
||
|
||
| ST | 标题 | 状态 |
|
||
|----|------|------|
|
||
| ST1785925037781309 | 总部端-推广码数据跟踪优化 | ✅ attributionCount 统计卡 |
|
||
| ST1785924286682833 | 用户端-门店电话加密+拨打埋点 | ✅ maskPhone + store_phone_call |
|
||
| ST1785921693982470 | 技术支持-工单优先级 | ✅ priority 枚举 + HQ UI |
|
||
| ST1785921585900725 | 门店端扫一扫授权异常 | ✅ 已有（v3.4.12 前） |
|
||
| ST1785907536648201 | 版本不对提示更新 | ✅ UpdateManager + minClientVersion |
|
||
| ST1785906800359657 | 合伙人暂停后禁登 | ✅ loginPartnerWechat status |
|
||
| ST1785906592340255 | PARTNER_H5 login 校验 | ✅ 前端空字段拦截 |
|
||
| ST1785906390321653 | 现场提货提交确认弹框 | ✅ showModal |
|
||
| ST1785905773501871 | 核销记录用户信息 | ✅ 列表+详情 |
|
||
| ST1785904849234806 | 工单中心 | ✅ 已有 |
|
||
| ST1785904076632841 | 门店列表开城合伙人 | ✅ 已有 |
|
||
| ST1785902173093977 | 去掉商品详情分享按钮 | ✅ 移除 ShareNavButton |
|
||
| ST1785902141731113 | 商品首图大图 | ✅ previewable |
|
||
| ST1785901870913349 | 门店列表营业时间 | ✅ 已有 |
|
||
| ST1785901838948572 | SHOP 未绑定门店 | ✅ 已有 |
|
||
| ST1785901775231811 | 门店套餐遮挡 | ✅ 折叠/行数限制 |
|
||
| ST1785901711627824 | SHOP login 校验 | ✅ 前端空字段拦截 |
|
||
| ST1785901314893145 | 门头照裁剪 | ✅ aspectFit + preview |
|
||
| ST1785939375449985 | 订单物流追踪页 | ✅ order-logistics |
|
||
|
||
## 3. 后端 API / 配置
|
||
|
||
| 方法 | 路径 / 配置 | 说明 |
|
||
|------|-------------|------|
|
||
| GET | `/common/client-config` | 新增 `minClientVersion`（env `MINI_USER_MIN_VERSION`） |
|
||
| — | `CommonSupportTicket.priority` | `LOW \| NORMAL \| HIGH \| URGENT`，默认 NORMAL |
|
||
| — | `loginPartnerWechat` | 非 ACTIVE 账号抛出「合伙人账号已停用」 |
|
||
| GET | `/trade/orders/:id/track` | 物流追踪页复用 |
|
||
|
||
## 4. 数据表
|
||
|
||
- `common_support_ticket.priority` ENUM，默认 `NORMAL`
|
||
|
||
## 5. HQ 开发计划
|
||
|
||
在 admin-web **开发计划 → 版本列表** 创建 `v3.4.13`（状态 `IN_PROGRESS`），审批 ST 后关联 `dev_plan_task`。
|
||
|
||
## 6. 验收 ACC
|
||
|
||
- [ ] 推广码详情展示 attributionCount
|
||
- [ ] 核销记录含 userNo/nickname/phone
|
||
- [ ] 技术支持可创建/筛选/编辑优先级
|
||
- [ ] 合伙人/门店登录空字段前端提示；暂停合伙人微信登录被拒
|
||
- [ ] mini-user：电话脱敏、拨打埋点、提货确认、无分享按钮、首图 preview、门头/套餐正常
|
||
- [ ] mini-user：低版本弹窗、UpdateManager、物流追踪页
|
||
- [ ] `pnpm lint` 无新增错误
|