ylsw-bw/business/water-meter/doc/demand/功能需求说明/仪陇表务管理系统-PRD-04-功能需求说明-14-安装管理-V1.0.md

源文件：仪陇表务管理系统-PRD-04-功能需求说明-14-安装管理-V1.0.docx 导出时间：2026-05-26 10:34

仪陇表务管理系统 产品需求说明书 04-功能需求说明 安装管理

文档版本：V1.0

对应 01 版本：仪陇表务管理系统-PRD-01-总体说明-V1.0

模块序号：14

模块名称：安装管理

安装管理

本模块覆盖用户水表新装报装对接、出库领表、安装任务派单、现场安装及验收全链路。含 Web「安装任务管理」及 App「安装任务」「安装验收」。对应《PRD-03》水表新安装业务流程；出库在「出库管理」办理，报装数据可对接报装系统。

安装任务管理

功能描述

统筹新装安装任务调度，支持审批通过自动派单、管理人员直接派单及报装事件驱动。任务下发至 App「安装任务」执行，验收在 App「安装验收」完成。

菜单权限

表务营业办/供水站管理人员；表务分公司管理人员；表务水表管理中心；表务系统管理员

数据权限

表务营业办/供水站管理人员：可见、可操作本营业办（或本供水站）范围内安装任务。

表务分公司管理人员：可见、可操作本分公司及下属营业办、供水站范围内安装任务。

表务水表管理中心、表务系统管理员：可见全公司安装任务（管理员可操作）。

核心逻辑

本菜单实现《PRD-03》水表新安装业务流程中「安装工单派单」环节操作界面。

任务须关联已新装出库水表及计划用户信息；派单后推送至安装员 App。

现场数据录入与匹配校验在 App 完成；验收通过后联动台账「在用」。

功能需求

一级页面：安装任务管理

#整体布局

-- 上下结构：查询条件区 + 任务列表；顶部「新建任务」「批量派单」

#查询条件

-- 任务编号、安装合同编号、用户编号/名称：文本，模糊搜索

-- 任务状态：下拉（全部、待派单、待接单、待安装、待验收、已完成、已关闭）

-- 计划安装人、所属营业办/供水站：下拉

-- 申请日期：日期范围

-- 功能按钮：查询、重置

#数据列表

-- 表格字段：任务编号、来源（报装/工单通过/直接派单）、安装合同号、计划用户编号、安装地址、执行人、任务状态、创建时间

-- 行内操作：详情、派单、关闭（按状态与权限显示）

#交互说明

-- 新建/派单打开「弹窗：新建/派单安装任务」

-- 详情打开「弹窗：安装任务详情」

-- 换表/领用工单审批通过后可自动生成待派单任务；报装系统事件可推送待派单记录

弹窗：新建/派单安装任务

#弹窗类型

-- 居中弹窗；遮罩：有

#信息展示

-- 任务来源：单选（直接派单、关联已通过新装领用工单、关联报装合同）

-- 安装合同编号：选填（报装/合同模式必填）

-- 出库水表编号：必填，须为已新装出库状态

-- 计划安装用户编号、安装地址：必填

-- 计划安装人：必填，人员选择（安装员）

-- 备注：选填

#底部按钮

-- 保存并派单：生成任务并推送 App；取消

#交互说明

-- 派单成功后任务状态为「待接单」，安装员 App 可见

弹窗：安装任务详情

#弹窗类型

-- 抽屉弹窗（右侧）；只读为主

#信息展示

-- 任务信息、合同信息、出库水表、计划/实际用户编号、不匹配原因、验收结论、台账状态

#底部按钮

-- 关闭；派单/关闭任务（有权限且状态允许时）

安装任务（App）

功能描述

安装员接收任务、现场安装、录入数据并提交，支撑新装现场作业与户表匹配校验。

菜单权限

表务营业办/供水站职员（安装员岗位）

数据权限

