修订记录

记录文档版本变更，便于评审追溯。

注：V2.27 及此前内部迭代记录已归档，不再作为对外版本号；以 V1.00 为正式基线，其后以 V1.xx 递增。

相关文档

• 历史复杂版（对照，不再作为本方案实现依据）：直播1/云连锁商城直播产品需求文档.html
• 本方案目录：直播2/
• 商城后台原型：直播2/商城后台直播功能原型.html
• PC 直播间原型：直播2/PC直播间原型.html
• 商城门店端原型：直播2/商城门店端直播原型.html（标注清单：直播2/门店端水滴标注清单.md）

1.1 背景与目标

说明为什么做、做成什么。

背景

云连锁商城以「会员归属门店、库存与收款归门店」为底座。总部需要具备统一选品、讲解、发券的直播带货能力，同时不破坏门店履约与资金链路。

旧方案功能面过重（多角色中控、录播、邀约、复杂看板等）。本期做简单直播：底层履约与分红逻辑不变，功能与角色收敛。

产品目标

• 总部运营可创建主播、维护直播商品池与券池，并创建直播场次（指定主播、参与门店、选品、备券）。
• 主播登录 PC 直播间开播、讲解、发券。
• 仅参与门店会员可在门店端观看；直播中按下单原逻辑购买（扣本店库存、门店收款）。
• 分红按实付预估；售后期满且无进行中售后，从订单所属门店货款划扣给主播。

不做（一期 Out of Scope）

• 助理、嘉宾等多角色中控；独立中控台产品面。
• 录播模式、回放带货计佣、多级邀约裂变玩法。
• 用户运营、评论管理中台；侧栏数据看板不做在线趋势深看板、经营趋势图与排行榜（单场数据页单独提供 2 分钟趋势；数据看板提供跨场次转化漏斗）。
• 抽奖、赠品、红包雨等非优惠券福利。
• 跨店扣库存 / 无库存预售 / 总部共享仓代扣。
• 门店直播后台独立端（二期可对账只读）；观看端皮肤配置。

邀约能力一期范围（保留 vs 不做）

1.2 范围与角色

一期覆盖端口与角色权限边界；原型按端口分批交付。

角色

1.3 成功指标

2.1 锁定业务规则

以下规则为产品红线，冲突时以本表为准。

2.2 阶段行为矩阵

2.3 计价与分红逻辑

直播中成交价

实付 = 销售价小计 − 直播优惠 − 用户所选那 1 张券的优惠（展示口径）

其中 直播优惠 = Σ(销售价 − 直播价) × 数量（仅直播商品；销售价=直播价时仍展示 −¥0.00）。等价于 实付 = 直播价小计 − 券优惠。券门槛按直播价小计（运费是否计入对齐现网商城）。

提交订单不自动匹配；商城商品券与本场直播券互斥，至多 1 张。

支付成功快照（与结算周期无关）

订单支付成功后固定执行（不论当前结算周期配置）：

• 快照销售价、直播价、直播优惠金额、主播分红%、邀约人奖励比例（后续改价改比例不追溯）。
• 扣本店库存、门店收款、订单打「直播」标、回写中控。
• 预计算奖励基数：主播奖励 = 实付 × 分红%；若有邀约人：邀约奖励 = 实付 × 邀约人奖励比例（R3）。
• 此时不一定进入「待结算」展示态，取决于下方结算周期配置。

结算周期与奖励状态

后台【基础设置 → 奖励设置】配置全局结算周期（二选一，见 §4.6.1），同时作用于主播带货奖励与邀约人奖励。

「订单完成」模式下，已支付未确认收货的订单：不出现在各端奖励明细；不计入待结算汇总指标；不设第三展示态（如「未计入」「待收货」）。

配置变更：切换结算周期仅对保存后新产生/新达标的订单生效，不追溯历史订单。

退款与冲回

划扣与出账

• 待结算订单：售后期满且无进行中售后 → 可划扣金额 = 剩余未退实付 × 对应比例。
• 期满后仍有售后未完：延期，售后结束后再判（R9）。
• 出账：从订单所属门店结算款划扣给主播/记入邀约人收益账本（R2）。

已结束后

走商城统一日常价与原优惠逻辑（非直播券），不写本场直播分红。本期不做回放带货。

3.1 四端口信息架构

一期按四个产品端口交付，外加「原商城底座」交界改造。各端口职责互斥、状态与数据最终一致。

总体关系

3.1.1 商城后台 · 菜单树

3.1.2 PC 直播间 · 页面树

详见第 5 章。

3.1.3 门店端 · 会员直播 · 页面树

详见第 6 章。

3.1.4 门店端 · 主播 · 页面树

详见第 7 章。

3.1.5 原商城交界模块一览

完整三段式明细见 第 8 章。

3.2 场次生命周期

3.3 核心流程

本节为全流程总览；各功能章节内有对应流程图与交叉引用。

流程索引

图1 运营准备与建场

图2 场次生命周期

状态机详见 §3.2；多端同步规则见 §5.9。

图3 主播开播（PC / H5）

图4 中控带货（商品 + 发券）

图5 会员观看与准入

图6 下单、履约与分红

系统交互时序（多端口）：

图7 邀约分享与奖励

图8 券从创建到核销

3.4 领域模型（逻辑实体）

4.0 商城后台菜单总览

本期原型与研发的优先交付面。资源先入池，场次再引用。

我的应用 · 直播入口

