2.6 KiB
06 · 列偏好 scopeKey：客户 4 个 + 商机 3 个 + 平台 tags 双归属
- Status: resolved
- Type: task
- Blocked by: 01-ag-checklist
目标
字段设置（显隐列+顺序）后端接线，完全复刻线索模块范式（R5/R7）：业务方只加 scopeKey 常量，存储走既有 /api/preference/get|save + user_column_preference 表，零新端点。
做法
- crm-customer 常量（LeadConstants 同款注释块）：
COLUMN_SCOPE_OVERVIEW/MINE/POOL/CONTACT=customer.overview/mine/pool、contact.list； - crm-opportunity 常量：
opportunity.sales/manage/public_pool； ColumnPreferenceController（crm-preference）方法级 tags 补双归属：- 现状：仅 A2 线索四页；
- 补：A4 客户四页（总览/我的客户/公海/联系人）+ A3 商机三页（销售机会/商机管理/商机公海）；
- 固定列校验（客户名称不可隐藏、勾选/序号/操作列不参与、重置默认）归前端，后端只存取（平台侧不校验，与线索一致——R5 拍板）；
- 注：lead 侧常量标注"预留，尚未接线"维持现状，本票不动线索。
验收
- 三模块 mvn test 绿；
- knife4j 上
/api/preference/get|save出现在 A2/A3/A4 全部相关页面分组； - 常量注释引用 crm-preference/CONTEXT.md「scope」口径（同 LeadConstants L46-50 写法）。
Answer
常量块 — CustomerConstants.COLUMN_SCOPE_OVERVIEW/MINE/POOL/CONTACT = customer.overview/mine/pool、contact.list；OpportunityConstants.COLUMN_SCOPE_SALES/MANAGE/PUBLIC_POOL = opportunity.sales/manage/public_pool（与 saved-view / 形态偏好同码位）。注释块对称 LeadConstants L46-50 写法：引用 crm-preference/CONTEXT.md「scope」口径、crm-preference 不透明字符串存储不持语义、依赖方向单向防成环、固定列校验归前端（R5）。零新端点——存储走既有 /api/preference/get|save + user_column_preference 表。
平台 tags 双归属 → 三域归属 — ColumnPreferenceController 两 @Operation tags 由 A2×4 扩为 A2×4 + A4×4（总览/我的客户/公海/联系人）+ A3×3（销售机会/商机管理/商机公海），与票 05 形态偏好同套页面 tag 文本（ADR-0024 菜单粒度）；knife4j 上 /api/preference/get|save 落 A2/A3/A4 全部相关页面分组。
边界维持：lead 侧常量"预留，尚未接线"未动；后端不做固定列校验（平台只存取，测试既有口径未变）。
测试与验收：mvn test -pl crm-preference,crm-customer,crm-opportunity -am 全绿（改动为纯常量+注解，preference 23 / customer 144 / opportunity 242 维持）；BOM 扫描 clean。