luoweijian
/
crm-backend-matt
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
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.
137 Commits
1 Branch
0 Tags
401 MiB
 
 
 
 
 
Tree: 2329f8cf14
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '2329f8cf14'
${ noResults }
crm-backend-matt/.scratch/customer-module/issues/07-detail-follow-oplog.md

5.1 KiB
Raw Blame History

07 — 客户详情 8 页签 + 跟进记录 + 操作日志

Type: research Status: open Blocked by: 02, 05

问题

定客户详情页公共头部 + 8 页签数据源、跟进记录 customer_follow 子表、操作日志 customer_oplog 子表（字段级审计口径，对称商机 oplog 票 09）。

一手证据（蓝湖缓存 txt）

  • a4-4-1_客户详情_客户信息_.txt — 公共头部 + 客户信息页签 + 权限/敏感信息/加载/异常规则（这是详情页的顶层 spec，务必细读）
  • a4-4-2_客户详情_联系人_.txt — 联系人页签（复用票 06 数据源）
  • a4-4-3_客户详情_跟进记录_.txt — 跟进记录页签
  • a4-4-4_客户详情_关联商机_.txt — 关联商机页签（读 crm-opportunity ✅ 已建）
  • a4-4-5_客户详情_关联项目_.txt — 关联项目页签（读 A5 未建 → 划出本图，页签保留骨架显"—")
  • a4-4-6_客户详情_团队成员_.txt / a4-4-7_客户详情_团队成员_.txt — 团队成员页签
  • a4-4-6_客户详情_战略协议_.txt — 战略协议页签（战略协议子域划出 → 本图页签保留骨架显"—")
  • a4-4-1_客户详情_已归档客户_.txt / a4-4-1_客户详情_已被合并客户_.txt — 归档/合并态的详情皮肤
  • a4-4-7_客户详情_操作日志_.txt / a4-4-8_客户详情_操作日志_.txt — 操作日志页签

8 页签清单

  1. 客户信息 — 主表字段展开（票 02 字段集），支持折叠区块，「编辑客户信息」跳编辑页；「工商信息更新」→ 企查查回填 seam（票 04 复用）。
  2. 联系人 — 票 06 数据源，GET /api/customer/{id}/contacts。
  3. 跟进记录 — 本票新建 customer_follow 子表。
  4. 关联商机 — 反查 crm-opportunity（GET /api/opportunity/by-customer/{customerId} 需商机侧新增或本票新增反查接口）。
  5. 关联项目 — 划出（A5 未建），页签骨架保留。
  6. 战略协议 — 划出（战略协议子域），页签骨架保留。
  7. 团队成员 — 显示销售负责人 + 协同人；领导可维护。
  8. 操作日志 — 本票新建 customer_oplog 子表。

已知事实

  • 公共头部：客户阶段(潜在/重潜/已成交)/客户星级/销售负责人+部门/战略协议等级(快照)/已成交VIP等级/客户档案状态/最近跟进摘要/汇总卡片（已中标项目总额=A5读、跟进中方案预估总额=方案卡读、进行中商机总额=crm-opportunity读）/关联业务计数/快捷操作(关注/标记重点客户/跟进/添加联系人/新增商机/新增项目/新增战略协议/工商信息更新)。
  • 敏感信息：完整/脱敏/无权限三档；脱敏对电话/金额；完整值只当前页面会话生效，刷新恢复脱敏；每次完整查看记录敏感信息查询日志。
  • 加载/异常：局部区域独立加载/失败/重试；关联模块接口失败只影响该区域，客户基本信息继续展示。
  • 跟进记录：跟进方式必选(字典 follow_way 复用商机)、跟进内容必填(1-500)、下次跟进时间(非必填、不得早于当前)；本期不做跟进附件；提交后刷新最近跟进+跟进记录页签；商机行也可点跟进复用同一弹窗，自动关联当前客户+该商机(即 customer_follow.opportunity_id 可选)。
  • 操作日志（口径纠偏，对称商机票 09）：字段级审计——实体(customer/contact/follow/team)/字段/旧值/新值/操作人(系统 vs 人工)/操作时间/来源；非动作枚举模型。归属变更(领取/分配/抛公海/交割/归档)/阶段变更/工商信息更新/编辑保存/联系人增删改/团队成员变更/敏感信息查询/仍要创建重复客户/相似客户仍创建 均写日志；未保存/取消/校验失败不写。日志脱敏电话/金额；工商查询 raw / OCR 图片不写日志。默认全记 + 短黑名单排除（非白名单）。

待拍板点

  1. customer_follow 表字段：id/customer_id/opportunity_id(可选)/follow_way/content/next_follow_time/creator/create_time；无草稿态（对称商机票 09）；无附件本期。
  2. customer_oplog 表字段：id/biz_type(customer/contact/follow/team/company_info)/biz_id/entity_field/old_value/new_value/operator_user_id(null=系统)/operator_source/create_time；金额/电话脱敏存原值再回显时脱敏 or 存已脱敏值？→ 推荐存原值+回显时按查看者权限脱敏。
  3. 关联商机反查接口：本模块调 crm-opportunity 新增 list-by-customer 还是 crm-opportunity 直接暴露？→ 推荐 crm-opportunity 侧加，本模块调（对称票 09 的模块边界）。
  4. 公共头部汇总金额脱敏：无权限=***万元；无数据=0.00万元；接口失败=--+重试（原型明说）。
  5. 关注 / 标记重点客户 = 用户维度个人状态（对称商机票 14 followed）——本表建 user_customer_focus(user_id, customer_id, is_starred)。
  6. 归档/合并态详情皮肤：只读，隐藏编辑/新增入口；仍展示历史数据。合并态划出（合并不做），归档态本图做。

Answer

(待 resolve)