# PROJECT · 销售工作台 v2.0 项目宪章

> 竹间架构 L2。这份宪章回答四个问题：我们为什么做、做到什么程度、不做什么、东西放哪儿。

## 为什么做这个项目

宝锐生物营销中心下面有两条业务线——诊断原料和生命科学。销售团队三十来号人，每天要看 KPI、跟客户、追订单、录数据、攒测试反馈，这些活儿过去散落在各个 Excel 和聊天记录里。

这个项目就是要给营销中心造一个一体化的销售作战室：KPI 看板、客户管理、订单追踪、数据管理、测试反馈，五大模块收进一个壳。而且必须两条腿走路——飞书内嵌一套，CloudBase 外网一套，哪个场景都不能瘸。

## v1.0 到 v2.0，我们要跨过什么

先说架构。v1.0 是单文件 index.html 加一堆散落的 JSON，改一次抖三抖。v2.0 要做三层分拆——原则层、项目层、任务层各司其职，再加上模块化组件。

再看板。v1.0 三张卡片摆在那儿，年度、本月、半年度，冗余得让人不知道看哪张。v2.0 改成当月、当季、当年三层递进，一眼看清现在、这季、全年。

数据这条线变化最大。v1.0 的 JSON 全靠手动维护，人一走就断更。v2.0 要跑通自动管线：ERP 上传，自动处理，自动部署。

角色体系在 v1.0 已有 admin、gm、manager、sales 四级，v2.0 在此之上再加一条：区域经理自动锁定，不用手点。

部署从手动 tcb deploy 升级为 cron 自动部署，到点自己跑。

测试反馈在 v1.0 根本没有系统记录，v2.0 要有科研测试反馈页，正面案例和负面追踪都留痕。

最后是知识管理。过去方法论散落在 skills 和 memory 里，v2.0 改为三层架构文件驱动，知识跟着文件走，不跟着人走。

## 边界：说清楚不做什么

业务上，我们覆盖诊断原料（核酸诊断）和生命科学两条线。平台上，覆盖飞书 WebView 和 CloudBase 外网两个通道。用户是三十名销售人员加管理层。

财务、生产、供应链的系统对接，不在本项目范围内。这不是不想做，是先把销售这个战场打穿再说。

## 技术选型：克制是一种美德

我们刻意选了最朴素的技术栈：零依赖 HTML，CSS 和 JS 全部内联；图表用 Chart.js，但本地化，不碰 CDN；数据是 JSON 驱动，页面 fetch 渲染；托管用 CloudBase 静态托管；本地服务要出外网，走 Tailscale Funnel。

每一项选择背后的理由都一样：少一个外部依赖，少一个明天挂掉的理由。

## 文件结构

```
~/Desktop/Hermes输出-工作类/
├── 宝锐工作台.md          ← L1 原则+映射+Knowledge索引
├── PROJECT.md             ← L2 本项目（本文件）
├── TASK.md                ← L3 当前任务队列
├── RULES.md               ← 共同规范（R-xxx）
├── SKILLS.md              ← 完成方法（S-xxx）
├── 工具/                   ← HTML页面
│   ├── index.html          ← CloudBase工作台
│   ├── app.html            ← 飞书内嵌版
│   ├── landing.html        ← 分流首页
│   ├── 科研测试反馈.html    ← 测试案例库
│   └── admin.html          ← 超管页面
├── 数据/                   ← JSON数据文件
├── 脚本/                   ← Python管线脚本
├── 会话存档/               ← 历史会话
└── .hermes/状态.md         ← 旧状态文件（逐步迁移）
```

## 资源路由：要什么，去哪儿拿

找 KPI 目标和实际，看 `数据/kpi_dashboard.json`。找客户列表和订单，看 `数据/workbench_data.json`。找月度趋势，看 `数据/three_year_monthly.json`。查组织架构，从 workbench_data.json 的 personnel 字段走。测试反馈在 `数据/test_feedback.json`，顺丰物流状态在 `数据/shipment_status.json`。

部署脚本是 `~/.hermes/scripts/cb_sync_data.sh`。本地服务在 :8765 的 HTTP server 上。

这份宪章定了方向就不轻易改。要改，开个项目会，说清理由，改完同步所有人。