表务营业办/供水站职员：仅可见、可操作指派给本人的安装任务。

核心逻辑

对应《PRD-03》现场安装与数据录入、系统自动匹配校验环节。

功能需求

一级页面：安装任务列表（App）

#整体布局

-- 移动端列表页；默认展示本人待办/进行中任务

#页面标题

-- 安装任务

#数据列表

-- 列表项：任务编号、用户地址、计划用户、状态、计划安装时间

-- 行内操作：接单、进入作业（已接单）

#交互说明

-- 接单后打开「二级页面：安装任务详情（App）」

二级页面：安装任务详情（App）

#整体布局

-- 顶部信息区 + 中部表单 + 底部提交

#页面标题

-- 安装任务详情

#信息展示

-- 只读：任务编号、合同号、计划用户编号、安装地址、出库水表编号

-- 必填：实际安装用户编号、安装现场信息、安装时间

-- 拍照留痕：至少 1 张现场照片

-- GPS 定位：自动采集（可选手工确认）

#底部按钮

-- 提交安装数据；保存草稿

#交互说明

-- 提交后系统自动比对计划用户编号与实际用户编号；不一致须填写不匹配原因方可进入验收

-- 提交成功后任务状态为「待验收」，推送验收人员

安装验收（App）

功能描述

专项验收人员现场核查安装质量及户表匹配，提交验收结论并驱动台账更新。

菜单权限

表务营业办/供水站职员（验收岗位）

数据权限

表务营业办/供水站职员：可见、可操作指派给本人的验收任务。

核心逻辑

对应《PRD-03》现场安装验收与台账自动更新环节。

功能需求

一级页面：安装验收列表（App）

#整体布局

-- 待验收任务列表

#页面标题

-- 安装验收

#数据列表

-- 任务编号、地址、安装人、提交时间；操作：进入验收

二级页面：安装验收填报（App）

#整体布局

-- 只读安装信息 + 验收结论区

#信息展示

-- 展示水表编号、计划/实际用户编号、不匹配原因（如有）

-- 验收结论：必填，通过/不通过

-- 验收备注：不通过时必填

#底部按钮

-- 提交验收

#交互说明

-- 通过后系统更新水表状态为「在用」，回写出库/任务/台账；不通过退回整改

---

详细设计（研发）

以下内容合并自 design/功能设计/，与 PRD 需求章节配套使用。数据模型详见 design/数据库设计-V1.0.md。

仪陇表务-功能设计-14-安装管理-V1.0

# 仪陇表务 — 功能设计 14 安装管理 V1.0

需求来源：../demand/功能需求说明/仪陇表务管理系统-PRD-04-功能需求说明-14-*.md
数据模型：见 数据库设计-V1.0.md
接口约定：见本文 §接口设计（研发）、仪陇表务-公共接口说明-V1.0.md、00-总体框架设计-V1.0.md

1. 模块概述

项	说明
模块序号	14
模块名称	安装管理
后端包（建议）	com.tofly.wm.manage.install
业务模式	任务+App
工单	无（任务）

2. 功能范围

• 安装任务管理
• App 安装
• App 验收

3. 数据模型

3.1 涉及表

• wssmet_installtask_w
• wssmet_installrec_w
• wssmet_installaccept_w

3.2 实体约定

• 所有实体 extends BaseEntity；逻辑删除 Boolean deleted ↔ deleted。
• 字典 DictEntry + @DictDirectory(MeterConstant.*) ↔ 库列 VARCHAR2；组织/用户 OrganizationEntry/UserNameEntry ↔ 库列 NUMBER(19)；附件 FileEntryList/FileEntry 用 @TableField(exist = false)，无库列。
• 申请类主表含 process_instance_id / work_order_code / approve_status；工单反查 （无本地表，见 workflow）.TABLE_NAME + TABLE_ID。

4. 业务流程

报装/派单→新装出库→现场安装→户表校验→验收→在用。

