ylsw-bw/business/water-meter/doc/design/功能设计/仪陇表务-功能设计-15-换表管理-V1.0.md

# 仪陇表务 — 功能设计 15 换表管理 V1.0

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

1. 模块概述

项	说明
模块序号	15
模块名称	换表管理
后端包（建议）	com.tofly.wm.manage.replace
业务模式	申请工单+任务
工单	REPLACE_APPLY

2. 功能范围

• 换表申请
• 换表任务
• App 换表

3. 数据模型

3.1 涉及表

• wssmet_replaceapply_w
• wssmet_replaceapplylist_w
• wssmet_replacetask_w
• wssmet_replacerec_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. 核心业务规则

• 零散换表必填计划用户编号
• 户表不一致须原因

6. 接口设计（概要）

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

• 标准 CRUD 另含：GET /page、GET /list、POST /update、DELETE /{id}、DELETE /deleteByIds。
• 返回体：ResultResponse<T>。

7. 权限与数据范围

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

8. 上下游依赖

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

---

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