跳转至

LZ-组6 系统操作与答辩演示手册（v1）

适用对象：项目成员、评审人员和后续维护者。
本手册不记录数据库密码、服务器口令、token、cookie 或私钥。

1. 系统组成

组成 作用 正式位置或入口
Plus 12 流水线 处理完整数据、清洗、扩展 27 字段、生成 25 主题 E:\实训\数据分析Plus\12_自适应Windows数据流水线
Plus 13 企业后台 发布 plus-release_006，连接数据库和展示工具 E:\实训\数据分析Plus\13_Plus企业后台
Streamlit Plus 五标签页线上分析应用 https://lz-group-6.selfpage.cn/plus/
Metabase 六个答辩仪表板和交互查询 使用项目登记的只读入口，不在文档记录凭据
Windows 数据流水线工具版 面向兼容 CSV 的本地双语桌面分析工具 E:\实训\数据分析Github\windows-data-pipeline
v4.1 较早稳定展示版本 服务器 /app/，作为版本演进和备用展示

2. 答辩优先使用哪一个入口

2.1 主展示：Metabase

用于展示：

  1. Plus 答辩总览；
  2. Plus 流量与转化；
  3. Plus 类目与商品；
  4. Plus 用户与机会；
  5. Plus 模拟经营结构；
  6. Plus 数据与方法。

Metabase 适合现场筛选、切换页面和回答指标追问。

2.2 辅助展示：Streamlit Plus

用于展示完整项目已经形成线上应用，并快速说明：

  • 综合概览；
  • 流量与转化；
  • 类目商品与用户；
  • 订单与经营结构；
  • 数据与方法。

2.3 工程亮点：Windows 工具版

用于展示项目不仅完成一次分析，还将处理流程整理成可在 Windows 上运行、支持暂停恢复、资源调节和双语界面的工具。

3. 答辩前环境检查

3.1 线上检查

  • [ ] Streamlit Plus 公网入口可以打开；
  • [ ] 首页显示当前版本 plus-release_006；
  • [ ] 五个标签页均能加载；
  • [ ] Metabase 登录入口可用；
  • [ ] 六个仪表板和主要 Question 可打开；
  • [ ] 日期和其他筛选器能够正常应用；
  • [ ] 页面没有数据库错误、加载失败或敏感信息；
  • [ ] v4.1 备用入口仍可用。

3.2 本地备用材料

  • [ ] PPT 保存在答辩电脑和 U 盘；
  • [ ] 3 分钟演示视频保存本地副本；
  • [ ] 六个 Metabase 仪表板均有完整截图；
  • [ ] Streamlit 五个标签页均有截图；
  • [ ] Plus 12 正式运行、质量检查和最终结果有截图；
  • [ ] Windows 工具版有启动页、运行页和结果页截图；
  • [ ] 准备 PDF 版项目报告和个人报告；
  • [ ] 所有截图均已遮盖账号和敏感信息。

4. 现场演示顺序

4.1 推荐的 3—5 分钟系统演示

  1. 打开 Metabase“Plus 答辩总览”，说明数据规模和最终成果。
  2. 切换“流量与转化”，展示 12 月 2 日峰值、晚间表现和严格路径。
  3. 切换“类目与商品”，展示商品集中度和三类机会候选。
  4. 切换“用户与机会”，展示用户分层和观察期限制。
  5. 简短打开“模拟经营结构”，明确所有金额、订单、渠道、设备和地区均为模拟。
  6. 打开“数据与方法”，说明 plus-release_006、固定查询入口和低样本排除。
  7. 打开 Streamlit Plus，展示系统已经部署为独立线上应用。
  8. 使用截图或短录屏展示 Plus 12 和 Windows 工具版，不在现场启动一亿行任务。

4.2 四人讲解衔接

环节 主讲人 内容
项目总览与技术流程 黎钊恺 数据来源、Plus 12、Plus 13、部署和版本
流量与转化 吴锐锋 数据质量、日期时段、严格路径和指标口径
类目与商品 康奕 商品集中、图表设计、候选展示和样本限制
用户、推荐和运营 贾天宇 用户机会、商品机会、推荐和运营验证
总结与追问 黎钊恺统筹，全员回答 统一成果、边界和后续方向

5. Metabase 使用方法

5.1 数据源规则

  • 数据库：plus_backend；
  • Question 只查询 plus_current_* 固定查询入口；
  • 不直接绑定 plus_r006_* 物理版本表；
  • 不把 SQL 粘贴到 Dashboard，SQL 应保存在 Question 中；
  • 正式 49 个查询已经通过只读执行检查。

5.2 查看仪表板

  1. 进入项目 Metabase。
  2. 打开对应 Dashboard。
  3. 等待所有卡片加载完成。
  4. 应用日期、类目或页面提供的筛选器。
  5. 检查筛选器是否影响预期卡片。
  6. 演示后恢复默认筛选状态。

5.3 图表说明

  • 百分比字段已按 0—1 保存，设置百分比格式，不再乘 100；
  • buy_count 显示为“购买行为数”；
  • simulated_order_count 显示为“模拟订单数”；
  • 模拟经营图表标题必须带“模拟”；
  • 候选图表使用“待进一步检查”而不是“问题商品”；
  • 类目名称说明为人工映射；
  • 意向未购说明为“观察期结束后结果未知”。

