jacy
a2abbb6169
Store list/detail package flow, configurable WeChat mini brand assets and customer service, shop H5 home refresh. Co-authored-by: Cursor <cursoragent@cursor.com>
52 lines
2.5 KiB
Markdown
52 lines
2.5 KiB
Markdown
# 杜康好客 · v3.4.14 mini-user 门店体验 + 小程序可配置项
|
||
|
||
> **2026-08-06** · **开发中** · PRD §0.6 · mini-user `3.4.14` · **未发版**
|
||
|
||
## 范围
|
||
|
||
| 项 | 交付 |
|
||
|----|------|
|
||
| 门头照 | **固定 4:3 区域**；`aspectFit` 缩放完整显示（不裁剪）；标题信息卡固定接在门头下方 |
|
||
| 门店详情·套餐 | 仅完整标题纵向列表；点击进入详情 |
|
||
| 套餐详情页 | 实底导航让出胶囊区；内容区顶/左右留白；有图在门店名下；无图直接菜品 |
|
||
| **系统设置·微信小程序** | Logo / 资质图 / 客服电话 / C 端 H5 / Mock 验证码 **可配置**，经 `client-config` 下发 |
|
||
|
||
## 页面路由
|
||
|
||
| 路径 | 参数 |
|
||
|------|------|
|
||
| `pages/store-detail/index` | `id` 门店 ID |
|
||
| `pages/store-package-detail/index` | `storeId` · `index` 套餐序号（0-based） |
|
||
|
||
数据：复用 `GET /stores/:id` 内嵌 `packages[]`，详情页按 index 取项。
|
||
|
||
## 系统设置（微信小程序配置）
|
||
|
||
HQ → 系统设置 → **微信小程序配置**。启动时空缺键用 shared-types 默认值补种。
|
||
|
||
| 配置键 | 说明 |
|
||
|--------|------|
|
||
| `USER_H5_URL` | C 端 H5 落地页（推广码等） |
|
||
| `BRAND_LOGO_OSS_BASE` | Logo OSS 根路径（说明用） |
|
||
| `BRAND_LOGO_URL` / `_WIDE_` / `_MARK_` | 方形 / 长方形 / 图标 Logo |
|
||
| `MINI_USER_STATIC_OSS_BASE` | 小程序静态资源根路径 |
|
||
| `QUALIFICATION_DISCLOSURE_URL` | 资质公示长图 |
|
||
| `CUSTOMER_SERVICE_PHONE` | 总部客服电话 |
|
||
| `MOCK_SMS_FIXED_CODE` | Mock 短信固定验证码（仅 MOCK_SMS 开启） |
|
||
|
||
**下发**：`GET /common/client-config` 增加 `userH5Url`、`brandLogoUrl`、`brandLogoWideUrl`、`brandLogoMarkUrl`、`qualificationDisclosureUrl`、`customerServicePhone`。
|
||
`MOCK_SMS_FIXED_CODE` 仅服务端 Mock 短信读取，不下发客户端。
|
||
|
||
## ACC
|
||
|
||
- [ ] 门头区高度固定（4:3）；图片 aspectFit 完整缩放；标题 section 位置不随图高变化
|
||
- [ ] 门店详情套餐区仅标题列表，标题完整展示、可换行
|
||
- [ ] 点击套餐进入详情页，字段完整；返回回到门店详情
|
||
- [ ] 无套餐时不展示区块；index 非法时友好提示
|
||
- [ ] HQ 微信小程序配置可改 Logo/电话/落地页/Mock 码；保存后 client-config 立即生效（无需重启）
|
||
- [ ] mini-user 登录/我的/客服/分享图读取配置；未配置时回退代码默认常量
|
||
|
||
## HQ 开发计划
|
||
|
||
创建版本 `v3.4.14`（`IN_PROGRESS`），关联本迭代任务。发版前再合并发布。
|