# 仪陇表务管理系统 — 字典与枚举说明 V1.0

> **依据**：`../demand/` PRD-01～04、[数据库设计-V1.0.md](./数据库设计-V1.0.md) §2.1 与 DDL COMMENT。  
> **字典**：平台字典服务维护，Java 侧 `DictEntry` + `@DictDirectory(目录码)`；**枚举**：Java `*Enum implements Enumerable`，存库值为 `code` 列。  
> **说明**：存量 Java 中部分枚举类名/取值与设计期命名略有差异（如 `ArriveStateEnum` ↔ 设计 `ArriveStatusEnum`），实现时以本表为准统一。

## 1. 字典目录

### 1.1 METER_DIAMETER（口径）

| 编码 | 名称 | 说明 |
|------|------|------|
| DN15 | DN15 | 公称口径 15mm |
| DN20 | DN20 | 公称口径 20mm |
| DN25 | DN25 | 公称口径 25mm |
| DN32 | DN32 | 公称口径 32mm |
| DN40 | DN40 | 公称口径 40mm |
| DN50 | DN50 | 公称口径 50mm |
| DN65 | DN65 | 公称口径 65mm |
| DN80 | DN80 | 公称口径 80mm |
| DN100 | DN100 | 公称口径 100mm |
| DN150 | DN150 | 公称口径 150mm |
| DN200 | DN200 | 公称口径 200mm |

### 1.2 METER_TYPE（水表类型）

| 编码 | 名称 | 说明 |
|------|------|------|
| mechanical | 机械表 | 普表/机械式 |
| iot | 物联网表 | 远传/智能表 |
| ultrasonic | 超声波表 | 超声波计量 |
| electromagnetic | 电磁表 | 电磁流量计类 |

### 1.3 METER_IN_STOCK_ATTR（入库库存属性）

| 编码 | 名称 | 说明 |
|------|------|------|
| brand_new | 全新 | 新表首次入库 |
| old | 旧表 | 拆下或退回的旧表 |
| overdue | 超期 | 达到轮换/报废周期 |
| pending_verify | 待检定 | 待送检或待检定 |
| dispute_unqualified | 争议检定不合格 | 争议检定不合格退回 |

### 1.4 METER_RETURN_REASON（退回/返厂原因）

| 编码 | 名称 | 说明 |
|------|------|------|
| first_unqualified | 首检不合格 | 落地检不合格返厂 |
| expire_unqualified | 到期检不合格 | 到期检定不合格 |
| dispute_unqualified | 争议检定不合格 | 争议检定不合格 |
| damage | 表体损坏 | 表体物理损坏 |
| other | 其他 | 其他原因 |

### 1.5 METER_PURPOSE（领用用途）

| 编码 | 名称 | 说明 |
|------|------|------|
| new_install | 新装 | 新用户安装 |
| replace | 换表 | 换表领用 |
| rotate | 轮换 | 到期轮换 |
| verify | 检定 | 检定相关领用 |
| other | 其他 | 其他用途 |

### 1.6 METER_DISPOSE_TYPE（检定后处置类型）

| 编码 | 名称 | 说明 |
|------|------|------|
| return_factory | 返厂 | 不合格返厂 |
| scrap | 报废 | 报废处置 |
| continue_use | 继续使用 | 合格继续流转 |
| replace_new | 更换新表 | 不合格换表 |

### 1.7 METER_DISPUTE_REASON（争议检定原因）

| 编码 | 名称 | 说明 |
|------|------|------|
| reading_dispute | 读数争议 | 抄见读数争议 |
| meter_fault | 表计故障 | 用户反映表计异常 |
| billing_dispute | 计费争议 | 水量/计费争议 |
| other | 其他 | 其他争议原因 |

### 1.8 METER_VERIFY_REASON（其他检定原因）

| 编码 | 名称 | 说明 |
|------|------|------|
| user_apply | 用户申请 | 用户主动申请检定 |
| spot_check | 抽检 | 管理抽检 |
| complaint | 投诉复核 | 投诉触发 |
| other | 其他 | 其他检定原因 |

### 1.9 METER_VERIFY_ATTR（检定属性/类型）