6. Streamlit Plus 使用方法

6.1 在线访问

打开 https://lz-group-6.selfpage.cn/plus/，依次查看五个标签页。页面用于只读分析和答辩展示，不在页面中输入数据库或服务器凭据。

6.2 本地启动

在 E:\实训\数据分析Plus\13_Plus企业后台 中使用项目独立环境启动：

.venv\Scripts\python.exe -m streamlit run app.py

本地启动前应确认配置通过环境变量提供。不得把真实密码写进脚本或提交仓库。

6.3 页面检查

  • 综合概览：版本和核心数字正确；
  • 流量与转化：日期、小时、时段和路径能够显示；
  • 类目商品与用户：类目、商品和用户结果正常；
  • 订单与经营结构：所有经营指标标记为模拟；
  • 数据与方法：数据版本、来源和限制说明完整。

7. Plus 12 正式流水线使用说明

7.1 适用场景

Plus 12 用于复现当前正式完整数据，不用于答辩现场临时运行。正式运行耗时长、占用空间大，应在满足资源要求和已备份结果的电脑上执行。

7.2 首次准备

  1. 确认 9 个原始分片位于流水线约定的数据目录。
  2. 关闭浏览器、Office、IDE 等非必要程序。
  3. 双击 启动本机校准.bat。
  4. 校准通过后双击 启动一亿行自适应运行.bat。
  5. 按程序要求输入正式确认文本，才会启动或恢复。

7.3 运行与恢复

  • 进度窗口显示总体进度、当前阶段、CPU、内存、并发和心跳；
  • 可用资源不足时流水线会降低并发或安全停止；
  • 再次使用正式入口可恢复同一个正式运行目录；
  • 不要手工删除或修改正在运行的 run_NNN；
  • 已完成文件只有通过路径、大小和 SHA-256 检查后才会复用。

7.4 关键输出

正式结果位于：

runs\full\official-v1\run_001\

重点查看：

  • outputs\enriched_clean_events：清洗后 27 字段分析数据；
  • outputs\themes：25 个分析主题；
  • 维表和字段映射；
  • validation：验证结果；
  • manifest.json：文件清单、版本和检查信息；
  • state：运行进度和恢复信息。

正式交付不应复制整个约 49GB 运行目录。应只复制批准的代码、必要文档、小型样本、验证摘要和外链登记。

8. Windows 数据流水线工具版使用说明

8.1 定位

Windows 工具版面向一个完整 CSV 或多个同结构 CSV 分片，提供：

  • 基础行为分析；
  • 27 字段增强分析；
  • 25 个分析主题；
  • 本机资源检查和自适应调节；
  • 安全暂停和继续运行；
  • 双语桌面控制台；
  • 完全本地处理，不自动上传数据。

8.2 启动

在正式冻结快照中双击：

启动数据分析工具.bat

首次启动按工具提示准备独立环境。不要复制其他电脑的 .venv。

8.3 答辩展示

答辩只展示已经准备好的小型示例或完成结果：

  1. 选择输入文件；
  2. 展示基础/增强分析选择；
  3. 展示资源检查；
  4. 展示实时总览、数据问题和分析结果；
  5. 展示暂停、恢复和输出目录；
  6. 说明完整数据成果由 Plus 12 正式 run_001 提供。

不要在答辩现场启动百万行或一亿行任务。

9. 常见问题处理

9.1 线上页面打不开

  1. 检查网络连接；
  2. 刷新一次并等待；
  3. 切换到本地截图或演示视频；
  4. 使用 v4.1 备用入口；
  5. 答辩结束后再检查服务器，不在现场修改配置。

9.2 Metabase 卡片报错

  1. 确认选择 Plus 企业后台 数据库；
  2. 检查是否使用 plus_current_*；
  3. 恢复默认筛选器；
  4. 使用已经验证的 SQL 文档重新核对；
  5. 不在公开画面展示错误详情或数据库连接信息。

9.3 数字与报告不一致

  1. 确认版本为 plus-release_006；
  2. 确认时间范围一致；
  3. 检查行为次数、用户人数和用户—商品对是否混用；
  4. 检查是否误用早期样本；
  5. 以正式分析报告和统一口径字典为准。

9.4 本地流水线中断

  • 保留整个运行目录；
  • 不删除检查点和已完成块；
  • 重新使用正式入口恢复；
  • 若提示资源不足，先释放内存和磁盘空间；
  • 仍无法恢复时保存状态、日志和错误文件再排查。

10. 安全与提交要求

  • 不在文档、截图、Question 或代码中保存密码；
  • 截图隐藏账号、IP、宝塔信息和连接字符串；
  • .env、本地数据库配置和服务器密钥不得提交；
  • .venv、缓存、运行日志和大型数据不得进入正式仓库；
  • 数据外链只登记用途、文件名、大小、检查值和访问方式；
  • 正式提交前检查所有 HTML、图片、PPT、视频和 Word 文件可以打开。

11. 演示结束后的确认

  • [ ] 恢复 Metabase 默认筛选状态；
  • [ ] 关闭包含敏感信息的管理页面；
  • [ ] 记录评委问题和未答完整内容；
  • [ ] 核对最终提交材料是否需要根据答辩修改；
  • [ ] 任何核心数字修改都同步到报告、PPT、视频说明和公共手册。