zkxw/docs/superpowers/specs/2026-07-15-oa-return-copy-new-instance-design.md

OA 打回/拒绝/撤销：终态 + 复制表单开新实例（钉钉对齐修订）

项	内容
状态	已定稿；实现已落地（见 docs/superpowers/plans/2026-07-15-oa-return-copy-new-instance.md）
日期	2026-07-15
范围	打回语义、复制再发、审批进度去重、「已处理」列表、废弃同实例多轮与旧单关联
权威对齐	钉钉：打回 / 撤销 / 拒绝均终结当前审批单；再办 = 复制表单开新实例
关联	废止并取代 2026-07-15-oa-approval-progress-timeline-design.md 中 §3.3 同实例多轮、§4.3 多轮轴、§5.2 P1 同单再提交与「关联旧单」；保留该文 P0 进度树序与拒绝≠打回文案约定

---

1. 背景

实现 P1「同实例打回再提交 + 多轮进度 + sourceInstanceId 关联」后，产品实测发现：

1. 已处理列表看不到打回记录（done 查询未含 returned）。
   
2. 进度轴出现审批人节点 + 独立「打回」节点双重展示，多余。
   
3. 对照钉钉：打回、撤销都会终结当前单；再办是复制一份开新实例，无需同单多轮，也无需强制关联旧单。

本文件按钉钉模式修订产品语义，并作为后续实现权威来源。

---

2. 目标与非目标

目标

• 打回 / 拒绝 / 撤销 = 本单终态（不再同实例复活）。
  
• 三种终态下，发起人均可 「复制并重新发起」：仅复制表单（及可复用的发起选人等），开启全新实例。
  
• 新旧实例不写库关联（不使用 / 不依赖 source_instance_id 展示跳转）。
  
• 进度单轴、无「第 N 轮」；打回结果落在审批人任务节点上。
  
• 「已处理」含打回。

非目标

• 不在详情展示「由旧单重提」跳转链。
  
• 不做钉钉全量操作类型复刻。
  
• 不强制物理删除已有 source_instance_id / current_round / oa_instance_event 列或表（可保留兼容；业务路径不再依赖多轮 resubmit）。

---

3. 三种终态（SHALL）

动作	操作者	本单状态	进度终态文案（建议）	再办
打回	审批人	returned（展示：已打回）	审批人节点「已打回」+ 意见；不追加独立终态「已打回」行	复制表单 → 新实例
拒绝	审批人	rejected（已拒绝）	审批人「已拒绝」+「流程结束（已拒绝）」	同上
撤销	发起人	cancelled（已撤销）	「已撤销」	同上

3.1 禁止

• 不得将打回做成同实例 running/returned 后再 resubmit 开第二轮。
  
• 不得把拒绝叫做打回，或把打回做成拒绝而不标 returned。
  
• 不得在新实例强制写入「来源旧单」业务关联并在 UI 展示跳转（本版本）。
  
• 不得在进度中同时展示「审批人（已打回）」与独立的 kind=return「打回」节点。

3.2 打回引擎行为（修订）

审批人打回且意见必填时：

1. 当前审批任务 → returned，写入意见与完成时间。
   
2. 同实例其余 pending 任务 → cancelled。
   
3. 实例 → returned（终态，不可再同单提交）。
   
4. 可继续写 oa_instance_event（审计可选）；进度投影不得再追加独立打回节点。

3.3 复制并重新发起（SHALL）

• 入口：我发起的列表、实例详情；当状态 ∈ {returned, cancelled, rejected} 且当前用户为发起人。
  
• 文案：统一「复制并重新发起」（取代「修改并再次提交」「修改并重新提交」）。
  
• 行为：携带旧单 appId + 表单快照（及发起页需要的选人等）进入发起流；用户确认后 POST start，得到新 instanceId。
  
• 传输：可用路由 query 如 copyFromInstanceId（仅前端预填，不入新实例关联字段）。若需后端预填接口，只读返回旧单 formData，不写 source_instance_id。
  
• SHALL NOT 调用同实例 resubmit_instance。

---

4. 审批进度（修订）

4.1 仍生效（来自原 P0）

• 节点顺序：流程树序 → order_num → create_time → id。
  
• 含发起人「已提交」、任务节点、抄送、进行中的未到达；终态后不挂未达节点。

4.2 废止

• 「第 N 轮」分段标题与多轮 submit 轴。
  
• build_progress_items 中对 event_type=return 追加的独立 kind=return 项。

4.3 打回进度示意

发起人 · 已提交
抄送人 · 已结束（抄送）
审批人 · 已打回 · 意见：…

拒绝 / 撤销示意不变（单轴终态），无旧单关联提示。

---

5. 列表与文案

场景	规则
已处理	kind=done 含 approved / rejected / returned
我发起的	returned 展示「已打回」（不用「待修改」）
详情状态	同上

---

6. 对既有实现的处置

能力	处置
POST /instances/{id}/resubmit	移除或返回明确废弃错误；前端不再调用
start(..., sourceInstanceId) 写库关联 + 详情「查看原单」	停止写入与展示；copyFrom 仅预填
current_round / 任务 round_no 多轮逻辑	业务路径不再递增多轮；字段可保留默认 1
设计器 allowReturn	保留（控制是否出现打回按钮）

---

7. 验收要点

• 打回后实例为终态「已打回」，不能同单再次提交。
  
• 打回后进度仅审批人节点显示已打回+意见，无独立「打回」节点、无「第 N 轮」。
  
• 审批人「已处理」可见该打回任务。
  
• 已打回 / 已撤销 / 已拒绝：发起人可「复制并重新发起」，得到新实例且表单已预填；新旧无关联跳转。
  
• 拒绝与打回按钮/结果文案互不混用。

---

8. 决议记录

日期	决议
2026-07-15	产品确认：对齐钉钉；打回=终态；再办=复制开新单；三种终态均可复制；不做旧单关联。
2026-07-15	废止同实例多轮与独立打回进度节点；修复已处理未含 returned。