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.
151 Commits
1 Branch
0 Tags
439 MiB
 
 
 
 
 
Tree: 2846d35de0
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '2846d35de0'
${ noResults }
crm-backend-matt/.scratch/a7-parity/matrix-a7-3-upper.md

8.8 KiB
Raw Blame History

矩阵：A7-3 业务规则·上半（票 03）

  • 范围：A7-3-1 线索规则 + A7-3-2 商机规则上半（阶段设置 3 页 / 方案卡模板 3 页 / 方案推送规则 3 页），共 10 页。
  • 双源：文本库 6 文件 + 截图 10 张（阶段详情/编辑、推送详情/编辑 4 页文本库缺失，以截图为源——已读图提取）。
  • 类型标注同票 02。

一、A7-3-1 线索规则（= A2-1-5 引用副本，文本库 370 行）

# 原型要素 证据 现状 差距
1 列表 13 列：NO./池名称/团队/部门/省份/负责市场(城市)/部门负责人/部门成员/领取规则/超时回收/失效时长/持有上限/操作 u18-u43 POST /api/rule/pool/page（LeadPoolDTO） 缺出参块：「部门成员」列无数据源（见 #4）
2 按钮：新增公海池/批量删除/导入公海池/导出公海池 u152/u154/u227/u228 saveOrUpdate、delete-batch ✅ 缺接口×2：导入公海池、导出公海池
3 新增/编辑双 Tab（公海池+其他设置）：名称/省份/负责市场(市-区-县多选组件 u431)/销售团队/销售部门/部门负责人/部门成员/部门协作人 + 领取规则(两档单选)/每日领取上限/持有上限/超时回收 N 天/失效 M 天 u361-u431/u250-u269/u297 LeadPoolDTO：poolName✅ provinceRegionIds✅ cityRegionIds✅(市/区) teamDeptId✅ deptId✅ ownerUserId✅ collaboratorUserIds✅ claimRule(1/2)✅ dailyClaimLimit✅ holdLimit✅ recycleDays✅ expireDays✅ ✅ 字段高度对齐；缺入参：「部门成员」memberUserIds（原型独立多选，钉钉组织架构选人，u203-u224；现仅 owner+collaborator 两类，PoolMemberStore 落库 role_type 只有 OWNER/COLLABORATOR）——语义待拍板（显式成员表 vs 归属部门动态成员）
4 部门负责人权限约束（超管全改/部门负责人限本部门/销售无入口） u297 savePool 已拦截非管理员改 deptId（P2-4） ✅（其他规则参数的负责人可改性待核）
5 双归属 tag — tags={"A2 线索管理/线索设置","A7 后台管理/线索规则"} tag 待修：A7 侧应为「A7 后台管理/业务规则/线索规则」（v29 权威树：A7 后台管理>A7-3 业务规则>A7-3-1 线索规则）；文档仓副本同步

二、A7-3-2-1 商机阶段设置（3 页；详情/编辑页文本缺失，读图）

# 原型要素 证据 现状 差距
1 列表 9 列：序号/模板名称/编码/版本号/状态/适用范围/最近更新/绑定商机/操作 列表 u30-u38 page 按版本维度 ✅ 「绑定商机(条数)」列：Controller 注释已裁决归商机域统计不回显——已知裁决，页面展示需数据源，建议票 06 重议（page 附 count 或前端另查）
2 操作矩阵：草稿=详情/编辑/删除；发布中/停用=详情/编辑/复制 u47/u56/u193 page/detail/save-draft/publish/copy/disable/delete/versions 8 端点，状态机服务层兜底 ✅ ✅ 高度对齐
3 版本规则：同模板唯一草稿+唯一发布中；发布后原版转停用；编辑发布中=生成新草稿；复制=独立新模板新编码 u209 saveDraft/publish/copy 语义吻合 ✅ ✅
4 表单：模板名称/编码(系统)/适用范围/是否默认/模板说明 + 阶段流程节点条（增删排序） 编辑页截图 DTO：templateName✅ templateCode✅ applyScope(1/2) isDefault✅ templateDesc✅ nodes✅ 缺入参/语义：适用范围原型含条件式形态（列表示例「招标形式=ZC」「所属部门=广东15部」，u71/u89/u107），现有 applyScope 仅 1所有商机/2指定部门 两档，缺「指定条件(如招标形式)」档 + 条件值字段
5 节点配置：阶段字典项(引用「商机阶段」字典)/自定义节点名称/工作目标；固定节点「已转项目」末位 编辑页截图+PRD 字段说明 9-11 NodeItem：stageDictCode✅ customNodeName✅ workGoal✅ isFixed(服务端保证 OPP_STAGE_05)✅ ✅ 完全对齐
6 字典项状态校验：「仅启用状态的字典项可供阶段模板新增时选择」 编辑页 PRD 字段说明 17 — 校验差距：saveDraft/publish 校验 stageDictCode 引用字典项为启用态
7 tag — @Tag("A7 后台管理/商机规则/阶段模板") tag 待修：「A7 后台管理/业务规则/商机规则/商机阶段设置」

