| 文档属性 | 内容 |
|---|
| 文档版本 | V1.0 |
| 产品名称 | 直播激励结算中台 |
| 模块名称 | 薪酬列表 - 薪酬数据总览 |
| 系统版本 | V10.1 |
| 优先级 | P0（核心功能） |
| 文档状态 | 初稿 |
| 创建日期 | 2026-03-25 |
一、需求背景
1.1 业务背景
在直播激励结算业务中，运营、财务等角色需要对已结算的薪酬数据进行多维度查看、筛选、分析和导出。当前薪酬数据分散在多个Excel文件中，存在以下痛点：
- 数据分散难查：薪酬数据、订单数据、账号数据、效果数据分散在不同系统和文件中，缺乏统一查看入口
- 筛选效率低下：需要人工在Excel中逐一筛选，无法快速定位特定月份、平台、账号的数据
- 数据指标难算：CPE、CPM、CPC等效果指标需要手动计算，容易出错
- 导出流程繁琐：多表数据合并导出需要多步手工操作
1.2 需求目标
在 薪酬列表 模块下新增 「薪酬数据总览」 页面，实现：
- 一站式查看：将薪酬导入数据、订单数据、账号数据、效果指标数据整合到一张表中，提供51个标准字段 + 动态无法识别列的完整视图
- 灵活多维筛选：支持按月份、平台、COA、账号、订单号等多维度组合筛选，Tag式输入支持多值OR查询
- 自动指标计算：CPE、CPM、CPC、观看成本、点击成本、互动成本等效果指标由系统自动计算，确保准确性
- 便捷数据导出：一键导出Excel，自动附带字段来源说明行
1.3 核心前提
⚠️ 大前提：薪酬数据总览中的所有数据，必须在薪酬审核通过后才可展示。
- 只有薪酬审核流程审核通过（状态为"已审核"）的数据才会进入薪酬数据总览
- 薪酬审核未通过或审核中的数据不会在总览中出现
- 薪酬数据总览不展示任何未经审核确认的薪酬数据，确保数据的准确性和合规性
- 该前提贯穿整个薪酬数据总览的数据获取、展示、筛选、导出等所有环节
1.4 目标用户
| 用户角色 | 使用场景 | 核心诉求 |
|---|
| 运营人员 | 查看已结算薪酬数据、按平台/月份筛选、导出对账单 | 快速定位、灵活筛选、一键导出 |
| 财务人员 | 审核结算明细、对账、核查金额 | 数据准确、来源可追溯、导出完整 |
| 项目负责人 | 查看各游戏/COA的投放效果指标 | 多维对比、指标直观、趋势分析 |
二、产品整体架构
2.1 功能定位
本功能位于 薪酬列表 模块下的 「薪酬数据总览」 页面，用于将薪酬审核通过后的薪酬导入数据、订单数据、账号数据、效果指标数据整合展示。
薪酬列表
└── 薪酬数据总览（本功能）
├── 筛选区域（Tag式多值筛选）
├── 已选筛选标签展示
├── 工具栏（统计、搜索、导出、分页设置）
├── 数据表格（51个标准字段 + 动态无法识别列）
└── 分页栏
2.2 数据流向
薪酬审核通过 → 数据进入薪酬数据总览 → 多源数据整合（薪酬+订单+账号+效果指标）→ 标准化为51字段 + 无法识别列 → 前端展示/筛选/导出
2.3 数据准入规则（核心）
| 规则 | 说明 |
|---|
| 薪酬审核状态 | 仅展示薪酬审核状态为"已审核"的数据 |
| 数据时效性 | 薪酬审核通过后实时（或准实时，延迟≤5分钟）同步至薪酬数据总览 |
| 审核撤回处理 | 若薪酬审核被撤回（从"已审核"变为其他状态），对应数据应从总览中移除 |
| 数据完整性 | 审核通过的薪酬数据必须关联完整的订单信息和账号信息后才展示 |
三、功能详细描述
3.1 数据源与字段定义
3.1.1 标准字段表（51个字段）
数据总览展示的51个标准字段 + 动态追加的无法识别列，来源覆盖薪酬导入、公式计算、匹配关联等多个来源：
基础信息字段（23个）
| # | 字段名 | 数据来源类型 | 来源说明 | 是否必填 |
|---|
| 1 | 订单创建月份 | 薪酬导入 | 取自薪酬导入的"薪酬月份"字段 | 是 |
| 2 | 系统来源 | — | 无直接来源，默认值或系统写入（如BFC） | 否 |
| 3 | 产品ID | — | 暂无独立来源，关联产品库 | 否 |
| 4 | 产品名称 | — | 暂无独立来源，关联产品库 | 否 |
| 5 | COA_ID | 匹配关联 | 根据所选产品名称映射对应的COA_ID | 是 |
| 6 | COA名称 | 匹配关联 | 通过活动创建时选择的产品名称匹配获取 | 是 |
| 7 | SG | — | 暂无来源 | 否 |
| 8 | 产品类型 | — | 暂无来源 | 否 |
| 9 | 订单号 | 薪酬导入 | 来自活动创建模块的"上游订单号"字段 | 是 |
| 10 | 订单事项开始月份 | 薪酬导入 | 活动创建时填写的"开始时间" | 是 |
| 11 | 订单事项结束月份 | 薪酬导入 | 活动创建时填写的"结束时间" | 是 |
| 12 | 验收状态 | — | 系统流程状态，验收流程驱动（待对接） | 否 |
| 13 | 验收单号 | — | 系统自动生成（待对接） | 否 |
| 14 | 立项单号 | — | 关联立项系统（待对接） | 否 |
| 15 | 立项名称 | — | 关联立项系统（待对接） | 否 |
| 16 | 采购类别 | — | 暂无来源 | 否 |
| 17 | 采买类型 | — | 暂无来源 | 否 |
| 18 | 场景 | — | 暂无来源 | 否 |
| 19 | 合作模式 | — | 暂无来源 | 否 |
| 20 | 采买方式 | — | 暂无来源 | 否 |
| 21 | 平台 | 薪酬导入 | 从薪酬导入Excel的"平台"字段获取 | 是 |
| 22 | 原平台 | — | 与平台关联或由导入时带入（待对接） | 否 |
| 23 | 数据版本 | 薪酬导入 | 由薪酬导入时携带的数据版本信息 | 是 |
账号信息字段（6个）
| # | 字段名 | 数据来源类型 | 来源说明 | 是否必填 |
|---|
| 24 | 游可爱id | — | 无直接来源，薪酬导入时备注信息区域（待对接） | 否 |
| 25 | 账号ID | 薪酬导入 | 从薪酬导入的"平台账号ID"字段获取 | 是 |
| 26 | 账号名称 | 匹配关联 | 通过账号ID匹配账号库中的昵称 | 是 |
| 27 | 账号分级 | — | 暂无来源 | 否 |
| 28 | 账号圈层 | — | 暂无来源 | 否 |
| 29 | 账号粉丝数 | — | 暂无来源 | 否 |
金额字段（2个）
| # | 字段名 | 数据来源类型 | 来源说明 | 是否必填 |
|---|
| 30 | 已执行总价（不含服垫税减） | — | 暂无来源 | 否 |
| 31 | 已执行总价（含服垫税减） | 薪酬导入 | 从薪酬导入的"薪酬金额"字段获取 | 是 |
效果数据字段（13个）
| # | 字段名 | 数据来源类型 | 来源说明 | 是否必填 |
|---|
| 32 | 有效阅读量 | 匹配关联 | 导入数据中字段名近似匹配（"阅读量"≈"有效阅读量"） | 否 |
| 33 | 有效播放量 | 匹配关联 | 导入数据中"播放量/播放次数"等近似匹配 | 否 |
| 34 | 总互动量 | 匹配关联 | 导入数据匹配，或由 点赞+转发+评论+弹幕 计算 | 否 |
| 35 | 点赞量 | 匹配关联 | 导入数据中"点赞"相关字段匹配 | 否 |
| 36 | 转发量 | 匹配关联 | 导入数据中"转发/分享"相关字段匹配 | 否 |
| 37 | 评论量 | 匹配关联 | 导入数据中"评论"相关字段匹配 | 否 |
| 38 | 弹幕量 | 匹配关联 | 导入数据中"弹幕"相关字段（B站特有） | 否 |
| 39 | 总观看人数 | 匹配关联 | 匹配"访问人数/UV/观看UV"等近似字段 | 否 |
| 40 | 峰值在线人数 | 匹配关联 | 匹配"峰值/在线峰值"等近似字段 | 否 |
| 41 | 直播间点击次数 | 匹配关联 | 匹配"点击次数/PV"等近似字段 | 否 |
| 42 | 直播间点击人数 | 匹配关联 | 匹配"点击人数/点击UV"等近似字段 | 否 |
| 43 | 直播总时长（min） | 匹配关联 | 匹配"直播时长"相关字段 | 否 |
| 44 | 平均在线人数ACU（min) | 匹配关联 | 匹配"ACU/平均在线"相关字段 | 否 |
公式计算指标字段（7个）
| # | 字段名 | 计算公式 | 说明 |
|---|
| 45 | CPE | 薪酬金额 ÷ (点赞量 + 评论量 + 转发量) | 每次互动成本（Cost Per Engagement） |
| 46 | CPM | 薪酬金额 ÷ 有效播放量 × 1000 | 千次播放成本 |
| 47 | CPC | 薪酬金额 ÷ 有效播放量 | 每次播放成本（Cost Per Click） |
| 48 | 单人观看成本 | 薪酬金额 ÷ 总观看人数 | — |
| 49 | 单人点击成本 | 薪酬金额 ÷ 直播间点击人数 | — |
| 50 | 单次点击成本 | 薪酬金额 ÷ 直播间点击次数 | — |
| 51 | 互动成本 | 薪酬金额 ÷ (点赞量 + 评论量 + 转发量 + 弹幕量) | — |
无法识别字段（动态列）
| 说明 | 数据来源类型 | 展示规则 |
|---|
| 薪酬导入时无法自动匹配到标准字段的原始列，每个原始列独立追加为表格末尾的一列，表头名即为原始Excel中的列名 | 薪酬导入（无法识别） | 有值红色加粗显示，无值显示灰色 — |
3.1.2 字段来源分类
| 来源类型 | 标识色 | 说明 | 涉及字段数 |
|---|
| 薪酬导入 | 🔵 蓝色 | 从薪酬导入Excel中直接获取的字段 | 8个 |
| 公式计算 | 🟡 橙色 | 由其他字段通过公式计算得出的衍生指标 | 7个 |
| 匹配关联 | 🩷 粉色 | 通过ID匹配或字段名近似匹配获取的字段（含COA_ID、COA名称） | 16个 |
| 无法识别 | 🔴 红色 | 薪酬导入时无法自动匹配到标准字段的原始列，按原始表头名独立成列追加在末尾 | 动态（N个） |
| 无/暂无 | ⚪ 灰色 | 暂无明确来源的字段，表头保留但数据单元格统一显示 —，待后续对接 | 20个 |
3.1.3 表头来源指示器（Tooltip）
- 每个表头字段名称旁显示一个彩色圆点，颜色对应字段来源分类
- 鼠标悬停（hover）在圆点上时，会弹出Tooltip 提示框，显示该字段的来源类型和详细说明
- 提示框格式为：
[来源类型] 详细说明，如 [薪酬导入] 取自薪酬导入的"薪酬月份"字段
- 提示框位于圆点上方，深色背景白色文字，带三角指示器，鼠标移走后自动消失
- 该功能帮助用户快速了解每个字段的数据来源和含义，无需查阅文档
3.1.4 公式计算规则
- 计算时机：数据进入总览后由系统自动计算，不需要用户手动操作
- 除零处理：当分母为0或空时，计算结果显示为
—（不显示0，避免误解）
- 精度规则：计算结果保留2位小数
- 依赖关系：公式计算字段依赖金额字段和效果数据字段，当依赖字段为空时不做计算
3.1.5 无法识别数据处理规则
- 产生场景：薪酬导入Excel中包含系统无法自动识别或匹配到标准字段的原始列
- 展示方式：每个无法识别的原始列独立成为一个表头列，追加在标准字段列的末尾。有多少个无法识别的原始列就追加多少列，表头名即为原始Excel中的列名
- 数据显示：有值时以红色字体（#dc2626）加粗显示原始数据值；无值时显示灰色
—
- 表头样式：无法识别列的表头背景为浅红色（#fff5f5），文字为红色，圆点为红色（#f87171），hover 提示标注为"[无法识别]"
- 来源归属：无法识别的列统一归属为"薪酬导入"来源，因为数据来自薪酬导入Excel
- 导出处理：导出Excel时无法识别的列也会包含在导出数据中，与标准列一起导出
- 操作建议：运营/财务人员发现无法识别列后，应人工核查该列的含义，必要时联系数据源方确认后补充到标准字段映射中
3.2 筛选功能
3.2.1 功能说明
提供多维度的Tag式筛选输入，支持多值组合查询。所有筛选均基于薪酬审核通过后的数据集进行。
3.2.2 筛选维度
| 筛选项 | 输入方式 | 匹配逻辑 | 说明 |
|---|
| 订单创建月份 | Tag输入（回车添加） | 前缀匹配，多值OR | 输入如"2025-03"，支持同时筛选多个月份 |
| 平台 | Tag输入（回车添加） | 包含匹配，多值OR | 支持B站、抖音、快手、小红书等平台筛选 |
| COA_ID | Tag输入（回车添加） | 包含匹配，多值OR | 输入COA编号 |
| COA名称 | Tag输入（回车添加） | 包含匹配，多值OR | 输入COA名称关键词 |
| 账号名称 | Tag输入（回车添加） | 包含匹配，多值OR | 输入主播/账号名称 |
| 订单号 | Tag输入（回车添加） | 包含匹配，多值OR | 输入订单号 |
3.2.3 筛选交互设计
Tag式输入组件
- 输入框支持自由文本输入，按 回车 添加为Tag
- 输入时实时展示建议下拉列表（从当前数据集中提取可选值）
- 建议列表支持键盘 ↑↓ 导航，回车选中
- 已选中的值在建议列表中标记 ✓，不可重复添加
- 每个Tag右侧有 ✕ 删除按钮，支持单个移除
- 输入框为空时按 Backspace 可删除最后一个Tag
- 点击输入区域外自动关闭建议列表
筛选逻辑
| 规则 | 说明 |
|---|
| 同一维度内 | 多个值之间为 OR 关系（任一匹配即通过） |
| 不同维度间 | 各维度之间为 AND 关系（所有维度都需满足） |
| 不选任何值 | 默认显示全部数据（薪酬审核通过后的全量数据） |
| 重置 | 清空所有筛选条件，回到全部数据 |
全局搜索
- 工具栏提供全局搜索框，支持在所有字段中模糊搜索
- 搜索与Tag筛选同时生效（AND关系）
- 实时搜索，输入即触发
3.2.4 已选筛选标签展示
- 筛选区域下方展示当前所有已选的筛选条件标签
- 格式为：
维度名: 值，如 平台: B站、订单创建月份: 2025-03
- 每个标签可单独点击 ✕ 移除，移除后自动刷新数据
- 无筛选条件时该区域自动隐藏
3.3 数据表格
3.3.1 功能说明
以标准数据表格展示经筛选后的薪酬数据，支持排序、分页、横向滚动。
3.3.2 表格特性
| 特性 | 说明 |
|---|
| 列数 | 51列（标准字段） + N列（无法识别列） + 1列（行号） |
| 表头固定 | 表头置顶（sticky），滚动时不消失 |
| 列宽自适应 | 根据字段类型设置合理的默认列宽 |
| 横向滚动 | 宽度超出时支持横向滚动 |
| 行号列 | 最左侧显示序号（#），不可排序 |
| 来源指示器 | 表头字段名旁显示圆形来源标识色点，鼠标悬停时弹出Tooltip显示来源类型和详细说明 |
3.3.3 排序功能
- 点击表头可按该列升序/降序切换排序
- 排序后表头高亮显示当前排序列和方向（▲/▼）
- 数值列按数值大小排序，文本列按中文拼音排序
- 同一时间仅支持单列排序
3.3.4 单元格显示规则
| 情况 | 显示方式 |
|---|
| 来源为"无/暂无"的字段 | 表头保留显示，数据单元格统一显示灰色 —，表示该字段暂无数据来源 |
| 无法识别列（动态追加列） | 有值时以红色加粗显示原始数据，无值时显示灰色 —；表头浅红色背景 |
| 验收状态 | 彩色标签：已验收(绿)、未验收(红)、验收中(黄)、部分验收(蓝) |
| 采买方式 | 彩色标签：购买(蓝)、配送(紫) |
| 金额/效果指标列（数值列） | 千分位格式化，如 1,234,567.89 |
| 计算指标列（CPE/CPM/CPC等） | 蓝色加粗显示，保留2位小数 |
| 数值为0 | 浅灰色显示 0 |
| 值为空 | 显示灰色 — |
| 超长文本 | 单元格内文本溢出时省略号截断，悬浮(hover)显示完整内容 |
3.3.5 分页功能
| 功能项 | 说明 |
|---|
| 每页条数 | 支持 20 / 50 / 100 条/页切换，默认20条 |
| 分页导航 | 上一页/下一页 + 页码按钮，超过7页时省略中间页码显示 … |
| 页码信息 | 展示"共 X 条，第 Y/Z 页" |
| 翻页后自动回顶 | 点击翻页后表格滚动回顶部 |
3.4 工具栏
3.4.1 数据统计
- 显示总数据条数（薪酬审核通过后的全量数据条数）
- 筛选后显示筛选结果条数
- 未筛选时仅显示总数
3.4.2 导出功能
| 功能 | 说明 |
|---|
| 导出全部(Excel) | 导出当前筛选结果的全部数据为 .xlsx 文件 |
| 导出本页 | 仅导出当前页的数据为 .xlsx 文件 |
| 文件命名 | 薪酬数据总览_全部数据.xlsx 或 薪酬数据总览_当前页.xlsx |
| 导出内容 | 第1行：51个标准字段 + 无法识别列表头；第2~N行：数据行；末尾附加字段来源说明行 |
| 来源说明行 | 每个字段标注 [来源类型] 来源说明 | 详细描述，方便接收方理解数据含义 |
| 列宽设置 | 自动设置合理列宽，确保导出文件可读性 |
| 空数据处理 | 无数据时点击导出提示"没有可导出的数据" |
3.4.3 全局搜索
- 在全部51个标准字段中进行模糊搜索
- 支持输入即搜索（实时触发）
- 与筛选条件叠加生效
四、数据准入与安全机制
4.1 薪酬审核流程与数据总览的关系
薪酬数据导入 → 薪酬审核流程 → 审核通过 → 数据进入总览可见范围
→ 审核未通过/审核中 → 数据不进入总览
4.2 数据准入详细规则
| # | 规则 | 说明 | 异常处理 |
|---|
| 1 | 审核状态校验 | 系统每次加载/刷新数据时，必须校验每条薪酬记录的审核状态，仅展示"已审核"状态的数据 | 审核状态为空或异常值的记录不展示 |
| 2 | 实时同步 | 薪酬审核通过后，数据在≤5分钟内同步至薪酬数据总览 | 同步失败时记录日志并重试 |
| 3 | 审核撤回 | 已审核的薪酬若被撤回审核（状态变更为非"已审核"），对应数据从总览中移除 | 撤回后用户刷新页面即不可见 |
| 4 | 数据完整性 | 审核通过的薪酬数据必须完成与订单、账号的关联匹配后才在总览中展示 | 关联失败的记录暂不展示，记录异常日志 |
| 5 | 批量审核 | 支持批量审核通过场景，批量通过后对应数据批量进入总览 | — |
4.3 数据安全
| 维度 | 要求 |
|---|
| 访问权限 | 薪酬数据总览需登录后访问，不同角色可见的数据范围由权限控制 |
| 导出权限 | 导出功能需额外权限控制，确保敏感数据（如金额、账号ID）不被未授权人员导出 |
| 操作日志 | 所有查看、筛选、导出操作记录操作日志 |
| 数据脱敏 | 如未来涉及身份证号等敏感字段，需进行脱敏显示（如：3201****1234） |
五、交互与UI设计要求
5.1 整体风格
- 浅色主题：白色背景 + 柔和灰色边框 + 蓝色主题色
- 布局：左侧固定导航栏（深色） + 右侧主内容区（浅色）
- 字体：PingFang SC / Microsoft YaHei，正文13px，表头12px
- 间距：采用8px的倍数作为间距基准
5.2 色彩规范
| 用途 | 色值 | 说明 |
|---|
| 主题色 | #4f6ef7 | 按钮、链接、高亮 |
| 成功/已验收 | #10b981 | 导出成功、已验收标签 |
| 警告/验收中 | #f59e0b | 验收中标签、警告提示 |
| 危险/未验收 | #ef4444 | 未验收标签、错误提示 |
| 紫色 | #8b5cf6 | 配送标签 |
| 文本色 | #1a1a2e | 主文本 |
| 次要文本 | #555 | 次要文本 |
| 边框色 | #e5e7eb | 表格边框、分割线 |
| 背景色 | #f5f6fa | 页面背景 |
5.3 交互规范
| 交互场景 | 规范 |
|---|
| 按钮hover | 微妙的背景色变化，0.15s过渡 |
| 输入框focus | 边框变为主题色 + 外发光阴影 |
| Tag添加 | 0.15s的缩放+淡入动画 |
| 表格行hover | 行背景色变为浅蓝色 #f0f4ff |
| 操作反馈 | Toast消息提示（右上角滑入，3秒自动消失） |
| 空状态 | 居中显示空状态图标 + 文案提示 |
5.4 响应式适配
| 分辨率 | 适配策略 |
|---|
| ≥1920×1080 | 标准布局，导航栏220px |
| 1366×768 ~ 1920×1080 | 适当收窄间距 |
| <1366 | 左侧导航可收起为图标模式 |