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.
95 lines
7.2 KiB
95 lines
7.2 KiB
5 days ago
|
|
||
|
|
## Answer
|
||
|
|
|
||
|
|
**Status: resolved**（含 grill Q9 归档=删除 + Q15 领取赋锚点回填）
|
||
|
|
|
||
|
|
### A. 三个 workspace 数据范围（定稿）
|
||
|
|
|
||
|
|
| workspace | 数据范围 | 附加状态页 |
|
||
|
|
|---|---|---|
|
||
|
|
| **我的客户** | 当前用户为**销售负责人或协同人** 且 `archive_status=有效(1)` 且 **非公海**（owner 非空） | **无独立归档子页**（归档=删除，见 grill Q9/D19；列表加 `archive_status` 筛选默认排除） |
|
||
|
|
| **客户总览** | `@DataScope` 覆盖组织范围的 **未删除、未进入公海** 客户（默认只列 `archive_status=1`） | **无独立归档 tab**（归档=删除，加筛选条件默认排除，可勾选查询） |
|
||
|
|
| **客户公海** | `archive_status=有效(1)` **且 `owner_user_id IS NULL`** 逻辑视图 | 无 |
|
||
|
|
|
||
|
|
- **公海不是独立实体**，无池表；对称商机公海 = 逻辑视图（chart D3）。
|
||
|
|
- **管理职务不扩大「我的客户」数据范围**（原型 2.1 §6 明文）；管理视角走「客户总览」。
|
||
|
|
- **协同人视角**：协同人可见客户（进「我的客户」），但**不得归档/合并**（仅负责人可，原型 2.2 §4）。
|
||
|
|
|
||
|
|
### B. 内置视图 / 常用检索（硬编码，不入库）
|
||
|
|
|
||
|
|
**我的客户** 内置：`我负责的客户`(owner=我) / `我协同的客户`(团队成员表含我) / `待跟进的客户`(有下次跟进时间且 ≤ now) / `我关注的客户`(关注表) / `最近访问`(view_log 倒序)。
|
||
|
|
|
||
|
|
**客户公海** 内置：`最近访问` / `我关注的客户`（原型 A4-1-1 检索列表只见这两项 + 自定义）。
|
||
|
|
|
||
|
|
**客户总览** 内置：`最近访问` / `我关注的客户` / `我负责的客户` / `我协同的客户`（原型 A4-2-1 有「我负责的/我协同的」身份筛选）。
|
||
|
|
|
||
|
|
> 自定义视图 = crm-preference 平台能力，票 11 接入（三个 scope_key）。内置视图**不落库**，口径硬编码（对称商机票 14 拍板）。
|
||
|
|
|
||
|
|
### C. 三视图模式（定稿）
|
||
|
|
|
||
|
|
| workspace | 视图模式 |
|
||
|
|
|---|---|
|
||
|
|
| 我的客户 | 表格 / 列表详情(左表+右详情) / **看板** |
|
||
|
|
| 客户总览 | 表格 / 列表详情 / **看板** |
|
||
|
|
| 客户公海 | 表格 / 分屏(左表+右详情) |
|
||
|
|
|
||
|
|
- **看板视图分组页签 = 三个**：`客户阶段` / `客户星级` / `关系星级`（原型 A4-3-1 §1.3 明文「看板视图包含客户阶段、客户星级、关系星级三个分组页签」；A4-2-1 卡片视图顶部即「潜在客户(3)/重潜客户(3)/已成交客户(3)」）。
|
||
|
|
- ⚠ **本期注记（D20 改票 B）**：客户阶段本期实际只有「潜在」（重潜/已成交触发链路 seam 不可达），故本期看板「客户阶段」分组下客户均堆在「潜在客户」列，重潜/已成交列恒为空。**这是预期行为、非 bug**：看板仍按 `customer_stage` 正常分组，三列骨架照旧渲染，链路就绪后自然填充；不得为填列而造假阶段数据。
|
||
|
|
- **视图切换记住用户偏好**（复用 crm-preference 列偏好能力；对称商机票 14）；首次默认表格视图。
|
||
|
|
- 勾选跨分页保留；全选仅当前页/当前批次；批量操作按已勾选 ID 集合执行。
|
||
|
|
|
||
|
|
### D. 共用列（定稿，三 workspace 同款列基础 + 差异列）
|
||
|
|
|
||
|
|
**共用列**：客户名称(固定列不可隐藏) / 客户编号 / 客户类型 / 所属地区 / 行业 / 客户阶段 / 客户星级 / 关系星级 / 战略协议等级(快照) / 已成交VIP客户等级(快照) / 关联业务(商机/项目计数) / 最近跟进时间。
|
||
|
|
|
||
|
|
**差异列**：
|
||
|
|
- 我的客户 / 客户总览：+ 销售负责人 / 销售部门。
|
||
|
|
- 客户公海：+ **进入公海时间**(`enter_pool_time`，见票 03 回填) / 无销售负责人列（owner 空）。
|
||
|
|
|
||
|
|
**字段设置** = crm-preference 列偏好（列显隐/排序，用户级）；客户名称为固定列不参与设置。
|
||
|
|
|
||
|
|
### E. 归属迁移动作枚举（定稿）
|
||
|
|
|
||
|
|
| 动作 | 语义 | 前置校验 | 触发方 |
|
||
|
|
|---|---|---|---|
|
||
|
|
| 领取 | 公海→个人（owner 空→当前用户） | 客户仍在公海 + 无进行中商机/项目 | 普通销售 |
|
||
|
|
| 分配 | 公海→个人 / 个人→个人（换 owner） | 目标人员启用 + 有权分配范围 + 非原负责人 | 领导/管理 |
|
||
|
|
| 抛公海 | 个人→公海（清 owner+协同人） | **无进行中商机/项目**（原型 A4-1-1 §3 明文）+ 有抛公海权限 | 领导/管理 |
|
||
|
|
| 归档 | 有效→已归档（archive_status 1→2） | 仅销售负责人可；**无进行中商机/项目**（原型 A4-3-1 归档弹窗明说） | 销售/领导 |
|
||
|
|
| 恢复 | 已归档→有效（2→1） | 仅销售负责人可 | 销售/领导 |
|
||
|
|
| 交割 | 换 owner（跨模块同步商机/项目负责人） | 票 08 专管 | 销售本人 |
|
||
|
|
|
||
|
|
- 每边**写操作日志**（票 07 oplog）；CAS 乐观锁 + 版本号。
|
||
|
|
- **批量操作部分失败不回滚**（按客户逐条独立事务，跳过已不可操作项，Toast 报成功/跳过数）——**例外：批量归档整批预检**，任一失败整批不执行（原型 A4-3-1 §3.6 明文）。
|
||
|
|
- **「进行中商机/项目」阻止抛公海/归档**：商机侧读 crm-opportunity（状态=推进中 即 opp_status=2）；**项目侧留 seam**（A5 未建，先跳过项目那半，等 A5 建好补校验）。
|
||
|
|
- **领取/分配 后端副作用（D25，票10 锚点）**：从公海领取或分配到一个负责人时，若 `last_valid_follow_time` 为空（客户此前无主/无锚点）→ 赋当前时刻（超期提醒开始计时）。抛公海/归属迁移不动锚点（仍需有主才计时）。
|
||
|
|
|
||
|
|
### F. 新增字段（回填票 02）
|
||
|
|
|
||
|
|
| Java 字段 | 列名 | 类型 | 说明 |
|
||
|
|
|---|---|---|---|
|
||
|
|
| enterPoolTime | enter_pool_time | datetime | 进入公海时间（公海列表列；抛公海时写入，领取/分配时清空） |
|
||
|
|
|
||
|
|
> `enterPoolTime` 无孤立单大写字母陷阱，无需 `@Column(name=...)`。
|
||
|
|
|
||
|
|
### G. 领导视角 DataScope 映射（对称 crm-auth）
|
||
|
|
|
||
|
|
- 客户总览可见性 = `@DataScope(module="customer")` 套 `DataScopeEnum(SELF/DEPT/DEPT_AND_CHILD/ALL)`，按用户角色配置决定（ADR-0018 按模块可配）。
|
||
|
|
- 普通销售**无客户总览菜单权限**时不可见；总监=DEPT_AND_CHILD 或 ALL（按后台配置）。
|
||
|
|
- 公海：普通销售看「可领取」= 其部门集合可见范围内 owner 空的客户；领导看「可分配」= 其管理范围。
|
||
|
|
|
||
|
|
### H. 产品确认项 — 已随 grill 全部销号
|
||
|
|
|
||
|
|
| # | 问题 | 影响 |
|
||
|
|
|---|---|---|
|
||
|
|
| P0-1 | ~~已归档/已被合并 tab 形态~~ **已拍板（grill Q9/D19）**：去掉「已被合并」；**已归档 = 删除**，不做独立 tab/子页，列表加 `archive_status` 筛选条件（默认排除已归档，勾选可查） | 列表查询参数 |
|
||
|
|
| P1-1 | ~~进入公海时间排序~~ **已拍板（grill Q19）**：保留列 + 加入排序字段池（升降序） | 排序字段池（票 11） |
|
||
|
|
|
||
|
|
### I. 回填 / 下游影响
|
||
|
|
|
||
|
|
- **票 02**：新增 `enter_pool_time` 字段（本票 F）。
|
||
|
|
- **票 08**（交割）：owner 换主 = 本票「分配」动作的扩展版（跨模块同步），交割事务复用 owner 变更 oplog 语义。
|
||
|
|
- **票 11**（saved-view）：三 workspace 各自 scope_key，字段池白名单 = 本票 D 共用列 + 差异列。
|
||
|
|
- **票 07**（oplog）：归属迁移（领取/分配/抛公海/归档/恢复/交割）都写 oplog。
|
||
|
|
- **票 01**（CONTEXT）：术语「客户公海」「销售负责人」「协同人」「归档」「已合并」。
|