# 宝锐工作台数据来源标注规范

## 页眉来源徽章（强制性标准）

每个标签页顶部必须有来源徽章，三色体系：

| 徽章 | 含义 | CSS类 | 适用场景 |
|------|------|--------|---------|
| 🟢 实时 | 每次切换标签页从MCP实时拉取 | `src-live` | MCP API端点 |
| 🟡 批量 | 定时刷新（cron），非实时 | `src-batch` | MCP管道JSON缓存 |
| 🔴 ERP | 来自ERP系统，手动导入 | `src-erp` | ERP导出JSON |

## HTML实现

```html
<div class="info-bar">
  <span class="src-badge src-live">实时</span> 
  来源: 飞书项目MCP · <span id="xxxTime">更新 14:35</span>
</div>
```

CSS:
```css
.src-badge{font-size:9px;padding:2px 8px;border-radius:10px;font-weight:600}
.src-live{background:#e6f4ea;color:#0d904f}
.src-batch{background:#fef7e0;color:#e37400}
.src-erp{background:#fce8e6;color:#d93025}
```

## 标注要素

每个标签页的 info-bar 必须包含：
1. 颜色徽章
2. 来源系统名称（飞书项目MCP / ERP）
3. 更新频率或时间戳
4. 数据范围说明（如"最近100条""今日订单""H1已审计"）

## 工作台各标签页来源（2026-07-09）

| 标签 | 来源 | 频率 | 徽章 |
|------|------|------|:--:|
| 📋 每日活动 | 飞书项目 MCP API | 每次切换实时 | 🟢 实时 |
| 🧪 测试单 | ERP 批量导出 JSON | 手动更新 | 🔴 ERP |
| 📦 销售单 | 飞书项目 MCP API | 今日实时 | 🟢 实时 |
| 📊 KPI | ERP 财务数据（已审计） | 手动更新 | 🔴 ERP |
| 💬 客诉跟进 | 飞书项目 MCP API | 每次切换实时 | 🟢 实时 |
| 🚦 审批阻塞 | 飞书项目 JSON 缓存 | 每日 8:00/18:00 | 🟡 批量 |
| 🏢 KA对比 | ERP 订单导出 | 按需更新 | 🔴 ERP |

## 铁律

- 数据来源必须真实标注，禁止混用
- "来源: 飞书项目MCP" 必须区分 实时API vs 批量管道
- ERP数据必须标注"ERP"来源，不能伪装成实时
- 页面加载中显示 "⏳ 加载中…" 徽章，失败显示 "⚠ 离线"
- 所有KPI数字绝对不准估算，无法确认时留空或标"待确认"