• 入口：管理中心顶栏「更多 → 应用」进入「我的应用」。
• 侧栏：我的应用 / 应用市场 / 直播（二级可展开；子项：数据看板、直播间管理、主播管理、商品管理、优惠券管理、基础设置）；点击「直播」展开，再点收起。
• 主区页签：对齐原商城多页签（首页固定不可关；进入页面自动开签并激活；可切换 / × 关闭）。
• 订单模块：顶栏「订单」进入；侧栏含订单管理 / 售后管理 / 评价管理；订单管理底座对齐原商城列表。新增：订单标识枚举增加「直播」；会员在直播间点击商品购买并支付成功的订单打「直播」标识（组底 tag + 可筛）。边界：仅直播间购路径打标；非直播订单标识与筛选逻辑不变。详见附录「原商城改动影响面」。
• 营销模块（原商城）：顶栏「营销」进入；侧栏活动管理 / 优惠券列表（领取明细）/ 领取规则。新增活动/活动详情表单。新增：①「领取渠道」商城/直播（创建后不可改）；② 筛选与列「领取渠道」（活动管理不展示入池状态）；③ 渠道=直播不进商城领券中心；④ 券池仅引入渠道=直播且已开启。核销沿用原商城；一期发放=PC 手动，无定时发。
• 在企业服务分类下新增【直播】卡片（与「七件事」并列）。
• 点击【直播】进入直播【数据看板】；侧栏「直播」展开并高亮「数据看板」。

运营主流程

流程说明：下图展示本模块在整体链路中的位置；总览见 §3.3 图1。

4.1 数据看板

菜单：直播管理 → 数据看板；亦可由「更多 → 应用 → 我的应用 → 企业服务 → 直播」进入。跨场次总览，不做旧版邀约/回放/2 分钟在线趋势、经营趋势图与排行榜。

筛选

各筛选项 AND 组合；点击「查询」刷新概况卡片，「重置」恢复默认（时间近 30 天，其余清空）。

参与门店约束：

概况卡片

9 张独立指标卡（场次组 2 项 + 经营组 7 项，经营组与 4.3.1 主播详情同构，跨场次去重）：

场次时间筛选口径（与 §4.2 列表「开播时间」一致）：

直播转化漏斗

紧跟概况下方。结构与口径对齐 4.2.3 单场「直播转化漏斗」；统计范围为商城全部相关直播（受筛选约束；跨场次去重）。三层：访问人数 → 观看 → 成交；数值与概况终值对齐；展示区间转化率与访问成交转化率。

本期不做

页面布局（原型）

1. 筛选卡片：时间范围（默认近 30 天）、场次、主播、参与门店 + 查询/重置。
2. 概况卡片：9 张指标卡（场次、直播中、GMV、商品转化率、主播带货奖励、访问人数、观看人数、订单成交金额、订单成交数量）。
3. 直播转化漏斗（全商城跨场次汇总；无观众趋势折线）。

4.2 直播管理 · 列表

菜单：直播管理 → 直播管理。运营日常管理入口。

页面布局

1. 页标题：直播管理。
2. 筛选卡片：直播间、主播、直播间状态、创建时间 + 查询/重置。
3. 操作栏：「+ 新增直播间」；右侧展示主播开播链接 +【复制】按钮。
4. 列表卡片：表格；底部分页（共 X 条｜页码｜每页条数｜跳至）。

筛选字段

查询与重置

筛选规则明细

直播间状态定义

操作栏

列表字段

默认按创建时间倒序；分页每页 10/20/50 可选。

开播时间（列表）与累计时长

操作列细则

4.2.1 创建直播

单页滚动表单。选品选券从资源池选择。

页面结构

• 顶栏：返回、标题「添加直播间」/「编辑直播间」。
• 章节：基本信息 → 参与门店 → 所属主播 / 直播商品 →（可选）优惠券。
• 底部固定：取消、确认。
• 无手机预览、无录播、无角色抽屉（主播单选即可）。

底部按钮

保存校验（顺序）

基本信息字段

选择主播弹窗

• 入口：基本信息「所属主播」点击「选择主播」按钮弹出。
• 默认态：未选择时为空；选择后添加页回显主播头像 + 名称。
• 搜索区：支持输入主播 ID / 昵称 / 手机号模糊搜索。
• 数据源：主播管理列表中启用状态的主播。
• 主播列表：单选；默认不选；若添加页已选主播，弹窗打开时回显选中该主播。
• 列表列：ID（显示主播 ID）；主播信息（显示主播头像、名称、ID）。
• 分页：列表支持换页。
• 操作：取消关闭弹窗且不生效；确定时校验是否已选主播——未选 Toast「请选择主播」，已选则关闭弹窗并回填添加页。

参与门店

• 说明：选择参与的门店，其会员才能参与该直播。
• 单选：全部门店 / 部分门店；默认「全部门店」。
• 选择「全部门店」：商城全部门店参与本场直播；不展示「选择门店」按钮与已选列表；页面提示「商城全部门店将参与本场直播。」
• 选择「部分门店」：下方显示【选择门店】按钮与门店列表。
  • 未选门店：列表为空（空态）。
  • 已选门店：表格展示，支持单个删除。
• 门店列表字段：门店 ID；门店信息（logo、名称、电话）；门店认证状态（未认证 / 已认证）；操作（删除当前门店）。
• 未参与门店：该店及会员对本场完全不可见（R1）。

选择门店弹窗

• 入口：部分门店模式下点击【选择门店】。
• 搜索：门店 ID / 名字；点击「查询」后列表展示匹配门店。
• 列表：复选框（多选）；门店 ID；门店信息（logo、名称、电话）；门店认证状态（未认证/已认证）。
• 分页：支持换页。
• 操作：取消—关闭弹窗，不改变添加页已选门店；确定—将勾选结果回显到添加页已选门店列表。

直播商品

选择商品弹窗

• 入口：点击「选择商品」；数据来源于直播「商品管理」列表。
• 搜索：商品名称；商品 ID；分类（三级分类选择组件，选定后作为筛选条件）。
• 列表按商品维度展示，字段：
  • 复选框（多选，含表头全选本页）
  • 商品 ID
  • 商品：商品图 + 商品名称 + 商品规格（单规格显示「默认」）
  • 直播间价格 / 直播奖励比例 / 邀约人奖励比例：读取商品管理列表配置
  • 分类；商品状态（上架/下架）
