# 酱腌菜电商运营数据看板（局域网版）操作手册

## 一、团队如何访问

| 访问方式 | 地址 |
|---|---|
| 本机（运营电脑） | http://127.0.0.1:8000/dashboard.html |
| 局域网（团队其他电脑） | http://192.168.1.131:8000/dashboard.html |

> 局域网地址中的 IP 以实际为准：在本机命令行执行 `ipconfig` 查看 IPv4 地址；团队电脑需与运营电脑在同一局域网。
> 推荐把看板网址加入浏览器收藏夹。

## 二、服务如何启动 / 重启

- 正常情况服务已后台运行，无需操作。
- 电脑重启后：双击本文件夹中的 **`启动看板服务.bat`** 即可一键启动（已运行时会自动检测，不会重复启动）。

## 三、数据如何更新

- **每日 09:00 自动分析并刷新**（定时任务，P0+P1 全量采集）：
  1. 后台「机会商品」页**热门主题三大池**（全网热销 / 潜力商品 / 热门收藏，滚动加载至 1000 条 / 实际条数）→ `_scrape/hot_sale.json / potential.json / favorite.json`
  2. **表格视图**（activeTabKey=3，198件，含销量/曝光/点击/关联热搜词）翻页全量采集 → `_scrape/table.json`（P1 竞品销售信号）
  3. **买家评价词**（P1，尽力而为）：前台商品详情页好评标签，代表商品即可；若前台出现「系统繁忙」风控则自动跳过并沿用上次数据
  4. 运行 `python build_data.py`（v4：过滤+规格/竞争度/销量信号/评价词统计+推荐加权）→ `gen_fallback.py` → 看板自动生效
  - 定时任务依赖拼多多商家后台登录态；若登录过期，任务会提示重新登录后再继续。
- **手动刷新**：在命令行执行 `python build_data.py`（会重新统计并生成数据文件），刷新浏览器页面即可。

## 四、文件夹说明

| 文件 / 目录 | 作用 |
|---|---|
| `dashboard.html` | 看板主页面（打开即用） |
| `data/` | 看板数据文件（hot_words / opportunity_goods / rank_lists / store_stats），每日自动更新 |
| `_scrape/` | 采集原始数据：热门主题三大池（hot_sale/potential/favorite）+ 表格视图销量（table.json）+ 买家评价词（reviews.json） |
| `assets/` | 本地 ECharts 图表库（内网无需外网即可渲染） |
| `build_data.py` | 数据构建脚本 v4（合并去重 + 类目/价格带 + 包装规格/净含量/商用家用 + 关键词竞争度 + 销量/曝光/点击 + 评价词 + 推荐加权 + 生成JSON） |
| `gen_fallback.py` | 生成离线兜底数据脚本 |
| `启动看板服务.bat` | 一键启动局域网服务 |
| `_shots/` | 自检截图目录（内部使用，请勿删除） |

## 五、数据口径与来源

1. **机会商品 / 热搜词**：拼多多商家后台「机会商品」页（mms.pinduoduo.com/goods/goods_list/chance）**热门主题三大池**（全网热销 / 潜力商品 / 热门收藏）采集；
   滚动加载至 1000 条 / 实际条数，共采集原始记录 2840 条，按酱腌菜/调味品相关类目过滤（并排除面食/速食/干货香料误入）后合并去重 329 个机会商品；
   词频 = 关键词2字片段命中的相关类目商品标题数；热搜词菜单规模（共搜到N）为历史官方口径，既作热度参考也作**竞争池规模**（≤1000 蓝海、≥1500 红海）；
   热度分为本看板自建评分（10+词频×3+菜单规模/50(封顶44)+榜单命中×6+类目相关度10，封顶100），仅用于相对排序。
2. **竞品销售信号（P1）**：机会商品页**表格视图**（activeTabKey=3）全量198件采集，排名统计近7天（2026-09-23～09-29），列含销量/商品曝光人数/商品点击人数/关联热搜词；销量/曝光/点击为区间文本（500+ / 5000～10000 / 10万+），换算中值用于比较量级；按相关类目过滤后样本 63 件，平均曝光→点击转化率约 40%。
3. **买家评价词（P1）**：拼多多前台商品详情页真实好评标签（蜀中香榨菜丝 4,122 条评价、仲景香菇酱 4,087 条评价等，2026-09-30 采集）；前台限流时自动跳过并沿用上次数据。
4. **官方榜单**：拼多多官方排行榜 m.pinduoduo.com（用户实时数据，每日更新）——速食菜/料理包/快手菜、调味酱 TOP10 热卖指数。
5. **行业趋势**：豆丁网《2026年中国酱菜腌菜行业…》等公开报告（抖音酱腌菜话题播放量42.8亿次、无添加/脆爽/下饭神器年搜索增长超90%、潮汕橄榄菜搜索浏览量涨幅327%等）。

> 数据仅供本店运营内部参考，禁止对外分发。