5. 核心业务规则

• 计划/实际用户编号校验
• 验收通过后更新 Meter

6. 接口设计（概要）

方法	路径（示例前缀）	说明
—	/installTask/	见 PRD 界面
—	/installTask/dispatch	见 PRD 界面

• 标准 CRUD 另含：GET /page、GET /list、POST /update、DELETE /{id}、DELETE /deleteByIds。
• 返回体：须为带具体泛型的 ResultResponse<...>，见下文 §接口设计（研发）各接口出参（禁止 T/Vo 占位）。

7. 权限与数据范围

遵循 PRD-02：菜单角色 + 组织数据权限 + 工单岗位权限；具体角色见 PRD-04 各功能「菜单权限」「数据权限」章节。

8. 上下游依赖

上游	下游
见 PRD-03 流程说明	见 PRD-01 总体主流程

---

本设计仅依据 ../demand/ PRD 与 数据库设计-V1.0.md；实现时遵循 java6/java-ylsw-bw.md 与 database-design.mdc（`wssmet_` 表名），不参照存量业务表与接口。*

---

接口设计（研发）

统一前缀：/api/wm/manage/install；各接口 出参 须为具体泛型（见下文，禁止 T/Vo 占位）；公共约定见 仪陇表务-公共接口说明-V1.0.md。

新装安装任务-分页查询

项	内容
接口说明	分页查询新装安装任务
请求地址	GET /api/wm/manage/install/installTask/page
请求类型	GET

入参（Query（PageQuery））

字段	类型	说明
taskCode	String	任务编号
taskSourceCode	String（枚举 code）	任务来源
contractNo	String	合同
meterCode	String	水表表号
planUserNo	String	计划用户
installAddress	String	安装地址
taskStatusCode	String（枚举 code）	任务状态
remark	String	备注

出参

• ResultResponse>

外层包装 ResultResponse 含 code、message、data，见 公共接口说明 §1.3。

data（PageInfo）字段

InstallTaskVo 字段

字段	类型	说明
pageNum	Integer	当前页码
pageSize	Integer	每页条数
total	Long	总记录数
pages	Integer	总页数
list	List	当前页数据列表

字段	类型	说明
id	String	主键
taskCode	String	任务
taskSourceCode	String（枚举 code）	任务来源
contractNo	String	合同
meterId	Long	水表ID，关联wssmet_meter_w表的id字段
meterCode	String	水表表号
planUserNo	String	计划用户
installAddress	String	安装地址
executorId	Long	执行人ID，关联tf_user表的id字段
taskStatusCode	String（枚举 code）	任务状态
outRecordId	Long	出库主单ID，关联wssmet_invout_w表的id字段
applyId	Long	领用申请ID，关联wssmet_claimapply_w表的id字段
remark	String	备注

新装安装任务-列表查询

项	内容
接口说明	列表查询新装安装任务
请求地址	GET /api/wm/manage/install/installTask/list
请求类型	GET

入参（Query）

字段	类型	说明
taskCode	String	任务编号
taskSourceCode	String（枚举 code）	任务来源
contractNo	String	合同
meterCode	String	水表表号
planUserNo	String	计划用户
installAddress	String	安装地址
taskStatusCode	String（枚举 code）	任务状态
remark	String	备注

出参

• ResultResponse>

外层包装 ResultResponse 含 code、message、data，见 公共接口说明 §1.3。

data（List）元素字段

InstallTaskVo 字段

字段	类型	说明
id	String	主键
taskCode	String	任务
taskSourceCode	String（枚举 code）	任务来源
contractNo	String	合同
meterId	Long	水表ID，关联wssmet_meter_w表的id字段
meterCode	String	水表表号
planUserNo	String	计划用户
installAddress	String	安装地址
executorId	Long	执行人ID，关联tf_user表的id字段
taskStatusCode	String（枚举 code）	任务状态
outRecordId	Long	出库主单ID，关联wssmet_invout_w表的id字段
applyId	Long	领用申请ID，关联wssmet_claimapply_w表的id字段
remark	String	备注

