b14425da5a
支持办理人/主管转交运维段任务并记录原因；待审批与审批中可进费用明细但运维费用只读，审批完成不可进入。 Co-authored-by: Cursor <cursoragent@cursor.com>
7.8 KiB
7.8 KiB
还车应结款 · 运维部转交 设计规格
| 项 | 说明 |
|---|---|
| 日期 | 2026-07-22 |
| 状态 | 已确认 |
| 方案 | 方案 A：费用明细「运维部」卡片内单笔转交 |
| 关联原型 | vehicle-return-settlement；业务主实现复用 oneos-web-finance 还车应结款费用明细 |
| 主改文件 | src/prototypes/oneos-web-finance/pages/03-还车应结款.jsx |
1. 问题与目标
运维部人员处理还车应结款运维段时，存在两类卡住场景：
- 无法及时处理：当前办理人短期无法完成填写/提交，需把任务交给同事继续。
- 人员离职：原办理人账号停用或人已离开后，运维段无法由他人合法撤回、编辑，任务悬挂。
本期目标
- 在运维部费用明细段提供 转交办理人 能力。
- 当前办理人可主动转交；运维主管可代转（覆盖离职/无人处理）。
- 转交只换办理人，不改已填费用与整单审批流；改内容仍走既有撤回规则。
- 转交原因必填，并留下可查操作记录。
非目标（本期不做）
- 列表批量转交、操作列快捷转交
- 独立「转交台 / 待处理转交」页面
- 其他部门（业管 / 能源 / 安全）转交
- 真实组织人事同步、账号停用自动触发转交
- 真实消息通知（可本地 Toast + 记录演示）
2. 方案选择
| 方案 | 说明 | 结论 |
|---|---|---|
| A. 费用明细运维卡片内转交 | 与保存/提交/撤回同工作面 | 采用 |
| B. 列表批量 + 明细单笔 | 离职清多笔快，交互与权限更重 | 二期候选 |
| C. 主管独立转交台 | 主管视角清晰，新产品面 | 二期候选 |
3. 权限与状态规则
3.1 谁可发起
| 角色 | 能力 |
|---|---|
当前办理人（opsHandler） |
可将本单运维段转给其他运维同事 |
| 运维主管 | 可代转任意未禁止状态下的运维段（含原办理人已非在职） |
| 其他角色 / 非办理人非主管 | 无「转交」入口 |
3.2 转交对象
- 仅 运维部在职同事
- 排除：自己、已停用账号、非运维人员
- 选择器支持姓名模糊搜索
3.3 何时可转
| 维度 | 允许 | 禁止 |
|---|---|---|
| 运维段状态 | 待提交、已提交 | — |
| 整单审批状态 | 待提交、待审批、审批中、审批驳回、撤回 | 审批完成 |
说明：待审批 / 审批中仍可转交——只换办理人，不改已填内容、不改整单审批节点。
3.3.1 费用明细入口与运维段可编辑性（相对现网调整）
相对现网「待审批 / 审批中 / 审批完成不显示费用明细」：
| 顺序 | 条件 | 费用明细入口 | 运维段费用编辑 | 运维转交 |
|---|---|---|---|---|
| 1 | 整单待提交 / 审批驳回 / 撤回等（费用明细本就可进） | 显示 | 按运维段状态：待提交可编；已提交须先撤回再编 | 办理人/主管可转 |
| 2 | 整单 待审批 / 审批中 | 显示，不限角色（任何人可点进查看） | 不可编辑（保存/提交/撤回隐藏或禁用；表格只读） | 办理人/主管仍可转交 |
| 3 | 整单 审批完成 | 不显示（或只读查看若产品另有查看页） | — | 无转交 |
要改审批中的运维费用内容：须先按现有规则 整单撤回，回到可编辑的整单状态后，再由当前办理人编辑。
3.4 转交效果与改内容
| 顺序 | 条件 | 结果 |
|---|---|---|
| 1 | 转交成功 | 更新 opsHandler 为新办理人；写转交记录；Toast 成功 |
| 2 | 转交时运维段已提交 | 不自动撤回；status / 历史提交人姓名保持 |
| 3 | 整单待审批 / 审批中 | 转交可用；运维费用只读；不可部门撤回改数 |
| 4 | 新办理人要改费用（整单未在审批中） | 若段状态为已提交 → 先走运维部 撤回，再编辑保存/提交 |
| 5 | 整单在审批中要改费用 | 先 整单撤回，再进入费用明细编辑 |
| 6 | 整单审批完成 | 无转交按钮 |
3.5 原因
- 必填转交原因（多行文本）
- 空原因不可确认转交
4. 信息架构与交互
4.1 入口
费用明细页 → 运维部卡片标题栏右侧：
| 场景 | 可见操作（在权限内） |
|---|---|
| 整单可编 + 运维待提交 | 保存、提交、转交 |
| 整单可编 + 运维已提交 | 撤回、转交 |
| 整单待审批 / 审批中 | 费用只读；无保存/提交/撤回；办理人/主管可见 转交 |
| 整单审批完成 | 无转交 |
列表页：
- 待审批 / 审批中：显示「费用明细」（不限角色），与现网「隐藏」不同，以本规格为准
- 运维组办理人展示随
opsHandler更新 - 不增加列表「转交」操作、不做批量
4.2 转交弹窗
- 标题：转交运维办理人
- 当前办理人：只读
- 新办理人：必选下拉（运维在职、可搜索、排除自己）
- 转交原因：必填多行
- 取消 / 确认转交
- 确认前二次说明：确认后将由【新办理人】继续处理本单运维段
成功后：关闭弹窗；头部办理人即时更新；若当前用户已不再是办理人且非主管，操作区按权限收敛。
4.3 转交记录
每笔至少记录：时间、操作人、原办理人、新办理人、原因、当时运维段状态、当时整单审批状态。
费用明细运维卡片提供「转交记录」入口（时间线或抽屉即可）。
5. 数据模型
| 字段 | 说明 |
|---|---|
opsHandler |
当前办理人（权威）。初始可由还车人 returnPerson 带入；转交只改本字段，不改历史还车人 |
submitOperation.status |
运维段提交状态（待提交 / 已提交等既有口径） |
submitOperation.name |
最近一次提交人；转交不覆盖；新人再次提交时再更新 |
opsTransferLogs[] |
转交记录数组（见 4.3） |
列表「运维组」办理人解析：读 opsHandler，不再直接绑死 returnPerson。
原型演示：本地状态/种子即可，未接真实 API；组织人员用本地运维同事清单模拟。
6. 落地范围
| 项 | 路径 / 说明 |
|---|---|
| 主实现 | src/prototypes/oneos-web-finance/pages/03-还车应结款.jsx（费用明细运维段 + 列表 resolveDeptHandler） |
| 薄壳对齐 | src/prototypes/vehicle-return-settlement/ 办理预览若展示运维操作，对齐转交入口（轻量） |
| 业务规格 | src/prototypes/vehicle-return-settlement/.spec/ops-transfer.md |
| AutoPRD | .spec/requirements-prd.md + annotation-source.json + src/resources/prd/vehicle-return-settlement-autoprd.md（若约定存在则同步） |
7. 验收要点
- 办理人可把待提交单转给同事，原因必填，列表办理人变为新人。
- 已提交单可转交；新人可撤回后编辑再提交。
- 主管可代转「非本人」的运维段任务。
- 整单待审批 / 审批中：列表可进费用明细（不限角色）；运维费用只读不可编；办理人/主管仍可转交；费用与审批流不变。
- 审批完成后无转交按钮。
- 不可转给自己或非运维人员；原因为空不可提交。
- 转交记录可查（时间、人、原因、状态快照）。
8. 决策摘要（对齐记录）
| 决策点 | 结论 |
|---|---|
| 发起人 | 当前办理人 + 运维主管 |
| 可转状态（部门段） | 待提交 + 已提交 |
| 整单审批中 | 仍可转，只换人；费用明细可进（不限角色）；运维段不可编辑 |
| 接收人 | 仅运维部在职同事 |
| 原因 | 必填 |
| 交互方案 | A：费用明细卡片内单笔转交 |