三、A7-3-2-2 方案卡模板（3 页）

# 原型要素 证据 现状 差距
1 列表 10 列：序号/模板名称/编码/版本号/状态/适用范围/展示字段数/必填字段数/最近更新/操作 列表 u339-u348 page ✅（9 端点 + field-defs 系统字段库） 缺出参块：展示字段数/必填字段数两列无数据源（page 不回显字段项；detail 可算——建议 page 补两个 count）
2 表单：*适用范围（1所有部门通用/2对应部门专用）+是否默认(仅通用可设·唯一) 编辑页 u25/u28 DTO applyScope 两档 + isDefault 约束 ✅（票 07 已按原型） ✅
3 版本/操作矩阵（同阶段模板） 列表 PRD 同 #二-2 端点族 ✅ ✅
4 tag — @Tag("A7 后台管理/商机规则/方案卡模板") tag 待修：「A7 后台管理/业务规则/商机规则/方案卡模板」

四、A7-3-2-3 方案推送规则（3 页；详情/编辑页文本缺失，读图）——全缺码模块

原型形态：版本化规则主体（同阶段/方案卡模板模式：唯一草稿+唯一发布中、发布转停用、编辑生成新草稿、复制独立新编码）+ 4 步骤推送配置器。

应有端点清单（对标阶段模板 8 端点形态，/api/rule/opp-push-rule）：

  1. POST /page —— 分页（关键词/适用范围/状态筛选）
  2. GET /detail?id= —— 详情（含步骤配置只读回显）
  3. GET /versions?id= —— 同族版本列表
  4. POST /save-draft —— 保存草稿（配置全量替换）
  5. POST /publish —— 保存并发布（原发布中转停用）
  6. POST /copy?id= —— 复制（新编码 V1.0 草稿）
  7. POST /disable?id= —— 停用（仅发布中）
  8. POST /delete?id= —— 删除（仅草稿）

入参 DTO 设计素材（编辑页截图+PRD 字段说明 16 项）：

  • 主体：ruleName（必填，同族同名单版本间不可重复）、ruleCode（系统生成 PUSH_RULE_XX）、versionNo/status（系统）、适用范围（条件式：「全部商机」或「指定项目阶段/商机阶段等」+条件值，列表示例「项目阶段='投标阶段'」）、是否默认（同千位可绑定的适用范围中设默认）、ruleDesc（选填）
  • 推送配置 4 步骤：
    1. 基础推送信息：推送节点名称（下拉）、方案卡模板引用（选商务场景后加载方案卡版本）
    2. 字段校验：校验规则列表 [字段名称/字段来源(必填)/字段类型/校验规则(必填)/校验失败处理方式(必填)]，可增删行；失败方式（阻断提交/跳过节点等）
    3. 字段映射：映射列表 [字段名称/对应字段+推送方式]
    4. 创建/关联项目：创建方式（自动创建/用户交互/关联已有项目）、项目重复规则引用、项目名称规则（默认+动态字段拼接）、字段获取项目目标、备注信息（支持客户/负责人/时间等变量占位）
  • 出参附加：执行次数（按版本累计，草稿显示"--"；执行侧归商机域，列表回显需统计源——票 06 拍板数据源）
  • 业务约束（PRD u218）：停用后保留累计次数不新增；历史执行记录关联原版本不迁移；草稿不参与推送判断
  • tag：「A7 后台管理/业务规则/商机规则/方案推送规则」

五、缺口汇总（本票）

缺接口（3 组）

  1. 公海池导入 + 导出（A7-3-1）
  2. 方案推送规则全模块 8 端点（A7-3-2-3，新 Controller + 配置子表 + 推送执行侧归商机域另计）
  3. （待议）阶段模板「绑定商机」/ 推送规则「执行次数」列表统计源

缺入参（2 项）

  • LeadPoolDTO +「部门成员」memberUserIds（语义待拍板：显式成员表 vs 部门动态）
  • 阶段模板 applyScope 条件式档（「指定条件(招标形式等)」+ 条件值字段）——与推送规则适用范围同构，建议统一「条件式适用范围」值对象

缺出参块（2 项）

  • LeadPool 列表「部门成员」列数据源（随 #缺入参）
  • 方案卡 page 出参 +展示字段数/必填字段数

校验差距（1 项）

  • 阶段模板/推送规则保存时校验引用字典项为启用态

tag 待修（3 处）

  • LeadPool 双归属副本 →「A7 后台管理/业务规则/线索规则」
  • 阶段模板 →「A7 后台管理/业务规则/商机规则/商机阶段设置」
  • 方案卡 →「A7 后台管理/业务规则/商机规则/方案卡模板」（+推送规则新端点按此格式）