后谷咖啡数据看板系统

📋 系统概述

后谷咖啡数据看板是一套面向抖音电商运营的数据管理系统，覆盖从数据录入到分析汇报的完整 workflow。

系统架构

🔐 登录与权限

登录流程

1. 打开系统地址，进入登录页面
2. 输入用户名和密码
3. 点击登录，系统自动校验身份
4. 登录成功后跳转至主数据看板

用户权限分级

系统采用三级权限体系，不同角色可查看和管理的数据范围不同：

页面入口导航

登录后，页面顶部导航栏提供以下快捷入口（根据权限动态显示）：

• 数据录入 — 进入 entry.html 进行各类数据录入
• 数据同步 — 进入 sync.html 执行内外网数据同步
• 数据看板 — 进入 report.html 查看独立汇报页面
• 主播排班 — 进入 public_schedule.html 查看公开排班表

📝 数据录入

数据录入模块按数据类型提供对应录入方式。直播、主播、流量等模块可继续使用截图 OCR；店铺数据必须由浏览器扩展读取抖店页面结构化字段后推送，先进入待确认区，确认后才进入正式看板。

直播数据录入

直播数据录入支持从抖音罗盘后台截图，通过 OCR 自动识别关键指标，大幅减少手动录入工作量。

店铺数据录入

店铺数据不再使用图片识别、文字粘贴或文字解析。请在抖店罗盘页面打开已安装的浏览器扩展，读取页面上的结构化字段和实际业务日期后推送。

1. 打开抖店罗盘店铺数据页面，确认页面时间范围和店铺名称正确。
2. 打开浏览器扩展，提取并检查业务日期、交易、退款、结算、投放、流量、载体、自营/合作和复购指标。
3. 点击上传，数据只会进入“店铺数据待确认”区，不会直接参与正式看板统计。
4. 在待确认区打开记录，人工编辑字段并查看新旧差异。
5. 确认无误后点击“确认并覆盖提交”；同店铺同业务日期的正式数据默认被覆盖，并记录审计信息。
6. 如果数据不正确，点击驳回；被驳回的数据不会进入正式看板。

操作步骤

1. 在 entry.html 页面选择 "直播数据" Tab
2. 选择要录入的 直播间名称 和 直播时间
3. 从抖音罗盘后台截取数据截图（包含 GMV、GSV、观看人数、成交人数等）
4. 在页面粘贴区域按 Ctrl+V 粘贴截图，或拖拽/点击上传
5. 系统自动识别截图中的数据并填充到对应字段
6. 核对识别结果，手动修正有误的字段
7. 点击 "提交" 按钮保存数据

操作步骤

1. 在 entry.html 页面选择 "主播数据" Tab
2. 选择主播姓名、日期、所属直播间
3. 填写各项直播指标（GMV、观看人数、成交人数等）
4. 点击 "提交" 保存单条数据
5. 或使用批量粘贴功能一次性录入多条记录

排期数据录入

排期数据用于管理主播和排班人员的上班安排，支持日历视图展示。

操作步骤

1. 在 entry.html 页面选择 "排期数据" Tab
2. 选择日期和班次（早班/晚班）
3. 选择主播姓名和所属直播间
4. 添加排班人员（主播、中控等）
5. 点击 "保存排期"

流量数据录入

流量数据用于记录各直播间的流量来源分布，支持截图识别流量 Dashboard 数据。

操作步骤

1. 在 entry.html 页面，选择直播间和直播时间
2. 在"流量数据"区域粘贴流量 Dashboard 截图
3. 系统自动识别渠道名称、流量占比、用户支付金额、用户支付金额占比、渠道千次观看成交
4. 核对识别结果后，数据将与直播数据一并提交

支持识别的流量字段

字段名	说明
渠道名称	如：推荐页、关注、搜索、个人主页等
流量占比	该渠道带来的流量占总流量的百分比
用户支付金额	该渠道带来的成交金额
用户支付金额占比	该渠道成交金额占总成交的百分比
渠道千次观看成交	该渠道的千次观看成交金额

