# baoyu-sales-copilot — frontend ui

### 页面布局（上下分区）

**上半部分 · 时间维度订单分析（本周/本月/本季/本年可切换）：**
- `seg-control` 分段按钮切换 `orderState.analysisPeriod`
- 六维统计卡片（发货数/💰发货金额/运输中/已签收/⚠️物流异常/暂无路由）
- 三栏分析：🏆客户Top5（按金额）+ 📋订单类型占比（彩色进度条）+ ⚠️物流异常明细
- 🏢按部门横向进度条（flex-wrap自适应）

**下半部分 · 近90天订单明细：**
- 筛选栏：日期 + 部门 + 👤下单人 + 状态 + 搜索
- 8列表格（单据编号/客户/合同编号/下单人/部门/物流单号/状态/日期）
- 展开物流时间线 + 灰底高亮金额行（数量/单价/含税单价/金额/价税合计）
- 飞书全量订单链接双入口

#### 22. h1Summary 状态字段使用中文键名（⚠️ 2026-07-25 已踩坑）
- ❌ `data.h1Summary.delivered` → undefined，H1已签收未合并
- ❌ h1_summary 的 status 对象键名是中文：`{"已签收": 934, "无物流": 2718, ...}`
- ✅ `(data.h1Summary.status || {})['已签收']` 正确读取
- 影响范围：订单管理Tab"本年"的已签收卡片（修正前142→修正后1076）


### 23. 客户Tab顶部仅保留2卡片
- 顶部只显示客户数 + 联系人，不展示订单金额/商机等
- 订单金额在下方表格的"2026累计采购"列体现
- 飞书链接列：`https://project.feishu.cn/xsguanli/workObjectView/65ae1e403c87b152f3365ca6/{fid}?scope=workspaces`


### 24. 页面标题移除 BIORI BIOTECH 文字
- 登录页/顶部banner/页面title 均用 `logo.png`（复制到HTML同级目录）
- title 改为 "宝锐生物 · 销售工作台"
- 图片 height：banner 28px，登录页 48px（H1归档 + H2实时 + 自动归档）

2026全量4128条/2303.9万价税。全量刷新需5分钟/8MB，分层后H2仅343条/30秒刷新。

```
H1（1-6月）→ h1_archive.json（3KB纯汇总，季度末更新）
H2（7月+）→ shipment_status.json（实时明细 + 顺丰轨迹，每日刷新）
已签收>7天 → 自动从H2归档到H1
```

- shipment_status.json 内嵌 `h1_summary` + `full_year_tax`，前端一次加载
- 看板概览卡片已切MCP：客户数1678（MCP客户表）/ 2026价税合计2303.9万 / 本月价税 / 联系人7723（MCP客户`联系人数量`字段汇总，非订单收货人）
- 详参见 `references/mcp-data-pipeline-patterns.md` · 数据分层架构

**合并策略**：按单据编号(orderId)合并多行物料，金额/价税合计/数量累加。无物流单号的订单保留用于金额统计，标注"无物流"。

```
MCP直连(去掉物流单号过滤, 全部订单) → 按单据编号合并(累加) → 顺丰API(仅查有物流单号) → shipment_status.json
```

- MCP每20页重建会话防过期；JSON解析用 `raw_decode` 非 regex
- 顺丰每30批刷新 accessToken
- 无物流订单：`shipment.status = "no_tracking"`, `statusLabel = "无物流"`


### 1. 作战准备Tab不能只做简化版
- ❌ 只做客户搜索+TOP5，忽略材料生成和归档
- ✅ 必须完整继承访前准备中心的5种材料+归档功能


### 23. 客户Tab顶部仅保留客户数+联系人2卡片
- 顶部不展示订单金额/商机等，金额在表格"2026累计采购"列体现
- 飞书链接：`https://project.feishu.cn/xsguanli/workObjectView/65ae1e403c87b152f3365ca6/{fid}?scope=workspaces`
- `work_item_id` 从MCP单独拉取（34页，value_type=long_value）


### 24. 页面标题和logo
- 登录页/顶部banner/页面title 均用 `logo.png`（复制到HTML同级目录）