• 分页格式：共 X 条｜上一页/页码/下一页｜每页条数下拉（如 10 / 页）｜跳至页码；查询或改每页条数后回到第 1 页。
• 操作：取消—关闭且不变更添加页商品列表；确定—将勾选商品回显到添加页「商品信息」列表（按规格维度，即 SKU）。

添加页商品列表（按 SKU）

商品库存弹窗

• 搜索：门店 ID / 名字；点击查询刷新列表。
• 列表字段：门店 ID；门店信息（logo、名称、电话）；商品可售库存（当前 SKU 在该店可售数量）。
• 分页：格式同选择商品弹窗；查询或改每页条数后回到第 1 页。

优惠券

• 「+ 添加优惠券」打开弹窗，数据源为优惠券管理池。
• 本端口仅备券；真正发券在 PC 直播间。
• 列表字段：名称、类型、规则、操作（删除）。

4.2.2 编辑直播间

列表「编辑」进入，与 4.2.1 共用同一表单页（原型 live-form）；标题为「编辑直播间」。

一期原型与正式版

编辑规则

• 回填已有数据；保存校验同 4.2.1。
• 直播中修改参与门店：仅允许加店（R12）。
• 改价/改分红%仅影响后续新单。

带货商品（表单内）

单场数据

见 4.2.3 单场直播数据；列表「数据」进入同一页面。

4.2.3 单场直播数据

菜单：直播管理 → 直播间列表 →「数据」。针对单一场次的经营分析页，与侧栏「数据看板」（全场次汇总）独立，互不跳转混淆。

页面入口与布局

• 入口：直播间列表操作列「数据」；直播详情页「查看数据」。
• 返回：页内「← 返回直播间列表」回到直播管理列表。
• 布局（自上而下）：顶部直播信息卡（固定）→ 直播概况（7 指标卡片）→ 直播图表（趋势 + 漏斗）→ Tab 明细（奖励明细 / 邀约人列表 / 邀约排名）。
• 刷新：直播中概况与图表每 2 分钟 自动刷新一次。

顶部直播信息卡

固定展示，不随 Tab 切换隐藏。

直播概况

汇总当前直播场次的数据指标，7 张指标卡横向排列。指标名称旁提供 i 图标：鼠标悬停展示该指标口径说明（深色气泡提示；口径见下表）。

直播图表

（1）实时观众人数趋势

折线图，统计本场时段内三类人数的累计变化（每个数据点 = 截至该时刻的累计去重数，非该 2 分钟段增量）：

直播中每 2 分钟一个数据点；已结束场次展示本场完整时段趋势。关系上：观看人数 ≤ 访问人数；离开人数 ≤ 观看人数。

横轴（仅单场数据页）：本场开播至结束（直播中为开播至当前）的具体时刻 HH:mm（如 10:00、10:02），非按日。标签过多可间隔展示；主播详情、PC/H5 多场次汇总横轴仍按日。

（2）直播转化漏斗

三层漏斗，自上而下依次为：

1. 访问人数 — 直播场次创建起至今，进入预告页或直播间相关页的去重用户数（= 概况「访问人数」）。
2. 观看 — 直播实际开始起至今，直播中进房观看的去重用户数（预告不计；= 概况「观看人数」）。
3. 成交 — 本场直播间支付成功的用户数（去重），与概况「订单成交金额 / 订单成交数量」口径一致。

漏斗数值与概况指标卡当前累计终值对齐。标题旁 ? 悬停提示漏斗路径：访问人数 → 观看 → 成交。漏斗右侧展示：

• 访问 → 观看 转化率
• 观看 → 成交 转化率
• 访问成交转化率（访问 → 成交总转化率）

Tab：奖励明细 / 邀约人列表 / 邀约排名

（1）奖励明细

记录当前直播的订单奖励明细。

（2）邀约人列表

记录本场邀约明细（一行 = 一对邀约人→邀约对象；归因规则见 6.5）。

（3）邀约排名（本场 · 仅后台）

按邀约人汇总本场表现；仅商城后台；门店端 / 直播间不做 C 端排行榜。与邀约人列表、带 inviter 的本场订单同源。

默认排序：邀约人数降序 → 成交金额降序 → 会员 ID 升序；表头可切换「邀约人数 / 成交金额 / 邀约奖励」升降序。空态「暂无邀约数据」。

订单详情弹窗（邀约）

点击邀约人列表「详情」弹出，展示该邀约对象的下单数据。

4.3 主播管理

菜单：直播管理 → 主播管理。从商城会员中指定主播，维护主播状态与经营数据。

页面布局

• 筛选卡片：主播、直播状态、状态 + 查询/重置。
• 操作栏：「+ 添加主播」。
• 列表卡片：主播数据表格 + 统一分页组件。

筛选区

添加主播弹窗

• 入口：操作栏点击「+ 添加主播」。
• 目的：从商城会员中单选一名会员设为主播。

• 单选：每次仅能选择一名会员。
• 分页：与全站列表分页样式一致。
• 关闭：关闭弹窗，不保存。
• 确定：校验所选会员是否已是主播——是则 Toast「请勿重复添加主播」；否则 Toast「添加成功」，关闭弹窗并在列表新增该主播（默认启用）。添加成功后该会员可用绑定账号登录 PC 直播间开播。

列表字段

规则

• 禁用后不可被新建直播场次选用；已绑定待开播场次需提示处理（同 AC-17）。
• 禁用后不可登录 PC 直播间；未在主播管理中添加的会员账号不可登录。
• 点击「详情」进入 4.3.1 主播详情。

4.3.1 主播详情

菜单：直播管理 → 主播管理 →「详情」。针对单个主播的跨场次经营分析页，与 4.2.3 单场直播数据（单场维度）独立。

页面入口与布局