每日复盘日报

每日复盘日报用于记录每场直播后的复盘总结，包括关键动作、核心问题与需求、预估差距分析等内容。

操作步骤

1. 在 entry.html 页面，确保已选择直播间和直播时间
2. 滚动到页面下方的 "每日复盘日报" 区域
3. 填写以下固定区域内容：
   • 关键动作：本场直播采取的核心策略和动作
   • 核心问题与需求：发现的问题和需要支持的需求
   • 预估差距分析：目标达成情况的差距分析
4. 点击 "保存复盘"，数据将与直播数据一并提交

鹰眼日汇总（开发中）

数据录入的识别结果区将展示日汇总和场次明细；仅在人工确认后才会入账。该功能与 AI 分析无关，历史数据会先完成审核与清理，不会自动删除或合并历史记录。

鹰眼镜像到直播数据汇总（测试环境）

鹰眼日汇总识别结果仅在“直播数据”上传区域显示，位置在“基本信息”模块与“数据复制 / 图片识别”模块之间；切换到店铺数据、目标上传或主播上传时不显示该卡片，避免不同上传模块之间串数据。确认鹰眼日汇总后，系统会以 livewatch:<直播日ID> 作为唯一记录写入直播明细；同一直播日再次确认时覆盖原镜像行，不会重复累计。

• 成交件数：取鹰眼 orders（鹰眼字段标签即「成交件数」），同步写入前端展示列与内部别名列。
• 曝光次数、曝光-观看率：来自各场次抖音屏经营明细；曝光-观看率按累计观看人数 ÷ 曝光次数计算。
• 平均在线人数：取鹰眼导出的 online_avg。该值按同一直播日的全部 metric_samples.online_now 有效采样（仅大于 0）聚合均值，覆盖跨场次数据；不是页面上最后一次的实时在线快照。
• 商品点击字段：唯一真源是鹰眼 live_hourly_readings.metrics_json。商品点击次数固定取 funnel_product_clicks；商品点击率优先取 click_rate，该字段缺失时按 funnel_product_clicks ÷ funnel_viewers × 100 计算。不得读取顶层 product_clicks（历史可能为空或属于其他口径），也不得以抖音侧 product_click_users 或累计观看人数替代漏斗口径。缺失时保留为空，不以 0 填充。

直播间名称匹配：拉取时会自动忽略英文大小写和名称中的空格。例如页面显示的 后谷咖啡HOGOOD COFFEE官方 可正确匹配鹰眼标准 key 后谷咖啡hogoodcoffee官方；其他文字仍需完全一致，避免拉到不同直播间的数据。

已入账日汇总：完整归一化指标

已确认入账后，页面会直接显示核心指标摘要以及全部已入账归一化指标；所有指标均使用中文业务名称展示，不需要再展开操作。

该区域只展示已入账口径的指标和值，不显示鹰眼原始导出快照、逐场明细、字段状态或审核快照；查看不会修改已入账数据，也不会重新计算或再次入账。只有点击“确认入账”后才会生成已入账记录；仅拉取候选不会自动入账。

编辑模式：点击“编辑数据”后，会展示当前日汇总的全部归一化指标；ROI 由系统按净成交金额和投放消耗自动计算、只读显示，其余已采集数值均可编辑。如无需修改，可点击同区域的“关闭编辑”返回只读状态；关闭不会提交任何修改。若当前日期和直播间已有已入账日汇总，编辑区会自动带入该记录的当前入账值；仅提交实际改动的字段，确认后生成新版本，旧版本保留审计。

上传日志与方式：每次确认鹰眼日汇总都会同步形成一条“直播数据”上传日志，分别标记为“鹰眼日汇总（原样确认）”或“鹰眼日汇总（编辑确认）”，并保留来源直播日、场次和全部归一化指标快照。OCR/手工上传仍按原有方式记录；鹰眼日志请回到鹰眼日汇总区域编辑，避免与 OCR/手工编辑流程混用。

