Appearance
官方团购模块 (Official Group Buy)
文档版本: V2.0 更新日期: 2024-05-20 状态: 评审中
0. 背景与目标 (Context & Goals)
问题陈述 (Problem Statement)
- 库存去化: 雪票、酒店等标准化产品在平季或特定时段需要通过"以量换价"的方式快速去库存。
- 统一营销: 官方需要一种能够聚拢流量、制造抢购氛围的营销工具，而非分散的小团。
- 价格公平: 需要解决阶梯定价中"早买反而贵"的痛点，确保用户享受到最终的最低价。
成功指标 (Success Metrics)
- 成团率: 依托"模拟成团"机制，目标成团率 100%（只要有人买就尽量成）。
- 裂变系数 (K-factor): 平均每个分享者带来的新用户数 > 1.5。
一、 核心逻辑与业务规则
1.1 统一大团模式 (Unified Group Model)
官方发起一个拼团活动 = 一个统一的大团。不存在用户自主开团的逻辑。
- 唯一性: 官方创建活动后，系统生成唯一的拼团实例。
- 聚合性: 所有用户的报名都计入这个统一的团。
- 动态性: 随着参与人数增加，阶梯价格自动解锁。
1.2 阶梯价格与退差 (Tiered Pricing & Refund)
支持基于累计参与人数的动态定价。核心原则：用户最终按最低解锁价格结算。
阶梯示例:
- 2-4人: ¥680/人
- 5-9人: ¥600/人
- 10+人: ¥550/人
结算规则 (Pay Current, Refund Difference):
- 入局支付: 用户参与时，需支付当前已解锁的阶梯价格（每满一档，即时降价）。
- 例如: 第一档 ¥680 (0-4人)，第二档 ¥600 (5-9人)。
- 场景: 当前 3 人，用户 D 加入，支付 ¥680。后续凑够 5 人后，新用户 E 加入仅需支付 ¥600。
- 最终结算: 活动结束后，系统根据最终有效参团人数确定最终阶梯价。
- 场景: 最终 12 人，解锁 ¥550 档位。
- 自动退差: 系统计算差额（支付价 - 最终价），并自动将差额发放至用户钱包。
- 结果: 用户 D (付680) 退 ¥130；用户 E (付600) 退 ¥50。
- 入局支付: 用户参与时，需支付当前已解锁的阶梯价格（每满一档，即时降价）。
1.4 退款/逆向流程 (Refund Policy)
用户主动申请全额退款（取消订单）的规则。
继承原则: 团购活动不单独设置退改规则，直接继承所引用商品 (SKU) 的退改政策。
A. 活动进行中 (拼团未结束)
| 场景 | 退款规则 | 对拼团的影响 |
|---|---|---|
| 用户申请退款 | 遵循商品退改政策（如"随时退"/"24h前可退"） | 参团人数 -1，若跌破阶梯则后续用户需按上一级价格支付 |
| 风控限制 | 恶意刷单（反复买退）的用户将被限制下单 | - |
B. 拼团成功后，核销前 (Group Succeeded, Before Redemption)
| 场景 | 退款规则 | 退款金额 |
|---|---|---|
| 商品支持随时退 | 用户可直接申请退款 | 最终结算价（非原支付价） 例: 付 ¥680，结算价 ¥550，则退 ¥550；差价 ¥130 已入钱包 |
| 商品不支持随时退 | 按商品退改政策执行（可能收取手续费或不可退） | 按政策 |
| 过期未核销 | 自动发起退款（若商品配置为"过期自动退"） | 最终结算价 |
C. 核销后 (After Redemption)
| 场景 | 退款规则 |
|---|---|
| 已核销 (含部分核销) | 不可退款（服务已履约，不支持部分退） |
退款流程图
mermaid
flowchart TD
Start["用户申请退款"] --> CheckStatus{"订单状态?"}
%% 拼团中
CheckStatus -- 拼团中 --> CheckPolicy{"商品退改政策?"}
CheckPolicy -- 随时退/符合规则 --> RefundInProgress["全额退款 (原支付价)"]
RefundInProgress --> DecrCount["参团人数 -1"]
DecrCount --> CheckTier{"人数跌破阶梯?"}
CheckTier -- 是 --> TierUp["后续用户按上一级价格支付"]
CheckTier -- 否 --> End1["退款完成"]
TierUp --> End1
CheckPolicy -- 不支持/超时 --> Reject1["拒绝退款"]
%% 拼团成功未核销
CheckStatus -- 拼团成功/未核销 --> CheckPolicy2{"商品退改政策?"}
CheckPolicy2 -- 随时退 --> RefundSettled["退款 = 最终结算价"]
RefundSettled --> WalletNote["差价已在钱包，无需处理"]
WalletNote --> NoImpact["不影响其他用户价格"]
NoImpact --> End2["退款完成"]
CheckPolicy2 -- 不支持/收手续费 --> PartialOrReject["按政策执行"]
%% 已核销
CheckStatus -- 已核销 --> Reject2["不可退款 (含部分核销)"]
%% 过期
CheckStatus -- 过期未核销 --> CheckAutoRefund{"商品配置?"}
CheckAutoRefund -- 过期自动退 --> AutoRefund["自动退款 (最终结算价)"]
AutoRefund --> End4["退款完成"]
CheckAutoRefund -- 过期不退 --> Reject3["不退款"]关键逻辑: 拼团成功后的退款不影响其他用户的最终价格。平台承担因个别用户退款导致的阶梯成本差异，避免"退一人，全员涨价"的糟糕体验。
1.3 模拟成团 (Mock Success Guarantee)
为保障用户体验和库存去化，官方可配置"模拟成团"策略。
- 规则: 若活动结束时，参团人数未达到最低生效人数或预期的优惠阶梯，系统可自动触发"虚拟用户"补位。
- 逻辑:
- 系统自动匹配虚拟用户身份补齐人数。
- 虚拟用户不占用实际库存（或占用后释放），不参与核销。
- 确保真实用户能享受到承诺的成团权益，避免因差几人导致全员退款的糟糕体验。
二、 详细功能定义
2.1 发布端 (官方后台)
| 模块 | 字段/功能 | 说明/规则 |
|---|---|---|
| 关联产品 | 引用产品库 | 选择标准 SKU (如: 万龙平日雪票)。 |
| 价格策略 | 阶梯设置 | 设置多级人数门槛及对应价格。 |
| 结算设置 | 退差方式 | 默认: 原路退回 或 退至钱包 (推荐钱包以促进二次消费)。 |
| 风控设置 | 模拟成团 | 开关。 开启后，若到期未成团，系统自动补齐人数至最低成团门槛。 |
| 库存控制 | 活动总库存 | 本次活动的总库存上限。 |
2.2 用户端 (C-Side Flow)
A. 拼团详情页
- 价格展示:
- 展示当前已解锁价格。
- 展示最终目标价 ("再来 5 人即可解锁 ¥550")。
- 结算提示: 明确提示 "支付当前价，活动结束自动退差价"。
- 操作: [立即参团] (Pay Current Price)。
B. 状态流转
mermaid
stateDiagram-v2
[*] --> 待支付: 用户点击参团
待支付 --> 拼团中: 支付成功 (锁定当前价)
state 拼团中 {
[*] --> 人数增长
人数增长 --> 解锁新阶梯: 达到阈值
}
拼团中 --> 拼团成功: 活动结束 (含模拟成团)
拼团中 --> 拼团失败: 库存不足/极少人参与且未开启模拟
拼团成功 --> 计算退差: 最终价 < 支付价
计算退差 --> 发放权益: 核销码生效
计算退差 --> 钱包入账: 差额退回三、 验收标准 (Acceptance Criteria)
- 退差逻辑验证:
- 设置 2人(¥600)/5人(¥500)。
- 用户 A 第 1 个加入，支付 ¥600（此时未解锁任何优惠，或按原价/首阶梯支付）。
- 后续加入 4 人，最终 5 人成团，解锁 ¥500。
- 活动结束后，验证用户 A 的钱包收到 ¥100 退款。
- 模拟成团验证:
- 设置最低 5 人成团。
- 实际仅 3 人报名。开启模拟成团。
- 活动结束，系统自动补 2 个虚拟用户。
- 验证 3 名真实用户状态为"拼团成功"，且收到核销码。
- 钱包展示:
- 用户中心 -> 我的钱包 -> 交易明细中，应有一笔类型为"团购退差"的入账。
四、 不做范围 (Out-of-Scope)
- 实时退差: 差价必须在活动结束后统一结算，不支持过程中实时退款（即使已经解锁了更低价），以防后续有人退团导致阶梯回退。
C 端详情页
官方团购详情页 PRD
版本: V1.4
更新日期: 2026-01-21
依赖: 通用组件规范更新内容: V1.4 封面轮播（多图+指示器+箭头）、标题移至卡片区、库存上限展示、商品详情简化（亮点+套餐包含）
一、模块定位
场景：官方发起的标准化商品拼团（雪票、酒店套餐等），支持阶梯定价和自动退差。
核心交互：查看进度 → 支付当前价 → 结束后自动退差
运营机制：通过「模拟成团」保障，确保活动必定成功，不存在拼团失败场景。
二、封面与标题区
V1.4 更新：封面改为轮播组件，标题移至白色卡片区
2.1 封面轮播
┌────────────────────────────────────┐
│ [←] [图片1/3/图片] [→] │
│ │
│ ● ○ ○ (底部指示器) │
└────────────────────────────────────┘交互规则：
- 支持多图轮播（3秒自动切换）
- 底部小圆点指示器 + 左右箭头
- 与其他活动类型保持一致的轮播样式
2.2 标题卡片区
┌────────────────────────────────────┐
│ [官方团购] ⏰ 1天 23:58:05 │
│ 北大湖住滑套餐 · 3天2晚 │
│ ¥1499 当前解锁价 原价 ¥2499 │
│ [官方自营] [过期退] [随时退] │
└────────────────────────────────────┘三、阶梯价格区
3.1 拼团进度
┌────────────────────────────────────┐
│ 📊 拼团进度 │
│ 45人已参团 / 限1000份 │
│ ┌────────────────────────────────┐ │
│ │ ███████████░░░░░ │ │
│ └────────────────────────────────┘ │
│ 再来5人解锁 ¥1299 │
└────────────────────────────────────┘V1.4 新增：库存上限（限X份）展示
字段定义
| 字段名 | 类型 | 说明 |
|---|---|---|
| 阶梯配置 | 数组 | 价格阶梯列表 |
| 当前人数 | 整数 | 当前参团人数 |
| 库存上限 | 整数 | 限购总份数（来自发布页） |
| 结束时间 | 时间戳 | 拼团截止时间 |
四、商品详情区
V1.4 更新：简化结构，移除商品图片和描述（复用封面轮播）
┌────────────────────────────────────┐
│ 🎫 商品详情 │
├────────────────────────────────────┤
│ 亚洲顶级粉雪·五星酒店配套·含早餐自助 │
│ │
│ ┌────────────────────────────────┐ │
│ │ 套餐包含 │ │
│ │ ✓ 假日酒店双床房 2晚 │ │
│ │ ✓ 全天索道票 2张 │ │
│ │ ✓ 早餐自助 2位 │ │
│ └────────────────────────────────┘ │
│ 有效期：2026-01-01 至 2026-03-15 │
│ 使用规则：周一至周五可用，节假日除外 │
└────────────────────────────────────┘字段定义（来自引用产品 SKU）
| 字段名 | 类型 | 说明 |
|---|---|---|
| 产品亮点 | 字符串 | 简短卖点文案 |
| 套餐包含 | 数组 | 包含项目列表 |
| 有效期 | 日期范围 | 商品有效期 |
| 使用规则 | 字符串 | 使用规则说明 |
注意：商品图片复用封面轮播，不在商品详情区重复展示
2.3 拼团规则区
V1.3 新增：对齐发布页的阶梯设置、结算规则、模拟成团字段
┌────────────────────────────────────┐
│ 📋 拼团规则 │
├────────────────────────────────────┤
│ ● 结算规则 │
│ 用户入局时按当前已解锁的最高价支付； │
│ 活动结束时按最终达到的最低价结算， │
│ 差额发放至您的钱包。 │
│ │
│ ● 成团保障 ✓ │
│ 人数不足自动成团，享受当前阶梯价。 │
│ │
│ ● 退改政策 │
│ 未核销前可随时申请退款； │
│ 过期未核销自动退款。 │
└────────────────────────────────────┘字段定义（来自活动配置）
| 字段名 | 类型 | 来源 | 说明 |
|---|---|---|---|
| 结算规则 | 文案 | 发布页 | 阶梯定价+退差说明 |
| 模拟成团 | 布尔 | 发布页 | 是否开启自动补位 |
| 退改政策 | 枚举 | 引用产品 | 继承商品退改规则 |
| 过期自动退 | 布尔 | 引用产品 | 继承商品配置 |
三、发布者卡片配置
特殊处理：官方团购的发布者显示关联的雪场/商家信息
┌──────────────────────────────────────┐
│ [雪场Logo] 万龙滑雪场 ✅ 官方认证│
│ 崇礼五大雪场之一 · 优质粉雪 │
│ [查看详情] │
└──────────────────────────────────────┘四、报名流程（底部抽屉）
┌────────────────────────────────────┐
│ 确认参团 [×] │
├────────────────────────────────────┤
│ 商品：万龙滑雪场 平日雪票 │
│ 当前价：¥600/人 │
│ 数量：1 [- +] │
├────────────────────────────────────┤
│ 联系人信息 │
│ 姓名 * [ ] │
│ 手机号 * [ ] │
├────────────────────────────────────┤
│ ⚠️ 活动结束后，若解锁更低价格，差价 │
│ 将自动退回您的钱包 │
├────────────────────────────────────┤
│ 费用明细 │
│ ¥600 × 1 = ¥600 │
├────────────────────────────────────┤
│ [确认支付 ¥600] │
└────────────────────────────────────┘五、须知规则区配置
标题：📋 拼团规则
默认内容：
- 支付当前已解锁价格，活动结束后自动退差
- 差价将在活动结束后 3 个工作日内退至钱包
- 退款遵循商品退改政策
- 本活动由官方保障，确保成团
六、底部操作栏配置
| 元素 | 内容 |
|---|---|
| 左侧信息 | ¥{当前阶梯价}/人 + 原价划线 |
| 主按钮 | 立即参团 |
| 倒计时 | 距结束小于 24 小时时，显示倒计时 |
七、关联信息展示规则
V1.2 新增：遵循通用组件规范中的 ClubCard / ResortCard 定义
7.1 关联俱乐部 (ClubCard)
位置：发布者卡片下方
条件渲染：
- 仅当活动配置了关联俱乐部时显示
- 官方自营活动不展示：避免与发布者卡片信息重复
7.2 关联雪场 (ResortCard)
位置：拼团规则区下方（页面底部）
条件渲染：仅当活动配置了关联雪场时显示
八、不做范围
以下场景运营机制上不允许出现：
- ❌ 拼团失败：通过「模拟成团」机制，确保活动必定成功
- ❌ 库存不足导致的失败：官方需提前预留充足库存
八、验收标准
- 阶梯进度实时更新：新用户参团后，进度条和当前人数即时刷新
- 当前价格高亮：正确标识当前已解锁的阶梯档位
- 支付价格正确：用户支付金额 = 当前阶梯价格 × 数量
- 退差提示可见：底部抽屉中必须展示退差说明
- 倒计时准确：距结束时间倒计时每秒更新
- 进度条计算正确：进度 = 当前人数 / 下一阶梯门槛
- 提示文案正确：正确显示「再来 N 人解锁 ¥X」
B 端运营管理
官方团购 - 运营管理
版本: V1.1
更新日期: 2026-01-21
状态: 草稿
适用角色: 雪哒官方运营
一、入口与导航
导航路径：
运营后台 → 团购管理 → 点击团购卡片 → 团购管理详情页注：官方团购仅由雪哒官方运营人员发起，普通用户和俱乐部无此权限。C 端用户在「我的活动」中仅可查看参与的团购，不可管理。
二、团购列表
┌────────────────────────────────────────────────────────┐
│ 团购管理 │
│ │
│ [+ 创建团购] 筛选：[全部▼] 搜索：[ 🔍] │
├────────────────────────────────────────────────────────┤
│ 进行中 │
│ ┌────────────────────────────────────────────────────┐ │
│ │ 🎫 万龙平日雪票团 │ │
│ │ 阶梯价：¥680→¥600→¥550 │ │
│ │ 当前：12人 · 已解锁¥600档 │ │
│ │ 剩余：2天 15:32 │ │
│ │ [查看详情] [编辑] [结束] │ │
│ └────────────────────────────────────────────────────┘ │
├────────────────────────────────────────────────────────┤
│ 已结束 │
│ ┌────────────────────────────────────────────────────┐ │
│ │ 🎫 云顶周末夜场票团 [已结算] │ │
│ │ 成交：28人 · 最终价¥480 │ │
│ │ 退差金额：¥560 │ │
│ └────────────────────────────────────────────────────┘ │
└────────────────────────────────────────────────────────┘三、团购详情
┌────────────────────────────────────┐
│ ← 团购详情 │
├────────────────────────────────────┤
│ 🎫 万龙平日雪票团 │
│ 结束时间：01/25 20:00 │
├────────────────────────────────────┤
│ 📊 实时数据 │
│ ┌────────────────────────────────┐ │
│ │ 当前人数 12人 │ │
│ │ 当前档位 ¥600（5-9人档） │ │
│ │ 总收入 ¥7,200 │ │
│ │ 待退差 ¥0（结束后核算） │ │
│ └────────────────────────────────┘ │
├────────────────────────────────────┤
│ 📈 阶梯进度 │
│ ┌────────────────────────────────┐ │
│ │ 2-4人 ¥680 ✓ 已解锁 │ │
│ │ 5-9人 ¥600 ← 当前 │ │
│ │ 10+人 ¥550 🎯 再来3人 │ │
│ └────────────────────────────────┘ │
├────────────────────────────────────┤
│ 👥 参团列表 [导出CSV] │
│ ┌────────────────────────────────┐ │
│ │ 张三 138****1234 ¥600 1张 │ │
│ │ 李四 139****5678 ¥600 2张 │ │
│ └────────────────────────────────┘ │
├────────────────────────────────────┤
│ [编辑规则] [手动结束] │
└────────────────────────────────────┘四、核心功能
4.1 创建团购
| 配置项 | 说明 |
|---|---|
| 商品关联 | 选择已有商品（雪票/套餐） |
| 阶梯价格 | 配置多个人数阶梯和对应价格 |
| 开始时间 | 团购开始时间 |
| 结束时间 | 团购自动结束时间 |
| 人数上限 | 可选，限制最大参团人数 |
4.2 编辑规则
可编辑（团购进行中）：
- 结束时间（仅可延长）
- 新增更低价阶梯
不可编辑：
- 已有阶梯价格（保护已付款用户）
- 关联商品
4.3 手动结束
提前结束团购，触发退差结算流程。
4.4 退差结算
触发时机：团购结束后自动执行
结算逻辑：
最终价格 = 结束时已解锁的最低阶梯价格
退差金额 = 用户支付价格 - 最终价格
所有用户统一退差到钱包五、数据统计
| 指标 | 说明 |
|---|---|
| 参团人数 | 当前参团总人数 |
| 总收入 | 用户支付总金额 |
| 待退差 | 预估退差金额（结束后确定） |
| 实际收入 | 总收入 - 退差金额 |
六、验收标准
- 可创建多阶梯价格团购
- 实时显示当前人数和解锁档位
- 结束后自动计算退差并结算
- 参团列表可导出
- 编辑规则遵循限制条件