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

> 需求来源：`../demand/功能需求说明/仪陇表务管理系统-PRD-04-功能需求说明-02-*.md`  
> 数据模型：见 [数据库设计-V1.0.md](../数据库设计-V1.0.md)  
> 接口约定：见 [接口文档-V1.0.md](../接口文档-V1.0.md)、[00-总体框架设计-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](../数据库设计-V1.0.md)；实现时遵循 `java6/java-ylsw-bw.md` 与 `database-design.mdc`（`wssmet_*` 表名），**不参照**存量业务表与接口。*