oemsaas 开发知识库

requirements

18分钟阅读

会员权益体系 — 业务需求

状态：以蓝湖 Axure 原型为准（2026-06-03 版本）。
需求依据（唯一）：蓝湖《会员权益》原型（下文简称「原型」）。
冲突处理：本文与原型不一致时，以原型为准；原型未画出的能力不纳入本期需求（见 §15 原型未覆盖）。
实现阶段：与现有代码冲突时以代码为准，但新开发应以原型为准迭代。
性质：业务需求摘要（非技术设计）。

目录

0. 蓝湖原型索引

序号页面名说明
1积分配置按顾客级别的积分加权（平常日 / 会员日）
2顾客级别=会员日配置会员日规则（按星期 / 按月日期）
3运费折扣配置运费活动与会员日、级别联动
4应用会员配置会员等级规则：自动升级、条件、是否降级
5会员指定折扣方案列表：各级别全部商品 / 指定商品权益摘要
6会员指定折扣方案配置编辑：全部商品 %、指定商品、选品弹窗
7会员折扣方案配置2多方案条目（添加方案）
8业务流程图模块依赖与优先级总览

1. 背景与目标

在现有顾客等级（o_customer_level + 客户 level_id）基础上，扩展 Shopine 会员系统应用能力。商家安装后可配置：

权益说明
会员价按级别配置「全部商品」与「指定商品」权益价；区分平常日 / 会员日
自动升降级按累计消费金额或订单笔数升级；可选降级
会员日按星期或每月日期触发，放大价/运费/积分权益
积分加权在既有积分获取规则上乘以级别加权比例
运费可限制仅会员日生效、指定级别适用
优惠券按级别限制原型未单独出页，本期不做（见 §15）

产品交付（原型）：会员权益自动化 + 会员指定折扣方案（见 §3）。

2. 系统模块与依赖关系

蓝湖《业务流程图》约定：

顾客级别（新建 v1/v2/v3…）
    ├─→ 会员积分配置
    │       ├─ 会员积分获取方式配置（沿用现有积分规则）
    │       └─ 会员积分加权配置
    ├─→ 会员升级自动化
    │       └─ 升级条件：订单量 / 消费额（二选一作为主条件维度）
    └─→ 会员指定折扣方案
            ├─ 方案类型1：全部商品折扣方案
            └─ 方案类型2：指定商品折扣方案
                    ※ 指定商品折扣优先级 > 全部商品折扣

会员日设置（相对独立配置）
    ├─ 按星期几设定会员日
    └─ 按每月指定号数设定会员日

原型约定：

  • 顾客级别增删改时，积分加权、折扣方案列表中的「会员级别」联动同步（积分配置页说明）。
  • 升级条件使用「累计消费金额达 / 累计订单笔数达」字段（应用会员配置）；具体读写字段在 design 阶段与现有客户表对齐。

3. 后台功能结构

3.1 导航（原型）

一级二级菜单
会员权益会员权益自动化
会员权益会员指定折扣方案

3.2 会员权益自动化

包含（原型分页对应）：

  • 会员等级规则（应用会员配置）：升级/降级规则与 V1/V2/V3 阈值。
  • 会员日设置（顾客级别=会员日配置）。
  • 积分配置：级别加权。
  • 运费折扣配置：与会员日、级别联动（可归属自动化子配置，具体菜单以最终 UI 为准）。

3.3 会员指定折扣方案

  • 列表页：按顾客级别展示「全部商品」「指定商品」权益摘要、关联人数、排序、编辑入口。
  • 配置页：该级别的「全部商品会员权益」+「指定商品会员权益」（最多 9 个 SKU，各配会员日/非会员日折扣 %）。

4. 会员价（会员权益折扣）

本章对应原型「会员指定折扣方案」相关页面。购物车计价互斥、行项标签等原型未描述，见 §15。

4.1 配置模型（每个顾客级别一套）

一个顾客级别仅一套会员折扣配置，包含两块（业务流程图：指定商品权重 > 全部商品）：

块说明
全部商品（会员权益）该级别默认折扣；未在「指定商品」中的 SKU 走此处；数据语义 product_id = 0
指定商品（会员权益）最多 9 个商品；每个商品单独配置折扣；命中时覆盖「全部商品」规则

