# A7 后台管理缺口总报告（票 02-05 矩阵汇总）

四张矩阵：[matrix-a7-1-a7-2](matrix-a7-1-a7-2.md) / [matrix-a7-3-upper](matrix-a7-3-upper.md) / [matrix-a7-3-lower](matrix-a7-3-lower.md) / [matrix-a7-4-a7-5](matrix-a7-4-a7-5.md)。正式树 31 页全部过目完毕。

## 一、缺接口（按分区）

| 分区 | 缺口 | 规模 | 备注 |
|---|---|---|---|
| A7-1 用户管理 | 批量分配角色、移交预览、移交执行、用户导出 | 4 端点（轻） | 分配/移交均为全量替换语义 |
| A7-1 同步任务页 | 同步任务 5 端点（列表/触发/详情/日志/重试） | 5 端点（**重**：对接钉钉任务调度） | 原型有独立页 |
| A7-2 角色管理 | roles stats / copy / enable / disable | 4 端点（轻） | |
| A7-2 权限点管理 | resources enable / disable / references | 3 端点（轻） | references 是删除前置校验页 |
| A7-3 方案推送规则 | 全缺码：page/detail/save-draft/publish/copy/disable/delete/versions | 8 端点（版本化族） | 4 步骤推送配置器（基础信息/字段校验/字段映射/创建关联项目），素材已提取 |
| A7-3 项目查重规则 | 全缺码：同版本化 8 端点 | 8 端点（版本化族） | 4 步骤查重向导（触发场景/关联项目检索/异常关系分析/处理策略），素材已提取 |
| A7-3 项目规则 | 全缺码：current + 5 分区保存（阶段别名/拉群人员/冲突拉群/阶段提醒/标底认定） | 6 端点（轻，聚合配置） | 阶段提醒区块原型自注「待补充」 |
| A7-3 线索规则 LeadPool | 部门成员字段 memberUserIds + 导入导出 2 端点 | 1 字段 + 2 端点（轻） | 成员语义待拍板（显式成员表 vs 部门动态） |
| A7-4 日志管理 | operation/login/batch 三 page + batch/download + batch/file + 全局日志表与采集 + 批量结果文件 90 天管理 | 5 端点 + 基建（**重**） | 实现形态方案 A/B 待拍板 |

已确认无缺码：A7-1 用户列表核心/部门树、A7-2 角色管理核心/资源管理核心、A7-3 阶段模板族/方案卡模板族/公海与提醒族/客户规则 2 页/商机相关字典、A7-5 数据字典页。

## 二、缺入参 / 出参（轻改，随补码顺手做）

- UserPageParam 缺 username/mobile/roleId/title；UserStatsDTO 出参缺 lastSyncTime/lastTransferTime/lastTransferUser
- RoleParam 缺 roleType/status；RoleDTO 出参缺 roleType/status/userCount
- 阶段模板 applyScope 缺条件式档（现有两档 vs 原型「招标形式=ZC」条件式）
- 公海规则 detail 出参缺绑定商机数量（P2：依赖商机侧落规则版本引用字段，建议记账后随商机模块对齐补）
- OpportunityPoolRule 列表如需「所属战队」等冗余列随 UI 确认

## 三、语义差异 / 拍板项

1. **资源删除语义相反**：现实现=子节点检查+级联清理引用；原型=有引用禁止删除。改行为影响现有调用方，需拍板。
2. **LeadPool 部门成员**：显式成员表 vs 部门动态映射，语义拍板。
3. **查重规则「执行次数」vs「引用次数」**：原型列头与字段说明矛盾，建议按「引用次数」（被推送规则引用锁定版本的次数）理解。
4. **幻影挂账 3 项**：POST /depts/save、/depts/delete、/users/admin-role 原型无对应入口——保留（运维用）还是随文档重生成隐藏。
5. **字典种子数据**：商机 4 分组（opportunity_stage 8 值/opp_status/pause_reason/close_reason）种子缺失。
6. **dict 服务层 2 验证点**：默认项禁止停用阻断、未引用才可改分组（执行票顺带核）。

## 四、tag 待修清单（累计 12 处，随补码一次性改）

| # | Controller | 现状 → 目标 |
|---|---|---|
| 1-4 | ResourceController 4 端点 | 「A7 后台管理/权限点管理」→ 补「权限管理」一级 |
| 5 | SystemController /sync/dingtalk | 「A7 后台管理/运维」→「A7 后台管理/用户管理/同步任务」 |
| 6 | LeadPoolController | A7 副本 tag →「A7 后台管理/业务规则/线索规则」 |
| 7 | OpportunityStageTemplateController | → 补「业务规则」一级：「…/业务规则/商机规则/商机阶段设置」 |
| 8 | OpportunitySchemeCardTemplateController | →「…/业务规则/商机规则/方案卡模板」 |
| 9 | OpportunityPoolRuleController | →「…/业务规则/商机规则/公海与提醒」 |
| 10-11 | CustomerReminderRule / CustomerDedupRule | →「…/业务规则/客户规则/客户管理设置（超期未跟进提醒 / 客户查重设置）」 |
| 12 | DictGroup/DictItem | → 补「系统设置」一级 + 方法级多值挂「…/业务规则/商机规则/商机相关字典」（ADR-0024） |

## 五、待拍板四问

1. 本期补齐范围分档（P0 全做 / 重接口记账不做）。
2. 新接口模块归属：推送规则+查重规则+项目规则是否进 crm-rule；全局日志放哪。
3. 全局日志实现形态：A 新全局表+AOP 采集（域内三表保留服务详情页） vs B 聚合域内三表。
4. A7-2-3 数据共享（backup 草稿箱 3 页）是否纳入盘点范围。

拍板后毕业执行票：补码 + 深 tag + bruno-sync 重生成 + 基线验收（编译过 / BOM 0 / 单测全绿 / 对账双向零差）。

---

## 六、执行收官标注（票 12，2026-09-07）

执行票 07-12 全部 resolved，缺口处置终态如下（详细存证见各票 Answer）：

- **已执行**：缺接口 9 组中 7 组落地（用户管理 4 / 角色 4 / 权限点 3 / 推送规则 8 / 查重规则 8 / 项目规则 6 / LeadPool 1 字段+2 端点）；缺入出参全落（UserPageParam×4 / UserStats 时间戳×3 / RoleParam×2 / RoleDTO×3 / 阶段模板条件式档）；语义差异按票 06 拍板兑现（资源删除级联→禁删等）；tag 12 处全修；bruno-sync 重生成对账双向零差（372=372）。
- **已记账（本期不做）**：同步任务 5 端点（钉钉任务调度对接）；全局日志 5 端点+新全局表+AOP+批量结果文件 90 天管理（归属新建 crm-log）；公海规则 detail「绑定商机数量」出参（P2，依赖商机侧引用字段）；A7-2-3 数据共享 3 页（等原型正式化）。