# 受控文档三权流转控制完善（审核/批准/归档/重开 + 锁定期补充消化）

> 落地版 · `task_id=doc-review-lifecycle-2026-09-25` · 2026-09-25

## 1. 目标

在既有四态状态机（`drafting→reviewing→approving→approved`）上补齐四条缺口，不重造状态机：

| ID | 缺口 | 处理 |
|---|---|---|
| G1 | 锁定期补充误生成提案后卡死 | 积压账本 + `skipped_locked` |
| G2 | 职责人流转零通知 | 生命周期事件 + 收件人按槽位路由 |
| G3 | 批注不落库 / 权限过宽 | 阶段化矩阵 + resolve API + 前端落库 |
| G4 | 重开无 UI / 审批人仅创建人 | Approver 优先 + 创建人兜底 + 前端入口 |

## 2. 状态机（语义不变，正交积压）

```mermaid
stateDiagram-v2
    drafting --> reviewing : submit_review
    reviewing --> approving : review_approve
    reviewing --> drafting : review_reject
    approving --> approved : approver_approve
    approving --> reviewing : approver_reject
    approving --> drafting : approver_reject
    approved --> drafting : reopen_approve
```

积压表 `document_pending_supplements`（goose `00073`）独立于 `document_records` 状态列。回 drafting 时 `DigestPendingOnReturnToDrafting` 标记 digested 并通知 author。

## 3. 锁定期补充闭环

1. `CreateFromSupplement`：`LockedSnapshot = IsLocked || state != drafting`；`BusySnapshot` 仍为编辑租约。
2. `Decide`：锁定项 → `OutcomeSkippedLocked` + `PendingLedger.Record` + 知会当前职责人（reviewing→reviewer，approving/approved→approver，缺位→author）。
3. 回 drafting（驳回/重开）→ 消化积压 + `pending_supplements` digest。

## 4. 流转通知收件人

| 事件 | 收件人 |
|---|---|
| `document.review_requested` | ReviewerID |
| `document.approval_requested` | ApproverID |
| `document.rejected` / `reopened` / `pending_supplements` | AuthorID |
| `document.approved` | AuthorID |

`docnotify.RecipientForDocEvent` 统一解析；lifecycle hook 在 `SubmitForReview` / `Review*` / `Approver*` / `ReopenForRevision` 成功后触发。

## 5. 批注权限矩阵

| 状态 | 可新增批注 |
|---|---|
| drafting | author, reviewer |
| reviewing | reviewer, author（回应） |
| approving | approver, reviewer |
| approved | 禁止新增（`ErrDocumentLocked`） |
| viewer | 恒只读 |

`POST /api/v1/docgov/comments/{id}/resolve`：author 在 drafting 可 resolved；reviewer 可 reopen。

## 6. 重开审批

`handleProjectTraceReopenApprove`：文档 `ApproverID` 且成员仍 active → 可批；全部批准人缺位/退出 → 项目创建人兜底。前端 approved 态提供「申请再修订」。

## 7. 明确不做

- 不新增第五状态、不改 `IsLocked` 语义、不引入批量审批委托、不动 FAV 归档链路。