# 今日经验沉淀

## 数据源铁律
- `shipment_status.json` = 仅有快递单号的物流订单（近90天），不是全部销售订单！
- 销售额/订单数用 `kpi_dashboard.json` / `diag_kpis.json`（ERP全量）
- 客诉隔离：area + operator 双重过滤
- 三年逐月：非管理员按年度比例分摊

## CloudBase 部署
- 入口：`工具/index.html` → `/workbench/index.html`
- ❌ 已废弃：`工具/销售工作台.html`
- SDK: `static.cloudbase.net/.../latest/`（不能用 imgcache.qq.com）

## 飞书免登
- `feishuAutoLogin(code)` → 服务端 `/api/feishu/auth`（密钥不暴露前端）
- 依赖 Tailscale Funnel: `tailscale funnel --bg http://127.0.0.1:8765`

## 决策链
- MCP 查飞书客户「决策链URL链接」字段 → `customer_360.json` → iframe嵌入
- URL 格式：`https://i16l6v9noru.feishu.cn/wiki/{token}` 或 `/docx/{token}`

## 易错点
- `USER_AREA_MAP` key必须用登录后的dept全称（如 `诊断原料大客户销售部`）
- CloudBase `password` 字段会自动屏蔽，必须用 `pwd`
- KPI 累计达成非admin必须用 `getKPI().ytd+current`，不能用公司汇总