| 编码 | 名称 | 说明 |
|------|------|------|
| first | 首检/落地检 | 到货落地检 |
| expire | 到期检 | 周期到期检定 |
| dispute | 争议检 | 争议检定 |
| other | 其他检 | 其他检定登记 |

### 1.10 METER_RETURN_HQ_TAG（退回总仓标识）

| 编码 | 名称 | 说明 |
|------|------|------|
| yes | 是 | 需退回总公司总仓 |
| no | 否 | 留在分公司处置 |

### 1.11 METER_REPLACE_REASON（换表原因）

| 编码 | 名称 | 说明 |
|------|------|------|
| fault | 表计故障 | 表计损坏/故障 |
| expire | 到期轮换 | 到期强制轮换 |
| user_apply | 用户申请 | 用户申请换表 |
| reading_abnormal | 读数异常 | 读数/计量异常 |
| other | 其他 | 其他原因 |

### 1.12 METER_RELOCATE_REASON（迁表原因）

| 编码 | 名称 | 说明 |
|------|------|------|
| user_apply | 用户申请 | 用户要求迁表 |
| road_work | 道路施工 | 市政施工迁改 |
| meter_box_move | 表位调整 | 表箱/表位变更 |
| other | 其他 | 其他原因 |

### 1.13 METER_REMOVE_REASON（拆表原因）

| 编码 | 名称 | 说明 |
|------|------|------|
| stop_supply | 停水销户 | 用户销户停水 |
| verify | 送检拆表 | 检定/争议检拆表 |
| replace | 换表拆表 | 换表前拆旧表 |
| rotate | 轮换拆表 | 到期轮换拆表 |
| other | 其他 | 其他原因 |

### 1.14 METER_SCRAP_REASON（报废原因）

| 编码 | 名称 | 说明 |
|------|------|------|
| expire | 超期报废 | 达到报废年限 |
| unqualified | 检定不合格 | 检定不合格无法修复 |
| damage | 损坏报废 | 表体严重损坏 |
| lost | 遗失 | 水表遗失 |
| other | 其他 | 其他原因 |

### 1.15 METER_SAMPLE_MODE（周期检查抽检方式）

| 编码 | 名称 | 说明 |
|------|------|------|
| ratio | 按比例抽检 | 按配置比例抽取 |
| full | 全检 | 任务内全部检查 |
| random | 随机抽检 | 随机抽取 |

### 1.16 METER_ILLEGAL_USE（违规用水类型）

| 编码 | 名称 | 说明 |
|------|------|------|
| none | 无 | 未发现违规 |
| bypass | 私接旁路 | 私接旁路用水 |
| reverse | 倒装 | 水表倒装 |
| tamper | 破坏铅封 | 破坏铅封/表计 |
| other | 其他 | 其他违规情形 |

### 1.17 METER_READING_COMPARE（读数比对结果）

| 编码 | 名称 | 说明 |
|------|------|------|
| match | 一致 | 现场读数与系统一致 |
| higher | 现场偏大 | 现场读数大于系统 |
| lower | 现场偏小 | 现场读数小于系统 |
| unreadable | 无法抄见 | 无法读取 |

### 1.18 平台扩展字典（工单，非 §2.1 库列）

| 目录码 | 名称 | 说明 |
|--------|------|------|
| METER_JJCD | 工单紧急程度 | 采购/表务工单紧急度 |
| METER_ORDER_TYPE | 表务工单类型 | workflow 工单类型分类 |

---

## 2. 业务枚举

> 表格列：**枚举常量**（Java 枚举名）、**存储值**（`code`/`getKey()`）、**含义**（界面展示 `label`）。

### 2.1 ApproveStatusEnum（审批状态）

| 枚举常量 | 存储值 | 含义 |
|----------|--------|------|
| DRAFT | draft | 草稿 |
| PENDING | pending | 审批中 |
| APPROVED | approved | 已通过 |
| REJECTED | rejected | 已驳回 |
| CANCELLED | cancelled | 已撤销 |

### 2.2 ProcessStatusEnum（采购流程状态）

