# M9 审批与流程引擎 — 需求分析

| 项 | 值 |
|---|---|
| 模块 | M9 审批与流程引擎 |
| 域 | E 平台通用 |
| 主要角色 | 全员 |
| 成熟度 | 🟡 已起草待细化 |
| 关联模块 | 全模块（统一 Request 与 Automations 被各模块复用） |
| 逻辑设计(LDD) | [ldd/M9（数据模型/审批链结构/Automations 机制/ARR 计算口径）](../ldd/M9-审批与流程引擎-设计.md) |
| 上级文档 | [需求分析总纲](../需求分析总纲.md) |

> 本文档只描述**做什么/为什么/规则/验收（What/Why）**；数据结构、审批链配置结构、Automations 触发→动作机制、ARR 档位计算口径等**实现（How）见设计文档**。

## 目标（Why）
统一审批入口 + 自动化引擎，供各模块复用（Sponsored、立项、超支、签署、续约等），解决审批分散、无统一留痕的痛点。

## 关键规则与决策（已敲定）
| # | 结论 |
|---|---|
| D-A1 | 权益/资格审批采用 **ARR 驱动核定**（FR-APR-05）；ARR 档位数值配置化、待业务确认。 |

## 功能需求（What）
| 编号 | 需求 | 优先级 |
|---|---|---|
| FR-APR-01 | **统一 Request**：Sponsored 申请、立项、Man-days 超支、状态跳转、交付签署、**续约**、项目关闭、**资源协调（TAM 协调 PS/Support/SA，可非审批仅跟踪闭环，M4 FR-ENG-06/07）**等统一走 Request。 | P0 |
| FR-APR-02 | **审批链可配**：支持串行/并行/条件分支（如金额 > $X 走 VP）。 | P0 |
| FR-APR-03 | **待办/加急/通知**：待办、加急（飞书应用内/短信/电话）、结果通知（**经统一「平台通知服务」触达**，与 M10 共用、不重复建设）；全程留痕。 | P1 |
| FR-APR-04 | **Automations 自动化引擎**：以触发→动作方式（状态变更→指派/建任务/通知；到期前→提醒）供各模块复用。 | P1 |
| FR-APR-05 | **权益/资格审批（ARR 驱动）**：例外场景（Exceptional Premium Support、PS Sponsored）走审批；申请时**录入 ARR**，权益引擎按 ARR 档位计算**允许上限**（如最大 Sponsored 天数），审批据此核定；超上限需更高层特批；核定结果生成对应（虚拟）Contract/Quota（M1 FR-CUST-08b）。**ARR 取数**：优先**从客户主数据（Contract.arr）派生/一致性校验**，人工覆写需留痕 + 更高层核准（防抬高 ARR 套取更高额度）。 | P0 |
| FR-APR-06 | **缺席委托（Out-of-Office Delegation，共有能力）**：用户可设**缺席期 + 代理人**，期间其**待办/审批自动转派代理人**（可按类型/范围限定），到期**自动回退**；全程留痕。供各模块复用（如 M6 交付负责人/Secondary 休假顶岗、审批人缺席）。 | P1 |

## 验收标准（关键）
- 纳管审批场景 100% 走统一 Request 入口发起（旁路发起数=0），全程留痕。
- 审批链可配为串行/并行/条件分支；条件命中时路由到对应审批人的正确率=100%（如金额>阈值走 VP，阈值目标值待业务确认）。
- ARR 驱动核定：申请值≤档位上限走常规核定、>上限触发更高层特批率=100%（档位数值目标值待业务确认）；核定通过 100% 生成对应（虚拟）Contract/Quota。
- Automations 触发→动作执行成功率=100%（状态变更/到期提醒等按规则触发，误触发数=0），可被各模块复用。
- 设置缺席期后，待办/审批在期内自动转派指定代理人率=100%、到期自动回退；委托与代办操作留痕（审计）齐全率=100%。

## 遗留待确认
- 各审批场景的审批链定义（谁审、阈值、分支）。
- ARR 档位具体数值（配置化，待业务确认）。
- 与飞书原生审批的联动边界。