商城商品促销标识与价格规则字典

写在前面（给编写者与运营人员）： 本文档是 "规则字典" (Rulebook)。 当客户或销售疑惑：“为什么这个商品打着‘热销’标签？”，“为什么详情页会弹出一个‘满减’的提示？”时，请查阅本文档的底层规则。

1. 规则定义 (Policy Definition)

为了加强商城的导购体验，我们在商品上增加了多种视觉提示和价格规则说明：

• Ribbon (角标标签)：在商品图片左上角或右上角飘的横幅，例如 新品 (New)、特价 (Sale)、热销 (Hot)。
• Tiered Pricing (阶梯价)：买 1 件 $10，买 10 件 $9，在商品详情页展示的表格。
• Promotion (促销活动)：如满100减10、特定优惠码，在商品详情页以卡片形式展示。

2. 详细业务规则 (Business Rules)

2.1 角标标签 (Ribbon) 的生成逻辑

一个商品甚至可以同时显示多个标签（例如左上角“新品”，右上角“热销”），最多全局配置展示 $N$ 个。

标签类型	自动/手动	触发逻辑与判定说明
新品 (New)	自动	商品创建时间在设定的“新品保护期 (New Period)”范围内自动打标。
特价 (Sale)	自动	系统检测到该商品在当前客户的价格表下“存在折扣”，自动打标。
热销 (Hot)	自动	核心算法：在过去的 $N$ 天内，该商品的有效销售订单总量大于 $M$ 件，自动打标。 注：如果启用了单仓筛选，热销只计算当前仓库的销量。
手动标签	手动	运营人员在后台强行给特定变体或模板打上的标签。手动标签优先级高于自动标签。

2.2 Ribbon 后台配置

管理员可以在后台定义各种标签的样式、优先级和触发规则。

• 配置路径：Website (网站) > eCommerce (电商) > Product Ribbons (产品标签)

图 1: 后台 Ribbon 配置菜单

在列表中，你可以管理所有标签的 Display Priority (显示优先级)、Position (左右位置) 和 Background Color (背景色)。

图 2: 标签列表与优先级管理

• 自动规则配置 (Assign)：在标签详情页，通过 Assign 字段选择触发逻辑（如 Hot Selling 或 On Sale）。如果是手动标签，则选择 Manually。

图 3: 为标签分配自动触发规则 (Assign)

2.3 前端多标签展示效果

一个商品可以同时展示多个标签。系统会根据配置的优先级和左右位置进行智能排列。

图 4: 列表页多标签 (Multi-Ribbon) 叠加展示效果

2.4 详情页价格与促销规则 (Pricing & Promos)

登录后的客户进入详情页，会在价格区域下方看到两个折叠面板：

图 6: 详情页阶梯价格表与促销活动展示

1. Tiered Pricing (阶梯价)

   • 逻辑：系统读取当前客户绑定的 Pricelist (价格表)。如果价格表里配置了“最少买 $X$ 件可以享受单价 $Y$”，就会在这里生成一行表格。
   • 作用：让客户清楚知道买多少能拿更低的批发价。

2. Promotion (促销活动卡片)

   • 逻辑：读取后台配置的折扣与忠诚度计划 (Discount-Loyalty)。只要这个商品满足某个活动的“触发条件 (Condition)”，就会渲染一张卡片。
   • 信息展示：
     • 如果活动有优惠码，卡片会醒目提示：Code Required (需输入优惠码)。
     • 如果活动快结束（剩余 0~3 天），会红色警示提示：3 days left (剩3天)。否则显示 Ends on 2026/12/31 或 Long-term offer。

3. Odoo 配置与实现 (Configuration)

注意：本节主要供管理员或实施顾问参考，普通用户了解即可。

• 热销参数配置：
  • 路径：Website (网站) > Configuration (配置) > Settings (设置) > Shop (商店)
  • 调整参数：Hot Selling Days (N) (统计天数) 和 Sales Threshold (M) (销量阈值)。保存后全站热销商品自动重新计算。
• 多标签显示数量限制：
  • 同样在 Settings 中，可以设置 Max Ribbon Display Count (最多显示几个角标，例如 5 个)。

图 5: 热销阈值与最大显示数量配置

• 价格表说明 (Pricelist Notice)：
  • 路径：Sales (销售) > Products (产品) > Pricelists (价格表)
  • 在特定价格表上，可以编辑一段 HTML 说明文本（如“VIP专属物流政策”）。前端商城通过 Pricelist Notice Snippet 组件会自动抓取并展示给该价格表的客户。

4. 常见问题 (FAQ)

• Q: 为什么匿名访客看不到阶梯价和促销卡片？
  • A: 为了保护 B2B 商业机密，所有的价格说明、阶梯价表格、可用促销活动，严格限制为“仅登录用户可见”。访客页面只会展示最基础的面价。
• Q: 为什么商品销量很高，但没有“热销”标签？
  • A: 请检查后台的 $N$（天数）和 $M$（件数）配置。如果订单还处于 Quotation (草稿) 状态未确认，销量不会计入热销算法。只有状态为 Sale Order 的订单才会计算。

---

截图 TODO

• 多 Ribbon 展示：一个商品同时带有“热销”和“特价”标签的截图。
• 详情页折叠区：展开状态下的 Tiered Pricing 表格与 Promotion 卡片。
• 后台配置项：热销 N/M 参数配置界面的截图。