| 枚举常量 | 存储值 | 含义 |
|----------|--------|------|
| NOT_STARTED | not_started | 未开始 |
| IN_PROGRESS | in_progress | 进行中 |
| COMPLETED | completed | 已完成 |
| TERMINATED | terminated | 已终止 |

### 2.3 ArriveStatusEnum（到货状态）

> 存量代码类名 `ArriveStateEnum`。

| 枚举常量 | 存储值 | 含义 |
|----------|--------|------|
| NOT_ARRIVE | not_arrive | 未到货 |
| PARTIAL_ARRIVE | partial_arrive | 部分到货 |
| ARRIVED | arrived | 已到货 |

### 2.4 MeterStatusEnum（水表状态）

| 枚举常量 | 存储值 | 含义 |
|----------|--------|------|
| PENDING_LAND_VERIFY | pending_land_verify | 待落地检 |
| PENDING_SEAL_BIND | pending_seal_bind | 待铅封号绑定 |
| FIRST_VERIFY_UNQUALIFIED | first_verify_unqualified | 首检不合格 |
| RETURN_FACTORY | return_factory | 返厂 |
| HQ_IN_STOCK | hq_in_stock | 总公司在库 |
| HQ_NEW_OUT | hq_new_out | 总仓新表出库 |
| BRANCH_IN_STOCK | branch_in_stock | 分公司在库 |
| BRANCH_NEW_IN_STOCK | branch_new_in_stock | 分仓新表在库 |
| IN_USE | in_use | 在用 |
| EXPIRE_VERIFY_UNQUALIFIED | expire_verify_unqualified | 到期检不合格 |
| VERIFYING | verifying | 检定中 |
| SCRAPPED | scrapped | 已报废 |
| LOST | lost | 遗失 |

### 2.5 MeterLifeEventTypeEnum（生命周期事件类型）

| 枚举常量 | 存储值 | 含义 |
|----------|--------|------|
| ARRIVE | arrive | 到货登记 |
| LAND_VERIFY | land_verify | 落地检 |
| SEAL_BIND | seal_bind | 铅封绑定 |
| HQ_IN | hq_in | 总仓入库 |
| HQ_OUT | hq_out | 总仓出库 |
| BRANCH_IN | branch_in | 分仓入库 |
| BRANCH_OUT | branch_out | 分仓出库 |
| INSTALL | install | 安装挂接 |
| EXPIRE_VERIFY | expire_verify | 到期检定 |
| DISPUTE_VERIFY | dispute_verify | 争议检定 |
| REMOVE | remove | 拆表 |
| RETURN | return | 退库 |
| ROTATE | rotate | 轮换 |
| SCRAP | scrap | 报废 |

### 2.6 WarehouseTypeEnum（仓库类型）

| 枚举常量 | 存储值 | 含义 |
|----------|--------|------|
| HQ | hq | 总公司总仓 |
| BRANCH | branch | 分公司分仓 |
| STATION | station | 营业所/供水站 |

### 2.7 CommonStatusEnum（启用状态）

| 枚举常量 | 存储值 | 含义 |
|----------|--------|------|
| ENABLED | enabled | 启用 |
| DISABLED | disabled | 停用 |

### 2.8 CycleRuleTypeEnum（周期规则类型）

| 枚举常量 | 存储值 | 含义 |
|----------|--------|------|
| VERIFY | verify | 检定周期 |
| ROTATE | rotate | 轮换周期 |
| SCRAP | scrap | 报废周期 |

### 2.9 VerifyResultEnum（检定结果）

| 枚举常量 | 存储值 | 含义 |
|----------|--------|------|
| QUALIFIED | qualified | 合格 |
| UNQUALIFIED | unqualified | 不合格 |

### 2.10 VerifyStatusEnum（检定状态）

| 枚举常量 | 存储值 | 含义 |
|----------|--------|------|
| PENDING | pending | 待检定 |
| COMPLETED | completed | 检定完成 |
| QUALIFIED | qualified | 合格 |
| UNQUALIFIED | unqualified | 不合格 |

### 2.11 RegisterStatusEnum（登记状态）

