# 宝锐销售工作台 · 核心心法

> 竹间架构 L1。这份文件每次会话必读，不是文档，是规矩。新人来了先读三遍，再碰代码。

## 一、八条规矩，先记死

**P1 · 金额只认 ERP。** MCP 上显示多少钱不可靠，只能看活动、客诉、客户。谁从 MCP 拉金额或按比例分摊凑数，出了错自己背。这是红线。

**P2 · 页面必须零依赖。** 所有 HTML 自包含，不指望外部 CDN。Chart.js 早就本地化了。飞书 WebView 里网络环境复杂，今天靠 CDN 明天就白屏。

**P3 · 数据有权威等级。** ERP 最大，其次是月度报告 Excel，再往下是 MCP，最下策是推算。冲突的时候，等级高的说了算。

**P4 · 谁能看什么，门儿清。** admin 全看，gm 全看，manager 看自己部门，sales 只看自己。这不是技术问题，是纪律问题。

**P5 · 修东西按 CAPA 来。** 先观察现象，再分析根因，然后纠正加预防一起上。头痛医头的活不干。

**P6 · 系统出问题先体检。** 不全量排查完，一行修复代码都不许写。逐个猜是最贵的修 Bug 方式。

**P7 · 改完必须测。** "应该没问题"这五个字后面跟的全是事故。

**P8 · 渐进迭代。** 先把最小可用的跑通，再往上加功能。一口吃不成胖子，但一口一口吃，胖子总能吃出来。

## 二、KPI 的账，这么算

测试单怎么提？`df[单据类型.str.contains('测试')]`，然后按单据编号 nunique 去重——一张测试单可能拆好几行，不去重就把数算大了。

2025 年 ERP 里大客户部的销售员写的是代号：大客户1=黄明月，大客户2=赵云浩。王昕伟的单子归赵云浩。这几个映射漏一个，人的业绩就错了。

诊断原料的产品大类只有一个：核酸诊断。别到处找别的分类。

宝锐系内部采购必须剔干净——宝锐生物、横琴宝锐、宝泰仪，三家自己人买自己人的，算进去就是虚增。

## 三、咱们的人和盘子

三个部门，年度目标背下来：

- **诊断原料大客户销售部**：2,650万，赵云浩和张立娅两个人扛。
- **诊断原料销售拓展部**：3,400万，人最多。刘欣是经理，底下陈溪子、冯贤平、黄文才、李江辉、林潇、刘虹晶、路要峰、宋学伟、徐卓凡、杨天雄、张文蝶，十一个人。
- **生命科学销售部**：900万，分两片。浙江片吴云经理带袁殿果、侯海瑜、叶信福；广东片韩远怀经理、王诗香经理，加上黄建华、刘斌。

技术支持固定对口：浙江科研区域找王凡，广州科研区域找蒋嵘。别找错人。

客户侧，集团归集靠 CL 数组（500条），按集团名聚合。散户归到集团，账才看得清。

## 四、东西都在哪儿

本地起服务，在 `~/Desktop/Hermes输出-工作类` 下跑 `python3 -m http.server 8765`。

线上在 CloudBase，环境名 `bier-sales-d0gatbvlx288724e9`，源路径 `工具/` 部署到 `/workbench/`。

本机外网出口走 Tailscale，地址 `macbook-air-2.tail6864e8.ts.net`。

Venus 服务用这条命令起：`python3 ~/.hermes/hermes-agent/venv/bin/python3 脚本/销售工作台服务.py 8765`。

## 五、数据的家底

核心数据都在 `数据/` 目录：

- **kpi_dashboard.json** — 部门和个人 KPI 的家底，目标、实际、达成率都在里面。ERP 上传后刷新。
- **kpi_progress.json** — 管当月进度，MCP 每日更新。
- **workbench_data.json** — 客户加订单的合并体，每天 merge 一次。
- **three_year_monthly.json** — 2024 到 2026 的逐月销售额，ERP 上传后更新。
- **test_feedback.json** — 科研测试反馈的正负案例，手动维护。
- **tech_mapping.json** — 区域对技术支持的映射，静态的。
- **shipment_status.json** — 顺丰物流状态，watchdog 在盯着。

页面都在 `工具/` 目录：index.html 是工作台主页面（看板、客户、订单、数据管理），走 CloudBase；app.html 是飞书内嵌版，da 和 ls 两条业务线分流；landing.html 把人导到 app.html；科研测试反馈.html 是独立案例库；宝锐统一工作平台.html 是统一入口；admin.html 是超管的用户管理页。

每次重大改造的会话记录都存到 `会话存档/`，以后复盘、追溯全靠它。

## 六、几条常用命令，贴墙上

```bash
# KPI 刷新
cronjob run b5c6c96b1eee

# CloudBase 全量部署
bash ~/.hermes/scripts/cb_sync_data.sh
tcb hosting deploy 工具/index.html /workbench/index.html -e bier-sales-d0gatbvlx288724e9

# HTTP 服务器健康检查
curl -s -o /dev/null -w "%{http_code}" http://127.0.0.1:8765/
```

---

规矩讲完了。烦一次，比错一次便宜得多。