# 仪陇表务 — 功能设计 01 工单中心 V1.0

> 需求来源：`../demand/功能需求说明/仪陇表务管理系统-PRD-04-功能需求说明-01-*.md`  
> 数据模型：见 [数据库设计-V1.0.md](../数据库设计-V1.0.md) §6（**无本地工单表**）  
> 接口约定：见 [接口文档-V1.0.md](../接口文档-V1.0.md)、[00-总体框架设计-V1.0.md](../00-总体框架设计-V1.0.md)

## 1. 模块概述

| 项 | 说明 |
|----|------|
| 模块序号 | 01 |
| 模块名称 | 工单中心 |
| 后端包（建议） | `com.tofly.wm.workorder`（薄封装，委托 workflow） |
| 业务模式 | 嵌入平台 **workflow** 审批引擎 |
| 本地库表 | **无**；待办/已办/流程定义在 workflow |

## 2. 功能范围

- 工作空间、待我处理、已处理的、我发起的、抄送我的
- 工单台账、工单管理、工单配置、组件管理（均复用 workflow UI/API）

## 3. 数据模型

### 3.1 涉及表

本模块**不在表务库建表**。各业务「申请」主表（如 `wssmet_purapply_w`）保存：

- `process_instance_id` — 流程实例
- `work_order_code` — 工单编号
- `approve_status` — 审批状态

### 3.2 与业务模块关系

| 工单类型（workflow） | 业务表 | 模块 |
|---------------------|--------|------|
| 采购申请 | `wssmet_purapply_w` | 03 采购 |
| 领用申请 | `wssmet_claimapply_w` | 06 领取 |
| 调拨申请 | `wssmet_transferapply_w` | 07 调拨 |
| 换表申请 | `wssmet_replaceapply_w` | 15 换表 |
| 争议检定申请 | `wssmet_disverifyapply_w` | 09 争议检定 |
| 迁表申请 | `wssmet_relocateapply_w` | 16 迁表 |
| 拆表申请 | `wssmet_removeapply_w` | 18 拆表 |
| 营业所退库 | `wssmet_retstnapply_w` | 13 退库 |
| 退回总仓 | `wssmet_rethqapply_w` | 13 退库 |
| 报废申请 | `wssmet_scrapapply_w` | 21 报废 |

## 4. 业务流程

PRD：复用 workflow；业务申请保存后发起流程；办理界面展示**业务只读区**（字段由各 PRD-04 模块定义）+ 审批操作区。

## 5. 核心业务规则

- 待办按当前节点处理人（岗位/人员）匹配
- 通过后执行各模块「审核通过后数据影响」（见对应功能设计）
- 抄送工单只读、不可办理

## 6. 接口设计（概要）

| 能力 | 说明 |
|------|------|
| 待办/已办/我发起/抄送 | 调用 **workflow** 标准 API（表务侧可做 BFF 聚合） |
| 办理 | workflow 提交审批；回调或事件同步 `approve_status` 到业务表 |
| 工单台账 | workflow 全量查询 + 业务单号 `work_order_code` 关联 |

返回体（表务 BFF）：`ResultResponse<T>`。

## 7. 权限与数据范围

遵循 PRD-02：菜单角色 + 组织数据权限 + 工单节点岗位权限。

## 8. 上下游依赖

| 上游 | 下游 |
|------|------|
| 各业务申请模块发起流程 | 审批通过后驱动计划/任务/出入库（各 PRD-04） |

---

*本设计仅依据 `../demand/` PRD；**不参照**存量工单表与 `WorkOrder` 实体实现。*