| 枚举常量 | 存储值 | 含义 |
|----------|--------|------|
| NOT_REGISTERED | not_registered | 未登记 |
| REGISTERED | registered | 已登记 |

### 2.12 InboundStatusEnum（入库状态）

| 枚举常量 | 存储值 | 含义 |
|----------|--------|------|
| PENDING | pending | 待入库 |
| COMPLETED | completed | 已入库 |

### 2.13 OutboundStatusEnum（出库状态）

| 枚举常量 | 存储值 | 含义 |
|----------|--------|------|
| PENDING | pending | 待出库 |
| COMPLETED | completed | 已出库 |

### 2.14 TaskStatusEnum（任务状态）

| 枚举常量 | 存储值 | 含义 |
|----------|--------|------|
| DRAFT | draft | 草稿 |
| PENDING | pending | 待执行 |
| IN_PROGRESS | in_progress | 执行中 |
| COMPLETED | completed | 已完成 |
| OVERDUE | overdue | 已逾期 |
| CLOSED | closed | 已关闭 |

### 2.15 ExecNodeEnum（现场执行节点）

| 枚举常量 | 存储值 | 含义 |
|----------|--------|------|
| REMOVE | remove | 拆表 |
| SEND_HQ | send_hq | 送总公司 |
| VERIFY | verify | 检定 |
| PICKUP | pickup | 取回 |
| INSTALL | install | 安装 |
| BRANCH_IN | branch_in | 分仓入库 |
| CLAIM_NEW | claim_new | 领用新表 |

### 2.16 ExecProgressEnum（争议检定执行进度）

| 枚举常量 | 存储值 | 含义 |
|----------|--------|------|
| PENDING_SEND_HQ | pending_send_hq | 待送总公司 |
| HQ_PENDING_VERIFY | hq_pending_verify | 总公司待检定 |
| VERIFY_QUALIFIED | verify_qualified | 已检定合格 |
| VERIFY_UNQUALIFIED | verify_unqualified | 检定不合格 |
| COMPLETED | completed | 已完成 |

### 2.17 RecordStatusEnum（检定记录状态）

| 枚举常量 | 存储值 | 含义 |
|----------|--------|------|
| PENDING | pending | 待同步 |
| SYNCED | synced | 已同步 |
| FAILED | failed | 同步失败 |

### 2.18 InboundTypeEnum（入库类型）

| 枚举常量 | 存储值 | 含义 |
|----------|--------|------|
| INITIAL_INBOUND | initial_inbound | 初始化入库 |
| NEW_METER_INBOUND | new_meter_inbound | 新表入库 |
| OLD_METER_INBOUND | old_meter_inbound | 旧表入库 |
| ALLOCATION_INBOUND | allocation_inbound | 分配入库 |
| RETURN_INBOUND | return_inbound | 退回入库 |
| TRANSFER_INBOUND | transfer_inbound | 调拨入库 |
| CLAIM_INBOUND | claim_inbound | 领用入库 |
| CROSS_BRANCH_TRANSFER_IN | cross_branch_transfer_in | 跨分公司调拨入库 |
| BRANCH_RETURN_IN | branch_return_in | 营业所退库入库 |

### 2.19 OutboundTypeEnum（出库类型）

| 枚举常量 | 存储值 | 含义 |
|----------|--------|------|
| LOST_OUTBOUND | lost_outbound | 遗失出库 |
| WASTE_METER_OUTBOUND | waste_meter_outbound | 废表出库 |
| RETURN_OUTBOUND | return_outbound | 返厂出库 |
| INSTALL_OUTBOUND | install_outbound | 安装出库 |
| TRANSFER_OUTBOUND | transfer_outbound | 调拨出库 |
| RETURN_TO_MASTER_OUTBOUND | return_to_master_outbound | 返回总仓 |
| NEW_METER_CLAIM_OUTBOUND | new_meter_claim_outbound | 新表领用出库 |
| REPLACE_OUTBOUND | replace_outbound | 换表出库 |
| CROSS_BRANCH_TRANSFER_OUT | cross_branch_transfer_out | 跨分公司调拨出库 |
| SCRAP_DISPOSE_OUT | scrap_dispose_out | 报废水表处置出库 |