历史记录查看

页面下方提供直播数据、店铺数据、流量数据、每日复盘的上传记录列表，支持：

• 查看历史录入记录
• 编辑已提交的数据
• 删除错误的记录

📊 数据看板

数据看板是系统的核心展示模块，包含直播数据汇总、店铺数据汇总、直播间详情三大板块。数据看板的数据仅来自本地数据库中的 shop_data / live_data 表。

直播数据汇总

展示所有直播间的综合数据，支持按时间范围筛选、按店铺筛选、按直播间筛选。

功能特性

关键指标说明

指标	说明	计算方式
GMV	成交总金额	直接取值
GSV	成交净额	GMV - 退款金额
客单价	平均每单金额	GMV / 成交人数
ROI	投入产出比	GSV / 消耗
观看成交率	观看转成交比例	成交人数 / 观看人数 × 100%
退款率	退款金额占比	退款金额 / GMV × 100%

店铺数据汇总

店铺汇总与首页使用同一套数据看板，通过 Tab 切换查看。页面默认展示昨日；昨日无数据时自动切换近 7 日，也支持近 30 日、自定义日期和店铺筛选。

功能特性

• 结构化指标：展示交易、退款、结算、投放、流量、载体、人群及自营/合作数据
• 每日明细：逐条展示正式店铺原始记录，合计/均值行只读
• 字段选择：可按需要选择明细表中展示的字段，分栏颜色对应指标分类
• 逐条编辑：可直接修改明细行字段；检测到异常值时需要二次确认
• 逐条删除：可删除指定原始记录，操作前会二次确认
• 日期和店铺：支持昨日、近 7 日、近 30 日、自定义日期范围和店铺筛选

体验分指标

店铺体验分由三个维度组成：

• 商品分：商品质量相关评分
• 物流分：物流服务质量评分
• 服务分：商家服务评分

直播间详情

针对单个直播间的深度分析页面，展示该直播场的详细数据和趋势。

功能特性

1. 选择要查看的直播间名称
2. 系统自动加载该直播间的历史数据
3. 查看该直播场的详细指标
4. 查看近7天 GMV/ROI 趋势对比图
5. 查看流量分布详情（如已录入流量数据）

📑 运营汇报

运营汇报模块提供日报、周报、月报三种周期的数据分析汇报，支持 AI 智能分析和飞书文档导出。

汇报类型

操作步骤

1. 在 index.html 页面点击 "运营汇报" Tab
2. 选择汇报类型（日报/周报/月报）
3. 选择日期（日报选具体日期，周报选周起始日，月报选月份）
4. 点击 "生成汇报" 按钮
5. 系统加载数据并展示汇报内容

汇报内容组成

模块	内容说明
核心指标卡	GMV、GSV、ROI、客单价、综合费比、消耗 6大核心KPI
直播间明细	各直播间的详细数据对比表
流量分析	流量来源分布可视化
趋势图表	近7天 GMV/ROI 趋势对比图
达成分析	目标达成率、预估差距分析

AI 智能分析

系统支持调用 AI 模型对汇报数据进行智能分析，生成结构化的分析报告。

操作步骤

1. 生成运营汇报后，点击 "智能分析" 按钮
2. 系统构建分析 Prompt 并发送至对应 AI 模型
3. 等待 AI 分析完成（约10-30秒）
4. 查看 AI 生成的分析报告，包含：
   • 数据概览总结
   • 关键指标解读
   • 异常数据提醒
   • 优化建议

飞书文档导出

支持将运营汇报导出为飞书文档，方便分享给团队成员。

操作步骤

1. 生成汇报后，点击 "导出到飞书" 按钮
2. 系统开始异步导出（显示进度条）
3. 导出完成后，弹窗显示文档链接
4. 点击链接可直接在飞书中查看和编辑文档

🎯 目标管理

