crm-backend-matt

5.0 KiB

Raw Blame History

Answer

Status: resolved

A. 客户详情页骨架（定稿）

公共头部（8 页签共享）：客户名称 / 客户阶段(只读条) / 客户星级 / 关系星级 / 战略协议等级(快照) / 已成交VIP等级(快照) / 客户档案状态 / 销售负责人+部门 / 最近跟进摘要 / 待跟进提醒(下次跟进时间) / 关联业务计数(1商机/1项目)。

汇总卡片（4 张，均外部模块提供，接口失败显"--"+重试，不显 0）：已中标项目总额(A5) / 跟进中方案预估总额(方案卡) / 进行中商机总额(crm-opportunity) / 合同总额·累计回款(预留占位显"--")。

8 页签（默认进「客户信息」；首次打开才加载，切回保留条件/分页）：

#	页签	数据源	本图
1	客户信息	主表（票 02）	✅
2	联系人	`GET /api/customer/{id}/contacts`（票 06）	✅
3	跟进记录	`customer_follow`（B）	✅
4	关联商机	反查 crm-opportunity（C）	✅
5	关联项目	A5 项目模块	❌ 骨架显"--"
6	战略协议	战略协议子域	❌ 骨架显"--"
7	团队成员	负责人+协同人（D）	✅
8	操作日志	`customer_oplog`（E）	✅

B. 跟进记录 `customer_follow`（定稿）

Java 字段	列名	类型	必填	说明
id	id	bigint		主键
customerId	customer_id	bigint	✅	客户 ID
followWay	follow_way	varchar(20)	✅	跟进方式字典 `follow_way`：微信/拜访/电话/邮件/会议
followContent	follow_content	text	✅	跟进内容
nextFollowTime	next_follow_time	datetime		下次跟进时间（有则进"待跟进"筛选）
followBy / followByName / followDeptName	follow_by / follow_by_name / follow_dept_name	—		跟进人快照（对称商机跟进范式）
createTime	create_time	—		跟进时间（=创建时间，不可改）

无孤立单大写字母陷阱。nextFollowTime→next_follow_time ✅。

约束：

提交后不可修改/删除；纠错 = 新增补充记录（原型 7 明文）。
提交中禁止重复提交（原型公共规则）。
写库副作用（关键）：customer.last_valid_follow_time = now（超期提醒锚点刷新，票 10 回填）；更新"待跟进"状态。

契约：

POST /api/customer/{id}/follow          新增跟进（刷新 last_valid_follow_time）
GET  /api/customer/{id}/follow/page     跟进记录分页（时间倒序 + 日期分组；按 follow_way/关键字/时间范围过滤）

C. 关联商机页签（定稿，只读反查）

数据源：反查 crm-opportunity（按 customer_id 查该客户全部商机）。
列：商机名称 / 商机编号 / 阶段 / 预计金额 / 销售负责人 / 最近更新；点商机名跳 crm-opportunity 商机详情（新窗口）。
只读，不在客户详情内做商机写操作（对称：商机详情反查客户也只是带出）。
接口失败显"--" + 重试，不显 0 条。

D. 团队成员页签（定稿）

数据：销售负责人（owner_user_id 快照）+ 协同人列表（团队成员关联表）。
展示：姓名 / 部门 / 角色（负责人/协同人）；GET /api/customer/{id}/members。

E. 操作日志 `customer_oplog`（定稿，对称商机 oplog 范式）

Java 字段	列名	类型	说明
id	id	bigint	主键
customerId	customer_id	bigint	客户 ID
action	action	varchar(50)	动作类型：CREATE/UPDATE/FOLLOW/ARCHIVE/RESTORE/TRANSFER/CLAIM/POOL/STAGE_CHANGE
detail	detail	varchar(1000)	变更描述，形态 `把 {字段} 从 {旧} 修改为 {新}`（原型 8 明文）
operatorId / operatorName / operatorDeptName	operator_id / operator_name / operator_dept_name	—	操作人快照
createTime	create_time	—	操作时间

只追加、不可改删；GET /api/customer/{id}/oplog/page（时间倒序 + 日期分组 + 关键字/时间范围过滤）。
保留策略（§5.5 拍板 A，20260902）：customer_oplog 无限期保留（审计日志，不设保留期/清理/归档；不做冷热分离）。依据：原型 L250「日志生成后不可修改或删除」= append-only 审计；字段级日志量可控。
写 oplog 的动作（回填各票）：新增/编辑（票 02）/ 归属迁移·归档·恢复·领取·分配·抛公海（票 03）/ 阶段变化 operator=系统（票 05）/ 交割（票 08）。

F. 回填 / 下游

票 02：last_valid_follow_time 已含（B 刷新）。
票 03：归属迁移写 oplog（E）。
票 05：阶段变化写 oplog（operator=系统）。
票 10：跟进刷新锚点 → 超期提醒计时重启（B 副作用）。
crm-dict：新增 follow_way 分组（微信/拜访/电话/邮件/会议）。

G. 挂号 — 已随 grill 全部销号

~~汇总卡片占位渲染~~ 已拍板（grill Q18）：一律渲染卡片，值显"--"（不显 0/不留白），保持布局稳定。

5.0 KiB Raw Blame History