### 2.20 ConfirmStatusEnum（总仓入库确认状态）

| 枚举常量 | 存储值 | 含义 |
|----------|--------|------|
| PENDING | pending | 待确认 |
| CONFIRMED | confirmed | 已确认 |
| REJECTED | rejected | 已拒收 |

### 2.21 HqInboundStatusEnum（总仓入库状态）

| 枚举常量 | 存储值 | 含义 |
|----------|--------|------|
| PENDING | pending | 待总仓入库 |
| COMPLETED | completed | 已总仓入库 |

### 2.22 TaskSourceEnum（任务来源）

| 枚举常量 | 存储值 | 含义 |
|----------|--------|------|
| APPLY | apply | 申请审批通过自动生成 |
| MANUAL | manual | 手工派单 |
| SYSTEM | system | 系统自动生成 |

### 2.23 AcceptResultEnum（安装验收结果）

| 枚举常量 | 存储值 | 含义 |
|----------|--------|------|
| PASSED | passed | 验收通过 |
| FAILED | failed | 验收不通过 |

### 2.24 ReplaceTypeEnum（换表类型）

| 枚举常量 | 存储值 | 含义 |
|----------|--------|------|
| PLANNED | planned | 计划换表 |
| EMERGENCY | emergency | 紧急换表 |
| FAULT | fault | 故障换表 |
| EXPIRE | expire | 到期换表 |

### 2.25 ReturnStatusEnum（拆表退库状态）

| 枚举常量 | 存储值 | 含义 |
|----------|--------|------|
| NOT_RETURNED | not_returned | 未退库 |
| RETURNING | returning | 退库中 |
| RETURNED | returned | 已退库 |

### 2.26 CollectStatusEnum（旧表回收状态）

| 枚举常量 | 存储值 | 含义 |
|----------|--------|------|
| PENDING | pending | 待回收 |
| COLLECTED | collected | 已回收 |
| LOST | lost | 遗失 |

### 2.27 RotateStatusEnum（轮换明细状态）

| 枚举常量 | 存储值 | 含义 |
|----------|--------|------|
| PENDING | pending | 待轮换 |
| COMPLETED | completed | 已完成 |

### 2.28 InspectStatusEnum（周期检查明细状态）

| 枚举常量 | 存储值 | 含义 |
|----------|--------|------|
| PENDING | pending | 待检查 |
| COMPLETED | completed | 已完成 |

### 2.29 RunStatusEnum（运行状态）

| 枚举常量 | 存储值 | 含义 |
|----------|--------|------|
| NORMAL | normal | 正常 |
| ABNORMAL | abnormal | 异常 |

### 2.30 BodyStatusEnum（表体状态）

| 枚举常量 | 存储值 | 含义 |
|----------|--------|------|
| GOOD | good | 完好 |
| DAMAGED | damaged | 损坏 |

### 2.31 SealStatusEnum（铅封状态）

| 枚举常量 | 存储值 | 含义 |
|----------|--------|------|
| INTACT | intact | 完好 |
| BROKEN | broken | 破损 |

### 2.32 LeakStatusEnum（渗漏状态）

| 枚举常量 | 存储值 | 含义 |
|----------|--------|------|
| NONE | none | 无渗漏 |
| LEAK | leak | 有渗漏 |

### 2.33 DisposeStatusEnum（报废处置状态）

| 枚举常量 | 存储值 | 含义 |
|----------|--------|------|
| PENDING | pending | 待处置 |
| DISPOSED | disposed | 已处置 |

---

## 3. 与数据库 §2.1 对照

| §2.1 类型 | 说明列 | 引用列 | 取值明细 |
|-----------|--------|--------|----------|
| 字典 | 字段业务含义 | 目录码（如 `METER_DIAMETER`） | 本文 §1 对应小节 |
| 枚举 | 字段业务含义 | Java 枚举类名 | 本文 §2 对应小节 |

维护约定：新增/变更字典项或枚举值时，**同步更新**本文与 [数据库设计-V1.0.md](./数据库设计-V1.0.md) §2.1、DDL `COMMENT ON COLUMN`。