> **源文件**：仪陇表务管理系统-PRD-04-功能需求说明-01-工单中心-V1.0.docx > **导出时间**：2026-05-26 10:34 **仪陇表务管理系统 产品需求说明书 04-功能需求说明 工单中心** 文档版本：V1.0 对应 01 版本：仪陇表务管理系统-PRD-01-总体说明-V1.0 模块序号：01 模块名称：工单中心 ## 工单中心 本模块嵌入 workflow 审批引擎，承载全系统申请类业务的待办、已办、我发起、抄送及工单台账、流程配置等能力，对应《PRD-01》工单中心模块。含 Web 菜单：工作空间、待我处理、已处理的、我发起的、抄送我的、工单台账、工单管理、工单配置、组件管理；各业务模块发起的采购/领用/调拨/报废等申请工单在本模块统一办理。 ### **工作空间** #### 功能描述 承载工单审批工作空间入口，提供流程概览、快捷导航及待办汇总，为各岗位人员提供工单办理统一入口。 #### 菜单权限 表务系统管理员；表务总公司管理人员；表务水表采购；表务水表管理中心；表务分公司管理人员；表务分公司库管员；表务营业办/供水站管理人员；表务营业办/供水站职员 #### 数据权限 各角色按上述数据权限查看本人相关汇总数据。 #### 核心逻辑 复用 workflow 工作空间组件；待办数量与各业务模块推送的工单实时同步。 #### 功能需求 ##### **一级页面：工作空间** #整体布局 -- 复用 workflow 工作空间；顶部待办统计卡片 + 快捷入口（待我处理、我发起的、抄送我的） -- 展示当前用户待办数量、近期工单动态摘要 #交互说明 -- 点击待办卡片跳转「待我处理」菜单 -- 点击快捷入口跳转对应工单列表菜单 ### **待我处理** #### 功能描述 集中展示当前用户待审批、待办理的工单任务，提供待办提醒、审批处理及进度查看能力。 #### 菜单权限 表务系统管理员；表务总公司管理人员；表务水表采购；表务水表管理中心；表务分公司管理人员；表务分公司库管员；表务营业办/供水站管理人员；表务营业办/供水站职员 #### 数据权限 待我处理、已处理的：可见、可操作当前用户作为处理人（待办）或已办理过的工单数据。 #### 核心逻辑 以工单表为查询主体；当前节点处理人匹配当前登录用户岗位/人员。 #### 功能需求 ##### **一级页面：待我处理** #整体布局 -- 复用 workflow 待我处理列表；查询区 + 待办工单列表 #查询条件 -- 工单编号：文本，模糊搜索 -- 工单类型：下拉（全部、采购申请、领用申请、调拨申请、报废申请、换表申请等） -- 提交时间：日期范围 -- 功能按钮：查询、重置 #数据列表 -- 表格字段：工单编号、工单类型、业务单号、发起人、发起部门、当前节点、提交时间、等待时长 -- 行内操作：办理、详情 #交互说明 -- 点击「办理」或工单编号打开「二级页面：工单办理」 -- 点击「详情」打开「弹窗：工单只读详情」 ##### **二级页面：工单办理** #整体布局 -- 全屏二级页；分区：业务申请信息只读区（按工单类型动态表单）、业务明细只读区、审批记录区、当前环节操作区 #信息展示 -- 申请信息区：展示关联业务单全部字段（采购/领用/调拨/报废等由业务模块定义） -- 明细区：展示业务明细表格（如有） -- 审批记录：时间轴展示各环节处理人、结果、意见、时间 -- 审核意见：多行文本；驳回时必填 #底部按钮 -- 通过：校验后提交，流转至下一环节或完结 -- 驳回：须填写审核意见，按环节说明表退回指定环节 -- 转办 / 加签：按 workflow 标准能力（若流程配置启用） #交互说明 -- 办理完成后返回「待我处理」并刷新列表 -- 通过后按各业务模块「业务流程 · 审核通过后数据影响」更新业务数据 -- 本页为各业务申请类工单审核的标准办理界面；业务差异在各业务模块「审核界面说明」中描述 ##### **弹窗：工单只读详情** #弹窗类型 -- 抽屉弹窗（右侧）；遮罩：有 #信息展示 -- 只读展示申请信息、明细、审批记录；无通过/驳回按钮 #底部按钮 -- 关闭；去处理：仅当前用户为当前节点处理人且工单审批中时显示，跳转「二级页面：工单办理」 ### **已处理的** #### 功能描述 复用【workflow/已处理的】；归档或展示当前用户已办理的工单记录，支持查询与详情查看。 #### 菜单权限 表务系统管理员；表务总公司管理人员；表务水表采购；表务水表管理中心；表务分公司管理人员；表务分公司库管员；表务营业办/供水站管理人员；表务营业办/供水站职员 #### 数据权限 待我处理、已处理的：可见、可操作当前用户作为处理人（已办）或已办理过的工单数据。 #### 核心逻辑 复用 workflow 标准列表与详情；详情可跳转「弹窗：工单只读详情」；抄送工单不可办理。 #### 功能需求 ##### **一级页面：已处理的** #整体布局 -- 复用【workflow/已处理的】标准列表页 #查询条件 -- 工单编号、工单类型、时间范围；功能按钮：查询、重置 #数据列表 -- 字段与待我处理列表一致（抄送我的无办理操作） #交互说明 -- 打开「弹窗：工单只读详情」；我发起的支持撤销（流程配置允许且未进入不可逆节点时） ### **我发起的** #### 功能描述 复用【workflow/我发起的】；归档或展示当前用户发起的工单记录，支持查询与详情查看。 #### 菜单权限 表务系统管理员；表务总公司管理人员；表务水表采购；表务水表管理中心；表务分公司管理人员；表务分公司库管员；表务营业办/供水站管理人员；表务营业办/供水站职员 #### 数据权限 我发起的：可见、可操作当前登录账号作为发起人的工单数据。 #### 核心逻辑 复用 workflow 标准列表与详情；详情可跳转「弹窗：工单只读详情」；抄送工单不可办理。 #### 功能需求 ##### **一级页面：我发起的** #整体布局 -- 复用【workflow/我发起的】标准列表页 #查询条件 -- 工单编号、工单类型、时间范围；功能按钮：查询、重置 #数据列表 -- 字段与待我处理列表一致（抄送我的无办理操作） #交互说明 -- 打开「弹窗：工单只读详情」；我发起的支持撤销（流程配置允许且未进入不可逆节点时） ### **抄送我的** #### 功能描述 复用【workflow/抄送我的】；归档或展示当前用户抄送的工单记录，支持查询与详情查看。 #### 菜单权限 表务系统管理员；表务总公司管理人员；表务水表采购；表务水表管理中心；表务分公司管理人员；表务分公司库管员；表务营业办/供水站管理人员；表务营业办/供水站职员 #### 数据权限 抄送我的：可见当前用户被抄送的工单（只读，不可办理）。 #### 核心逻辑 复用 workflow 标准列表与详情；详情可跳转「弹窗：工单只读详情」；抄送工单不可办理。 #### 功能需求 ##### **一级页面：抄送我的** #整体布局 -- 复用【workflow/抄送我的】标准列表页 #查询条件 -- 工单编号、工单类型、时间范围；功能按钮：查询、重置 #数据列表 -- 字段与待我处理列表一致（抄送我的无办理操作） #交互说明 -- 打开「弹窗：工单只读详情」；我发起的支持撤销（流程配置允许且未进入不可逆节点时） ### **工单台账** #### 功能描述 集中管理全量工单数据，提供多条件查询、筛选、汇总统计及明细导出，支持合规核查与管理统计。 #### 菜单权限 表务系统管理员；表务总公司管理人员；表务系统管理员；表务总公司管理人员；表务水表采购；表务水表管理中心；表务分公司管理人员；表务分公司库管员；表务营业办/供水站管理人员；表务营业办/供水站职员 #### 数据权限 工单台账、工单管理：表务系统管理员、表务总公司管理人员可见全公司工单；其他角色按所属部门及管辖部门过滤工单申请人部门。 #### 核心逻辑 复用 workflow 数据统计能力；数据范围按组织层级过滤。 #### 功能需求 ##### **一级页面：工单台账** #整体布局 -- 复用 workflow 数据统计/工单台账；多条件查询 + 全量工单列表 + 导出 #查询条件 -- 工单编号、工单类型、工单状态、发起人、发起部门、提交时间范围 -- 功能按钮：查询、重置、导出 #数据列表 -- 表格字段：工单编号、工单类型、业务单号、发起人、发起部门、工单状态、当前节点、提交时间、完结时间 #交互说明 -- 支持汇总统计视图切换（按类型、状态）；导出 Excel ### **工单管理** #### 功能描述 提供全量工单运维管理能力，支持工单状态监控、异常干预及数据统计，供系统管理员统筹监管。 #### 菜单权限 表务系统管理员；表务总公司管理人员 #### 数据权限 表务系统管理员、表务总公司管理人员：可见、可操作全公司范围内工单运维数据。 #### 核心逻辑 复用 workflow 数据统计（管理视图）；支持工单异常干预（按引擎能力）。 #### 功能需求 ##### **一级页面：工单管理** #整体布局 -- 复用 workflow 管理视图；工单运行监控 + 异常工单列表 #交互说明 -- 与工单台账数据同源，侧重运维监控指标展示 ### **工单配置** #### 功能描述 统一配置各业务审批规则，提供流程、节点、处理岗位及启停策略自定义能力。 #### 菜单权限 表务系统管理员；开发人员 #### 数据权限 表务系统管理员、开发人员：可见、可操作全公司范围内工单配置与组件数据。 #### 核心逻辑 复用 workflow 模型管理；流程与业务工单类型绑定；节点处理人按岗位配置。 #### 功能需求 ##### **一级页面：工单配置** #整体布局 -- 复用 workflow 模型管理；流程列表 + 流程设计入口 #交互说明 -- 配置变更影响后续新发起工单；已运行工单按原流程版本完结 ### **组件管理** #### 功能描述 承载工单表单自定义组件的开发与维护，供开发人员注册组件、管理员在流程配置中引用。 #### 菜单权限 表务系统管理员；开发人员 #### 数据权限 表务系统管理员、开发人员：可见、可操作全公司范围内工单配置与组件数据。 #### 核心逻辑 复用 workflow 组件管理；组件版本与流程表单引用关系由引擎维护。 #### 功能需求 ##### **一级页面：组件管理** #整体布局 -- 复用 workflow 组件管理；组件列表 + 注册/编辑 #交互说明 -- 仅开发人员维护组件代码；管理员在工单配置中选择已发布组件 --- ## 详细设计（研发） > 以下内容合并自 `design/功能设计/`，与 PRD 需求章节配套使用。数据模型详见 `design/数据库设计-V1.0.md`。 ### 仪陇表务-功能设计-01-工单中心-V1.0 # 仪陇表务 — 功能设计 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](../../design/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）：须为具体泛型，见 [公共接口说明](./仪陇表务-公共接口说明-V1.0.md)（**禁止** `ResultResponse`）。 ## 7. 权限与数据范围 遵循 PRD-02：菜单角色 + 组织数据权限 + 工单节点岗位权限。 ## 8. 上下游依赖 | 上游 | 下游 | |------|------| | 各业务申请模块发起流程 | 审批通过后驱动计划/任务/出入库（各 PRD-04） | --- *本设计仅依据 `../demand/` PRD；**不参照**存量工单表与 `WorkOrder` 实体实现。* --- ## 接口设计（研发） 本模块接口见 [公共接口说明](./仪陇表务-公共接口说明-V1.0.md) §2 工单中心。