# 宝锐工作台 · 核心心法

> 竹间架构 L1。这份东西不是文档，是我干了这些年踩出来的规矩。新人来了先把这个读三遍，再碰代码。

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

小伙子，咱们这个工作台看起来就是几个 HTML 页面，但里面每一条数据背后都有讲究。我一条一条跟你说。

**第一条，也是最大的一条：金额只认 ERP。** 你别管 MCP 上显示多少钱，那玩意儿不可靠，只能拿来看活动、客诉、客户这些维度的东西。谁要是从 MCP 拉金额、或者按比例分摊凑数，出了错自己背。这是红线。

**第二条，页面必须零依赖。** 所有 HTML 都得自包含，不指望任何外部 CDN。Chart.js 我们早就本地化了。为什么？飞书 WebView 里网络环境复杂，你今天靠 CDN 明天就白屏给你看。

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

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

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

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

**第七条，改完必须测。** 我见过太多"应该没问题"——这五个字后面跟着的全是事故。

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

## 二、KPI 的账，这么算

KPI 这块坑最多，你听我细说。

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

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

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

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

## 三、咱们的人和盘子

三个部门，年度目标你得背下来。

诊断原料大客户销售部，2650 万，赵云浩和张立娅两个人扛。

诊断原料销售拓展部，3400 万，人最多：刘欣是经理，底下陈溪子、冯贤平、黄文才、李江辉、林潇、刘虹晶、路要峰、宋学伟、徐卓凡、杨天雄、张文蝶，十一个人。

生命科学销售部，900 万，分两片。浙江片是吴云经理带着袁殿果、侯海瑜、叶信福；广东片是韩远怀经理、王诗香经理，加上黄建华、刘斌。

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

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

## 四、东西都在哪儿

本地起服务，在 `~/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 是超管的用户管理页，挂在 /admin 下。

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

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

```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/
```

规矩讲完了。记住，这份文件每次会话必读，别嫌烦——烦一次，比错一次便宜得多。