• 入口：主播管理列表操作列「详情」。
• 返回：页内「← 返回主播列表」回到主播管理列表。
• 布局（自上而下）：顶部主播信息卡（固定）→ 直播概况（7 指标卡片）→ 直播图表（趋势 + 漏斗）→ Tab 明细（奖励明细 / 邀约人列表）。

顶部主播信息卡

固定展示，不随 Tab 切换隐藏。

直播概况

汇总该主播名下所有直播场次的数据指标，7 张指标卡横向排列。指标名称旁提供 i 图标：鼠标悬停展示该指标口径说明（与单场数据页同一套提示交互；统计范围为该主播全部场次，跨场次去重）。

直播图表

（1）实时观众人数趋势

折线图，按日统计三类人数的累计变化（每个数据点 = 截至该日的累计去重数；统计范围为该主播全部场次，跨场次去重）：

横轴按日（与单场数据页 HH:mm 不同）。图例：访问人数 / 观看人数 / 离开人数。

（2）直播转化漏斗

三层漏斗，自上而下依次为：

1. 访问人数 — 该主播名下各场次创建起至今，进入预告页或直播间相关页的去重用户数（跨场次去重；= 概况「访问人数」）。
2. 观看 — 该主播名下各场次开播起至今，直播中进房观看的去重用户数（预告不计；跨场次去重；= 概况「观看人数」）。
3. 成交 — 支付成功用户数（去重），与概况「订单成交金额 / 订单成交数量」口径一致。

漏斗数值与概况指标卡当前累计终值对齐（跨场次去重）。漏斗标题旁 ? 悬停提示路径：访问人数 → 观看 → 成交。漏斗右侧展示：

• 访问 → 观看 转化率
• 观看 → 成交 转化率
• 访问成交转化率（访问 → 成交总转化率）

Tab：奖励明细 / 邀约人列表

（1）奖励明细

记录该主播所有直播的订单奖励明细（跨场次汇总）。

（2）邀约人列表

记录该主播所有直播下的邀约人数据（跨场次汇总）。

订单详情弹窗（邀约）

点击邀约人列表「详情」弹出，展示该邀约对象的下单数据。

4.4 商品管理（直播商品池）

从商城商品库引入；建场时只从本池选用。数据按 SKU 单规格 展示。

页面布局

1. 筛选：商品、商品分类、商品状态 + 查询/重置。
2. 操作栏：「添加商品」。
3. 列表：SKU 维度表格 + 分页。

查询区

添加商品弹窗

• 从商城商品库多选；查询支持 ID/名称、分类、状态。
• 确定后按 SKU 回显至商品列表；分页格式同选择商品弹窗。

商品列表（按 SKU）

商品库存弹窗

门店 ID/名字搜索；列表：门店 ID、门店信息、可售库存；分页同选择商品弹窗。

规则

• 池内有货 ≠ 各参与店都能卖（R5）。
• 进行中场次占用的 SKU 不可移除。
• 直播价建议 ≤ 平台价；高于则二次确认。

4.5 优惠券管理（直播券池）

将主商城领取渠道=直播的优惠券添加至列表；从商城营销 → 活动管理引入，场次备券，PC 直播间手动发放（一期不做定时发）。

券全链路流程

流程说明：总览见 §3.3 图8。

闭环（一期）

营销·新增活动（领取渠道：商城|直播，创建后不可改）
        │
   ┌────┴────┐
   ▼         ▼
渠道=商城  渠道=直播
   │         │
领券中心   已开启 → 直播券池 → 建场备券 → PC【手动发放】→ 直播间领取
（过滤直播券）                                    │
                                          商城下单可核销（原逻辑）

与原商城营销的关系（底座 / 新增 / 边界）

页面目标

维护直播券池，供创建/编辑直播场次备券；后台不直接发券，主播在 PC 直播间手动发放。

查询区

操作：查询按条件过滤券池列表并回到第 1 页；重置清空条件并恢复全量列表。

操作栏

【添加优惠券】：点击弹出「添加优惠券」弹窗，从主商城营销中心引入优惠券至券池。

添加优惠券弹窗

（1）查询

• 优惠券：输入框，按优惠券名称模糊搜索。

（2）列表

（3）分页

格式同「选择商品」弹窗；查询或修改每页条数后回到第 1 页。

（4）操作

• 取消：关闭弹窗，不变更券池列表。
• 确定：将勾选结果回显至券池列表；已在池中的券不重复添加。

优惠券列表（券池）

删除

• 点击「删除」弹出二次确认「确认删除」。
• 点击「取消」：关闭弹窗，不删除。
• 点击「确认」：校验优惠券是否在直播间中发放中——是则提示「直播间发放中，提示不能删除」；否则从券池列表移除。

分页：格式同「选择商品」弹窗；查询或修改每页条数后回到第 1 页。

规则

• 遵循 R7/R10：本场券由中控发放；直播确认订单还可选用该商品商城详情中的券，与本场券互斥只选 1 张。
• 后台不发放到直播间；主播在 PC 直播间手动发券（一期无定时发）。
• 源活动须为「领取渠道=直播」且「已开启」方可从商城引入；券池移除不影响已结束场次订单快照。
• 用户在直播间领取后，商城下单核销逻辑与原商城优惠券一致。

4.6 基础设置

直播通用配置。主播账号维护见 4.3 主播管理。

4.6.1 奖励设置

结算周期规则（与 §2.3 一致）：

• 全局配置，主播带货奖励与邀约人奖励共用同一结算周期。
• 切换配置仅对保存后新达标订单生效，不追溯历史。
• 「订单完成」模式下，已支付未收货订单不出现在各端奖励明细，不设第三展示态。
• 「待结算」与「已结算」两层状态：前者由结算周期决定计入时点，后者由 R9 售后期满划扣决定。

4.6.2 直播设置

页面分区：功能开关 → 推流 / 播放配置 → 腾讯云密钥（敏感区顶部提示：密钥仅用于服务端调用，默认脱敏，勿对外分享）。

