Skip to main content

业务规范、降级策略与常见问题排查 (Policy & FAQ)

为了保障商城前端展示的稳定性、视觉一致性与高转化率，本文档汇总了促销展示模块的设计输出标准、多语言匹配原则、系统级智能降级机制以及运营常见异常的诊断排查路径。

1. 视觉设计规范与素材发布准则​

维度规范要求业务考量
文件体积单张图片建议 < 500 KB（推荐 150 KB ~ 300 KB）移动端商户在后厨或弱网环境下采购时，小体积可实现秒开，大幅降低首屏跳出率。
推荐格式WebP（首选）或压缩后的 JPG / PNGWebP 兼顾了高保真透明通道与极致压缩率，Odoo 19 前端天然原生支持。
设计安全区桌面端核心文字与行动号召按钮请居中分布于中间 1200 px 宽度内避免超宽屏（如 4K 显示器）或小笔记本屏幕将核心文案裁剪或挤出视区。
双端一致性移动端专属海报与桌面端海报应保持相同的活动利益点与主色调确保采购商在电脑端与微信端切换浏览时的品牌认知统一。

2. 智能降级与异常保护机制​

系统在底层内置了多层容错逻辑，确保前台任何情况下都不会出现页面崩溃或残缺空白：

2.1 游客/未登录访客自动降级​

  • 若促销活动设置了「适用客户标签」或「适用发货仓库」，系统将其判定为 私域专属促销。
  • 访客未登录时，系统将自动隐藏上述受限海报，只加载未设置任何受众标签的全员公开海报。
  • 保护了高价值采购商的协议价与私密大促信息不向竞对或外部散客泄露。

2.2 多语言 (i18n) 动态兜底机制​

  • 当访客以 en_US 访问时，系统优先匹配 Language = English (US) 的素材；
  • 若该活动仅配置了 zh_CN 语言素材，系统将向英文用户隐藏该中文海报，避免语言冲突；
  • 若素材未设置语言（Language = False），系统将其视作通用多语种素材，在任何语言环境下均正常兜底展示。

2.3 移动端素材平滑回退​

  • 若运营人员在上传素材时未上传「移动端专属图片」，移动设备访问时将自动回退使用桌面端图片，确保活动不会因漏传素材而开天窗。

2.4 无有效海报时的容器静默​

  • 若某个位置下所有活动均已过期，或者所有海报均被临时关闭，前端组件容器将自动折叠隐藏，不会在页面上留下白斑或无内容的灰色方框。

2.5 原图 Lightbox 全屏预览交互​

  • 如果单张海报未配置外部跳转 URL，当用户在前台点击该图片时，系统将自动触发无缝全屏 Lightbox 弹窗，方便采购商放大查看产品细节、配料表或活动条款细则。

原图全屏预览 Lightbox 弹窗交互

3. 优先级叠加与排序机制详解​

当一个展示位置绑定了来自多个活动的多张海报时，系统如何决定谁排在第一张？

$$排序权重 = 活动优先级 (Activity\ Priority) \times 1000 + 素材优先级 (Image\ Priority)$$

  1. 第一权重（活动层级）：
    • 高优先级的活动素材永远优先展示。例如优先级 30 的大促活动海报，排在优先级 10 的日常活动海报之前。
  2. 第二权重（素材层级）：
    • 同一活动下的多张海报，按素材表单中的 优先级 (Priority) 倒序排列。
  3. 第三权重（创建时间）：
    • 若优先级完全一致，按照素材创建时间倒序（最新创建的靠前）。

4. 常见问题诊断与排查手册 (FAQ)​

Q1: 后台已创建海报，前台对应位置却一片空白？​

请按以下排查漏斗依次检查：

  1. 检查活动总开关：进入促销活动表单，确认右上角「活动启用」开关是否为绿色打开状态。
  2. 检查时间窗口：确认当前服务器时间是否介于活动的「开始时间」与「结束时间」之间（注意时区）。
  3. 检查受众规则：
    • 当前登录账号是否具备活动所要求的「客户标签」？
    • 当前账号所属的默认交货仓库是否包含在「适用发货仓库」列表中？
    • 如果测试时使用无痕窗口（未登录状态），请确认活动是否误选了客户标签或仓库。
  4. 检查位置绑定：检查海报表单中的「展示位置」是否与页面 Snippet 选中的展示位置完全匹配。

Q2: 为什么切换网站语言后，某些促销海报看不到了？​

  • 原因：该促销海报设置了专属语言（如 zh_CN）。当访客切换至 en_US 时，系统为了防止英文用户看到无法理解的中文海报，会自动进行语言隔离过滤。
  • 解决办法：
    • 如果该海报需要对所有语言访客公开，请将海报表单的「语言」字段清空保持留空；
    • 如果属于定向营销，请额外新建一张专属该语言的英文海报，并将「语言」设置为 English (US)。

Q3: 为什么删除某个「展示位置 (Position)」时系统报错拦截？​

  • 系统安全防呆保护：
    • 若提示 "A promotion position linked to images cannot be deleted."：说明还有海报素材绑定了该位置。请先在素材列表批量解除关联，然后再删除。
    • 若提示 "A promotion position used by a page component cannot be deleted."：说明商城某个页面（如 /shop 或 /promotions）的 Snippet 正在使用该位置作为数据源。请先进入页面构建器将组件移除或切换为其他位置。

Q4: 手机端看到的图片字迹偏小或看起来变形？​

  • 原因：该海报未上传「移动端专属图片」，前端直接沿用了宽画幅的桌面大图并在手机上等比缩小。
  • 解决办法：请视觉设计师专门导出 750 × 600 px 的竖向移动端素材，并在海报表单的「移动端专属图片」字段中上传。

Q5: 轮播图在前台静止不动，不会自动播放？​

  • 原因 1：在网站构建器中，未勾选该组件的「自动播放 (Auto Play)」选项。请点击编辑页面，在右侧面板开启开关并保存。
  • 原因 2：客户鼠标悬停（Hover）在轮播图区域时，为了防止误触，浏览器会默认暂停自动轮播；移开鼠标后会恢复播放。