字典与枚举说明-V1.0.md 16 KB

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

依据../demand/ PRD-01~04、数据库设计-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 §2.1、DDL COMMENT ON COLUMN