1772 lines
90 KiB
HTML
1772 lines
90 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;}
|
||
/* CSS for syntax highlighting */
|
||
pre > code.sourceCode { white-space: pre; position: relative; }
|
||
pre > code.sourceCode > span { line-height: 1.25; }
|
||
pre > code.sourceCode > span:empty { height: 1.2em; }
|
||
.sourceCode { overflow: visible; }
|
||
code.sourceCode > span { color: inherit; text-decoration: inherit; }
|
||
div.sourceCode { margin: 1em 0; }
|
||
pre.sourceCode { margin: 0; }
|
||
@media screen {
|
||
div.sourceCode { overflow: auto; }
|
||
}
|
||
@media print {
|
||
pre > code.sourceCode { white-space: pre-wrap; }
|
||
pre > code.sourceCode > span { display: inline-block; text-indent: -5em; padding-left: 5em; }
|
||
}
|
||
pre.numberSource code
|
||
{ counter-reset: source-line 0; }
|
||
pre.numberSource code > span
|
||
{ position: relative; left: -4em; counter-increment: source-line; }
|
||
pre.numberSource code > span > a:first-child::before
|
||
{ content: counter(source-line);
|
||
position: relative; left: -1em; text-align: right; vertical-align: baseline;
|
||
border: none; display: inline-block;
|
||
-webkit-touch-callout: none; -webkit-user-select: none;
|
||
-khtml-user-select: none; -moz-user-select: none;
|
||
-ms-user-select: none; user-select: none;
|
||
padding: 0 4px; width: 4em;
|
||
color: #aaaaaa;
|
||
}
|
||
pre.numberSource { margin-left: 3em; border-left: 1px solid #aaaaaa; padding-left: 4px; }
|
||
div.sourceCode
|
||
{ background-color: #f8f8f8; }
|
||
@media screen {
|
||
pre > code.sourceCode > span > a:first-child::before { text-decoration: underline; }
|
||
}
|
||
code span.al { color: #ef2929; } /* Alert */
|
||
code span.an { color: #8f5902; font-weight: bold; font-style: italic; } /* Annotation */
|
||
code span.at { color: #204a87; } /* Attribute */
|
||
code span.bn { color: #0000cf; } /* BaseN */
|
||
code span.cf { color: #204a87; font-weight: bold; } /* ControlFlow */
|
||
code span.ch { color: #4e9a06; } /* Char */
|
||
code span.cn { color: #8f5902; } /* Constant */
|
||
code span.co { color: #8f5902; font-style: italic; } /* Comment */
|
||
code span.cv { color: #8f5902; font-weight: bold; font-style: italic; } /* CommentVar */
|
||
code span.do { color: #8f5902; font-weight: bold; font-style: italic; } /* Documentation */
|
||
code span.dt { color: #204a87; } /* DataType */
|
||
code span.dv { color: #0000cf; } /* DecVal */
|
||
code span.er { color: #a40000; font-weight: bold; } /* Error */
|
||
code span.ex { } /* Extension */
|
||
code span.fl { color: #0000cf; } /* Float */
|
||
code span.fu { color: #204a87; font-weight: bold; } /* Function */
|
||
code span.im { } /* Import */
|
||
code span.in { color: #8f5902; font-weight: bold; font-style: italic; } /* Information */
|
||
code span.kw { color: #204a87; font-weight: bold; } /* Keyword */
|
||
code span.op { color: #ce5c00; font-weight: bold; } /* Operator */
|
||
code span.ot { color: #8f5902; } /* Other */
|
||
code span.pp { color: #8f5902; font-style: italic; } /* Preprocessor */
|
||
code span.sc { color: #ce5c00; font-weight: bold; } /* SpecialChar */
|
||
code span.ss { color: #4e9a06; } /* SpecialString */
|
||
code span.st { color: #4e9a06; } /* String */
|
||
code span.va { color: #000000; } /* Variable */
|
||
code span.vs { color: #4e9a06; } /* VerbatimString */
|
||
code span.wa { color: #8f5902; font-weight: bold; font-style: italic; } /* Warning */
|
||
</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>
|
||
<li><a href="#一系统整体架构" id="toc-一系统整体架构"><span
|
||
class="toc-section-number">1.3</span> 一、系统整体架构</a>
|
||
<ul>
|
||
<li><a href="#系统架构图" id="toc-系统架构图"><span
|
||
class="toc-section-number">1.3.1</span> 1.1 系统架构图</a></li>
|
||
<li><a href="#技术架构图" id="toc-技术架构图"><span
|
||
class="toc-section-number">1.3.2</span> 1.2 技术架构图</a></li>
|
||
<li><a href="#业务架构图" id="toc-业务架构图"><span
|
||
class="toc-section-number">1.3.3</span> 1.3 业务架构图</a></li>
|
||
</ul></li>
|
||
<li><a href="#二统一平台" id="toc-二统一平台"><span
|
||
class="toc-section-number">1.4</span> 二、统一平台</a>
|
||
<ul>
|
||
<li><a href="#单点登录" id="toc-单点登录"><span
|
||
class="toc-section-number">1.4.1</span> 2.1 单点登录</a></li>
|
||
<li><a href="#系统管理" id="toc-系统管理"><span
|
||
class="toc-section-number">1.4.2</span> 2.2 系统管理</a></li>
|
||
</ul></li>
|
||
<li><a href="#三营收系统" id="toc-三营收系统"><span
|
||
class="toc-section-number">1.5</span> 三、营收系统</a>
|
||
<ul>
|
||
<li><a href="#系统管理-1" id="toc-系统管理-1"><span
|
||
class="toc-section-number">1.5.1</span> 3.1 系统管理</a></li>
|
||
<li><a href="#抄表开账" id="toc-抄表开账"><span
|
||
class="toc-section-number">1.5.2</span> 3.2 抄表开账</a>
|
||
<ul>
|
||
<li><a href="#业务流程图" id="toc-业务流程图"><span
|
||
class="toc-section-number">1.5.2.1</span> 3.2.1 业务流程图</a></li>
|
||
<li><a href="#主要功能" id="toc-主要功能"><span
|
||
class="toc-section-number">1.5.2.2</span> 3.2.2 主要功能</a></li>
|
||
<li><a href="#核心接口定义" id="toc-核心接口定义"><span
|
||
class="toc-section-number">1.5.2.3</span> 3.2.3 核心接口定义</a></li>
|
||
<li><a href="#前端界面设计" id="toc-前端界面设计"><span
|
||
class="toc-section-number">1.5.2.4</span> 3.2.4 前端界面设计</a></li>
|
||
</ul></li>
|
||
<li><a href="#收费管理" id="toc-收费管理"><span
|
||
class="toc-section-number">1.5.3</span> 3.3 收费管理</a>
|
||
<ul>
|
||
<li><a href="#业务流程图-1" id="toc-业务流程图-1"><span
|
||
class="toc-section-number">1.5.3.1</span> 3.3.1 业务流程图</a></li>
|
||
<li><a href="#主要功能-1" id="toc-主要功能-1"><span
|
||
class="toc-section-number">1.5.3.2</span> 3.3.2 主要功能</a></li>
|
||
<li><a href="#核心接口定义-1" id="toc-核心接口定义-1"><span
|
||
class="toc-section-number">1.5.3.3</span> 3.3.3 核心接口定义</a></li>
|
||
</ul></li>
|
||
<li><a href="#账务处理" id="toc-账务处理"><span
|
||
class="toc-section-number">1.5.4</span> 3.4 账务处理</a>
|
||
<ul>
|
||
<li><a href="#业务流程图-2" id="toc-业务流程图-2"><span
|
||
class="toc-section-number">1.5.4.1</span> 3.4.1 业务流程图</a></li>
|
||
<li><a href="#主要功能-2" id="toc-主要功能-2"><span
|
||
class="toc-section-number">1.5.4.2</span> 3.4.2 主要功能</a></li>
|
||
<li><a href="#核心接口定义-2" id="toc-核心接口定义-2"><span
|
||
class="toc-section-number">1.5.4.3</span> 3.4.3 核心接口定义</a></li>
|
||
</ul></li>
|
||
<li><a href="#发票管理" id="toc-发票管理"><span
|
||
class="toc-section-number">1.5.5</span> 3.5 发票管理</a>
|
||
<ul>
|
||
<li><a href="#业务流程图-3" id="toc-业务流程图-3"><span
|
||
class="toc-section-number">1.5.5.1</span> 3.5.1 业务流程图</a></li>
|
||
<li><a href="#核心接口定义-3" id="toc-核心接口定义-3"><span
|
||
class="toc-section-number">1.5.5.2</span> 3.5.2 核心接口定义</a></li>
|
||
</ul></li>
|
||
<li><a href="#代收业务" id="toc-代收业务"><span
|
||
class="toc-section-number">1.5.6</span> 3.6 代收业务</a></li>
|
||
<li><a href="#环卫系统" id="toc-环卫系统"><span
|
||
class="toc-section-number">1.5.7</span> 3.7 环卫系统</a></li>
|
||
<li><a href="#业务工单" id="toc-业务工单"><span
|
||
class="toc-section-number">1.5.8</span> 3.8 业务工单</a></li>
|
||
</ul></li>
|
||
<li><a href="#四表务系统" id="toc-四表务系统"><span
|
||
class="toc-section-number">1.6</span> 四、表务系统</a>
|
||
<ul>
|
||
<li><a href="#表务工单" id="toc-表务工单"><span
|
||
class="toc-section-number">1.6.1</span> 4.1 表务工单</a></li>
|
||
<li><a href="#表务仓库" id="toc-表务仓库"><span
|
||
class="toc-section-number">1.6.2</span> 4.2 表务仓库</a></li>
|
||
<li><a href="#水表参数与基础信息" id="toc-水表参数与基础信息"><span
|
||
class="toc-section-number">1.6.3</span> 4.3 水表参数与基础信息</a></li>
|
||
<li><a href="#物联网对接与数据同步" id="toc-物联网对接与数据同步"><span
|
||
class="toc-section-number">1.6.4</span> 4.4
|
||
物联网对接与数据同步</a></li>
|
||
</ul></li>
|
||
<li><a href="#五报装系统" id="toc-五报装系统"><span
|
||
class="toc-section-number">1.7</span> 五、报装系统</a>
|
||
<ul>
|
||
<li><a href="#报装流程" id="toc-报装流程"><span
|
||
class="toc-section-number">1.7.1</span> 5.1 报装流程</a></li>
|
||
<li><a href="#一户一表管理" id="toc-一户一表管理"><span
|
||
class="toc-section-number">1.7.2</span> 5.2 一户一表管理</a></li>
|
||
</ul></li>
|
||
<li><a href="#六客户服务" id="toc-六客户服务"><span
|
||
class="toc-section-number">1.8</span> 六、客户服务</a>
|
||
<ul>
|
||
<li><a href="#微信支付宝服务窗" id="toc-微信支付宝服务窗"><span
|
||
class="toc-section-number">1.8.1</span> 6.1 微信、支付宝服务窗</a></li>
|
||
<li><a href="#历史账单" id="toc-历史账单"><span
|
||
class="toc-section-number">1.8.2</span> 6.2 历史账单</a></li>
|
||
<li><a href="#电子发票" id="toc-电子发票"><span
|
||
class="toc-section-number">1.8.3</span> 6.3 电子发票</a></li>
|
||
<li><a href="#营业网点" id="toc-营业网点"><span
|
||
class="toc-section-number">1.8.4</span> 6.4 营业网点</a></li>
|
||
<li><a href="#账户流水" id="toc-账户流水"><span
|
||
class="toc-section-number">1.8.5</span> 6.5 账户流水</a></li>
|
||
<li><a href="#微网厅" id="toc-微网厅"><span
|
||
class="toc-section-number">1.8.6</span> 6.6 微网厅</a></li>
|
||
</ul></li>
|
||
<li><a href="#七系统配置" id="toc-七系统配置"><span
|
||
class="toc-section-number">1.9</span> 七、系统配置</a>
|
||
<ul>
|
||
<li><a href="#水表参数" id="toc-水表参数"><span
|
||
class="toc-section-number">1.9.1</span> 7.1 水表参数</a></li>
|
||
<li><a href="#地址参数" id="toc-地址参数"><span
|
||
class="toc-section-number">1.9.2</span> 7.2 地址参数</a></li>
|
||
<li><a href="#价格体系" id="toc-价格体系"><span
|
||
class="toc-section-number">1.9.3</span> 7.3 价格体系</a></li>
|
||
<li><a href="#基本配置" id="toc-基本配置"><span
|
||
class="toc-section-number">1.9.4</span> 7.4 基本配置</a></li>
|
||
<li><a href="#催缴管理" id="toc-催缴管理"><span
|
||
class="toc-section-number">1.9.5</span> 7.5 催缴管理</a></li>
|
||
<li><a href="#用户权限" id="toc-用户权限"><span
|
||
class="toc-section-number">1.9.6</span> 7.6 用户权限</a></li>
|
||
<li><a href="#定时任务" id="toc-定时任务"><span
|
||
class="toc-section-number">1.9.7</span> 7.7 定时任务</a></li>
|
||
</ul></li>
|
||
<li><a href="#八系统接口" id="toc-八系统接口"><span
|
||
class="toc-section-number">1.10</span> 八、系统接口</a>
|
||
<ul>
|
||
<li><a href="#银行接口" id="toc-银行接口"><span
|
||
class="toc-section-number">1.10.1</span> 8.1 银行接口</a></li>
|
||
<li><a href="#支付宝微信接口" id="toc-支付宝微信接口"><span
|
||
class="toc-section-number">1.10.2</span> 8.2 支付宝/微信接口</a></li>
|
||
<li><a href="#短信接口" id="toc-短信接口"><span
|
||
class="toc-section-number">1.10.3</span> 8.3 短信接口</a></li>
|
||
<li><a href="#集抄系统接口" id="toc-集抄系统接口"><span
|
||
class="toc-section-number">1.10.4</span> 8.4 集抄系统接口</a></li>
|
||
<li><a href="#政务系统接口" id="toc-政务系统接口"><span
|
||
class="toc-section-number">1.10.5</span> 8.5 政务系统接口</a></li>
|
||
<li><a href="#消火栓系统接口" id="toc-消火栓系统接口"><span
|
||
class="toc-section-number">1.10.6</span> 8.6 消火栓系统接口</a></li>
|
||
<li><a href="#其他系统对接" id="toc-其他系统对接"><span
|
||
class="toc-section-number">1.10.7</span> 8.7 其他系统对接</a></li>
|
||
</ul></li>
|
||
<li><a href="#九统计分析" id="toc-九统计分析"><span
|
||
class="toc-section-number">1.11</span> 九、统计分析</a>
|
||
<ul>
|
||
<li><a href="#报表查询" id="toc-报表查询"><span
|
||
class="toc-section-number">1.11.1</span> 9.1 报表查询</a></li>
|
||
<li><a href="#欠费查询" id="toc-欠费查询"><span
|
||
class="toc-section-number">1.11.2</span> 9.2 欠费查询</a></li>
|
||
<li><a href="#缴费记录" id="toc-缴费记录"><span
|
||
class="toc-section-number">1.11.3</span> 9.3 缴费记录</a></li>
|
||
<li><a href="#用水分析" id="toc-用水分析"><span
|
||
class="toc-section-number">1.11.4</span> 9.4 用水分析</a></li>
|
||
</ul></li>
|
||
<li><a href="#十工程管理" id="toc-十工程管理"><span
|
||
class="toc-section-number">1.12</span> 十、工程管理</a>
|
||
<ul>
|
||
<li><a href="#工程申请" id="toc-工程申请"><span
|
||
class="toc-section-number">1.12.1</span> 10.1 工程申请</a></li>
|
||
<li><a href="#工程施工" id="toc-工程施工"><span
|
||
class="toc-section-number">1.12.2</span> 10.2 工程施工</a></li>
|
||
<li><a href="#工程验收" id="toc-工程验收"><span
|
||
class="toc-section-number">1.12.3</span> 10.3 工程验收</a></li>
|
||
<li><a href="#工程查询" id="toc-工程查询"><span
|
||
class="toc-section-number">1.12.4</span> 10.4 工程查询</a></li>
|
||
</ul></li>
|
||
<li><a href="#十一抄表app" id="toc-十一抄表app"><span
|
||
class="toc-section-number">1.13</span> 十一、抄表APP</a>
|
||
<ul>
|
||
<li><a href="#首页功能" id="toc-首页功能"><span
|
||
class="toc-section-number">1.13.1</span> 11.1 首页功能</a></li>
|
||
<li><a href="#抄表功能" id="toc-抄表功能"><span
|
||
class="toc-section-number">1.13.2</span> 11.2 抄表功能</a></li>
|
||
<li><a href="#工单管理" id="toc-工单管理"><span
|
||
class="toc-section-number">1.13.3</span> 11.3 工单管理</a></li>
|
||
</ul></li>
|
||
<li><a href="#十二接口服务" id="toc-十二接口服务"><span
|
||
class="toc-section-number">1.14</span> 十二、接口服务</a>
|
||
<ul>
|
||
<li><a href="#api市场" id="toc-api市场"><span
|
||
class="toc-section-number">1.14.1</span> 12.1 API市场</a></li>
|
||
<li><a href="#api管理" id="toc-api管理"><span
|
||
class="toc-section-number">1.14.2</span> 12.2 API管理</a></li>
|
||
<li><a href="#接口权限管理" id="toc-接口权限管理"><span
|
||
class="toc-section-number">1.14.3</span> 12.3 接口权限管理</a></li>
|
||
<li><a href="#系统对外接口" id="toc-系统对外接口"><span
|
||
class="toc-section-number">1.14.4</span> 12.4 系统对外接口</a></li>
|
||
</ul></li>
|
||
<li><a href="#系统集成架构" id="toc-系统集成架构"><span
|
||
class="toc-section-number">1.15</span> 系统集成架构</a>
|
||
<ul>
|
||
<li><a href="#前后端集成架构" id="toc-前后端集成架构"><span
|
||
class="toc-section-number">1.15.1</span> 前后端集成架构</a></li>
|
||
<li><a href="#技术栈整合方案" id="toc-技术栈整合方案"><span
|
||
class="toc-section-number">1.15.2</span> 技术栈整合方案</a></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>
|
||
<table>
|
||
<thead>
|
||
<tr>
|
||
<th>项目信息</th>
|
||
<th>详情</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr>
|
||
<td><strong>项目名称</strong></td>
|
||
<td>福建水务营收系统</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>文档类型</strong></td>
|
||
<td>概要设计文档</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>技术框架</strong></td>
|
||
<td>RuoYi-Vue-Pro + yudao-ui-admin-vue3</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>文档版本</strong></td>
|
||
<td>v1.0</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>编写日期</strong></td>
|
||
<td>2024-12-19</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>文档状态</strong></td>
|
||
<td>✅ 已完成</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<h2 data-number="1.2" id="目录"><span
|
||
class="header-section-number">1.2</span> 目录</h2>
|
||
<ul>
|
||
<li><a
|
||
href="#福建水务营收系统模块功能设计文档">福建水务营收系统模块功能设计文档</a>
|
||
<ul>
|
||
<li><a href="#文档信息">文档信息</a></li>
|
||
<li><a href="#目录">目录</a></li>
|
||
<li><a href="#一系统整体架构">一、系统整体架构</a>
|
||
<ul>
|
||
<li><a href="#11-系统架构图">1.1 系统架构图</a></li>
|
||
<li><a href="#12-技术架构图">1.2 技术架构图</a></li>
|
||
<li><a href="#13-业务架构图">1.3 业务架构图</a></li>
|
||
</ul></li>
|
||
<li><a href="#二统一平台">二、统一平台</a>
|
||
<ul>
|
||
<li><a href="#21-单点登录">2.1 单点登录</a></li>
|
||
<li><a href="#22-系统管理">2.2 系统管理</a></li>
|
||
</ul></li>
|
||
<li><a href="#三营收系统">三、营收系统</a>
|
||
<ul>
|
||
<li><a href="#31-系统管理">3.1 系统管理</a></li>
|
||
<li><a href="#32-抄表开账">3.2 抄表开账</a>
|
||
<ul>
|
||
<li><a href="#321-业务流程图">3.2.1 业务流程图</a></li>
|
||
<li><a href="#322-主要功能">3.2.2 主要功能</a></li>
|
||
<li><a href="#323-核心接口定义">3.2.3 核心接口定义</a></li>
|
||
<li><a href="#324-前端界面设计">3.2.4 前端界面设计</a></li>
|
||
</ul></li>
|
||
<li><a href="#33-收费管理">3.3 收费管理</a>
|
||
<ul>
|
||
<li><a href="#331-业务流程图">3.3.1 业务流程图</a></li>
|
||
<li><a href="#332-主要功能">3.3.2 主要功能</a></li>
|
||
<li><a href="#333-核心接口定义">3.3.3 核心接口定义</a></li>
|
||
</ul></li>
|
||
<li><a href="#34-账务处理">3.4 账务处理</a>
|
||
<ul>
|
||
<li><a href="#341-业务流程图">3.4.1 业务流程图</a></li>
|
||
<li><a href="#342-主要功能">3.4.2 主要功能</a></li>
|
||
<li><a href="#343-核心接口定义">3.4.3 核心接口定义</a></li>
|
||
</ul></li>
|
||
<li><a href="#35-发票管理">3.5 发票管理</a>
|
||
<ul>
|
||
<li><a href="#351-业务流程图">3.5.1 业务流程图</a></li>
|
||
<li><a href="#352-核心接口定义">3.5.2 核心接口定义</a></li>
|
||
</ul></li>
|
||
<li><a href="#36-代收业务">3.6 代收业务</a></li>
|
||
<li><a href="#37-环卫系统">3.7 环卫系统</a></li>
|
||
<li><a href="#38-业务工单">3.8 业务工单</a></li>
|
||
</ul></li>
|
||
<li><a href="#四表务系统">四、表务系统</a>
|
||
<ul>
|
||
<li><a href="#41-表务工单">4.1 表务工单</a></li>
|
||
<li><a href="#42-表务仓库">4.2 表务仓库</a></li>
|
||
<li><a href="#43-水表参数与基础信息">4.3 水表参数与基础信息</a></li>
|
||
<li><a href="#44-物联网对接与数据同步">4.4 物联网对接与数据同步</a></li>
|
||
</ul></li>
|
||
<li><a href="#五报装系统">五、报装系统</a>
|
||
<ul>
|
||
<li><a href="#51-报装流程">5.1 报装流程</a></li>
|
||
<li><a href="#52-一户一表管理">5.2 一户一表管理</a></li>
|
||
</ul></li>
|
||
<li><a href="#六客户服务">六、客户服务</a>
|
||
<ul>
|
||
<li><a href="#61-微信支付宝服务窗">6.1 微信、支付宝服务窗</a></li>
|
||
<li><a href="#62-历史账单">6.2 历史账单</a></li>
|
||
<li><a href="#63-电子发票">6.3 电子发票</a></li>
|
||
<li><a href="#64-营业网点">6.4 营业网点</a></li>
|
||
<li><a href="#65-账户流水">6.5 账户流水</a></li>
|
||
<li><a href="#66-微网厅">6.6 微网厅</a></li>
|
||
</ul></li>
|
||
<li><a href="#七系统配置">七、系统配置</a>
|
||
<ul>
|
||
<li><a href="#71-水表参数">7.1 水表参数</a></li>
|
||
<li><a href="#72-地址参数">7.2 地址参数</a></li>
|
||
<li><a href="#73-价格体系">7.3 价格体系</a></li>
|
||
<li><a href="#74-基本配置">7.4 基本配置</a></li>
|
||
<li><a href="#75-催缴管理">7.5 催缴管理</a></li>
|
||
<li><a href="#76-用户权限">7.6 用户权限</a></li>
|
||
<li><a href="#77-定时任务">7.7 定时任务</a></li>
|
||
</ul></li>
|
||
<li><a href="#八系统接口">八、系统接口</a>
|
||
<ul>
|
||
<li><a href="#81-银行接口">8.1 银行接口</a></li>
|
||
<li><a href="#82-支付宝微信接口">8.2 支付宝/微信接口</a></li>
|
||
<li><a href="#83-短信接口">8.3 短信接口</a></li>
|
||
<li><a href="#84-集抄系统接口">8.4 集抄系统接口</a></li>
|
||
<li><a href="#85-政务系统接口">8.5 政务系统接口</a></li>
|
||
<li><a href="#86-消火栓系统接口">8.6 消火栓系统接口</a></li>
|
||
<li><a href="#87-其他系统对接">8.7 其他系统对接</a></li>
|
||
</ul></li>
|
||
<li><a href="#九统计分析">九、统计分析</a>
|
||
<ul>
|
||
<li><a href="#91-报表查询">9.1 报表查询</a></li>
|
||
<li><a href="#92-欠费查询">9.2 欠费查询</a></li>
|
||
<li><a href="#93-缴费记录">9.3 缴费记录</a></li>
|
||
<li><a href="#94-用水分析">9.4 用水分析</a></li>
|
||
</ul></li>
|
||
<li><a href="#十工程管理">十、工程管理</a>
|
||
<ul>
|
||
<li><a href="#101-工程申请">10.1 工程申请</a></li>
|
||
<li><a href="#102-工程施工">10.2 工程施工</a></li>
|
||
<li><a href="#103-工程验收">10.3 工程验收</a></li>
|
||
<li><a href="#104-工程查询">10.4 工程查询</a></li>
|
||
</ul></li>
|
||
<li><a href="#十一抄表app">十一、抄表APP</a>
|
||
<ul>
|
||
<li><a href="#111-首页功能">11.1 首页功能</a></li>
|
||
<li><a href="#112-抄表功能">11.2 抄表功能</a></li>
|
||
<li><a href="#113-工单管理">11.3 工单管理</a></li>
|
||
</ul></li>
|
||
<li><a href="#十二接口服务">十二、接口服务</a>
|
||
<ul>
|
||
<li><a href="#121-api市场">12.1 API市场</a></li>
|
||
<li><a href="#122-api管理">12.2 API管理</a></li>
|
||
<li><a href="#123-接口权限管理">12.3 接口权限管理</a></li>
|
||
<li><a href="#124-系统对外接口">12.4 系统对外接口</a></li>
|
||
</ul></li>
|
||
<li><a href="#系统集成架构">系统集成架构</a>
|
||
<ul>
|
||
<li><a href="#前后端集成架构">前后端集成架构</a></li>
|
||
<li><a href="#技术栈整合方案">技术栈整合方案</a></li>
|
||
</ul></li>
|
||
</ul></li>
|
||
</ul>
|
||
<h2 data-number="1.3" id="一系统整体架构"><span
|
||
class="header-section-number">1.3</span> 一、系统整体架构</h2>
|
||
<p>福建水务营收系统采用现代化的分布式微服务架构，基于RuoYi-Vue-Pro后端框架和yudao-ui-admin-vue3前端框架构建，为水务企业提供完整的营收管理解决方案。</p>
|
||
<h3 data-number="1.3.1" id="系统架构图"><span
|
||
class="header-section-number">1.3.1</span> 1.1 系统架构图</h3>
|
||
<p><strong>图表 1</strong></p>
|
||
<figure>
|
||
<img src="temp_mermaid_water_biz_module_design_6403/diagram_1.png"
|
||
alt="图表 1" />
|
||
<figcaption aria-hidden="true">图表 1</figcaption>
|
||
</figure>
|
||
<details>
|
||
<summary>
|
||
查看图表源码
|
||
</summary>
|
||
<pre class="mermaid"><code>graph TB
|
||
subgraph "用户层"
|
||
A1[管理员用户]
|
||
A2[抄表员]
|
||
A3[收费员]
|
||
A4[客户用户]
|
||
end
|
||
|
||
subgraph "接入层"
|
||
B1[PC端管理后台<br/>yudao-ui-admin-vue3]
|
||
B2[移动端抄表APP<br/>uni-app]
|
||
B3[微信小程序]
|
||
B4[支付宝小程序]
|
||
B5[Web客户端]
|
||
end
|
||
|
||
subgraph "网关层"
|
||
C1[API网关<br/>Spring Cloud Gateway]
|
||
C2[负载均衡<br/>Nginx]
|
||
end
|
||
|
||
subgraph "服务层"
|
||
D1[用户认证服务<br/>Spring Security + JWT]
|
||
D2[营收管理服务<br/>RuoYi-Vue-Pro]
|
||
D3[表务管理服务]
|
||
D4[报装管理服务]
|
||
D5[客户服务]
|
||
D6[系统管理服务]
|
||
end
|
||
|
||
subgraph "中间件层"
|
||
E1[(Redis缓存<br/>6.0+)]
|
||
E2[RabbitMQ消息队列]
|
||
E3[Elasticsearch搜索]
|
||
E4[MinIO文件存储]
|
||
end
|
||
|
||
subgraph "数据层"
|
||
F1[(主数据库<br/>OpenGauss 5.0+)]
|
||
F2[(从数据库<br/>OpenGauss 5.0+)]
|
||
F3[(历史数据库<br/>OpenGauss 5.0+)]
|
||
end
|
||
|
||
subgraph "外部系统"
|
||
G1[银行系统]
|
||
G2[支付宝/微信]
|
||
G3[短信平台]
|
||
G4[集抄系统]
|
||
G5[政务平台]
|
||
end
|
||
|
||
A1 --> B1
|
||
A2 --> B2
|
||
A3 --> B1
|
||
A4 --> B3
|
||
A4 --> B4
|
||
A4 --> B5
|
||
|
||
B1 --> C2
|
||
B2 --> C2
|
||
B3 --> C2
|
||
B4 --> C2
|
||
B5 --> C2
|
||
|
||
C2 --> C1
|
||
C1 --> D1
|
||
C1 --> D2
|
||
C1 --> D3
|
||
C1 --> D4
|
||
C1 --> D5
|
||
C1 --> D6
|
||
|
||
D1 --> E1
|
||
D2 --> E1
|
||
D2 --> E2
|
||
D3 --> E1
|
||
D4 --> E3
|
||
D5 --> E4
|
||
D6 --> E1
|
||
|
||
D2 --> F1
|
||
D3 --> F1
|
||
D4 --> F2
|
||
D5 --> F2
|
||
D6 --> F3
|
||
|
||
D2 --> G1
|
||
D2 --> G2
|
||
D5 --> G3
|
||
D3 --> G4
|
||
D4 --> G5
|
||
</code></pre>
|
||
</details>
|
||
<h3 data-number="1.3.2" id="技术架构图"><span
|
||
class="header-section-number">1.3.2</span> 1.2 技术架构图</h3>
|
||
<p><strong>图表 2</strong></p>
|
||
<figure>
|
||
<img src="temp_mermaid_water_biz_module_design_6403/diagram_2.png"
|
||
alt="图表 2" />
|
||
<figcaption aria-hidden="true">图表 2</figcaption>
|
||
</figure>
|
||
<details>
|
||
<summary>
|
||
查看图表源码
|
||
</summary>
|
||
<pre class="mermaid"><code>graph TB
|
||
subgraph "前端技术栈"
|
||
FE1[Vue 3.x]
|
||
FE2[TypeScript 4.x]
|
||
FE3[Element Plus]
|
||
FE4[Vite 4.x]
|
||
FE5[Pinia状态管理]
|
||
end
|
||
|
||
subgraph "后端技术栈"
|
||
BE1[Spring Boot 3.x]
|
||
BE2[Spring Security 6.x]
|
||
BE3[MyBatis Plus 3.x]
|
||
BE4[Spring Cloud Gateway]
|
||
BE5[Hibernate Validator]
|
||
end
|
||
|
||
subgraph "数据库技术"
|
||
DB1[OpenGauss 5.0+]
|
||
DB2[Redis 6.0+]
|
||
DB3[HikariCP连接池]
|
||
DB4[MyBatis-Plus代码生成]
|
||
end
|
||
|
||
subgraph "中间件技术"
|
||
MW1[RabbitMQ 3.x]
|
||
MW2[Elasticsearch 8.x]
|
||
MW3[MinIO对象存储]
|
||
MW4[XXL-JOB定时任务]
|
||
end
|
||
|
||
subgraph "运维技术"
|
||
OPS1[Docker容器化]
|
||
OPS2[Jenkins CI/CD]
|
||
OPS3[Prometheus监控]
|
||
OPS4[ELK日志分析]
|
||
end
|
||
|
||
subgraph "安全技术"
|
||
SEC1[JWT Token认证]
|
||
SEC2[OAuth2.0授权]
|
||
SEC3[AES数据加密]
|
||
SEC4[RSA签名验证]
|
||
end
|
||
|
||
FE1 --> FE2
|
||
FE2 --> FE3
|
||
FE3 --> FE4
|
||
FE4 --> FE5
|
||
|
||
BE1 --> BE2
|
||
BE2 --> BE3
|
||
BE3 --> BE4
|
||
BE4 --> BE5
|
||
|
||
DB1 --> DB2
|
||
DB2 --> DB3
|
||
DB3 --> DB4
|
||
|
||
MW1 --> MW2
|
||
MW2 --> MW3
|
||
MW3 --> MW4
|
||
|
||
OPS1 --> OPS2
|
||
OPS2 --> OPS3
|
||
OPS3 --> OPS4
|
||
|
||
SEC1 --> SEC2
|
||
SEC2 --> SEC3
|
||
SEC3 --> SEC4
|
||
</code></pre>
|
||
</details>
|
||
<h3 data-number="1.3.3" id="业务架构图"><span
|
||
class="header-section-number">1.3.3</span> 1.3 业务架构图</h3>
|
||
<p><strong>图表 3</strong></p>
|
||
<figure>
|
||
<img src="temp_mermaid_water_biz_module_design_6403/diagram_3.png"
|
||
alt="图表 3" />
|
||
<figcaption aria-hidden="true">图表 3</figcaption>
|
||
</figure>
|
||
<details>
|
||
<summary>
|
||
查看图表源码
|
||
</summary>
|
||
<pre class="mermaid"><code>graph TB
|
||
subgraph "统一平台层"
|
||
UP1[单点登录]
|
||
UP2[系统管理]
|
||
UP3[用户权限]
|
||
UP4[组织架构]
|
||
end
|
||
|
||
subgraph "核心业务层"
|
||
CB1[客户管理]
|
||
CB2[抄表管理]
|
||
CB3[收费管理]
|
||
CB4[账务管理]
|
||
CB5[表务管理]
|
||
CB6[报装管理]
|
||
end
|
||
|
||
subgraph "增值服务层"
|
||
VS1[客户服务]
|
||
VS2[移动应用]
|
||
VS3[微信服务]
|
||
VS4[电子发票]
|
||
VS5[在线支付]
|
||
end
|
||
|
||
subgraph "数据服务层"
|
||
DS1[统计分析]
|
||
DS2[报表查询]
|
||
DS3[数据导出]
|
||
DS4[决策支持]
|
||
end
|
||
|
||
subgraph "集成服务层"
|
||
IS1[银行接口]
|
||
IS2[支付接口]
|
||
IS3[短信接口]
|
||
IS4[集抄接口]
|
||
IS5[政务接口]
|
||
end
|
||
|
||
UP1 --> CB1
|
||
UP2 --> CB2
|
||
UP3 --> CB3
|
||
UP4 --> CB4
|
||
|
||
CB1 --> VS1
|
||
CB2 --> VS2
|
||
CB3 --> VS3
|
||
CB4 --> VS4
|
||
CB5 --> VS5
|
||
CB6 --> VS1
|
||
|
||
VS1 --> DS1
|
||
VS2 --> DS2
|
||
VS3 --> DS3
|
||
VS4 --> DS4
|
||
VS5 --> DS1
|
||
|
||
DS1 --> IS1
|
||
DS2 --> IS2
|
||
DS3 --> IS3
|
||
DS4 --> IS4
|
||
DS1 --> IS5
|
||
</code></pre>
|
||
</details>
|
||
<h2 data-number="1.4" id="二统一平台"><span
|
||
class="header-section-number">1.4</span> 二、统一平台</h2>
|
||
<p>统一平台是客户服务平台的综合展示平台，基于RuoYi-Vue-Pro和yudao-ui-admin-vue3框架构建，包含日常工作功能和客户全部的信息，是系统的基础功能模块。</p>
|
||
<h3 data-number="1.4.1" id="单点登录"><span
|
||
class="header-section-number">1.4.1</span> 2.1 单点登录</h3>
|
||
<p>单点登录模块基于Spring
|
||
Security和JWT实现用户一次登录即可访问系统中所有应用的功能，主要特点包括：</p>
|
||
<ul>
|
||
<li>支持通过用户名、密码进行身份认证</li>
|
||
<li>支持OAuth2.0授权码+PKCE模式的第三方登录</li>
|
||
<li>支持手机号+短信验证码登录方式</li>
|
||
<li>支持多因素认证（MFA）增强安全性</li>
|
||
<li>根据登录人员所在公司的不同，显示不同的系统名称和界面风格</li>
|
||
<li>提供流程节点到期提醒功能</li>
|
||
<li>Token自动刷新机制，提升用户体验</li>
|
||
</ul>
|
||
<h3 data-number="1.4.2" id="系统管理"><span
|
||
class="header-section-number">1.4.2</span> 2.2 系统管理</h3>
|
||
<p>系统管理模块基于RuoYi-Vue-Pro框架的现成功能，提供对系统基础参数的配置管理功能，主要包括：</p>
|
||
<ul>
|
||
<li>组织机构管理：
|
||
<ul>
|
||
<li>支持多级组织结构的管理</li>
|
||
<li>支持组织机构导入导出</li>
|
||
<li>组织关系树形展示</li>
|
||
<li>组织数据权限控制</li>
|
||
</ul></li>
|
||
<li>员工管理：
|
||
<ul>
|
||
<li>系统操作人员的基本信息管理</li>
|
||
<li>用户分配角色与权限</li>
|
||
<li>用户状态管理（启用/禁用）</li>
|
||
<li>用户密码安全策略</li>
|
||
<li>用户操作日志记录</li>
|
||
</ul></li>
|
||
<li>角色权限管理：
|
||
<ul>
|
||
<li>基于RBAC模型的权限控制</li>
|
||
<li>支持数据权限精细化控制</li>
|
||
<li>支持多租户的权限隔离</li>
|
||
<li>基于菜单、按钮级别的权限管理</li>
|
||
</ul></li>
|
||
<li>系统菜单配置：
|
||
<ul>
|
||
<li>支持自定义系统菜单和功能模块</li>
|
||
<li>菜单多级分类管理</li>
|
||
<li>动态路由生成</li>
|
||
<li>菜单权限配置</li>
|
||
</ul></li>
|
||
<li>数据字典管理：
|
||
<ul>
|
||
<li>维护系统使用的各类基础代码数据</li>
|
||
<li>支持字典项多级管理</li>
|
||
<li>支持字典缓存，提高访问性能</li>
|
||
</ul></li>
|
||
<li>系统监控：
|
||
<ul>
|
||
<li>在线用户监控与管理</li>
|
||
<li>服务器性能监控</li>
|
||
<li>定时任务执行状态监控</li>
|
||
<li>系统缓存监控与管理</li>
|
||
</ul></li>
|
||
<li>系统日志管理：
|
||
<ul>
|
||
<li>记录用户登录日志</li>
|
||
<li>记录操作日志，支持操作回溯</li>
|
||
<li>记录系统异常日志，便于问题排查</li>
|
||
</ul></li>
|
||
<li>短信管理：
|
||
<ul>
|
||
<li>支持阿里云、腾讯云等多家短信渠道</li>
|
||
<li>短信模板配置管理</li>
|
||
<li>短信发送日志记录</li>
|
||
</ul></li>
|
||
<li>租户管理：
|
||
<ul>
|
||
<li>支持SaaS多租户</li>
|
||
<li>租户套餐配置</li>
|
||
<li>租户数据隔离</li>
|
||
<li>租户资源管理</li>
|
||
</ul></li>
|
||
<li>配置管理：
|
||
<ul>
|
||
<li>系统参数配置</li>
|
||
<li>通知公告管理</li>
|
||
<li>定时任务配置</li>
|
||
</ul></li>
|
||
</ul>
|
||
<h2 data-number="1.5" id="三营收系统"><span
|
||
class="header-section-number">1.5</span> 三、营收系统</h2>
|
||
<p>营收系统是水务业务系统的核心组成部分，负责抄表、收费、账务处理等关键业务功能。</p>
|
||
<h3 data-number="1.5.1" id="系统管理-1"><span
|
||
class="header-section-number">1.5.1</span> 3.1 系统管理</h3>
|
||
<p>营收系统的基础管理功能，包括：</p>
|
||
<ul>
|
||
<li>水价管理：不同用户类型的水价标准管理，支持阶梯水价</li>
|
||
<li>用户档案管理：维护用户基本信息、用水信息、账户信息等
|
||
<ul>
|
||
<li>客户分组管理</li>
|
||
<li>集收管理</li>
|
||
<li>客户基础信息管理</li>
|
||
<li>定额管理</li>
|
||
<li>客户优惠方案设置</li>
|
||
</ul></li>
|
||
<li>更名过户管理：处理用户变更、过户等业务</li>
|
||
<li>注销报停管理：处理用户注销、暂停用水等业务</li>
|
||
</ul>
|
||
<h3 data-number="1.5.2" id="抄表开账"><span
|
||
class="header-section-number">1.5.2</span> 3.2 抄表开账</h3>
|
||
<p>抄表开账模块负责水表读数的采集和账单生成，是营收系统的核心业务模块。</p>
|
||
<h4 data-number="1.5.2.1" id="业务流程图"><span
|
||
class="header-section-number">1.5.2.1</span> 3.2.1 业务流程图</h4>
|
||
<p><strong>图表 4</strong></p>
|
||
<figure>
|
||
<img src="temp_mermaid_water_biz_module_design_6403/diagram_4.png"
|
||
alt="图表 4" />
|
||
<figcaption aria-hidden="true">图表 4</figcaption>
|
||
</figure>
|
||
<details>
|
||
<summary>
|
||
查看图表源码
|
||
</summary>
|
||
<pre class="mermaid"><code>flowchart TD
|
||
Start([开始抄表周期]) --> BookPlan[制定抄表计划]
|
||
BookPlan --> CreateBook[生成抄表册本]
|
||
CreateBook --> AssignReader[分配抄表员]
|
||
|
||
AssignReader --> ReadingStart[开始抄表]
|
||
ReadingStart --> ReadingType{抄表方式}
|
||
|
||
ReadingType -->|人工抄表| ManualReading[现场抄表录入]
|
||
ReadingType -->|远程抄表| RemoteReading[远程采集数据]
|
||
ReadingType -->|客户自报| SelfReporting[客户自主上报]
|
||
|
||
ManualReading --> DataValidation[数据校验]
|
||
RemoteReading --> DataValidation
|
||
SelfReporting --> DataValidation
|
||
|
||
DataValidation --> ValidationResult{校验结果}
|
||
ValidationResult -->|异常| ExceptionHandle[异常处理]
|
||
ValidationResult -->|正常| DataReview[数据复核]
|
||
|
||
ExceptionHandle --> ReviewException[人工审核异常]
|
||
ReviewException --> DataReview
|
||
|
||
DataReview --> ReviewResult{复核结果}
|
||
ReviewResult -->|退回| ReadingStart
|
||
ReviewResult -->|通过| BillGeneration[生成账单]
|
||
|
||
BillGeneration --> CalcWaterFee[计算水费]
|
||
CalcWaterFee --> CalcSewageFee[计算污水费]
|
||
CalcSewageFee --> CalcOtherFee[计算其他费用]
|
||
CalcOtherFee --> BillReview[账单审核]
|
||
|
||
BillReview --> BillResult{审核结果}
|
||
BillResult -->|退回| BillGeneration
|
||
BillResult -->|通过| BillConfirm[账单确认]
|
||
|
||
BillConfirm --> SendNotification[发送缴费通知]
|
||
SendNotification --> End([完成开账])
|
||
</code></pre>
|
||
</details>
|
||
<h4 data-number="1.5.2.2" id="主要功能"><span
|
||
class="header-section-number">1.5.2.2</span> 3.2.2 主要功能</h4>
|
||
<p><strong>册本管理</strong>：册本基本信息的维护和管理 - 册本创建与配置
|
||
- 抄表路线规划 - 抄表员分配 - 抄表周期设置</p>
|
||
<p><strong>抄表录入</strong>：支持多种抄表方式 -
|
||
手工抄表：现场抄表、批量录入 - 智能抄表：远程数据采集、自动同步 -
|
||
自报抄表：客户自主上报、在线提交</p>
|
||
<p><strong>抄表数据审核</strong>：确保数据质量 -
|
||
数据校验：读数合理性检查、用量异常检测 -
|
||
异常处理：异常数据标记、人工处理 - 开账处理：数据确认、账单生成</p>
|
||
<p><strong>追加抄表</strong>：支持非周期性特殊抄表 -
|
||
补抄管理：漏抄数据补录 - 特殊抄表：临时抄表需求 -
|
||
调整抄表：读数错误修正</p>
|
||
<h4 data-number="1.5.2.3" id="核心接口定义"><span
|
||
class="header-section-number">1.5.2.3</span> 3.2.3 核心接口定义</h4>
|
||
<p><strong>抄表管理主要接口</strong>：</p>
|
||
<div class="sourceCode" id="cb5"><pre
|
||
class="sourceCode java"><code class="sourceCode java"><span id="cb5-1"><a href="#cb5-1" aria-hidden="true" tabindex="-1"></a><span class="at">@RestController</span></span>
|
||
<span id="cb5-2"><a href="#cb5-2" aria-hidden="true" tabindex="-1"></a><span class="at">@RequestMapping</span><span class="op">(</span><span class="st">"/admin-api/water/reading"</span><span class="op">)</span></span>
|
||
<span id="cb5-3"><a href="#cb5-3" aria-hidden="true" tabindex="-1"></a><span class="at">@Tag</span><span class="op">(</span>name <span class="op">=</span> <span class="st">"管理后台 - 抄表管理"</span><span class="op">)</span></span>
|
||
<span id="cb5-4"><a href="#cb5-4" aria-hidden="true" tabindex="-1"></a><span class="kw">public</span> <span class="kw">class</span> MeterReadingController <span class="op">{</span></span>
|
||
<span id="cb5-5"><a href="#cb5-5" aria-hidden="true" tabindex="-1"></a> </span>
|
||
<span id="cb5-6"><a href="#cb5-6" aria-hidden="true" tabindex="-1"></a> <span class="at">@PostMapping</span><span class="op">(</span><span class="st">"/create"</span><span class="op">)</span></span>
|
||
<span id="cb5-7"><a href="#cb5-7" aria-hidden="true" tabindex="-1"></a> <span class="at">@Operation</span><span class="op">(</span>summary <span class="op">=</span> <span class="st">"创建抄表记录"</span><span class="op">)</span></span>
|
||
<span id="cb5-8"><a href="#cb5-8" aria-hidden="true" tabindex="-1"></a> <span class="kw">public</span> CommonResult<span class="op"><</span><span class="bu">Long</span><span class="op">></span> <span class="fu">createReading</span><span class="op">(</span><span class="at">@Valid</span> <span class="at">@RequestBody</span> MeterReadingSaveReqVO createReqVO<span class="op">);</span></span>
|
||
<span id="cb5-9"><a href="#cb5-9" aria-hidden="true" tabindex="-1"></a> </span>
|
||
<span id="cb5-10"><a href="#cb5-10" aria-hidden="true" tabindex="-1"></a> <span class="at">@PostMapping</span><span class="op">(</span><span class="st">"/batch-create"</span><span class="op">)</span></span>
|
||
<span id="cb5-11"><a href="#cb5-11" aria-hidden="true" tabindex="-1"></a> <span class="at">@Operation</span><span class="op">(</span>summary <span class="op">=</span> <span class="st">"批量创建抄表记录"</span><span class="op">)</span></span>
|
||
<span id="cb5-12"><a href="#cb5-12" aria-hidden="true" tabindex="-1"></a> <span class="kw">public</span> CommonResult<span class="op"><</span>MeterReadingBatchRespVO<span class="op">></span> <span class="fu">batchCreateReading</span><span class="op">(</span><span class="at">@Valid</span> <span class="at">@RequestBody</span> MeterReadingBatchReqVO batchReqVO<span class="op">);</span></span>
|
||
<span id="cb5-13"><a href="#cb5-13" aria-hidden="true" tabindex="-1"></a> </span>
|
||
<span id="cb5-14"><a href="#cb5-14" aria-hidden="true" tabindex="-1"></a> <span class="at">@PostMapping</span><span class="op">(</span><span class="st">"/review"</span><span class="op">)</span></span>
|
||
<span id="cb5-15"><a href="#cb5-15" aria-hidden="true" tabindex="-1"></a> <span class="at">@Operation</span><span class="op">(</span>summary <span class="op">=</span> <span class="st">"抄表数据复核"</span><span class="op">)</span></span>
|
||
<span id="cb5-16"><a href="#cb5-16" aria-hidden="true" tabindex="-1"></a> <span class="kw">public</span> CommonResult<span class="op"><</span><span class="bu">Boolean</span><span class="op">></span> <span class="fu">reviewReading</span><span class="op">(</span><span class="at">@Valid</span> <span class="at">@RequestBody</span> MeterReadingReviewReqVO reviewReqVO<span class="op">);</span></span>
|
||
<span id="cb5-17"><a href="#cb5-17" aria-hidden="true" tabindex="-1"></a> </span>
|
||
<span id="cb5-18"><a href="#cb5-18" aria-hidden="true" tabindex="-1"></a> <span class="at">@PostMapping</span><span class="op">(</span><span class="st">"/generate-bill"</span><span class="op">)</span></span>
|
||
<span id="cb5-19"><a href="#cb5-19" aria-hidden="true" tabindex="-1"></a> <span class="at">@Operation</span><span class="op">(</span>summary <span class="op">=</span> <span class="st">"生成账单"</span><span class="op">)</span></span>
|
||
<span id="cb5-20"><a href="#cb5-20" aria-hidden="true" tabindex="-1"></a> <span class="kw">public</span> CommonResult<span class="op"><</span>BillGenerateRespVO<span class="op">></span> <span class="fu">generateBill</span><span class="op">(</span><span class="at">@Valid</span> <span class="at">@RequestBody</span> ReadingBillReqVO reqVO<span class="op">);</span></span>
|
||
<span id="cb5-21"><a href="#cb5-21" aria-hidden="true" tabindex="-1"></a><span class="op">}</span></span></code></pre></div>
|
||
<p><strong>接口设计要点</strong>： -
|
||
遵循RESTful设计规范，统一的请求响应格式 - 支持批量操作提高处理效率 -
|
||
完整的数据校验和异常处理机制 - 集成RuoYi-Vue-Pro的权限控制和日志记录</p>
|
||
<h4 data-number="1.5.2.4" id="前端界面设计"><span
|
||
class="header-section-number">1.5.2.4</span> 3.2.4 前端界面设计</h4>
|
||
<p><strong>抄表管理页面结构</strong>：</p>
|
||
<pre class="vue"><code><template>
|
||
<ContentWrap>
|
||
<!-- 查询条件 -->
|
||
<el-form class="search-form" inline>
|
||
<el-form-item label="抄表日期">
|
||
<el-date-picker v-model="queryParams.readingDate" type="daterange" />
|
||
</el-form-item>
|
||
<el-form-item label="抄表状态">
|
||
<el-select v-model="queryParams.status">
|
||
<el-option label="待复核" value="pending" />
|
||
<el-option label="已通过" value="approved" />
|
||
</el-select>
|
||
</el-form-item>
|
||
<el-form-item>
|
||
<el-button type="primary" @click="handleQuery">查询</el-button>
|
||
<el-button @click="resetQuery">重置</el-button>
|
||
</el-form-item>
|
||
</el-form>
|
||
|
||
<!-- 操作按钮 -->
|
||
<el-row class="mb-10px">
|
||
<el-button type="primary" @click="handleAdd">新增抄表</el-button>
|
||
<el-button type="success" @click="handleBatchAdd">批量抄表</el-button>
|
||
<el-button type="warning" @click="handleExport">导出数据</el-button>
|
||
</el-row>
|
||
|
||
<!-- 数据表格 -->
|
||
<el-table v-loading="loading" :data="readingList">
|
||
<el-table-column prop="readingCode" label="抄表编号" width="180" />
|
||
<el-table-column prop="customerName" label="客户名称" />
|
||
<el-table-column prop="meterCode" label="水表编号" />
|
||
<el-table-column prop="readingValue" label="本次读数" />
|
||
<el-table-column prop="waterUsage" label="用水量" />
|
||
<el-table-column prop="readingDate" label="抄表日期" />
|
||
<el-table-column prop="status" label="状态">
|
||
<template #default="{ row }">
|
||
<dict-tag :type="DICT_TYPE.READING_STATUS" :value="row.status" />
|
||
</template>
|
||
</el-table-column>
|
||
<el-table-column label="操作" width="200" fixed="right">
|
||
<template #default="{ row }">
|
||
<el-button link @click="handleUpdate(row)">编辑</el-button>
|
||
<el-button link @click="handleReview(row)">复核</el-button>
|
||
<el-button link type="danger" @click="handleDelete(row)">删除</el-button>
|
||
</template>
|
||
</el-table-column>
|
||
</el-table>
|
||
</ContentWrap>
|
||
</template></code></pre>
|
||
<p><strong>前端页面功能特性</strong>： - 响应式设计：基于Element
|
||
Plus的现代化UI组件 - 数据表格：支持分页、排序、筛选等功能 -
|
||
表单验证：前端数据校验和错误提示 - 批量操作：支持批量抄表录入和批量审核
|
||
- 实时更新：页面数据实时刷新和状态同步</p>
|
||
<h3 data-number="1.5.3" id="收费管理"><span
|
||
class="header-section-number">1.5.3</span> 3.3 收费管理</h3>
|
||
<p>收费管理模块负责水费的收取和管理，是营收系统的重要业务模块。</p>
|
||
<h4 data-number="1.5.3.1" id="业务流程图-1"><span
|
||
class="header-section-number">1.5.3.1</span> 3.3.1 业务流程图</h4>
|
||
<p><strong>图表 5</strong></p>
|
||
<figure>
|
||
<img src="temp_mermaid_water_biz_module_design_6403/diagram_5.png"
|
||
alt="图表 5" />
|
||
<figcaption aria-hidden="true">图表 5</figcaption>
|
||
</figure>
|
||
<details>
|
||
<summary>
|
||
查看图表源码
|
||
</summary>
|
||
<pre class="mermaid"><code>flowchart TD
|
||
Start([客户缴费]) --> QueryCustomer[查询客户信息]
|
||
QueryCustomer --> CustomerExists{客户是否存在}
|
||
CustomerExists -->|否| ErrorReturn[返回错误信息]
|
||
CustomerExists -->|是| QueryBills[查询欠费账单]
|
||
|
||
QueryBills --> BillExists{是否有欠费}
|
||
BillExists -->|否| NoDebt[无欠费提示]
|
||
BillExists -->|是| ShowBills[显示账单列表]
|
||
|
||
ShowBills --> SelectBills[选择缴费账单]
|
||
SelectBills --> CalcAmount[计算缴费金额]
|
||
CalcAmount --> SelectPayMethod[选择支付方式]
|
||
|
||
SelectPayMethod --> PaymentType{支付方式}
|
||
PaymentType -->|现金| CashPayment[现金收费]
|
||
PaymentType -->|银行卡| BankCardPay[银行卡支付]
|
||
PaymentType -->|在线支付| OnlinePayment[在线支付]
|
||
PaymentType -->|预存款| PrepaidPayment[预存款支付]
|
||
|
||
CashPayment --> ValidatePayment[验证收费金额]
|
||
BankCardPay --> ValidatePayment
|
||
OnlinePayment --> ThirdPartyPay[第三方支付]
|
||
PrepaidPayment --> CheckBalance[检查预存余额]
|
||
|
||
ThirdPartyPay --> PaymentCallback[支付回调]
|
||
PaymentCallback --> ValidatePayment
|
||
|
||
CheckBalance --> BalanceOK{余额是否充足}
|
||
BalanceOK -->|否| InsufficientBalance[余额不足]
|
||
BalanceOK -->|是| ValidatePayment
|
||
|
||
ValidatePayment --> PaymentSuccess{支付成功}
|
||
PaymentSuccess -->|否| PaymentFailed[支付失败处理]
|
||
PaymentSuccess -->|是| UpdateAccount[更新账户状态]
|
||
|
||
UpdateAccount --> UpdateBills[更新账单状态]
|
||
UpdateBills --> GenerateReceipt[生成收费凭证]
|
||
GenerateReceipt --> PrintReceipt[打印收据]
|
||
PrintReceipt --> SendNotification[发送缴费通知]
|
||
SendNotification --> Complete([完成缴费])
|
||
|
||
PaymentFailed --> End([结束])
|
||
InsufficientBalance --> End
|
||
ErrorReturn --> End
|
||
NoDebt --> End
|
||
</code></pre>
|
||
</details>
|
||
<h4 data-number="1.5.3.2" id="主要功能-1"><span
|
||
class="header-section-number">1.5.3.2</span> 3.3.2 主要功能</h4>
|
||
<p><strong>柜台收费</strong>：现场收费服务 -
|
||
用户查询：客户信息查询、账单查询 - 收费处理：多种支付方式、找零计算 -
|
||
收费打印：收据打印、发票开具 - 预存预付：余额充值、预付费管理</p>
|
||
<p><strong>柜台结账</strong>：营业网点日常结账 -
|
||
日结处理：当日收费汇总、统计分析 - 交款管理：现金上缴、账务核对 -
|
||
结账查询：历史结账记录查询</p>
|
||
<p><strong>预付款管理</strong>：预付费业务处理 -
|
||
预付款充值：余额充值、充值记录 - 使用管理：自动扣款、余额提醒 -
|
||
退款处理：预付款退款、退款审核</p>
|
||
<p><strong>缴费记录查询</strong>：缴费历史管理 -
|
||
多条件查询：按时间、金额、渠道查询 - 统计分析：缴费趋势、渠道分析 -
|
||
导出功能：缴费记录导出</p>
|
||
<h4 data-number="1.5.3.3" id="核心接口定义-1"><span
|
||
class="header-section-number">1.5.3.3</span> 3.3.3 核心接口定义</h4>
|
||
<p><strong>缴费管理主要接口</strong>：</p>
|
||
<div class="sourceCode" id="cb8"><pre
|
||
class="sourceCode java"><code class="sourceCode java"><span id="cb8-1"><a href="#cb8-1" aria-hidden="true" tabindex="-1"></a><span class="at">@RestController</span></span>
|
||
<span id="cb8-2"><a href="#cb8-2" aria-hidden="true" tabindex="-1"></a><span class="at">@RequestMapping</span><span class="op">(</span><span class="st">"/admin-api/water/payment"</span><span class="op">)</span></span>
|
||
<span id="cb8-3"><a href="#cb8-3" aria-hidden="true" tabindex="-1"></a><span class="at">@Tag</span><span class="op">(</span>name <span class="op">=</span> <span class="st">"管理后台 - 缴费管理"</span><span class="op">)</span></span>
|
||
<span id="cb8-4"><a href="#cb8-4" aria-hidden="true" tabindex="-1"></a><span class="kw">public</span> <span class="kw">class</span> PaymentController <span class="op">{</span></span>
|
||
<span id="cb8-5"><a href="#cb8-5" aria-hidden="true" tabindex="-1"></a> </span>
|
||
<span id="cb8-6"><a href="#cb8-6" aria-hidden="true" tabindex="-1"></a> <span class="at">@PostMapping</span><span class="op">(</span><span class="st">"/create"</span><span class="op">)</span></span>
|
||
<span id="cb8-7"><a href="#cb8-7" aria-hidden="true" tabindex="-1"></a> <span class="at">@Operation</span><span class="op">(</span>summary <span class="op">=</span> <span class="st">"创建缴费记录"</span><span class="op">)</span></span>
|
||
<span id="cb8-8"><a href="#cb8-8" aria-hidden="true" tabindex="-1"></a> <span class="kw">public</span> CommonResult<span class="op"><</span>PaymentRespVO<span class="op">></span> <span class="fu">createPayment</span><span class="op">(</span><span class="at">@Valid</span> <span class="at">@RequestBody</span> PaymentCreateReqVO createReqVO<span class="op">);</span></span>
|
||
<span id="cb8-9"><a href="#cb8-9" aria-hidden="true" tabindex="-1"></a> </span>
|
||
<span id="cb8-10"><a href="#cb8-10" aria-hidden="true" tabindex="-1"></a> <span class="at">@PostMapping</span><span class="op">(</span><span class="st">"/cash-payment"</span><span class="op">)</span></span>
|
||
<span id="cb8-11"><a href="#cb8-11" aria-hidden="true" tabindex="-1"></a> <span class="at">@Operation</span><span class="op">(</span>summary <span class="op">=</span> <span class="st">"现金缴费"</span><span class="op">)</span></span>
|
||
<span id="cb8-12"><a href="#cb8-12" aria-hidden="true" tabindex="-1"></a> <span class="kw">public</span> CommonResult<span class="op"><</span>PaymentRespVO<span class="op">></span> <span class="fu">cashPayment</span><span class="op">(</span><span class="at">@Valid</span> <span class="at">@RequestBody</span> CashPaymentReqVO cashReqVO<span class="op">);</span></span>
|
||
<span id="cb8-13"><a href="#cb8-13" aria-hidden="true" tabindex="-1"></a> </span>
|
||
<span id="cb8-14"><a href="#cb8-14" aria-hidden="true" tabindex="-1"></a> <span class="at">@PostMapping</span><span class="op">(</span><span class="st">"/online-payment"</span><span class="op">)</span></span>
|
||
<span id="cb8-15"><a href="#cb8-15" aria-hidden="true" tabindex="-1"></a> <span class="at">@Operation</span><span class="op">(</span>summary <span class="op">=</span> <span class="st">"在线支付"</span><span class="op">)</span></span>
|
||
<span id="cb8-16"><a href="#cb8-16" aria-hidden="true" tabindex="-1"></a> <span class="kw">public</span> CommonResult<span class="op"><</span>OnlinePaymentRespVO<span class="op">></span> <span class="fu">onlinePayment</span><span class="op">(</span><span class="at">@Valid</span> <span class="at">@RequestBody</span> OnlinePaymentReqVO onlineReqVO<span class="op">);</span></span>
|
||
<span id="cb8-17"><a href="#cb8-17" aria-hidden="true" tabindex="-1"></a> </span>
|
||
<span id="cb8-18"><a href="#cb8-18" aria-hidden="true" tabindex="-1"></a> <span class="at">@PostMapping</span><span class="op">(</span><span class="st">"/prepaid-payment"</span><span class="op">)</span></span>
|
||
<span id="cb8-19"><a href="#cb8-19" aria-hidden="true" tabindex="-1"></a> <span class="at">@Operation</span><span class="op">(</span>summary <span class="op">=</span> <span class="st">"预存款缴费"</span><span class="op">)</span></span>
|
||
<span id="cb8-20"><a href="#cb8-20" aria-hidden="true" tabindex="-1"></a> <span class="kw">public</span> CommonResult<span class="op"><</span>PaymentRespVO<span class="op">></span> <span class="fu">prepaidPayment</span><span class="op">(</span><span class="at">@Valid</span> <span class="at">@RequestBody</span> PrepaidPaymentReqVO prepaidReqVO<span class="op">);</span></span>
|
||
<span id="cb8-21"><a href="#cb8-21" aria-hidden="true" tabindex="-1"></a><span class="op">}</span></span></code></pre></div>
|
||
<p><strong>接口设计特点</strong>： -
|
||
支持多种缴费方式：现金、银行卡、在线支付、预存款 -
|
||
事务控制：确保缴费操作的原子性和一致性 -
|
||
异步处理：第三方支付采用异步回调机制 -
|
||
安全验证：完整的权限控制和数据校验</p>
|
||
<pre><code>
|
||
#### 3.3.4 前端界面设计
|
||
|
||
**缴费管理页面结构**：
|
||
```vue
|
||
<template>
|
||
<ContentWrap>
|
||
<!-- 客户查询 -->
|
||
<el-form class="search-form" inline>
|
||
<el-form-item label="客户编号">
|
||
<el-input v-model="queryParams.customerCode" placeholder="请输入客户编号" />
|
||
</el-form-item>
|
||
<el-form-item label="客户姓名">
|
||
<el-input v-model="queryParams.customerName" placeholder="请输入客户姓名" />
|
||
</el-form-item>
|
||
<el-form-item>
|
||
<el-button type="primary" @click="handleQuery">查询</el-button>
|
||
<el-button @click="resetQuery">重置</el-button>
|
||
</el-form-item>
|
||
</el-form>
|
||
|
||
<!-- 账单信息 -->
|
||
<el-table v-loading="loading" :data="billList" @selection-change="handleSelectionChange">
|
||
<el-table-column type="selection" width="55" />
|
||
<el-table-column prop="billCode" label="账单编号" />
|
||
<el-table-column prop="billDate" label="账期" />
|
||
<el-table-column prop="waterUsage" label="用水量" />
|
||
<el-table-column prop="totalAmount" label="应缴金额" />
|
||
<el-table-column prop="balanceAmount" label="欠费金额" />
|
||
</el-table>
|
||
|
||
<!-- 缴费操作 -->
|
||
<el-row class="payment-actions">
|
||
<el-col :span="12">
|
||
<el-statistic title="选中金额" :value="selectedAmount" prefix="￥" />
|
||
</el-col>
|
||
<el-col :span="12" class="text-right">
|
||
<el-button type="success" @click="handleCashPayment">现金缴费</el-button>
|
||
<el-button type="primary" @click="handleOnlinePayment">在线支付</el-button>
|
||
<el-button type="warning" @click="handlePrepaidPayment">预存扣费</el-button>
|
||
</el-col>
|
||
</el-row>
|
||
</ContentWrap>
|
||
</template></code></pre>
|
||
<h3 data-number="1.5.4" id="账务处理"><span
|
||
class="header-section-number">1.5.4</span> 3.4 账务处理</h3>
|
||
<p>账务处理模块负责处理各类特殊账务情况，确保账务数据的准确性和完整性。</p>
|
||
<h4 data-number="1.5.4.1" id="业务流程图-2"><span
|
||
class="header-section-number">1.5.4.1</span> 3.4.1 业务流程图</h4>
|
||
<p><strong>图表 6</strong></p>
|
||
<figure>
|
||
<img src="temp_mermaid_water_biz_module_design_6403/diagram_6.png"
|
||
alt="图表 6" />
|
||
<figcaption aria-hidden="true">图表 6</figcaption>
|
||
</figure>
|
||
<details>
|
||
<summary>
|
||
查看图表源码
|
||
</summary>
|
||
<pre class="mermaid"><code>flowchart TD
|
||
Start([账务处理请求]) --> CheckAuth[权限验证]
|
||
CheckAuth --> AuthOK{权限验证}
|
||
AuthOK -->|失败| AuthError[权限错误]
|
||
AuthOK -->|成功| ProcessType{处理类型}
|
||
|
||
ProcessType -->|调账| AdjustAccount[账务调整]
|
||
ProcessType -->|退款| RefundProcess[退款处理]
|
||
ProcessType -->|销账| WriteOff[销账处理]
|
||
ProcessType -->|预存调整| PrepaidAdjust[预存调整]
|
||
|
||
AdjustAccount --> ValidateAdjust[验证调整数据]
|
||
RefundProcess --> ValidateRefund[验证退款数据]
|
||
WriteOff --> ValidateWriteOff[验证销账数据]
|
||
PrepaidAdjust --> ValidatePrepaid[验证预存数据]
|
||
|
||
ValidateAdjust --> AdjustApproval[调账审批]
|
||
ValidateRefund --> RefundApproval[退款审批]
|
||
ValidateWriteOff --> WriteOffApproval[销账审批]
|
||
ValidatePrepaid --> PrepaidApproval[预存审批]
|
||
|
||
AdjustApproval --> ApprovalResult{审批结果}
|
||
RefundApproval --> ApprovalResult
|
||
WriteOffApproval --> ApprovalResult
|
||
PrepaidApproval --> ApprovalResult
|
||
|
||
ApprovalResult -->|拒绝| ApprovalReject[审批拒绝]
|
||
ApprovalResult -->|通过| ExecuteProcess[执行处理]
|
||
|
||
ExecuteProcess --> UpdateAccount[更新账户]
|
||
UpdateAccount --> RecordLog[记录日志]
|
||
RecordLog --> Complete([处理完成])
|
||
|
||
AuthError --> End([结束])
|
||
ApprovalReject --> End
|
||
</code></pre>
|
||
</details>
|
||
<h4 data-number="1.5.4.2" id="主要功能-2"><span
|
||
class="header-section-number">1.5.4.2</span> 3.4.2 主要功能</h4>
|
||
<p><strong>未销调整</strong>：处理各类账务调整需求 -
|
||
水量调整：调整用水量和相关费用 - 金额调整：直接调整账单金额 -
|
||
违约金减免：减免或取消违约金 - 费用追加：补收相关费用</p>
|
||
<p><strong>特殊开账</strong>：处理特殊情况的账单生成 -
|
||
补抄开账：补录抄表数据并生成账单 - 估抄开账：估算用水量生成账单 -
|
||
平均开账：基于历史用量平均开账</p>
|
||
<p><strong>账务退款</strong>：处理各类退款业务 -
|
||
多缴退款：退还多缴的水费 - 预付款退款：退还预存余额 -
|
||
错误缴费退款：退还错误缴费</p>
|
||
<h4 data-number="1.5.4.3" id="核心接口定义-2"><span
|
||
class="header-section-number">1.5.4.3</span> 3.4.3 核心接口定义</h4>
|
||
<div class="sourceCode" id="cb11"><pre
|
||
class="sourceCode java"><code class="sourceCode java"><span id="cb11-1"><a href="#cb11-1" aria-hidden="true" tabindex="-1"></a><span class="at">@RestController</span></span>
|
||
<span id="cb11-2"><a href="#cb11-2" aria-hidden="true" tabindex="-1"></a><span class="at">@RequestMapping</span><span class="op">(</span><span class="st">"/admin-api/water/account"</span><span class="op">)</span></span>
|
||
<span id="cb11-3"><a href="#cb11-3" aria-hidden="true" tabindex="-1"></a><span class="at">@Tag</span><span class="op">(</span>name <span class="op">=</span> <span class="st">"管理后台 - 账务处理"</span><span class="op">)</span></span>
|
||
<span id="cb11-4"><a href="#cb11-4" aria-hidden="true" tabindex="-1"></a><span class="at">@Validated</span></span>
|
||
<span id="cb11-5"><a href="#cb11-5" aria-hidden="true" tabindex="-1"></a><span class="kw">public</span> <span class="kw">class</span> AccountProcessController <span class="op">{</span></span>
|
||
<span id="cb11-6"><a href="#cb11-6" aria-hidden="true" tabindex="-1"></a> </span>
|
||
<span id="cb11-7"><a href="#cb11-7" aria-hidden="true" tabindex="-1"></a> <span class="at">@PostMapping</span><span class="op">(</span><span class="st">"/adjust"</span><span class="op">)</span></span>
|
||
<span id="cb11-8"><a href="#cb11-8" aria-hidden="true" tabindex="-1"></a> <span class="at">@Operation</span><span class="op">(</span>summary <span class="op">=</span> <span class="st">"账务调整"</span><span class="op">)</span></span>
|
||
<span id="cb11-9"><a href="#cb11-9" aria-hidden="true" tabindex="-1"></a> <span class="at">@PreAuthorize</span><span class="op">(</span><span class="st">"@ss.hasPermission('water:account:adjust')"</span><span class="op">)</span></span>
|
||
<span id="cb11-10"><a href="#cb11-10" aria-hidden="true" tabindex="-1"></a> <span class="kw">public</span> CommonResult<span class="op"><</span><span class="bu">Boolean</span><span class="op">></span> <span class="fu">adjustAccount</span><span class="op">(</span><span class="at">@Valid</span> <span class="at">@RequestBody</span> AccountAdjustReqVO adjustReqVO<span class="op">);</span></span>
|
||
<span id="cb11-11"><a href="#cb11-11" aria-hidden="true" tabindex="-1"></a> </span>
|
||
<span id="cb11-12"><a href="#cb11-12" aria-hidden="true" tabindex="-1"></a> <span class="at">@PostMapping</span><span class="op">(</span><span class="st">"/refund"</span><span class="op">)</span></span>
|
||
<span id="cb11-13"><a href="#cb11-13" aria-hidden="true" tabindex="-1"></a> <span class="at">@Operation</span><span class="op">(</span>summary <span class="op">=</span> <span class="st">"退款处理"</span><span class="op">)</span></span>
|
||
<span id="cb11-14"><a href="#cb11-14" aria-hidden="true" tabindex="-1"></a> <span class="at">@PreAuthorize</span><span class="op">(</span><span class="st">"@ss.hasPermission('water:account:refund')"</span><span class="op">)</span></span>
|
||
<span id="cb11-15"><a href="#cb11-15" aria-hidden="true" tabindex="-1"></a> <span class="kw">public</span> CommonResult<span class="op"><</span><span class="bu">Boolean</span><span class="op">></span> <span class="fu">processRefund</span><span class="op">(</span><span class="at">@Valid</span> <span class="at">@RequestBody</span> RefundProcessReqVO refundReqVO<span class="op">);</span></span>
|
||
<span id="cb11-16"><a href="#cb11-16" aria-hidden="true" tabindex="-1"></a> </span>
|
||
<span id="cb11-17"><a href="#cb11-17" aria-hidden="true" tabindex="-1"></a> <span class="at">@PostMapping</span><span class="op">(</span><span class="st">"/write-off"</span><span class="op">)</span></span>
|
||
<span id="cb11-18"><a href="#cb11-18" aria-hidden="true" tabindex="-1"></a> <span class="at">@Operation</span><span class="op">(</span>summary <span class="op">=</span> <span class="st">"销账处理"</span><span class="op">)</span></span>
|
||
<span id="cb11-19"><a href="#cb11-19" aria-hidden="true" tabindex="-1"></a> <span class="at">@PreAuthorize</span><span class="op">(</span><span class="st">"@ss.hasPermission('water:account:write-off')"</span><span class="op">)</span></span>
|
||
<span id="cb11-20"><a href="#cb11-20" aria-hidden="true" tabindex="-1"></a> <span class="kw">public</span> CommonResult<span class="op"><</span><span class="bu">Boolean</span><span class="op">></span> <span class="fu">writeOffAccount</span><span class="op">(</span><span class="at">@Valid</span> <span class="at">@RequestBody</span> WriteOffReqVO writeOffReqVO<span class="op">);</span></span>
|
||
<span id="cb11-21"><a href="#cb11-21" aria-hidden="true" tabindex="-1"></a><span class="op">}</span></span></code></pre></div>
|
||
<h3 data-number="1.5.5" id="发票管理"><span
|
||
class="header-section-number">1.5.5</span> 3.5 发票管理</h3>
|
||
<p>发票管理模块负责水费发票的全生命周期管理，支持纸质发票和电子发票。</p>
|
||
<h4 data-number="1.5.5.1" id="业务流程图-3"><span
|
||
class="header-section-number">1.5.5.1</span> 3.5.1 业务流程图</h4>
|
||
<p><strong>图表 7</strong></p>
|
||
<figure>
|
||
<img src="temp_mermaid_water_biz_module_design_6403/diagram_7.png"
|
||
alt="图表 7" />
|
||
<figcaption aria-hidden="true">图表 7</figcaption>
|
||
</figure>
|
||
<details>
|
||
<summary>
|
||
查看图表源码
|
||
</summary>
|
||
<pre class="mermaid"><code>flowchart TD
|
||
Start([发票业务]) --> InvoiceType{发票类型}
|
||
|
||
InvoiceType -->|纸质发票| PaperInvoice[纸质发票管理]
|
||
InvoiceType -->|电子发票| EInvoice[电子发票管理]
|
||
|
||
PaperInvoice --> PaperStock[发票库存管理]
|
||
PaperStock --> PaperPrint[发票打印]
|
||
PaperPrint --> PaperRecord[打印记录]
|
||
|
||
EInvoice --> EInvoiceGenerate[电子发票生成]
|
||
EInvoiceGenerate --> EInvoiceSign[电子签章]
|
||
EInvoiceSign --> EInvoiceSend[发票推送]
|
||
|
||
PaperRecord --> InvoiceQuery[发票查询]
|
||
EInvoiceSend --> InvoiceQuery
|
||
|
||
InvoiceQuery --> InvoiceCancel{需要作废?}
|
||
InvoiceCancel -->|是| CancelInvoice[发票作废]
|
||
InvoiceCancel -->|否| Complete([完成])
|
||
|
||
CancelInvoice --> CancelRecord[作废记录]
|
||
CancelRecord --> Complete
|
||
</code></pre>
|
||
</details>
|
||
<h4 data-number="1.5.5.2" id="核心接口定义-3"><span
|
||
class="header-section-number">1.5.5.2</span> 3.5.2 核心接口定义</h4>
|
||
<div class="sourceCode" id="cb13"><pre
|
||
class="sourceCode java"><code class="sourceCode java"><span id="cb13-1"><a href="#cb13-1" aria-hidden="true" tabindex="-1"></a><span class="at">@RestController</span></span>
|
||
<span id="cb13-2"><a href="#cb13-2" aria-hidden="true" tabindex="-1"></a><span class="at">@RequestMapping</span><span class="op">(</span><span class="st">"/admin-api/water/invoice"</span><span class="op">)</span></span>
|
||
<span id="cb13-3"><a href="#cb13-3" aria-hidden="true" tabindex="-1"></a><span class="at">@Tag</span><span class="op">(</span>name <span class="op">=</span> <span class="st">"管理后台 - 发票管理"</span><span class="op">)</span></span>
|
||
<span id="cb13-4"><a href="#cb13-4" aria-hidden="true" tabindex="-1"></a><span class="at">@Validated</span></span>
|
||
<span id="cb13-5"><a href="#cb13-5" aria-hidden="true" tabindex="-1"></a><span class="kw">public</span> <span class="kw">class</span> InvoiceController <span class="op">{</span></span>
|
||
<span id="cb13-6"><a href="#cb13-6" aria-hidden="true" tabindex="-1"></a> </span>
|
||
<span id="cb13-7"><a href="#cb13-7" aria-hidden="true" tabindex="-1"></a> <span class="at">@PostMapping</span><span class="op">(</span><span class="st">"/generate"</span><span class="op">)</span></span>
|
||
<span id="cb13-8"><a href="#cb13-8" aria-hidden="true" tabindex="-1"></a> <span class="at">@Operation</span><span class="op">(</span>summary <span class="op">=</span> <span class="st">"生成发票"</span><span class="op">)</span></span>
|
||
<span id="cb13-9"><a href="#cb13-9" aria-hidden="true" tabindex="-1"></a> <span class="kw">public</span> CommonResult<span class="op"><</span>InvoiceRespVO<span class="op">></span> <span class="fu">generateInvoice</span><span class="op">(</span><span class="at">@Valid</span> <span class="at">@RequestBody</span> InvoiceGenerateReqVO generateReqVO<span class="op">);</span></span>
|
||
<span id="cb13-10"><a href="#cb13-10" aria-hidden="true" tabindex="-1"></a> </span>
|
||
<span id="cb13-11"><a href="#cb13-11" aria-hidden="true" tabindex="-1"></a> <span class="at">@PostMapping</span><span class="op">(</span><span class="st">"/print"</span><span class="op">)</span></span>
|
||
<span id="cb13-12"><a href="#cb13-12" aria-hidden="true" tabindex="-1"></a> <span class="at">@Operation</span><span class="op">(</span>summary <span class="op">=</span> <span class="st">"打印发票"</span><span class="op">)</span></span>
|
||
<span id="cb13-13"><a href="#cb13-13" aria-hidden="true" tabindex="-1"></a> <span class="kw">public</span> CommonResult<span class="op"><</span><span class="bu">Boolean</span><span class="op">></span> <span class="fu">printInvoice</span><span class="op">(</span><span class="at">@Valid</span> <span class="at">@RequestBody</span> InvoicePrintReqVO printReqVO<span class="op">);</span></span>
|
||
<span id="cb13-14"><a href="#cb13-14" aria-hidden="true" tabindex="-1"></a> </span>
|
||
<span id="cb13-15"><a href="#cb13-15" aria-hidden="true" tabindex="-1"></a> <span class="at">@PostMapping</span><span class="op">(</span><span class="st">"/cancel"</span><span class="op">)</span></span>
|
||
<span id="cb13-16"><a href="#cb13-16" aria-hidden="true" tabindex="-1"></a> <span class="at">@Operation</span><span class="op">(</span>summary <span class="op">=</span> <span class="st">"发票作废"</span><span class="op">)</span></span>
|
||
<span id="cb13-17"><a href="#cb13-17" aria-hidden="true" tabindex="-1"></a> <span class="kw">public</span> CommonResult<span class="op"><</span><span class="bu">Boolean</span><span class="op">></span> <span class="fu">cancelInvoice</span><span class="op">(</span><span class="at">@Valid</span> <span class="at">@RequestBody</span> InvoiceCancelReqVO cancelReqVO<span class="op">);</span></span>
|
||
<span id="cb13-18"><a href="#cb13-18" aria-hidden="true" tabindex="-1"></a><span class="op">}</span></span></code></pre></div>
|
||
<h3 data-number="1.5.6" id="代收业务"><span
|
||
class="header-section-number">1.5.6</span> 3.6 代收业务</h3>
|
||
<p>代收业务模块负责处理各种渠道的水费代收业务，主要功能包括：</p>
|
||
<ul>
|
||
<li>实时收费：银行代收、支付宝/微信收费、代收点收费</li>
|
||
<li>银行代扣：代扣协议管理、代扣数据生成和处理</li>
|
||
<li>银行托收：托收单生成、托收数据处理</li>
|
||
<li>代扣渠道管理：渠道维护、规则设置、效率分析</li>
|
||
</ul>
|
||
<h3 data-number="1.5.7" id="环卫系统"><span
|
||
class="header-section-number">1.5.7</span> 3.7 环卫系统</h3>
|
||
<p>环卫系统模块负责管理与环卫相关的收费和计费业务，主要功能包括：</p>
|
||
<ul>
|
||
<li>计费核定：环卫收费规则配置和业务字典维护</li>
|
||
<li>计费退补：退费和补缴规则配置，字典配置参与计算</li>
|
||
<li>计费减免：环卫费用减免规则配置和审批流程</li>
|
||
<li>环卫收费统计：环卫收费数据统计和分析</li>
|
||
</ul>
|
||
<h3 data-number="1.5.8" id="业务工单"><span
|
||
class="header-section-number">1.5.8</span> 3.8 业务工单</h3>
|
||
<p>业务工单模块负责管理日常业务工单的流转和处理，主要功能包括：</p>
|
||
<ul>
|
||
<li>业务清单：查询通过系统办理的日常业务工单及进度信息</li>
|
||
<li>上报清单：新增、查询问题清单，包括通过手机端上报的问题</li>
|
||
<li>稽查工单：对手机端的稽查信息进行多条件查询和导出</li>
|
||
<li>移表工单：客户对需要进行移动的水表进行登记</li>
|
||
<li>换表工单：新增客户自报的换表和故障的水表等进行换表登记</li>
|
||
<li>工作流可视化：工作节点可视化展示和流程管理</li>
|
||
</ul>
|
||
<h2 data-number="1.6" id="四表务系统"><span
|
||
class="header-section-number">1.6</span> 四、表务系统</h2>
|
||
<p>表务系统负责水表的全生命周期管理，包括水表购置、安装、维修、更换等业务。</p>
|
||
<h3 data-number="1.6.1" id="表务工单"><span
|
||
class="header-section-number">1.6.1</span> 4.1 表务工单</h3>
|
||
<p>表务工单模块负责处理各类表务作业，主要功能包括：</p>
|
||
<ul>
|
||
<li>换表工单：换表计划、换表施工、换表回填</li>
|
||
<li>移表工单：移表申请、移表施工、移表验收</li>
|
||
<li>拆表工单：拆表申请、拆表施工、拆表确认</li>
|
||
<li>复装工单：复装申请、复装施工、复装验收</li>
|
||
<li>校表工单：校表申请、校表实施、校表结果</li>
|
||
<li>稽查工单：水量异常稽查、违规用水稽查、处罚决定</li>
|
||
<li>业务上报：异常上报、投诉上报、处理结果反馈</li>
|
||
</ul>
|
||
<h3 data-number="1.6.2" id="表务仓库"><span
|
||
class="header-section-number">1.6.2</span> 4.2 表务仓库</h3>
|
||
<p>表务仓库模块负责水表的仓储管理，主要功能包括：</p>
|
||
<ul>
|
||
<li>新表入库：水表检定、入库登记、入库确认</li>
|
||
<li>水表检定：检定信息记录、结果管理</li>
|
||
<li>水表领用：领用单登记、领用单管理</li>
|
||
<li>水表出库：出库登记、出库确认</li>
|
||
<li>水表退库：退库申请、退库确认</li>
|
||
<li>水表报废：报废申请、报废确认</li>
|
||
<li>水表生命周期查询：状态查询、历史记录查询</li>
|
||
</ul>
|
||
<h3 data-number="1.6.3" id="水表参数与基础信息"><span
|
||
class="header-section-number">1.6.3</span> 4.3 水表参数与基础信息</h3>
|
||
<p>水表参数与基础信息模块负责维护水表相关的基础数据，主要功能包括：</p>
|
||
<ul>
|
||
<li>水表厂家管理：厂家信息维护、厂家状态管理</li>
|
||
<li>水表型号管理：型号信息维护、型号分类管理</li>
|
||
<li>水表口径管理：口径信息维护、定换周期设置</li>
|
||
<li>水表量程管理：量程信息维护、量程范围设置</li>
|
||
</ul>
|
||
<h3 data-number="1.6.4" id="物联网对接与数据同步"><span
|
||
class="header-section-number">1.6.4</span> 4.4 物联网对接与数据同步</h3>
|
||
<p>物联网对接与数据同步模块负责水表数据的互联互通，主要功能包括：</p>
|
||
<ul>
|
||
<li>厂家设备信息管理：设备型号管理、厂家信息维护</li>
|
||
<li>表务对接日志：数据同步日志、错误处理</li>
|
||
<li>水表数据推送接口：新表数据推送、校验机制</li>
|
||
<li>远程抄表数据同步：数据接收、验证与处理</li>
|
||
<li>物联网水表监控：状态监控、异常事件报警</li>
|
||
</ul>
|
||
<h2 data-number="1.7" id="五报装系统"><span
|
||
class="header-section-number">1.7</span> 五、报装系统</h2>
|
||
<p>报装系统负责新用户的报装立户管理，主要功能包括：</p>
|
||
<h3 data-number="1.7.1" id="报装流程"><span
|
||
class="header-section-number">1.7.1</span> 5.1 报装流程</h3>
|
||
<p>报装流程模块负责新用户报装业务的全流程管理，主要功能包括：</p>
|
||
<ul>
|
||
<li>报装申请：用户申请、材料审核、现场勘查</li>
|
||
<li>方案设计：设计方案、设计审核、费用估算</li>
|
||
<li>合同签订：费用通知、合同签订、收费管理</li>
|
||
<li>施工管理：施工计划、施工实施、施工验收</li>
|
||
<li>开户通水：水表安装、用户立户、通水确认</li>
|
||
</ul>
|
||
<h3 data-number="1.7.2" id="一户一表管理"><span
|
||
class="header-section-number">1.7.2</span> 5.2 一户一表管理</h3>
|
||
<p>一户一表管理模块负责实施”一户一表”改造，主要功能包括：</p>
|
||
<ul>
|
||
<li>改造计划：制定改造计划、用户协商、费用估算</li>
|
||
<li>改造实施：施工管理、水表安装、验收管理</li>
|
||
<li>用户转换：数据转换、账务处理、使用确认</li>
|
||
</ul>
|
||
<h2 data-number="1.8" id="六客户服务"><span
|
||
class="header-section-number">1.8</span> 六、客户服务</h2>
|
||
<p>客户服务模块提供多渠道的客户服务功能，主要包括：</p>
|
||
<h3 data-number="1.8.1" id="微信支付宝服务窗"><span
|
||
class="header-section-number">1.8.1</span> 6.1 微信、支付宝服务窗</h3>
|
||
<ul>
|
||
<li>账户绑定：支持用户绑定水务账户</li>
|
||
<li>用水查询：查询用水情况和用水趋势</li>
|
||
<li>水费查询：查询水费信息和欠费信息</li>
|
||
<li>在线缴费：支持在线缴纳水费</li>
|
||
<li>业务办理：支持在线办理简单业务</li>
|
||
</ul>
|
||
<h3 data-number="1.8.2" id="历史账单"><span
|
||
class="header-section-number">1.8.2</span> 6.2 历史账单</h3>
|
||
<ul>
|
||
<li>账单查询：查询历史账单信息</li>
|
||
<li>用水分析：分析用水趋势，提供图表展示</li>
|
||
<li>账单推送：定期推送账单信息</li>
|
||
<li>账单明细：提供详细的账单明细</li>
|
||
</ul>
|
||
<h3 data-number="1.8.3" id="电子发票"><span
|
||
class="header-section-number">1.8.3</span> 6.3 电子发票</h3>
|
||
<ul>
|
||
<li>发票申请：申请开具电子发票</li>
|
||
<li>发票查询：查询已开具发票</li>
|
||
<li>发票下载：下载电子发票</li>
|
||
<li>发票推送：推送电子发票到用户邮箱或微信</li>
|
||
</ul>
|
||
<h3 data-number="1.8.4" id="营业网点"><span
|
||
class="header-section-number">1.8.4</span> 6.4 营业网点</h3>
|
||
<ul>
|
||
<li>网点查询：查询营业网点信息</li>
|
||
<li>网点导航：提供到营业网点的导航</li>
|
||
<li>业务指南：提供各网点业务办理指南</li>
|
||
<li>等候情况：实时显示各网点的等候情况</li>
|
||
</ul>
|
||
<h3 data-number="1.8.5" id="账户流水"><span
|
||
class="header-section-number">1.8.5</span> 6.5 账户流水</h3>
|
||
<ul>
|
||
<li>流水查询：查询账户交易流水</li>
|
||
<li>明细下载：下载流水明细</li>
|
||
<li>交易统计：提供交易金额统计</li>
|
||
<li>缴费证明：生成缴费证明</li>
|
||
</ul>
|
||
<h3 data-number="1.8.6" id="微网厅"><span
|
||
class="header-section-number">1.8.6</span> 6.6 微网厅</h3>
|
||
<ul>
|
||
<li>用户注册：用户注册微网厅账号</li>
|
||
<li>信息查询：查询用水、缴费信息</li>
|
||
<li>业务办理：在线办理各类业务</li>
|
||
<li>用户反馈：提交意见建议</li>
|
||
</ul>
|
||
<h2 data-number="1.9" id="七系统配置"><span
|
||
class="header-section-number">1.9</span> 七、系统配置</h2>
|
||
<p>系统配置模块提供各类系统参数的配置管理功能，主要包括：</p>
|
||
<h3 data-number="1.9.1" id="水表参数"><span
|
||
class="header-section-number">1.9.1</span> 7.1 水表参数</h3>
|
||
<ul>
|
||
<li>水表厂家：管理水表生产厂商信息</li>
|
||
<li>水表型号：管理水表型号规格</li>
|
||
<li>水表量程：管理水表量程规格</li>
|
||
</ul>
|
||
<h3 data-number="1.9.2" id="地址参数"><span
|
||
class="header-section-number">1.9.2</span> 7.2 地址参数</h3>
|
||
<ul>
|
||
<li>行政区划：管理行政区划信息</li>
|
||
<li>地址编码：管理地址编码规则</li>
|
||
<li>地址库：维护标准地址库</li>
|
||
</ul>
|
||
<h3 data-number="1.9.3" id="价格体系"><span
|
||
class="header-section-number">1.9.3</span> 7.3 价格体系</h3>
|
||
<ul>
|
||
<li>用水性质：管理不同用水性质的分类</li>
|
||
<li>水价标准：管理不同用水性质的水价标准</li>
|
||
<li>阶梯水价：管理阶梯水价设置</li>
|
||
<li>调价管理：管理水价调整流程</li>
|
||
</ul>
|
||
<h3 data-number="1.9.4" id="基本配置"><span
|
||
class="header-section-number">1.9.4</span> 7.4 基本配置</h3>
|
||
<ul>
|
||
<li>系统参数：管理系统基本参数</li>
|
||
<li>业务规则：管理业务处理规则</li>
|
||
<li>打印模板：管理各类打印模板</li>
|
||
<li>短信模板：管理短信发送模板</li>
|
||
</ul>
|
||
<h3 data-number="1.9.5" id="催缴管理"><span
|
||
class="header-section-number">1.9.5</span> 7.5 催缴管理</h3>
|
||
<ul>
|
||
<li>催缴计划：制定欠费催缴计划</li>
|
||
<li>催缴任务：分配催缴任务</li>
|
||
<li>催缴执行：记录催缴执行情况</li>
|
||
<li>催缴结果：统计催缴结果</li>
|
||
</ul>
|
||
<h3 data-number="1.9.6" id="用户权限"><span
|
||
class="header-section-number">1.9.6</span> 7.6 用户权限</h3>
|
||
<ul>
|
||
<li>菜单权限：不同角色可访问的菜单权限配置</li>
|
||
<li>功能权限：不同角色可操作的功能权限配置</li>
|
||
<li>数据权限：通过查询字典权限控制不同用户业务取数权限</li>
|
||
<li>角色管理：自定义角色及权限组合</li>
|
||
</ul>
|
||
<h3 data-number="1.9.7" id="定时任务"><span
|
||
class="header-section-number">1.9.7</span> 7.7 定时任务</h3>
|
||
<ul>
|
||
<li>任务配置：定时任务可视化配置，包含传参设置</li>
|
||
<li>任务监控：定时任务执行状态监控</li>
|
||
<li>任务日志：定时任务执行日志记录和查询</li>
|
||
<li>任务调度：任务优先级和执行顺序管理</li>
|
||
</ul>
|
||
<h2 data-number="1.10" id="八系统接口"><span
|
||
class="header-section-number">1.10</span> 八、系统接口</h2>
|
||
<p>系统接口模块提供与外部系统的集成和数据交换功能，实现业务数据的互通互联。</p>
|
||
<h3 data-number="1.10.1" id="银行接口"><span
|
||
class="header-section-number">1.10.1</span> 8.1 银行接口</h3>
|
||
<p>银行接口实现与银行系统的对接，支持代扣、托收等功能，主要包括：</p>
|
||
<ul>
|
||
<li>收费接口：实现用户通过银行渠道缴纳水费</li>
|
||
<li>冲正接口：处理银行退款和交易取消</li>
|
||
<li>对账接口：与银行系统进行对账</li>
|
||
<li>托收接口：支持银行托收功能</li>
|
||
<li>代扣接口：支持银行代扣功能</li>
|
||
</ul>
|
||
<h3 data-number="1.10.2" id="支付宝微信接口"><span
|
||
class="header-section-number">1.10.2</span> 8.2 支付宝/微信接口</h3>
|
||
<p>支付宝和微信接口实现与第三方支付平台的对接，支持在线支付功能，主要包括：</p>
|
||
<ul>
|
||
<li>欠费查询：查询用户欠费信息</li>
|
||
<li>在线支付：支持用户在线缴纳水费</li>
|
||
<li>支付通知：处理支付结果通知</li>
|
||
<li>对账接口：与支付平台进行对账</li>
|
||
</ul>
|
||
<h3 data-number="1.10.3" id="短信接口"><span
|
||
class="header-section-number">1.10.3</span> 8.3 短信接口</h3>
|
||
<p>短信接口提供短信通知和验证功能，主要包括：</p>
|
||
<ul>
|
||
<li>账单通知：通过短信通知用户账单信息</li>
|
||
<li>缴费提醒：提醒用户及时缴费</li>
|
||
<li>催缴通知：向欠费用户发送催缴短信</li>
|
||
<li>业务通知：通知用户业务办理状态</li>
|
||
<li>验证码功能：提供短信验证码服务</li>
|
||
</ul>
|
||
<h3 data-number="1.10.4" id="集抄系统接口"><span
|
||
class="header-section-number">1.10.4</span> 8.4 集抄系统接口</h3>
|
||
<p>集抄系统接口实现与智能水表集中抄表系统的对接，主要包括：</p>
|
||
<ul>
|
||
<li>抄表数据获取：获取智能水表的抄表数据</li>
|
||
<li>水表状态监控：监控水表的使用状态</li>
|
||
<li>异常数据处理：处理抄表异常情况</li>
|
||
</ul>
|
||
<h3 data-number="1.10.5" id="政务系统接口"><span
|
||
class="header-section-number">1.10.5</span> 8.5 政务系统接口</h3>
|
||
<p>政务系统接口实现与地方政务平台和政务APP的对接，主要包括：</p>
|
||
<ul>
|
||
<li>数据推送：推送营收数据到政务平台</li>
|
||
<li>数据查询：支持政务平台查询水务数据</li>
|
||
<li>缴费对接：支持通过政务平台缴费</li>
|
||
<li>报装工单对接：对接报装业务工单</li>
|
||
</ul>
|
||
<h3 data-number="1.10.6" id="消火栓系统接口"><span
|
||
class="header-section-number">1.10.6</span> 8.6 消火栓系统接口</h3>
|
||
<p>消火栓系统接口实现与消火栓系统的对接，主要功能包括：</p>
|
||
<ul>
|
||
<li>预存缴费管理：管理用户预存水费</li>
|
||
<li>剩余水量计算：计算用户剩余可用水量</li>
|
||
<li>取水控制：根据预存和剩余水量控制取水</li>
|
||
</ul>
|
||
<h3 data-number="1.10.7" id="其他系统对接"><span
|
||
class="header-section-number">1.10.7</span> 8.7 其他系统对接</h3>
|
||
<p>其他系统对接模块负责与周边系统进行数据交换和业务协同，主要功能包括：</p>
|
||
<ul>
|
||
<li>环卫系统对接：实现与环卫系统的数据同步和业务流程对接</li>
|
||
<li>客服系统对接：实现与客服系统的工单同步和问题处理</li>
|
||
<li>工单系统对接：实现与工单系统的工单流转和状态同步</li>
|
||
<li>OA系统对接：实现与OA系统的审批流程对接和数据共享</li>
|
||
<li>智水擎平台对接：实现与智水擎平台的数据交换和业务协同</li>
|
||
</ul>
|
||
<h2 data-number="1.11" id="九统计分析"><span
|
||
class="header-section-number">1.11</span> 九、统计分析</h2>
|
||
<p>统计分析模块提供多维度的数据统计和分析功能，为管理决策提供数据支持。</p>
|
||
<h3 data-number="1.11.1" id="报表查询"><span
|
||
class="header-section-number">1.11.1</span> 9.1 报表查询</h3>
|
||
<ul>
|
||
<li>标准报表：系统内置的标准统计报表</li>
|
||
<li>自定义报表：用户可自定义的报表</li>
|
||
<li>报表导出：支持将报表导出为Excel、PDF等格式</li>
|
||
<li>报表打印：支持报表打印功能</li>
|
||
</ul>
|
||
<h3 data-number="1.11.2" id="欠费查询"><span
|
||
class="header-section-number">1.11.2</span> 9.2 欠费查询</h3>
|
||
<ul>
|
||
<li>欠费情况统计：按区域、用户类型等维度统计欠费情况</li>
|
||
<li>欠费用户明细：查询欠费用户的详细信息</li>
|
||
<li>欠费分析：分析欠费原因和趋势</li>
|
||
<li>欠费导出：支持将欠费数据导出</li>
|
||
</ul>
|
||
<h3 data-number="1.11.3" id="缴费记录"><span
|
||
class="header-section-number">1.11.3</span> 9.3 缴费记录</h3>
|
||
<ul>
|
||
<li>缴费情况统计：按多维度统计缴费情况</li>
|
||
<li>缴费明细查询：查询缴费明细记录</li>
|
||
<li>缴费趋势分析：分析缴费趋势</li>
|
||
<li>缴费渠道分析：分析各缴费渠道的使用情况</li>
|
||
</ul>
|
||
<h3 data-number="1.11.4" id="用水分析"><span
|
||
class="header-section-number">1.11.4</span> 9.4 用水分析</h3>
|
||
<ul>
|
||
<li>用水量统计：按多维度统计用水量</li>
|
||
<li>用水趋势分析：分析用水趋势，预测用水需求</li>
|
||
<li>异常用水分析：识别和分析异常用水情况</li>
|
||
<li>节水潜力分析：分析用户节水潜力</li>
|
||
</ul>
|
||
<h2 data-number="1.12" id="十工程管理"><span
|
||
class="header-section-number">1.12</span> 十、工程管理</h2>
|
||
<p>工程管理模块负责处理与供水工程相关的业务，包括工程申请、施工管理和工程验收等。</p>
|
||
<h3 data-number="1.12.1" id="工程申请"><span
|
||
class="header-section-number">1.12.1</span> 10.1 工程申请</h3>
|
||
<ul>
|
||
<li>工程立项：新建供水工程的立项申请</li>
|
||
<li>材料提交：上传工程相关材料</li>
|
||
<li>前期勘察：记录工程前期勘察结果</li>
|
||
<li>工程预算：制定工程预算方案</li>
|
||
<li>申请审批：对工程申请进行审批</li>
|
||
</ul>
|
||
<h3 data-number="1.12.2" id="工程施工"><span
|
||
class="header-section-number">1.12.2</span> 10.2 工程施工</h3>
|
||
<ul>
|
||
<li>施工计划：制定工程施工计划</li>
|
||
<li>施工派工：将施工任务分配给施工人员</li>
|
||
<li>施工记录：记录施工过程和施工情况</li>
|
||
<li>材料管理：管理工程施工材料的使用情况</li>
|
||
<li>施工异常处理：处理施工过程中的异常情况</li>
|
||
</ul>
|
||
<h3 data-number="1.12.3" id="工程验收"><span
|
||
class="header-section-number">1.12.3</span> 10.3 工程验收</h3>
|
||
<ul>
|
||
<li>验收申请：提交工程验收申请</li>
|
||
<li>验收检查：对工程进行验收检查</li>
|
||
<li>验收记录：记录验收结果</li>
|
||
<li>竣工结算：进行工程竣工结算</li>
|
||
<li>工程归档：对工程资料进行归档</li>
|
||
</ul>
|
||
<h3 data-number="1.12.4" id="工程查询"><span
|
||
class="header-section-number">1.12.4</span> 10.4 工程查询</h3>
|
||
<ul>
|
||
<li>工程进度查询：查询工程进度情况</li>
|
||
<li>工程资料查询：查询工程相关资料</li>
|
||
<li>工程统计：统计工程数量、金额等信息</li>
|
||
<li>工程分析：分析工程实施情况</li>
|
||
</ul>
|
||
<h2 data-number="1.13" id="十一抄表app"><span
|
||
class="header-section-number">1.13</span> 十一、抄表APP</h2>
|
||
<p>抄表APP是针对移动端开发的抄表工具，支持外勤人员进行现场抄表、问题处理和工单管理等业务操作。</p>
|
||
<h3 data-number="1.13.1" id="首页功能"><span
|
||
class="header-section-number">1.13.1</span> 11.1 首页功能</h3>
|
||
<ul>
|
||
<li>首页：显示当前登录用户信息、快捷搜索和主要和抄表业务相关的功能模块</li>
|
||
<li>个人信息：查看个人信息，可以进行密码、手机号信息修改，可以进行抄表设置</li>
|
||
<li>快捷查询：提供搜索栏，用户输入户号、户名、地址以及册本后，系统会自动检索到相关的信息</li>
|
||
</ul>
|
||
<h3 data-number="1.13.2" id="抄表功能"><span
|
||
class="header-section-number">1.13.2</span> 11.2 抄表功能</h3>
|
||
<ul>
|
||
<li>抄表任务：显示当前登录的抄表员抄表任务信息</li>
|
||
<li>NFC抄表：抄表设备感应NFC后自动弹出抄表页</li>
|
||
<li>扫码抄表：扫水表上二维码，搜集该表信息，弹出抄表页</li>
|
||
<li>数据采集：抄表数据现场采集功能</li>
|
||
<li>AI录入：对接AI接口实现智能读数</li>
|
||
<li>抄表轨迹：记录表的物理位置，在地图上点击后采集水表定位</li>
|
||
<li>抄表导航：指引抄表员前往下一个抄表点</li>
|
||
<li>抄表汇总：系统会根据当前登录的人员自动汇总抄表信息</li>
|
||
<li>账单查询：查询客户账单详情</li>
|
||
<li>欠费查询：显示当前登录的抄表员抄表用水客户的欠费情况</li>
|
||
</ul>
|
||
<h3 data-number="1.13.3" id="工单管理"><span
|
||
class="header-section-number">1.13.3</span> 11.3 工单管理</h3>
|
||
<ul>
|
||
<li>问题上报：系统支持上报当前登录的抄表员抄表时遇到的用水问题</li>
|
||
<li>问题回填：问题上报后，可进行问题回填和处理</li>
|
||
<li>代办工单：显示当前登录的抄表员需要代办工单</li>
|
||
<li>平台工单管理：移动端提交工单后，系统会自动提交到工单处置平台进行受理、派发</li>
|
||
<li>停水复水工单：当客户存在欠费的情况下可以对该客户进行停水操作</li>
|
||
<li>稽查工单：实现抄表稽查和水价稽查</li>
|
||
<li>维修工单：提交坏表维修报修等工单</li>
|
||
</ul>
|
||
<h2 data-number="1.14" id="十二接口服务"><span
|
||
class="header-section-number">1.14</span> 十二、接口服务</h2>
|
||
<p>接口服务模块提供系统对外的API接口管理和服务能力，实现与第三方系统的便捷集成。</p>
|
||
<h3 data-number="1.14.1" id="api市场"><span
|
||
class="header-section-number">1.14.1</span> 12.1 API市场</h3>
|
||
<ul>
|
||
<li>API展示：展示系统提供的各类API接口</li>
|
||
<li>API使用说明：提供API接口的详细使用说明和示例</li>
|
||
<li>API测试：提供API接口的在线测试功能</li>
|
||
</ul>
|
||
<h3 data-number="1.14.2" id="api管理"><span
|
||
class="header-section-number">1.14.2</span> 12.2 API管理</h3>
|
||
<ul>
|
||
<li>API申请：第三方系统申请调用API的流程管理</li>
|
||
<li>API调度看板：监控API调用情况和性能指标</li>
|
||
<li>接口服务配置管理：管理API接口的配置参数</li>
|
||
<li>接口限流熔断管理：控制API接口的调用频率和熔断机制</li>
|
||
</ul>
|
||
<h3 data-number="1.14.3" id="接口权限管理"><span
|
||
class="header-section-number">1.14.3</span> 12.3 接口权限管理</h3>
|
||
<ul>
|
||
<li>授权管理：管理API接口的授权信息</li>
|
||
<li>白名单管理：设置允许访问API的IP白名单</li>
|
||
<li>安全策略：设置API调用的安全策略和防护措施</li>
|
||
</ul>
|
||
<h3 data-number="1.14.4" id="系统对外接口"><span
|
||
class="header-section-number">1.14.4</span> 12.4 系统对外接口</h3>
|
||
<ul>
|
||
<li>查询接口：提供各类数据查询接口</li>
|
||
<li>业务处理接口：提供业务处理和操作接口</li>
|
||
<li>状态同步接口：提供状态信息同步接口</li>
|
||
<li>数据推送接口：提供数据推送和订阅接口</li>
|
||
</ul>
|
||
<h2 data-number="1.15" id="系统集成架构"><span
|
||
class="header-section-number">1.15</span> 系统集成架构</h2>
|
||
<h3 data-number="1.15.1" id="前后端集成架构"><span
|
||
class="header-section-number">1.15.1</span> 前后端集成架构</h3>
|
||
<p><strong>图表 8</strong></p>
|
||
<figure>
|
||
<img src="temp_mermaid_water_biz_module_design_6403/diagram_8.png"
|
||
alt="图表 8" />
|
||
<figcaption aria-hidden="true">图表 8</figcaption>
|
||
</figure>
|
||
<details>
|
||
<summary>
|
||
查看图表源码
|
||
</summary>
|
||
<pre class="mermaid"><code>graph TB
|
||
subgraph "前端应用"
|
||
F1[管理后台<br/>yudao-ui-admin-vue3]
|
||
F2[移动端<br/>uni-app]
|
||
F3[客户端<br/>微信小程序]
|
||
end
|
||
|
||
subgraph "后端服务"
|
||
B1[认证服务<br/>Spring Security]
|
||
B2[业务服务<br/>RuoYi-Vue-Pro]
|
||
B3[网关服务<br/>Spring Cloud Gateway]
|
||
end
|
||
|
||
subgraph "数据存储"
|
||
D1[(OpenGauss 5.0+)]
|
||
D2[(Redis 6.0)]
|
||
D3[MinIO文件存储]
|
||
end
|
||
|
||
F1 --> B3
|
||
F2 --> B3
|
||
F3 --> B3
|
||
|
||
B3 --> B1
|
||
B3 --> B2
|
||
|
||
B1 --> D2
|
||
B2 --> D1
|
||
B2 --> D2
|
||
B2 --> D3
|
||
</code></pre>
|
||
</details>
|
||
<h3 data-number="1.15.2" id="技术栈整合方案"><span
|
||
class="header-section-number">1.15.2</span> 技术栈整合方案</h3>
|
||
<p><strong>后端技术整合</strong>： - Spring Boot 3.x作为核心框架 -
|
||
Spring Security 6.x提供安全认证 - MyBatis Plus 3.x简化数据访问 -
|
||
RuoYi-Vue-Pro提供基础功能框架</p>
|
||
<p><strong>前端技术整合</strong>： - Vue 3.x + TypeScript构建现代化前端
|
||
- Element Plus提供UI组件库 - Vite作为构建工具 - Pinia进行状态管理</p>
|
||
<p><strong>数据库集成</strong>： - OpenGauss
|
||
5.0+作为主数据库，国产自主可控 - Redis 6.0提供缓存和会话管理 -
|
||
HikariCP连接池优化和读写分离支持</p>
|
||
<p><strong>中间件集成</strong>： - RabbitMQ提供消息队列 -
|
||
MinIO提供文件存储 - Elasticsearch提供全文搜索</p>
|
||
</body>
|
||
</html>
|