5.7 KiB

Raw Blame History

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

Type: task Status: resolved 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 三处均有「常用检索 / 自定义检索 / 编辑检索 / 重命名 / 删除」+ 保存对话框条件列表）。

接入手册三步

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

待拍板点

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

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 级，不写代码）

scope_key 唯一性：customer.overview / customer.mine / customer.pool 三值互斥，与商机 opportunity.* 无碰撞。
filter 白名单：白名单内字段 + 合法操作符生效；白名单外字段/操作符静默跳过。
默认视图互斥：每 scope 仅一个 isDefault（crm-preference 已实现，验证客户三 scope 复用生效）。
端到端：保存自定义检索 → 列表 → 再次进入带 viewId 恢复条件。
数据范围不越权：saved-view 只叠加筛选，不改变 @DataScope 数据范围。

F. 回填 / 下游

票 03：字段池白名单来源（票 03 D 节共用列 + 差异列）。
crm-preference：无改动（纯消费方）。

5.7 KiB Raw Blame History