福建水务营收系统-表务模块正文

系统设计团队

2024年12月19日

1 福建水务营收系统详细设计-表务模块正文

1.1 章节导航(精简)

1.2 文档定位

本文档为 01_Detailed_Design.md 中“表务详细设计”章节的模块正文拆分稿,便于按模块独立维护。正式交付口径以主详设为准。

2 表务详细设计

2.1 表务模块统一约束

  1. 表务模块负责水表档案、状态、库存、工单与物联网接入,账单生成仍归属 SYS-002 营收主流程。
  2. 水表状态变更必须通过表务工单、出入库动作或报装装表流程驱动,不允许绕过业务过程直接改写生命周期状态。
  3. 换表、移表、拆表、复装完成后,必须同步客户绑定关系、安装位置和最新表计状态,避免档案与现场状态不一致。
  4. 库存、出入库、报废等动作必须具备批次追溯与操作留痕,满足审计与责任界定要求。
  5. 远传抄表与设备告警数据进入 SYS-002 后,必须先完成校验和异常判断,再进入抄表开账链路。

2.2 接口与数据追溯矩阵

说明:接口字段以 ../03_Technical_Design/03_Interface_Design.md 为准,数据库口径以 ../03_Technical_Design/01_Database_Design.md 为准。

METER 模块 关键接口 核心数据域(摘要) 主要协同对象
METER-001 表务基础管理 IF-METER-001 biz_meterbiz_meter_modelbiz_meter_caliberbiz_meter_range 营收、报装
METER-002 仓库与库存管理 IF-METER-003 biz_meter_in_outbiz_meter_in_out_relbiz_meter 仓储管理端
METER-003 设备档案管理 IF-METER-001IF-METER-002IF-METER-004 biz_meterbiz_meter_logbiz_process*biz_meter_readbiz_reading_databiz_last_reading 工单系统、移动作业、IoT 平台、营收开账

2.3 METER-001 表务基础管理

2.3.1 功能说明

管理水表档案、厂家、型号、口径、量程、检定证书、安装位置、当前状态等基础信息。

2.3.2 关键设计

2.3.3 核心数据

2.3.4 接口映射

2.3.5 落地边界

2.4 METER-002 仓库与库存管理

2.4.1 功能说明

管理新表入库、领用、出库、退库、报废及库存预警,是架构图中“仓库与库存管理”模块的正式承接章节。

2.4.2 关键设计

  1. 库存动作以批次和明细双层结构记录,支持领用、退库、报废等全过程追溯。
  2. 库存状态与设备生命周期联动更新,避免“账上在库、现场在用”不一致。
  3. 报废、退库等高风险动作需保留审批或责任人留痕。

2.4.3 核心数据

2.4.4 接口映射

2.4.5 落地边界

2.5 METER-003 设备档案管理

2.5.1 功能说明

管理水表唯一电子档案、状态流转、安装历史、质检追溯,并统一承接表务工单和物联网同步相关能力。

2.5.2 关键设计

  1. 一块水表对应唯一档案主记录,覆盖在库、在用、待检、故障、报废等状态。
  2. 设备档案同时关联安装历史、维修记录、库存动作与最近有效读数,形成全生命周期追溯闭环。
  3. 表务工单和远传同步能力属于设备档案管理下的实施态支撑能力,不再作为独立模块编号表达。

2.5.3 核心数据

2.5.4 接口映射

2.5.5 落地边界

2.5.6 物联网接入与数据同步能力

2.5.7 功能说明

接入集抄系统、智能表平台及厂家物联网平台,实现远程抄表、状态查询、设备参数同步与异常告警。

2.5.8 业务流程

flowchart TD
    A[定时采集任务] --> B[发送采集请求]
    B --> C[物联网平台返回数据]
    C --> D[数据校验]
    D --> E{是否有效}
    E -->|有效| F[写入抄表记录]
    E -->|无效| G[异常标记并告警]
    F --> H[参与开账]
    G --> I[人工复核处理]

2.5.9 关键规则

  1. 远传抄表结果必须校验设备标识、采集时间、读数合法性和重复上送情况。
  2. 异常读数、离线状态、设备告警需区分业务异常与设备异常两类处理。
  3. 校验通过的有效读数进入抄表开账链路,异常结果需保留人工复核入口。

2.5.10 核心数据

2.5.11 接口映射

2.5.12 落地边界

2.5.13 表务工单协同能力

处理换表、移表、拆表、复装、校表、稽查、维修等表务工单,是 METER-003 设备档案管理的实施态过程能力。

2.5.13.1 业务流程

flowchart TD
    A[创建表务工单] --> B[派发现场任务]
    B --> C[现场处理并采集结果]
    C --> D[回写旧表/新表信息]
    D --> E[更新水表状态与客户绑定]
    E --> F[写入过程日志与附件]
    F --> G[工单办结]

2.5.13.2 关键规则

  1. 工单类型决定必填字段、处理流程和附件要求。
  2. 换表工单需同时记录旧表拆除信息与新表安装信息。
  3. 工单完成后同步更新设备档案、客户绑定关系与安装历史。