【保存设置】持久化全部配置，Toast 提示结果。

5.0 PC直播间菜单总预览

主播开播端口。视觉对齐 pencil-designer / 商城后台原型（主色 #1976d2、浅色后台、Material 圆角卡片）；水滴标注与商城后台原型同套（含中控弹窗：商品列表、商品库存、发券、连麦，打开弹窗时标注面板自动切换）。可交互原型：直播2/PC直播间原型.html；标注清单：直播2/PC直播间水滴标注清单.md。

5.1 端口定位与约束

5.2 登录与入口

商城后台添加且启用的主播，用绑定账号登录 PC 直播间开播。

• 入口：后台「主播端链接」（含 tenantId）。
• 布局：左氛围图 + 右浅底圆角登录卡片。
• 账号：占位「请输入账号」；支持手机号/昵称/ID；仅数字、字母、中文昵称及常用符号 ._@-，实时过滤特殊字符；空提交 Toast「请输入账号」。
• 密码：占位「请输入密码」；显示/隐藏切换；空提交 Toast「请输入密码」。
• 记住账号和密码：本地同时缓存账号与密码；下次打开自动回填；取消勾选清除缓存。
• 提交校验顺序：空账号 → 空密码 → 账号是否存在 → 密码是否正确 → 是否已绑定主播 → 是否启用。
• 失败提示：账号不存在 / 密码错误 / 该账号未绑定主播，无法登录 / 主播已禁用，无法登录；成功进入直播中心。
• 留意：公共电脑慎用记住密码；禁用下次登录拦截（正式版应踢已登录会话）；连续输错锁定/验证码见风险表。
• 原型演示：b / 123456（午间秒杀 id=30 三端联动）；或 qi / 123456；禁用示例 B / 13900001111；未绑定示例 13600136001。

5.3 直播中心

主播开播工作台——左侧展示重点预告场次并一键进入开播流程；右侧管理本主播近期场次。

主播开播流程

流程说明：PC 与 H5 同源；总览见 §3.3 图3。H5 入口见 §7.3。

左侧直播预告

• 候选：本主播「直播中」「待开播」；有直播中优先展示，否则展示开播时间最近的待开播。
• 展示：封面、名称、开播时间；【立即开始】待开播/直播中 → 直播中控（待开播进中控为「待开始」）。
• 底部：主播头像 / 昵称 / ID（可复制）。

右侧场次列表

• 范围：直播中 / 待开播 / 已结束（已取消不展示）；超出高度区域内滚动。
• 排序：状态（直播中＞待开播＞已结束）→ 开播时间升序 → 创建时间降序。
• 卡片：封面、名称、开播时间；待开播额外标「即将开播」。
• 直播中/待开播显示【开播】【取消】；已结束纯展示。
• 【开播】：待开播 / 直播中 → 直播中控（待开播时状态「待开始」）。【取消】二次确认后→已取消，不进直播历史，后台同步已取消。

5.4 开播准备

• WebRTC getUserMedia 本地预览；可选摄像头/麦克风。
• 本场信息只读：名称、状态、计划时间、商品数、券数。
• 【开始直播】：校验待开播、主播启用、无并行直播中、设备与推流成功 → 状态变直播中。

5.5 直播中控

主播开播主操作台。支持在本页完成待开始 → 直播中 → 已结束；不展示 KPI、不展示推流状态。后台「待开播」在中控展示为「待开始」。布局对齐直播伴侣：左右铺满；顶部状态栏与画面区贴合为同一深色整体；状态栏字段规则不变。进入中控后隐藏主播中心全局顶栏，中控占满可视区域；离开中控恢复。

中控带货流程

流程说明：总览见 §3.3 图4。

布局

原型水滴标注：中控页四个工具入口各挂独立水滴（④商品 / ⑤互动消息 / ⑥发券 / ⑦连麦），连麦面板独立水滴 ⑩（livingMicPanel）；商品/发券打开弹窗时切换至对应弹窗标注。

状态栏

• 【开始直播】可在中控「待开始」直接点；成功后场次→直播中；待开始期间摄像/麦克默认开启并显示预览，可手动开关。
• 关播触发：【×】或【结束直播】（直播中不展示【返回】）；确认后→已结束，停推停采集，本页结束页：标题「直播已结束」、直播时长 HH:MM:SS、数据卡两项指标（见下表）；底部【确定】回直播中心；商品/发券/连麦/评论输入禁用；摄像/麦克锁定关。

结束页数据卡口径（PC 中控与门店端主播结束页一致）：

原型演示默认：观看人数 100 人、最高在线人数 80 人。

画面预览与设备操作条

一期仅摄像头。进入中控（待开始）摄像/麦克默认开；已结束由本场数据页覆盖预览区。摄像头/麦克风为圆形图标 + 名称，置于左侧竖向设备操作条；关闭态图标带禁用斜线。

原型门店端联动：仅直播中将预览帧（约 3～4fps、缩略 JPEG）经 BroadcastChannel + localStorage key live2_preview_bus_v1 同步至门店端观看页；正式版改为 CDN 拉流播放。

实时数据弹窗

入口：状态栏右侧【实时数据】。待开始 / 直播中 / 已结束均可打开（只读）。深色弹窗；右上角 × 关闭。布局：顶行左「直播时长」、右「今日奖励」；底行三列「本月获得奖励 / 已发放奖励 / 待发放奖励」。

在线观众弹窗

入口：状态栏【在线 N】（顶栏观看人数（实时）区域）。口径与门店端 H5 中控「在线观众」一致。顶栏展示名仍为「观看人数」，口径为当前在房在线数，与数据页「观看人数（累计）」同名不同义。

商品列表弹窗

