ylsw-bw/business/water-meter/doc/demand/功能需求说明/仪陇表务管理系统-PRD-04-功能需求说明-01-工单中心-V1.0.md

源文件：仪陇表务管理系统-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 §6（无本地工单表）
接口约定：见本文 §接口设计（研发）、仪陇表务-公共接口说明-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 实体实现。*

---

接口设计（研发）

本模块接口见 公共接口说明 §2 工单中心。