dukang/docs/杜康好客-v3.4.15-mini-user门店列表优化.md

杜康好客 · v3.4.15 mini-user 门店列表 + HQ 门店照片 / 套餐多图

2026-08-07 · mini-user 3.4.15

更新内容

A. mini-user 门店列表卡片

• 门店列表卡片去掉「去核销」按钮，整卡最右侧改为小箭头（进入详情）
• 第 1 行：门店名单行截断（不显示省略号），宽度顶到文案区最右
• 第 2 行：地址最多两行；右侧显示距离
• 第 3 行：营业时间同行展示（多段时段空格拼接）
• 店铺封面右上角叠加斜角「营业中」标签图

B. HQ 门店照片支持替换与删除

• 门店详情「审核材料」Tab：门头照 / 环境照 / 签约合同可上传替换、删除
• 环境照最多 20 张；保存后写回 CommonResource（软删旧图再写入）
• PUT /admin/stores/:id 支持 coverUrl / envPhotoUrls / contractUrl（空值=删除）

C. 门店套餐图片最多 20 张

• 单条套餐支持多图：imageUrls（JSON）+ imageUrl 同步为首图（兼容旧数据）
• 上限 STORE_PACKAGE_IMAGE_MAX_COUNT = 20
• HQ / 合伙人 H5 / 门店 H5 均可增删换图；C 端套餐详情左右滑动浏览并可点击预览

D. 门店排序字段

• store_store.sort_order（Store.sortOrder，默认 0，越小越靠前）
• HQ 门店列表 / 新建 / 编辑可配置；C 端门店列表优先按 sortOrder，同序再按距离（有定位）或创建时间

范围

项	交付
门店列表卡片	布局与交互如上
HQ 门店照片	审核材料可替换/删除
套餐多图	最多 20 张 / 条；C 端左右滑动
门店排序	sortOrder 字段 + HQ 配置 + C 端排序
版本号	mini-user 3.4.15

ACC

• 列表项无「去核销」按钮；右侧有 › 箭头；点击整卡进详情
• 长店名单行截断且无 …；标题行无距离
• 地址 ≤2 行，距离在第二行右侧
• 营业时间单行；双时段同行显示
• 封面右上角可见「营业中」斜角标签
• HQ 门店详情可替换/删除门头照、环境照、合同并保存生效
• 环境照无法超过 20 张
• 套餐单条可上传至多 20 张图；C 端详情可左右滑动浏览全部
• HQ 可设置门店排序；C 端列表按排序优先展示