• 标题：商品列表；右上角 × 关闭弹窗。
• 布局：商品坑列表超出面板高度时可上下滑动（滚动条可见）；底部【关闭】按钮固定在弹窗底部。
• 搜索：商品名称模糊；占位「请输入商品名称」；点击「搜索」刷新列表。
• 列表：按 SPU 一行（本场已添加规格收在该行）；支持 ↑ / ↓ 调整 SPU 顺序（同步会员端货架；搜索时不可排序）。
• 卡片：图片、名称左侧排序号（1、2、3…）、名称、销售价、直播价=该 SPU 默认规格直播价、主播奖励比例（图左上展示为「奖励X%」，如「奖励8%」）。默认规格优先商城默认 SKU，未加入本场则取本场已添加排序最前。
• 置顶：将该 SPU 移到列表第 1 位；Toast「置顶成功」；同步会员端；搜索时禁用。无讲解按钮。
• 上架 / 下架：整 SPU 控制会员端货架；不可单独下架某一规格。原型经 live2_goods_bus_v1 同步。
• 店库存：展示有货门店数 / 无货门店数（仅统计本场参与门店）；点击打开商品库存弹窗。
• 商品库存弹窗：右上角 × 关闭；商品名称加粗展示（如「康养礼包」）；门店搜索占位「请输入门店名称」，模糊匹配门店名称；列表仅展示本场参与门店；可纵向滚动且滚动条可见，底部【关闭】固定；字段：门店信息（logo、名称、电话）、库存（有库存：合计可售≠0；无库存：合计可售=0 且标红）。门店 ID 与后台/门店端统一为 1001 起。
• 不可改价/改主播奖励比例/增删 SKU；中控不提供售罄操作。

互动消息

主播在中控实时查看会员评论并回复；同步展示讲解商品、发券等业务消息。连麦不在公屏展示。 会员端公屏（见 第 6 章 门店端·会员直播）与中控、后台单场数据页采用同一套胶囊气泡样式。

消息类型

上述四类消息均进入公屏；粉丝端、后台单场数据页与中控展示规则一致。连麦仅在连麦弹窗 / 小窗处理，不进入公屏。

评论气泡（单条 UI）：深色胶囊圆角气泡，对齐直播伴侣参考截图。

评论列表

输入区与表情：圆角深色一体化输入条；占位「添加评论…」。

数据同步

各直播状态可用性

不可：评论审核、删除、禁言、置顶、私信（一期不做评论管理中台）。

发券 → 优惠券弹窗

入口：直播工具【发券】→ 弹窗标题「优惠券」；右上角 × 关闭。数据源：本场备券（商城后台优惠券管理入池）。

列表：本场备券；仅展示活动「已开启」且有全局库存（或不限量，或本场已发放）的券；已结束/已关闭不展示；本场未发放且全局库存=0（被其他直播间领完）不展示。

库存：全局库存=活动发放数量−已领取（全渠道共享；不限量恒有库存）；本场发放剩余=点击【发放】时快照，会员领取时扣减。

活动开始时间：沿用原商城；当前时间<活动开始时间 显示「不可发放」置灰。

不限量券发放后持续「发放中」，不出现「已发完」。待开始可看不可发；已结束入口禁用。本场已发完且全局库存=0 仍展示。库存为 0 点发放 Toast「券库存不足」。不可临时加券。

连麦（完整流程）

5.6 数据分析

汇总查看本主播的直播经营数据与趋势（区别于后台全场次数据看板）。PC / 门店端主播 / 后台主播详情·单场数据同名指标口径一致，可对账。

筛选：全部 / 今日 / 本周 / 本月（单选，按开播时间落入区间）；切换后刷新概况、实时观众人数趋势与直播转化漏斗。

概况

直播转化漏斗

紧跟概况下方。结构与口径对齐 4.2.3 单场「直播转化漏斗」；范围为当前主播 + 时间筛选内场次汇总（跨场次去重）。三层：访问人数 → 观看 → 成交（支付成功用户数，与订单成交口径一致）；数值与概况终值对齐。

UI：标题 ? tip、洞察条「访问成交转化率为 X%」（不含「【数据解读】」「总」前缀）、右侧区间转化率、竖向访问成交转化率。与概况「商品转化率」分母不同（查看商品人数）。

实时观众人数趋势

紧跟直播转化漏斗下方。结构与口径对齐 4.2.3 单场「实时观众人数趋势」；范围为当前主播 + 时间筛选汇总（跨场次去重）。三折线：访问人数 / 观看人数 / 离开人数（每个数据点 = 截至该日的累计去重数）。

页面顺序：概况 → 直播转化漏斗 → 实时观众人数趋势。

不做 GMV / 商品转化率 / 订单成交金额 / 订单成交数量 / 主播带货奖励经营趋势图。

5.7 直播订单

记录并查询本主播直播期间产生的订单（只读；售后走商城原订单中心）。

组合查询

【搜索】过滤并回第 1 页；【重置】清空条件恢复全量。

订单列表

列表列较多时支持左右滑动查看。

分页：格式同「选择商品」弹窗（共 X 条｜上一页 / 页码 / 下一页｜每页条数下拉｜跳至）；查询或改每页条数后回到第 1 页。不提供改价、发货、退款。

5.8 直播历史

展示本主播已结束场次数据，卡片形式展示。本期不做回放带货。

分页：格式同「选择商品」弹窗（共 X 条｜上一页 / 页码 / 下一页｜每页条数下拉｜跳至）；查询或改每页条数后回到第 1 页。

5.9 状态联动

流程说明：场次状态机见 §3.2；下图汇总多端动作与后台状态同步。

6.0 端口定位与页面总览

会员观看与下单端口（不含主播开播，主播见第 7 章）。与第 4 章、第 5 / 7 章串联。原型：直播2/商城门店端直播原型.html；标注清单：直播2/门店端水滴标注清单.md。

端到端链路

商城后台创建直播 → 主播在 PC 或 门店端主播工作台开播 → 会员在「我的 → 直播」观看 / 下单。主播开播能力见 第 7 章。

