ylsw-bw/business/water-meter/doc/design/功能设计/仪陇表务-功能设计-02-水表台账-V1.0.md

# 仪陇表务 — 功能设计 02 水表台账 V1.0

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

1. 模块概述

项	说明
模块序号	02
模块名称	水表台账
后端包（建议）	com.tofly.wm.ledger
业务模式	只读查询
工单	无

2. 功能范围

• 水表查询
• 采购台账
• 检定台账
• 入出库台账(总仓/分仓)
• 安装/换表/周检/轮换/报废台账

3. 数据模型

3.1 涉及表

• wssmet_meter_w
• wssmet_meterlife_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. 业务流程

跨业务表聚合查询与导出；生命周期时间轴来自 LIFECYCLE。

5. 核心业务规则

• 出厂编码唯一
• 数据权限按管辖组织

6. 接口设计（概要）

方法	路径（示例前缀）	说明
—	/ledger/meter/page	见 PRD 界面
—	/ledger/purchase/page	见 PRD 界面
—	/ledger/verify/page	见 PRD 界面
—	—	…各台账 /export

• 标准 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_` 表名），不参照存量业务表与接口。*