目标管理模块用于设定和追踪各直播间、店铺、商品卡的月度/年度目标，支持目标达成率自动计算。

目标类型

• 直播间目标：按直播间维度设定 GMV、GSV、成交人数等目标
• 店铺目标：按店铺维度设定 GMV、体验分等目标
• 商品卡目标：按商品卡维度设定成交目标

目标设定步骤

1. 点击 "目标管理" Tab 进入目标管理页面
2. 选择目标周期（月度/年度）
3. 选择目标对象（直播间/店铺/商品卡）
4. 选择具体的目标对象名称
5. 填写各项目标数值
6. 点击 "保存目标"

目标达成追踪

目标导入

支持通过 Excel 模板批量导入目标数据：

1. 点击 "下载模板" 获取目标导入模板
2. 按模板格式填写目标数据
3. 点击 "导入目标" 上传 Excel 文件
4. 系统自动解析并导入目标

📅 排期表

排期表模块用于管理主播和排班人员的工作安排，支持日历视图和个人排班查询。

功能特性

排班颜色规则

系统支持14种直播间颜色规则，在排期表中以不同颜色区分不同直播间：

个人排班查询

主播和排班人员可通过 schedule.html 页面查询个人排班：

1. 访问 /static/schedule.html
2. 登录系统
3. 选择查询日期范围
4. 查看个人排班列表

📋 考核维度

考核维度模块用于按周、月、个人、主播等多个维度进行业绩考核分析。

考核类型

考核类型	说明
周考核	按周统计各直播间/店铺的业绩达成情况
月考核	按月统计各直播间/店铺的业绩达成情况
个人考核	按负责人统计其管辖范围的业绩
主播考核	按主播统计其直播业绩
商品卡考核	按商品卡统计成交情况

负责人配置

支持为每个直播间、店铺、商品卡配置负责人：

1. 在考核维度页面点击 "负责人配置"
2. 选择配置类型（直播间/店铺/商品卡）
3. 为每个对象选择负责人（下拉选择品牌自营用户）
4. 点击 "保存配置"

考核指标

• GMV：成交总金额
• GSV：成交净额
• ROI：投入产出比
• 客单价：平均成交金额
• 综合费比：费用占比
• 消耗：投放消耗金额
• 达成率：实际业绩 / 目标业绩 × 100%

👥 用户管理

用户管理模块仅供管理员使用，用于管理系统用户、配置用户权限。

用户管理功能

权限配置

DP合作用户需要配置以下权限：

• 店铺权限：选择该用户可查看的店铺
• 直播间权限：选择该用户可查看的直播间

🔄 数据同步

数据同步模块用于在内网服务器和外网服务器之间双向同步数据，确保两套环境数据一致。

同步架构

同步规则

同步步骤

1. 访问 /static/sync.html 页面
2. 选择同步方向（内网→外网 / 外网→内网）
3. 选择要同步的数据表
4. 点击 "开始同步"
5. 等待同步完成，查看同步结果

自动同步

系统支持自动双向同步机制：

• 数据写入时自动记录到同步队列
• 后台 SyncWorker 自动推送变更到外网
• 后台 SyncPoller 定期从外网拉取变更
• 通过 source_tag 标记避免循环同步

📤 飞书导出

系统支持将运营汇报、数据看板等内容导出为飞书文档，方便团队协作。

导出内容

• 运营日报/周报/月报
• 数据分析图表（以图片形式嵌入）
• 数据表格（以飞书表格或 Markdown 表格形式）
• AI 智能分析报告

导出步骤

1. 在 report.html 页面生成运营汇报
2. 点击 "导出到飞书" 按钮
3. 等待异步导出完成（显示进度条：创建文档→写入内容→设置权限）
4. 导出完成后，弹窗显示文档链接和文档信息
5. 点击链接可在飞书中查看和编辑

文档管理

❓ 常见问题

数据录入相关

权限相关

系统相关

飞书导出相关

数据同步相关