会员侧主流程

流程说明：总览见 §3.3 图5；未参与拦截见 §6.6。

页面一览

6.1 入口与直播中心

入口：「我的」功能宫格「直播」（与门店首页、领券中心等并列）→ 页名「直播中心」。同宫格「直播」右侧为「主播」入口（见 第 7 章）。

6.1.1 我的收益

记录当前登录会员作为邀约人的邀约记录与奖励明细；字段口径与商城后台「邀约人列表 / 奖励明细」一致（C 端仅看本人数据）。

邀约列表

奖励明细

邀约列表、奖励明细均支持纵向滚动，滚动条隐藏。

6.1.2 直播回放（会员观看）

进房条件（须同时满足）：

1. 商城后台「直播管理 → 基础设置 → 是否开启直播回放」为开启（见 §4.6）；
2. 本场已有回放资源（录制完成可播）。

入口：直播中心点击已结束场次卡片。不满足上述任一条件时：不进入本页，Toast「本场已结束」；一期不做只读结束说明页；不可下单、不可领本场券（R6）。

交互：竖屏全屏播放本场录制回放；标题「直播回放」；右上角 × 返回直播中心。底栏：播放 / 暂停、当前时长、进度条、总时长、全屏。

边界（R6）：仅观看，不按本场直播价售卖、不发本场券、不计本场分红；不做回放带货计佣。UI 与主播端「直播回放」页一致，返回目标为直播中心（非主播直播历史）。

6.2 直播预告

待开播场次进入预告页。

6.3 直播间观看

阶段行为

画面与工具

顶部栏

在线观众抽屉（会员观看页）

入口：观看页顶栏头像组 + 在线人数。口径与门店端 H5 中控 / PC「在线观众」一致；会员端只读（无踢人等操作）。

直播间浮窗

会员进入本场观看页且场次 直播中 后，离开观看页即在全局页面展示悬浮 【直播中】 浮窗。本期不做视频缩放小窗 / 画中画（PiP）；浮窗不含直播画面预览。

主播工作台例外（整区）：「我的 → 主播」下全部页面（资料、开播列表、历史、数据分析、订单、H5 中控、回放等）不展示浮窗，且自动结束在房会话。

各页顶栏 ‹ 等既有返回保留；商品详情 ‹ 回房仍可打开商品列表；浮窗回房不打开商品列表。

公屏消息类型

与 PC 中控、商城后台单场数据页采用同一套胶囊气泡；连麦不进公屏。

三端联动：正式版 WebSocket；原型 live2_chat_bus_v1 跨标签演示（liveId=30「午间秒杀」）。

优惠券抽屉

入口：直播间左侧优惠券图标 → 底部弹出「优惠券」抽屉。

布局：与商品列表面板高度一致，固定占直播间可视高度 75%（内容少时不收缩）；券列表超出时不显示滚动条，可手动上下滑动，不左右滑。

列表范围：仅展示主播在 PC 中控已点击【发放】的券；推送 COUPON_ISSUED（正式版 WebSocket；原型 localStorage 跨标签）。

发券推送弹窗（待领取）

主播在中控【发放】后，向在房未领会员弹出：标题「直播惊喜券」（无顶部装饰图）+ 券卡 + 立即领取 + 关闭；关闭后同券不再强弹，仍可从抽屉领取。

领券成功弹窗

领取成功后弹出「优惠券领取成功」（无顶部装饰图）+ 券卡 + 去使用（打开商品列表）+ 底部关闭。仅发券推送弹窗内领取触发；抽屉内领取不触发。

优惠券卡片字段（对齐展开截图）：

商品面板（购物车）

深色底栏面板，对齐观看端参考稿；高度与优惠券抽屉一致，固定占可视高度 75%（内容少时不收缩）；商品列表超出时不显示滚动条，可手动上下滑动，不左右滑。

数据范围：仅展示中控 已上架 SPU；一张卡一个 SPU；卡面直播价=默认规格价。库存读本店可售（R5）。

商品详情（直播商品）

身份：① 直播间入口（货架/抢购/公屏商品卡）；② 本场直播商品详情分享链（有观看本场权限）→ 直播详情。商城列表、订单再买、非直播商品链 → 普通详情。

连麦入口（观众）

底栏顺序：评论输入 → 表情 → 购物车 → 连麦 → 更多 ⋯。
仅当本场「开启连麦」= 开时显示【连麦】按钮；关闭时整钮隐藏。

主播拒绝 → Toast「主播已拒绝连麦」；事件不进公屏。

分享入口

底部「更多 ⋯」打开更多面板，仅含【分享】：

废除原「点击右上角进行分享」Toast；观众端与预告页、主播 H5 更多·分享共用同一套链接生成与归因规则。

6.4 下单与履约

直播中下单走原商城购买流程；页面级「底座 / 新增 / 边界」总表见附录「原商城改动影响面」。

下单履约与分红流程

流程说明：计价与分红规则见 §2.3；总览见 §3.3 图6。

提交订单

订单支付 / 支付成功

我的订单（C 端）

入口：「我的 → 全部订单 / 待付款等状态」或直播间商品面板【订单】。不另建直播订单中心。

订单详情（C 端）

6.5 分享与邀约归因

做三渠道分享归因、进房锁定、下单计奖与后台邀约排名；不做多级裂变与 C 端排行榜（与 1.1 一致）。

邀约分享流程

流程说明：总览见 §3.3 图7；邀约人收益见 §6.1.1。

6.5.1 按页面的分享入口

6.5.2 分享弹窗（shareSheet）

底部 Sheet；标题「分享」；渠道不含朋友圈。

不做展示：弹窗底部灰色说明文案（如链路参数、首次进房锁定邀约规则）；归因规则仍见 6.5.3～6.5.5。

微信好友分享卡片

生成海报（sharePoster）

