2.9 KiB

Raw Blame History

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

接入手册三步

约定 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

(待 resolve)

2.9 KiB Raw Blame History