每块均配置 会员日、非会员日（平常日） 两套百分比。

列表页「编辑」进入的是 该顾客级别 的配置，不是多套平行方案。

4.2 折扣百分比语义（已确认）

  • 字段为支付比例百分比（打折），有效值应 ≤ 100（列表中的 110% 等为占位示例，实际配置应小于 100 表示降价）。
  • 100 = 按原价，无会员折扣。
  • 80 = 实付为原价的 80%（8 折）。
  • 建议实现：实付价 = 原价 × (输入百分比 / 100)（具体币种精度在 design.md 约定）。

校验：保存时会员日/非会员日百分比建议在 (0, 100] 区间（是否允许 0 由实现约定）。

4.3 指定商品配置（已确认）

  • + 选择商品 弹窗：集合、上架状态、标题搜索、更多筛选（同原型）。
  • 已选商品表：商品图、名称、 SPU、原价、会员日 %、非会员日 %、删除。
  • 每个会员级别最多 9 个指定商品；每个商品独立配置会员日 / 非会员日折扣百分比。

5. 会员日

5.1 规则类型（原型：顾客级别=会员日配置）

类型 A — 按星期指定

字段说明
触发频次每周 / 每月首周 / 每月末周
触发星期星期一～星期日，支持多选
已配置活动时间根据所选星期生成，支持多选

类型 B — 每月指定日期

字段说明
添加触发日期1 号至 28 号
已配置活动时间根据所选日期，支持多选

5.2 会员日生效范围

会员日当天，下列权益切换为「会员日」配置：

权益平常日会员日
商品会员价平常日 %会员日 %
运费活动见 §8「仅会员日有效=是」时仅在会员日；=否 时在所选时段内始终有效
积分平常日加权 %会员日加权 %

6. 自动升级（无自动降级）

对应原型 应用会员配置 / 会员等级规则。
业务确认（覆盖原型「是否降级」默认是）：本期仅自动升级，不做自动降级。

6.1 基础设置

字段规则
会员自动化升级开关，默认开启；开启后按条件仅判断升级
升级条件下拉二选一：按消费金额 / 按订单笔数
是否降级原型有该开关；实现按业务确认：不执行自动降级（见 §6.4）

6.2 等级阈值（V1 / V2 / V3…）

字段说明
顾客级别下拉/展示名称，联动 o_customer_level（新增/修改级别时同步）
累计消费金额达仅当升级条件为「按消费金额」时展示并存储
累计订单笔数达仅当升级条件为「按订单笔数」时展示并存储

升级条件二选一（已确认）：

  • 下拉切换后，未选中维度的字段 隐藏且不写入存储（切换前已填的另一维数据不保留）。
  • 升级判断 只使用当前选中的单一维度（金额 或 笔数，不做 AND/OR 组合）。

原型示例：V1 普通会员 0 元；V2 白银 1000 元；V3 黄金 5000 元（金额单位与店铺货币一致）。

6.3 触发时机

  • 支付成功等正向事件：可触发自动升级判断（具体事件列表见 design.md）。
  • 原型未画批量初始化交互；若做历史顾客级别同步，单独约定，不纳入自动降级。

6.4 降级与退款（已确认）

场景行为
退款 / 取消订单不做降级处理；不因退款回退 level_id
自动降级不做；顾客等级不会因未达门槛而自动下调
修改升级门槛配置仅影响后续升级判断，不批量调低已有顾客等级

等级变更仅：自动升级、后台人工设级（沿用现有顾客级别能力）。

7. 积分权益

对应原型 积分配置。

7.1 开关与联动

项说明
是否开启加权关闭则隐藏/不应用右侧配置
会员级别列表联动顾客级别配置（1 级、2 级、3 级…随级别增删同步）

7.2 加权规则

字段说明
平常日积分加权比例在「积分获取规则」应得积分基础上 × 百分比
会员日积分加权比例同上，会员日使用

默认值（原型）： 平常日 100%，会员日 110%。

取整： 积分出现小数时，保留 1 位小数并向上取整。

7.3 与现有积分体系关系

  • 获取方式：仍走现有 PointsRule / 积分事件配置（原型称「会员积分获取方式配置」）。
  • 加权：本需求新增，按 level_id + 是否会员日套用比例。

