You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

54 lines
2.8 KiB

5 days ago
## Answer
**Status: resolved**
### A. 接线结论(定稿)
复用 crm-preference `user_saved_view` 平台能力,**不重写**。rule of three:商机是样本 1,客户是样本 2;样本 3 出现前不抽共享翻译器(各自 `XxxSavedViewFilter`)。
### B. scope_key(定稿,3 个)
| workspace | scope_key |
|---|---|
| 客户总览 | `customer.overview` |
| 我的客户 | `customer.mine` |
| 客户公海 | `customer.pool` |
- **公海双视角(普通销售 / 领导)共用 `customer.pool`**:字段池相同,视角只影响行内操作(领取 vs 分配),不影响筛选条件。
### C. `CustomerSavedViewFilter`(定稿)
- filter_json → MyBatis-Plus wrapper 翻译器,对称 `OpportunitySavedViewFilter`
- **字段池白名单**(票 03 定的可筛选列):
| 字段 | 支持操作符 |
|---|---|
| 客户名称 / 客户编号 | 包含 / 不包含 |
| 客户类型 / 行业 / 客户阶段 / 客户星级 / 关系星级 / 战略协议等级 / 已成交VIP等级 / 档案状态 / 地区 | 属于任一 / 不属于任一 |
| 最近跟进时间 | 早于 / 晚于 / 从未跟进 / 已有跟进 |
| 进入公海时间(仅 pool) | 早于 / 晚于 |
| 销售负责人 / 销售部门(仅 overview / mine) | 属于任一 / 不属于任一 |
| 创建时间 | 早于 / 晚于 |
- **未知字段 / 未知操作符 → 跳过**(不报错,对称商机)。
- **排序字段池**:创建时间 / 最近跟进时间 / 进入公海时间(默认);客户名称等文本字段**不排**(参商机默认口径)。
### D. PageParam 接入(定稿)
- 三 workspace 的 PageParam(`CustomerOverviewPageParam` / `CustomerMinePageParam` / `CustomerPoolPageParam`)均加 `savedViewId`
- ViewQueryImpl:有 `savedViewId` → 先调 `SavedViewService.get(viewId, scope_key)` 取 filter → 叠加 wrapper;无 → 不叠加。
- 前端进入 workspace:先 `GET /api/preference/view/list?scope_key=...``isDefault` 视图 → 带 `viewId``/page`(对称商机)。
### E. 验收清单(spec 级,不写代码)
1. scope_key 唯一性:`customer.overview` / `customer.mine` / `customer.pool` 三值互斥,与商机 `opportunity.*` 无碰撞。
2. filter 白名单:白名单内字段 + 合法操作符生效;白名单外字段/操作符静默跳过。
3. 默认视图互斥:每 scope 仅一个 `isDefault`(crm-preference 已实现,验证客户三 scope 复用生效)。
4. 端到端:保存自定义检索 → 列表 → 再次进入带 viewId 恢复条件。
5. 数据范围不越权:saved-view 只叠加筛选,**不改变** @DataScope 数据范围。
### F. 回填 / 下游
- **票 03**:字段池白名单来源(票 03 D 节共用列 + 差异列)。
- **crm-preference**:无改动(纯消费方)。