# 11 — 自定义视图接入 crm-preference（复用商机 saved-view 平台能力）

Type: task
Status: open
Blocked by: 03

## 目标

客户模块的三 workspace（客户总览 / 我的客户 / 客户公海）复用 crm-preference 已建的 `user_saved_view` 平台能力，按接入手册三步走：约定 scope_key + 建 `CustomerSavedViewFilter` + PageParam 加 savedViewId。**平台能力不重写**，商机图票 14 已建。

## 已知事实

- **平台能力已就绪**（商机图票 14）：`user_saved_view` 实体 + `SavedViewService` list/save/delete/setDefault + Controller `/api/preference/view` + 六操作符枚举 `SavedViewOperator`（包含/不包含/属于任一/不属于任一/早于/晚于 等）+ 按 `scope_key` 分组、crm-preference 不校验字段。
- **商机侧接线样本**：`OpportunitySavedViewFilter`（filter_json → wrapper，字段池白名单 = 票 10 可筛选列，未知字段/操作符跳过）+ `OpportunityPageParam.savedViewId` + ViewQueryImpl 叠加。**本票直接参此样本改客户版**（rule of three，商机是样本1，客户是样本2；样本3出现前不抽共享翻译器）。
- **原型明说客户支持自定义视图**（`a4-1-1_客户公海列表.txt` / `a4-2-1_客户总览列表.txt` / `a4-3-1_我的客户列表.txt` 三处均有「常用检索 / 自定义检索 / 编辑检索 / 重命名 / 删除」+ 保存对话框条件列表）。

## 接入手册三步

1. **约定 scope_key**：
   - 客户总览 = `customer.overview`
   - 我的客户 = `customer.mine`
   - 客户公海 = `customer.pool`
   - （公海双视角=普通销售/领导 → 是否分两 scope 需拍板；推荐**共用 `customer.pool`**，因为字段池相同，视角只影响行内操作而非筛选。）
2. **建 `CustomerSavedViewFilter`**：filter_json 条件翻译成 MyBatis-Plus wrapper；字段池白名单 = 票 03 定的可筛选列（客户名称/客户类型/行业/客户阶段/星级/关系星级/战略等级/地区/最近跟进时间/进入公海时间 等）；未知字段/操作符跳过。
3. **PageParam 加 `savedViewId`**：客户三 workspace 的 PageParam 均加此字段；ViewQueryImpl 里叠加 filter。

## 待拍板点

1. **scope_key 数量**：3 个还是把公海/总览合成一个？→ 推荐 3 个（保存的检索按语境分组，用户体验更清晰）。
2. **公海双视角是否分 scope**：见上，推荐共用。
3. **排序字段池**：默认可排序 = 创建时间 / 最近跟进时间 / 进入公海时间；其他字段（如客户名称）排不排？→ 参商机的默认口径。
4. **默认视图**：每个 scope 一个 isDefault 视图，crm-preference 已实现互斥。前端进入 workspace 先调 `/view/list` 取 isDefault 再带 viewId 调 `/page`（对称商机）。
5. **测试**：本票不写代码，但 spec 需列出接入验收清单（scope_key 唯一/filter 白名单/未知字段跳过/默认视图互斥/端到端 saved-view 可用）。

## Answer

_(待 resolve)_