8. 运费权益

对应原型 运费折扣配置；在现有运费折扣能力上扩展（已确认）。

字段说明
仅会员日有效是：在所选活动时间段内，仅会员日当天对命中级别的顾客生效；否：在所选活动时间段内始终有效（与是否会员日无关）
指定会员级别多选，数据来自顾客级别配置
其它运费规则金额、地区、物流方式等 复用现有运费折扣 创建/编辑能力；本页仅增加会员相关选项

校验：开启「仅会员日有效=是」时，需判断活动时段内是否存在会员日；顾客 level_id 须在「指定会员级别」内。

9. 优惠券限制

本期不做：原型未包含优惠券按级别限制的配置页（见 §15）。

10. 前台展示

本期不做：原型 8 页均为后台配置，未包含商品详情、账户首页、购物车标签等前台稿（见 §15）。

11. 应用交付

  • Shopine 会员系统应用安装后开放 §3 菜单与配置能力。
  • 应用未安装时，相关配置入口不展示（具体开关以应用中心约定为准）。

12. 原型已明确规则（摘录）

项原型约定
需求依据仅以蓝湖《会员权益》原型为准
指定 vs 全部商品指定商品折扣优先级 > 全部商品（业务流程图）
折扣 % 语义支付比例%；100=原价，80=8折；有效配置应 ≤100（列表 110% 为占位）
每级别折扣结构一套：全部商品权益 + 指定商品最多 9 个（各配会员日/非会员日 %）
升级条件按消费金额 或 按订单笔数（二选一，单维度判断）
升级字段 UI未选中维度隐藏且不存库
运费扩展现有运费折扣 +「仅会员日有效」「指定会员级别」
仅会员日有效=否所选活动时段内始终有效
自动降级不做（含退款/取消不降级）
自动升级默认开启，仅升不降
会员日-月日期1–28 日
会员日-星期每周 / 每月首周 / 每月末周 + 星期多选
积分加权默认平常日 100%，会员日 110%；小数向上取整
级别联动顾客级别变更 → 积分加权、折扣方案级别列表同步
运费仅会员日有效 + 指定会员级别多选

13. 确认记录

13.1 已确认（2026-06-03，业务确认）

#结论
2折扣字段为支付比例%；100=无折扣，小于 100 表示打折；列表 110% 等为占位，实际应 < 100
3每个会员级别最多单独配置 9 个指定商品；每商品可配 会员日 / 非会员日 折扣 %
4每个会员级别一套：「全部商品会员权益」+「指定商品会员权益（≤9）」；非多套平行方案
5现有运费折扣增加选项：「仅会员日有效」「指定会员级别」；否=所选时段内始终有效
6升级条件二选一后，另一维度字段 隐藏且不存；升级判断 仅用单一维度
1不自动降级；退款/取消订单不触发降级、不调低 level_id

14. 建议分期（参考）

阶段范围
P0原型后台：会员指定折扣方案（列表 + 配置 + 选品）
P1原型后台：应用会员配置（仅自动升级 + 阈值）
P2原型后台：会员日 + 积分加权 + 运费折扣配置
P3顾客级别联动 + 应用安装与菜单
P4§15 原型未覆盖项（须新原型后再排期）

15. 原型未覆盖（本期不做）

下列能力在沟通中出现过，但当前蓝湖《会员权益》8 页未体现，不写入本期需求、不开发；若要做须先补原型。

能力说明
前台商品详情 VIP 价 / 帮助弹层无前台稿
账户首页 / 会员中心无前台稿
购物车/订单行标签（如 member discount）无稿
购物车计价与批发/限时/礼品/一口价互斥无稿
优惠券按级别限制无配置页
支付成功 Webhook 升级、历史批量初始化无交互稿
秘密款无稿
主题路由自动分组无稿

维护：蓝湖原型版本变更后，更新文首链接、versionId 与 §0 页面表。技术实现见 design.md，DDL 见 membership_tables.sql。

架构补充（2026-06-08）：配置 UI 在 oemsaasapp；商城表存积分加权、会员日、会员折扣、运费扩展；升降级规则在应用库；升级走 orders/paid Webhook（延迟 5 分钟）+ 应用回写 level_id。

关系图谱

反向链接