Files
dukang/杜康好客-v3.4.14-mini-user门店体验开发文档.md
T
jacy a2abbb6169 feat(v3.4.14): mini-user store UX, brand config, client settings
Store list/detail package flow, configurable WeChat mini brand assets and customer service, shop H5 home refresh.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-06 15:21:59 +08:00

2.5 KiB
Raw Permalink Blame History

杜康好客 · 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 增加 userH5UrlbrandLogoUrlbrandLogoWideUrlbrandLogoMarkUrlqualificationDisclosureUrlcustomerServicePhone
MOCK_SMS_FIXED_CODE 仅服务端 Mock 短信读取,不下发客户端。

ACC

  • 门头区高度固定(4:3);图片 aspectFit 完整缩放;标题 section 位置不随图高变化
  • 门店详情套餐区仅标题列表,标题完整展示、可换行
  • 点击套餐进入详情页,字段完整;返回回到门店详情
  • 无套餐时不展示区块;index 非法时友好提示
  • HQ 微信小程序配置可改 Logo/电话/落地页/Mock 码;保存后 client-config 立即生效(无需重启)
  • mini-user 登录/我的/客服/分享图读取配置;未配置时回退代码默认常量

HQ 开发计划

创建版本 v3.4.14IN_PROGRESS),关联本迭代任务。发版前再合并发布。