新装安装任务-详情

项	内容
接口说明	查询新装安装任务详情
请求地址	GET /api/wm/manage/install/installTask/{id}
请求类型	GET

入参（Path: id）

字段	类型	说明
id	String	主键

出参

• ResultResponse（含明细 list 若适用）

外层包装 ResultResponse 含 code、message、data，见 公共接口说明 §1.3。

data（InstallTaskVo）字段

InstallTaskVo 字段

字段	类型	说明
id	String	主键
taskCode	String	任务
taskSourceCode	String（枚举 code）	任务来源
contractNo	String	合同
meterId	Long	水表ID，关联wssmet_meter_w表的id字段
meterCode	String	水表表号
planUserNo	String	计划用户
installAddress	String	安装地址
executorId	Long	执行人ID，关联tf_user表的id字段
taskStatusCode	String（枚举 code）	任务状态
outRecordId	Long	出库主单ID，关联wssmet_invout_w表的id字段
applyId	Long	领用申请ID，关联wssmet_claimapply_w表的id字段
remark	String	备注

新装安装任务-新增

项	内容
接口说明	新增新装安装任务
请求地址	POST /api/wm/manage/install/installTask/
请求类型	POST

入参（Body: Dto）

字段	类型	说明
taskCode	String	任务编号
taskSourceCode	String（枚举 code）	任务来源
contractNo	String	合同
meterId	Long	水表ID，关联wssmet_meter_w表的id字段
meterCode	String	水表表号
planUserNo	String	计划用户
installAddress	String	安装地址
executorId	Long	执行人ID，关联tf_user表的id字段
taskStatusCode	String（枚举 code）	任务状态
outRecordId	Long	出库主单ID，关联wssmet_invout_w表的id字段
applyId	Long	领用申请ID，关联wssmet_claimapply_w表的id字段
remark	String	备注

出参

• ResultResponse

data 字段

字段	类型	说明
id	Long	新增记录主键

新装安装任务-修改

项	内容
接口说明	修改新装安装任务
请求地址	POST /api/wm/manage/install/installTask/update
请求类型	POST

入参（Body: Dto（含 id））

字段	类型	说明
taskCode	String	任务编号
taskSourceCode	String（枚举 code）	任务来源
contractNo	String	合同
meterId	Long	水表ID，关联wssmet_meter_w表的id字段
meterCode	String	水表表号
planUserNo	String	计划用户
installAddress	String	安装地址
executorId	Long	执行人ID，关联tf_user表的id字段
taskStatusCode	String（枚举 code）	任务状态
outRecordId	Long	出库主单ID，关联wssmet_invout_w表的id字段
applyId	Long	领用申请ID，关联wssmet_claimapply_w表的id字段
remark	String	备注

出参

• ResultResponse

data 无业务字段（null）。

新装安装任务-删除

项	内容
接口说明	逻辑删除新装安装任务（支持批量）
请求地址	DELETE /api/wm/manage/install/installTask/deleteByIds?ids=1,2
请求类型	DELETE

入参（Query: ids）

字段	类型	说明
ids	String	主键，逗号分隔

出参

• ResultResponse

data 无业务字段（null）。

安装验收

项	内容
接口说明	新装验收登记
请求地址	POST /api/wm/manage/install/installAccept/
请求类型	POST

入参（Body: Dto）

字段	类型	说明
taskId	Long	新装安装任务ID，关联wssmet_installtask_w表的id字段
acceptResultCode	String（枚举 code）	验收
acceptRemark	String	验收备注
acceptorId	Long	验收人ID，关联tf_user表的id字段
acceptorName	String	验收人
acceptTime	DateTime	验收时间

出参

• ResultResponse

data 无业务字段（null）。