1. 文档元信息
属性 内容
文档名称 云灵汐(涉旅电商分销子系统)- PC端营销中心模块产品需求文档
文档版本 v1.0
编制日期 2026年7月
文档状态 待评审
适用平台 平台运营后台(PC端)、供应商后台(PC端)
前置依赖PRD 基础功能与权限管理PRD、商家与店铺管理PRD、商品供应链管理中心PRD、分销中心模块PRD、订单履约全链路模块PRD、财务中心模块PRD
参考文档 PRD-产出SOP与深度标准模板、核心业务主流程图、功能清单整理版、菜单结构整理版
文档定位: 本文档为营销中心模块的独立PRD,覆盖会员管理、积分管理、优惠券管理、活动管理(含展示活动/满减/秒杀/拼团/活动审核)及供应商活动参与五大功能域,共计22个功能项。营销中心是平台五大核心业务引擎之一(分销与营销中心),承担用户留存、转化提升和活动运营的核心职责。
2. 术语表
术语 定义 备注
营销中心 平台运营后台一级菜单,包含会员管理、积分管理、优惠券管理、活动管理四大子模块 本PRD覆盖范围
会员 在平台注册并具有会员身份的C端用户,通过成长值划分等级,享有差异化权益 不同于分销商账号
成长值 会员等级的量化指标,通过消费、签到、评价等行为累积,达到阈值自动升级 不存储于DB,前端计算展示
会员等级 按成长值划分的层级体系,分为普通、白银、黄金、铂金、钻石五级 不同等级享有不同权益
会员权益项 绑定到会员等级的具体权益,如折扣率、生日礼券、优先客服、免邮等 可跨等级复用
积分 会员在平台内的虚拟权益点数,通过消费、签到等行为获取,可兑换商品或优惠券 积分不可抵扣订单金额(与已有PRD一致)
优惠券 平台或供应商发放的营销凭证,用户在下单时可抵扣订单金额 分为满减券、折扣券、代金券
成本承担方 优惠券或活动优惠的成本由谁承担,分为平台承担、供应商承担、分销商承担 主流程图核心设计原则
成交价 C端为平台销售价扣减优惠券、满减等活动优惠后的金额(积分不可抵扣订单金额) 与订单履约PRD、财务PRD定义一致
秒杀活动 限时限量特价促销活动,具有独立库存池、限购规则和防刷策略 订单类型order_type=2
拼团活动 多人成团享优惠价格的活动,分为普通拼团、老带新拼团、阶梯拼团 未成团自动退款并退券
满减活动 订单金额达到阈值后减免的促销活动,如满300减30 可跨商品叠加
展示活动 以专题页/Banner形式展示的营销活动,聚合商品和优惠券,无价格优惠 仅展示,不改变商品价格
活动模板 预设活动配置模板,包含活动类型、规则字段、页面布局等,支持一键创建活动 提升运营效率
底价保护 营销活动价格不得低于商品底价,由商品供应链中心校验拦截 与供应链PRD一致
逆向分账 退款时按"分销商佣金→供应商货款→平台服务费"顺序扣回资金 与财务PRD一致
积分对账 积分发放、消耗、兑换的定期核对,对账类型recon_type=6 与财务PRD一致
3. 需求背景
云灵汐涉旅电商分销子系统连接平台运营、供应商、分销商(个人/B端/OTA)和C端消费者四类角色,通过商品供应链、订单履约、分销推广、财务清分五大核心引擎驱动业务运转。营销中心作为五大引擎之一,承担用户拉新、留存、转化提升和活动运营的核心职责。
当前系统已完成基础功能与权限管理、商家与店铺管理、商品供应链管理、分销中心、订单履约全链路和财务中心六大模块的PRD设计,但营销中心作为连接C端消费者体验和平台运营策略的关键模块尚未独立设计。从核心业务主流程图(流程9:核心营销流程)可以看出,营销活动贯穿"活动创建→供应商参与→活动发布→活动执行→活动复盘"全链路,并通过优惠券自动匹配、秒杀库存锁定、拼团成团/退款等机制与订单、分销、财务模块深度联动。
已有的6个PRD中,订单履约PRD定义了discount_amount(优惠金额)和price_snapshot(成交价快照)字段,财务PRD定义了C端成交价=平台销售价-优惠券/满减/积分抵扣的口径,供应链PRD定义了活动价下限校验和库存占用接口。但这些PRD均未定义营销活动本身的创建、配置、审核、执行和复盘逻辑,也未定义会员体系和积分体系。营销中心PRD正是填补这一空白的独立模块文档。
4. 目标与范围
4.1 核心目标
建立完整的会员等级与权益体系,实现C端用户的分层运营和差异化服务
建立积分获取与消耗闭环,通过积分激励用户消费、签到、评价等行为
提供优惠券全生命周期管理(创建→发放→领取→使用→退回→作废),支持成本承担方标记和精准投放
支持展示活动、满减活动、秒杀活动、拼团活动四类营销活动的创建、审核、发布和复盘
提供供应商参与平台活动的入口(活动报名→审核→参与→数据查看)
与订单履约、财务清分、商品供应链模块无缝衔接,确保营销成本在分账环节精准扣减
4.2 功能范围
功能域 功能项数 包含内容
会员管理 4 会员类型、会员等级、会员权益项、会员列表
积分管理 6 积分规则、获取设置、兑换设置、获取记录、兑换记录、积分对账
优惠券管理 3 优惠券活动、优惠券列表、使用记录
活动管理 7 活动类型、活动模板、展示活动、满减活动、秒杀活动、拼团活动、活动审核
供应商活动参与 2 可参与活动(活动报名)、我的活动(活动记录与数据)
合计 22 覆盖菜单结构中营销中心全部20个三级菜单 + 供应商后台2个营销活动菜单
4.3 不在本次范围
C端移动端的优惠券领取、活动参与交互(在C端交易PRD/移动端PRD中定义)
优惠券在结算页的自动匹配和手动选择逻辑(在C端交易PRD中定义)
AI智能营销方案生成(主流程图标注为"可选",本期不实现)
营销活动落地页的可视化拖拽搭建(本期仅支持模板化页面配置)
供应商自主发起营销活动(主流程图描述了供应商创建优惠券/满减活动的能力,但当前菜单结构仅支持供应商参与平台活动,自主创建列为后续迭代)
会员协议和积分协议的合同管理(在商家管理-合同管理PRD中定义,优先级P2)
5. 用户与角色
角色 所在后台 营销中心权限 典型操作
平台运营-营销专员 平台运营后台 会员管理(读写)、积分管理(读写)、优惠券管理(读写)、活动管理(读写) 创建优惠券、配置活动、审核供应商活动报名
平台运营-审核员 平台运营后台 活动审核(读写)、优惠券审核(读写) 审核活动提交、审核优惠券投放
平台运营-会员运营 平台运营后台 会员管理(读写)、积分管理(读写)、积分对账(读写) 配置会员等级权益、积分规则、积分对账
平台运营-数据分析 平台运营后台 全部营销数据(只读) 查看活动转化分析、会员数据分析
平台超级管理员 平台运营后台 全部权限(读写) 配置营销中心菜单权限、审批重大变更
供应商-营销专员 供应商后台 活动申请(读写)、我的活动(只读) 查看可参与活动、报名提交商品、查看活动数据
供应商-管理员 供应商后台 活动申请(读写)、我的活动(只读) 管理本供应商活动报名、查看活动数据
权限说明: 营销中心全部功能位于平台运营后台,供应商后台仅有"营销活动"一级菜单(活动申请/我的活动)。分销商后台无独立营销菜单,分销推广相关功能在"推广管理"菜单下(属于分销中心PRD范围)。C端消费者的优惠券领取、活动参与在移动端实现,不在本PRD范围。
6. 功能清单
本章列出营销中心模块全部22个功能项,与功能清单整理版第9节"营销活动"和菜单结构中"营销中心"一级菜单完全对齐。
编号 功能模块 功能项 适用后台 核心功能 优先级
9.1 会员管理 会员类型 平台 会员类型、会员来源、启停 P1
9.2 会员管理 会员等级 平台 会员等级、成长值、权益 P1
9.3 会员管理 会员权益项 平台 权益项、适用范围、生效规则 P1
9.4 会员管理 会员列表 平台 会员列表、详情、标签、状态 P1
9.5 积分管理 积分规则 平台 获取/消耗/过期规则 P1
9.6 积分管理 获取设置 平台 签到、下单、评价等积分获取配置 P1
9.7 积分管理 兑换设置 平台 积分兑换商品/优惠券配置 P1
9.8 积分管理 获取记录 平台 积分获取明细、来源、撤销 P1
9.9 积分管理 兑换记录 平台 兑换明细、核销/发放状态 P1
9.10 积分管理 积分对账 平台 积分发放、消耗、过期、差异处理 P1
9.11 优惠券管理 优惠券活动 平台 优惠券活动创建、审核、投放 P1
9.12 优惠券管理 优惠券列表 平台 券模板、库存、状态、启停 P1
9.13 优惠券管理 使用记录 平台 领取、使用、退回、作废记录 P1
9.14 活动管理 活动类型 平台 活动分类、展示类型、启停 P1
9.15 活动管理 活动模板 平台 活动模板、字段配置、规则模板 P1
9.16 活动管理 展示活动 平台 展示类活动、专题、Banner、报名商品 P1
9.17 活动管理 满减活动 平台 满减规则、适用商品、成本承担 P1
9.18 活动管理 秒杀活动 平台 秒杀时段、活动库存、限购、防刷 P1
9.19 活动管理 拼团活动 平台 拼团规则、成团失败处理、退款 P1
9.20 活动管理 活动审核 平台 活动提交、审核、驳回、发布 P1
9.21 供应商活动 可参与活动 供应商 查看活动、报名、提交商品、审核结果 P1
9.22 供应商活动 我的活动 供应商 活动记录、活动数据、退出申请 P1
7. 系统架构
7.1 营销中心在系统中的定位
营销中心是平台五大核心业务引擎之一(分销与营销中心),在系统总览中与商品供应链中心、订单全流程中心、财务清分结算中心、AI辅助决策中心并列。营销中心直接连入财务清分结算中心(营销成本在结算环节扣减),同时被AI辅助决策中心辅助(AI营销能力,本期不实现)。
flowchart TB
subgraph 营销中心["营销中心(本PRD范围)"]
M1["会员管理 类型/等级/权益/列表"]
M2["积分管理 规则/获取/兑换/对账"]
M3["优惠券管理 活动/列表/使用记录"]
M4["活动管理 展示/满减/秒杀/拼团/审核"]
M5["供应商活动参与 报名/我的活动"]
end
M1 --> M2
M3 --> M4
M4 --> M5
M3 -.->|"成本承担方标记"| F["财务清分结算中心"]
M4 -.->|"库存占用/价格校验"| S["商品供应链中心"]
M4 -.->|"活动ID嵌入"| D["分销中心"]
M3 -.->|"discount_amount"| O["订单履约中心"]
M2 -.->|"积分对账recon_type=6"| F
图7-1:营销中心系统架构与模块关系图
7.2 与已有模块的交互边界
交互模块 交互内容 数据流向 边界说明
商品供应链中心 活动商品库存占用、活动价下限校验(底价保护) 营销中心→供应链(请求库存占用);供应链→营销中心(返回可用库存、校验结果) 活动创建时校验活动价≥底价;秒杀活动预占库存;活动结束释放库存
订单履约中心 优惠金额写入订单、秒杀订单类型标记、拼团成团/退款触发 C端交易系统→订单(写入discount_amount、order_type=2);营销中心→订单(拼团退款触发退券) 优惠券自动匹配在C端交易系统实现;订单仅记录优惠结果
财务清分结算中心 营销成本按承担方扣减、积分对账 营销中心→财务(成本承担方标记随订单传入);财务→营销中心(积分对账数据回传) C端成交价=销售价-优惠券/满减,隐式扣减供应商结算基准价
分销中心 活动ID嵌入推广链接(本期不实现,预留接口) 分销中心→营销中心(预留activity_id参数位) 当前推广链接仅含salesperson_id、product_id、sku_id
商家与店铺管理 供应商创建优惠券时校验商家状态、店铺状态 营销中心→商家管理(校验商家已激活、店铺营业中) 仅已激活商家且店铺营业中可参与活动
权限管理系统 角色鉴权、菜单权限、数据权限 权限系统→营销中心(返回用户角色和权限) 参考基础功能与权限管理PRD
8. 核心业务流程
8.1 营销活动全流程
flowchart TD
A["运营发起营销活动"] --> B{"活动类型"}
B -->|"优惠券"| C1["配置优惠规则 使用范围/发放方式 标记成本承担方"]
B -->|"满减"| C2["配置满减规则 适用商品/门槛/减免额 标记成本承担方"]
B -->|"秒杀"| C3["配置秒杀商品/价格 预热时间/限购规则 防刷策略/底价校验"]
B -->|"拼团"| C4["选择拼团类型 普通/老带新/阶梯 成团人数/价格/有效期"]
B -->|"展示活动"| C5["配置专题页 Banner/商品聚合 无价格优惠"]
C1 --> D["提交审核"]
C2 --> D
C3 --> D
C4 --> D
C5 --> D
D --> E{"审核结果"}
E -->|"通过"| F["发布上线 生成活动页URL"]
E -->|"驳回"| A
F --> G["供应商参与平台活动 查看活动→报名→提交商品→审核"]
G --> H["活动执行与监控"]
H --> I["秒杀:锁定专属库存 防刷拦截"]
H --> J["拼团:用户开团分享 到期未成团自动退款退券"]
H --> K["优惠券:结算页自动匹配 过期自动失效"]
H --> L["满减:订单达标自动减免"]
H --> M["活动数据统计"]
I & J & K & L --> N{"活动结束"}
N -->|"到期自动结束"| O["秒杀未售库存归还总库存"]
N -->|"运营手动结束"| O
O --> P["活动复盘报告"]
图8-1:营销活动全流程(对齐主流程图流程9)
8.2 优惠券成本承担与退款退券流程
flowchart TD
A["用户下单使用优惠券"] --> B["订单写入discount_amount"]
B --> C{"成本承担方"}
C -->|"平台承担"| D1["平台服务费中扣减"]
C -->|"供应商承担"| D2["供应商货款中扣减"]
C -->|"分销商承担"| D3["分销商佣金中扣减"]
D1 & D2 & D3 --> E["订单核销完成 分账时按承担方扣减"]
E --> F{"发生退款?"}
F -->|"整单退款"| G1["优惠券退回用户券包 恢复有效期"]
F -->|"部分退款"| G2["优惠券不退回 按实际支付金额退款"]
G1 --> H["逆向分账 佣金→货款→服务费顺序扣回"]
G2 --> H
图8-2:优惠券成本承担与退款退券流程(对齐订单履约PRD退款规则)
8.3 秒杀库存完整链路
flowchart TD
A["活动开始前 从总库存划拨 秒杀专属库存池"] --> B["用户下单 锁定秒杀库存"]
B --> C{"30min内支付?"}
C -->|"是"| D["库存确认售出"]
C -->|"否"| E["释放回秒杀池"]
D --> F{"活动结束?"}
E --> F
F -->|"是"| G["未售秒杀库存 归还总库存池"]
F -->|"提前结束"| H["已锁定未支付库存 先释放回秒杀池 再归还总库存"]
图8-3:秒杀库存完整链路(对齐主流程图流程9秒杀库存链路)
8.4 会员成长值与等级变更流程
flowchart TD
A["用户消费/签到/评价"] --> B["系统计算成长值增量"]
B --> C["累加至会员成长值总额"]
C --> D{"成长值达到 下一等级阈值?"}
D -->|"是"| E["自动升级会员等级"]
D -->|"否"| F["保持当前等级"]
E --> G["解锁新等级权益"]
G --> H["发送升级通知"]
F --> I{"连续90天无消费?"}
I -->|"是"| J["成长值每日衰减1%"]
I -->|"否"| K["保持成长值"]
J --> L{"成长值低于 当前等级下限?"}
L -->|"是"| M["自动降级"]
L -->|"否"| K
图8-4:会员成长值与等级变更流程
9. 全局规则
规则编号 规则名称 规则内容 对齐说明
MK-001 成本承担方标记机制 每张优惠券和每个满减活动在创建时必须标记成本承担方(平台/供应商/分销商),后续在分账、退款全链路中按此标记扣减对应方资金 对齐主流程图核心设计原则
MK-002 底价保护 营销活动价格不得低于商品底价,活动创建时由商品供应链中心校验拦截(返回LIMIT_BELOW_BASE错误码) 对齐供应链PRD五层价格体系
MK-003 积分不可抵扣订单金额 积分仅用于兑换商品或优惠券,不参与订单金额计算,不影响成交价 对齐订单履约PRD和财务PRD定义
MK-004 整单退款退券、部分退款不退券 整单退款时优惠券退回用户券包并恢复有效期(未过期情况下);部分退款时优惠券不退回 对齐订单履约PRD退款规则
MK-005 退款按实际支付金额计算 退款金额=成交价×数量,已使用优惠券不补发或折现 对齐订单履约PRD退款规则
MK-006 供应商/分销商仅创建自身承担成本的优惠券 供应商只能创建成本由供应商承担的优惠券,且仅适用于自己供应范围内的商品;分销商同理 对齐主流程图规则说明
MK-007 优惠券禁止联合发放 不允许平台与供应商联合发放优惠券,成本承担方必须唯一 对齐订单履约PRD退款规则
MK-008 秒杀订单特殊处理 秒杀订单order_type=2,超时时间可单独配置(如15分钟),可配置不允许自动取消(is_auto_cancel=0) 对齐订单履约PRD数据模型
MK-009 拼团未成团自动退款退券 拼团到期未成团时自动取消并退款,已使用优惠券退回用户券包,已记录的分销商佣金标记作废,库存释放回日历池 对齐主流程图流程5拼团履约
MK-010 活动ID嵌入推广链接(预留) 当前推广链接仅含salesperson_id、product_id、sku_id;本期预留activity_id参数位,后续版本实现营销活动与分销归因联合追踪 对齐分销PRD推广链接参数
MK-011 活动商品分类引用保护 商品分类被活动规则引用时不可删除,需先解除活动引用 对齐供应链PRD分类删除限制
MK-012 会员等级权益次月生效 会员等级变更后新权益次日0点生效(与商家等级"次月1日生效"不同,会员等级更轻量) 差异化于商家等级规则
MK-013 积分对账recon_type=6 积分对账作为财务对账的独立类型,由平台财务与会员运营共同负责 对齐财务PRD对账管理
MK-014 活动数据快照 订单创建时冻结活动价格快照,后续活动调整不影响已创建订单 对齐财务PRD快照结算规则
MK-015 优惠券互斥规则 同一订单中,满减活动与优惠券可叠加使用;不同优惠券之间互斥(一笔订单仅使用一张优惠券);秒杀商品不参与满减活动 主流程图确认可叠加
10. 页面路由
10.1 平台运营后台-营销中心
路由路径 页面名称 所属模块 权限要求
/marketing/member/type 会员类型管理 会员管理 会员运营-读写
/marketing/member/level 会员等级管理 会员管理 会员运营-读写
/marketing/member/benefit 会员权益项管理 会员管理 会员运营-读写
/marketing/member/list 会员列表 会员管理 会员运营-读写
/marketing/member/detail/:id 会员详情 会员管理 会员运营-读写
/marketing/points/rule 积分规则 积分管理 会员运营-读写
/marketing/points/earn-config 获取设置 积分管理 会员运营-读写
/marketing/points/exchange-config 兑换设置 积分管理 会员运营-读写
/marketing/points/earn-record 获取记录 积分管理 会员运营-只读
/marketing/points/exchange-record 兑换记录 积分管理 会员运营-只读
/marketing/points/reconciliation 积分对账 积分管理 会员运营+财务-读写
/marketing/coupon/activity 优惠券活动 优惠券管理 营销专员-读写
/marketing/coupon/list 优惠券列表 优惠券管理 营销专员-读写
/marketing/coupon/usage 使用记录 优惠券管理 营销专员-只读
/marketing/activity/type 活动类型 活动管理 营销专员-读写
/marketing/activity/template 活动模板 活动管理 营销专员-读写
/marketing/activity/showcase 展示活动 活动管理 营销专员-读写
/marketing/activity/full-reduction 满减活动 活动管理 营销专员-读写
/marketing/activity/seckill 秒杀活动 活动管理 营销专员-读写
/marketing/activity/group-buy 拼团活动 活动管理 营销专员-读写
/marketing/activity/audit 活动审核 活动管理 审核员-读写
10.2 供应商后台-营销活动
路由路径 页面名称 权限要求
/supplier/marketing/available 可参与活动 供应商营销专员-读写
/supplier/marketing/mine 我的活动 供应商营销专员-只读
11. 数据模型
11.1 核心实体关系
erDiagram
t_member_type ||--o{ t_member : "分类"
t_member_level ||--o{ t_member : "等级"
t_member_level ||--o{ t_member_benefit : "等级关联权益"
t_member_benefit }o--o{ t_member_level : "权益可跨等级"
t_member ||--o{ t_points_account : "积分账户"
t_points_account ||--o{ t_points_earn_record : "获取记录"
t_points_account ||--o{ t_points_exchange_record : "兑换记录"
t_coupon_template ||--o{ t_coupon_instance : "券模板生成实例"
t_coupon_instance ||--o{ t_coupon_usage_record : "使用记录"
t_activity ||--o{ t_activity_product : "活动商品"
t_activity ||--o{ t_supplier_activity_apply : "供应商报名"
t_seckill_activity ||--|| t_activity : "秒杀活动扩展"
t_group_buy_activity ||--|| t_activity : "拼团活动扩展"
图11-1:营销中心核心实体关系图
11.2 核心数据表
表名 说明 核心字段 与已有PRD对齐
t_member_type 会员类型 id, type_name, type_code, source, status, sort_order, created_at 新增
t_member_level 会员等级 id, level_name, level_code, growth_value_min, growth_value_max, sort_order, status 新增
t_member_benefit 会员权益项 id, benefit_name, benefit_type(discount/free_shipping/birthday_coupon/priority_service), benefit_value, applicable_scope, status 新增
t_member_level_benefit 等级-权益关联表 id, level_id, benefit_id, sort_order 多对多关系
t_member 会员主表 id, user_id, member_type_id, member_level_id, growth_value, total_points, available_points, status, tags, registered_at, last_active_at user_id关联权限系统用户表
t_points_rule 积分规则 id, rule_name, earn_type(sign/order/review/share), earn_value, daily_limit, expire_days, status 新增
t_points_account 积分账户 id, member_id, total_earned, total_consumed, total_expired, available_balance, frozen_balance, version version乐观锁
t_points_earn_record 积分获取记录 id, account_id, rule_id, earn_type, points, biz_id(订单ID/签到日期), status(有效/已撤销), created_at 新增
t_points_exchange_record 积分兑换记录 id, account_id, exchange_type(goods/coupon), target_id, points_cost, status(待发放/已发放/已撤销), created_at 新增
t_coupon_template 优惠券模板 id, coupon_name, coupon_type(full_reduction/discount/voucher), face_value, threshold, discount_rate, valid_type(fixed/relative), valid_start, valid_end, valid_days, total_stock, issued_count, used_count, cost_bearer(platform/supplier/distributor), bearer_id, applicable_scope, status, created_at cost_bearer对齐主流程图
t_coupon_instance 优惠券实例 id, template_id, member_id, coupon_code, status(unused/used/expired/returned/voided), earned_at, used_at, expired_at, order_id order_id关联订单表
t_coupon_usage_record 优惠券使用记录 id, instance_id, action(earn/use/return/void), order_id, amount, operator, created_at 新增
t_activity 活动主表 id, activity_name, activity_type(showcase/full_reduction/seckill/group_buy), activity_type_id, template_id, status(draft/pending_audit/approved/published/ongoing/ended/rejected), start_time, end_time, cost_bearer, bearer_id, applicable_scope, description, created_at 新增
t_activity_type 活动类型配置 id, type_name, type_code, display_type, status, sort_order 新增
t_activity_template 活动模板 id, template_name, activity_type, config_json, page_layout_json, status, created_at 新增
t_activity_product 活动商品 id, activity_id, product_id, sku_id, activity_price, original_price, sort_order, status product_id/sku_id关联供应链
t_seckill_activity 秒杀活动扩展 id, activity_id, seckill_date, time_slots(JSON), stock_pool, locked_count, sold_count, per_user_limit, anti_fraud_config(JSON), payment_timeout_min payment_timeout_min对齐订单PRD
t_group_buy_activity 拼团活动扩展 id, activity_id, group_type(normal/bring_new/tiered), min_members, max_members, group_price, validity_hours, fail_action(auto_refund) 新增
t_supplier_activity_apply 供应商活动报名 id, activity_id, supplier_id, product_ids(JSON), apply_status(pending/approved/rejected/withdrawn), apply_reason, audit_opinion, created_at supplier_id关联商家表
t_activity_data_stat 活动数据统计 id, activity_id, view_count, click_count, order_count, pay_amount, discount_amount, conversion_rate, roi, stat_date discount_amount对齐订单PRD
与已有PRD数据模型对齐说明: 订单履约PRD中t_order表的discount_amount字段记录优惠总额(优惠券+活动减免),t_order_item表的price_snapshot记录扣减优惠后的成交价,order_type=2标记秒杀订单。本PRD的t_coupon_instance.order_id和t_activity_data_stat.discount_amount与这些字段对应。财务PRD中finance_reconciliation_order表的recon_type=6标记积分对账,本PRD的积分对账功能产出数据供财务对账消费。
12. 会员管理功能模块详解
会员管理是营销中心的核心基础模块,负责会员类型定义、等级体系搭建、权益配置以及会员全生命周期管理。本章涵盖会员类型管理、会员等级与成长值、会员权益项管理、会员列表与详情四个功能点,为后续优惠券、积分、活动等营销能力的精准投放提供数据基座。
全局规则约束: 本章所有功能均须遵循以下全局规则——MK-001:积分不可抵扣订单金额,积分仅用于兑换权益或触发等级判定;MK-002:每张券/每个活动必须标记成本承担方(platform/supplier/distributor),权益项中涉及优惠券发放的需明确成本归属;MK-012:会员等级自动升级(成长值达阈值触发),手动降级需填写降级原因并记录操作日志。
9.1 会员类型管理
核心业务逻辑
会员类型管理用于定义平台会员的分类体系,当前系统支持「个人会员」与「企业会员」两大类型。不同会员类型在注册流程中要求的字段不同:个人会员仅需手机号、姓名等基础信息;企业会员需额外提供营业执照号、企业名称、联系人等企业资质字段。会员类型是会员档案(t_member)的外键基础,也是权益配置和营销活动定向投放的筛选维度之一。
平台运营人员可在本功能中对会员类型进行增删改查操作,并支持启用/停用。停用后的会员类型不会出现在新用户注册的类型选择列表中,但已注册的该类型会员不受影响,仍可正常使用。每个会员类型包含类型名称、类型编码、描述三个可编辑字段,其中类型编码在系统内全局唯一,用于后端逻辑识别与第三方对接。
对齐说明: 会员类型与会员等级为正交关系——同一类型下可包含全部等级,类型决定注册字段与资质审核流程,等级决定权益享有的范围。企业会员注册后默认进入审核流程(status=pending),审核通过后方可正常登录使用,个人会员注册即生效。
业务约束: 系统预置的「个人会员」与「企业会员」两个类型不允许删除,仅允许编辑描述信息;用户新建的自定义类型在无关联会员时可删除。停用类型时系统会校验是否有关联的活跃会员,若存在则需二次确认。
交互说明
序号 操作步骤 触发条件 系统行为 预期结果
1 进入会员类型列表页 运营人员点击左侧菜单「会员管理 → 会员类型」 系统查询 t_member_type 表,按 created_at 倒序展示全部类型记录,默认每页20条 列表展示类型名称、类型编码、描述、状态、创建时间及操作列
2 点击「新建会员类型」按钮 运营人员在列表页右上角点击「新建会员类型」按钮 系统弹出新建弹窗,展示类型名称、类型编码、描述三个输入项,类型编码输入框旁显示实时唯一性校验提示 弹窗展示空白表单,所有输入项均为可编辑状态
3 填写类型名称 运营人员在「类型名称」输入框中输入文本 系统实时校验:非空、长度2-20字符、不含特殊符号,失焦时校验是否与已有类型名称重复 校验通过显示绿色勾号,校验失败输入框标红并显示错误提示
4 填写类型编码 运营人员在「类型编码」输入框中输入编码 系统实时校验:非空、仅允许大写字母+下划线、长度2-30字符,失焦时查询 t_member_type 表校验唯一性 编码格式正确且唯一时显示「编码可用」,重复时显示「编码已存在」
5 点击「保存」提交新建 运营人员填写完整后点击弹窗内「保存」按钮 系统执行前端校验→后端二次校验编码唯一性→写入 t_member_type 表(status 默认 enabled)→关闭弹窗→刷新列表 列表顶部出现新建的类型记录,状态为「启用」,页面顶部显示「新建成功」提示
6 点击「编辑」操作 运营人员在列表行操作列点击「编辑」链接 系统弹出编辑弹窗,回填当前类型的类型名称、类型编码、描述字段;系统预置类型的类型编码字段置为只读 弹窗展示回填数据,预置类型编码不可修改,其余字段可编辑
7 点击「停用」操作 运营人员在启用状态的类型行点击「停用」链接 系统查询 t_member 表中 member_type_id 等于当前类型且 status 不等于 cancelled 的会员数量;若数量大于0则弹出二次确认弹窗显示关联会员数,若为0则直接弹出确认弹窗 有关联会员时显示「该类型下有N个活跃会员,停用后新用户不可选择此类型,确认停用?」;无关联时显示「确认停用该会员类型?」
8 确认停用 运营人员在二次确认弹窗中点击「确认」按钮 系统将 t_member_type.status 更新为 disabled,记录操作日志(操作人、操作时间、操作类型、目标ID),刷新列表 该类型状态列显示「停用」标签,操作列变为「启用」「编辑」
9 点击「启用」操作 运营人员在停用状态的类型行点击「启用」链接 系统直接将 t_member_type.status 更新为 enabled,记录操作日志,刷新列表 该类型状态列恢复为「启用」标签,新用户注册时可选该类型
10 点击「删除」操作 运营人员在自定义类型(非预置)行点击「删除」链接 系统查询 t_member 表中该类型下的会员数量;若大于0则阻止删除并提示;若为0则弹出删除确认弹窗 有关联会员时提示「该类型下存在N个会员,不可删除」;无关联时显示「确认删除该会员类型?此操作不可恢复」
原型
https://admin.yunlingxi.com/marketing/member-types
营销中心 / 会员管理 / 会员类型
会员类型管理
+ 新建类型
类型名称 类型编码 描述 状态 创建时间 操作
个人会员 PERSONAL 面向个人消费者的默认会员类型 启用 2025-01-01 00:00:00 编辑
企业会员 ENTERPRISE 面向企业客户,需提供营业执照 启用 2025-01-01 00:00:00 编辑
VIP分销商 VIP_DISTRIBUTOR 平台核心分销渠道会员 停用 2025-03-15 10:30:00 启用 编辑 删除
https://admin.yunlingxi.com/marketing/member-types
营销中心 / 会员管理 / 会员类型
会员类型管理
+ 新建类型
类型名称 类型编码 描述 状态 创建时间 操作
个人会员 PERSONAL 面向个人消费者的默认会员类型 启用 2025-01-01 00:00:00 编辑
企业会员 ENTERPRISE 面向企业客户,需提供营业执照 启用 2025-01-01 00:00:00 编辑
VIP分销商 VIP_DISTRIBUTOR 平台核心分销渠道会员 停用 2025-03-15 10:30:00 启用 编辑 删除
状态说明
状态值 状态名称 触发条件 可执行操作 跳转目标
enabled 启用 新建类型保存成功后默认进入此状态;或停用状态被手动启用 编辑、停用、删除(仅自定义类型) 停用确认弹窗 / 编辑弹窗
disabled 停用 启用状态被手动停用且通过关联会员校验或二次确认 编辑、启用、删除(仅自定义类型且无关联会员) 启用操作直接生效 / 编辑弹窗
—(预置锁定) 系统预置 系统初始化时创建的「个人会员」「企业会员」类型,标识为预置不可删除 编辑(仅描述)、停用、启用 编辑弹窗(编码只读)
—(新建中) 编辑态-新建 点击「新建会员类型」按钮后弹窗打开,尚未保存 保存、取消 保存成功→列表页;取消→关闭弹窗
—(编辑中) 编辑态-修改 点击「编辑」链接后弹窗打开,回填数据,尚未保存 保存、取消 保存成功→列表页;取消→关闭弹窗
—(删除确认) 删除待确认 点击「删除」且通过关联会员校验后弹出删除确认弹窗 确认删除、取消 确认→列表页刷新;取消→关闭弹窗
异常处理
异常场景 触发条件 处理策略 用户提示
类型编码重复 新建或编辑时提交的类型编码在 t_member_type 表中已存在(排除自身记录) 后端返回 409 冲突状态码,前端拦截并阻止表单关闭,保留用户已填数据 「类型编码已存在,请更换后重试」
类型名称重复 新建或编辑时提交的类型名称与已有记录重复(不区分大小写) 后端返回校验失败,前端在类型名称输入框下方标红提示 「该类型名称已存在,请使用其他名称」
停用时有关联会员 对启用状态的类型执行停用操作,且 t_member 表中存在 member_type_id 为该类型且 status≠cancelled 的记录 系统不直接阻止,但弹出二次确认弹窗,显示关联活跃会员数量,需用户手动确认后方可停用 「该类型下有 N 个活跃会员,停用后新用户将无法选择此类型注册,但已有会员不受影响。确认停用?」
删除时有关联会员 对自定义类型执行删除操作,且 t_member 表中存在 member_type_id 为该类型的记录 系统直接阻止删除操作,不弹出确认弹窗,仅显示错误提示 「该类型下存在 N 个会员,无法删除。请先转移或注销相关会员后再操作」
删除系统预置类型 对系统预置的「个人会员」「企业会员」类型执行删除操作 前端隐藏预置类型的删除入口;若通过接口直接调用,后端返回 403 拒绝 「系统预置类型不可删除」
编码格式非法 类型编码包含小写字母、数字、中文或特殊字符(仅允许大写字母和下划线) 前端输入时实时校验,阻止非法字符输入或失焦时标红提示 「类型编码仅支持大写字母和下划线,长度2-30字符,如 PERSONAL、VIP_USER」
9.2 会员等级与成长值
核心业务逻辑
会员等级体系采用5级分层架构:普通会员、白银会员、黄金会员、铂金会员、钻石会员,各等级按成长值区间自低到高划分。成长值是衡量会员活跃度与贡献度的综合指标,会员通过消费行为(每消费1元累计1成长值,以实付金额为准)、每日签到(每次签到+5成长值)、订单评价(每条有效评价+10成长值)等行为累积成长值。
等级升级遵循 MK-012 规则:当会员成长值达到更高等级的成长值下限时,系统自动触发升级,无需人工干预。升级在成长值变更的同一事务中完成,同时更新 t_member.level_id 字段并写入等级变更日志。等级降级仅支持手动操作,运营人员需在会员详情页选择目标等级并填写降级原因(如「违规操作降级」「协商调整」等),系统记录操作人、降级原因、降级时间至操作日志。
成长值区间配置须满足连续无重叠原则:相邻等级的成长值区间首尾相接(如普通 0-999,白银 1000-4999),系统在保存等级配置时自动校验区间是否与已存在的等级区间重叠。每个等级配置包含等级名称、等级编码、成长值下限、成长值上限、排序序号五个字段,排序序号用于列表展示顺序及前端等级图标渲染。
对齐说明: 成长值仅用于等级判定与权益解锁,不可抵扣订单金额(遵循 MK-001 规则)。成长值的消耗场景仅限于「等级降级时清零」或「运营手动扣减」,不存在消费抵扣场景。积分与成长值为独立体系,积分可通过消费获得也可独立使用,但成长值仅作为等级指标。
区间校验规则: 成长值下限必须小于上限;新等级区间不得与任何已启用等级的区间存在交集;修改已有等级区间时,若该等级下已有会员且新区间不再覆盖这些会员的当前成长值,系统将提示需手动处理受影响会员的等级归属。
交互说明
序号 操作步骤 触发条件 系统行为 预期结果
1 进入会员等级列表页 运营人员点击左侧菜单「会员管理 → 会员等级」 系统查询 t_member_level 表,按 sort_order 正序展示全部等级,同时统计每个等级下的会员数量(关联 t_member 表) 列表展示等级名称、编码、成长值区间、排序、会员数、状态、操作列
2 点击「配置等级」按钮 运营人员在列表页右上角点击「配置等级」或某行操作列点击「编辑」 系统弹出等级配置弹窗,展示等级名称、等级编码、成长值下限、成长值上限、排序序号五个输入项 新建时展示空白表单;编辑时回填当前等级数据
3 填写等级名称与编码 运营人员输入等级名称(如「白银会员」)和等级编码(如 SILVER) 系统实时校验名称非空且2-10字符;编码仅大写字母、全局唯一;校验名称是否与已有等级重复 校验通过无提示,失败时输入框标红并显示错误信息
4 填写成长值区间 运营人员输入成长值下限和上限 系统实时校验:下限和上限均为非负整数、下限小于上限、区间不与已启用等级重叠(提交时后端二次校验) 区间合法时无提示;下限≥上限时提示「下限必须小于上限」
5 点击「保存」提交等级配置 运营人员填写完整后点击弹窗「保存」按钮 系统执行前端校验→后端校验编码唯一性与区间重叠→写入/更新 t_member_level 表→关闭弹窗→刷新列表并按 sort_order 重新排序 列表中出现新等级或更新后的等级数据,区间无重叠,页面提示「保存成功」
6 查看各等级会员数 运营人员在列表页查看「会员数」列 系统实时统计 t_member 表中 level_id 等于该等级且 status=normal 的会员数量,展示在对应行 每行会员数列展示当前等级下的活跃会员数量
7 点击「停用」操作 运营人员在启用状态的等级行点击「停用」 系统查询该等级下是否有 status=normal 的会员;若有则提示「该等级下有N个会员,停用后这些会员等级不变但不再自动升级至此等级,确认停用?」;若无则直接确认 确认后等级状态变为 inactive,操作列变为「启用」「编辑」
8 点击「删除」操作 运营人员在等级行点击「删除」 系统查询 t_member 表中 level_id 为该等级的会员数;若大于0则阻止删除并提示;若为0则弹出确认弹窗 有关联会员时提示无法删除;无关联时确认后删除成功
9 手动降级会员等级 运营人员在会员详情页(见9.4)点击「调整等级」→选择「降级」→选择目标等级 系统弹出降级确认弹窗,必填「降级原因」(下拉选择+自定义输入),确认后将 t_member.level_id 更新为目标等级,写入等级变更日志(含操作人、原等级、新等级、原因、时间) 会员等级更新为目标等级,详情页等级标签更新,操作日志中新增一条降级记录
10 系统自动升级会员等级 会员成长值变更(消费/签到/评价)后,系统在事务内判断成长值是否达到更高等级阈值 系统自动查询 t_member_level 表中成长值区间覆盖当前成长值的最高等级,若高于当前等级则更新 t_member.level_id,写入升级日志(触发来源:消费/签到/评价) 会员等级自动提升,C端用户下次登录时看到新等级标签与权益
原型
https://admin.yunlingxi.com/marketing/member-levels
营销中心 / 会员管理 / 会员等级
会员等级管理
+ 配置等级
等级名称 编码 成长值区间 排序 会员数 状态 操作
● 普通会员NORMAL 0 - 999 1 12,580 启用 编辑 停用
● 白银会员SILVER 1,000 - 4,999 2 3,420 启用 编辑 停用
● 黄金会员GOLD 5,000 - 19,999 3 1,860 启用 编辑 停用
● 铂金会员PLATINUM 20,000 - 49,999 4 520 启用 编辑 停用
● 钻石会员DIAMOND 50,000+ 5 86 启用 编辑 停用
https://admin.yunlingxi.com/marketing/member-levels
营销中心 / 会员管理 / 会员等级
会员等级管理
+ 配置等级
等级名称 编码 成长值区间 排序 会员数 状态 操作
● 普通会员NORMAL 0 - 999 1 12,580 启用 编辑 停用
● 白银会员SILVER 1,000 - 4,999 2 3,420 启用 编辑 停用
● 黄金会员GOLD 5,000 - 19,999 3 1,860 启用 编辑 停用
● 铂金会员PLATINUM 20,000 - 49,999 4 520 启用 编辑 停用
● 钻石会员DIAMOND 50,000+ 5 86 启用 编辑 停用
提示:成长值区间不可与已启用等级重叠。最高等级上限建议设为 999,999,999。
https://admin.yunlingxi.com/marketing/member-levels
营销中心 / 会员管理 / 会员等级
会员等级管理
+ 配置等级
等级名称 编码 成长值区间 排序 会员数 状态 操作
● 普通会员NORMAL 0 - 999 1 12,580 启用 编辑 停用
● 白银会员SILVER 1,000 - 4,999 2 3,420 启用 编辑 停用
● 黄金会员GOLD 5,000 - 19,999 3 1,860 启用 编辑 停用
● 铂金会员PLATINUM 20,000 - 49,999 4 520 启用 编辑 停用
● 钻石会员DIAMOND 50,000+ 5 86 启用 编辑 停用
影响说明:降级后会员将失去当前等级的全部权益,且不会自动恢复。成长值不随降级变化,等级变更将记入操作日志。
状态说明
状态值 状态名称 触发条件 可执行操作 跳转目标
active 启用 新建等级保存成功后默认进入;或停用状态被手动启用 编辑、停用、删除(无关联会员时) 编辑弹窗 / 停用确认弹窗 / 删除确认弹窗
inactive 停用 启用状态被手动停用且通过确认;停用后该等级不再参与自动升级判定 编辑、启用、删除(无关联会员时) 编辑弹窗 / 启用直接生效
—(自动升级中) 自动升级事务 会员成长值变更后,系统在事务内判定成长值是否达到更高等级阈值 系统自动执行,无需人工操作 升级成功→更新 t_member.level_id + 写日志;无更高等级→无操作
—(手动降级中) 手动降级待确认 运营人员在会员详情页选择降级目标等级并填写原因后提交 确认降级、取消 确认→更新等级+写日志;取消→关闭弹窗
—(配置编辑中) 等级配置编辑态 点击「配置等级」或「编辑」后弹窗打开 保存、取消 保存成功→列表刷新;取消→关闭弹窗
—(区间冲突待处理) 区间冲突 修改等级成长值区间后,该等级下已有会员的成长值不再落在新区间内 手动调整受影响会员等级或恢复原区间 系统提示受影响会员数量,引导运营人员至会员列表处理
异常处理
异常场景 触发条件 处理策略 用户提示
成长值区间重叠 新建或编辑等级时,成长值区间与已启用等级的区间存在交集(如新等级 1000-5000 与已有等级 3000-8000 重叠) 后端校验失败返回 409,前端拦截并保留用户输入,标红成长值输入框 「成长值区间与已有等级「黄金会员(5000-19999)」重叠,请调整区间后重试」
上限小于等于下限 运营人员输入的成长值上限小于或等于下限 前端实时校验,失焦时标红提示,阻止保存 「成长值上限必须大于下限」
删除有会员的等级 对某等级执行删除操作,且 t_member 表中存在 level_id 为该等级的记录 系统阻止删除,不弹出确认弹窗 「该等级下存在 N 个会员,无法删除。请先将相关会员转移至其他等级」
等级编码重复 新建或编辑时提交的等级编码在 t_member_level 表中已存在 后端返回 409,前端标红编码输入框并提示 「等级编码已存在,请更换后重试」
修改区间导致会员越界 编辑已启用等级的成长值区间后,该等级下部分会员的当前成长值不再落在新区间内 系统在保存时检测受影响会员数量,弹出预警弹窗列出受影响会员数,要求运营人员确认处理方式(手动调整或恢复原区间) 「区间修改后将有 N 个会员的成长值不在该等级区间内,请前往会员列表手动调整这些会员的等级。确认保存?」
手动降级未填原因 运营人员执行手动降级时未选择或填写降级原因 前端校验必填项,阻止提交 「请选择降级原因,降级操作须记录原因以备审计」
9.3 会员权益项管理
核心业务逻辑
会员权益项管理用于定义和配置各会员等级可享受的权益内容。系统支持五类权益项:折扣率(discount_rate,购物时按比例打折)、生日礼券(birthday_coupon,会员生日月自动发放指定优惠券)、优先客服(priority_service,接入优先客服通道)、免邮(free_shipping,订单免除运费)、积分倍率(points_multiplier,消费获积分按倍率加成)。
权益项采用「权益模板 + 等级绑定值」的两层架构:第一层在 t_member_benefit 表中定义权益项的基础信息(权益类型、名称、描述、状态),第二层通过 level_id 字段将权益项绑定到具体会员等级,并设置该等级下的权益值(benefit_value)。同一权益类型可在不同等级绑定不同的权益值,例如折扣率权益在白银等级为 0.95、黄金等级为 0.90、铂金等级为 0.85。权益项可跨等级复用,即一个权益项模板可同时绑定多个等级。
权益项中涉及优惠券发放的(如生日礼券),需遵循 MK-002 规则在权益配置中标记成本承担方(platform/supplier/distributor),确保券成本可追溯。积分倍率权益需遵循 MK-001 规则,积分倍率仅影响积分获取数量,不影响积分用途(积分不可抵扣订单金额)。
对齐说明: 权益项与会员等级为多对多关系。同一等级可绑定多个权益项,同一权益项可绑定多个等级。权益项的 benefit_value 根据权益类型有不同格式要求:折扣率为 0-1 之间的小数(保留2位)、生日礼券为优惠券模板ID、优先客服为布尔值(1/0)、免邮为布尔值(1/0)、积分倍率为正整数(如 2 表示双倍积分)。
绑定唯一性约束: 同一会员等级不允许重复绑定同一类型的权益项。例如黄金等级已绑定折扣率权益后,不可再次添加折扣率权益,但可修改已有绑定的 benefit_value。停用权益项后,该权益对所有等级即时失效。
交互说明
序号 操作步骤 触发条件 系统行为 预期结果
1 进入权益项列表页 运营人员点击左侧菜单「会员管理 → 会员权益」 系统查询 t_member_benefit 表,展示全部权益项,按 benefit_type 分组排列,展示权益名称、类型、描述、绑定等级数、状态、操作 列表展示全部权益项记录,绑定等级数列显示该权益已绑定的等级数量
2 点击「新建权益项」 运营人员点击列表页右上角「新建权益项」按钮 系统弹出新建议弹窗,展示权益类型(下拉选择5种类型)、权益名称、描述三个输入项 弹窗展示空白表单,权益类型下拉可选:折扣率/生日礼券/优先客服/免邮/积分倍率
3 选择权益类型 运营人员在权益类型下拉框中选择一种类型 系统根据所选类型动态展示权益值输入提示:折扣率→输入0-1小数;生日礼券→选择优惠券模板;优先客服/免邮→开关控件;积分倍率→输入正整数 表单动态展示对应类型的权益值输入控件
4 填写权益名称与描述 运营人员输入权益名称(2-20字符)和描述(选填,最多200字符) 系统实时校验名称非空、长度合法、不与已有权益名称重复 校验通过无提示,失败标红提示
5 点击「保存」创建权益项 运营人员填写完整后点击「保存」 系统校验→写入 t_member_benefit 表(status=active,level_id 暂为空表示未绑定)→关闭弹窗→刷新列表 列表中出现新权益项,绑定等级数为0,状态为启用
6 点击「绑定等级」 运营人员在权益项行操作列点击「绑定等级」 系统弹出等级绑定弹窗,左侧展示全部启用等级(勾选框),右侧展示已选等级的权益值输入区 弹窗展示等级列表,已绑定的等级默认勾选并回填权益值
7 勾选等级并设置权益值 运营人员勾选目标等级并输入对应权益值 系统实时校验:同一等级不可重复绑定同一权益类型(编辑时排除自身);权益值格式按类型校验(折扣率0-1、积分倍率正整数等);涉及生日礼券的需选择成本承担方 校验通过无提示,失败标红对应输入框
8 点击「保存绑定」 运营人员设置完所有等级的权益值后点击「保存绑定」 系统批量写入/更新 t_member_benefit 表中该权益项对各等级的绑定记录(level_id + benefit_value),关闭弹窗,刷新列表中绑定等级数 绑定等级数更新为已绑定数量,页面提示「权益绑定成功」
9 点击「停用」权益项 运营人员在启用状态的权益项行点击「停用」 系统弹出确认弹窗:「停用后该权益对所有已绑定等级即时失效,会员将无法享受此权益,确认停用?」 确认后权益项状态变为 inactive,所有等级的该权益即时失效
10 点击「编辑」权益项 运营人员在权益项行点击「编辑」 系统弹出编辑弹窗,回填权益类型(只读不可改)、权益名称、描述字段;权益类型不可修改,仅可修改名称和描述 弹窗回填数据,权益类型置灰只读,名称和描述可编辑
原型
https://admin.yunlingxi.com/marketing/member-benefits
营销中心 / 会员管理 / 会员权益项
会员权益项管理
+ 新建权益项
权益名称
权益类型 全部 折扣率 生日礼券 优先客服 免邮 积分倍率
状态 全部 启用 停用
查询
重置
权益名称 权益类型 描述 已绑定等级数 状态 操作
购物折扣 折扣率 (discount_rate) 订单实付金额按折扣率优惠 4 启用 绑定等级 编辑 停用
生日礼券 生日礼券 (birthday_coupon) 会员生日月自动发放指定优惠券 3 启用 绑定等级 编辑 停用
优先客服 优先客服 (priority_service) 接入VIP专属客服通道 2 启用 绑定等级 编辑 停用
免邮特权 免邮 (free_shipping) 订单免除运费 3 启用 绑定等级 编辑 停用
积分加速 积分倍率 (points_multiplier) 消费获取积分按倍率加成 3 启用 绑定等级 编辑 停用
https://admin.yunlingxi.com/marketing/member-benefits
营销中心 / 会员管理 / 会员权益项
会员权益项管理
+ 新建权益项
权益名称
权益类型 全部 折扣率 生日礼券 优先客服 免邮 积分倍率
状态 全部 启用 停用
查询
重置
权益名称 权益类型 描述 已绑定等级数 状态 操作
购物折扣 折扣率 (discount_rate) 订单实付金额按折扣率优惠 4 启用 绑定等级 编辑 停用
生日礼券 生日礼券 (birthday_coupon) 会员生日月自动发放指定优惠券 3 启用 绑定等级 编辑 停用
优先客服 优先客服 (priority_service) 接入VIP专属客服通道 2 启用 绑定等级 编辑 停用
免邮特权 免邮 (free_shipping) 订单免除运费 3 启用 绑定等级 编辑 停用
积分加速 积分倍率 (points_multiplier) 消费获取积分按倍率加成 3 启用 绑定等级 编辑 停用
权益值设置(折扣率)
提示:折扣率 1.00=原价,0.90=九折,0.85=八五折
遵循 MK-002:若权益类型为「生日礼券」,需额外选择优惠券模板并标记成本承担方(平台/供应商/分销商)。
状态说明
状态值 状态名称 触发条件 可执行操作 跳转目标
active 启用 新建权益项保存成功后默认进入;或停用状态被手动启用 绑定等级、编辑、停用 绑定等级弹窗 / 编辑弹窗 / 停用确认弹窗
inactive 停用 启用状态被手动停用且通过确认;停用后该权益对所有已绑定等级即时失效 编辑、启用 编辑弹窗 / 启用直接生效
—(未绑定) 未绑定等级 新建权益项保存后尚未绑定任何会员等级,level_id 为空 绑定等级、编辑、停用、删除 绑定等级弹窗
—(已绑定) 已绑定等级 权益项已绑定至少一个会员等级,绑定等级数大于0 绑定等级(修改)、编辑、停用 绑定等级弹窗(回填已绑定数据)
—(绑定编辑中) 绑定编辑态 点击「绑定等级」后弹窗打开,正在勾选等级和设置权益值 保存绑定、取消 保存成功→列表刷新;取消→关闭弹窗
—(停用确认中) 停用待确认 点击「停用」后弹出确认弹窗,提示停用影响范围 确认停用、取消 确认→权益即时失效;取消→关闭弹窗
异常处理
异常场景 触发条件 处理策略 用户提示
同一等级重复绑定同一权益类型 在绑定等级弹窗中勾选某等级时,该等级已存在同类型的权益项绑定(编辑时排除自身记录) 前端实时校验,勾选时标红提示该等级已有同类型权益,阻止该等级的权益值保存 「该等级已绑定「折扣率」类型权益,同一等级不可重复绑定同一权益类型。请先解除已有绑定或修改已有权益值」
折扣率权益值格式错误 折扣率权益的 benefit_value 不在 0-1 区间或小数位超过2位 前端实时校验,失焦时标红提示并阻止保存 「折扣率须为0-1之间的小数(保留2位),如 0.90 表示九折,1.00 表示原价」
积分倍率权益值格式错误 积分倍率权益的 benefit_value 不是正整数(如输入0、负数、小数) 前端实时校验,标红提示并阻止保存 「积分倍率须为正整数,如 2 表示双倍积分,3 表示三倍积分」
生日礼券未选优惠券模板 生日礼券权益绑定等级时未选择对应的优惠券模板ID 前端校验必填,阻止保存绑定 「请为该等级选择生日礼券对应的优惠券模板」
生日礼券未标记成本承担方 生日礼券权益绑定等级时未选择成本承担方(违反 MK-002) 前端校验必填,阻止保存绑定 「请选择该生日礼券的成本承担方(平台/供应商/分销商),遵循成本归属规则」
停用权益项时有已绑定等级 对已绑定等级的权益项执行停用操作 系统不阻止停用,但弹出确认弹窗提示影响范围,列出受影响的等级数与会员数 「停用后该权益将对 N 个已绑定等级即时失效,约影响 M 名会员。确认停用?」
9.4 会员列表与详情
核心业务逻辑
会员列表与详情是运营人员管理会员档案的核心入口。列表页支持多维度筛选查询,包括会员类型(个人/企业)、会员等级(普通/白银/黄金/铂金/钻石)、手机号(精确匹配)、注册时间(时间段)、会员状态(正常/冻结/注销)五个筛选条件。查询结果以分页表格展示,每页默认20条,支持按注册时间、成长值、累计消费金额排序。
点击列表行进入会员详情页,详情页采用多Tab布局展示:基本信息Tab(姓名、手机号、邮箱、类型、等级、成长值、累计消费、注册时间、状态)、消费记录Tab(关联订单列表,含订单号、金额、时间、状态)、优惠券记录Tab(持有券列表,含券名称、面额、状态、到期时间)、积分记录Tab(积分获取与消耗流水,遵循 MK-001 积分不可抵扣订单金额)、等级变更日志Tab(自动升级与手动降级记录)。
运营人员可在详情页执行两项关键操作:手动调整成长值和冻结/解冻会员。手动调整成长值需在弹窗中选择调整类型(增加/扣减)、输入调整数量、填写调整原因(必填),系统在调整后重新判定会员等级是否需自动升级(遵循 MK-012),若成长值达到更高等级阈值则自动升级,若扣减后低于当前等级下限则保持当前等级不变(等级不自动降级,仅手动降级)。调整操作记录至成长值变更日志。冻结会员后,该会员无法登录下单但保留全部数据;解冻后恢复正常。
对齐说明: 手动调整成长值后,若成长值增加达到更高等级阈值,系统自动升级等级(MK-012 自动升级规则);若成长值扣减后低于当前等级下限,等级不自动降级,需运营人员手动降级(MK-012 手动降级规则)。成长值变更日志须记录操作人、调整前成长值、调整后成长值、调整原因、是否触发等级变更。
操作权限约束: 手动调整成长值和冻结/解冻会员操作仅限「运营管理员」角色执行,「运营专员」角色仅可查看。所有操作均写入审计日志,包含操作人ID、操作时间、操作类型、目标会员ID、变更前后数据。
交互说明
序号 操作步骤 触发条件 系统行为 预期结果
1 进入会员列表页 运营人员点击左侧菜单「会员管理 → 会员列表」 系统默认查询 t_member 表全部 status=normal 的会员,按 register_at 倒序展示,每页20条 列表展示会员姓名、手机号、类型、等级、成长值、累计消费、注册时间、状态、操作列
2 设置筛选条件查询 运营人员在列表上方筛选区选择会员类型/等级/状态,输入手机号,选择注册时间区间,点击「查询」 系统根据筛选条件组合查询 t_member 表,关联 t_member_type 和 t_member_level 展示类型名称和等级名称,返回分页结果 列表展示符合筛选条件的会员记录,分页器更新总条数
3 点击列表行进入详情 运营人员点击某行会员记录 系统跳转至会员详情页,默认展示「基本信息」Tab,查询 t_member 表关联类型和等级信息 详情页展示会员基本信息,顶部显示姓名、等级标签、状态标签
4 切换Tab查看消费记录 运营人员点击「消费记录」Tab 系统查询该会员关联的订单列表,按订单创建时间倒序展示,每页10条 Tab内容区展示订单表格:订单号、商品、金额、下单时间、订单状态
5 切换Tab查看优惠券记录 运营人员点击「优惠券记录」Tab 系统查询该会员持有的优惠券列表,按领取时间倒序展示 Tab内容区展示券列表:券名称、面额、状态(未使用/已使用/已过期)、到期时间、来源
6 切换Tab查看积分记录 运营人员点击「积分记录」Tab 系统查询该会员的积分流水记录,按时间倒序展示,含获取/消耗类型和数量 Tab内容区展示积分流水表格,顶部汇总当前积分余额(注:积分不可抵扣订单金额 MK-001)
7 点击「调整成长值」 运营人员在详情页基本信息Tab点击「调整成长值」按钮(仅运营管理员可见) 系统弹出成长值调整弹窗,展示当前成长值、调整类型(增加/扣减单选)、调整数量输入框、调整原因(必填) 弹窗展示当前成长值,调整类型默认选中「增加」
8 填写调整信息并提交 运营人员选择调整类型、输入数量、填写原因后点击「确认调整」 系统校验:调整数量为正整数、原因非空→更新 t_member.growth_value→判定是否触发自动升级(MK-012)→写入成长值变更日志和等级变更日志(若升级)→刷新详情页 成长值更新,若触发升级则等级标签同步更新,页面提示「成长值调整成功,会员等级已升级至XX」或「成长值调整成功」
9 点击「冻结」操作 运营人员在详情页点击「冻结」按钮(仅运营管理员可见,且会员状态为 normal) 系统弹出冻结确认弹窗,必填「冻结原因」(下拉选择+自定义输入),确认后更新 t_member.status=frozen,写入操作日志,C端用户登录时提示账号已冻结 会员状态变为「冻结」,操作按钮变为「解冻」,页面提示「冻结成功」
10 点击「解冻」操作 运营人员在详情页点击「解冻」按钮(会员状态为 frozen) 系统弹出解冻确认弹窗,确认后更新 t_member.status=normal,写入操作日志,会员可正常登录 会员状态恢复为「正常」,操作按钮变为「冻结」,页面提示「解冻成功」
11 切换Tab查看等级变更日志 运营人员点击「等级变更日志」Tab 系统查询该会员的等级变更记录,按时间倒序展示,含变更类型(自动升级/手动降级)、原等级、新等级、触发原因、操作人、时间 Tab内容区展示等级变更日志表格
原型
https://admin.yunlingxi.com/marketing/members
营销中心 / 会员管理 / 会员列表
会员列表
导出
会员姓名 手机号 类型 等级 成长值 累计消费 注册时间 状态 操作
张三 138****8888 个人会员 黄金会员 8,520 ¥8,520.00 2025-02-15 正常 详情
李四 139****6666 企业会员 铂金会员 35,200 ¥35,200.00 2025-01-10 正常 详情
王五 137****1234 个人会员 普通会员 320 ¥320.00 2025-06-01 冻结 详情
赵六 136****5555 企业会员 白银会员 2,150 ¥2,150.00 2025-03-20 正常 详情
孙七 135****7777 个人会员 钻石会员 65,300 ¥65,300.00 2024-11-05 正常 详情
https://admin.yunlingxi.com/marketing/members/10086
营销中心 / 会员管理 / 会员列表 / 会员详情
基本信息
消费记录
优惠券
积分记录
等级日志
成长值构成
消费成长值:8,200(占比 96.2%)
签到成长值:240(占比 2.8%)
评价成长值:80(占比 0.9%)
手动调整:+0
距下一等级
还需 11,480 成长值升级至铂金会员
提示:积分不可抵扣订单金额(MK-001)。成长值达到更高等级阈值时系统自动升级,等级降级需手动操作并填写原因(MK-012)。
https://admin.yunlingxi.com/marketing/members/10086
营销中心 / 会员管理 / 会员列表 / 会员详情
基本信息
消费记录
优惠券
积分记录
等级日志
成长值构成
消费成长值:8,200(占比 96.2%)
签到成长值:240(占比 2.8%)
评价成长值:80(占比 0.9%)
手动调整:+0
距下一等级
还需 11,480 成长值升级至铂金会员
提示:积分不可抵扣订单金额(MK-001)。成长值达到更高等级阈值时系统自动升级,等级降级需手动操作并填写原因(MK-012)。
提示:若调整后成长值达到更高等级阈值(铂金 20,000),系统将自动升级等级(MK-012)。扣减后低于当前等级下限时等级不变,需手动降级。
https://admin.yunlingxi.com/marketing/members/10086
营销中心 / 会员管理 / 会员列表 / 会员详情
基本信息
消费记录
优惠券
积分记录
等级日志
成长值构成
消费成长值:8,200(占比 96.2%)
签到成长值:240(占比 2.8%)
评价成长值:80(占比 0.9%)
手动调整:+0
距下一等级
还需 11,480 成长值升级至铂金会员
提示:积分不可抵扣订单金额(MK-001)。成长值达到更高等级阈值时系统自动升级,等级降级需手动操作并填写原因(MK-012)。
影响说明:冻结后该会员将无法登录和下单,但保留全部数据。解冻后可恢复正常使用。操作将记入审计日志。
状态说明
状态值 状态名称 触发条件 可执行操作 跳转目标
normal 正常 会员注册审核通过后默认进入此状态;或冻结状态被手动解冻 查看详情、调整成长值、冻结 详情页 / 成长值调整弹窗 / 冻结确认弹窗
frozen 冻结 正常状态被运营人员手动冻结(需填写冻结原因);冻结后C端无法登录下单 查看详情、解冻 详情页 / 解冻确认弹窗
cancelled 注销 会员在C端主动注销账号,或运营人员执行注销操作;注销后数据保留但不可恢复为正常 查看详情(只读) 详情页(只读模式,无操作按钮)
—(成长值调整中) 成长值调整态 运营人员在详情页点击「调整成长值」后弹窗打开 确认调整、取消 确认→更新成长值+判定升级+写日志;取消→关闭弹窗
—(自动升级触发) 自动升级事务 成长值调整后(增加)达到更高等级阈值,系统在事务内自动执行等级升级 系统自动执行,无需人工操作 升级成功→更新 level_id + 写等级变更日志
—(冻结确认中) 冻结待确认 点击「冻结」后弹出确认弹窗,需填写冻结原因 确认冻结、取消 确认→状态变为 frozen;取消→关闭弹窗
异常处理
异常场景 触发条件 处理策略 用户提示
调整后成长值超出等级区间 手动增加成长值后,新成长值超过当前最高等级(钻石会员)的上限,或扣减后成长值为负数 系统对成长值上限不做硬性限制(钻石等级上限设为极大值),但扣减后成长值不可小于0,系统自动截断为0并提示 「成长值扣减后不可小于0,系统已将成长值调整为0。当前等级维持不变,如需降级请手动操作」
调整成长值未填原因 运营人员提交成长值调整时未选择或填写调整原因 前端校验必填项,阻止提交 「请选择调整原因,成长值调整操作须记录原因以备审计」
调整数量非正整数 运营人员输入的调整数量为0、负数或小数 前端实时校验,标红输入框并阻止提交 「调整数量须为正整数,请重新输入」
冻结已注销会员 对 status=cancelled 的会员执行冻结操作 系统隐藏冻结按钮;若通过接口调用,后端返回 403 拒绝 「该会员已注销,无法执行冻结操作」
手机号格式校验失败 筛选查询时输入的手机号不符合11位数字格式 前端实时校验,失焦时标红提示,允许查询但提示格式可能不正确 「手机号格式不正确,请输入11位数字。系统仍将尝试精确匹配」
冻结会员尝试下单 status=frozen 的会员在C端尝试登录或下单 C端拦截登录请求,返回账号冻结状态,不允许进入下单流程 C端提示:「您的账号已被冻结,如有疑问请联系客服。冻结原因:XXX」
13. 积分管理功能模块详解
积分管理是营销中心的核心子模块之一,负责积分规则的配置、获取与兑换场景的参数管理、积分流水记录的查询追踪,以及积分发放与消耗的对账核验。积分体系遵循全局规则 MK-001(积分不可抵扣订单金额,仅可兑换优惠券和商品)和 MK-009(积分对账以 recon_type=6 标识,对账产出数据供财务中心消费),确保积分流转在业务、财务、订单三方链路中对齐一致。
数据模型总览: t_points_rule(积分规则表)、t_points_account(积分账户表)、t_points_record(积分流水表)。积分账户记录会员余额(balance)、累计获取(total_earned)、累计消耗(total_used);积分流水以正数表示获取、负数表示消耗,每笔流水记录变动后余额(balance_after)及关联订单(order_id)。
9.5 积分规则
核心业务逻辑
积分规则是积分体系的底层配置入口,用于定义会员在系统中执行特定行为时获取积分的发放标准。系统支持五类积分获取行为:消费得积分(action_type=purchase)、签到得积分(action_type=sign_in)、评价得积分(action_type=review)、注册得积分(action_type=register)、分享得积分(action_type=share)。每条规则包含四个核心字段:行为类型(action_type)、积分值(points_value)、每日上限(daily_limit)、状态(status)。消费积分以"1元=1积分"为基准换算,运营可配置倍率调整实际发放比例(倍率配置在 9.6 获取设置中管理)。每类行为类型全局仅允许存在一条生效规则,新建时系统自动校验行为类型唯一性。签到、评价、注册、分享类行为积分值为固定值(每次行为发放固定积分),消费类行为按订单实付金额乘以倍率计算。
对齐说明: 遵循 MK-001 约束——积分不可抵扣订单金额,消费积分按订单实付金额(扣除优惠券、满减等优惠后的实际支付金额)计算,不按订单原价计算。规则停用后不影响已发放积分,仅停止新的积分发放。消费积分发放需在订单完成且无退款后触发,退款时按订单 PRD 约定扣回已发放积分。
交互说明
序号 操作步骤 触发条件 系统行为 预期结果
1 进入积分规则列表页 用户点击左侧导航"积分管理 > 积分规则" 系统查询 t_points_rule 表全量数据,按 created_at 倒序排列,分页展示(每页10条) 页面展示规则列表表格,包含规则名称、行为类型、积分值、每日上限、状态、操作列
2 点击"新建规则"按钮 用户点击列表页右上角"新建规则"按钮 系统弹出新建规则弹窗,展示表单:行为类型(下拉)、积分值(数值输入)、每日上限(数值输入)、状态(单选开关);行为类型下拉框仅展示未被已启用规则占用的类型 弹窗展示空白表单,已被占用的行为类型在下拉框中显示为"已配置"且不可选
3 选择行为类型 用户点击行为类型下拉框展开选项 系统展示可选行为类型列表:消费得积分(purchase)、签到得积分(sign_in)、评价得积分(review)、注册得积分(register)、分享得积分(share);若该类型已存在 enabled 状态规则则标记禁用并提示"该行为类型已配置生效规则" 用户仅可选择未配置或已停用的行为类型
4 填写积分值 用户在积分值输入框中输入数值 系统实时校验:积分值必须为正整数(≥1);选择 purchase 类型时输入框下方提示"消费积分按实付金额×倍率计算,倍率请在获取设置中配置" 输入合法值时校验通过;输入 0 或负数时输入框标红并提示"积分值必须为正整数"
5 填写每日上限 用户在每日上限输入框中输入数值 系统实时校验:每日上限必须为≥0 的整数,0 表示不限制;选择 register 类型时自动锁定每日上限为 1 且不可修改;选择 purchase 类型时提示"消费积分按订单实付金额计算,建议设置每日上限防止刷分" 输入合法值时校验通过;输入负数时标红提示"每日上限不能为负数"
6 点击"保存"按钮 用户填写完整表单后点击弹窗底部"保存"按钮 系统执行前端校验 + 后端二次校验(行为类型唯一性、积分值正整数、每日上限非负),通过后写入 t_points_rule 表,status 默认为 enabled,记录 created_at 弹窗关闭,列表刷新并高亮新增行,页面顶部 Toast 提示"规则创建成功"
7 编辑已有规则 用户点击列表行操作列"编辑"链接 系统弹出编辑弹窗,回填当前规则数据;行为类型字段设为只读(不可修改),可修改积分值、每日上限、状态 弹窗展示已有规则数据,行为类型灰色只读,其余字段可编辑
8 启用/停用规则 用户点击列表状态列的开关组件切换状态 系统弹出二次确认框:"确认停用该规则?停用后该行为将停止发放积分,已发放积分不受影响";用户确认后更新 t_points_rule.status 字段并刷新缓存 状态标签实时更新(启用/停用),Toast 提示"操作成功";停用后该行为类型在新建规则时可被重新选择
9 搜索与分页 用户在搜索框输入规则名称关键字或点击分页器 系统按 rule_name 模糊匹配查询 t_points_rule,返回对应页数据,更新分页器总条数 列表展示筛选结果,分页器更新页码和总条数
10 查看规则详情 用户点击列表行操作列"详情"链接 系统弹出详情弹窗,展示规则完整信息:规则ID、规则名称、行为类型、积分值、每日上限、状态、创建时间、最后修改时间 弹窗以只读形式展示规则所有字段
原型
https://admin.yunlingxi.com/marketing/points-rules
营销中心 / 积分管理 / 积分规则
积分规则管理
+ 新建规则
规则名称
行为类型 全部 消费 签到 评价 注册 分享
状态 全部 启用 停用
查询
重置
规则名称 行为类型 积分值 每日上限 状态 操作
消费得积分 消费 1积分/元 不限 启用 编辑 停用
签到得积分 签到 5积分/次 1次/天 启用 编辑 停用
评价得积分 评价 10积分/次 5次/天 启用 编辑 停用
注册得积分 注册 100积分/次 1次(锁定) 启用 编辑 停用
分享得积分 分享 3积分/次 3次/天 停用 编辑 启用
状态说明
状态值 状态名称 触发条件 可执行操作 跳转目标
enabled 启用 新建规则保存成功 / 停用规则重新启用 编辑、停用、查看详情 编辑弹窗 / 详情弹窗
disabled 停用 用户手动停用启用中的规则 编辑、启用、查看详情 编辑弹窗 / 详情弹窗
creating 创建中 用户点击"新建规则"按钮,弹窗打开未保存 填写表单、保存、取消 保存后→规则列表
editing 编辑中 用户点击"编辑"链接,编辑弹窗打开未保存 修改字段、保存、取消 保存后→规则列表
pending_confirm 待确认 用户切换启用/停用状态,二次确认框弹出 确认、取消 确认后→enabled/disabled
synced 已生效 规则保存或状态切换后,系统将规则同步至缓存节点,实际开始/停止积分发放 编辑、停用/启用 规则列表
异常处理
异常场景 触发条件 处理策略 用户提示
行为类型重复 新建规则时选择的 action_type 已存在 enabled 状态规则 后端校验 t_points_rule 中该 action_type 是否已有 enabled 记录,若存在则拒绝写入,返回错误码 "该行为类型已存在生效规则,请先停用原规则或选择其他行为类型"
积分值为0或负数 用户在积分值输入框输入 0 或负数 前端实时校验拦截,后端二次校验 points_value ≥ 1,不通过则拒绝保存 "积分值必须为正整数,请重新输入"
每日上限为负数 用户在每日上限输入框输入负数 前端实时校验拦截,后端二次校验 daily_limit ≥ 0,不通过则拒绝保存 "每日上限不能为负数,0表示不限制"
规则名称为空 用户未填写规则名称即点击保存 前端校验 rule_name 非空,后端校验 rule_name 长度 1-50 字符 "请输入规则名称(1-50字符)"
网络超时 保存或状态切换时网络中断 前端请求超时(15s),自动重试1次,仍失败则保留弹窗数据不丢失,提示用户重试 "网络异常,请稍后重试"
并发修改冲突 两个用户同时编辑同一条规则并保存 后端基于 updated_at 乐观锁校验,检测到版本不一致则拒绝后提交的请求 "该规则已被其他用户修改,请刷新后重试"
9.6 获取设置
核心业务逻辑
获取设置用于配置积分获取场景的具体参数,是积分规则的细化扩展层。在 9.5 积分规则中定义了行为类型和基础积分值后,获取设置针对每个行为类型配置更精细的发放规则。主要配置项包括:(1)消费积分倍率:默认 1.0 倍,可按商品类目设置不同倍率(如酒店类目 1.2 倍、门票类目 0.8 倍),消费积分 = 实付金额 × 类目倍率,向上取整;(2)签到积分递增规则:连续签到每天积分递增 +1,首日 5 分,次日 6 分……上限 10 分/天,断签后重新从 5 分开始;(3)评价积分分级:纯文字评价 10 分,图文评价 20 分,追加评价 5 分;(4)注册赠送积分:新会员注册成功后一次性发放,默认 100 分;(5)生日双倍积分:会员生日当天所有积分获取按 2 倍计算(含消费、签到、评价、分享),生日双倍仅当天有效。
对齐说明: 获取设置依赖 9.5 积分规则中对应行为类型处于 enabled 状态方可生效。若积分规则停用,则对应获取设置自动失效但不修改其自身状态字段。消费积分倍率配置需与订单 PRD 对齐——按订单实付金额(扣除优惠后)计算,退款时按实退金额比例扣回已发放积分。生日双倍积分与倍率叠加时,实际倍率 = 类目倍率 × 2。
交互说明
序号 操作步骤 触发条件 系统行为 预期结果
1 进入获取设置列表页 用户点击左侧导航"积分管理 > 获取设置" 系统加载所有积分获取场景配置项,按行为类型分组展示,每组展示场景名称/规则参数/倍率或分值/上限/状态 页面展示分组列表,包含消费积分倍率、签到递增、评价分级、注册赠送、生日双倍等配置项
2 编辑消费积分倍率 用户点击"消费积分倍率"行的"编辑"按钮 系统弹出编辑弹窗,展示倍率配置表格:类目名称、倍率值、状态;支持新增类目倍率行、修改倍率值 弹窗展示当前所有类目倍率配置,默认行包含"全部类目 默认1.0",可新增按类目覆盖
3 新增类目倍率 用户在倍率编辑弹窗中点击"新增类目倍率"按钮 系统新增一行空白倍率配置,包含类目选择下拉框(从商品类目字典加载)、倍率输入框、删除按钮 新增行展示类目选择和倍率输入,用户可选择具体类目并输入倍率
4 编辑签到递增规则 用户点击"签到积分递增"行的"编辑"按钮 系统弹出编辑弹窗,展示:首日积分值、每日递增值、单日上限、连续签到最大天数限制 弹窗回填当前配置,用户可修改递增参数
5 编辑评价积分分级 用户点击"评价积分分级"行的"编辑"按钮 系统弹出编辑弹窗,展示:文字评价积分、图文评价积分、追加评价积分,三个独立输入框 弹窗回填当前配置,用户可修改各级评价积分值
6 编辑注册赠送积分 用户点击"注册赠送积分"行的"编辑"按钮 系统弹出编辑弹窗,展示注册赠送积分值输入框(默认100),下方提示"新会员注册成功后一次性发放" 弹窗回填当前积分值,用户可修改
7 编辑生日双倍积分 用户点击"生日双倍积分"行的"编辑"按钮 系统弹出编辑弹窗,展示生日双倍开关、生效范围(全部行为类型多选)、提示说明 弹窗展示开关和生效范围,用户可开启/关闭并选择生效行为
8 保存配置 用户在任意编辑弹窗中点击"保存"按钮 系统校验所有字段合法性(倍率>0、递增值≥0、积分值≥1),通过后更新配置并刷新缓存,记录修改日志 弹窗关闭,列表刷新展示新配置,Toast 提示"配置保存成功"
9 启用/停用场景配置 用户点击场景配置行的状态开关 系统弹出确认框,确认后更新该场景配置状态;停用后该场景不再发放积分 状态标签更新,Toast 提示"操作成功"
10 查看修改日志 用户点击场景配置行的"日志"链接 系统弹出日志弹窗,展示该配置的历史修改记录:修改人、修改时间、修改前值、修改后值 弹窗以时间线形式展示配置变更历史
原型
https://admin.yunlingxi.com/marketing/points-earn-settings
营销中心 / 积分管理 / 获取设置
积分获取设置
场景 规则说明 倍率或分值 上限 状态 操作
消费积分倍率 按商品类目配置倍率 默认1.0 / 酒店1.2 / 门票0.8 — 启用 编辑 日志
签到积分递增 连续签到每天+1 首日5 / 递增+1 单日上限10 启用 编辑 日志
评价积分分级 文字/图文/追加分级 文字10 / 图文20 / 追加5 5次/天 启用 编辑 日志
注册赠送积分 新会员注册一次性发放 100积分 1次 启用 编辑 日志
生日双倍积分 生日当天所有积分×2 ×2 仅生日当天 启用 编辑 日志
状态说明
状态值 状态名称 触发条件 可执行操作 跳转目标
enabled 启用 场景配置保存且对应积分规则处于 enabled 状态 编辑、停用、查看日志 编辑弹窗 / 日志弹窗
disabled 停用 用户手动停用场景配置 编辑、启用、查看日志 编辑弹窗 / 日志弹窗
inactive 未生效 场景配置为 enabled 但对应 9.5 积分规则已停用 编辑、查看日志 编辑弹窗(提示需启用积分规则)
editing 编辑中 用户点击编辑按钮,弹窗打开未保存 修改参数、保存、取消 保存后→场景列表
pending_confirm 待确认 用户切换启用/停用状态,二次确认框弹出 确认、取消 确认后→enabled/disabled
synced 已同步 配置保存后系统将参数同步至缓存节点,实际开始按新参数发放积分 编辑、停用 场景列表
异常处理
异常场景 触发条件 处理策略 用户提示
倍率为0或负数 用户在消费积分倍率输入框中输入 0 或负数 前端实时校验拦截,后端二次校验倍率必须 > 0,不通过则拒绝保存 "倍率必须为正数,请重新输入"
签到递增上限配置冲突 用户设置的单日上限 < 首日积分值,或每日递增值为负数 前端校验:单日上限 ≥ 首日积分值、每日递增值 ≥ 0;后端二次校验 "单日上限不能小于首日积分值,每日递增值不能为负数"
评价积分分值为0或负数 用户在评价积分输入框输入 0 或负数 前端校验拦截,后端二次校验各级评价积分 ≥ 1 "评价积分值必须为正整数"
类目倍率重复配置 用户新增类目倍率时选择了已配置的类目 前端校验同一类目不可重复配置倍率,后端二次校验唯一性 "该类目已存在倍率配置,请直接编辑已有配置"
依赖积分规则未启用 用户启用获取设置但对应的 9.5 积分规则处于 disabled 状态 系统允许保存获取设置为 enabled,但实际状态显示为 inactive(未生效),并提示需先启用积分规则 "该场景对应的积分规则未启用,当前配置暂未生效,请先在积分规则中启用对应行为类型"
生日双倍与倍率叠加溢出 生日双倍倍率 × 类目倍率后积分值超过系统单笔上限(99999) 系统自动对单笔积分发放做上限截断,实际发放取 min(计算值, 99999),并记录截断日志 运营端无提示(自动截断),日志中记录"生日双倍叠加后截断"
9.7 兑换设置
核心业务逻辑
兑换设置用于配置积分兑换选项,是积分消耗的核心配置入口。系统支持两类兑换方式:(1)兑换优惠券:运营设置所需积分、关联的券模板、每人兑换上限、总兑换上限,会员使用积分兑换后获得对应优惠券;(2)兑换商品:运营设置所需积分、关联的商品 SKU、可用库存,会员兑换后扣减库存并生成兑换订单。兑换比例由运营自由配置(不同兑换项可设置不同所需积分)。积分兑换后即时扣减 t_points_account.balance,同时在 t_points_record 中生成负数流水记录(points 为负数),关联兑换记录ID。兑换设置与券模板、商品库存联动——券模板下线或商品库存为 0 时,兑换项自动标记为不可兑换。
对齐说明: 遵循 MK-001——积分不可抵扣订单金额,但可兑换优惠券和商品。兑换优惠券后获得的优惠券可用于后续订单抵扣(券的使用规则由券模板定义),但积分本身不参与订单结算。兑换商品不生成交易订单(order_id 为空),仅生成积分兑换记录。兑换产生的积分消耗流水参与 9.10 积分对账(recon_type=6)的消耗统计。
交互说明
序号 操作步骤 触发条件 系统行为 预期结果
1 进入兑换设置列表页 用户点击左侧导航"积分管理 > 兑换设置" 系统加载所有兑换项配置,按创建时间倒序分页展示(每页10条),展示兑换类型/兑换目标/所需积分/兑换上限/状态 页面展示兑换项列表表格,支持按兑换类型(优惠券/商品)筛选
2 点击"新建兑换项"按钮 用户点击页面右上角"新建兑换项"按钮 系统弹出新建弹窗,展示表单:兑换类型(单选:优惠券/商品)、兑换目标(根据类型动态切换)、所需积分、每人兑换上限、总兑换上限、状态 弹窗展示空白表单,兑换类型默认选中"优惠券"
3 选择兑换类型为"兑换优惠券" 用户选择兑换类型为"优惠券" 系统动态展示券模板选择下拉框(从券模板管理加载 enabled 状态的模板列表),选择后展示券面值、券有效期等摘要信息 用户可选择券模板,页面展示选中券模板的摘要信息
4 选择兑换类型为"兑换商品" 用户选择兑换类型为"商品" 系统动态展示商品选择搜索框(从商品中心加载在售商品列表),选择后展示商品名称、当前库存、商品图片缩略图 用户可搜索选择商品,页面展示选中商品的摘要信息
5 填写所需积分 用户在所需积分输入框中输入数值 系统实时校验:所需积分必须为正整数(≥1),并在下方展示预估兑换比例提示(如"100积分兑换1张5元券") 输入合法值时校验通过,输入 0 或负数时标红提示
6 填写兑换上限 用户填写每人兑换上限和总兑换上限 系统校验:每人兑换上限和总兑换上限为≥1 的正整数,总兑换上限须≥每人兑换上限 输入合法值时校验通过
7 点击"保存"按钮 用户填写完整后点击保存 系统校验所有字段(兑换类型非空、兑换目标非空、所需积分正整数、上限合法),通过后写入兑换设置表,status 默认为 enabled,同步至缓存 弹窗关闭,列表刷新展示新增兑换项,Toast 提示"兑换项创建成功"
8 编辑兑换项 用户点击列表行操作列"编辑"链接 系统弹出编辑弹窗,回填当前数据;兑换类型不可修改,可修改所需积分、兑换上限、状态 弹窗展示已有数据,兑换类型灰色只读
9 启用/停用兑换项 用户点击状态列开关切换 系统弹出确认框,确认后更新状态;停用后前端兑换入口不展示该项 状态标签更新,Toast 提示"操作成功"
10 查看兑换统计 用户点击列表行"统计"链接 系统弹出统计弹窗,展示该兑换项的累计兑换次数、累计消耗积分、剩余兑换额度 弹窗展示兑换统计数据
原型
https://admin.yunlingxi.com/marketing/points-exchange-settings
营销中心 / 积分管理 / 兑换设置
积分兑换设置
+ 新建兑换项
兑换类型 全部 优惠券 商品
状态 全部 启用 停用
查询
重置
兑换项名称 类型 目标 所需积分 兑换上限 状态 操作
兑换优惠券-满100减10券 优惠券 满100减10券 1,000 每人3张 / 总10,000张 启用 编辑 停用
兑换优惠券-新人券 优惠券 5元无门槛券 500 每人1张 / 总5,000张 启用 编辑 停用
兑换商品-旅行保温杯 商品 旅行保温杯 3,000 每人1个 / 总500个 启用 编辑 停用
兑换商品-定制行李牌 商品 定制行李牌 800 每人2个 / 总2,000个 库存不足 编辑 停用
状态说明
状态值 状态名称 触发条件 可执行操作 跳转目标
enabled 启用 新建兑换项保存成功 / 停用项重新启用 编辑、停用、查看统计 编辑弹窗 / 统计弹窗
disabled 停用 用户手动停用启用中的兑换项 编辑、启用、查看统计 编辑弹窗 / 统计弹窗
out_of_stock 库存不足 关联商品库存为 0 或关联券模板剩余可发放量不足 编辑、查看统计 编辑弹窗(提示补充库存)
target_offline 目标已下线 关联的券模板被下线或商品被下架 编辑(更换目标)、停用 编辑弹窗
exhausted 已兑完 总兑换次数达到总兑换上限 编辑(调整上限)、查看统计 编辑弹窗 / 统计弹窗
synced 已生效 兑换项保存后同步至缓存,前端兑换入口可展示该项 编辑、停用 兑换设置列表
异常处理
异常场景 触发条件 处理策略 用户提示
兑换所需积分为0或负数 用户在所需积分输入框输入 0 或负数 前端实时校验拦截,后端二次校验所需积分 ≥ 1,不通过则拒绝保存 "所需积分必须为正整数,请重新输入"
关联券模板已下线 用户选择的券模板状态为已下线或已被删除 前端券模板下拉框不展示已下线模板;后端校验券模板状态,若非 enabled 则拒绝保存 "所选券模板已下线,请重新选择有效的券模板"
商品库存不足 用户关联的商品当前库存为 0 前端允许保存但状态自动设为 out_of_stock;后端记录库存状态,兑换时不允许下单 "该商品当前库存为0,兑换项已创建但暂时不可兑换,补充库存后自动恢复"
总兑换上限小于每人上限 用户填写的总兑换上限 < 每人兑换上限 前端校验拦截,后端二次校验总兑换上限 ≥ 每人兑换上限 "总兑换上限不能小于每人兑换上限,请调整"
兑换目标未选择 用户未选择券模板或商品即点击保存 前端校验兑换目标非空,后端二次校验 "请选择兑换目标(券模板或商品)"
并发兑换导致库存超卖 多个会员同时兑换同一商品导致库存不足 后端使用数据库行锁 + 库存预检,库存不足时回滚事务并返回失败,积分不扣减 会员端提示"该商品已兑换完毕",运营端无提示(系统自动处理)
9.8 获取记录
核心业务逻辑
获取记录用于查询会员积分获取历史,是积分流水的查询入口。系统从 t_points_record 表中筛选 points > 0 的记录(正数表示获取),展示会员信息、行为类型、获取积分、变动后余额、关联订单、获取时间。支持按会员ID、手机号、行为类型(purchase/sign_in/review/register/share)、时间范围进行多条件组合筛选。获取记录为只读历史数据,不支持修改或删除,仅支持查看详情和导出 Excel。导出时按当前筛选条件全量查询并生成 Excel 文件,单次导出上限 100,000 条。每条获取记录关联 t_points_account 的余额变更,balance_after 字段记录该笔获取后的账户余额快照。
对齐说明: 获取记录中的消费积分(action_type=purchase)按订单实付金额计算(对齐订单 PRD),关联订单ID可在订单中心反查。退款时系统自动生成一条冲正记录(points 为负数,action_type=purchase_reverse),该冲正记录出现在兑换记录或获取记录中以负数形式展示,确保积分流水闭环。获取记录数据可作为 9.10 积分对账(recon_type=6)发放统计的数据来源。
交互说明
序号 操作步骤 触发条件 系统行为 预期结果
1 进入获取记录列表页 用户点击左侧导航"积分管理 > 获取记录" 系统默认加载近30天的获取记录,按 created_at 倒序分页展示(每页20条) 页面展示筛选条件区和记录表格,默认展示近30天数据
2 输入会员ID筛选 用户在筛选区"会员ID"输入框中输入会员ID 系统按 member_id 精确匹配查询 t_points_record,仅返回该会员的获取记录 列表展示该会员的所有获取记录
3 输入手机号筛选 用户在筛选区"手机号"输入框中输入手机号 系统先通过会员中心反查 member_id,再查询该会员的获取记录 列表展示该手机号对应会员的获取记录
4 选择行为类型筛选 用户在行为类型下拉框中选择特定类型 系统按 action_type 精确匹配筛选,支持多选(如同时选 purchase + sign_in) 列表展示所选行为类型的获取记录
5 选择时间范围筛选 用户在时间范围选择器中选取起止日期 系统按 created_at 范围查询,时间范围最长不超过 180 天 列表展示指定时间范围内的获取记录
6 点击"查询"按钮 用户填写筛选条件后点击查询 系统组合所有筛选条件查询 t_points_record,返回分页结果,更新汇总数据(总获取积分、总记录数) 列表展示筛选结果,页面顶部展示汇总统计
7 查看记录详情 用户点击列表行操作列"详情"链接 系统弹出详情弹窗,展示完整信息:记录ID、会员信息、行为类型、获取积分、变动前余额、变动后余额、关联订单ID、获取时间、备注 弹窗以只读形式展示记录所有字段
8 点击"导出"按钮 用户点击页面右上角"导出"按钮 系统按当前筛选条件查询全量数据(上限100,000条),生成 Excel 文件并触发下载;超过上限时提示缩小范围 浏览器下载 Excel 文件,包含所有筛选结果列
9 重置筛选条件 用户点击筛选区"重置"按钮 系统清空所有筛选条件,恢复默认查询(近30天全量数据) 列表恢复默认展示,筛选条件清空
10 跳转关联订单 用户在详情弹窗中点击"关联订单"链接 系统在新标签页打开订单中心对应订单详情页 新标签页展示该订单的完整信息
原型
https://admin.yunlingxi.com/marketing/points-earn-records
营销中心 / 积分管理 / 获取记录
积分获取记录
导出Excel
总记录数:3,856 条
总获取积分:128,450
记录ID 会员信息 行为类型 获取积分 变动后余额 关联订单 时间 操作
PR20260723001 张三 (138****8888) 消费得积分 +256 1,856 ORD20260723... 2026-07-23 10:32 详情
PR20260723002 李四 (139****6666) 签到得积分 +7 342 — 2026-07-23 09:15 详情
PR20260723003 王五 (137****2233) 评价得积分 +20 580 ORD20260720... 2026-07-23 08:48 详情
PR20260723004 赵六 (135****1100) 注册得积分 +100 100 — 2026-07-23 08:02 详情
PR20260723005 孙七 (136****9999) 分享得积分 +3 215 — 2026-07-23 07:56 详情
状态说明
状态值 状态名称 触发条件 可执行操作 跳转目标
completed 已入账 积分获取行为完成,系统成功写入 t_points_record 并更新 t_points_account.balance 查看详情、导出 详情弹窗
pending 待入账 消费积分在订单完成但未过退款保护期(如7天无理由),积分暂存待确认状态 查看详情 详情弹窗(标注"待入账")
reversed 已冲正 关联订单发生全额退款,系统自动生成冲正记录扣回已发放积分 查看详情、查看关联退款单 详情弹窗 / 退款单详情
partial_reversed 部分冲正 关联订单发生部分退款,系统按退款比例扣回部分已发放积分 查看详情、查看关联退款单 详情弹窗 / 退款单详情
adjusted 已调整 运营人员通过后台手动调整积分(补发或扣减),记录中标注调整原因 查看详情、查看调整日志 详情弹窗 / 调整日志
expired 已过期 积分超过有效期未使用,系统自动过期清零并记录过期流水 查看详情 详情弹窗
异常处理
异常场景 触发条件 处理策略 用户提示
查询条件无效 用户输入的会员ID不存在或手机号格式不正确 前端校验手机号格式(11位数字),后端校验会员ID是否存在,不存在则返回空结果 "未找到对应会员,请检查会员ID或手机号是否正确"
时间范围超限 用户选择的时间范围超过 180 天 前端校验时间范围跨度,超过 180 天时拒绝查询并提示缩小范围 "查询时间范围不能超过180天,请缩小查询范围"
导出数据量超限 用户点击导出时筛选结果超过 100,000 条 系统先统计总条数,超过上限时拒绝导出并提示缩小筛选范围;未超限时异步生成 Excel 并通知下载 "导出数据量超过100,000条上限,请增加筛选条件缩小范围后重试"
手机号反查失败 用户输入手机号但会员中心未找到对应会员 系统返回空结果,不报错,页面展示"暂无数据" "未找到该手机号对应的会员积分记录"
关联订单不存在 用户点击关联订单链接但订单已被物理删除 系统跳转订单中心时检测订单不存在,返回提示而非报错页面 "该订单已不存在或已被删除"
导出任务超时 导出大数据量时生成 Excel 超过 60 秒 系统转为异步导出模式,生成完成后通过站内信通知用户下载,避免前端长时间等待 "数据量较大,正在后台生成Excel,完成后将通过站内信通知您下载"
9.9 兑换记录
核心业务逻辑
兑换记录用于查询会员积分兑换历史,是积分消耗流水的查询入口。系统从 t_points_record 表中筛选 points < 0 的记录(负数表示消耗),展示会员信息、兑换类型(优惠券/商品)、兑换目标、消耗积分、变动后余额、兑换时间。支持按会员ID、手机号、兑换类型(coupon_exchange/goods_exchange)、时间范围进行多条件组合筛选。兑换记录为只读历史数据,不支持修改或删除,仅支持查看详情和导出 Excel。每条兑换记录关联兑换设置项ID,可在兑换设置中反查配置。兑换扣减积分后即时更新 t_points_account.balance(扣减 total_used 字段),balance_after 记录扣减后的余额快照。单次导出上限 100,000 条。
对齐说明: 兑换记录遵循 MK-001——积分兑换优惠券后获得的优惠券可用于后续订单抵扣,但积分本身不参与订单金额结算。兑换记录中的积分消耗数据参与 9.10 积分对账(recon_type=6)的消耗统计,对账产出数据供财务中心消费。若兑换的商品发生退货,系统自动退回积分并生成退回记录(正数流水),原兑换记录状态更新为 refunded。
交互说明
序号 操作步骤 触发条件 系统行为 预期结果
1 进入兑换记录列表页 用户点击左侧导航"积分管理 > 兑换记录" 系统默认加载近30天的兑换记录,按 created_at 倒序分页展示(每页20条) 页面展示筛选条件区和记录表格,默认展示近30天数据
2 输入会员ID筛选 用户在筛选区"会员ID"输入框中输入会员ID 系统按 member_id 精确匹配查询 t_points_record 中 points < 0 的记录 列表展示该会员的所有兑换记录
3 输入手机号筛选 用户在筛选区"手机号"输入框中输入手机号 系统先通过会员中心反查 member_id,再查询该会员的兑换记录 列表展示该手机号对应会员的兑换记录
4 选择兑换类型筛选 用户在兑换类型下拉框中选择特定类型 系统按兑换类型筛选:coupon_exchange(兑换优惠券)/ goods_exchange(兑换商品),支持多选 列表展示所选兑换类型的记录
5 选择时间范围筛选 用户在时间范围选择器中选取起止日期 系统按 created_at 范围查询,时间范围最长不超过 180 天 列表展示指定时间范围内的兑换记录
6 点击"查询"按钮 用户填写筛选条件后点击查询 系统组合所有筛选条件查询并返回分页结果,更新汇总数据(总消耗积分、总记录数) 列表展示筛选结果,页面顶部展示汇总统计
7 查看记录详情 用户点击列表行操作列"详情"链接 系统弹出详情弹窗,展示完整信息:记录ID、会员信息、兑换类型、兑换目标、消耗积分、变动前余额、变动后余额、兑换设置项ID、兑换时间 弹窗以只读形式展示记录所有字段
8 点击"导出"按钮 用户点击页面右上角"导出"按钮 系统按当前筛选条件查询全量数据(上限100,000条),生成 Excel 文件并触发下载 浏览器下载 Excel 文件
9 重置筛选条件 用户点击筛选区"重置"按钮 系统清空所有筛选条件,恢复默认查询(近30天全量数据) 列表恢复默认展示
10 跳转兑换设置 用户在详情弹窗中点击"兑换设置项"链接 系统在新标签页打开兑换设置对应配置项的编辑页 新标签页展示该兑换设置项的编辑页
原型
https://admin.yunlingxi.com/marketing/points-exchange-records
营销中心 / 积分管理 / 兑换记录
积分兑换记录
导出Excel
总记录数:2,341 条
总消耗积分:876,200
记录ID 会员信息 兑换类型 兑换目标 消耗积分 变动后余额 时间 操作
EX20260723001 张三 (138****8888) 兑换优惠券 5元无门槛券 -500 1,356 2026-07-23 14:20 详情
EX20260723002 李四 (139****6666) 兑换商品 旅行保温杯 -3,000 242 2026-07-23 11:45 详情
EX20260723003 王五 (137****2233) 兑换优惠券 20元满100减券 -2,000 560 2026-07-23 10:08 详情
EX20260723004 赵六 (135****1100) 兑换商品 定制行李牌 -800 100 2026-07-23 09:30 详情
EX20260723005 孙七 (136****9999) 兑换优惠券 满100减10券 -1,000 420 2026-07-23 09:12 详情
状态说明
状态值 状态名称 触发条件 可执行操作 跳转目标
completed 已完成 积分扣减成功,优惠券已发放至会员账户 / 商品兑换订单已生成 查看详情、导出 详情弹窗
pending 处理中 积分已扣减但优惠券发放或商品兑换订单尚未完成(异步处理中) 查看详情 详情弹窗(标注"处理中")
failed 失败 积分扣减成功但后续发放失败(如券模板库存不足、商品库存不足),系统自动退回积分 查看详情、查看失败原因 详情弹窗 / 失败日志
canceled 已取消 运营人员手动取消兑换(如商品缺货需召回),系统自动退回积分 查看详情、查看取消原因 详情弹窗 / 取消日志
refunded 已退回 兑换的商品发生退货,系统自动退回已消耗积分并生成退回流水 查看详情、查看退回记录 详情弹窗 / 退回记录详情
expired 已过期 兑换的优惠券超过有效期未使用(记录本身不变,但券状态为过期),仅作标记 查看详情 详情弹窗
异常处理
异常场景 触发条件 处理策略 用户提示
查询条件无效 用户输入的会员ID不存在或手机号格式不正确 前端校验手机号格式(11位数字),后端校验会员ID是否存在,不存在则返回空结果 "未找到对应会员,请检查会员ID或手机号是否正确"
时间范围超限 用户选择的时间范围超过 180 天 前端校验时间范围跨度,超过 180 天时拒绝查询 "查询时间范围不能超过180天,请缩小查询范围"
导出数据量超限 用户点击导出时筛选结果超过 100,000 条 系统先统计总条数,超过上限时拒绝导出并提示缩小范围;未超限时异步生成 Excel "导出数据量超过100,000条上限,请增加筛选条件缩小范围后重试"
兑换设置项已删除 用户点击兑换设置项链接但该配置已被删除 系统跳转时检测配置不存在,返回提示而非报错页面 "该兑换设置项已被删除,无法查看配置详情"
异步导出任务失败 异步生成 Excel 时服务异常导致任务失败 系统记录失败日志,通过站内信通知用户导出失败并建议重试 "导出任务失败,请稍后重试。如多次失败请联系管理员"
手机号反查多条会员 用户输入手机号对应多个会员(历史数据合并) 系统返回所有匹配会员的兑换记录,并在列表中增加会员标识列区分 "该手机号关联多个会员,已展示全部记录,请在会员ID列区分"
9.10 积分对账
核心业务逻辑
积分对账用于定期核对积分发放与消耗数据,确保积分账户余额与流水记录一致。系统按日/周/月维度生成对账报表,展示每个对账周期的核心指标:期初余额(period_opening,取上期期末余额)、本期发放(period_earned,t_points_record 中 points > 0 的汇总)、本期消耗(period_used,t_points_record 中 points < 0 的绝对值汇总)、期末余额(period_closing = period_opening + period_earned - period_used)、差异值(diff = period_closing - 实际 t_points_account 余额汇总)。对账类型标记为 recon_type=6,与财务对账体系中的其他对账类型区分。差异值超过阈值(默认阈值为 0,即不允许有差异;可配置)时触发告警,对账状态自动标记为 exception。对账完成后支持导出对账单(Excel/CSV),供财务中心消费进行跨系统核对。
对齐说明: 遵循 MK-009——积分对账以 recon_type=6 标识,对账产出数据供财务对账中心消费。财务 PRD 中积分对账作为独立对账类型纳入财务对账体系,对账单导出后由财务中心拉取或主动推送至财务对账队列。对账差异阈值由运营在系统参数中配置,超过阈值时系统自动触发告警通知(站内信 + 邮件)发送至财务和运营负责人。对账报表中"本期发放"数据来源为 9.8 获取记录,"本期消耗"数据来源为 9.9 兑换记录,确保数据链路闭环。
交互说明
序号 操作步骤 触发条件 系统行为 预期结果
1 进入积分对账报表页 用户点击左侧导航"积分管理 > 积分对账" 系统默认加载当月对账报表,展示汇总数据卡片和明细表格 页面展示汇总卡片(期初/发放/消耗/期末/差异)和按日明细表格
2 选择对账周期维度 用户在周期维度选择器中选择"日/周/月" 系统切换展示对应维度的对账数据,重新查询并刷新表格 表格按所选维度展示对账明细行
3 选择时间范围 用户在时间范围选择器中选取起止日期 系统按时间范围查询对账数据,支持单日/单周/单月或自定义范围 汇总卡片和明细表格更新为所选时间范围的数据
4 查看汇总数据卡片 页面加载或查询后自动展示 系统展示五项核心指标:期初余额、本期发放、本期消耗、期末余额、差异值;差异值为 0 显示绿色,超阈值显示红色 页面顶部展示五张数据卡片,差异值按阈值着色
5 查看明细表格 用户在汇总卡片下方查看明细表 系统按对账周期维度展示每行明细:周期日期、期初余额、发放、消耗、期末余额、差异值、状态、操作 明细表格展示各周期对账数据,支持按列排序
6 展开日级明细 用户点击周/月维度的某行"展开"按钮 系统展开该行下钻至日级明细,展示该周/月内每日的对账数据 表格展开子行展示日级数据
7 查看差异详情 用户点击差异值非零行的"差异分析"链接 系统弹出差异分析弹窗,展示差异来源:逐笔流水与账户余额比对,标记不一致的流水记录 弹窗展示差异分析明细,可定位到具体异常流水
8 手动触发对账 用户点击"立即对账"按钮 系统对当前时间范围执行手动对账,重新计算期初/发放/消耗/期末/差异,更新对账状态;若已存在该周期对账记录则覆盖更新 对账完成后刷新页面,展示最新对账结果,Toast 提示"对账完成"
9 导出对账单 用户点击"导出对账单"按钮 系统按当前查询条件生成对账单文件(Excel格式),包含汇总数据和明细数据,文件名含对账周期和 recon_type=6 标识 浏览器下载对账单 Excel 文件
10 推送到财务中心 用户点击"推送至财务中心"按钮 系统将对账单数据推送至财务对账队列(携带 recon_type=6 标识),推送成功后状态更新为已推送 Toast 提示"对账单已推送至财务中心",状态列更新为"已推送"
原型
https://admin.yunlingxi.com/marketing/points-reconciliation
营销中心 / 积分管理 / 积分对账
积分对账报表
立即对账
导出对账单
推送至财务中心
对账类型:recon_type=6 (积分对账)
对账状态:已对账
对账日期 期初余额 本期发放 本期消耗 期末余额 差异 状态 操作
2026-07-25 1,295,200 +3,500 -1,200 1,297,500 0 已对账 差异分析
2026-07-24 1,292,800 +4,200 -1,800 1,295,200 0 已对账 差异分析
2026-07-23 1,290,000 +5,800 -3,000 1,292,800 0 已对账 差异分析
2026-07-22 1,288,500 +3,200 -1,700 1,290,000 +30 异常 差异处理
2026-07-21 1,285,000 +6,500 -3,000 1,288,500 0 已对账 差异分析
状态说明
状态值 状态名称 触发条件 可执行操作 跳转目标
pending 待对账 新对账周期开始但尚未执行对账计算(如当日尚未触发日终对账任务) 手动对账、查看明细 对账明细表
completed 已对账 对账计算完成且差异值在阈值范围内(diff ≤ 阈值) 查看明细、差异分析、导出对账单、推送至财务中心 差异分析弹窗 / 导出
exception 异常 对账计算完成但差异值超过阈值(diff > 阈值),系统自动标记并触发告警 差异分析、处理差异、导出对账单、手动标记已处理 差异分析弹窗
processing 对账中 用户点击"立即对账"或定时任务触发,系统正在执行对账计算 等待完成 完成后→completed/exception
pushed 已推送 已对账的对账单成功推送至财务对账队列(携带 recon_type=6) 查看推送记录、导出对账单 推送记录详情
resolved 已处理 异常对账经差异分析处理后,运营手动标记为已处理,差异已消除或已说明 查看明细、查看处理记录、导出对账单 处理记录详情
异常处理
异常场景 触发条件 处理策略 用户提示
对账差异超阈值 对账计算后 diff > 配置阈值(默认 0) 系统自动将对账状态标记为 exception,触发告警(站内信 + 邮件)通知财务和运营负责人;用户可在差异分析弹窗中逐笔排查 "积分对账差异为 +30,超过阈值0,请进行差异分析。已通知相关负责人"
数据缺失 对账期间部分日期的 t_points_record 或 t_points_account 数据缺失(如数据库同步延迟) 系统在对账明细中标记缺失日期行状态为"数据缺失",不参与汇总计算,提示用户稍后重新对账 "2026-07-15 积分流水数据缺失,该日不参与对账汇总,请稍后重新执行对账"
重复对账 用户对已对账完成的周期再次点击"立即对账" 系统弹出二次确认框"该周期已完成对账,重复对账将覆盖原有结果,是否继续?";确认后重新计算并覆盖,记录重复对账日志 "该周期已完成对账,确认重新对账将覆盖原有结果,是否继续?"
推送财务中心失败 对账单推送至财务对账队列时网络异常或队列服务不可用 系统自动重试3次(间隔 10s/30s/60s),仍失败则标记推送状态为"推送失败",用户可手动重推 "推送至财务中心失败,已重试3次。请稍后手动重推或联系管理员检查财务对账队列服务"
对账计算超时 对账数据量过大导致计算超过 120 秒未完成 系统转为异步计算模式,前端展示"对账进行中"状态,完成后通过站内信通知用户查看结果 "对账数据量较大,正在后台计算,完成后将通过站内信通知您"
导出对账单失败 导出时数据查询异常或文件生成失败 系统记录失败日志,提示用户重试;连续失败3次则提示联系管理员 "对账单导出失败,请重试。如多次失败请联系管理员"
14. 优惠券管理功能模块详解
优惠券管理功能模块是云灵汐涉旅电商分销子系统营销中心的核心子模块,面向平台运营、供应商、分销商三类角色,提供优惠券模板的创建、管理、发放与使用追溯能力。本模块通过统一的优惠券模板(t_coupon_template)定义券类型、面值、门槛、有效期、适用范围与成本承担方,并通过券实例(t_coupon_instance)和使用记录(t_coupon_usage_record)实现券的全生命周期可追溯。
模块对齐总览: 本模块严格遵循全局营销规则 MK-002(每张券必须标记成本承担方 platform/supplier/distributor)、MK-003(C端成交价=平台销售价-优惠券/满减,积分不参与)、MK-004(整单退款退券、部分退款不退券)、MK-011(优惠券+满减可叠加,不同优惠券互斥,秒杀排除满减)。同时与订单PRD(discount_amount记录优惠总额、price_snapshot记录成交价)、财务PRD(成本承担方通过降低settlement_base_price隐式实现)、供应链PRD(适用商品范围校验商品状态)保持一致。
角色权限说明: 平台运营可创建全部三种成本承担方的优惠券模板;供应商仅可创建成本承担方为 supplier 的模板且适用范围仅限自有商品;分销商仅可创建成本承担方为 distributor 的模板且适用范围仅限其分销商品。跨角色承担方的模板需经平台审核。
9.11 优惠券活动(优惠券模板创建与管理)
核心业务逻辑
优惠券活动功能用于创建优惠券模板,是券发放与核销的规则源头。系统支持三种券类型:满减券 (满 threshold 元减 face_value 元,要求 face_value ≤ threshold)、折扣券 (打 discount_rate 折,设置封顶金额 face_value 作为最大优惠上限,discount_rate 取值范围 0~1 且不含边界)、代金券 (直减 face_value 元,门槛 threshold 可设为 0 表示无门槛)。每张券模板必填券名称、券类型、面值、门槛、有效期、发放量、成本承担方、适用范围八项核心字段。
成本承担方机制(MK-002对齐): 成本承担方必须在创建时显式选定,取值为 platform(平台承担)、supplier(供应商承担)、distributor(分销商承担)。承担方为 supplier 时,财务PRD对齐实现方式为:当订单使用该券核销时,系统在生成结算单时将该券抵扣金额从供应商的 settlement_base_price 中扣减,即供应商货款结算基数降低;承担方为 platform 时,settlement_base_price 不变,抵扣金额计入平台营销费用科目;承担方为 distributor 时,抵扣金额从分销商佣金中扣减。bearer_id 字段记录具体承担主体ID(供应商ID或分销商ID,平台承担时为空)。
有效期机制: valid_type=fixed(固定日期)时,valid_start 与 valid_end 必填且 valid_end 必须晚于 valid_start,券在 [valid_start, valid_end] 区间内可用;valid_type=relative(领取后N天)时,valid_days 必填,券实例的可用区间为 [earned_at, earned_at + valid_days 天],到期日 23:59:59 自动失效。两种类型互斥,创建时单选。
适用范围机制: applicable_scope=all(全部商品)时,券可用于全平台所有符合营销条件的商品(秒杀商品除外,见MK-011);applicable_scope=category(指定类目)时,关联类目ID列表,仅类目下商品可用;applicable_scope=product(指定商品)时,关联商品ID列表。供应链PRD对齐:适用范围内的商品若在券核销时已下架,系统自动剔除该商品不可用券,并在C端下单页给出提示。
叠加与互斥规则(MK-011对齐): 每张券模板创建时默认"可叠加满减"为开启状态,即该券可与满减活动同时作用于同一订单;但不同优惠券之间互斥,一笔订单仅可使用一张优惠券;秒杀活动商品在适用范围校验时被排除,即秒杀商品既不可用优惠券也不可用满减。
发放量控制: total_stock 为该模板可发放的券实例总量上限,issued_count 为已发放数量,used_count 为已核销数量。系统保证 issued_count ≤ total_stock,超量发放请求将被拒绝。创建后模板可发放给指定会员(按会员ID/会员标签)或全员(全员发放需二次确认)。
对齐说明: 本功能与 MK-002(成本承担方显式标记)、MK-003(券抵扣金额计入 discount_amount,C端成交价=平台销售价-优惠券/满减)、MK-011(券+满减叠加、券互斥、秒杀排除)对齐。券核销时由订单服务写入 discount_amount 与 price_snapshot(订单PRD对齐),财务服务据 cost_bearer 调整 settlement_base_price(财务PRD对齐)。
审核机制: 面值超过 500 元、发放量超过 10000 张、或成本承担方为 supplier/distributor 的模板,提交后进入 pending 待审核状态,需平台运营管理员审核通过后方可激活;其余模板提交后可直接进入 approved 状态。
交互说明
序号 操作步骤 触发条件 系统行为 预期结果
1 进入优惠券模板列表页,点击"新建优惠券"按钮 用户拥有优惠券创建权限(平台运营/供应商/分销商) 系统跳转至多步表单创建页,默认展示步骤一"基本信息",步骤指示器高亮第一步 进入新建模板表单,步骤指示器显示"1/5 基本信息"
2 填写基本信息:券名称、券类型、券描述 用户在基本信息步骤输入内容 系统实时校验券名称长度(2-30字符)、券类型必选(满减券/折扣券/代金券三选一)、券描述可选(最长100字符) 表单字段校验通过,"下一步"按钮可点击;校验失败时字段下方红色提示
3 配置规则:面值、门槛、折扣率、封顶金额、成本承担方、适用范围 用户点击"下一步"进入规则配置步骤 系统根据券类型动态展示字段:满减券显示面值+门槛;折扣券显示折扣率+封顶金额;代金券显示面值+门槛(可0)。成本承担方下拉(platform/supplier/distributor),适用范围单选(全部/指定类目/指定商品)并联动选择器 规则配置完成,校验通过后可进入下一步;面值大于门槛等异常时拦截并提示
4 配置有效期:选择固定日期或领取后N天 用户点击"下一步"进入有效期步骤 系统展示有效期类型单选:选 fixed 时展示开始/结束日期选择器;选 relative 时展示 valid_days 输入框(1-365天)。系统校验固定日期的结束时间须晚于开始时间且开始时间不早于当前时间 有效期配置完成,校验通过可进入下一步
5 配置发放:发放量、发放对象、发放方式 用户点击"下一步"进入发放配置步骤 系统展示 total_stock 输入框(1-999999)、发放对象单选(指定会员/全员,全员需二次确认)、发放方式(手动领取/定向发放) 发放配置完成,校验通过可进入预览
6 预览确认完整模板配置 用户点击"下一步"进入预览确认步骤 系统以只读卡片形式展示前四步全部配置项,包括券类型、面值、门槛、成本承担方、有效期、适用范围、发放量等,用户可点击各步骤"编辑"返回修改 用户确认配置无误,可选择"保存草稿"或"提交"
7 保存草稿 用户点击"保存草稿"按钮 系统将模板以 status=draft 存入 t_coupon_template,issued_count=0,used_count=0,created_at=当前时间,并记录创建人。弹出"保存成功"提示,返回模板列表 模板列表新增一条 draft 状态记录,提示"草稿保存成功"
8 提交模板 用户点击"提交"按钮 系统按审核规则判定:满足自动通过条件的直接置 approved;需人工审核的置 pending。写入状态变更日志,返回模板列表并提示提交结果 模板状态变为 approved 或 pending,列表对应记录更新,提示"提交成功,等待审核"或"提交成功"
9 审核操作(仅平台运营管理员) 审核人进入待审核列表,点击"审核"按钮 系统弹出审核弹窗,展示模板完整配置,提供"通过"和"驳回(必填驳回原因)"操作。通过则 status=approved,驳回则 status=draft 并记录驳回原因 审核通过后模板可被激活发放;驳回后模板回到草稿态,创建人可见驳回原因
10 激活并发放 approved 状态模板,用户点击"激活发放"按钮 系统将 status 置为 active,根据发放配置执行发放:定向发放则按会员ID生成券实例写入 t_coupon_instance(status=unused);手动领取则模板上架至C端领券中心。issued_count 累加 模板进入 active 状态,券实例生成或上架成功,发放明细可查
原型
/marketing/coupon-templates
营销中心 / 优惠券管理 / 优惠券活动
优惠券模板管理
券名称
类型 全部 满减券 折扣券 代金券
状态 全部 进行中 已暂停 草稿 已过期
查询 重置
+ 新建优惠券
券名称 类型 面值 门槛 已发放 已使用 状态 操作
暑期满减券 满减券 ¥50 ¥300 8,200 5,130 进行中 编辑 发放明细 暂停
新人代金券 代金券 ¥20 无门槛 5,000 3,890 进行中 编辑 发放明细 暂停
会员日折扣券 折扣券 8折 封顶¥100 3,000 2,156 已暂停 编辑 恢复 发放明细
国庆满减券 满减券 ¥100 ¥800 0 0 草稿 编辑 提交 删除
双十一折扣券 折扣券 7.5折 封顶¥200 10,000 9,876 已过期 发放明细 使用统计
/marketing/coupon-templates/create
营销中心 / 优惠券管理 / 优惠券活动 / 新建优惠券
新建优惠券模板
1 基本信息 2 规则配置 3 有效期 4 发放配置 5 预览
券类型选择 / 面值 / 门槛 / 折扣率 / 成本承担方 / 适用范围
上一步 下一步 保存草稿
/marketing/coupon-templates/create
营销中心 / 优惠券管理 / 优惠券活动 / 新建优惠券
预览确认
1 基本信息 2 规则配置 3 有效期 4 发放配置 5 预览
¥50
满300元可用
暑期满减券
满减券 | 2026-07-25至2026-08-31
适用:指定类目 | 成本承担:平台
配置项 配置值
券名称 暑期满减券
券类型 满减券
面值/门槛 ¥50 / ¥300
成本承担方 平台承担(platform)
适用范围 指定类目(国内跟团游/境外自由行/门票)
叠加规则 可与满减叠加;券互斥;秒杀排除
有效期 固定日期 2026-07-25 00:00 至 2026-08-31 23:59
发放量 10,000张
发放对象 全员
发放方式 手动领取
返回修改 保存草稿 提交
状态说明
状态值 状态名称 触发条件 可执行操作 跳转目标
draft 草稿 新建模板点击"保存草稿",或审核被驳回 编辑、删除、提交审核 提交后 → pending;删除后移除
pending 待审核 满足审核条件的模板点击"提交" 撤回(回到draft)、查看详情 审核通过 → approved;审核驳回 → draft
approved 审核通过 审核通过,或满足自动通过条件直接提交 激活发放、编辑(仅部分字段)、查看详情 激活后 → active
active 进行中 approved 模板点击"激活发放" 暂停、追加发放、查看发放明细、查看使用统计、结束 暂停 → paused;手动结束 → ended;有效期到期 → expired
paused 已暂停 active 模板点击"暂停" 恢复、查看明细、结束 恢复 → active;结束 → ended
ended 已结束 active/paused 模板点击"结束",或发放量已达上限且全部核销完毕 查看发放明细、查看使用统计 终态,不可逆
expired 已过期 系统定时任务检测到 valid_end 早于当前时间(fixed类型),或所有券实例均已过期(relative类型) 查看发放明细、查看使用统计 终态,不可逆
异常处理
异常场景 触发条件 处理策略 用户提示
面值大于门槛 满减券/代金券提交时 face_value > threshold 且 threshold > 0 前端实时拦截,禁止进入下一步;后端二次校验拒绝写入 "抵扣面值不能大于使用门槛,请调整后再提交"
折扣率越界 折扣券 discount_rate ≤ 0 或 ≥ 1 前端输入框失焦校验拦截,后端校验拒绝 "折扣率必须在 0~1 之间(如0.8表示8折),不能等于0或1"
有效期时间倒置 fixed 类型 valid_end ≤ valid_start 前端日期选择器联动校验,后端校验拒绝 "有效期结束时间必须晚于开始时间,请重新选择"
成本承担方未选 规则配置步骤 cost_bearer 为空 "下一步"按钮置灰,后端校验拒绝 "请选择成本承担方(MK-002要求每张券必须标记)"
适用范围商品已下架 applicable_scope=product 且关联商品中存在 status=下架的商品 提交时系统校验商品状态,自动剔除下架商品并保留上架商品;若全部下架则拒绝提交 "以下商品已下架已自动剔除:[商品名];请确认剩余商品范围" 或 "所选商品均已下架,无法创建优惠券"
发放量超额 total_stock 超过当前角色权限上限(如供应商单模板上限5000) 前端校验拦截,后端二次校验拒绝 "发放量超过您的权限上限(5000张),请联系平台运营调整"
审核驳回 审核人选择驳回并填写原因 模板状态回退至 draft,记录驳回原因,原创建人收到站内通知 "优惠券模板审核未通过:[驳回原因],请修改后重新提交"
9.12 优惠券列表
核心业务逻辑
优惠券列表功能用于管理已创建的优惠券模板,提供模板的全量检索、筛选与运维操作入口。列表数据源为 t_coupon_template,展示券名称、券类型、面值、门槛、已发放(issued_count)、已使用(used_count)、剩余(total_stock - issued_count)、状态、操作等字段。系统支持按券名称模糊查询、券类型精确筛选、状态多选筛选、创建时间区间筛选四种维度的组合查询。
可执行操作与状态约束: 不同状态下的模板可执行操作不同:draft 状态可编辑全部字段并删除;pending 状态仅可撤回;approved 状态可激活、可编辑非核心字段(券描述、发放方式);active 状态可暂停、追加发放、查看发放明细、查看使用统计、结束;paused 状态可恢复、结束;ended/expired 为终态仅可查看。非草稿态模板的核心字段(券类型、面值、门槛、成本承担方、适用范围)不可编辑,防止已发放券规则变更导致核销异常。
追加发放机制: active 状态模板支持追加发放,运营人员输入追加数量,系统校验"已发放量 + 追加数量 ≤ total_stock",若需突破原 total_stock 上限则需同时上调 total_stock(受角色权限上限约束)。追加发放生成新的券实例,issued_count 同步累加,使用记录 t_coupon_usage_record 写入 action=earn 的领取记录。
暂停与恢复: active 模板暂停后变为 paused,暂停期间C端领券中心下架该券(手动领取类型),已领取未使用的券实例不受影响仍可在有效期内核销。恢复后重新上架。暂停不影响已发放券实例的有效期计算。
使用统计: 点击"查看使用统计"跳转至统计页,展示该模板的发放量、领取量、核销量、核销率(used_count/issued_count)、节省金额合计(sum(amount where action=use))、各状态券实例分布等指标,支持按时间维度查看趋势。
对齐说明: 列表中的成本承担方字段始终展示(MK-002),确保运营可识别每张券的成本归属。核销数据与订单PRD的 discount_amount、财务PRD的 settlement_base_price 调整记录关联,使用统计页可下钻至订单与结算明细。
操作风险提示: "结束"操作为不可逆操作,结束后未发放的剩余库存作废,已发放未使用的券实例在有效期内仍可核销。系统在结束前需二次确认并展示影响范围(剩余库存数、未核销券实例数)。
交互说明
序号 操作步骤 触发条件 系统行为 预期结果
1 进入优惠券列表页 用户拥有优惠券查看权限并点击菜单"优惠券管理 > 优惠券列表" 系统默认加载全部状态的模板列表(按 created_at 倒序),分页展示,每页20条,顶部展示筛选区 列表展示模板记录,筛选区可输入条件
2 按券名称模糊查询 用户在筛选区券名称输入框输入关键词并点击"查询" 系统对 t_coupon_template.coupon_name 执行 LIKE 模糊匹配,与其他筛选条件AND组合查询,重置分页至第1页 列表展示匹配的模板记录,空结果时展示"暂无数据"
3 按券类型/状态/时间组合筛选 用户选择券类型(满减/折扣/代金)、状态(多选)、创建时间区间后点击"查询" 系统按 coupon_type、status、created_at 区间组合查询,支持与券名称查询叠加 列表展示符合全部筛选条件的记录
4 点击"重置"清空筛选 用户点击筛选区"重置"按钮 系统清空所有筛选条件,重新加载默认列表 筛选区清空,列表恢复全量展示
5 编辑模板(仅draft状态) 用户点击某条 draft 状态记录的"编辑"按钮 系统跳转至多步表单编辑页,预填该模板全部字段,所有字段可编辑 进入编辑态表单,修改后可保存或提交
6 暂停模板 用户点击 active 状态记录的"暂停"按钮 系统弹出二次确认弹窗,确认后将 status 置为 paused,C端领券中心同步下架,记录操作日志 记录状态变为 paused,操作列按钮更新为"恢复"
7 恢复模板 用户点击 paused 状态记录的"恢复"按钮 系统将 status 置为 active,C端领券中心重新上架,校验当前时间是否仍在有效期内,若已过有效期则提示不可恢复 记录状态变为 active,领券中心可领
8 追加发放 用户点击 active 状态记录的"追加发放"按钮 系统弹出追加发放弹窗,展示当前已发放量、剩余库存,输入追加数量,校验不超过 total_stock(或同步上调),确认后生成券实例并累加 issued_count 弹窗关闭,列表"已发放"列数据更新,提示"追加发放成功"
9 查看发放明细 用户点击任意状态记录的"发放明细"按钮 系统跳转至发放明细页,展示该模板下所有券实例列表(coupon_code、member_id、status、earned_at 等) 进入发放明细列表页
10 查看使用统计 用户点击任意状态记录的"使用统计"按钮 系统跳转至使用统计页,展示发放量、核销量、核销率、节省金额等指标及趋势图 进入使用统计页
11 结束模板 用户点击 active/paused 状态记录的"结束"按钮 系统弹出风险确认弹窗,展示剩余库存数与未核销券实例数,需输入"确认结束"文字后才能提交,status 置为 ended 记录状态变为 ended,不可再操作
原型
/marketing/coupon-list
营销中心 / 优惠券管理 / 优惠券列表
优惠券列表
券名称 类型 面值/门槛 已发放 已使用 剩余 状态 操作
暑期满减券 满减券 ¥50/¥300 8,200 5,130 1,800 进行中 暂停 追加发放 明细 统计
新人代金券 代金券 ¥20/无门槛 5,000 3,890 0 进行中 暂停 追加发放 明细 统计
会员日折扣券 折扣券 8折/封顶¥100 3,000 2,156 844 已暂停 恢复 明细 统计 结束
国庆满减券 满减券 ¥100/¥800 0 0 5,000 草稿 编辑 提交 删除
五一满500减80券 满减券 ¥80/¥500 10,000 9,876 0 已过期 明细 统计
/marketing/coupon-list
营销中心 / 优惠券管理 / 优惠券列表
优惠券列表
券名称 类型 状态 操作
暑期满减券 满减券 进行中 追加发放
状态说明
状态值 状态名称 触发条件 可执行操作 跳转目标
draft 草稿 新建保存草稿或审核驳回 编辑(全字段)、提交审核、删除 提交 → pending;删除 → 移除
pending 待审核 提交后待人工审核 撤回、查看详情 撤回 → draft;通过 → approved;驳回 → draft
approved 审核通过 审核通过或自动通过 激活发放、编辑(部分字段)、查看详情 激活 → active
active 进行中 approved 点击激活 暂停、追加发放、发放明细、使用统计、结束 暂停 → paused;结束 → ended;到期 → expired
paused 已暂停 active 点击暂停 恢复、发放明细、使用统计、结束 恢复 → active;结束 → ended
ended 已结束 手动结束或库存发完且核销完 发放明细、使用统计 终态不可逆
expired 已过期 定时任务检测有效期到期 发放明细、使用统计 终态不可逆
异常处理
异常场景 触发条件 处理策略 用户提示
非草稿态编辑核心字段 用户对非 draft 状态模板尝试编辑券类型/面值/门槛/成本承担方/适用范围 系统将核心字段置为只读,仅允许编辑券描述、发放方式等非核心字段;后端拒绝核心字段变更请求 "该模板已进入[状态]状态,核心规则字段不可修改,仅可编辑描述与发放方式"
追加发放超总库存 追加发放数量 > (total_stock - issued_count) 且未勾选上调总库存 前端校验拦截,弹窗提示剩余可发放量;若勾选上调则校验新 total_stock 不超角色权限上限 "追加数量超过剩余可发放量(1800张),请减少数量或勾选上调总库存"
暂停后恢复时已过有效期 paused 模板点击恢复,但当前时间已超过 valid_end 系统校验有效期,拒绝恢复操作,建议直接结束 "该优惠券有效期已结束,无法恢复,建议点击'结束'终止活动"
结束操作库存影响未确认 用户点击"结束"但未在确认弹窗输入"确认结束"文字 系统禁用确认按钮,需完整输入验证文字后方可提交 "请输入'确认结束'以继续,该操作不可逆"
查询条件无效 创建时间区间开始时间晚于结束时间 前端校验拦截,不发起查询 "开始时间不能晚于结束时间,请重新选择"
删除存在已发放实例的模板 用户对 issued_count > 0 的 draft 模板点击删除 系统拒绝删除,提示需先处理已发放实例;draft 态理论上 issued_count=0 但做兜底校验 "该模板已存在发放记录,无法删除,请先结束活动"
9.13 使用记录
核心业务逻辑
使用记录功能用于查询优惠券使用的全生命周期记录,数据来源为 t_coupon_usage_record(操作记录)关联 t_coupon_instance(券实例)。每张券实例从领取到核销、退还或作废的每一次状态流转均产生一条使用记录,action 字段标识操作类型:earn(领取)、use(核销使用)、return(退还)、void(作废)。记录字段包含券码(coupon_code)、会员(member_id)、操作类型(action)、金额(amount,核销时为抵扣金额,领取/作废时为0)、订单号(order_id,核销与退还时关联订单)、操作人(operator,系统自动或人工)、时间(created_at)。
退还规则(MK-004对齐): 当订单发生整单退款时,系统自动触发券退还,券实例状态从 used 变为 returned,写入 action=return 的使用记录,amount 记录原抵扣金额(用于统计还原),会员可在券有效期内重新使用该券。当订单发生部分退款时,券不退还,券实例保持 used 状态,不产生 return 记录。此规则与订单PRD一致:整单退款退券、部分退款不退券。
作废规则: 运营人员可对特定券实例执行作废操作(如发现异常领取、风控拦截),券实例状态变为 voided,写入 action=void 的使用记录,作废后券不可再使用。作废需记录操作人与作废原因。
金额统计口径: 核销记录的 amount 为该券实际抵扣金额,计入订单的 discount_amount(订单PRD对齐),同时按成本承担方影响 settlement_base_price(财务PRD对齐)。退还记录的 amount 为负数(或标识为退还),用于核销金额的冲减统计。领取与作废记录的 amount 为0。
查询与导出: 支持按券模板(template_id)、会员(member_id)、订单号(order_id)、操作类型(action 多选)、时间区间组合筛选。支持将查询结果导出为 Excel,导出字段与列表展示一致,单次导出上限 10000 条,超出需缩小时间范围分批导出。
对齐说明: 本功能严格对齐 MK-004(整单退款退券、部分退款不退券)。退还操作由订单退款事件驱动,使用记录中 action=return 的记录与订单退款单双向关联,确保财务对账时可追溯券抵扣金额的还原。
风控对齐: 同一会员短时间内高频领取同一模板券(如1分钟内超过5次)将触发风控,相关券实例自动作废(action=void),使用记录标注风控原因,运营可在使用记录页筛 action=void 查看风控作废明细。
交互说明
序号 操作步骤 触发条件 系统行为 预期结果
1 进入使用记录列表页 用户点击菜单"优惠券管理 > 使用记录" 系统默认加载近30天全部操作类型的记录,按 created_at 倒序分页展示,每页20条 列表展示使用记录,顶部展示筛选区与导出按钮
2 按券模板筛选 用户在筛选区选择券模板(下拉搜索,支持券名称模糊) 系统按 template_id 过滤 t_coupon_instance 再关联 t_coupon_usage_record,展示该模板下所有使用记录 列表展示该模板的使用记录
3 按会员筛选 用户输入会员ID或会员手机号 系统按 member_id 查询券实例,关联展示该会员所有券使用记录 列表展示该会员的使用记录
4 按订单号筛选 用户输入订单号 系统按 order_id 查询使用记录,展示该订单关联的券核销与退还记录 列表展示该订单的券使用记录(含use与return)
5 按操作类型筛选 用户勾选操作类型多选(领取/使用/退还/作废) 系统按 action 字段筛选,支持多选组合 列表展示符合操作类型的记录
6 按时间区间筛选 用户选择操作时间起止区间 系统按 created_at 区间过滤,与其他条件AND组合 列表展示时间区间内的记录
7 点击"查询"执行组合筛选 用户配置多项筛选条件后点击"查询" 系统按全部条件组合查询,重置分页至第1页 列表展示符合全部条件的记录
8 查看记录详情 用户点击某条记录的"详情"链接 系统弹出详情弹窗,展示券码、券模板信息、会员信息、操作类型、金额、订单号、操作人、时间及操作原因(退还/作废时展示) 弹窗展示完整记录详情
9 导出查询结果 用户点击"导出"按钮 系统校验当前查询结果条数,≤10000条则生成Excel下载,>10000条则提示缩小范围;导出任务异步执行,完成后通知 导出文件下载或提示缩小范围
10 人工作废券实例 运营人员在使用记录页或发放明细页对某 unused/used 券实例点击"作废" 系统弹出作废弹窗,必填作废原因,确认后券实例状态置 voided,写入 action=void 记录,operator 记录当前操作人 券实例作废,使用记录新增一条 void 记录
原型
/marketing/coupon-usage-records
营销中心 / 优惠券管理 / 使用记录
优惠券使用记录
券码 会员 操作类型 金额(元) 订单号 操作人 时间 操作
CPN20260725001 MB10086 领取 0.00 - 系统 2026-07-25 09:12:33 详情
CPN20260725001 MB10086 使用 50.00 ORD20260726001 系统 2026-07-26 14:30:11 详情
CPN20260725001 MB10086 退还 -50.00 ORD20260726001 系统(整单退款) 2026-07-27 10:05:42 详情
CPN20260725008 MB20099 作废 0.00 - admin(风控) 2026-07-25 09:13:55 详情
CPN20260725015 MB30012 使用 80.00 ORD20260726008 系统 2026-07-26 16:22:09 详情
/marketing/coupon-usage-records
营销中心 / 优惠券管理 / 使用记录
优惠券使用记录
券码 操作类型 操作
CPN20260725001 退还 详情
字段 值
券码 CPN20260725001
券模板 暑期满减券(满减券/面值¥50/门槛¥300)
会员信息 MB10086 / 旅行家小李 / 券当前状态:已退还
操作类型 退还(return)
操作时间 2026-07-27 10:05:42
金额 -50.00元(抵扣金额还原)
订单信息 ORD20260726001(整单退款触发退券,MK-004)
操作人 系统(整单退款自动触发)
操作原因 订单整单退款,按MK-004规则自动退券,券实例状态used→returned,会员可在有效期内重新使用
状态说明
状态值 状态名称 触发条件 可执行操作 跳转目标
unused 未使用 券实例领取后(action=earn)尚未核销 核销使用、作废、查看详情 核销 → used;作废 → voided;到期 → expired
used 已使用 订单下单核销券(action=use),写入 order_id 与 amount 查看详情;整单退款时自动退还 整单退款 → returned;部分退款保持 used
expired 已过期 定时任务检测券实例超过有效期(fixed 到 valid_end,relative 到 earned_at+valid_days) 查看详情 终态不可逆
returned 已退还 订单整单退款触发(MK-004),action=return 记录写入 在有效期内可再次核销;查看详情 再次核销 → used;到期 → expired;人工作废 → voided
voided 已作废 运营人工作废或风控自动作废(action=void),记录操作人与原因 查看详情 终态不可逆
-(记录态) 使用记录不可变 t_coupon_usage_record 中每条记录为不可变日志,仅追加不修改 仅查询与导出,不可编辑删除 无状态流转,为审计留痕
异常处理
异常场景 触发条件 处理策略 用户提示
查询条件无效 时间区间开始晚于结束,或会员/订单号格式非法 前端校验拦截,不发起查询;后端二次校验返回参数错误 "查询条件无效:[具体原因],请检查后重试"
导出超限 当前查询结果超过 10000 条 系统拒绝导出,提示缩小时间范围或增加筛选条件分批导出 "导出数据量超过上限(10000条),请缩小查询范围后分批导出"
部分退款误触发退券 订单部分退款时系统错误触发了券退还 系统按 MK-004 校验退款类型,整单退款才退券;若误触发则回滚券实例状态与 return 记录,记录异常日志 (系统内部异常,对运营展示告警)"检测到部分退款误退券异常,已自动回滚,请联系技术排查"
退还时券已过期 整单退款触发退券,但券实例已超过有效期 系统校验券有效期,若已过期则不退还(券直接失效),仅记录 return 日志标注"券已过期不可恢复",不改变券状态(保持 expired) (订单退款流程提示)"优惠券已过期,退还后无法再次使用,抵扣金额不退回"
作废已核销券实例 运营对 used 状态券实例执行作废 系统校验券状态,used 态券已产生核销记录,禁止直接作废;需先通过订单退款流程退券后再作废 "该券已核销使用,无法直接作废,请先通过订单退款流程处理"
风控批量作废失败 风控规则触发批量作废,部分券实例并发核销中 系统对并发核销中的券加锁,核销完成后作废;已核销的券跳过作废并记录跳过原因 (风控日志)"批量作废:成功N条,跳过M条(已核销),详情见风控日志"
15. 活动管理功能模块详解
活动管理是营销中心的核心模块,提供从活动类型配置、模板管理到四类营销活动(展示、满减、秒杀、拼团)的创建、审核与发布的全流程管理能力。模块遵循统一的活动状态流转规范(MK-013),并在价格合规、成本承担、库存管理等关键环节与供应链中心、订单中心、财务中心深度联动。
模块定位: 活动管理向上承接运营策略的落地执行,向下驱动商品曝光与交易转化。四类活动分别覆盖"品牌展示→满减促单→限时秒杀→社交裂变"的完整营销链路,同时通过统一审核流与价格合规校验(MK-005)保障平台利润底线。
9.14 活动类型
核心业务逻辑
活动类型是整个活动管理模块的元数据层,定义系统支持哪些营销活动形态。系统预置四类活动类型:展示活动(showcase)、满减活动(full_reduction)、秒杀活动(seckill)、拼团活动(group_buy)。每种类型包含类型名称、类型编码(type_code)、展示方式(display_type)、启用状态与排序权重。活动类型被活动模板(t_activity_template)和活动实例(t_activity)引用,类型编码在系统内全局唯一,一旦被引用则不可删除,仅可停用。运营人员可在此维护类型的显示名称和排序,影响前端活动入口的展示顺序。
对齐说明: 活动类型属于系统元数据层,与 t_activity_type 表对应。type_code 在代码层面被硬编码引用(如 activity_type='seckill' 对应秒杀库存池逻辑 MK-006、order_type=2 订单类型判定),因此 type_code 字段创建后不可修改,仅 display_name 和 sort_order 可编辑。
交互说明
序号 操作步骤 触发条件 系统行为 预期结果
1 进入活动类型管理页 点击「营销中心 > 活动管理 > 活动类型」菜单 查询 t_activity_type 表全量数据,按 sort_order 排序展示列表 展示所有活动类型卡片/列表,含名称、编码、展示方式、状态、排序值
2 新建活动类型 点击「新建类型」按钮 弹出新建表单,包含类型名称、类型编码、展示方式、排序值输入项 展示空白表单,等待填写
3 填写类型编码 在「类型编码」输入框输入英文编码 实时校验编码格式(仅小写字母+下划线,3-32字符)并查询唯一性 编码可用时显示绿色勾号;重复时显示红色提示「该编码已存在」
4 选择展示方式 点击「展示方式」下拉选择 展示可选的展示方式列表:卡片式、列表式、瀑布流式、弹窗式 选定后预览区展示对应展示样式的缩略图
5 保存活动类型 填写完成后点击「保存」 校验必填项与编码唯一性,写入 t_activity_type 表,status 默认为 enabled 提示「保存成功」,列表刷新展示新类型
6 编辑活动类型 点击列表中某类型的「编辑」操作 加载该类型数据至编辑表单,type_code 字段置为只读灰显 可修改名称、展示方式、排序值,不可修改编码
7 启用/停用类型 点击类型卡片上的状态开关 查询是否有引用该类型的进行中活动(t_activity 关联校验),无引用则切换状态 状态切换成功;若存在进行中活动则弹窗提示不可停用
8 拖拽排序 长按类型卡片拖动至目标位置 更新各类型 sort_order 字段,前端即时重排 列表顺序更新并持久化
9 搜索筛选 在搜索框输入类型名称或编码 按名称模糊匹配 + 编码精确匹配查询 展示匹配结果列表
10 删除活动类型 点击「删除」操作 查询 t_activity_template 和 t_activity 是否有引用记录,无引用则逻辑删除(status 标记为 deleted),有引用则拒绝 删除成功提示;或提示「该类型已被 N 个模板/活动引用,无法删除,可先停用」
原型
/marketing/activity-types
营销中心 / 活动管理 / 活动类型
活动类型管理
排序 类型名称 编码 展示方式 状态 操作
1 展示活动 showcase 卡片式 已启用 编辑 停用
2 满减活动 full_reduction 列表式 已启用 编辑 停用
3 秒杀活动 seckill 卡片式 已启用 编辑 停用
4 拼团活动 group_buy 卡片式 已停用 编辑 启用
/marketing/activity-types
营销中心 / 活动管理 / 活动类型
活动类型管理
状态说明
状态值 状态名称 触发条件 可执行操作 跳转目标
enabled 已启用 新建保存后默认 / 由 disabled 手动启用 编辑、停用、删除(无引用时)、基于此类型创建模板 —
disabled 已停用 由 enabled 手动停用(需无进行中活动引用) 编辑、启用、删除(无引用时) —
deleted 已删除 无任何引用时手动删除(逻辑删除) 无(不可恢复,仅可新建同名新类型) —
— 锁定中(临时态) 存在进行中活动引用该类型时尝试停用 仅可查看,不可停用或删除 弹窗提示引用活动列表
— 编码校验中(临时态) 新建/编辑时输入编码后失焦 等待校验结果 校验通过→可保存;失败→标红提示
— 保存中(临时态) 点击「保存」后请求发出 等待响应 成功→列表刷新;失败→保留表单数据并提示错误
— 排序更新中(临时态) 拖拽排序松开后 等待排序持久化 成功→列表顺序锁定;失败→回滚至原顺序
异常处理
异常场景 触发条件 处理策略 用户提示
类型编码重复 新建时输入已存在的 type_code 前端失焦校验 + 后端唯一索引兜底,拒绝写入 「类型编码已存在,请更换」
停用时有进行中活动 尝试停用被进行中活动引用的类型 查询 t_activity 中 activity_type_id 关联且 status in (published, ongoing) 的记录,存在则拒绝 「该类型下有 N 个进行中活动,无法停用,请先结束相关活动」
删除时有引用 尝试删除被模板或活动引用的类型 查询 t_activity_template 和 t_activity 的引用记录,存在则拒绝删除 「该类型已被 N 个模板、M 个活动引用,无法删除,可先停用」
编码格式非法 输入包含大写字母、特殊字符或长度不在 3-32 范围 前端正则校验拦截 「编码仅支持小写字母和下划线,长度 3-32 字符」
必填项缺失 类型名称或展示方式为空时点击保存 前端校验必填项 对应字段下方标红提示「此项为必填项」
并发修改冲突 两名运营人员同时编辑同一类型并保存 基于 updated_at 乐观锁,后提交者检测到版本变化则拒绝 「该数据已被其他用户修改,请刷新后重试」
9.15 活动模板
核心业务逻辑
活动模板是对某类活动配置规则和页面布局的预设封装,用于提升运营创建同类活动的效率。模板包含两个核心 JSON 配置:config_json(规则字段默认值,如满减阶梯规则、秒杀限购数、防刷策略默认值)和 page_layout_json(专题页区块布局,如 Banner 位、商品瀑布流、优惠券领取区位置与样式)。模板不包含具体商品信息和活动时间,这些在创建活动实例时填充。运营人员选择模板后系统自动载入预设规则和布局,仅需补充商品和时间即可快速完成活动创建。模板支持草稿、启用、停用三种状态,停用后的模板不可用于创建新活动但已创建的活动不受影响。
对齐说明: 模板与 t_activity_template 表对应。config_json 的结构因活动类型而异:满减模板含 tier_rules 数组、秒杀模板含 per_user_limit/anti_fraud_config 默认值、拼团模板含 min_members/max_members 默认值。page_layout_json 遵循统一区块化布局协议(block_id + block_type + sort_order + style_config),由前端专题页渲染引擎解析。
交互说明
序号 操作步骤 触发条件 系统行为 预期结果
1 进入模板管理页 点击「营销中心 > 活动管理 > 活动模板」菜单 查询 t_activity_template 表,按创建时间倒序展示列表 展示模板列表,含名称、活动类型、状态、创建时间、操作列
2 新建模板 点击「新建模板」按钮 进入模板创建向导,第一步选择活动类型 展示四种活动类型卡片供选择
3 选择活动类型 点击某活动类型卡片(如「满减活动」) 根据类型加载对应的 config_json 配置表单字段 进入规则配置步骤,展示该类型适用的规则字段表单
4 配置规则默认值 在规则配置页填写各字段默认值 实时校验 JSON 合法性,将表单值序列化为 config_json 表单填写完成,config_json 预览区实时更新
5 配置页面布局 切换到「页面布局」配置步骤 加载可视化布局编辑器,展示可拖拽的区块组件列表(Banner位、商品列表、优惠券区等) 运营拖拽区块到画布,配置区块样式和排序
6 布局预览 点击「预览布局」按钮 根据 page_layout_json 渲染专题页预览效果 弹窗展示模拟专题页页面布局效果
7 保存模板 点击「保存模板」按钮 校验 config_json 和 page_layout_json 格式合法性,写入 t_activity_template 表,status 默认 draft 提示「保存成功」,返回模板列表
8 启用模板 在草稿/停用状态的模板上点击「启用」 校验引用的活动类型处于 enabled 状态,通过后更新模板 status 为 active 模板状态变更为「已启用」,可用于创建活动
9 基于模板创建活动 点击启用状态模板的「创建活动」操作 新建活动表单自动载入模板的 config_json 作为默认值、page_layout_json 作为页面布局初始值 跳转至活动创建页,规则和布局已预填
10 复制模板 点击「复制」操作 复制模板所有配置到新模板草稿,名称后缀「_副本」 生成新草稿模板,可在此基础上修改
11 编辑模板 点击「编辑」操作 加载模板配置至编辑向导,已启用模板编辑后自动回退为草稿状态 可修改规则默认值和页面布局
原型
/marketing/activity-templates
营销中心 / 活动管理 / 活动模板
活动模板管理
活动类型 全部 展示活动 满减活动 秒杀活动 拼团活动
状态 全部 已启用 草稿 已停用
+ 新建模板
/marketing/activity-templates
营销中心 / 活动管理 / 活动模板
活动模板管理
规则默认值配置区(config_json)
配置项 默认值
阶梯规则 tier_rules [{"threshold":300,"reduction":30},{"threshold":500,"reduction":60}]
成本承担方默认值 platform(平台承担)
可叠加优惠券 true
排除秒杀商品 true
适用范围默认 全部商品
页面布局预览区(page_layout_json)
Banner位(750x300)
优惠券领取区
商品瀑布流(3列)
+ 添加区块
状态说明
状态值 状态名称 触发条件 可执行操作 跳转目标
draft 草稿 新建保存后默认 / 已启用模板被编辑后自动回退 编辑、删除、启用、复制 启用后→active
active 已启用 草稿状态点击「启用」并通过校验 编辑(编辑后回退草稿)、停用、复制、创建活动 编辑后→draft;停用后→inactive
inactive 已停用 已启用状态点击「停用」 编辑、启用、删除(无引用时)、复制 启用后→active
— 校验中(临时态) 点击「启用」时校验活动类型状态 等待校验结果 通过→active;失败→保留 draft 并提示
— 保存中(临时态) 点击「保存草稿」 等待写入完成 成功→列表刷新;失败→保留编辑内容
— 删除确认中(临时态) 点击「删除」 弹窗确认是否删除 确认→逻辑删除;取消→返回列表
— 创建活动中(临时态) 点击「创建活动」 载入模板配置并跳转活动创建页 成功→活动创建页(已预填);失败→提示并停留
异常处理
异常场景 触发条件 处理策略 用户提示
config_json 格式错误 JSON 序列化/反序列化失败或字段类型不匹配 前端 JSON Schema 校验拦截 + 后端二次校验,拒绝保存 「规则配置 JSON 格式错误:字段 tier_rules[0].threshold 应为数字类型」
引用已停用的活动类型 启用模板时其关联的活动类型处于 disabled 状态 校验 t_activity_type.status = enabled,不通过则拒绝启用 「关联的活动类型「拼团活动」已停用,请先在活动类型管理中启用」
page_layout_json 区块引用无效 布局配置中引用了不存在的 block_type 前端布局校验器检查 block_type 合法性 「页面布局包含未知区块类型 xxx,请移除后重试」
模板名称重复 保存时模板名称已存在 后端唯一性校验(同活动类型下名称唯一) 「该名称已被使用,请更换模板名称」
删除时有引用 删除被活动实例引用的模板 查询 t_activity 中 template_id 关联记录,存在则拒绝 「该模板已被 N 个活动引用,无法删除,可先停用」
JSON 超长 config_json 或 page_layout_json 超过字段长度限制(64KB) 后端校验 JSON 字符串长度 「配置内容超出大小限制(64KB),请精简区块配置」
9.16 展示活动
核心业务逻辑
展示活动(activity_type=showcase)是以专题页或 Banner 形式聚合商品和优惠券的营销活动,其核心特征是不改变商品价格 ,仅通过视觉呈现和流量引导提升曝光与转化。运营人员配置活动基本信息(名称、时间、适用范围)、页面素材(Banner 图、专题页布局)、关联商品池和关联优惠券池后,提交审核。审核通过后活动进入"已通过"状态,运营手动发布后进入"已发布"状态,到达 start_time 自动转为"进行中"。展示活动中的优惠券领取和商品点击数据实时写入 t_activity_data_stat 统计表,支持活动效果分析。
对齐说明: 展示活动不涉及价格变更,因此不触发 MK-005 底价校验。活动内关联的优惠券独立管理(见优惠券模块),展示活动仅做关联引用。活动状态流转严格遵循 MK-013:草稿→待审核→已通过→已发布→进行中→已结束(驳回可发生在待审核环节)。
交互说明
序号 操作步骤 触发条件 系统行为 预期结果
1 进入活动列表页 点击「营销中心 > 活动管理 > 展示活动」菜单 查询 t_activity WHERE activity_type='showcase',按创建时间倒序展示 展示展示活动列表,含名称、时间、状态、数据概览(浏览/点击/订单)
2 新建展示活动 点击「新建活动」按钮,选择"展示活动"类型 进入活动创建向导,可选择基于模板创建或从空白创建 展示创建向导第一步:基本信息配置
3 填写基本信息 在基本信息页输入活动名称、选择适用范围(全部/指定分销商)、设置起止时间 校验时间合法性(开始时间需大于当前时间,结束时间需大于开始时间),校验名称唯一性 填写完成,可进入下一步
4 上传 Banner 图 在页面配置步骤上传 Banner 图片 校验图片格式(jpg/png/webp)、尺寸(建议 750x300px)、大小(≤2MB),上传至 CDN 上传成功展示预览缩略图;不符规格则提示具体问题
5 配置专题页布局 使用可视化布局编辑器拖拽区块 根据模板 page_layout_json 或空白布局加载区块组件,运营可增删排序区块 布局配置完成,支持实时预览
6 关联商品 在选品步骤点击「添加商品」 弹出商品选择器,展示供应链中心提供的在售商品列表,支持搜索/类目筛选/批量添加 选中商品加入活动商品池,写入 t_activity_product 记录(activity_price=original_price,不改变价格)
7 关联优惠券 在关联券步骤点击「添加优惠券」 展示可用优惠券列表(状态为已发放且未过期的券),支持多选 选中优惠券关联至活动,前端专题页展示领取入口
8 预览活动 点击「预览」按钮 根据当前配置渲染专题页预览,模拟 C 端展示效果 弹窗展示完整专题页预览,含 Banner、商品、券领取区
9 保存草稿 点击「保存草稿」 写入 t_activity 表,status='draft',记录 activity_type='showcase' 提示「已保存为草稿」,可在草稿列表中继续编辑
10 提交审核 点击「提交审核」 校验必填项完整性,通过后 status 更新为 pending_audit,生成审核任务 提示「已提交审核,请等待审核结果」,活动进入待审核列表
11 发布活动 审核通过后点击「发布」 status 更新为 published,若当前时间已到 start_time 则直接转为 ongoing 活动在前端上线,开始统计浏览/点击数据
12 结束活动 到达 end_time 或手动点击「结束」 status 更新为 ended,停止前端展示,保留统计数据 活动下线,可查看活动数据报表
原型
/marketing/showcase-activities
营销中心 / 活动管理 / 展示活动
展示活动管理
活动名称
状态 全部 进行中 已通过 草稿 已结束
查询 重置
+ 新建活动
活动名称 时间 状态 参与商品数 浏览量 操作
暑期旅游专题 2026-07-01~08-31 进行中 28 15,230 数据 编辑 结束
国庆特价精选 2026-10-01~10-07 已通过 15 0 发布 编辑
双十一大促 2026-11-01~11-11 草稿 0 0 编辑 提交 删除
新年特惠 2025-12-25~01-03 已结束 35 42,100 数据 复制
/marketing/showcase-activities/create
营销中心 / 活动管理 / 展示活动 / 新建
新建展示活动
1 基本信息 2 页面配置 3 选品关联券 4 预览
Banner图上传区(建议750x300px,≤2MB)
+ 点击上传Banner图
优惠券模块区
优惠券名称 面额 剩余量 操作
新人专享券 满1000减100 5,000 移除
暑期满减券 满3000减300 2,000 移除
+ 添加优惠券
上一步 下一步 保存草稿
状态说明
状态值 状态名称 触发条件 可执行操作 跳转目标
draft 草稿 新建保存或审核驳回后回退 编辑、提交审核、删除、复制 提交审核→pending_audit
pending_audit 待审核 从草稿提交审核 查看、撤回(回退草稿) 审核通过→approved;审核驳回→rejected→draft
approved 已通过 审核通过(MK-013 流转节点) 发布、编辑(编辑后回退草稿)、查看审核记录 发布→published
published 已发布 审核通过后手动发布 查看、手动结束 到达 start_time→ongoing;手动结束→ended
ongoing 进行中 到达 start_time 自动流转 / 发布时已到开始时间 查看数据、手动结束 到达 end_time→ended;手动结束→ended
ended 已结束 到达 end_time 自动结束 / 手动结束 查看数据报表、复制为新活动 —
rejected 已驳回 审核未通过,自动回退草稿并附审核意见 查看驳回原因、编辑修改后重新提交 修改后重新提交→pending_audit
— 撤回中(临时态) 在待审核状态点击「撤回」 等待状态回退 成功→draft;失败→提示并保留 pending_audit
异常处理
异常场景 触发条件 处理策略 用户提示
必填项缺失 活动名称、时间、Banner 图等必填项为空时提交审核 前端逐项校验,标记缺失字段 「请完善以下必填项:活动名称、活动时间、Banner 图」
Banner 图尺寸不符 上传图片尺寸不在建议范围或文件过大 前端图片处理校验宽高比和文件大小 「Banner 图建议尺寸 750x300px,当前 600x200px 不符合要求」
关联商品已下架 提交审核时关联的商品在供应链中心已下架 提交时调用供应链接口校验商品上架状态,下架商品自动标记并提示移除 「商品「xxx」已下架,请移除后重新提交」
活动时间冲突 同适用范围内活动时间区间重叠 查询 t_activity 同 scope 下时间区间重叠的活动,提示但不强制阻止 「与活动「xxx」时间重叠,是否继续?」(确认后可提交)
优惠券已过期或已领完 提交审核时关联优惠券已过期或库存为 0 校验优惠券状态和剩余库存,标记无效券 「优惠券「xxx」已过期/已领完,请移除或更换」
审核驳回 审核人驳回活动并填写驳回理由 status 更新为 rejected,记录审核意见,自动回退 draft 状态 「活动审核未通过,原因:xxx,请修改后重新提交」
发布后商品库存为 0 活动进行中某商品库存售罄 自动将该商品在活动页标记"已售罄",不影响其他商品展示 前端展示"已售罄"标签,不阻断活动
9.17 满减活动
核心业务逻辑
满减活动(activity_type=full_reduction)是按订单金额门槛阶梯式减免的促销活动。运营配置活动名称、起止时间、适用范围(全部商品/指定类目/指定商品)、多阶梯满减规则(如满300减30、满500减60)和成本承担方(platform/supplier/distributor)。满减在订单结算时按商品实付金额匹配最高满足的阶梯计算减免额,满减金额不超过订单金额本身。满减可与优惠券叠加使用(MK-011),但秒杀商品(order_type=2)排除满减。成本承担方通过财务中心的 settlement_base_price 降低隐式实现(MK-002/MK-003),满减减免金额计入订单 discount_amount 字段(订单 PRD 对齐)。
规则对齐:
MK-002 :每条满减规则必须标记成本承担方,影响财务分账时 settlement_base_price 的调整方向。
MK-003 :C端成交价 = 平台销售价 - 优惠券减免 - 满减减免,满减在优惠券之后计算。
MK-005 :满减后的成交价不得低于商品底价,由供应链中心在活动提交时校验。
MK-011 :满减可与优惠券叠加;不同优惠券互斥;秒杀商品不参与满减计算。
交互说明
序号 操作步骤 触发条件 系统行为 预期结果
1 进入满减活动列表 点击「营销中心 > 活动管理 > 满减活动」 查询 t_activity WHERE activity_type='full_reduction',展示列表 展示满减活动列表,含名称、规则摘要、时间、成本承担方、状态
2 新建满减活动 点击「新建活动」 进入创建向导,可选择基于模板或空白创建 展示创建向导第一步:基本信息
3 填写基本信息 输入活动名称、起止时间、适用范围 校验时间合法性和名称唯一性 进入规则配置步骤
4 配置满减阶梯规则 在规则配置步骤添加阶梯 每行配置:门槛金额、减免金额;支持多阶梯(≥1 行);校验阶梯门槛递增、减免金额递增且不超过门槛 阶梯规则实时校验,不合法行标红提示
5 选择成本承担方 在成本承担步骤选择承担方 下拉选择 platform(平台)/ supplier(供应商)/ distributor(分销商),若选 supplier 则需选择具体供应商 成本承担方确定,影响财务分账配置
6 选品配置 在选品步骤添加商品 根据适用范围(全部/指定类目/指定商品)展示对应商品选择器;调用供应链接口获取商品底价用于 MK-005 校验 选中商品关联至活动,展示商品原价和底价
7 底价校验预检 选品完成后系统自动触发或点击「校验底价」 调用供应链中心接口,模拟满减最大减免后的成交价是否低于商品底价 校验通过显示绿色标识;不通过标红提示具体商品和价差
8 保存草稿 点击「保存草稿」 写入 t_activity 表,status='draft',activity_type='full_reduction' 提示保存成功
9 提交审核 点击「提交审核」 校验必填项和阶梯规则合法性,通过后 status→pending_audit 提示已提交审核
10 查看活动数据 在活动列表点击「数据」 查询 t_activity_data_stat 统计表,展示浏览/点击/订单/支付/满减金额/转化率/ROI 展示活动效果数据报表
11 复制活动 点击「复制」 复制活动配置为新草稿,名称后缀「_副本」,需重新设置时间 生成新草稿活动
12 提前结束活动 进行中活动点击「结束」 弹窗二次确认,确认后 status→ended,前端立即停止满减计算 活动下线,已生成订单不受影响
原型
/marketing/full-reduction-activities
营销中心 / 活动管理 / 满减活动
满减活动管理
活动名称
状态 全部 进行中 草稿 已结束
查询 重置
+ 新建活动
活动名称 门槛规则 适用范围 时间 状态 操作
满300减30 满300减30 全部商品 2026-07-01~08-31 进行中 数据 编辑 结束
满500减60 满500减60 指定类目 2026-07-15~08-15 进行中 数据 编辑 结束
满1000减120 满1000减120 指定商品 2026-08-01~08-31 草稿 编辑 提交 删除
阶梯满减 满300减30/满500减60/满1000减120 全部商品 2026-06-01~09-30 已结束 数据 复制
/marketing/full-reduction-activities/create
营销中心 / 活动管理 / 满减活动 / 新建
新建满减活动
1 基本信息 2 规则配置 3 有效期 4 选品 5 预览
阶梯规则配置表(至少1行,门槛需递增)
+ 添加阶梯
适用范围选择
已选类目:国内跟团游/境外自由行/门票
选品区
商品名称 原价 底价 满减后最低成交价 底价校验
云南丽江5日游 ¥3,280 ¥2,500 ¥3,220(满500减60) 通过
海南三亚4日游 ¥2,680 ¥2,000 ¥2,620(满500减60) 通过
+ 添加商品 重新校验底价
上一步 下一步 保存草稿
状态说明
状态值 状态名称 触发条件 可执行操作 跳转目标
draft 草稿 新建保存或审核驳回后回退 编辑、提交审核、删除、复制 提交审核→pending_audit
pending_audit 待审核 从草稿提交审核 查看、撤回 通过→approved;驳回→rejected→draft
approved 已通过 审核通过 发布、编辑(回退草稿) 发布→published
published 已发布 手动发布 查看、手动结束 到达 start_time→ongoing;手动结束→ended
ongoing 进行中 到达 start_time 自动流转 查看数据、手动结束、调整阶梯(受限) 到达 end_time→ended;手动结束→ended
ended 已结束 到达 end_time 或手动结束 查看数据报表、复制为新活动 —
rejected 已驳回 审核未通过 查看驳回原因、编辑修改后重新提交 修改后重新提交→pending_audit
— 底价校验中(临时态) 选品后触发或手动点击校验 等待供应链接口返回 通过→可提交;失败→标记问题商品
异常处理
异常场景 触发条件 处理策略 用户提示
阶梯金额非递增 第 N 阶门槛金额 ≤ 第 N-1 阶门槛金额 前端校验拦截,标红异常行 「第 2 阶门槛金额 500 需大于第 1 阶 300」
减免金额超过门槛 某阶梯减免金额 ≥ 该阶梯门槛金额 前端校验拦截 「第 1 阶减免金额 300 不可超过门槛金额 300,请调低」
门槛为 0 阶梯门槛金额填写为 0 前端校验拦截 「阶梯门槛金额必须大于 0」
满减后成交价低于底价(MK-005) 模拟满减最大减免后成交价 < 商品底价 提交审核时调用供应链接口校验,不通过则拒绝提交 「商品「xxx」满减后成交价 ¥1,940 低于底价 ¥2,000,请调整满减规则或移除该商品」
成本承担方信息缺失 选择 supplier 承担但未选择具体供应商 前端联动校验 「选择供应商承担时需指定具体供应商」
必填项缺失 活动名称、时间、阶梯规则为空 前端逐项校验 对应字段标红提示「此项为必填项」
进行中商品底价变更 活动进行中供应商调低商品底价导致满减后成交价低于新底价 系统定时任务校验,标记异常商品,通知运营处理 站内消息「活动「xxx」商品底价已变更,满减后可能低于底价,请检查」
9.18 秒杀活动
核心业务逻辑
秒杀活动(activity_type=seckill)是限时限量特价促销活动,通过独立库存池、时段控制、限购策略和防刷机制实现高并发场景下的公平抢购。秒杀活动的核心特征包括:(1) 独立库存池——秒杀库存(stock_pool)独立于商品常规库存,从供应链中心"活动可用库存"中预扣锁定,避免超卖;(2) 库存锁定/释放——下单时锁定库存(locked_count+1),支付成功后转为已售(sold_count+1),支付超时(payment_timeout_min)自动释放库存回滚;(3) 时段控制——支持单日多时段配置(time_slots JSON),每个时段独立库存配额;(4) 限购防刷——per_user_limit 控制单人限购数量,anti_fraud_config 配置 IP 限制、设备指纹限制、验证码开关等防刷策略。秒杀商品生成的订单 order_type=2(订单 PRD 对齐),秒杀商品不参与满减(MK-011),秒杀价不得低于商品底价(MK-005)。
关键规则对齐:
MK-005 :秒杀价 ≥ 商品底价,提交审核时由供应链中心校验,不通过则拒绝。
MK-006 :秒杀独立库存池 + 锁定/释放机制。下单锁定→支付成功转已售→支付超时释放。stock_pool = locked_count + sold_count + 剩余可用。
MK-014 :支付超时(payment_timeout_min)后系统自动取消订单并释放库存,库存回滚至可用池。
MK-011 :秒杀商品(order_type=2)排除满减计算。
订单 PRD :秒杀订单 order_type=2,price_snapshot 记录秒杀成交价,discount_amount 仅记录优惠券减免(秒杀本身降价不记入 discount_amount,而是直接体现在 price_snapshot 中)。
交互说明
序号 操作步骤 触发条件 系统行为 预期结果
1 进入秒杀活动列表 点击「营销中心 > 活动管理 > 秒杀活动」 查询 t_activity WHERE activity_type='seckill' JOIN t_seckill_activity,展示列表 展示秒杀活动列表,含名称、日期、时段、库存概览、状态
2 新建秒杀活动 点击「新建活动」 进入创建向导,可选择基于模板或空白创建 展示创建向导第一步:基本信息
3 填写基本信息 输入活动名称、秒杀日期、适用范围 校验日期合法性(秒杀日期需大于当前日期),校验名称唯一性 进入时段配置步骤
4 配置抢购时段 在时段配置步骤添加时段 每行配置:时段名称、开始时间、结束时间;校验时段不重叠且在活动日期内;序列化为 time_slots JSON 时段列表实时更新,支持拖拽排序
5 选品并定价 在选品步骤添加商品 展示商品选择器,选中后填写秒杀价;调用供应链接口获取商品底价用于 MK-005 校验和"活动可用库存"获取 商品列表展示原价、秒杀价、底价、可用库存、底价校验状态
6 配置秒杀库存 为每个商品+时段组合设置秒杀库存 从供应链中心预扣"活动可用库存"至 stock_pool;校验 stock_pool ≤ 供应链可用库存;写入 t_seckill_activity 和 t_activity_product 库存池配置完成,locked_count=0,sold_count=0
7 配置每人限购 设置 per_user_limit 值 校验 per_user_limit ≥ 1,建议 ≤ 5;该值影响下单时用户维度库存校验 限购数设置完成
8 配置防刷策略 在防刷配置步骤设置策略 配置 anti_fraud_config JSON:IP 限制(同 IP 限购数)、设备指纹限制(同设备限购数)、验证码开关(强制/智能触发)、购买频率限制 防刷策略配置完成
9 设置支付超时 配置 payment_timeout_min 设置支付超时时间(默认 15 分钟,可调 5-60 分钟);超时后触发订单取消+库存释放 超时时间设置完成
10 预览活动 点击「预览」 渲染秒杀活动页预览,展示时段倒计时、商品秒杀价、库存进度条 弹窗展示完整秒杀页预览
11 保存草稿 点击「保存草稿」 写入 t_activity(status=draft)+ t_seckill_activity + t_activity_product;库存预扣暂不执行 提示保存成功
12 提交审核 点击「提交审核」 校验必填项、底价合规(MK-005)、时段不重叠、库存>0;通过后 status→pending_audit 提示已提交审核
13 发布并预热 审核通过后点击「发布」 status→published;发布时从供应链中心执行库存预扣(锁定 stock_pool 到秒杀池);到达预热时间转为 preparing 库存预扣成功,前端展示"即将开始"倒计时
14 查看实时数据 活动中点击「数据」 实时查询 t_seckill_activity(locked_count/sold_count)+ t_activity_data_stat,展示库存消耗进度、下单数、支付数、转化率 展示秒杀实时数据看板
原型
/marketing/seckill-activities
营销中心 / 活动管理 / 秒杀活动
秒杀活动管理
活动名称
状态 全部 进行中 已通过 草稿 已结束
查询 重置
+ 新建活动
活动名称 日期 时段 商品数 库存 已售 状态 操作
暑期秒杀第一波 2026-07-15 10:00-12:00 8 500 423 进行中 数据 结束
暑期秒杀第二波 2026-07-22 14:00-16:00 6 300 0 已通过 发布 编辑
国庆秒杀 2026-10-01 10:00-18:00 12 1,000 0 草稿 编辑 提交 删除
双十一秒杀 2026-11-11 00:00-23:59 20 2,000 1,985 已结束 数据 复制
/marketing/seckill-activities/create
营销中心 / 活动管理 / 秒杀活动 / 新建
新建秒杀活动
1 基本信息 2 时段配置 3 选品定价 4 库存配置 5 防刷配置 6 预览
上一步 下一步 保存草稿
/marketing/seckill-activities/create
营销中心 / 活动管理 / 秒杀活动 / 新建
新建秒杀活动
1 基本信息 2 时段配置 3 选品定价 4 库存配置 5 防刷配置 6 预览
防刷策略配置(anti_fraud_config)
支付超时时间(payment_timeout_min)
上一步 下一步 保存草稿
状态说明
状态值 状态名称 触发条件 可执行操作 跳转目标
draft 草稿 新建保存或审核驳回后回退 编辑、提交审核、删除、复制 提交审核→pending_audit
pending_audit 待审核 从草稿提交审核 查看、撤回 通过→approved;驳回→rejected→draft
approved 已通过 审核通过(含 MK-005 底价校验) 发布、编辑(回退草稿) 发布→published
published 已发布 手动发布,库存预扣至秒杀池 查看、取消发布(释放库存) 到达预热时间→preparing
preparing 预热中 到达预热时间(start_time 前 N 分钟),前端展示"即将开始" 查看、紧急下线 到达 start_time→ongoing
ongoing 进行中 到达 start_time,时段开始 查看实时数据、紧急结束 到达 end_time→ended;手动结束→ended
ended 已结束 所有时段结束 / 手动结束 查看数据报表、库存释放确认 —
rejected 已驳回 审核未通过(底价校验失败等) 查看驳回原因、编辑修改后重新提交 修改后重新提交→pending_audit
— 库存预扣中(临时态) 点击「发布」时从供应链预扣库存 等待预扣完成 成功→published;失败→提示并停留 approved
异常处理
异常场景 触发条件 处理策略 用户提示
秒杀价低于底价(MK-005) 提交审核时秒杀价 < 商品底价 调用供应链中心接口校验,不通过则拒绝提交 「商品「xxx」秒杀价 ¥1,990 低于底价 ¥2,000,请调高秒杀价或移除该商品」
秒杀库存为 0 某商品秒杀库存池配额填写为 0 前端校验拦截 「商品「xxx」秒杀库存必须大于 0」
秒杀库存超过供应链可用库存 stock_pool > 供应链"活动可用库存" 调用供应链接口校验可用量,超出则拒绝 「商品「xxx」秒杀库存 100 超过供应链可用库存 80,请调低秒杀库存」
时段重叠 两个时段的时间区间存在交集 前端校验时段区间不重叠 「时段「午场秒杀」(14:00-15:00) 与「早场秒杀」(10:00-15:00) 时间重叠,请调整」
限购数过大 per_user_limit 超过库存池的合理比例(如 > stock_pool/10) 前端警告提示但不强制阻止 「限购数 20 较大,可能导致少数用户抢完库存,建议设置 1-5」
库存预扣失败 发布时从供应链预扣库存,但供应链库存已被其他活动占用 回滚预扣操作,活动保持 approved 状态 「库存预扣失败:商品「xxx」可用库存不足,请调整秒杀库存或稍后重试」
支付超时释放库存(MK-014) 用户下单后 payment_timeout_min 内未完成支付 订单中心定时任务检测超时订单,取消订单,locked_count-1,库存回滚至可用池 用户端「您的订单因支付超时已取消,库存已释放」
高并发超卖风险 并发下单量瞬时超过剩余库存 库存扣减使用 Redis 原子操作 + 数据库乐观锁双重保障;扣减失败返回库存不足 用户端「当前秒杀商品已被抢完」
防刷拦截 触发 IP 限制/设备限制/频率限制 拦截下单请求,记录风控日志 用户端「操作过于频繁,请稍后再试」或触发验证码
9.19 拼团活动
核心业务逻辑
拼团活动(activity_type=group_buy)是通过多人成团享受优惠价格的社会化裂变营销活动。系统支持三种拼团类型:普通拼团(normal,任意用户参与成团)、老带新拼团(bring_new,团员中需包含至少 1 名新用户方可成团)、阶梯拼团(tiered,不同成团人数对应不同优惠价)。运营配置活动名称、起止时间、商品、拼团价、成团人数(最小/最大)、成团时限(validity_hours)和失败处理策略。拼团价不得低于商品底价(MK-005)。用户发起拼团后,系统在 validity_hours 内等待成团人数达标;若超时未成团则自动触发失败处理:退款+退券+佣金作废(逆向分账 MK-007/MK-008)。成团后订单按拼团价成交,price_snapshot 记录拼团成交价。
关键规则对齐:
MK-005 :拼团价 ≥ 商品底价,提交审核时由供应链中心校验。
MK-007 :拼团未成团(超时未满员)自动触发退款 + 退券。已使用的优惠券退回用户券包,优惠券有效期不延长。
MK-008 :逆向分账——退款按「佣金→货款→服务费」顺序扣回。拼团失败退款时,已结算的分销佣金优先扣回,其次货款,最后服务费。财务中心通过 settlement_base_price 回滚调整。
失败处理 :fail_action 固定为 auto_refund(自动退款退券),不支持手动处理模式。
交互说明
序号 操作步骤 触发条件 系统行为 预期结果
1 进入拼团活动列表 点击「营销中心 > 活动管理 > 拼团活动」 查询 t_activity WHERE activity_type='group_buy' JOIN t_group_buy_activity,展示列表 展示拼团活动列表,含名称、拼团类型、成团人数、拼团价、状态
2 新建拼团活动 点击「新建活动」 进入创建向导,可选择基于模板或空白创建 展示创建向导第一步:基本信息
3 填写基本信息 输入活动名称、起止时间、适用范围 校验时间合法性和名称唯一性 进入拼团配置步骤
4 选择拼团类型 在拼团配置步骤选择类型 展示三种类型卡片:普通拼团/老带新拼团/阶梯拼团;选择后加载对应配置表单 类型确定,展示对应的成团规则配置
5 配置成团规则 根据拼团类型填写成团参数 普通/老带新:填写最小成团人数、最大成团人数、成团时限;阶梯:填写多组成团人数与对应拼团价;校验 min_members ≤ max_members,validity_hours > 0 成团规则配置完成
6 选品并定价 在选品步骤添加商品 展示商品选择器,选中后填写拼团价;调用供应链接口获取商品底价用于 MK-005 校验 商品列表展示原价、拼团价、底价、底价校验状态
7 配置失败处理 设置 fail_action 固定为 auto_refund(自动退款退券),展示逆向分账规则说明(MK-007/MK-008) 失败处理策略确认
8 底价校验预检 选品完成后自动触发或点击「校验底价」 调用供应链中心接口,校验拼团价是否 ≥ 商品底价 校验通过显示绿色标识;不通过标红提示
9 预览活动 点击「预览」 渲染拼团活动页预览,展示拼团进度、成团倒计时、拼团价 弹窗展示完整拼团页预览
10 保存草稿 点击「保存草稿」 写入 t_activity(status=draft)+ t_group_buy_activity + t_activity_product 提示保存成功
11 提交审核 点击「提交审核」 校验必填项、底价合规(MK-005)、成团人数合理性、时限>0;通过后 status→pending_audit 提示已提交审核
12 查看拼团数据 活动中点击「数据」 查询 t_activity_data_stat + 拼团明细表,展示发起团数、成团率、参团人数、退款数 展示拼团活动数据报表
13 查看拼团明细 点击「拼团明细」 展示每个拼团实例的团长、团员、成团状态、倒计时、退款状态 展示拼团实例列表
原型
/marketing/group-buy-activities
营销中心 / 活动管理 / 拼团活动
拼团活动管理
活动名称
状态 全部 进行中 草稿 已结束
查询 重置
+ 新建活动
活动名称 拼团类型 成团人数 拼团价 时间 状态 操作
3人成团旅游套餐 普通拼团 3-5人 ¥2,680 2026-07-01~08-31 进行中 数据 明细 结束
5人老带新拼团 老带新拼团 5人 ¥1,980 2026-07-15~08-15 进行中 数据 明细 结束
阶梯拼团3-5-10人 阶梯拼团 3-10人 ¥1,580起 2026-08-01~09-30 草稿 编辑 提交 删除
国庆拼团特惠 普通拼团 3人 ¥2,280 2026-10-01~10-07 已结束 数据 明细 复制
/marketing/group-buy-activities/create
营销中心 / 活动管理 / 拼团活动 / 新建
新建拼团活动
1 基本信息 2 拼团配置 3 选品定价 4 预览
上一步 下一步 保存草稿
状态说明
状态值 状态名称 触发条件 可执行操作 跳转目标
draft 草稿 新建保存或审核驳回后回退 编辑、提交审核、删除、复制 提交审核→pending_audit
pending_audit 待审核 从草稿提交审核 查看、撤回 通过→approved;驳回→rejected→draft
approved 已通过 审核通过(含 MK-005 底价校验) 发布、编辑(回退草稿) 发布→published
published 已发布 手动发布 查看、手动结束 到达 start_time→ongoing;手动结束→ended
ongoing 进行中 到达 start_time 自动流转 查看数据、查看拼团明细、手动结束 到达 end_time→ended;手动结束→ended
ended 已结束 到达 end_time 或手动结束 查看数据报表、查看拼团明细、复制为新活动 —
rejected 已驳回 审核未通过 查看驳回原因、编辑修改后重新提交 修改后重新提交→pending_audit
— 拼团失败处理中(临时态) 拼团超时未成团,触发 auto_refund 系统自动执行退款+退券+佣金作废 成功→退款完成;失败→人工介入
异常处理
异常场景 触发条件 处理策略 用户提示
拼团价低于底价(MK-005) 提交审核时拼团价 < 商品底价 调用供应链中心接口校验,不通过则拒绝提交 「商品「xxx」拼团价 ¥1,990 低于底价 ¥2,000,请调高拼团价或移除该商品」
最小人数大于最大人数 min_members > max_members 前端校验拦截 「最小成团人数 5 不可大于最大成团人数 3,请调整」
成团时限为 0 validity_hours ≤ 0 前端校验拦截 「成团时限必须大于 0,建议设置 12-48 小时」
拼团超时未成团(MK-007) 拼团发起后 validity_hours 内未达到 min_members 系统定时任务检测超时拼团,自动执行 auto_refund:退款至用户原支付渠道,退回已使用优惠券,作废已结算佣金 用户端「您的拼团未在规定时间内成团,已自动退款 ¥xxx,优惠券已退回」
逆向分账扣回失败(MK-008) 拼团失败退款时佣金已提现,无法扣回 标记为异常分账记录,转人工处理;货款正常退款,佣金挂账追回 运营端站内消息「拼团 xxx 逆向分账异常:佣金 ¥xx 已提现,需人工追回」
老带新拼团无新用户 老带新拼团成团时检测到所有团员均为老用户 拒绝成团,拼团继续等待新用户加入至超时 用户端「当前拼团缺少新用户参与,邀请好友加入即可成团」
退券时优惠券已过期 拼团失败退券时优惠券已过有效期 优惠券退回但状态标记为已过期,用户不可再使用;补偿等值积分(可选) 用户端「优惠券已退回,但因已过期无法继续使用」
部分团员已支付部分未支付 拼团超时,部分团员已支付部分未支付 已支付团员自动退款退券,未支付团员订单自动取消 已支付团员「拼团未成团,已退款」;未支付团员「拼团已取消」
9.20 活动审核
核心业务逻辑
活动审核是活动从草稿进入发布流程的关键管控节点,确保所有上线活动满足信息完整性、价格合规性和时间合理性要求。审核模块统一处理四类活动(展示/满减/秒杀/拼团)的审核请求。审核维度包括:(1) 活动信息完整性——校验必填项、关联商品/优惠券是否有效;(2) 价格合规性——满减后成交价/秒杀价/拼团价是否不低于商品底价(MK-005),由供应链中心提供底价校验接口;(3) 时间合理性——活动时间区间是否合理、是否存在同范围活动时间冲突;(4) 成本承担方确认——审核人确认成本承担方信息正确(MK-002)。审核通过后活动进入"已通过"状态可被发布;审核驳回则附审核意见回退草稿。支持单条审核和批量审核。审核记录留存可追溯。
对齐说明: 活动审核严格遵循 MK-013 状态流转:活动从 draft 提交后进入 pending_audit,审核结果为 approved 或 rejected。批量审核时同一批活动的审核结果保持一致(全通过或全驳回),避免部分通过导致配置不一致。底价校验(MK-005)在审核阶段由系统自动执行,审核人可查看校验结果但无需手动操作。
交互说明
序号 操作步骤 触发条件 系统行为 预期结果
1 进入待审核列表 点击「营销中心 > 活动管理 > 活动审核」 查询 t_activity WHERE status='pending_audit',按提交时间正序展示 展示待审核活动列表,含名称、类型、提交人、提交时间、审核优先级
2 筛选待审核活动 按活动类型/提交时间/提交人筛选 按筛选条件查询 展示筛选后的待审核列表
3 进入审核详情页 点击某活动的「审核」操作 加载活动完整配置:基本信息 + 规则配置 + 选品定价 + 成本承担方;自动执行底价校验(MK-005)并展示结果 展示审核详情页,含活动信息、价格校验结果、成本承担方信息
4 查看底价校验结果 在审核详情页查看价格合规性区域 系统已自动调用供应链接口完成底价校验,展示每个商品的底价、活动价、校验结果(通过/不通过) 审核人确认价格合规性
5 查看成本承担方 在审核详情页查看成本承担方区域 展示 cost_bearer(platform/supplier/distributor)和 bearer_id;满减活动展示阶梯规则与成本分摊逻辑 审核人确认成本承担方信息正确
6 查看时间合理性 在审核详情页查看时间区域 展示活动时间区间,系统自动检测同范围内是否有时间冲突的活动并标记 审核人确认时间合理性
7 审核通过 确认无误后点击「通过」 status 更新为 approved,记录审核人、审核时间、审核意见;活动进入可发布状态 提示「审核通过」,活动进入已通过列表
8 审核驳回 发现问题点击「驳回」 弹出驳回意见输入框(必填),填写后 status 更新为 rejected,自动回退 draft 并附审核意见 提示「已驳回」,活动创建人收到站内消息通知
9 批量审核 勾选多条活动后点击「批量通过」或「批量驳回」 批量更新状态,批量驳回需填写统一驳回意见;批量操作前二次确认 提示「已批量审核 N 条活动」
10 查看审核记录 在活动详情页点击「审核记录」 查询审核日志表,展示历次审核记录(审核人、时间、结果、意见) 展示审核历史时间线
原型
/marketing/activity-audit
营销中心 / 活动管理 / 活动审核
活动审核
活动名称 类型 提交人 提交时间 成本承担方 操作
暑期满300减30满500减60 满减 张运营 2026-07-10 14:30 平台承担 审核
7.20秒杀狂欢日 秒杀 李营销 2026-07-12 09:00 平台承担 审核
云南丽江3人拼团游 拼团 王推广 2026-07-13 16:00 供应商承担 审核
国庆旅游展示专题 展示 张运营 2026-07-14 10:15 平台承担 审核
暑期新人代金券活动 满减 李营销 2026-07-14 15:30 分销商承担 审核
/marketing/activity-audit/detail
营销中心 / 活动管理 / 活动审核 / 详情
审核详情 - 7.20秒杀狂欢日
活动信息(只读)
字段 值 字段 值
活动名称 7.20秒杀狂欢日 活动类型 秒杀活动(seckill)
活动时间 2026-07-20 10:00~21:00 成本承担方 平台承担(platform)
时段配置 3个时段:10:00-11:00/14:00-15:00/20:00-21:00 支付超时 15分钟
价格校验结果表(MK-005)
商品 原价 活动价 底价 是否合规
云南丽江5日游 ¥3,280 ¥2,580 ¥2,500 合规
海南三亚4日游 ¥2,680 ¥1,990 ¥2,000 不合规(低于底价¥10)
桂林漓江竹筏漂流 ¥180 ¥128 ¥100 合规
成本承担方确认
字段 值
成本承担方 平台承担(platform)
承担主体ID -(平台承担时为空)
满减分摊逻辑 减免金额计入平台营销费用,settlement_base_price不变
通过 驳回 返回列表
状态说明
状态值 状态名称 触发条件 可执行操作 跳转目标
pending_audit 待审核 活动从草稿提交审核 审核通过、审核驳回、查看详情、批量操作 通过→approved;驳回→rejected→draft
approved 已通过 审核人点击「通过」,底价校验通过 发布、查看审核记录 发布→published
rejected 已驳回 审核人点击「驳回」并填写驳回意见 查看驳回原因、编辑修改后重新提交 修改后重新提交→pending_audit
— 底价校验中(临时态) 进入审核详情页时系统自动执行 等待校验结果 通过→可手动通过;不通过→系统建议驳回
— 批量审核确认中(临时态) 点击「批量通过」或「批量驳回」 弹窗二次确认 确认→批量更新状态;取消→返回列表
— 审核提交中(临时态) 点击「通过」或「驳回」后请求发出 等待响应 成功→状态更新;失败→提示并保留当前页
— 时间冲突检测中(临时态) 进入审核详情页时系统自动检测 等待检测结果 有冲突→标记提示;无冲突→正常展示
异常处理
异常场景 触发条件 处理策略 用户提示
底价校验失败(MK-005) 系统自动校验发现活动价低于商品底价 审核详情页标红提示,系统建议驳回;审核人仍可手动通过但需二次确认 「商品「xxx」活动价低于底价,建议驳回并通知创建人调整」
成本承担方信息缺失(MK-002) 满减/秒杀/拼团活动未设置成本承担方或 bearer_id 为空 审核时校验 cost_bearer 和 bearer_id 完整性,缺失则拒绝通过 「成本承担方信息不完整,请驳回并通知创建人补充」
活动时间冲突 同适用范围内活动时间区间与已有活动重叠 系统标记冲突活动但不强制阻止审核,由审核人判断 「与活动「xxx」时间重叠(2025-07-20 10:00~21:00),请确认是否通过」
供应链接口超时 审核时调用供应链中心底价校验接口超时 重试 3 次后仍超时则标记为「校验异常」,审核人可手动核实或驳回 「底价校验服务暂时不可用,请稍后重试或手动核实商品底价」
驳回意见为空 点击「驳回」但未填写审核意见 前端校验拦截 「驳回时请填写审核意见,以便创建人修改」
批量审核含不同类型 批量审核选中了不同类型的活动 允许批量操作但提示审核人注意类型差异;秒杀活动底价校验结果可能不同 「选中活动包含多种类型,请逐一确认底价校验结果」
审核人无权限 当前用户无审核权限 后端权限校验拦截,拒绝审核操作 「您没有活动审核权限,请联系管理员」
16. 供应商活动参与功能模块详解
本章描述供应商在PC端后台参与平台营销活动的功能设计,包含"可参与活动"和"我的活动"两个功能点。供应商通过活动报名审核制(MK-015)参与平台发布的营销活动,实现供应链与营销中心的活动联动。供应商报名的商品经平台审核通过后纳入活动商品范围,审核通过的活动商品可通过分销链接进行推广(对齐分销PRD)。
章节概述: 本章功能面向供应商后台 角色,核心数据表为 t_supplier_activity_apply(供应商活动报名表)。功能依赖 t_activity(活动主表)中状态为 published/ongoing 且 applicable_scope 允许供应商参与的活动记录。对齐全局规则 MK-015(供应商活动报名审核制)、MK-005(活动价格不得低于商品底价)、MK-013(活动状态流)。
9.21 可参与活动
功能概述: 供应商在后台查看平台发布的可参与活动列表(状态为 published/ongoing 且 applicable_scope 允许供应商参与的活动),选择目标活动后进行商品报名。供应商需选择符合活动条件的商品、填写报名理由,提交后进入审核流程。同一供应商对同一活动仅可报名一次,但可在一次报名中选择多个商品。报名提交后状态为 pending(待审核),等待平台审核。
16.1.1 核心逻辑
属性 说明
功能编号
9.21
功能名称
可参与活动
业务目标
供应商浏览并参与平台发布的营销活动,通过报名审核后将商品纳入活动范围,实现平台活动与供应商商品的联动推广
操作角色
供应商后台用户(供应商管理员/供应商运营人员)
触发条件
平台活动状态为 published 或 ongoing,且 t_activity.applicable_scope 包含"供应商参与"范围
核心业务规则
R1. 仅展示状态为 published/ongoing 且 applicable_scope 允许供应商参与的活动,已结束(ended)或草稿(draft)状态活动不展示。
R2. 同一供应商(supplier_id)对同一活动(activity_id)仅允许提交一次有效报名申请;若已有 pending/approved 状态的报名记录,禁止再次报名。
R3. 一次报名可选择多个商品,product_ids 以 JSON 数组格式存储(例:["P001","P002","P003"])。
R4. 报名商品需校验:①商品状态为"在售";②商品库存 ≥ 活动要求的最低库存阈值;③商品类型与活动类型(activity_type)匹配;④活动价格不得低于商品底价(MK-005 )。
R5. 报名需在活动报名截止时间前提交,截止时间后不可报名(报名截止时间由活动配置决定,默认为活动开始前24小时)。
R6. 报名理由为必填项,字数限制 10-500 字。
R7. 提交后报名状态为 pending(待审核),进入平台审核流程(MK-015 )。
R8. 活动成本承担方(cost_bearer/bearer_id)在活动详情中展示,供应商报名时需知晓并接受成本分摊规则。
关联数据表
t_supplier_activity_apply(供应商活动报名表,主操作表)、t_activity(活动主表,数据来源)、t_product(商品表,商品校验)、t_supplier(供应商表,身份校验)
关联全局规则
MK-005(活动价格不得低于商品底价)、MK-013(活动状态流)、MK-015(供应商活动报名审核制)
PRD对齐
供应链PRD: 供应商活动报名需校验商品状态和库存;
分销PRD: 供应商活动商品(审核通过后)可通过分销链接推广
关键字段映射
t_supplier_activity_apply.id → 报名记录主键
t_supplier_activity_apply.activity_id → 关联活动ID(FK → t_activity.id)
t_supplier_activity_apply.supplier_id → 供应商ID
t_supplier_activity_apply.product_ids → 报名商品ID列表(JSON数组)
t_supplier_activity_apply.apply_status → 报名状态(pending/approved/rejected/withdrawn)
t_supplier_activity_apply.apply_reason → 报名理由
t_supplier_activity_apply.audit_opinion → 审核意见(平台审核时填写)
t_supplier_activity_apply.created_at → 报名时间
16.1.2 交互说明
步骤 操作角色 操作动作 系统响应 备注
1
供应商用户
登录供应商后台,点击左侧菜单"营销中心 → 可参与活动"
系统加载可参与活动列表页,查询 t_activity 表中 status IN ('published','ongoing') 且 applicable_scope 包含供应商参与范围的活动记录,按 start_time 倒序展示
默认展示全部可参与活动,分页每页20条
2
供应商用户
在筛选区选择活动类型(展示/满减/秒杀/拼团)和/或输入活动名称关键词,点击"查询"
系统按筛选条件过滤活动列表,更新表格数据
活动类型对应 activity_type 字枚举值
3
供应商用户
点击某活动行的"查看详情"按钮
弹出活动详情弹窗/跳转详情页,展示:活动名称、活动类型、活动时间(start_time ~ end_time)、参与条件、成本承担方(cost_bearer)、报名截止时间、活动规则说明
详情页为只读展示
4
供应商用户
在活动列表中点击目标活动行的"报名"按钮
系统先校验该供应商是否已对该活动提交过报名(查询 t_supplier_activity_apply 中 activity_id + supplier_id 且 apply_status IN ('pending','approved')),若已存在则提示"您已报名该活动,请勿重复报名"并终止;校验通过则打开报名弹窗
重复报名校验(R2)
5
供应商用户
在报名弹窗中,系统加载该供应商的在售商品列表
系统查询 t_product 表中属于当前供应商且状态为"在售"的商品,并根据活动类型(activity_type)和参与条件标记符合条件的商品(可勾选)与不符合条件的商品(置灰禁选,tooltip 提示原因)
商品条件校验(R4)
6
供应商用户
勾选一个或多个商品,为每个商品设置活动价格(秒杀/满减类活动需要)
系统实时校验活动价格 ≥ 商品底价(MK-005),不满足时输入框标红并提示"活动价格不得低于商品底价 ¥XXX"
底价校验(MK-005)
7
供应商用户
在"报名理由"文本域中填写报名说明(10-500字)
系统实时统计字数,不足10字或超过500字时提示
必填校验(R6)
8
供应商用户
点击"提交报名"按钮
系统执行提交前校验:①商品选择数量 ≥ 1;②报名理由字数合规;③活动报名未截止;④商品状态和库存仍满足要求。校验通过后创建 t_supplier_activity_apply 记录,apply_status = 'pending',created_at = 当前时间。提交成功后提示"报名提交成功,等待平台审核",关闭弹窗,刷新列表
状态初始化为 pending(R7)
9
供应商用户
点击"取消"或关闭弹窗
若有未保存的填写内容,提示"确认放弃当前编辑?";确认后关闭弹窗不做任何数据变更
防误操作
16.1.3 原型示意
/supplier/activities/available
供应商工作台 / 营销活动 / 活动申请
可参与活动
活动类型 全部 展示活动 满减活动 秒杀活动 拼团活动
活动名称
查询 重置
活动名称 类型 时间 参与条件 报名截止 状态 操作
暑期满减大促 满减活动 2026-07-15~08-15 在售商品,库存≥100 2026-07-14 18:00 进行中 报名
国庆秒杀活动 秒杀活动 2026-10-01 在售商品,库存≥200 2026-09-28 12:00 已发布 报名
双十一拼团特惠 拼团活动 2026-11-01~11-11 在售商品,库存≥50 2026-10-30 18:00 已发布 报名
新年展示专题 展示活动 2026-12-25~01-03 在售商品 2026-12-20 18:00 已发布 报名
/supplier/activities/available
供应商工作台 / 营销活动 / 活动申请
可参与活动
活动信息 活动名称:暑期满减大促 | 类型:满减活动 | 时间:2026-07-15~08-15 | 成本承担:供应商承担50%
商品选择区(勾选报名商品)
16.1.4 状态说明
报名记录(t_supplier_activity_apply.apply_status)的状态流转如下:
当前状态 触发事件 目标状态 操作角色 说明
-
供应商提交报名
pending(待审核)
供应商
报名记录创建,apply_status 初始化为 pending,等待平台审核
pending(待审核)
平台审核通过
approved(已通过)
平台审核员
平台在活动审核管理中审核通过,audit_opinion 填入审核意见,报名商品纳入活动商品范围
pending(待审核)
平台审核驳回
rejected(已驳回)
平台审核员
平台审核不通过,audit_opinion 填入驳回原因,供应商可查看驳回原因后重新报名其他活动
pending(待审核)
供应商主动撤回
withdrawn(已撤回)
供应商
供应商在"我的活动"页面撤回报名,撤回后不可恢复;该活动允许供应商重新报名(因原报名已非 pending/approved 状态)
approved(已通过)
活动结束
approved(已通过)
系统自动
报名状态保持 approved,活动结束后供应商可在"我的活动"中查看参与商品的销售数据
rejected(已驳回)
-
-
-
终态,不可变更
withdrawn(已撤回)
-
-
-
终态,不可恢复,但供应商可对该活动重新发起报名
状态流转图:
pending(待审核)→ approved(已通过)|→ rejected(已驳回)|→ withdrawn(已撤回)
16.1.5 异常处理
异常编号 异常场景 触发条件 处理方式 提示信息
EX-9.21-01
重复报名
供应商对同一活动已存在 pending 或 approved 状态的报名记录
拦截报名操作,不打开报名弹窗,按钮置灰或点击后提示
"您已报名该活动,请勿重复报名。可在'我的活动'中查看报名状态。"
EX-9.21-02
商品不符合活动条件
所选商品状态非"在售"、库存低于活动最低阈值、或商品类型与活动类型不匹配
不符合条件的商品在商品选择列表中置灰禁选,鼠标悬停展示具体原因
"该商品不符合活动条件:{具体原因,如'库存不足,需≥50'/'商品类型不匹配'}"
EX-9.21-03
活动价格低于底价
供应商为商品设置的活动价格 < 商品底价(违反 MK-005)
输入框标红,实时拦截,提交按钮禁用
"活动价格不得低于商品底价 ¥{底价金额},请调整后提交"
EX-9.21-04
活动已截止报名
当前时间晚于活动报名截止时间
活动列表中该活动的"报名"按钮置灰禁用
"该活动报名已截止"
EX-9.21-05
未选择任何商品
供应商未勾选任何商品即点击"提交报名"
提交校验失败,阻止提交
"请至少选择一个商品进行报名"
EX-9.21-06
报名理由不合规
报名理由为空、少于10字或超过500字
提交校验失败,阻止提交,聚焦到理由输入框
"报名理由不能为空" / "报名理由至少10个字" / "报名理由不能超过500个字"
EX-9.21-07
活动状态变更
供应商在报名填写过程中,活动状态从 published/ongoing 变更为 ended 或被下架
提交时校验活动当前状态,若活动已不可参与,提示并关闭弹窗
"该活动已结束/已下架,无法报名"
EX-9.21-08
商品库存并发变更
供应商填写报名期间,商品库存被其他操作修改导致不再满足活动最低库存要求
提交时重新校验商品库存,不满足则提示具体商品
"商品'{商品名称}'当前库存不满足活动要求(需≥{阈值}),请移除后重新提交"
EX-9.21-09
网络异常/提交超时
提交报名时网络中断或服务端响应超时
前端 loading 超时(15秒)后提示,保留用户已填内容不丢失
"网络异常,请检查网络后重试。您的填写内容已保存。"
9.22 我的活动
功能概述: 供应商查看自己已报名的活动及审核状态。展示活动名称、报名时间、审核状态、审核意见等信息。供应商可对待审核(pending)状态的报名执行撤回操作;可查看报名详情。审核通过(approved)后,供应商可在活动详情中查看参与商品的销售数据(销量、销售额、转化率等),实现活动效果闭环跟踪。
16.2.1 核心逻辑
属性 说明
功能编号
9.22
功能名称
我的活动
业务目标
供应商管理自己的活动报名记录,跟踪审核进度,撤回误报申请,查看审核通过后的活动销售数据,实现供应商侧的活动参与闭环
操作角色
供应商后台用户(供应商管理员/供应商运营人员)
触发条件
供应商登录后台,进入"营销中心 → 我的活动"页面
核心业务规则
R1. 列表仅展示当前登录供应商(supplier_id)的报名记录,按 created_at 倒序排列。
R2. 筛选条件支持:审核状态(pending/approved/rejected/withdrawn)、活动名称关键词、报名时间范围。
R3. 撤回操作仅允许在 pending(待审核)状态下执行;approved/rejected/withdrawn 状态不可撤回。
R4. 若活动已进入 ongoing(进行中)状态,即使报名仍为 pending,也不允许撤回(活动已开始,撤回无意义)。
R5. 撤回需二次确认,确认后 apply_status 变更为 withdrawn,不可恢复。
R6. 审核通过(approved)的报名,详情页展示参与商品的销售数据:销量、销售额、转化率、退款率等。数据实时性为 T+1(每日凌晨同步前一日数据)。
R7. 列表展示审核意见(audit_opinion),驳回状态下必填展示,通过状态下可选展示。
R8. 活动结束后,报名记录保留可查,销售数据冻结为最终值。
关联数据表
t_supplier_activity_apply(供应商活动报名表,主操作表)、t_activity(活动主表,关联查询)、t_product(商品表,商品信息展示)、t_order(订单表,销售数据统计)
关联全局规则
MK-015(供应商活动报名审核制)、MK-013(活动状态流)
PRD对齐
供应链PRD: 供应商活动报名状态全程可追溯;
分销PRD: 审核通过的活动商品可通过分销链接推广,销售数据含分销渠道数据
关键字段映射
t_supplier_activity_apply.apply_status → 审核状态展示
t_supplier_activity_apply.apply_reason → 报名理由展示
t_supplier_activity_apply.audit_opinion → 审核意见展示
t_supplier_activity_apply.created_at → 报名时间展示
t_supplier_activity_apply.product_ids → 参与商品列表(JSON解析后关联 t_product 展示商品名称/图片)
销售数据来源:关联 t_order 中活动ID + 商品ID的订单统计
16.2.2 交互说明
步骤 操作角色 操作动作 系统响应 备注
1
供应商用户
登录供应商后台,点击左侧菜单"营销中心 → 我的活动"
系统加载我的活动列表页,查询 t_supplier_activity_apply 表中 supplier_id = 当前供应商ID 的所有记录,按 created_at 倒序展示
默认展示全部状态,分页每页20条
2
供应商用户
在筛选区选择审核状态、输入活动名称、选择报名时间范围,点击"查询"
系统按筛选条件过滤列表数据
审核状态对应 apply_status 枚举
3
供应商用户
点击某报名记录的"查看详情"按钮
跳转/弹窗展示报名详情:活动信息(名称/类型/时间/成本承担方)、报名信息(报名时间/报名理由/报名商品列表)、审核信息(审核状态/审核意见/审核时间)。若审核状态为 approved 且活动已开始/结束,额外展示"销售数据"区域
详情页信息分区展示
4
供应商用户
在列表中对 pending 状态的报名记录点击"撤回"按钮
系统先校验:①报名状态是否仍为 pending;②关联活动是否已进入 ongoing 状态。校验通过后弹出二次确认框"确定撤回该报名申请?撤回后不可恢复。"
撤回前置校验(R3/R4)
5
供应商用户
在二次确认框中点击"确定撤回"
系统更新 t_supplier_activity_apply.apply_status = 'withdrawn',提示"撤回成功",刷新列表。撤回后该报名记录状态变为"已撤回",操作列不再显示"撤回"按钮
状态变更为 withdrawn(R5)
6
供应商用户
在二次确认框中点击"取消"
关闭确认框,不做任何变更
-
7
供应商用户
在详情页查看销售数据(仅 approved 状态可见)
系统展示参与商品的销售统计:总销量、总销售额、平均转化率、退款率、分销渠道销量占比等。数据按 T+1 同步,展示数据更新时间
销售数据 T+1(R6)
8
供应商用户
在详情页点击"返回"按钮
返回我的活动列表页
-
16.2.3 原型示意
/supplier/activities/mine
供应商工作台 / 营销活动 / 我的活动
我的活动
审核状态 全部 待审核 已通过 已驳回 已撤回
活动名称
查询 重置
活动名称 报名时间 审核状态 审核意见 操作
暑期满减大促 2026-07-10 14:30 已通过 同意,商品符合活动要求 查看
国庆秒杀活动 2026-09-25 10:20 待审核 - 查看 撤回
双十一拼团特惠 2026-10-28 16:00 已驳回 商品库存不足 查看
新年展示专题 2026-12-15 09:00 已撤回 - 查看
/supplier/activities/mine
供应商工作台 / 营销活动 / 我的活动
我的活动
活动信息 活动名称:暑期满减大促 | 类型:满减活动 | 时间:2026-07-15~08-15 | 成本承担:供应商承担50%
审核结果 审核状态:已通过 | 审核意见:同意,商品符合活动要求 | 报名时间:2026-07-10 14:30
报名商品列表
商品名称 商品底价 活动价 销量 销售额 转化率
三亚蜈支洲岛一日游 ¥299 ¥259 156 ¥40,404 12.3%
桂林漓江竹筏漂流 ¥180 ¥159 89 ¥14,151 9.8%
销售数据统计
16.2.4 状态说明
报名记录在"我的活动"中的可操作性取决于 apply_status 和关联活动的 status:
报名状态 活动状态 可执行操作 说明
pending(待审核)
published(已发布)
撤回、查看详情
活动尚未开始,供应商可撤回报名。撤回后状态变为 withdrawn,可重新报名
pending(待审核)
ongoing(进行中)
查看详情(不可撤回)
活动已开始,即使报名尚未审核,也不允许撤回(R4)。展示提示"活动已开始,无法撤回"
approved(已通过)
ongoing(进行中)
查看详情(含销售数据)
报名已通过且活动进行中,详情页展示实时销售数据(T+1)
approved(已通过)
ended(已结束)
查看详情(含最终销售数据)
活动已结束,销售数据冻结为最终值,报名记录永久可查
rejected(已驳回)
任意
查看详情
终态,仅可查看审核意见,不可操作。供应商可对该活动重新报名(若活动仍可参与)
withdrawn(已撤回)
任意
查看详情
终态,仅可查看。供应商可对该活动重新报名(若活动仍可参与)
16.2.5 异常处理
异常编号 异常场景 触发条件 处理方式 提示信息
EX-9.22-01
非待审核态撤回
供应商对 approved/rejected/withdrawn 状态的报名执行撤回
列表中不显示"撤回"按钮;若通过异常请求触发,后端返回错误
"仅待审核状态的报名可撤回"
EX-9.22-02
活动已开始不可撤回
报名状态为 pending,但关联活动已进入 ongoing 状态
"撤回"按钮置灰,鼠标悬停提示原因;后端二次校验拦截
"活动已开始,无法撤回报名"
EX-9.22-03
撤回并发冲突
供应商点击撤回时,平台审核员同时对该报名进行了审核操作(通过或驳回)
后端校验 apply_status 是否仍为 pending,若已变更则撤回失败
"该报名申请审核状态已变更,无法撤回。请刷新页面查看最新状态。"
EX-9.22-04
销售数据加载失败
详情页请求销售数据接口超时或返回异常
销售数据区域展示"数据加载失败",提供"重新加载"按钮,不影响其他信息展示
"销售数据加载失败,请点击重新加载"
EX-9.22-05
报名记录不存在
供应商访问的报名记录ID不存在或不属于当前供应商
返回错误页面或提示
"报名记录不存在或您无权查看"
EX-9.22-06
商品信息变更
报名商品在活动期间被供应商下架或删除,详情页商品信息展示异常
商品列表中标记该商品为"已下架/已删除",销售数据正常展示历史数据
商品行状态显示"已下架",不影响已产生的销售数据展示
EX-9.22-07
数据权限越权
供应商尝试查看其他供应商的报名记录
后端校验 supplier_id 与当前登录供应商一致,不一致则拒绝访问
"您无权查看该记录"
17. 系统初始化与依赖顺序
本章定义营销中心模块上线前的系统初始化数据清单、各数据项之间的依赖顺序,以及上线前需完成的配置检查项。系统初始化数据的完整性和正确性是营销中心各功能正常运行的前提条件。
17.1 初始化数据清单
以下为营销中心模块上线前必须初始化的基础数据,按数据域分类:
序号
数据项
数据域
说明
默认值
依赖前置项
1
会员类型
会员管理
系统预设的会员类型,区分个人用户和企业用户,决定会员注册流程和权益体系
个人会员(individual)、企业会员(enterprise)
无
2
会员等级
会员管理
会员成长值等级体系,每个等级对应不同的成长值区间,等级越高权益越优
普通(0-999)、白银(1000-4999)、黄金(5000-19999)、铂金(20000-49999)、钻石(50000+)
会员类型
3
默认权益项
会员管理
各会员等级对应的默认权益配置,权益项可在后台调整
折扣率(普通95折/白银92折/黄金88折/铂金85折/钻石80折)、生日礼券(白银及以上)、优先客服(黄金及以上)、免邮(铂金及以上)、积分倍率(普通1.0x/白银1.2x/黄金1.5x/铂金2.0x/钻石3.0x)
会员等级
4
积分规则
积分管理
积分获取规则,定义不同行为对应的积分奖励值,支持后台配置调整
消费积分(1元=1积分)、签到积分(5积分/天)、评价积分(20积分/次)、注册积分(100积分/次)、分享积分(10积分/次)
会员类型
5
活动类型
活动管理
系统支持的活动类型枚举,每种类型对应不同的活动模板和规则引擎
展示活动(showcase)、满减活动(full_reduction)、秒杀活动(seckill)、拼团活动(group_buy)
无
6
活动模板
活动管理
每种活动类型的默认配置模板,包含活动规则字段、商品准入条件、成本承担方选项等
展示模板、满减模板(含阶梯满减配置)、秒杀模板(含库存锁定规则)、拼团模板(含成团人数/时效配置)
活动类型
7
优惠券模板
优惠券管理
预设的优惠券模板类型,定义优惠券的基本属性维度
满减券(门槛金额+抵扣金额)、折扣券(折扣比例+最高抵扣)、代金券(固定面值)、兑换券(指定商品兑换)
会员等级
8
审核流程配置
系统配置
活动和优惠券的审核流程配置,定义审核节点和审核人角色
活动审核:运营专员初审→运营主管复审;优惠券审核:运营专员审核
活动类型、优惠券模板
9
分销佣金规则
分销管理
分销链接的默认佣金比例配置,可按商品分类差异化设置
默认分销佣金比例:5%(可按分类调整,范围1%-20%)
活动类型
10
状态枚举值
系统配置
各核心业务对象的状态枚举值初始化,确保状态机一致性
活动状态:draft/pending_audit/approved/published/ongoing/ended/rejected;报名状态:pending/approved/rejected/withdrawn;优惠券状态:unused/used/expired/refunded
无
17.2 依赖顺序说明
初始化数据之间存在严格的依赖关系,必须按以下顺序依次完成初始化,否则后置数据项无法正确配置或功能异常:
顺序
初始化项
前置依赖
依赖说明
初始化后的效果
1
会员类型
无
最基础数据项,会员等级和权益配置均需关联会员类型
注册流程可区分个人/企业会员
2
会员等级
会员类型
每个会员类型下需独立配置等级体系,等级ID需关联会员类型ID
会员成长值可映射到等级
3
会员权益项
会员等级
权益项绑定到具体会员等级,等级升级时权益自动变更
不同等级会员享有差异化权益
4
积分规则
会员类型
积分规则按会员类型配置,积分倍率受会员等级权益影响
用户行为可产生积分
5
活动类型
无
活动类型为独立枚举,不依赖其他数据项,但活动模板依赖活动类型
活动创建时可选择活动类型
6
活动模板
活动类型
每种活动类型对应一套模板配置,模板定义该类型的默认规则和字段
活动创建时自动加载模板配置
7
优惠券模板
会员等级
优惠券可按会员等级定向发放,模板需支持等级筛选条件
优惠券创建时可选择模板
8
审核流程配置
活动类型、优惠券模板
审核流程绑定到具体活动类型和优惠券模板,定义审核节点
活动和优惠券提交后进入审核流程
9
分销佣金规则
活动类型
分销佣金规则需区分是否为活动商品,活动商品佣金可独立配置
分销链接可正确计算佣金
10
活动(首条)
活动模板、审核流程配置、优惠券模板
活动创建依赖模板加载规则,提交后依赖审核流程配置进入审核
系统可创建并发布营销活动
依赖链路图(文字版流程):
会员类型 → 会员等级 → 会员权益项 → 积分规则 → 活动类型 → 活动模板 → 优惠券模板 → 审核流程配置 → 分销佣金规则 → 活动
关键路径: 会员类型 → 会员等级 → 会员权益项(会员域),活动类型 → 活动模板 → 活动(活动域),两条路径在"活动"节点汇合(活动可关联优惠券和会员等级定向投放)。
注意事项: 若跳过依赖顺序直接初始化后置数据项,系统将报错或产生数据不一致。例如:未初始化会员等级直接配置权益项,权益项无法关联到等级ID;未初始化活动模板直接创建活动,活动规则字段将为空导致功能异常。
17.3 配置检查项清单
系统初始化完成后,上线前需逐项检查以下配置是否正确:
序号
检查项
检查内容
检查方法
预期结果
1
会员类型完整性
确认"个人会员"和"企业会员"两条记录已正确初始化,类型编码(individual/enterprise)无重复
数据库查询
2条记录
2
会员等级区间连续性
5个等级的成长值区间无重叠、无遗漏,区间边界值正确(0→999→1000→4999→5000→19999→20000→49999→50000+)
数据库查询+区间校验脚本
区间连续无重叠
3
权益项等级覆盖
每个会员等级均配置了完整的权益项(折扣率/生日礼券/优先客服/免邮/积分倍率),无缺失
后台页面逐级检查
5级权益完整
4
积分规则有效性
5条积分规则(消费/签到/评价/注册/分享)均配置了积分值,规则状态为"启用"
数据库查询
5条规则启用
5
活动类型枚举一致性
活动类型枚举值(showcase/full_reduction/seckill/group_buy)与代码中枚举定义一致
代码审查+数据库对比
4种类型一致
6
活动模板加载
4种活动类型均能正确加载对应模板,模板字段无缺失
创建活动测试
模板加载正常
7
优惠券模板可用
4种优惠券模板(满减/折扣/代金/兑换)均可正常创建优惠券
创建优惠券测试
4种模板可用
8
审核流程配置
活动审核流程(初审+复审)和优惠券审核流程已配置,审核人角色已分配
后台流程配置页检查
流程配置完整
9
状态枚举完整性
活动状态(7种)、报名状态(4种)、优惠券状态(4种)枚举值与数据模型定义一致
数据库+代码对比
枚举值一致
10
分销佣金比例
默认分销佣金比例已配置(5%),分类差异化比例(如存在)已设置
后台配置页检查
佣金比例已配置
11
供应商参与范围
活动 applicable_scope 字段支持"供应商参与"选项,可正确筛选可参与活动
创建活动测试
范围配置可用
12
底价校验生效
商品底价字段已正确配置,活动价格低于底价时系统拦截(MK-005)
创建活动测试
拦截生效
18. 验收标准
本章定义营销中心模块的功能验收标准、集成测试场景和性能指标,作为系统测试和上线验收的依据。验收范围覆盖全部22个功能点(9.1-9.22)及跨模块集成场景。
18.1 功能验收标准
以下为22个功能点的验收标准,每个功能点包含验收要点、验收方法和通过标准:
功能编号
功能名称
验收要点
验收方法
通过标准
9.1
会员类型管理
会员类型的增删改查;个人会员/企业会员类型预设正确;类型删除时校验关联数据
功能测试+边界测试
CRUD操作正常,删除有关联数据时拦截
9.2
会员等级管理
5个会员等级的成长值区间配置;区间连续无重叠;等级升降级规则正确
功能测试+数据校验
区间无重叠,成长值达到阈值自动升级
9.3
会员权益管理
各等级权益项配置(折扣率/生日礼券/优先客服/免邮/积分倍率);权益随等级变更自动切换
功能测试+场景测试
权益配置生效,等级变更后权益同步更新
9.4
成长值规则管理
成长值获取规则配置;消费/签到/评价等行为成长值发放;成长值累计正确
功能测试+数据验证
行为触发后成长值正确累计,等级阈值触发升级
9.5
积分规则管理
5种积分规则配置;积分倍率受会员等级影响;积分发放和扣减正确
功能测试+计算验证
积分规则生效,等级倍率正确应用
9.6
优惠券模板管理
4种优惠券模板(满减/折扣/代金/兑换)创建;模板字段配置完整;模板状态管理
功能测试+字段校验
4种模板可创建,字段校验通过
9.7
优惠券发放管理
优惠券批量发放;定向会员等级发放;发放数量和有效期控制;发放记录可查
功能测试+批量测试
发放数量准确,有效期生效,记录完整
9.8
优惠券核销与退券
下单时优惠券核销;整单退款退券(恢复未使用);部分退款不退券(MK-008规则)
场景测试+对账验证
整单退款退券,部分退款不退券,状态正确
9.9
活动管理
活动创建/编辑/上下架;活动状态流转(MK-013);活动时间冲突校验
功能测试+状态机测试
状态流转正确(草稿→待审核→已通过→已发布→进行中→已结束)
9.10
展示活动管理
展示活动创建;商品关联展示;展示位配置;活动价格不低于底价(MK-005)
功能测试+价格校验
展示活动正常创建,底价校验拦截生效
9.11
满减活动管理
满减规则配置(阶梯满减);满减计算正确;活动价格不低于底价(MK-005)
功能测试+计算验证
满减金额计算正确,底价校验通过
9.12
秒杀活动管理
秒杀库存独立锁定(MK-006);秒杀价格配置;库存扣减和释放;底价校验
并发测试+库存验证
库存不超卖,支付超时库存释放,底价校验通过
9.13
拼团活动管理
拼团规则配置(成团人数/时效);成团/未成团判定;未成团自动退款退券
场景测试+定时任务验证
成团判定正确,未成团自动退款退券
9.14
活动审核管理
活动审核流程(初审/复审);审核通过/驳回;审核权限分离(MK-014);审核意见记录
功能测试+权限测试
审核流程完整,权限分离生效,意见可查
9.15
积分对账管理
积分消费与财务对账;积分扣减记录与财务消费记录一致(MK-011);对账差异告警
对账测试+数据验证
积分与财务数据一致,差异可发现可追溯
9.16
营销数据看板
活动/优惠券/会员/积分核心指标展示;数据实时性;多维度筛选
功能测试+数据验证
指标数据准确,筛选生效,看板加载正常
9.17
活动效果分析
活动维度数据分析(参与率/转化率/ROI);活动对比分析;趋势图展示
功能测试+数据验证
分析数据准确,对比和趋势展示正常
9.18
优惠券使用分析
优惠券领取/核销/过期统计;使用率分析;ROI分析
功能测试+数据验证
统计数据准确,分析维度完整
9.19
分销链接管理
分销链接生成;链接有效期控制;佣金比例配置(MK-012);链接状态管理
功能测试+链接验证
链接可生成可追踪,有效期和佣金正确
9.20
活动分销推广
活动商品分销链接生成;分销数据统计;活动商品通过分销推广
功能测试+数据验证
活动商品可分销推广,分销数据统计准确
9.21
可参与活动
供应商查看可参与活动列表;商品报名(多选+理由);重复报名拦截;底价校验(MK-005);报名审核制(MK-015)
功能测试+边界测试
列表展示正确,报名流程完整,拦截规则生效
9.22
我的活动
报名记录查看;待审核态撤回;活动开始后不可撤回;审核通过后销售数据展示
功能测试+状态测试
列表和详情正确,撤回规则生效,销售数据T+1展示
18.2 集成测试场景
以下为跨模块集成测试场景,验证营销中心与其他子系统的联动正确性:
场景编号
场景描述
涉及模块
预期结果
ITS-01
优惠券下单→整单退款→退券验证
营销中心 + 订单履约
用户使用优惠券下单后发起整单退款,退款完成后优惠券状态恢复为"未使用",用户可再次使用该券;订单状态变为"已退款";优惠券核销记录标记为"已退券"
ITS-02
优惠券下单→部分退款→不退券验证
营销中心 + 订单履约
用户使用优惠券下单后发起部分商品退款,退款完成后优惠券保持"已使用"状态不退回;退款金额按商品实付比例计算(不含券面值);订单状态为"部分退款"
ITS-03
秒杀活动下单→支付超时→库存释放验证
营销中心 + 订单履约
用户在秒杀活动中下单成功(库存锁定),支付超时后订单自动取消,秒杀库存释放回活动库存池,其他用户可继续抢购;库存锁定记录和释放记录完整可查
ITS-04
拼团未成团→自动退款退券→逆向分账验证
营销中心 + 订单履约 + 财务中心
拼团活动超时未达到成团人数,系统自动触发:①所有参团订单退款;②优惠券退回恢复"未使用";③财务中心逆向分账,按原分账比例冲销;④供应商货款同步冲减;全流程记录可追溯
ITS-05
活动价格低于底价→拦截验证
营销中心 + 供应链
运营人员创建活动时,设置某商品活动价格低于商品底价(违反 MK-005),系统在保存时拦截并提示"活动价格不得低于商品底价";供应商报名活动时设置低于底价的活动价,同样被拦截;活动无法保存/提交
ITS-06
供应商活动报名→审核→商品上架验证
营销中心 + 商家管理 + 供应链
供应商在"可参与活动"中报名商品并提交(状态pending)→平台在活动审核管理中审核通过(状态approved)→报名商品自动加入活动商品范围→前端活动页展示该供应商商品→商品可通过分销链接推广(分销PRD对齐);全流程状态可追溯
ITS-07
积分对账→财务对账消费验证
营销中心 + 财务中心
用户消费产生积分扣减(积分兑换/抵扣),营销中心记录积分变动明细;财务中心记录对应消费金额;T+1对账时积分扣减总额与财务消费记录一致,无差异;若存在差异,系统生成对账差异告警,支持人工核查
ITS-08
会员升级→权益变更验证
营销中心(内部闭环)
用户成长值累计达到升级阈值(如4999→5000,白银升黄金)→系统自动升级会员等级→权益项同步切换(折扣率/积分倍率/免邮等变更)→用户侧即时生效→升级记录可查;验证降级场景(成长值衰减)同样触发权益变更
集成测试覆盖说明: 以上8个场景覆盖了营销中心与订单履约(ITS-01/02/03/04)、供应链(ITS-05/06)、商家管理(ITS-06)、财务中心(ITS-04/07)的交叉联动,以及营销中心内部闭环(ITS-08)。每个场景均涉及状态流转和数据一致性验证。
18.3 性能指标
以下为营销中心模块的性能验收指标:
序号
指标项
目标值
测试方法
1
页面首屏加载时间
≤ 2.0 秒(P95)
使用性能测试工具(Lighthouse/WebPageTest)在正常网络环境下测量各核心页面首屏加载时间,取95分位值
2
API平均响应时间
≤ 500 毫秒(P95)
使用JMeter对核心API(活动列表/优惠券列表/会员信息/积分查询)压测,并发100用户,取95分位响应时间
3
活动列表查询响应
≤ 1.0 秒(数据量≥10000条活动)
数据库预置10000条活动记录,测试活动列表分页查询+筛选的响应时间
4
秒杀活动并发下单QPS
≥ 2000 TPS
使用JMeter模拟2000并发用户同时秒杀下单,验证库存不超卖、订单创建成功率≥99.9%
5
系统并发用户数
≥ 5000 在线用户
使用JMeter模拟5000用户并发访问系统各功能,系统稳定运行无OOM/线程阻塞
6
报表/看板数据生成时间
≤ 10 秒
在数据量≥100万订单记录环境下,测试营销数据看板和活动效果分析报表的查询生成时间
7
数据库慢查询
≤ 100 毫秒(P99)
开启数据库慢查询日志,压测期间统计所有SQL执行时间,99分位值不超过100ms
8
优惠券批量发放耗时
≤ 30 秒(10000张券)
测试批量发放10000张优惠券的端到端耗时,含数据库写入和通知发送
9
供应商活动报名提交响应
≤ 800 毫秒(P95)
模拟100个供应商同时提交活动报名,测试报名接口响应时间(含商品校验+重复报名校验+底价校验)
10
积分对账任务执行时间
≤ 5 分钟(全量对账)
在日均10万笔积分变动记录环境下,测试T+1全量对账任务的执行耗时
附录A:质量自检清单
本附录用于PRD交付前的质量自检,确保功能覆盖、详情完整性、规则一致性、PRD对齐和业务闭环均满足要求。
A.1 功能覆盖检查
序号
检查项
检查内容
检查结果
备注
1
功能点总数
确认PRD覆盖全部22个功能点(9.1-9.22),无遗漏
通过
9.1-9.22共22个功能点已全部定义
2
会员管理域覆盖
9.1会员类型/9.2会员等级/9.3会员权益/9.4成长值规则/9.5积分规则,共5个功能点
通过
第10章覆盖
3
优惠券域覆盖
9.6优惠券模板/9.7优惠券发放/9.8优惠券核销与退券,共3个功能点
通过
第11章覆盖
4
活动管理域覆盖
9.9活动管理/9.10展示活动/9.11满减活动/9.12秒杀活动/9.13拼团活动/9.14活动审核,共6个功能点
通过
第12-14章覆盖
5
数据分析与分销域覆盖
9.15积分对账/9.16营销看板/9.17活动效果/9.18优惠券分析/9.19分销链接/9.20活动分销,共6个功能点
通过
第15章覆盖
6
供应商活动域覆盖
9.21可参与活动/9.22我的活动,共2个功能点
通过
第16章覆盖
A.2 5级详情完整性检查
序号
检查项
检查内容
检查结果
备注
1
核心逻辑完整性
每个功能点是否包含核心逻辑说明(业务目标/操作角色/触发条件/业务规则/关联数据表/全局规则/PRD对齐)
通过
全部22个功能点均包含核心逻辑(table.ix)
2
交互说明完整性
每个功能点是否包含分步骤交互说明(步骤/角色/操作动作/系统响应/备注)
通过
全部22个功能点均包含交互说明(table.st)
3
原型示意完整性
每个功能点是否包含PC端原型示意(列表页/表单页/详情页/弹窗等关键界面)
通过
全部22个功能点均包含原型(prototype-frame)
4
状态说明完整性
每个功能点是否包含状态流转说明(当前状态/触发事件/目标状态/操作角色/说明)
通过
全部22个功能点均包含状态说明(table.st)
5
异常处理完整性
每个功能点是否包含异常处理说明(异常编号/异常场景/触发条件/处理方式/提示信息)
通过
全部22个功能点均包含异常处理(table.ex)
A.3 全局规则一致性检查
规则编号
规则名称
检查内容
检查结果
体现位置
MK-001
会员等级自动升降级
成长值达到阈值自动升级,成长值衰减自动降级
通过
9.2/9.4 + ITS-08
MK-002
会员降级保护期
降级后设置保护期,保护期内不再次降级
通过
9.2 核心逻辑
MK-003
积分有效期管理
积分设置有效期,过期自动清零并通知用户
通过
9.5 核心逻辑
MK-004
优惠券使用门槛校验
优惠券使用时校验门槛金额、商品范围、有效期
通过
9.8 核心逻辑
MK-005
活动价格不得低于商品底价
创建活动和供应商报名时均校验活动价格≥商品底价
通过
9.10/9.11/9.12/9.21 + ITS-05
MK-006
秒杀库存独立锁定
秒杀活动库存独立于商品库存,下单锁定、超时释放
通过
9.12 + ITS-03
MK-007
拼团成团条件校验
拼团需满足成团人数和成团时效,未成团自动退款
通过
9.13 + ITS-04
MK-008
优惠券退券规则
整单退款退券,部分退款不退券
通过
9.8 + ITS-01/ITS-02
MK-009
活动时间冲突校验
同一商品在同一时间段不可参与互斥类型的活动
通过
9.9 核心逻辑
MK-010
活动成本承担方配置
活动可配置成本承担方(平台/供应商/分摊),影响分账
通过
9.9/9.21 核心逻辑
MK-011
积分消费对账机制
积分扣减与财务消费记录T+1对账,差异告警
通过
9.15 + ITS-07
MK-012
分销链接有效期与佣金规则
分销链接设置有效期,佣金比例可配置
通过
9.19/9.20 核心逻辑
MK-013
活动状态流
活动状态:草稿→待审核→已通过→已发布→进行中→已结束(驳回为分支)
通过
9.9/9.14/9.21/9.22 状态说明
MK-014
活动审核权限分离
活动初审和复审由不同角色执行,创建人不可审核
通过
9.14 核心逻辑
MK-015
供应商活动报名审核制
供应商报名活动需平台审核,审核通过后商品纳入活动
通过
9.21/9.22 + ITS-06
A.4 PRD对齐检查
序号
对齐PRD
检查内容
检查结果
备注
1
订单履约PRD
优惠券退券规则(整单退/部分退)与订单履约退款流程一致;秒杀库存释放与订单取消联动;拼团退款与订单退款一致
通过
ITS-01/02/03/04验证
2
财务中心PRD
积分对账与财务消费记录一致;拼团逆向分账规则与财务分账一致;活动成本承担方影响分账
通过
ITS-04/07验证
3
供应链PRD
供应商活动报名校验商品状态和库存;活动价格不低于底价;商品上下架影响活动参与
通过
9.21/ITS-05/ITS-06验证
4
分销PRD
供应商活动商品可通过分销链接推广;分销佣金规则一致;分销数据含活动商品
通过
9.19/9.20/ITS-06验证
5
商家管理PRD
供应商活动报名与商家管理供应商资质校验一致;审核流程角色与商家管理权限一致
通过
ITS-06验证
A.5 闭环检查
序号
检查项
检查内容
检查结果
备注
1
活动生命周期闭环
创建→审核→发布→进行→结束,全状态流转可追溯,无死锁状态
通过
MK-013状态流完整,9.9/9.14覆盖
2
优惠券生命周期闭环
创建→发放→领取→核销→退券(整单退)/过期,全状态可追溯
通过
9.6/9.7/9.8覆盖,ITS-01/02验证
3
供应商报名闭环
报名→审核→通过/驳回→撤回→商品上架→销售数据,全流程可追溯
通过
9.21/9.22覆盖,ITS-06验证
4
积分闭环
获取→累计→消费→对账,积分变动全链路可追溯
通过
9.5/9.15覆盖,ITS-07验证
5
退款对账闭环
退款→退券→逆向分账→积分冲减→财务对账,全链路数据一致
通过
ITS-01/02/04/07验证
6
会员成长闭环
行为→成长值→等级变更→权益变更,闭环自洽
通过
9.2/9.3/9.4覆盖,ITS-08验证
附录B:功能点与章节索引
本附录提供全部22个功能点的索引信息,包含功能编号、功能名称、所属章节、功能域、优先级和涉及数据表,便于快速定位。
功能编号
功能名称
所属章节
功能域
优先级
涉及数据表
9.1
会员类型管理
第10章
会员管理域
P0
t_member_type
9.2
会员等级管理
第10章
会员管理域
P0
t_member_level
9.3
会员权益管理
第10章
会员管理域
P1
t_member_benefit, t_member_level
9.4
成长值规则管理
第10章
会员管理域
P1
t_growth_rule, t_member_growth_log
9.5
积分规则管理
第10章
积分管理域
P0
t_points_rule, t_points_account, t_points_log
9.6
优惠券模板管理
第11章
优惠券域
P0
t_coupon_template
9.7
优惠券发放管理
第11章
优惠券域
P0
t_coupon, t_coupon_issue, t_coupon_template
9.8
优惠券核销与退券
第11章
优惠券域
P0
t_coupon, t_order, t_order_refund
9.9
活动管理
第12章
活动管理域
P0
t_activity
9.10
展示活动管理
第12章
活动管理域
P1
t_activity, t_activity_product, t_product
9.11
满减活动管理
第13章
活动管理域
P0
t_activity, t_activity_rule, t_activity_product
9.12
秒杀活动管理
第13章
活动管理域
P0
t_activity, t_seckill_stock, t_activity_product
9.13
拼团活动管理
第14章
活动管理域
P0
t_activity, t_group_buy, t_group_buy_record
9.14
活动审核管理
第14章
活动管理域
P0
t_activity, t_activity_audit_log
9.15
积分对账管理
第15章
数据分析域
P1
t_points_account, t_points_log, t_finance_record
9.16
营销数据看板
第15章
数据分析域
P1
t_activity, t_coupon, t_order, t_member
9.17
活动效果分析
第15章
数据分析域
P2
t_activity, t_order, t_activity_product
9.18
优惠券使用分析
第15章
数据分析域
P2
t_coupon, t_coupon_issue, t_order
9.19
分销链接管理
第15章
分销推广域
P1
t_distribution_link, t_product, t_supplier
9.20
活动分销推广
第15章
分销推广域
P1
t_distribution_link, t_activity, t_activity_product
9.21
可参与活动
第16章
供应商活动域
P1
t_supplier_activity_apply, t_activity, t_product
9.22
我的活动
第16章
供应商活动域
P1
t_supplier_activity_apply, t_activity, t_order
索引统计: 共22个功能点,覆盖6个功能域(会员管理域5个、积分管理域1个、优惠券域3个、活动管理域6个、数据分析域4个、分销推广域2个、供应商活动域2个)。优先级分布:P0共11个、P1共8个、P2共2个、P1(供应商)共2个。涉及核心数据表25张。