不做展示：「邀约人 ID · 扫码进房锁定归因」、主播信息。邀约参数仍写入二维码链接。

6.5.3 链接规范

https://{商城域名}/live/{live_id}?inviter={member_id}&from=share

可选 channel=wechat|poster|copy 仅统计，不参与归因唯一键。海报二维码与复制链接参数须一致。未登录须先登录再分享。

观看登录：所有用户观看直播（含预告/观看/分享或扫码进入）均须先登录；未登录打开链 → 登录 → 带回原链参数再进房校验。

6.5.4 角色与术语

示例：会员2 分享 → 会员1 打开链接进房 → 会员1 下单 → 会员2 获邀约奖励。

6.5.5 进房归因与锁定

6.5.6 数据去向

6.5.7 直播商品详情分享（仅复制链接，不计邀约）

与 6.5.2 三渠道邀约分享隔离：商品详情分享只传播直播商品落地页，不写邀约记录、不锁定邀约人、下单不计邀约奖。

分享弹层（goodsShareSheet）

链接规范

https://{商城域名}/live/{live_id}/goods/{spu_id}?sharer={member_id}&from=goods_share

禁止在本链上使用 inviter 或写入邀约归因逻辑。

从分享进入直播商品详情

6.6 未参与拦截

无权限 = 当前登录会员所属门店不在本场参与门店范围内。拦截页不写邀约记录。

7. 商城门店端 · 主播

已被商城后台添加且启用的主播，在门店端「我的 → 主播」进入工作台。功能逻辑与数据统计与 PC 直播间一致（概况 / 历史 / 订单奖励口径同 5.6～5.8）。原型页面 key：anchor / anchorHistory / anchorAnalytics / anchorOrders / anchorLive。

7.0 端口定位

7.1 入口与身份校验

入口位置：「我的」功能宫格，「直播」右侧「主播」。入口对所有会员可见；点击时校验：

7.2 主播工作台

开播列表仅本主播场次；仅展示直播中、待开播（不含已结束、不含已取消）。排序三级：① 直播中 ＞ 待开播；② 开播时间升序；③ 创建时间降序。资料区 / 快捷入口 / Tab 固定，列表区可上下滑动（隐藏滚动条）。卡片时间直接展示（如 2026-07-22 12:00:00），不带「开播时间」前缀。

7.3 H5 直播中控

定位：App 可交互开播中控（非空占位页）。状态机：待开播 →【开始直播】→ 直播中 → 顶栏返回/× 确认 → 已结束（独立结束页）。同一主播同时仅 1 场直播中（PC/App 互斥）。

H5 开播流程

流程说明：与 PC 同源，入口不同；总览见 §3.3 图3、§5.3。

顶栏（待开播 / 直播中）

在线观众抽屉

待开播 / 直播中

底栏与「更多」（待开播 / 直播中）

商品库存抽屉（门店端 H5）

定位：H5 主播中控内，查看当前 SPU 在各参与门店的可售库存。
容器：底部抽屉（原型 hostStockSheet）；业务逻辑与 PC 中控「商品库存」弹窗（§5.5）一致，仅 UI 容器不同。

入口：商品列表【店库存】→ 抽屉「商品库存」。
叠层：自商品列表（hostGoodsSheet）之上打开；关闭后回到商品列表。

已结束页

关播确认后进入独立结束页（不留在中控锁定态）。

统计口径与 PC 中控结束页（§5.5）一致。原型演示默认：观看人数 100 人、最高在线人数 80 人。

7.4 直播历史 / 数据分析 / 直播订单

直播历史

独立页面（入口：主播工作台 Tab「直播历史」）。本主播已结束场次时间轴「直播动态」；列表区可上下滑动（隐藏滚动条）；口径同 PC 5.8。

直播回放

入口：直播历史卡片封面。竖屏全屏播放本场回放；标题「直播回放」；右上角 × 返回直播历史。底栏：播放/暂停、当前时长、进度条、总时长、全屏。仅观看，不做回放带货计佣（R6）。

数据分析

时间筛选：全部 / 今日 / 本周 / 本月；切换后刷新概况、实时观众人数趋势与直播转化漏斗。

直播概况与商城后台 4.3.1 主播详情严格同构：7 张指标卡（GMV、商品转化率、主播带货奖励、访问人数、观看人数、订单成交金额、订单成交数量）；不含最高点赞数、最高在线数、累计开播次数。

页面顺序：概况 → 直播转化漏斗 → 实时观众人数趋势。漏斗/观众趋势口径对齐 §4.2.3 / §4.3.1（跨场次去重）。不做 GMV / 商品转化率 / 订单成交金额 / 订单成交数量 / 主播带货奖励经营趋势图。

与 PC 5.6 差异：PC 数据分析概况另含累计开播次数；门店端不做此项。

直播订单

本主播带货奖励明细（非邀约人奖励）；列表=当前主播全部直播间订单。

7.5 与 PC 中控对照 · 7.6 收益隔离

7.5 与 PC 中控对照

7.6 与「我的收益」隔离

8. 原商城改动影响面

统一「底座 / 新增 / 边界」写法。历史修订若与本附录冲突，以本附录当前结论为准。

A. 总览矩阵

B. 门店端 · 页面明细

B1 我的订单

B2 订单详情

B3 提交订单

B4 订单支付 / 支付成功

C. 商城后台 · 订单管理

C2. 商城后台 · 营销 · 活动管理

D. 研发对照速记

9.1 非功能需求

9.2 验收标准（节选）

9.3 风险与待定

附录 · 术语表

附录 · 演示数据口径（三端联动）

原型验收时，唯一全量联动演示场次如下（三端须同浏览器多标签同开）。

商品场景覆盖（名称/直播价三端一致）：

券场景覆盖：

午间秒杀奖励明细与 PC「直播订单」、后台邀约订单统一为水果商品与订单号 E20260722120… 系列，不再使用洗发水挂本场。