2051 lines
66 KiB
HTML
2051 lines
66 KiB
HTML
<!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="#设计范围" id="toc-设计范围"><span
|
||
class="toc-section-number">2.3</span> 设计范围</a></li>
|
||
<li><a href="#术语与缩略语" id="toc-术语与缩略语"><span
|
||
class="toc-section-number">2.4</span> 术语与缩略语</a></li>
|
||
<li><a href="#参考资料" id="toc-参考资料"><span
|
||
class="toc-section-number">2.5</span> 参考资料</a></li>
|
||
<li><a href="#模块正文文件索引" id="toc-模块正文文件索引"><span
|
||
class="toc-section-number">2.6</span> 模块正文文件索引</a></li>
|
||
</ul></li>
|
||
<li><a href="#系统总体设计" id="toc-系统总体设计"><span
|
||
class="toc-section-number">3</span> 系统总体设计</a>
|
||
<ul>
|
||
<li><a href="#总体目标" id="toc-总体目标"><span
|
||
class="toc-section-number">3.1</span> 总体目标</a></li>
|
||
<li><a href="#逻辑架构设计" id="toc-逻辑架构设计"><span
|
||
class="toc-section-number">3.2</span> 逻辑架构设计</a>
|
||
<ul>
|
||
<li><a href="#设计说明" id="toc-设计说明"><span
|
||
class="toc-section-number">3.2.1</span> 设计说明</a></li>
|
||
</ul></li>
|
||
<li><a href="#部署分区设计" id="toc-部署分区设计"><span
|
||
class="toc-section-number">3.3</span> 部署分区设计</a></li>
|
||
<li><a href="#子系统与模块划分" id="toc-子系统与模块划分"><span
|
||
class="toc-section-number">3.4</span> 子系统与模块划分</a>
|
||
<ul>
|
||
<li><a href="#与架构图模块清单的承接说明"
|
||
id="toc-与架构图模块清单的承接说明"><span
|
||
class="toc-section-number">3.4.1</span>
|
||
与架构图模块清单的承接说明</a></li>
|
||
</ul></li>
|
||
</ul></li>
|
||
<li><a href="#统一平台详细设计" id="toc-统一平台详细设计"><span
|
||
class="toc-section-number">4</span> 统一平台详细设计</a>
|
||
<ul>
|
||
<li><a href="#章节定位" id="toc-章节定位"><span
|
||
class="toc-section-number">4.1</span> 章节定位</a></li>
|
||
<li><a href="#模块摘要" id="toc-模块摘要"><span
|
||
class="toc-section-number">4.2</span> 模块摘要</a></li>
|
||
<li><a href="#正文入口" id="toc-正文入口"><span
|
||
class="toc-section-number">4.3</span> 正文入口</a></li>
|
||
</ul></li>
|
||
<li><a href="#营收业务详细设计" id="toc-营收业务详细设计"><span
|
||
class="toc-section-number">5</span> 营收业务详细设计</a>
|
||
<ul>
|
||
<li><a href="#章节定位-1" id="toc-章节定位-1"><span
|
||
class="toc-section-number">5.1</span> 章节定位</a></li>
|
||
<li><a href="#模块摘要-1" id="toc-模块摘要-1"><span
|
||
class="toc-section-number">5.2</span> 模块摘要</a></li>
|
||
<li><a href="#正文入口-1" id="toc-正文入口-1"><span
|
||
class="toc-section-number">5.3</span> 正文入口</a></li>
|
||
</ul></li>
|
||
<li><a href="#客户服务模块详细设计" id="toc-客户服务模块详细设计"><span
|
||
class="toc-section-number">6</span> 客户服务模块详细设计</a>
|
||
<ul>
|
||
<li><a href="#章节定位-2" id="toc-章节定位-2"><span
|
||
class="toc-section-number">6.1</span> 章节定位</a></li>
|
||
<li><a href="#模块摘要-2" id="toc-模块摘要-2"><span
|
||
class="toc-section-number">6.2</span> 模块摘要</a></li>
|
||
<li><a href="#正文入口-2" id="toc-正文入口-2"><span
|
||
class="toc-section-number">6.3</span> 正文入口</a></li>
|
||
</ul></li>
|
||
<li><a href="#表务详细设计" id="toc-表务详细设计"><span
|
||
class="toc-section-number">7</span> 表务详细设计</a>
|
||
<ul>
|
||
<li><a href="#章节定位-3" id="toc-章节定位-3"><span
|
||
class="toc-section-number">7.1</span> 章节定位</a></li>
|
||
<li><a href="#模块摘要-3" id="toc-模块摘要-3"><span
|
||
class="toc-section-number">7.2</span> 模块摘要</a></li>
|
||
<li><a href="#正文入口-3" id="toc-正文入口-3"><span
|
||
class="toc-section-number">7.3</span> 正文入口</a></li>
|
||
</ul></li>
|
||
<li><a href="#报装与签章详细设计" id="toc-报装与签章详细设计"><span
|
||
class="toc-section-number">8</span> 报装与签章详细设计</a>
|
||
<ul>
|
||
<li><a href="#章节定位-4" id="toc-章节定位-4"><span
|
||
class="toc-section-number">8.1</span> 章节定位</a></li>
|
||
<li><a href="#模块摘要-4" id="toc-模块摘要-4"><span
|
||
class="toc-section-number">8.2</span> 模块摘要</a></li>
|
||
<li><a href="#正文入口-4" id="toc-正文入口-4"><span
|
||
class="toc-section-number">8.3</span> 正文入口</a></li>
|
||
</ul></li>
|
||
<li><a href="#数据库详细设计" id="toc-数据库详细设计"><span
|
||
class="toc-section-number">9</span> 数据库详细设计</a>
|
||
<ul>
|
||
<li><a href="#数据库选型与原则" id="toc-数据库选型与原则"><span
|
||
class="toc-section-number">9.1</span> 数据库选型与原则</a></li>
|
||
<li><a href="#数据库逻辑架构" id="toc-数据库逻辑架构"><span
|
||
class="toc-section-number">9.2</span> 数据库逻辑架构</a></li>
|
||
<li><a href="#核心数据模型" id="toc-核心数据模型"><span
|
||
class="toc-section-number">9.3</span> 核心数据模型</a></li>
|
||
<li><a href="#核心数据表设计" id="toc-核心数据表设计"><span
|
||
class="toc-section-number">9.4</span> 核心数据表设计</a>
|
||
<ul>
|
||
<li><a href="#客户与账户类" id="toc-客户与账户类"><span
|
||
class="toc-section-number">9.4.1</span> 客户与账户类</a></li>
|
||
<li><a href="#水表与抄表类" id="toc-水表与抄表类"><span
|
||
class="toc-section-number">9.4.2</span> 水表与抄表类</a></li>
|
||
<li><a href="#账单收费与发票类" id="toc-账单收费与发票类"><span
|
||
class="toc-section-number">9.4.3</span> 账单、收费与发票类</a></li>
|
||
<li><a href="#银行渠道与交易类" id="toc-银行渠道与交易类"><span
|
||
class="toc-section-number">9.4.4</span> 银行渠道与交易类</a></li>
|
||
<li><a href="#表务与工单类" id="toc-表务与工单类"><span
|
||
class="toc-section-number">9.4.5</span> 表务与工单类</a></li>
|
||
<li><a href="#报装与签章类" id="toc-报装与签章类"><span
|
||
class="toc-section-number">9.4.6</span> 报装与签章类</a></li>
|
||
</ul></li>
|
||
<li><a href="#索引与性能设计" id="toc-索引与性能设计"><span
|
||
class="toc-section-number">9.5</span> 索引与性能设计</a>
|
||
<ul>
|
||
<li><a href="#主要索引策略" id="toc-主要索引策略"><span
|
||
class="toc-section-number">9.5.1</span> 主要索引策略</a></li>
|
||
</ul></li>
|
||
</ul></li>
|
||
<li><a href="#接口详细设计" id="toc-接口详细设计"><span
|
||
class="toc-section-number">10</span> 接口详细设计</a>
|
||
<ul>
|
||
<li><a href="#接口设计原则" id="toc-接口设计原则"><span
|
||
class="toc-section-number">10.1</span> 接口设计原则</a></li>
|
||
<li><a href="#统一平台接口" id="toc-统一平台接口"><span
|
||
class="toc-section-number">10.2</span> 统一平台接口</a></li>
|
||
<li><a href="#营收业务接口" id="toc-营收业务接口"><span
|
||
class="toc-section-number">10.3</span> 营收业务接口</a></li>
|
||
<li><a href="#表务与物联网接口" id="toc-表务与物联网接口"><span
|
||
class="toc-section-number">10.4</span> 表务与物联网接口</a></li>
|
||
<li><a href="#报装与签章接口" id="toc-报装与签章接口"><span
|
||
class="toc-section-number">10.5</span> 报装与签章接口</a></li>
|
||
<li><a href="#客户渠道接口" id="toc-客户渠道接口"><span
|
||
class="toc-section-number">10.6</span> 客户渠道接口</a></li>
|
||
<li><a href="#外部系统接口" id="toc-外部系统接口"><span
|
||
class="toc-section-number">10.7</span> 外部系统接口</a>
|
||
<ul>
|
||
<li><a href="#金融支付接口" id="toc-金融支付接口"><span
|
||
class="toc-section-number">10.7.1</span> 金融支付接口</a></li>
|
||
<li><a href="#税务与消息接口" id="toc-税务与消息接口"><span
|
||
class="toc-section-number">10.7.2</span> 税务与消息接口</a></li>
|
||
<li><a href="#物联网政务与签章接口" id="toc-物联网政务与签章接口"><span
|
||
class="toc-section-number">10.7.3</span> 物联网、政务与签章接口</a></li>
|
||
</ul></li>
|
||
</ul></li>
|
||
<li><a href="#安全详细设计" id="toc-安全详细设计"><span
|
||
class="toc-section-number">11</span> 安全详细设计</a>
|
||
<ul>
|
||
<li><a href="#安全目标与分层防护" id="toc-安全目标与分层防护"><span
|
||
class="toc-section-number">11.1</span> 安全目标与分层防护</a></li>
|
||
<li><a href="#身份认证与访问控制" id="toc-身份认证与访问控制"><span
|
||
class="toc-section-number">11.2</span> 身份认证与访问控制</a></li>
|
||
<li><a href="#数据安全与隐私保护" id="toc-数据安全与隐私保护"><span
|
||
class="toc-section-number">11.3</span> 数据安全与隐私保护</a></li>
|
||
<li><a href="#接口安全与审计追踪" id="toc-接口安全与审计追踪"><span
|
||
class="toc-section-number">11.4</span> 接口安全与审计追踪</a></li>
|
||
<li><a href="#安全运营与应急响应" id="toc-安全运营与应急响应"><span
|
||
class="toc-section-number">11.5</span> 安全运营与应急响应</a></li>
|
||
</ul></li>
|
||
<li><a href="#部署与运维设计" id="toc-部署与运维设计"><span
|
||
class="toc-section-number">12</span> 部署与运维设计</a>
|
||
<ul>
|
||
<li><a href="#部署总体方案" id="toc-部署总体方案"><span
|
||
class="toc-section-number">12.1</span> 部署总体方案</a></li>
|
||
<li><a href="#环境规划" id="toc-环境规划"><span
|
||
class="toc-section-number">12.2</span> 环境规划</a></li>
|
||
<li><a href="#网络与分区设计" id="toc-网络与分区设计"><span
|
||
class="toc-section-number">12.3</span> 网络与分区设计</a></li>
|
||
<li><a href="#监控告警与日志" id="toc-监控告警与日志"><span
|
||
class="toc-section-number">12.4</span> 监控告警与日志</a>
|
||
<ul>
|
||
<li><a href="#监控指标" id="toc-监控指标"><span
|
||
class="toc-section-number">12.4.1</span> 监控指标</a></li>
|
||
<li><a href="#日志分类" id="toc-日志分类"><span
|
||
class="toc-section-number">12.4.2</span> 日志分类</a></li>
|
||
</ul></li>
|
||
<li><a href="#备份恢复与发布管理" id="toc-备份恢复与发布管理"><span
|
||
class="toc-section-number">12.5</span> 备份恢复与发布管理</a></li>
|
||
</ul></li>
|
||
<li><a href="#附录" id="toc-附录"><span
|
||
class="toc-section-number">13</span> 附录</a>
|
||
<ul>
|
||
<li><a href="#附录a-模块编号说明" id="toc-附录a-模块编号说明"><span
|
||
class="toc-section-number">13.1</span> 附录A 模块编号说明</a></li>
|
||
<li><a href="#附录b-接口编号说明" id="toc-附录b-接口编号说明"><span
|
||
class="toc-section-number">13.2</span> 附录B 接口编号说明</a></li>
|
||
<li><a href="#附录c-设计约束与统一口径"
|
||
id="toc-附录c-设计约束与统一口径"><span
|
||
class="toc-section-number">13.3</span> 附录C 设计约束与统一口径</a></li>
|
||
</ul></li>
|
||
</ul>
|
||
</nav>
|
||
<h1 data-number="1" id="福建水务营收系统详细设计说明书"><span
|
||
class="header-section-number">1</span>
|
||
福建水务营收系统详细设计说明书</h1>
|
||
<table>
|
||
<thead>
|
||
<tr>
|
||
<th style="text-align: left;">文件状态：</th>
|
||
<th style="text-align: left;">文档密级：</th>
|
||
<th style="text-align: left;">公开</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr>
|
||
<td style="text-align: left;">【】草稿</td>
|
||
<td style="text-align: left;"></td>
|
||
<td style="text-align: left;"></td>
|
||
</tr>
|
||
<tr>
|
||
<td style="text-align: left;">【√】修改稿</td>
|
||
<td style="text-align: left;"></td>
|
||
<td style="text-align: left;"></td>
|
||
</tr>
|
||
<tr>
|
||
<td style="text-align: left;">【】正式发布</td>
|
||
<td style="text-align: left;"></td>
|
||
<td style="text-align: left;"></td>
|
||
</tr>
|
||
<tr>
|
||
<td style="text-align: left;"></td>
|
||
<td style="text-align: left;"><strong>当前版本：</strong></td>
|
||
<td style="text-align: left;"><strong>V1.6</strong></td>
|
||
</tr>
|
||
<tr>
|
||
<td style="text-align: left;"></td>
|
||
<td style="text-align: left;"><strong>作者：</strong></td>
|
||
<td style="text-align: left;"><strong>唐伟杰</strong></td>
|
||
</tr>
|
||
<tr>
|
||
<td style="text-align: left;"></td>
|
||
<td style="text-align: left;"><strong>完成日期：</strong></td>
|
||
<td style="text-align: left;"><strong>2026-03-10</strong></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<h2 data-number="1.1" id="版本历史"><span
|
||
class="header-section-number">1.1</span> 版本历史</h2>
|
||
<table>
|
||
<colgroup>
|
||
<col style="width: 25%" />
|
||
<col style="width: 25%" />
|
||
<col style="width: 25%" />
|
||
<col style="width: 25%" />
|
||
</colgroup>
|
||
<thead>
|
||
<tr>
|
||
<th style="text-align: left;">日期</th>
|
||
<th style="text-align: left;">版本号</th>
|
||
<th style="text-align: left;">作者</th>
|
||
<th style="text-align: left;">备注</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr>
|
||
<td style="text-align: left;">2025-07-01</td>
|
||
<td style="text-align: left;">V1.0</td>
|
||
<td style="text-align: left;">唐伟杰</td>
|
||
<td style="text-align: left;">初版</td>
|
||
</tr>
|
||
<tr>
|
||
<td style="text-align: left;">2025-07-17</td>
|
||
<td style="text-align: left;">V1.1</td>
|
||
<td style="text-align: left;">唐伟杰</td>
|
||
<td style="text-align: left;">补充详细设计内容</td>
|
||
</tr>
|
||
<tr>
|
||
<td style="text-align: left;">2025-08-01</td>
|
||
<td style="text-align: left;">V1.2</td>
|
||
<td style="text-align: left;">唐伟杰</td>
|
||
<td
|
||
style="text-align: left;">同步更新概要设计中的子系统和模块结构，补充数据库设计章节并统一主要模块逻辑。</td>
|
||
</tr>
|
||
<tr>
|
||
<td style="text-align: left;">2025-08-01</td>
|
||
<td style="text-align: left;">V1.3</td>
|
||
<td style="text-align: left;">唐伟杰</td>
|
||
<td style="text-align: left;">数据库系统口径统一为达梦数据库 8.0+。</td>
|
||
</tr>
|
||
<tr>
|
||
<td style="text-align: left;">2025-08-01</td>
|
||
<td style="text-align: left;">V1.4</td>
|
||
<td style="text-align: left;">唐伟杰</td>
|
||
<td style="text-align: left;">单点登录采用 OAuth2.0
|
||
协议，补充统一认证相关设计。</td>
|
||
</tr>
|
||
<tr>
|
||
<td style="text-align: left;">2026-03-10</td>
|
||
<td style="text-align: left;">V1.6</td>
|
||
<td style="text-align: left;">唐伟杰</td>
|
||
<td
|
||
style="text-align: left;">将分散的模块设计、数据库设计、接口设计、安全设计、部署设计与报装电子签章设计整合为统一主详设，统一系统名称、章节体系、模块/接口编号及数据库口径，清理重复内容与部署脏片段。</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<h2 data-number="1.2" id="章节导航精简"><span
|
||
class="header-section-number">1.2</span> 章节导航（精简）</h2>
|
||
<ul>
|
||
<li><a href="#sec-preface">前言</a></li>
|
||
<li><a href="#sec-overall-design">系统总体设计</a></li>
|
||
<li><a href="#sec-module-detail">详细模块设计</a>
|
||
<ul>
|
||
<li><a href="#sec-platform-detail">统一平台详细设计</a></li>
|
||
<li><a href="#sec-revenue-detail">营收业务详细设计</a></li>
|
||
<li><a href="#sec-customer-detail">客户服务模块详细设计</a></li>
|
||
<li><a href="#sec-meter-detail">表务详细设计</a></li>
|
||
<li><a href="#sec-installation-detail">报装与签章详细设计</a></li>
|
||
</ul></li>
|
||
<li><a href="#sec-database-detail">数据库详细设计</a></li>
|
||
<li><a href="#sec-interface-detail">接口详细设计</a></li>
|
||
<li><a href="#sec-security-detail">安全详细设计</a></li>
|
||
<li><a href="#sec-deployment-detail">部署与运维设计</a></li>
|
||
<li><a href="#sec-appendix">附录</a></li>
|
||
<li><a href="#sec-module-files">模块正文文件索引</a></li>
|
||
</ul>
|
||
<p><a id="sec-preface"></a></p>
|
||
<h1 data-number="2" id="前言"><span
|
||
class="header-section-number">2</span> 前言</h1>
|
||
<h2 data-number="2.1" id="编写目的"><span
|
||
class="header-section-number">2.1</span> 编写目的</h2>
|
||
<p>本文档用于指导福建水务营收系统的详细设计、开发实现、联调测试、部署上线及后续运维，是本项目详细设计阶段的统一主说明书。本文档以
|
||
<code>docs/design/02_Detailed_Design/01_Detailed_Design.md</code>
|
||
作为唯一主详设文件，吸收模块设计、数据库设计、接口设计、安全设计、部署设计以及报装电子签章专项设计中的可复用内容，形成可直接交付和实施使用的统一版本。</p>
|
||
<h2 data-number="2.2" id="建设背景"><span
|
||
class="header-section-number">2.2</span> 建设背景</h2>
|
||
<p>福建水务营收系统面向集团化、多组织、多渠道的营收业务场景，覆盖客户资料、抄表开账、营业收费、账务处理、表务管理、报装立户、电子签章、客户服务、移动作业、外部支付与政务对接等核心业务。系统建设目标是形成统一平台、统一数据、统一接口、统一安全管控的营收业务支撑体系，满足集团及下属单位的标准化与可扩展管理要求。</p>
|
||
<h2 data-number="2.3" id="设计范围"><span
|
||
class="header-section-number">2.3</span> 设计范围</h2>
|
||
<p>本文档覆盖以下设计内容：</p>
|
||
<ol type="1">
|
||
<li>系统总体架构与部署架构设计。</li>
|
||
<li>统一平台、营收业务、表务、报装与签章、客户服务渠道等业务模块详细设计。</li>
|
||
<li>达梦数据库 8.0+
|
||
口径下的核心数据模型、核心表结构、索引与性能设计。</li>
|
||
<li>内部接口、外部接口、安全控制、部署与运维方案。</li>
|
||
<li>关键业务流程、模块关系、接口交互与审计留痕要求。</li>
|
||
</ol>
|
||
<h2 data-number="2.4" id="术语与缩略语"><span
|
||
class="header-section-number">2.4</span> 术语与缩略语</h2>
|
||
<table>
|
||
<thead>
|
||
<tr>
|
||
<th>术语/缩略语</th>
|
||
<th>说明</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr>
|
||
<td>SSO</td>
|
||
<td>单点登录</td>
|
||
</tr>
|
||
<tr>
|
||
<td>OAuth2.0</td>
|
||
<td>统一认证授权协议</td>
|
||
</tr>
|
||
<tr>
|
||
<td>RBAC</td>
|
||
<td>基于角色的访问控制模型</td>
|
||
</tr>
|
||
<tr>
|
||
<td>DM8</td>
|
||
<td>达梦数据库 8.0+</td>
|
||
</tr>
|
||
<tr>
|
||
<td>API</td>
|
||
<td>应用程序接口</td>
|
||
</tr>
|
||
<tr>
|
||
<td>CA</td>
|
||
<td>电子认证与电子签章能力</td>
|
||
</tr>
|
||
<tr>
|
||
<td>MFA</td>
|
||
<td>多因素认证</td>
|
||
</tr>
|
||
<tr>
|
||
<td>ETL</td>
|
||
<td>数据抽取、转换、加载</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<h2 data-number="2.5" id="参考资料"><span
|
||
class="header-section-number">2.5</span> 参考资料</h2>
|
||
<ol type="1">
|
||
<li>《福建水务营收系统概要设计相关文档》</li>
|
||
<li><code>docs/design/02_Detailed_Design/02_Module_Traceability_Index.md</code></li>
|
||
<li><code>docs/design/02_Detailed_Design/03_CA_Esignature_Supplement.md</code></li>
|
||
<li><code>docs/design/02_Detailed_Design/11_UP_Detailed.md</code></li>
|
||
<li><code>docs/design/02_Detailed_Design/12_REV_Detailed.md</code></li>
|
||
<li><code>docs/design/02_Detailed_Design/13_CS_Detailed.md</code></li>
|
||
<li><code>docs/design/02_Detailed_Design/14_METER_Detailed.md</code></li>
|
||
<li><code>docs/design/02_Detailed_Design/15_INST_Detailed.md</code></li>
|
||
<li><code>docs/design/03_Technical_Design/01_Database_Design.md</code></li>
|
||
<li><code>docs/design/03_Technical_Design/02_Table_Specs.md</code>（历史命名映射补充）</li>
|
||
<li><code>docs/design/03_Technical_Design/03_Interface_Design.md</code></li>
|
||
<li><code>docs/design/03_Technical_Design/04_Security_Design.md</code></li>
|
||
<li><code>docs/design/03_Technical_Design/05_Deployment_Design.md</code></li>
|
||
<li>福建水投相关业务操作手册及需求说明资料</li>
|
||
<li><code>docs/design/01_Overview/05_Module_Inventory.md</code></li>
|
||
</ol>
|
||
<p><a id="sec-module-files"></a></p>
|
||
<h2 data-number="2.6" id="模块正文文件索引"><span
|
||
class="header-section-number">2.6</span> 模块正文文件索引</h2>
|
||
<ul>
|
||
<li>总体层模块清单与承接映射：<code>docs/design/01_Overview/05_Module_Inventory.md</code></li>
|
||
<li>统一平台模块正文：<code>docs/design/02_Detailed_Design/11_UP_Detailed.md</code></li>
|
||
<li>营收业务模块正文：<code>docs/design/02_Detailed_Design/12_REV_Detailed.md</code></li>
|
||
<li>客户服务模块正文：<code>docs/design/02_Detailed_Design/13_CS_Detailed.md</code></li>
|
||
<li>表务模块正文：<code>docs/design/02_Detailed_Design/14_METER_Detailed.md</code></li>
|
||
<li>报装与签章模块正文：<code>docs/design/02_Detailed_Design/15_INST_Detailed.md</code></li>
|
||
</ul>
|
||
<p><a id="sec-overall-design"></a></p>
|
||
<h1 data-number="3" id="系统总体设计"><span
|
||
class="header-section-number">3</span> 系统总体设计</h1>
|
||
<h2 data-number="3.1" id="总体目标"><span
|
||
class="header-section-number">3.1</span> 总体目标</h2>
|
||
<p>福建水务营收系统总体设计遵循“统一平台、业务协同、数据集中、接口标准、安全可控”的原则，实现以下目标：</p>
|
||
<ul>
|
||
<li>建立统一认证、统一组织、统一权限、统一参数、统一审计基础能力。</li>
|
||
<li>构建覆盖营收、表务、报装、客户服务的完整业务闭环。</li>
|
||
<li>形成达梦数据库 8.0+
|
||
为核心的数据架构，支撑集团化数据管理与查询分析。</li>
|
||
<li>通过标准化接口接入银行、第三方支付、短信、税控、物联网、政务、CA
|
||
签章等外部系统。</li>
|
||
<li>满足生产部署、容灾备份、日志审计与安全监管要求。</li>
|
||
</ul>
|
||
<h2 data-number="3.2" id="逻辑架构设计"><span
|
||
class="header-section-number">3.2</span> 逻辑架构设计</h2>
|
||
<pre class="mermaid"><code>graph TB
|
||
U1[柜台/客服/管理人员] --> A1[PC管理端]
|
||
U2[抄表员/表务人员] --> A2[移动作业端]
|
||
U3[客户用户] --> A3[微信/支付宝/微服务窗]
|
||
U4[第三方系统] --> A4[外部系统接口]
|
||
|
||
subgraph G[接入与网关层]
|
||
G1[统一门户]
|
||
G2[API网关]
|
||
G3[统一认证中心]
|
||
end
|
||
|
||
subgraph B[业务服务层]
|
||
B1[统一平台服务]
|
||
B2[营收业务服务]
|
||
B3[表务管理服务]
|
||
B4[报装与签章服务]
|
||
B5[客户服务渠道服务]
|
||
B6[消息通知与任务调度]
|
||
end
|
||
|
||
subgraph D[数据与支撑层]
|
||
D1[(达梦数据库 8.0+)]
|
||
D2[(Redis缓存)]
|
||
D3[对象存储/文件服务]
|
||
D4[消息队列]
|
||
D5[日志审计与监控]
|
||
end
|
||
|
||
A1 --> G1
|
||
A2 --> G1
|
||
A3 --> G1
|
||
A4 --> G2
|
||
G1 --> G2 --> G3
|
||
G2 --> B1
|
||
G2 --> B2
|
||
G2 --> B3
|
||
G2 --> B4
|
||
G2 --> B5
|
||
B1 --> D1
|
||
B2 --> D1
|
||
B3 --> D1
|
||
B4 --> D1
|
||
B5 --> D1
|
||
B2 --> D2
|
||
B3 --> D2
|
||
B4 --> D3
|
||
B5 --> D4
|
||
B1 --> D5
|
||
B2 --> D5
|
||
B3 --> D5
|
||
B4 --> D5
|
||
B5 --> D5
|
||
</code></pre>
|
||
<h3 data-number="3.2.1" id="设计说明"><span
|
||
class="header-section-number">3.2.1</span> 设计说明</h3>
|
||
<ol type="1">
|
||
<li>统一平台服务提供认证、组织、权限、参数、审计等公共能力。</li>
|
||
<li>营收业务服务承担客户、抄表、开账、收费、账务、发票、催缴、统计与业务工单等核心处理。</li>
|
||
<li>表务管理服务承担设备档案、表务工单、仓储、物联网集抄对接等处理。</li>
|
||
<li>报装与签章服务承担申请受理、现场踏勘、施工验收、合同签署与资料归档。</li>
|
||
<li>客户服务渠道服务面向微信、支付宝、微服务窗等客户侧渠道提供查询、缴费、电子发票与业务办理。</li>
|
||
</ol>
|
||
<h2 data-number="3.3" id="部署分区设计"><span
|
||
class="header-section-number">3.3</span> 部署分区设计</h2>
|
||
<pre class="mermaid"><code>graph TB
|
||
INTERNET[互联网/政务外网/合作机构] --> DMZ[DMZ接入区]
|
||
DMZ --> APP[应用服务区]
|
||
APP --> DATA[数据服务区]
|
||
APP --> OPS[管理运维区]
|
||
|
||
subgraph DMZ[DMZ接入区]
|
||
LB[负载均衡/Nginx]
|
||
WAF[WAF与边界防护]
|
||
GW[API网关]
|
||
end
|
||
|
||
subgraph APP[应用服务区]
|
||
APP1[统一平台服务]
|
||
APP2[营收业务服务]
|
||
APP3[表务服务]
|
||
APP4[报装签章服务]
|
||
APP5[客户渠道服务]
|
||
end
|
||
|
||
subgraph DATA[数据服务区]
|
||
DBM[(达梦主库)]
|
||
DBS[(达梦备库/从库)]
|
||
REDIS[(Redis)]
|
||
FILE[文件存储]
|
||
end
|
||
|
||
subgraph OPS[管理运维区]
|
||
MON[监控平台]
|
||
LOG[日志平台]
|
||
BAK[备份服务]
|
||
JUMP[堡垒机/跳板机]
|
||
end
|
||
</code></pre>
|
||
<h2 data-number="3.4" id="子系统与模块划分"><span
|
||
class="header-section-number">3.4</span> 子系统与模块划分</h2>
|
||
<table>
|
||
<colgroup>
|
||
<col style="width: 33%" />
|
||
<col style="width: 33%" />
|
||
<col style="width: 33%" />
|
||
</colgroup>
|
||
<thead>
|
||
<tr>
|
||
<th>子系统</th>
|
||
<th>说明</th>
|
||
<th>核心模块</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr>
|
||
<td>统一平台</td>
|
||
<td>提供统一认证、组织、权限、参数、审计与监控基础能力</td>
|
||
<td>UP-001 ~ UP-004</td>
|
||
</tr>
|
||
<tr>
|
||
<td>营收业务</td>
|
||
<td>覆盖客户、抄表、收费、账务、发票、催缴、统计、代收与业务工单</td>
|
||
<td>REV-001 ~ REV-009</td>
|
||
</tr>
|
||
<tr>
|
||
<td>表务管理</td>
|
||
<td>覆盖水表基础参数、仓储库存、设备档案以及工单和物联网同步等支撑能力</td>
|
||
<td>METER-001 ~ METER-003</td>
|
||
</tr>
|
||
<tr>
|
||
<td>报装与签章</td>
|
||
<td>覆盖报装流程管理、工程管理、档案管理及其下挂签章归档能力</td>
|
||
<td>INST-001 ~ INST-003</td>
|
||
</tr>
|
||
<tr>
|
||
<td>客户服务模块</td>
|
||
<td>覆盖账户绑定、信息查询、在线缴费、电子发票、网点服务、业务办理与柜面扫码支付</td>
|
||
<td>CS-001 ~ CS-007</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<h3 data-number="3.4.1" id="与架构图模块清单的承接说明"><span
|
||
class="header-section-number">3.4.1</span>
|
||
与架构图模块清单的承接说明</h3>
|
||
<ol type="1">
|
||
<li>架构图中的模块枚举基线以
|
||
<code>../01_Overview/05_Module_Inventory.md</code> 为准。</li>
|
||
<li>当前详细设计采用“业务域正文承接多个架构层模块”的组织方式，不强制为
|
||
<code>MOBILE-*</code>、<code>WECHAT-*</code>、<code>WORK-*</code>
|
||
单独建立平行正式主稿。</li>
|
||
<li><code>WECHAT-*</code> 当前按客户服务渠道视角并入 <code>CS-*</code>
|
||
体系承接；<code>MOBILE-*</code>
|
||
当前作为抄表与表务协同端能力分散承接于营收与表务正文；<code>WORK-*</code>
|
||
当前作为工单协同与流程支撑能力在客户服务、表务、报装正文中交叉引用。</li>
|
||
<li>若后续需要新增独立正文，必须先确认该模块已具备稳定边界、独立接口和核心数据域，并同步更新概要设计与追溯索引。</li>
|
||
</ol>
|
||
<p><a id="sec-module-detail"></a> <a id="sec-platform-detail"></a></p>
|
||
<h1 data-number="4" id="统一平台详细设计"><span
|
||
class="header-section-number">4</span> 统一平台详细设计</h1>
|
||
<h2 data-number="4.1" id="章节定位"><span
|
||
class="header-section-number">4.1</span> 章节定位</h2>
|
||
<p>为避免主详设与分模块文件重复维护，本章仅保留统一平台模块摘要与入口链接，详细正文统一维护在模块文件中。</p>
|
||
<h2 data-number="4.2" id="模块摘要"><span
|
||
class="header-section-number">4.2</span> 模块摘要</h2>
|
||
<table>
|
||
<colgroup>
|
||
<col style="width: 25%" />
|
||
<col style="width: 25%" />
|
||
<col style="width: 25%" />
|
||
<col style="width: 25%" />
|
||
</colgroup>
|
||
<thead>
|
||
<tr>
|
||
<th>模块编号</th>
|
||
<th>模块名称</th>
|
||
<th>设计摘要</th>
|
||
<th>正文链接</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr>
|
||
<td><code>UP-001</code></td>
|
||
<td>统一认证与单点登录</td>
|
||
<td>统一身份认证、单点登录、令牌生命周期管理与高敏感二次校验</td>
|
||
<td><a href="./11_UP_Detailed.md#mod-up-001">UP-001</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>UP-002</code></td>
|
||
<td>组织用户与权限管理</td>
|
||
<td>组织、岗位、角色、菜单与数据权限统一管控</td>
|
||
<td><a href="./11_UP_Detailed.md#mod-up-002">UP-002</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>UP-003</code></td>
|
||
<td>参数字典与基础配置</td>
|
||
<td>统一维护字典、价格、地址、渠道和任务参数</td>
|
||
<td><a href="./11_UP_Detailed.md#mod-up-003">UP-003</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>UP-004</code></td>
|
||
<td>审计监控与运维支撑</td>
|
||
<td>操作审计、接口监控、任务追踪与告警通知</td>
|
||
<td><a href="./11_UP_Detailed.md#mod-up-004">UP-004</a></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<h2 data-number="4.3" id="正文入口"><span
|
||
class="header-section-number">4.3</span> 正文入口</h2>
|
||
<ul>
|
||
<li><a href="./11_UP_Detailed.md#sec-content">统一平台模块正文</a></li>
|
||
</ul>
|
||
<p><a id="sec-revenue-detail"></a></p>
|
||
<h1 data-number="5" id="营收业务详细设计"><span
|
||
class="header-section-number">5</span> 营收业务详细设计</h1>
|
||
<h2 data-number="5.1" id="章节定位-1"><span
|
||
class="header-section-number">5.1</span> 章节定位</h2>
|
||
<p>本章保留营收业务模块的设计摘要，详细流程、数据域与规则说明统一维护在分模块正文文件中。</p>
|
||
<h2 data-number="5.2" id="模块摘要-1"><span
|
||
class="header-section-number">5.2</span> 模块摘要</h2>
|
||
<table>
|
||
<colgroup>
|
||
<col style="width: 25%" />
|
||
<col style="width: 25%" />
|
||
<col style="width: 25%" />
|
||
<col style="width: 25%" />
|
||
</colgroup>
|
||
<thead>
|
||
<tr>
|
||
<th>模块编号</th>
|
||
<th>模块名称</th>
|
||
<th>设计摘要</th>
|
||
<th>正文链接</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr>
|
||
<td><code>REV-001</code></td>
|
||
<td>客户资料管理</td>
|
||
<td>客户主档、账户、联系人、绑定关系等主数据管理</td>
|
||
<td><a href="./12_REV_Detailed.md#mod-rev-001">REV-001</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>REV-002</code></td>
|
||
<td>抄表开账</td>
|
||
<td>抄表计划、异常复核、计费与账单生成</td>
|
||
<td><a href="./12_REV_Detailed.md#mod-rev-002">REV-002</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>REV-003</code></td>
|
||
<td>营业收费</td>
|
||
<td>多渠道缴费、账单核销与收费凭证管理</td>
|
||
<td><a href="./12_REV_Detailed.md#mod-rev-003">REV-003</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>REV-004</code></td>
|
||
<td>账务处理</td>
|
||
<td>调整、退款、冲正、呆坏账等账务修正</td>
|
||
<td><a href="./12_REV_Detailed.md#mod-rev-004">REV-004</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>REV-005</code></td>
|
||
<td>发票与税务处理</td>
|
||
<td>发票申请、回写、作废与红冲协同</td>
|
||
<td><a href="./12_REV_Detailed.md#mod-rev-005">REV-005</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>REV-006</code></td>
|
||
<td>催缴与通知</td>
|
||
<td>欠费催缴策略、触达与结果回写</td>
|
||
<td><a href="./12_REV_Detailed.md#mod-rev-006">REV-006</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>REV-007</code></td>
|
||
<td>统计分析</td>
|
||
<td>营收、收费、欠费、渠道等多维统计</td>
|
||
<td><a href="./12_REV_Detailed.md#mod-rev-007">REV-007</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>REV-008</code></td>
|
||
<td>代收与银行业务</td>
|
||
<td>代收代扣、对账、结算与差异处理</td>
|
||
<td><a href="./12_REV_Detailed.md#mod-rev-008">REV-008</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>REV-009</code></td>
|
||
<td>业务参数配置</td>
|
||
<td>价格模板、页面配置与规则参数管理</td>
|
||
<td><a href="./12_REV_Detailed.md#mod-rev-009">REV-009</a></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<h2 data-number="5.3" id="正文入口-1"><span
|
||
class="header-section-number">5.3</span> 正文入口</h2>
|
||
<ul>
|
||
<li><a href="./12_REV_Detailed.md#sec-content">营收业务模块正文</a></li>
|
||
</ul>
|
||
<p><a id="sec-customer-detail"></a></p>
|
||
<h1 data-number="6" id="客户服务模块详细设计"><span
|
||
class="header-section-number">6</span> 客户服务模块详细设计</h1>
|
||
<h2 data-number="6.1" id="章节定位-2"><span
|
||
class="header-section-number">6.1</span> 章节定位</h2>
|
||
<p>本章保留客户服务模块摘要与入口，详细设计内容由分模块正文文件统一承载。</p>
|
||
<h2 data-number="6.2" id="模块摘要-2"><span
|
||
class="header-section-number">6.2</span> 模块摘要</h2>
|
||
<table>
|
||
<colgroup>
|
||
<col style="width: 25%" />
|
||
<col style="width: 25%" />
|
||
<col style="width: 25%" />
|
||
<col style="width: 25%" />
|
||
</colgroup>
|
||
<thead>
|
||
<tr>
|
||
<th>模块编号</th>
|
||
<th>模块名称</th>
|
||
<th>设计摘要</th>
|
||
<th>正文链接</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr>
|
||
<td><code>CS-001</code></td>
|
||
<td>账户绑定管理</td>
|
||
<td>渠道账号与客户账户绑定、解绑、默认设置</td>
|
||
<td><a href="./13_CS_Detailed.md#mod-cs-001">CS-001</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>CS-002</code></td>
|
||
<td>信息查询服务</td>
|
||
<td>账单、缴费、欠费、用水分析与历史查询</td>
|
||
<td><a href="./13_CS_Detailed.md#mod-cs-002">CS-002</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>CS-003</code></td>
|
||
<td>在线缴费服务</td>
|
||
<td>多渠道在线支付下单、回调确认与补单</td>
|
||
<td><a href="./13_CS_Detailed.md#mod-cs-003">CS-003</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>CS-004</code></td>
|
||
<td>电子发票服务</td>
|
||
<td>发票申请、查询、下载与推送</td>
|
||
<td><a href="./13_CS_Detailed.md#mod-cs-004">CS-004</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>CS-005</code></td>
|
||
<td>营业网点服务</td>
|
||
<td>网点信息、服务范围与办事引导</td>
|
||
<td><a href="./13_CS_Detailed.md#mod-cs-005">CS-005</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>CS-006</code></td>
|
||
<td>业务办理服务</td>
|
||
<td>线上办理入口与办理状态流转协同</td>
|
||
<td><a href="./13_CS_Detailed.md#mod-cs-006">CS-006</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>CS-007</code></td>
|
||
<td>柜面扫码支付</td>
|
||
<td>柜面二维码收款与收费状态联动</td>
|
||
<td><a href="./13_CS_Detailed.md#mod-cs-007">CS-007</a></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<h2 data-number="6.3" id="正文入口-2"><span
|
||
class="header-section-number">6.3</span> 正文入口</h2>
|
||
<ul>
|
||
<li><a href="./13_CS_Detailed.md#sec-content">客户服务模块正文</a></li>
|
||
</ul>
|
||
<p><a id="sec-meter-detail"></a></p>
|
||
<h1 data-number="7" id="表务详细设计"><span
|
||
class="header-section-number">7</span> 表务详细设计</h1>
|
||
<h2 data-number="7.1" id="章节定位-3"><span
|
||
class="header-section-number">7.1</span> 章节定位</h2>
|
||
<p>本章保留表务模块摘要，详细流程与对象说明统一在分模块正文文件维护。</p>
|
||
<h2 data-number="7.2" id="模块摘要-3"><span
|
||
class="header-section-number">7.2</span> 模块摘要</h2>
|
||
<table>
|
||
<colgroup>
|
||
<col style="width: 25%" />
|
||
<col style="width: 25%" />
|
||
<col style="width: 25%" />
|
||
<col style="width: 25%" />
|
||
</colgroup>
|
||
<thead>
|
||
<tr>
|
||
<th>模块编号</th>
|
||
<th>模块名称</th>
|
||
<th>设计摘要</th>
|
||
<th>正文链接</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr>
|
||
<td><code>METER-001</code></td>
|
||
<td>表务基础管理</td>
|
||
<td>水表档案、状态与参数基础管理</td>
|
||
<td><a href="./14_METER_Detailed.md#mod-meter-001">METER-001</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>METER-002</code></td>
|
||
<td>仓库与库存管理</td>
|
||
<td>入库、出库、退库、报废与库存预警</td>
|
||
<td><a href="./14_METER_Detailed.md#mod-meter-002">METER-002</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>METER-003</code></td>
|
||
<td>设备档案管理</td>
|
||
<td>设备主档、状态流转、工单协同与远传同步</td>
|
||
<td><a href="./14_METER_Detailed.md#mod-meter-003">METER-003</a></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<h2 data-number="7.3" id="正文入口-3"><span
|
||
class="header-section-number">7.3</span> 正文入口</h2>
|
||
<ul>
|
||
<li><a href="./14_METER_Detailed.md#sec-content">表务模块正文</a></li>
|
||
</ul>
|
||
<p><a id="sec-installation-detail"></a></p>
|
||
<h1 data-number="8" id="报装与签章详细设计"><span
|
||
class="header-section-number">8</span> 报装与签章详细设计</h1>
|
||
<h2 data-number="8.1" id="章节定位-4"><span
|
||
class="header-section-number">8.1</span> 章节定位</h2>
|
||
<p>本章保留报装与签章模块摘要，详细流程、CA
|
||
集成与异常补偿策略统一维护在分模块正文及 CA 专项补充文档。</p>
|
||
<h2 data-number="8.2" id="模块摘要-4"><span
|
||
class="header-section-number">8.2</span> 模块摘要</h2>
|
||
<table>
|
||
<colgroup>
|
||
<col style="width: 25%" />
|
||
<col style="width: 25%" />
|
||
<col style="width: 25%" />
|
||
<col style="width: 25%" />
|
||
</colgroup>
|
||
<thead>
|
||
<tr>
|
||
<th>模块编号</th>
|
||
<th>模块名称</th>
|
||
<th>设计摘要</th>
|
||
<th>正文链接</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr>
|
||
<td><code>INST-001</code></td>
|
||
<td>报装流程管理</td>
|
||
<td>申请受理、踏勘流转与方案编制</td>
|
||
<td><a href="./15_INST_Detailed.md#mod-inst-001">INST-001</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>INST-002</code></td>
|
||
<td>工程管理</td>
|
||
<td>施工验收、立户通水与合同签章协同</td>
|
||
<td><a href="./15_INST_Detailed.md#mod-inst-003">INST-002</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>INST-003</code></td>
|
||
<td>档案管理</td>
|
||
<td>材料归档、签章回执留存与过程可追溯</td>
|
||
<td><a href="./15_INST_Detailed.md#mod-inst-005">INST-003</a></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<h2 data-number="8.3" id="正文入口-4"><span
|
||
class="header-section-number">8.3</span> 正文入口</h2>
|
||
<ul>
|
||
<li><a
|
||
href="./15_INST_Detailed.md#sec-content">报装与签章模块正文</a></li>
|
||
<li><a href="./03_CA_Esignature_Supplement.md#sec-position">报装 CA
|
||
电子签章专项补充</a></li>
|
||
</ul>
|
||
<p><a id="sec-database-detail"></a></p>
|
||
<h1 data-number="9" id="数据库详细设计"><span
|
||
class="header-section-number">9</span> 数据库详细设计</h1>
|
||
<h2 data-number="9.1" id="数据库选型与原则"><span
|
||
class="header-section-number">9.1</span> 数据库选型与原则</h2>
|
||
<p>系统数据库统一采用达梦数据库 8.0+。数据库设计遵循以下原则：</p>
|
||
<ol type="1">
|
||
<li>统一主数据模型，避免多口径重复建模。</li>
|
||
<li>面向业务闭环设计客户、水表、账单、缴费、工单、报装、签章等核心对象。</li>
|
||
<li>兼顾 OLTP 事务处理与统计查询性能。</li>
|
||
<li>支持多单位、多区域的数据隔离与权限过滤。</li>
|
||
<li>敏感数据字段满足加密、脱敏和审计要求。</li>
|
||
</ol>
|
||
<h2 data-number="9.2" id="数据库逻辑架构"><span
|
||
class="header-section-number">9.2</span> 数据库逻辑架构</h2>
|
||
<pre class="mermaid"><code>graph TB
|
||
APP[业务应用] --> ORM[数据访问层]
|
||
APP --> CACHE[Redis缓存]
|
||
ORM --> MASTER[(达梦主库)]
|
||
MASTER --> SLAVE[(达梦从库/备库)]
|
||
MASTER --> FILE[文件与归档索引]
|
||
</code></pre>
|
||
<h2 data-number="9.3" id="核心数据模型"><span
|
||
class="header-section-number">9.3</span> 核心数据模型</h2>
|
||
<pre class="mermaid"><code>erDiagram
|
||
BIZ_CUST ||--o{ BIZ_CUST_CONTACT : 包含
|
||
BIZ_CUST ||--o{ BIZ_CUST_METER : 绑定
|
||
BIZ_CUST ||--|| BIZ_ACCOUNT : 对应
|
||
BIZ_METER ||--o{ BIZ_READING_DATA : 产生
|
||
BIZ_READING_DATA ||--|| BIZ_CHARGE : 生成
|
||
BIZ_CHARGE ||--o{ BIZ_CHARGE_DETAIL : 包含
|
||
BIZ_CHARGE ||--o{ BK_TRANSACTION : 核销
|
||
BIZ_CUST ||--o{ BIZ_INVOICE : 开票
|
||
INSTALLATION_APPLY ||--o{ INSTALLATION_CONTRACT : 生成
|
||
INSTALLATION_CONTRACT ||--o{ INSTALLATION_SIGNATURE : 签署
|
||
INSTALLATION_CONTRACT ||--o{ INSTALLATION_EVIDENCE : 存证
|
||
</code></pre>
|
||
<h2 data-number="9.4" id="核心数据表设计"><span
|
||
class="header-section-number">9.4</span> 核心数据表设计</h2>
|
||
<h3 data-number="9.4.1" id="客户与账户类"><span
|
||
class="header-section-number">9.4.1</span> 客户与账户类</h3>
|
||
<table>
|
||
<colgroup>
|
||
<col style="width: 33%" />
|
||
<col style="width: 33%" />
|
||
<col style="width: 33%" />
|
||
</colgroup>
|
||
<thead>
|
||
<tr>
|
||
<th>表名</th>
|
||
<th>说明</th>
|
||
<th>关键字段</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr>
|
||
<td><code>biz_cust</code></td>
|
||
<td>客户主档表</td>
|
||
<td>code、name、cust_type、id_no、mobile、address、status</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>biz_account</code></td>
|
||
<td>客户账户表</td>
|
||
<td>code、cust_id、balance、arrears_amount、status</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>biz_cust_contact</code></td>
|
||
<td>客户联系人表</td>
|
||
<td>cust_id、name、mobile、contact_type、is_default</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>biz_cust_app_binds</code></td>
|
||
<td>渠道绑定关系表</td>
|
||
<td>cust_id、app_type、app_user_id、status</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>biz_cust_invoice</code></td>
|
||
<td>客户开票信息表</td>
|
||
<td>cust_id、invoice_title、tax_no、email、mobile</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<h3 data-number="9.4.2" id="水表与抄表类"><span
|
||
class="header-section-number">9.4.2</span> 水表与抄表类</h3>
|
||
<table>
|
||
<colgroup>
|
||
<col style="width: 33%" />
|
||
<col style="width: 33%" />
|
||
<col style="width: 33%" />
|
||
</colgroup>
|
||
<thead>
|
||
<tr>
|
||
<th>表名</th>
|
||
<th>说明</th>
|
||
<th>关键字段</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr>
|
||
<td><code>biz_meter</code></td>
|
||
<td>水表信息表</td>
|
||
<td>code、meter_no、model_code、caliber_code、status</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>biz_cust_meter</code></td>
|
||
<td>客户与水表关系表</td>
|
||
<td>cust_id、meter_id、bind_status、bind_time</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>biz_meter_book</code></td>
|
||
<td>抄表册本表</td>
|
||
<td>code、name、reader_id、cycle_type、status</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>biz_reading_data</code></td>
|
||
<td>抄表数据表</td>
|
||
<td>meter_id、cust_id、reading_time、current_reading、usage_amount</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>biz_last_reading</code></td>
|
||
<td>上次抄表结果表</td>
|
||
<td>meter_id、last_reading、last_reading_time</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>biz_meter_read</code></td>
|
||
<td>抄表任务状态表</td>
|
||
<td>book_id、meter_id、read_status、reader_id</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<h3 data-number="9.4.3" id="账单收费与发票类"><span
|
||
class="header-section-number">9.4.3</span> 账单、收费与发票类</h3>
|
||
<table>
|
||
<colgroup>
|
||
<col style="width: 33%" />
|
||
<col style="width: 33%" />
|
||
<col style="width: 33%" />
|
||
</colgroup>
|
||
<thead>
|
||
<tr>
|
||
<th>表名</th>
|
||
<th>说明</th>
|
||
<th>关键字段</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr>
|
||
<td><code>biz_charge</code></td>
|
||
<td>营业账主表</td>
|
||
<td>code、cust_id、record_id、total_amount、charge_status</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>biz_charge_detail</code></td>
|
||
<td>营业账明细表</td>
|
||
<td>charge_id、cost_component_code、usage_amount、detail_amount</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>biz_collection</code></td>
|
||
<td>托收资料表</td>
|
||
<td>cust_id、channel_code、collection_status、apply_time</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>biz_withholding</code></td>
|
||
<td>代扣资料表</td>
|
||
<td>cust_id、agreement_no、withholding_status、sign_time</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>biz_invoice</code></td>
|
||
<td>发票主表</td>
|
||
<td>code、cust_id、invoice_status、invoice_type、issue_time</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>biz_invoice_taxrate</code></td>
|
||
<td>发票税率表</td>
|
||
<td>tax_code、tax_name、tax_rate、status</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<h3 data-number="9.4.4" id="银行渠道与交易类"><span
|
||
class="header-section-number">9.4.4</span> 银行渠道与交易类</h3>
|
||
<table>
|
||
<colgroup>
|
||
<col style="width: 33%" />
|
||
<col style="width: 33%" />
|
||
<col style="width: 33%" />
|
||
</colgroup>
|
||
<thead>
|
||
<tr>
|
||
<th>表名</th>
|
||
<th>说明</th>
|
||
<th>关键字段</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr>
|
||
<td><code>bk_payment_channel</code></td>
|
||
<td>支付渠道表</td>
|
||
<td>channel_code、channel_name、channel_type、status</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>bk_channel_api_config</code></td>
|
||
<td>渠道接口配置表</td>
|
||
<td>channel_code、api_url、sign_type、status</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>bk_channel_route_rule</code></td>
|
||
<td>渠道路由规则表</td>
|
||
<td>business_type、channel_code、priority、status</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>bk_transaction</code></td>
|
||
<td>渠道交易流水表</td>
|
||
<td>trade_no、biz_order_no、channel_code、trade_amount、trade_status</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>bk_transaction_callback</code></td>
|
||
<td>支付回调表</td>
|
||
<td>trade_no、callback_status、callback_time、payload</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>bk_transaction_exception</code></td>
|
||
<td>渠道异常表</td>
|
||
<td>trade_no、exception_type、exception_status、remark</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>bk_withholding_agreement</code></td>
|
||
<td>代扣签约表</td>
|
||
<td>agreement_no、cust_id、bank_code、status</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>bk_withholding_batch</code></td>
|
||
<td>代扣批次表</td>
|
||
<td>batch_no、batch_date、total_count、status</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>bk_withholding_item</code></td>
|
||
<td>代扣明细表</td>
|
||
<td>batch_no、cust_id、charge_id、item_status</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>bk_reconcile_batch</code></td>
|
||
<td>对账批次表</td>
|
||
<td>batch_no、channel_code、reconcile_date、status</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>bk_reconcile_diff</code></td>
|
||
<td>对账差异表</td>
|
||
<td>batch_no、trade_no、diff_type、diff_amount</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>bk_settlement_batch</code></td>
|
||
<td>结算批次表</td>
|
||
<td>batch_no、channel_code、settlement_date、status</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<h3 data-number="9.4.5" id="表务与工单类"><span
|
||
class="header-section-number">9.4.5</span> 表务与工单类</h3>
|
||
<table>
|
||
<colgroup>
|
||
<col style="width: 33%" />
|
||
<col style="width: 33%" />
|
||
<col style="width: 33%" />
|
||
</colgroup>
|
||
<thead>
|
||
<tr>
|
||
<th>表名</th>
|
||
<th>说明</th>
|
||
<th>关键字段</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr>
|
||
<td><code>biz_meter_log</code></td>
|
||
<td>表务工单/过程留痕表</td>
|
||
<td>biz_type、biz_id、operate_user、operate_time、remark</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>biz_meter_in_out</code></td>
|
||
<td>水表出入库主表</td>
|
||
<td>code、in_out_type、warehouse_id、operate_time、status</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>biz_meter_in_out_rel</code></td>
|
||
<td>出入库关联明细表</td>
|
||
<td>in_out_id、meter_id、quantity、status</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>biz_process</code></td>
|
||
<td>业务工单主表</td>
|
||
<td>code、biz_type_code、cust_id、process_status</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<h3 data-number="9.4.6" id="报装与签章类"><span
|
||
class="header-section-number">9.4.6</span> 报装与签章类</h3>
|
||
<table>
|
||
<colgroup>
|
||
<col style="width: 33%" />
|
||
<col style="width: 33%" />
|
||
<col style="width: 33%" />
|
||
</colgroup>
|
||
<thead>
|
||
<tr>
|
||
<th>表名</th>
|
||
<th>说明</th>
|
||
<th>关键字段</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr>
|
||
<td><code>biz_process</code></td>
|
||
<td>报装申请主表</td>
|
||
<td>code、biz_type_code、cust_id、process_status</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>biz_process_transfer</code></td>
|
||
<td>现场踏勘与流转表</td>
|
||
<td>process_id、from_user、to_user、transfer_time</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>installation_contract</code></td>
|
||
<td>报装合同表</td>
|
||
<td>contract_code、installation_id、contract_type、contract_status</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>installation_signature</code></td>
|
||
<td>签章记录表</td>
|
||
<td>signature_code、contract_id、signer_id、signature_time、signature_status</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>installation_evidence</code></td>
|
||
<td>存证记录表</td>
|
||
<td>evidence_code、contract_id、evidence_hash、evidence_status</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<h2 data-number="9.5" id="索引与性能设计"><span
|
||
class="header-section-number">9.5</span> 索引与性能设计</h2>
|
||
<h3 data-number="9.5.1" id="主要索引策略"><span
|
||
class="header-section-number">9.5.1</span> 主要索引策略</h3>
|
||
<ol type="1">
|
||
<li>唯一索引：客户编号、水表编号、账单编号、缴费编号、合同编号等业务唯一键。</li>
|
||
<li>复合索引：
|
||
<ul>
|
||
<li>客户查询：<code>(customer_type, status)</code></li>
|
||
<li>账单查询：<code>(customer_id, bill_month, bill_status)</code></li>
|
||
<li>抄表查询：<code>(meter_id, reading_date)</code></li>
|
||
<li>缴费查询：<code>(customer_id, payment_time)</code></li>
|
||
</ul></li>
|
||
<li>时间分区：账单、缴费、日志等大表按月或按年管理归档。</li>
|
||
<li>热点缓存：参数字典、用户会话、移动端任务、发票状态等进入
|
||
Redis。</li>
|
||
</ol>
|
||
<p><a id="sec-interface-detail"></a></p>
|
||
<h1 data-number="10" id="接口详细设计"><span
|
||
class="header-section-number">10</span> 接口详细设计</h1>
|
||
<h2 data-number="10.1" id="接口设计原则"><span
|
||
class="header-section-number">10.1</span> 接口设计原则</h2>
|
||
<ol type="1">
|
||
<li>内部接口统一采用 RESTful 风格，JSON 作为主要报文格式。</li>
|
||
<li>外部接口根据对接方规范支持 HTTPS API、SFTP 文件交换等方式。</li>
|
||
<li>接口编号统一采用 <code>IF-</code> 或 <code>EXT-</code>
|
||
前缀，与模块编号区分。</li>
|
||
<li>关键交易接口必须支持幂等控制、签名校验、失败重试与调用日志。</li>
|
||
</ol>
|
||
<h2 data-number="10.2" id="统一平台接口"><span
|
||
class="header-section-number">10.2</span> 统一平台接口</h2>
|
||
<table>
|
||
<colgroup>
|
||
<col style="width: 20%" />
|
||
<col style="width: 20%" />
|
||
<col style="width: 20%" />
|
||
<col style="width: 20%" />
|
||
<col style="width: 20%" />
|
||
</colgroup>
|
||
<thead>
|
||
<tr>
|
||
<th>接口编号</th>
|
||
<th>接口名称</th>
|
||
<th>功能描述</th>
|
||
<th>调用方</th>
|
||
<th>协议</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr>
|
||
<td>IF-UP-001</td>
|
||
<td>用户登录接口</td>
|
||
<td>用户登录并获取访问令牌</td>
|
||
<td>PC端/移动端/渠道端</td>
|
||
<td>HTTPS REST</td>
|
||
</tr>
|
||
<tr>
|
||
<td>IF-UP-002</td>
|
||
<td>用户信息接口</td>
|
||
<td>获取当前登录用户上下文</td>
|
||
<td>各业务系统</td>
|
||
<td>HTTPS REST</td>
|
||
</tr>
|
||
<tr>
|
||
<td>IF-UP-003</td>
|
||
<td>权限校验接口</td>
|
||
<td>校验菜单、按钮和数据权限</td>
|
||
<td>各业务模块</td>
|
||
<td>HTTPS REST</td>
|
||
</tr>
|
||
<tr>
|
||
<td>IF-UP-004</td>
|
||
<td>参数字典接口</td>
|
||
<td>获取字典与业务参数</td>
|
||
<td>各业务模块</td>
|
||
<td>HTTPS REST</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<h2 data-number="10.3" id="营收业务接口"><span
|
||
class="header-section-number">10.3</span> 营收业务接口</h2>
|
||
<table>
|
||
<colgroup>
|
||
<col style="width: 20%" />
|
||
<col style="width: 20%" />
|
||
<col style="width: 20%" />
|
||
<col style="width: 20%" />
|
||
<col style="width: 20%" />
|
||
</colgroup>
|
||
<thead>
|
||
<tr>
|
||
<th>接口编号</th>
|
||
<th>接口名称</th>
|
||
<th>功能描述</th>
|
||
<th>调用方</th>
|
||
<th>协议</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr>
|
||
<td>IF-REV-001</td>
|
||
<td>客户信息查询接口</td>
|
||
<td>查询客户档案、账户状态、联系人与水表绑定关系</td>
|
||
<td>柜台/客户渠道/工单</td>
|
||
<td>HTTPS REST</td>
|
||
</tr>
|
||
<tr>
|
||
<td>IF-REV-004</td>
|
||
<td>抄表数据提交接口</td>
|
||
<td>提交人工或远传抄表数据并触发校验</td>
|
||
<td>抄表APP/集抄系统</td>
|
||
<td>HTTPS REST</td>
|
||
</tr>
|
||
<tr>
|
||
<td>IF-REV-005</td>
|
||
<td>账单生成接口</td>
|
||
<td>根据抄表结果、水价模板和费用组成生成账单</td>
|
||
<td>开账任务</td>
|
||
<td>HTTPS REST</td>
|
||
</tr>
|
||
<tr>
|
||
<td>IF-REV-006</td>
|
||
<td>缴费处理接口</td>
|
||
<td>创建收费记录并核销账单</td>
|
||
<td>柜台/线上渠道</td>
|
||
<td>HTTPS REST</td>
|
||
</tr>
|
||
<tr>
|
||
<td>IF-REV-007</td>
|
||
<td>账务调整接口</td>
|
||
<td>发起金额调整、退款、冲正、坏账等业务处理</td>
|
||
<td>财务/营业人员</td>
|
||
<td>HTTPS REST</td>
|
||
</tr>
|
||
<tr>
|
||
<td>IF-REV-008</td>
|
||
<td>发票申请接口</td>
|
||
<td>发起开票申请并接收票据状态回写</td>
|
||
<td>柜台/客户渠道</td>
|
||
<td>HTTPS REST</td>
|
||
</tr>
|
||
<tr>
|
||
<td>IF-REV-009</td>
|
||
<td>催缴任务接口</td>
|
||
<td>生成催缴名单并提交消息触达请求</td>
|
||
<td>营收系统/消息服务</td>
|
||
<td>HTTPS REST</td>
|
||
</tr>
|
||
<tr>
|
||
<td>IF-REV-010</td>
|
||
<td>统计查询接口</td>
|
||
<td>查询营收、收费、欠费、渠道、客户统计结果</td>
|
||
<td>管理后台/统计分析端</td>
|
||
<td>HTTPS REST</td>
|
||
</tr>
|
||
<tr>
|
||
<td>IF-REV-011</td>
|
||
<td>银行代收协同接口</td>
|
||
<td>发起代扣、回盘、对账、结算协同</td>
|
||
<td>银行代收模块/SYS-009</td>
|
||
<td>HTTPS REST / 文件交换</td>
|
||
</tr>
|
||
<tr>
|
||
<td>IF-REV-012</td>
|
||
<td>业务参数配置接口</td>
|
||
<td>查询和维护价格模板、优惠方案、业务参数配置</td>
|
||
<td>管理后台/参数管理端</td>
|
||
<td>HTTPS REST</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<h2 data-number="10.4" id="表务与物联网接口"><span
|
||
class="header-section-number">10.4</span> 表务与物联网接口</h2>
|
||
<table>
|
||
<colgroup>
|
||
<col style="width: 20%" />
|
||
<col style="width: 20%" />
|
||
<col style="width: 20%" />
|
||
<col style="width: 20%" />
|
||
<col style="width: 20%" />
|
||
</colgroup>
|
||
<thead>
|
||
<tr>
|
||
<th>接口编号</th>
|
||
<th>接口名称</th>
|
||
<th>功能描述</th>
|
||
<th>调用方</th>
|
||
<th>协议</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr>
|
||
<td>IF-METER-001</td>
|
||
<td>水表档案查询接口</td>
|
||
<td>查询水表与生命周期信息</td>
|
||
<td>表务/营收/报装</td>
|
||
<td>HTTPS REST</td>
|
||
</tr>
|
||
<tr>
|
||
<td>IF-METER-002</td>
|
||
<td>表务工单处理接口</td>
|
||
<td>提交换表、移表等结果</td>
|
||
<td>移动作业端</td>
|
||
<td>HTTPS REST</td>
|
||
</tr>
|
||
<tr>
|
||
<td>IF-METER-003</td>
|
||
<td>库存出入库接口</td>
|
||
<td>处理领用、退库、报废</td>
|
||
<td>仓储管理端</td>
|
||
<td>HTTPS REST</td>
|
||
</tr>
|
||
<tr>
|
||
<td>IF-METER-004</td>
|
||
<td>集抄数据接收接口</td>
|
||
<td>接收远程抄表数据</td>
|
||
<td>物联网平台</td>
|
||
<td>HTTPS REST</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<h2 data-number="10.5" id="报装与签章接口"><span
|
||
class="header-section-number">10.5</span> 报装与签章接口</h2>
|
||
<table>
|
||
<colgroup>
|
||
<col style="width: 20%" />
|
||
<col style="width: 20%" />
|
||
<col style="width: 20%" />
|
||
<col style="width: 20%" />
|
||
<col style="width: 20%" />
|
||
</colgroup>
|
||
<thead>
|
||
<tr>
|
||
<th>接口编号</th>
|
||
<th>接口名称</th>
|
||
<th>功能描述</th>
|
||
<th>调用方</th>
|
||
<th>协议</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr>
|
||
<td>IF-INST-001</td>
|
||
<td>报装申请提交接口</td>
|
||
<td>提交报装申请与附件</td>
|
||
<td>柜台/微网厅/政务平台</td>
|
||
<td>HTTPS REST</td>
|
||
</tr>
|
||
<tr>
|
||
<td>IF-INST-002</td>
|
||
<td>踏勘结果回填接口</td>
|
||
<td>回填现场踏勘结果</td>
|
||
<td>报装人员</td>
|
||
<td>HTTPS REST</td>
|
||
</tr>
|
||
<tr>
|
||
<td>IF-INST-003</td>
|
||
<td>合同签署发起接口</td>
|
||
<td>创建签章任务</td>
|
||
<td>报装系统</td>
|
||
<td>HTTPS REST</td>
|
||
</tr>
|
||
<tr>
|
||
<td>IF-INST-004</td>
|
||
<td>签章回执接口</td>
|
||
<td>回写签章结果和存证信息</td>
|
||
<td>CA系统/报装系统</td>
|
||
<td>HTTPS REST</td>
|
||
</tr>
|
||
<tr>
|
||
<td>IF-INST-005</td>
|
||
<td>报装归档接口</td>
|
||
<td>归档申请、合同和验收资料</td>
|
||
<td>报装系统</td>
|
||
<td>HTTPS REST</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<h2 data-number="10.6" id="客户渠道接口"><span
|
||
class="header-section-number">10.6</span> 客户渠道接口</h2>
|
||
<table>
|
||
<colgroup>
|
||
<col style="width: 20%" />
|
||
<col style="width: 20%" />
|
||
<col style="width: 20%" />
|
||
<col style="width: 20%" />
|
||
<col style="width: 20%" />
|
||
</colgroup>
|
||
<thead>
|
||
<tr>
|
||
<th>接口编号</th>
|
||
<th>接口名称</th>
|
||
<th>功能描述</th>
|
||
<th>调用方</th>
|
||
<th>协议</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr>
|
||
<td>IF-CS-001</td>
|
||
<td>账户绑定接口</td>
|
||
<td>绑定或解绑客户账户</td>
|
||
<td>微信/支付宝/微网厅</td>
|
||
<td>HTTPS REST</td>
|
||
</tr>
|
||
<tr>
|
||
<td>IF-CS-002</td>
|
||
<td>历史账单查询接口</td>
|
||
<td>查询账单、欠费、用水趋势</td>
|
||
<td>客户端</td>
|
||
<td>HTTPS REST</td>
|
||
</tr>
|
||
<tr>
|
||
<td>IF-CS-003</td>
|
||
<td>在线支付下单接口</td>
|
||
<td>创建微信/支付宝支付订单</td>
|
||
<td>客户端</td>
|
||
<td>HTTPS REST</td>
|
||
</tr>
|
||
<tr>
|
||
<td>IF-CS-004</td>
|
||
<td>发票申请接口</td>
|
||
<td>提交电子发票申请</td>
|
||
<td>客户端</td>
|
||
<td>HTTPS REST</td>
|
||
</tr>
|
||
<tr>
|
||
<td>IF-CS-005</td>
|
||
<td>网点与业务办理接口</td>
|
||
<td>查询网点、提交业务办理</td>
|
||
<td>客户端</td>
|
||
<td>HTTPS REST</td>
|
||
</tr>
|
||
<tr>
|
||
<td>IF-CS-006</td>
|
||
<td>业务办理进度接口</td>
|
||
<td>查询业务办理和工单进度</td>
|
||
<td>客户端</td>
|
||
<td>HTTPS REST</td>
|
||
</tr>
|
||
<tr>
|
||
<td>IF-CS-007</td>
|
||
<td>柜面扫码支付接口</td>
|
||
<td>创建柜面扫码支付订单并回写结果</td>
|
||
<td>柜台终端/营业前台</td>
|
||
<td>HTTPS REST</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<h2 data-number="10.7" id="外部系统接口"><span
|
||
class="header-section-number">10.7</span> 外部系统接口</h2>
|
||
<h3 data-number="10.7.1" id="金融支付接口"><span
|
||
class="header-section-number">10.7.1</span> 金融支付接口</h3>
|
||
<table style="width:100%;">
|
||
<colgroup>
|
||
<col style="width: 16%" />
|
||
<col style="width: 16%" />
|
||
<col style="width: 16%" />
|
||
<col style="width: 16%" />
|
||
<col style="width: 16%" />
|
||
<col style="width: 16%" />
|
||
</colgroup>
|
||
<thead>
|
||
<tr>
|
||
<th>接口编号</th>
|
||
<th>接口名称</th>
|
||
<th>功能描述</th>
|
||
<th>协议</th>
|
||
<th>输入参数</th>
|
||
<th>输出结果</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr>
|
||
<td>EXT-001</td>
|
||
<td>银行代扣接口</td>
|
||
<td>批量代扣水费</td>
|
||
<td>HTTPS/SFTP</td>
|
||
<td>客户信息、账单金额、代扣日期</td>
|
||
<td>扣款结果</td>
|
||
</tr>
|
||
<tr>
|
||
<td>EXT-101</td>
|
||
<td>微信支付统一下单</td>
|
||
<td>创建微信支付订单</td>
|
||
<td>HTTPS</td>
|
||
<td>订单信息、金额</td>
|
||
<td>预支付信息</td>
|
||
</tr>
|
||
<tr>
|
||
<td>EXT-201</td>
|
||
<td>支付宝统一收单</td>
|
||
<td>创建支付宝支付订单</td>
|
||
<td>HTTPS</td>
|
||
<td>订单信息、金额</td>
|
||
<td>支付结果</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<h3 data-number="10.7.2" id="税务与消息接口"><span
|
||
class="header-section-number">10.7.2</span> 税务与消息接口</h3>
|
||
<table style="width:100%;">
|
||
<colgroup>
|
||
<col style="width: 16%" />
|
||
<col style="width: 16%" />
|
||
<col style="width: 16%" />
|
||
<col style="width: 16%" />
|
||
<col style="width: 16%" />
|
||
<col style="width: 16%" />
|
||
</colgroup>
|
||
<thead>
|
||
<tr>
|
||
<th>接口编号</th>
|
||
<th>接口名称</th>
|
||
<th>功能描述</th>
|
||
<th>协议</th>
|
||
<th>输入参数</th>
|
||
<th>输出结果</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr>
|
||
<td>EXT-301</td>
|
||
<td>短信发送接口</td>
|
||
<td>发送催缴或通知短信</td>
|
||
<td>HTTPS</td>
|
||
<td>手机号、模板、参数</td>
|
||
<td>发送结果</td>
|
||
</tr>
|
||
<tr>
|
||
<td>EXT-401</td>
|
||
<td>邮件发送接口</td>
|
||
<td>发送电子发票或通知邮件</td>
|
||
<td>HTTPS</td>
|
||
<td>邮箱、主题、内容</td>
|
||
<td>发送结果</td>
|
||
</tr>
|
||
<tr>
|
||
<td>EXT-501</td>
|
||
<td>电子发票开具接口</td>
|
||
<td>税控平台开票</td>
|
||
<td>HTTPS</td>
|
||
<td>发票信息、税率</td>
|
||
<td>发票结果</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<h3 data-number="10.7.3" id="物联网政务与签章接口"><span
|
||
class="header-section-number">10.7.3</span> 物联网、政务与签章接口</h3>
|
||
<table style="width:100%;">
|
||
<colgroup>
|
||
<col style="width: 16%" />
|
||
<col style="width: 16%" />
|
||
<col style="width: 16%" />
|
||
<col style="width: 16%" />
|
||
<col style="width: 16%" />
|
||
<col style="width: 16%" />
|
||
</colgroup>
|
||
<thead>
|
||
<tr>
|
||
<th>接口编号</th>
|
||
<th>接口名称</th>
|
||
<th>功能描述</th>
|
||
<th>协议</th>
|
||
<th>输入参数</th>
|
||
<th>输出结果</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr>
|
||
<td>EXT-601</td>
|
||
<td>水表数据采集接口</td>
|
||
<td>获取远程抄表数据</td>
|
||
<td>HTTPS</td>
|
||
<td>水表编号、时间范围</td>
|
||
<td>抄表数据</td>
|
||
</tr>
|
||
<tr>
|
||
<td>EXT-701</td>
|
||
<td>政务数据汇聚接口</td>
|
||
<td>向政务平台推送业务数据</td>
|
||
<td>HTTPS</td>
|
||
<td>业务数据、统计数据</td>
|
||
<td>推送结果</td>
|
||
</tr>
|
||
<tr>
|
||
<td>EXT-801</td>
|
||
<td>环卫收费对接接口</td>
|
||
<td>同步污水费/环卫收费数据</td>
|
||
<td>HTTPS</td>
|
||
<td>收费数据</td>
|
||
<td>同步结果</td>
|
||
</tr>
|
||
<tr>
|
||
<td>EXT-901</td>
|
||
<td>客服工单创建接口</td>
|
||
<td>与客服系统同步工单</td>
|
||
<td>HTTPS</td>
|
||
<td>工单信息</td>
|
||
<td>工单编号</td>
|
||
</tr>
|
||
<tr>
|
||
<td>EXT-1001</td>
|
||
<td>消火栓控制接口</td>
|
||
<td>控制取水权限与设备状态</td>
|
||
<td>HTTPS</td>
|
||
<td>设备信息、控制指令</td>
|
||
<td>控制结果</td>
|
||
</tr>
|
||
<tr>
|
||
<td>EXT-CA-001</td>
|
||
<td>身份认证接口</td>
|
||
<td>验证合同签署方身份</td>
|
||
<td>HTTPS REST</td>
|
||
<td>用户信息、认证方式</td>
|
||
<td>认证结果</td>
|
||
</tr>
|
||
<tr>
|
||
<td>EXT-CA-002</td>
|
||
<td>电子签章接口</td>
|
||
<td>执行电子签章</td>
|
||
<td>HTTPS REST</td>
|
||
<td>文档内容、签章位置</td>
|
||
<td>签章结果</td>
|
||
</tr>
|
||
<tr>
|
||
<td>EXT-CA-003</td>
|
||
<td>时间戳接口</td>
|
||
<td>申请签署时间戳</td>
|
||
<td>HTTPS REST</td>
|
||
<td>文档哈希</td>
|
||
<td>时间戳凭证</td>
|
||
</tr>
|
||
<tr>
|
||
<td>EXT-CA-004</td>
|
||
<td>电子存证接口</td>
|
||
<td>存储签署后合同</td>
|
||
<td>HTTPS REST</td>
|
||
<td>签署文档、元数据</td>
|
||
<td>存证凭证</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<p><a id="sec-security-detail"></a></p>
|
||
<h1 data-number="11" id="安全详细设计"><span
|
||
class="header-section-number">11</span> 安全详细设计</h1>
|
||
<h2 data-number="11.1" id="安全目标与分层防护"><span
|
||
class="header-section-number">11.1</span> 安全目标与分层防护</h2>
|
||
<p>系统安全设计遵循机密性、完整性、可用性、可审计性原则，采用边界安全、应用安全、数据安全、运维安全四层防护模式。</p>
|
||
<pre class="mermaid"><code>graph TB
|
||
T[外部威胁] --> N[边界安全]
|
||
N --> A[应用安全]
|
||
A --> D[数据安全]
|
||
D --> O[运维安全]
|
||
O --> C[核心业务资产]
|
||
</code></pre>
|
||
<h2 data-number="11.2" id="身份认证与访问控制"><span
|
||
class="header-section-number">11.2</span> 身份认证与访问控制</h2>
|
||
<ol type="1">
|
||
<li>采用 OAuth2.0 + JWT 统一认证。</li>
|
||
<li>高风险操作支持 MFA 二次认证。</li>
|
||
<li>基于 RBAC 的菜单、按钮、数据权限控制。</li>
|
||
<li>管理端、移动端、客户端、外部系统按不同安全域实施权限隔离。</li>
|
||
</ol>
|
||
<h2 data-number="11.3" id="数据安全与隐私保护"><span
|
||
class="header-section-number">11.3</span> 数据安全与隐私保护</h2>
|
||
<ol type="1">
|
||
<li>核心数据库统一为达梦数据库 8.0+，关键数据按要求启用加密存储。</li>
|
||
<li>身份证号、手机号、银行账户等敏感字段按角色脱敏展示。</li>
|
||
<li>文件、合同、签章凭证、验收附件统一归档并控制访问权限。</li>
|
||
<li>备份数据加密存储，支持异地容灾保管。</li>
|
||
</ol>
|
||
<h2 data-number="11.4" id="接口安全与审计追踪"><span
|
||
class="header-section-number">11.4</span> 接口安全与审计追踪</h2>
|
||
<ul>
|
||
<li>所有外部接口采用 HTTPS 加密传输。</li>
|
||
<li>关键接口支持签名、时间戳、随机数防重放。</li>
|
||
<li>支付、退款、签章、账务调整等交易型接口必须具备幂等控制。</li>
|
||
<li>统一记录调用时间、调用方、请求摘要、响应结果、异常码与处理人。</li>
|
||
</ul>
|
||
<h2 data-number="11.5" id="安全运营与应急响应"><span
|
||
class="header-section-number">11.5</span> 安全运营与应急响应</h2>
|
||
<ol type="1">
|
||
<li>建立暴力破解、异常访问、接口失败、支付异常、签章异常等监控规则。</li>
|
||
<li>按 P0~P3 级别定义安全事件处置流程。</li>
|
||
<li>定期进行漏洞扫描、补丁更新、备份恢复演练和权限审计。</li>
|
||
</ol>
|
||
<p><a id="sec-deployment-detail"></a></p>
|
||
<h1 data-number="12" id="部署与运维设计"><span
|
||
class="header-section-number">12</span> 部署与运维设计</h1>
|
||
<h2 data-number="12.1" id="部署总体方案"><span
|
||
class="header-section-number">12.1</span> 部署总体方案</h2>
|
||
<p>系统采用集中部署模式，生产环境分为接入区、应用区、数据区、运维管理区，支持主备容灾与横向扩展。</p>
|
||
<pre class="mermaid"><code>graph TB
|
||
U[外部访问] --> LB[负载均衡/Nginx]
|
||
LB --> APP1[应用节点1]
|
||
LB --> APP2[应用节点2]
|
||
LB --> APP3[应用节点3]
|
||
APP1 --> DB[(达梦主库)]
|
||
APP2 --> DB
|
||
APP3 --> DB
|
||
DB --> DBS[(达梦备库/从库)]
|
||
APP1 --> REDIS[(Redis)]
|
||
APP1 --> FILE[对象存储]
|
||
APP1 --> MON[监控与日志平台]
|
||
</code></pre>
|
||
<h2 data-number="12.2" id="环境规划"><span
|
||
class="header-section-number">12.2</span> 环境规划</h2>
|
||
<table>
|
||
<thead>
|
||
<tr>
|
||
<th>环境</th>
|
||
<th>用途</th>
|
||
<th>说明</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr>
|
||
<td>开发环境</td>
|
||
<td>开发联调</td>
|
||
<td>功能开发、单元验证</td>
|
||
</tr>
|
||
<tr>
|
||
<td>测试环境</td>
|
||
<td>集成测试</td>
|
||
<td>接口联调、业务测试、性能测试</td>
|
||
</tr>
|
||
<tr>
|
||
<td>预生产环境</td>
|
||
<td>上线前验证</td>
|
||
<td>模拟生产配置，进行发布演练</td>
|
||
</tr>
|
||
<tr>
|
||
<td>生产环境</td>
|
||
<td>正式运行</td>
|
||
<td>双机或多节点高可用部署</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<h2 data-number="12.3" id="网络与分区设计"><span
|
||
class="header-section-number">12.3</span> 网络与分区设计</h2>
|
||
<ol type="1">
|
||
<li>DMZ 区部署负载均衡、WAF、网关等对外接入组件。</li>
|
||
<li>应用区部署统一平台、营收、表务、报装、客户渠道等应用节点。</li>
|
||
<li>数据区部署达梦数据库、Redis、对象存储与备份服务。</li>
|
||
<li>管理区部署堡垒机、日志平台、监控平台和运维工具。</li>
|
||
</ol>
|
||
<h2 data-number="12.4" id="监控告警与日志"><span
|
||
class="header-section-number">12.4</span> 监控告警与日志</h2>
|
||
<h3 data-number="12.4.1" id="监控指标"><span
|
||
class="header-section-number">12.4.1</span> 监控指标</h3>
|
||
<table>
|
||
<thead>
|
||
<tr>
|
||
<th>类别</th>
|
||
<th>监控项</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr>
|
||
<td>主机监控</td>
|
||
<td>CPU、内存、磁盘、网络</td>
|
||
</tr>
|
||
<tr>
|
||
<td>应用监控</td>
|
||
<td>QPS、响应时间、错误率、线程池</td>
|
||
</tr>
|
||
<tr>
|
||
<td>数据库监控</td>
|
||
<td>连接数、慢 SQL、锁等待、主备同步</td>
|
||
</tr>
|
||
<tr>
|
||
<td>业务监控</td>
|
||
<td>开账量、收费量、退款量、签章成功率</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<h3 data-number="12.4.2" id="日志分类"><span
|
||
class="header-section-number">12.4.2</span> 日志分类</h3>
|
||
<ul>
|
||
<li>操作日志</li>
|
||
<li>登录日志</li>
|
||
<li>接口调用日志</li>
|
||
<li>任务执行日志</li>
|
||
<li>安全审计日志</li>
|
||
<li>外部系统对接日志</li>
|
||
</ul>
|
||
<h2 data-number="12.5" id="备份恢复与发布管理"><span
|
||
class="header-section-number">12.5</span> 备份恢复与发布管理</h2>
|
||
<ol type="1">
|
||
<li>数据库执行每日增量、每周全量备份。</li>
|
||
<li>关键文件、合同、电子发票、签章凭证同步纳入备份。</li>
|
||
<li>发布采用版本化管理，执行发布审批、健康检查、回滚预案。</li>
|
||
<li>对支付、签章、银行代扣等关键链路执行灰度验证前置检查，但生产方案不保留脚本碎片或临时配置片段。</li>
|
||
</ol>
|
||
<p><a id="sec-appendix"></a></p>
|
||
<h1 data-number="13" id="附录"><span
|
||
class="header-section-number">13</span> 附录</h1>
|
||
<h2 data-number="13.1" id="附录a-模块编号说明"><span
|
||
class="header-section-number">13.1</span> 附录A 模块编号说明</h2>
|
||
<table>
|
||
<thead>
|
||
<tr>
|
||
<th>前缀</th>
|
||
<th>模块域</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr>
|
||
<td>UP</td>
|
||
<td>统一平台</td>
|
||
</tr>
|
||
<tr>
|
||
<td>REV</td>
|
||
<td>营收业务</td>
|
||
</tr>
|
||
<tr>
|
||
<td>METER</td>
|
||
<td>表务管理</td>
|
||
</tr>
|
||
<tr>
|
||
<td>INST</td>
|
||
<td>报装与签章</td>
|
||
</tr>
|
||
<tr>
|
||
<td>CS</td>
|
||
<td>客户服务与渠道</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<h2 data-number="13.2" id="附录b-接口编号说明"><span
|
||
class="header-section-number">13.2</span> 附录B 接口编号说明</h2>
|
||
<table>
|
||
<thead>
|
||
<tr>
|
||
<th>前缀</th>
|
||
<th>说明</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr>
|
||
<td>IF-UP / IF-REV / IF-CS / IF-METER / IF-INST</td>
|
||
<td>系统内部标准接口</td>
|
||
</tr>
|
||
<tr>
|
||
<td>IF-EXT</td>
|
||
<td>对外系统接口</td>
|
||
</tr>
|
||
<tr>
|
||
<td>EXT-CA</td>
|
||
<td>历史资料中的电子签章专项外部接口编号（存量引用）</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<h2 data-number="13.3" id="附录c-设计约束与统一口径"><span
|
||
class="header-section-number">13.3</span> 附录C 设计约束与统一口径</h2>
|
||
<ol type="1">
|
||
<li>系统名称统一为“福建水务营收系统”。</li>
|
||
<li>数据库口径统一为“达梦数据库 8.0+”。</li>
|
||
<li>模块编号统一采用 <code>UP/REV/METER/INST/CS-001</code> 风格。</li>
|
||
<li>接口编号统一采用
|
||
<code>IF-UP/IF-REV/IF-CS/IF-METER/IF-INST/IF-EXT-001</code> 风格，历史
|
||
<code>EXT-*</code> 仅用于存量资料引用。</li>
|
||
<li>本文档为唯一主详设文件，其他专项文档作为历史参考与内容来源，不再作为并行主文件使用。</li>
|
||
</ol>
|
||
</body>
|
||
</html>
|