fujian_water_biz_doc/output/14_METER_Detailed.html

382 lines
19 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml" lang="" xml:lang="">
<head>
<meta charset="utf-8" />
<meta name="generator" content="pandoc" />
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes" />
<meta name="author" content="系统设计团队" />
<title>福建水务营收系统-表务模块正文</title>
<style>
code{white-space: pre-wrap;}
span.smallcaps{font-variant: small-caps;}
div.columns{display: flex; gap: min(4vw, 1.5em);}
div.column{flex: auto; overflow-x: auto;}
div.hanging-indent{margin-left: 1.5em; text-indent: -1.5em;}
/* The extra [class] is a hack that increases specificity enough to
override a similar rule in reveal.js */
ul.task-list[class]{list-style: none;}
ul.task-list li input[type="checkbox"] {
font-size: inherit;
width: 0.8em;
margin: 0 0.8em 0.2em -1.6em;
vertical-align: middle;
}
.display.math{display: block; text-align: center; margin: 0.5rem auto;}
</style>
<link rel="stylesheet" href="output/document_style.css" />
<meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0">
</head>
<body>
<header id="title-block-header">
<h1 class="title">福建水务营收系统-表务模块正文</h1>
<p class="author">系统设计团队</p>
<p class="date">2024年12月19日</p>
</header>
<nav id="TOC" role="doc-toc">
<ul>
<li><a href="#福建水务营收系统详细设计-表务模块正文"
id="toc-福建水务营收系统详细设计-表务模块正文"><span
class="toc-section-number">1</span>
福建水务营收系统详细设计-表务模块正文</a>
<ul>
<li><a href="#章节导航精简" id="toc-章节导航精简"><span
class="toc-section-number">1.1</span> 章节导航(精简)</a></li>
<li><a href="#文档定位" id="toc-文档定位"><span
class="toc-section-number">1.2</span> 文档定位</a></li>
</ul></li>
<li><a href="#表务详细设计" id="toc-表务详细设计"><span
class="toc-section-number">2</span> 表务详细设计</a>
<ul>
<li><a href="#表务模块统一约束" id="toc-表务模块统一约束"><span
class="toc-section-number">2.1</span> 表务模块统一约束</a></li>
<li><a href="#接口与数据追溯矩阵" id="toc-接口与数据追溯矩阵"><span
class="toc-section-number">2.2</span> 接口与数据追溯矩阵</a></li>
<li><a href="#meter-001-表务基础管理"
id="toc-meter-001-表务基础管理"><span
class="toc-section-number">2.3</span> METER-001 表务基础管理</a>
<ul>
<li><a href="#功能说明" id="toc-功能说明"><span
class="toc-section-number">2.3.1</span> 功能说明</a></li>
<li><a href="#关键设计" id="toc-关键设计"><span
class="toc-section-number">2.3.2</span> 关键设计</a></li>
<li><a href="#核心数据" id="toc-核心数据"><span
class="toc-section-number">2.3.3</span> 核心数据</a></li>
<li><a href="#接口映射" id="toc-接口映射"><span
class="toc-section-number">2.3.4</span> 接口映射</a></li>
<li><a href="#落地边界" id="toc-落地边界"><span
class="toc-section-number">2.3.5</span> 落地边界</a></li>
</ul></li>
<li><a href="#meter-002-仓库与库存管理"
id="toc-meter-002-仓库与库存管理"><span
class="toc-section-number">2.4</span> METER-002 仓库与库存管理</a>
<ul>
<li><a href="#功能说明-1" id="toc-功能说明-1"><span
class="toc-section-number">2.4.1</span> 功能说明</a></li>
<li><a href="#关键设计-1" id="toc-关键设计-1"><span
class="toc-section-number">2.4.2</span> 关键设计</a></li>
<li><a href="#核心数据-1" id="toc-核心数据-1"><span
class="toc-section-number">2.4.3</span> 核心数据</a></li>
<li><a href="#接口映射-1" id="toc-接口映射-1"><span
class="toc-section-number">2.4.4</span> 接口映射</a></li>
<li><a href="#落地边界-1" id="toc-落地边界-1"><span
class="toc-section-number">2.4.5</span> 落地边界</a></li>
</ul></li>
<li><a href="#meter-003-设备档案管理"
id="toc-meter-003-设备档案管理"><span
class="toc-section-number">2.5</span> METER-003 设备档案管理</a>
<ul>
<li><a href="#功能说明-2" id="toc-功能说明-2"><span
class="toc-section-number">2.5.1</span> 功能说明</a></li>
<li><a href="#关键设计-2" id="toc-关键设计-2"><span
class="toc-section-number">2.5.2</span> 关键设计</a></li>
<li><a href="#核心数据-2" id="toc-核心数据-2"><span
class="toc-section-number">2.5.3</span> 核心数据</a></li>
<li><a href="#接口映射-2" id="toc-接口映射-2"><span
class="toc-section-number">2.5.4</span> 接口映射</a></li>
<li><a href="#落地边界-2" id="toc-落地边界-2"><span
class="toc-section-number">2.5.5</span> 落地边界</a></li>
<li><a href="#物联网接入与数据同步能力"
id="toc-物联网接入与数据同步能力"><span
class="toc-section-number">2.5.6</span>
物联网接入与数据同步能力</a></li>
<li><a href="#功能说明-3" id="toc-功能说明-3"><span
class="toc-section-number">2.5.7</span> 功能说明</a></li>
<li><a href="#业务流程" id="toc-业务流程"><span
class="toc-section-number">2.5.8</span> 业务流程</a></li>
<li><a href="#关键规则" id="toc-关键规则"><span
class="toc-section-number">2.5.9</span> 关键规则</a></li>
<li><a href="#核心数据-3" id="toc-核心数据-3"><span
class="toc-section-number">2.5.10</span> 核心数据</a></li>
<li><a href="#接口映射-3" id="toc-接口映射-3"><span
class="toc-section-number">2.5.11</span> 接口映射</a></li>
<li><a href="#落地边界-3" id="toc-落地边界-3"><span
class="toc-section-number">2.5.12</span> 落地边界</a></li>
<li><a href="#表务工单协同能力" id="toc-表务工单协同能力"><span
class="toc-section-number">2.5.13</span> 表务工单协同能力</a>
<ul>
<li><a href="#业务流程-1" id="toc-业务流程-1"><span
class="toc-section-number">2.5.13.1</span> 业务流程</a></li>
<li><a href="#关键规则-1" id="toc-关键规则-1"><span
class="toc-section-number">2.5.13.2</span> 关键规则</a></li>
</ul></li>
</ul></li>
</ul></li>
</ul>
</nav>
<h1 data-number="1" id="福建水务营收系统详细设计-表务模块正文"><span
class="header-section-number">1</span>
福建水务营收系统详细设计-表务模块正文</h1>
<h2 data-number="1.1" id="章节导航精简"><span
class="header-section-number">1.1</span> 章节导航(精简)</h2>
<ul>
<li><a href="#sec-position">文档定位</a></li>
<li><a href="#sec-content">表务详细设计正文</a>
<ul>
<li><a href="#sec-meter-rules">表务模块统一约束</a></li>
<li><a href="#sec-meter-trace">接口与数据追溯矩阵</a></li>
<li><a href="#mod-meter-001">METER-001 表务基础管理</a></li>
<li><a href="#mod-meter-002">METER-002 仓库与库存管理</a></li>
<li><a href="#mod-meter-003">METER-003 设备档案管理</a></li>
</ul></li>
</ul>
<p><a id="sec-position"></a></p>
<h2 data-number="1.2" id="文档定位"><span
class="header-section-number">1.2</span> 文档定位</h2>
<p>本文档为 <code>01_Detailed_Design.md</code>
中“表务详细设计”章节的模块正文拆分稿,便于按模块独立维护。正式交付口径以主详设为准。</p>
<p><a id="sec-content"></a></p>
<h1 data-number="2" id="表务详细设计"><span
class="header-section-number">2</span> 表务详细设计</h1>
<p><a id="sec-meter-rules"></a></p>
<h2 data-number="2.1" id="表务模块统一约束"><span
class="header-section-number">2.1</span> 表务模块统一约束</h2>
<ol type="1">
<li>表务模块负责水表档案、状态、库存、工单与物联网接入,账单生成仍归属
<code>SYS-002</code> 营收主流程。</li>
<li>水表状态变更必须通过表务工单、出入库动作或报装装表流程驱动,不允许绕过业务过程直接改写生命周期状态。</li>
<li>换表、移表、拆表、复装完成后,必须同步客户绑定关系、安装位置和最新表计状态,避免档案与现场状态不一致。</li>
<li>库存、出入库、报废等动作必须具备批次追溯与操作留痕,满足审计与责任界定要求。</li>
<li>远传抄表与设备告警数据进入 <code>SYS-002</code>
后,必须先完成校验和异常判断,再进入抄表开账链路。</li>
</ol>
<p><a id="sec-meter-trace"></a></p>
<h2 data-number="2.2" id="接口与数据追溯矩阵"><span
class="header-section-number">2.2</span> 接口与数据追溯矩阵</h2>
<blockquote>
<p>说明:接口字段以
<code>../03_Technical_Design/03_Interface_Design.md</code>
为准,数据库口径以
<code>../03_Technical_Design/01_Database_Design.md</code> 为准。</p>
</blockquote>
<table>
<colgroup>
<col style="width: 25%" />
<col style="width: 25%" />
<col style="width: 25%" />
<col style="width: 25%" />
</colgroup>
<thead>
<tr>
<th>METER 模块</th>
<th>关键接口</th>
<th>核心数据域(摘要)</th>
<th>主要协同对象</th>
</tr>
</thead>
<tbody>
<tr>
<td>METER-001 表务基础管理</td>
<td><code>IF-METER-001</code></td>
<td><code>biz_meter</code><code>biz_meter_model</code><code>biz_meter_caliber</code><code>biz_meter_range</code></td>
<td>营收、报装</td>
</tr>
<tr>
<td>METER-002 仓库与库存管理</td>
<td><code>IF-METER-003</code></td>
<td><code>biz_meter_in_out</code><code>biz_meter_in_out_rel</code><code>biz_meter</code></td>
<td>仓储管理端</td>
</tr>
<tr>
<td>METER-003 设备档案管理</td>
<td><code>IF-METER-001</code><code>IF-METER-002</code><code>IF-METER-004</code></td>
<td><code>biz_meter</code><code>biz_meter_log</code><code>biz_process*</code><code>biz_meter_read</code><code>biz_reading_data</code><code>biz_last_reading</code></td>
<td>工单系统、移动作业、IoT 平台、营收开账</td>
</tr>
</tbody>
</table>
<p><a id="mod-meter-001"></a></p>
<h2 data-number="2.3" id="meter-001-表务基础管理"><span
class="header-section-number">2.3</span> METER-001 表务基础管理</h2>
<h3 data-number="2.3.1" id="功能说明"><span
class="header-section-number">2.3.1</span> 功能说明</h3>
<p>管理水表档案、厂家、型号、口径、量程、检定证书、安装位置、当前状态等基础信息。</p>
<h3 data-number="2.3.2" id="关键设计"><span
class="header-section-number">2.3.2</span> 关键设计</h3>
<ul>
<li>一块水表对应唯一档案主记录。</li>
<li>设备状态覆盖在库、在用、待检、故障、报废等。</li>
<li>与客户、水表工单、抄表记录形成关联闭环。</li>
</ul>
<h3 data-number="2.3.3" id="核心数据"><span
class="header-section-number">2.3.3</span> 核心数据</h3>
<ul>
<li><code>biz_meter</code>:水表主档。</li>
<li><code>biz_meter_model</code>:水表型号。</li>
<li><code>biz_meter_caliber</code>:水表口径。</li>
<li><code>biz_meter_range</code>:水表量程。</li>
<li><code>biz_last_reading</code>:最近有效读数状态。</li>
</ul>
<h3 data-number="2.3.4" id="接口映射"><span
class="header-section-number">2.3.4</span> 接口映射</h3>
<ul>
<li><code>IF-METER-001</code>:查询水表档案、状态与生命周期信息。</li>
<li><code>IF-REV-001</code>:客户侧查询场景复用表计关联信息。</li>
</ul>
<h3 data-number="2.3.5" id="落地边界"><span
class="header-section-number">2.3.5</span> 落地边界</h3>
<ul>
<li><strong>已落地</strong>:水表主档、型号、口径、量程、状态等基础档案对象。</li>
<li><strong>部分落地</strong>:证书、检定批次、厂家深度评价等附属对象可能由扩展字段或附件承载。</li>
<li><strong>文档先行</strong>:复杂设备健康评分与预测性维护不作为当前已实现能力表述。</li>
</ul>
<p><a id="mod-meter-002"></a></p>
<h2 data-number="2.4" id="meter-002-仓库与库存管理"><span
class="header-section-number">2.4</span> METER-002 仓库与库存管理</h2>
<h3 data-number="2.4.1" id="功能说明-1"><span
class="header-section-number">2.4.1</span> 功能说明</h3>
<p>管理新表入库、领用、出库、退库、报废及库存预警,是架构图中“仓库与库存管理”模块的正式承接章节。</p>
<h3 data-number="2.4.2" id="关键设计-1"><span
class="header-section-number">2.4.2</span> 关键设计</h3>
<ol type="1">
<li>库存动作以批次和明细双层结构记录,支持领用、退库、报废等全过程追溯。</li>
<li>库存状态与设备生命周期联动更新,避免“账上在库、现场在用”不一致。</li>
<li>报废、退库等高风险动作需保留审批或责任人留痕。</li>
</ol>
<h3 data-number="2.4.3" id="核心数据-1"><span
class="header-section-number">2.4.3</span> 核心数据</h3>
<ul>
<li><code>biz_meter_in_out</code>:出入库主表。</li>
<li><code>biz_meter_in_out_rel</code>:出入库明细关系。</li>
<li><code>biz_meter_log</code>:库存与生命周期动作留痕。</li>
<li><code>biz_meter</code>:生命周期状态主对象。</li>
</ul>
<h3 data-number="2.4.4" id="接口映射-1"><span
class="header-section-number">2.4.4</span> 接口映射</h3>
<ul>
<li><code>IF-METER-003</code>:领用、退库、报废等库存动作处理。</li>
</ul>
<h3 data-number="2.4.5" id="落地边界-1"><span
class="header-section-number">2.4.5</span> 落地边界</h3>
<ul>
<li><strong>已落地</strong>:出入库主明细、库存状态回写、动作留痕。</li>
<li><strong>部分落地</strong>:仓位优化、库龄分析等能力可能通过报表层实现,而非独立业务对象。</li>
<li><strong>文档先行</strong>:自动补货策略与仓网优化仅保留设计方向。</li>
</ul>
<p><a id="mod-meter-003"></a></p>
<h2 data-number="2.5" id="meter-003-设备档案管理"><span
class="header-section-number">2.5</span> METER-003 设备档案管理</h2>
<h3 data-number="2.5.1" id="功能说明-2"><span
class="header-section-number">2.5.1</span> 功能说明</h3>
<p>管理水表唯一电子档案、状态流转、安装历史、质检追溯,并统一承接表务工单和物联网同步相关能力。</p>
<h3 data-number="2.5.2" id="关键设计-2"><span
class="header-section-number">2.5.2</span> 关键设计</h3>
<ol type="1">
<li>一块水表对应唯一档案主记录,覆盖在库、在用、待检、故障、报废等状态。</li>
<li>设备档案同时关联安装历史、维修记录、库存动作与最近有效读数,形成全生命周期追溯闭环。</li>
<li>表务工单和远传同步能力属于设备档案管理下的实施态支撑能力,不再作为独立模块编号表达。</li>
</ol>
<h3 data-number="2.5.3" id="核心数据-2"><span
class="header-section-number">2.5.3</span> 核心数据</h3>
<ul>
<li><code>biz_meter</code>:水表主档与状态主对象。</li>
<li><code>biz_meter_log</code>:设备过程留痕与工单回写对象。</li>
<li><code>biz_process</code><code>biz_process_transfer</code>:表务工单流程主线。</li>
<li><code>biz_meter_read</code><code>biz_reading_data</code><code>biz_last_reading</code>:读数、状态与同步对象。</li>
</ul>
<h3 data-number="2.5.4" id="接口映射-2"><span
class="header-section-number">2.5.4</span> 接口映射</h3>
<ul>
<li><code>IF-METER-001</code>:查询水表档案、状态与生命周期信息。</li>
<li><code>IF-METER-002</code>:换表、移表、校表、维修等处理结果提交。</li>
<li><code>IF-METER-004</code>:远传抄表、告警与状态同步接收。</li>
</ul>
<h3 data-number="2.5.5" id="落地边界-2"><span
class="header-section-number">2.5.5</span> 落地边界</h3>
<ul>
<li><strong>已落地</strong>:设备主档、状态流转、工单留痕、远传同步与异常标记能力。</li>
<li><strong>部分落地</strong>:质检批次、厂家评价、复杂设备健康评分等附属对象可能由扩展字段、附件或报表层承接。</li>
<li><strong>文档先行</strong>:预测性维护和实时控制指令不作为当前正式实现口径。</li>
</ul>
<p><a id="mod-meter-004"></a></p>
<h3 data-number="2.5.6" id="物联网接入与数据同步能力"><span
class="header-section-number">2.5.6</span> 物联网接入与数据同步能力</h3>
<h3 data-number="2.5.7" id="功能说明-3"><span
class="header-section-number">2.5.7</span> 功能说明</h3>
<p>接入集抄系统、智能表平台及厂家物联网平台,实现远程抄表、状态查询、设备参数同步与异常告警。</p>
<h3 data-number="2.5.8" id="业务流程"><span
class="header-section-number">2.5.8</span> 业务流程</h3>
<pre class="mermaid"><code>flowchart TD
A[定时采集任务] --&gt; B[发送采集请求]
B --&gt; C[物联网平台返回数据]
C --&gt; D[数据校验]
D --&gt; E{是否有效}
E --&gt;|有效| F[写入抄表记录]
E --&gt;|无效| G[异常标记并告警]
F --&gt; H[参与开账]
G --&gt; I[人工复核处理]
</code></pre>
<h3 data-number="2.5.9" id="关键规则"><span
class="header-section-number">2.5.9</span> 关键规则</h3>
<ol type="1">
<li>远传抄表结果必须校验设备标识、采集时间、读数合法性和重复上送情况。</li>
<li>异常读数、离线状态、设备告警需区分业务异常与设备异常两类处理。</li>
<li>校验通过的有效读数进入抄表开账链路,异常结果需保留人工复核入口。</li>
</ol>
<h3 data-number="2.5.10" id="核心数据-3"><span
class="header-section-number">2.5.10</span> 核心数据</h3>
<ul>
<li><code>biz_meter_read</code>:抄表任务或状态承接对象。</li>
<li><code>biz_reading_data</code>:远传读数数据。</li>
<li><code>biz_last_reading</code>:最新有效读数。</li>
<li><code>biz_meter</code>:设备状态与参数关联对象。</li>
</ul>
<h3 data-number="2.5.11" id="接口映射-3"><span
class="header-section-number">2.5.11</span> 接口映射</h3>
<ul>
<li><code>IF-METER-004</code>:远传抄表、告警与状态同步接收。</li>
<li><code>IF-EXT-009</code>IoT/集抄平台数据接入协同。</li>
<li><code>IF-REV-004</code><code>IF-REV-005</code>:校验通过后进入抄表提交与开账流程。</li>
</ul>
<h3 data-number="2.5.12" id="落地边界-3"><span
class="header-section-number">2.5.12</span> 落地边界</h3>
<ul>
<li><strong>已落地</strong>:远传数据接入、基础校验、异常标记与读数同步。</li>
<li><strong>部分落地</strong>:复杂设备诊断与厂家私有协议适配更多由外部
IoT 平台承载。</li>
<li><strong>文档先行</strong>:边缘计算、实时控制指令等能力不作为当前正式实现口径。</li>
</ul>
<p><a id="mod-meter-002-workflow"></a></p>
<h3 data-number="2.5.13" id="表务工单协同能力"><span
class="header-section-number">2.5.13</span> 表务工单协同能力</h3>
<p>处理换表、移表、拆表、复装、校表、稽查、维修等表务工单,是
<code>METER-003</code> 设备档案管理的实施态过程能力。</p>
<h4 data-number="2.5.13.1" id="业务流程-1"><span
class="header-section-number">2.5.13.1</span> 业务流程</h4>
<pre class="mermaid"><code>flowchart TD
A[创建表务工单] --&gt; B[派发现场任务]
B --&gt; C[现场处理并采集结果]
C --&gt; D[回写旧表/新表信息]
D --&gt; E[更新水表状态与客户绑定]
E --&gt; F[写入过程日志与附件]
F --&gt; G[工单办结]
</code></pre>
<h4 data-number="2.5.13.2" id="关键规则-1"><span
class="header-section-number">2.5.13.2</span> 关键规则</h4>
<ol type="1">
<li>工单类型决定必填字段、处理流程和附件要求。</li>
<li>换表工单需同时记录旧表拆除信息与新表安装信息。</li>
<li>工单完成后同步更新设备档案、客户绑定关系与安装历史。</li>
</ol>
</body>
</html>