241 lines
10 KiB
HTML
241 lines
10 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="#up-001-统一认证与单点登录"
|
|
id="toc-up-001-统一认证与单点登录"><span
|
|
class="toc-section-number">2.1</span> UP-001 统一认证与单点登录</a>
|
|
<ul>
|
|
<li><a href="#功能说明" id="toc-功能说明"><span
|
|
class="toc-section-number">2.1.1</span> 功能说明</a></li>
|
|
<li><a href="#关键设计" id="toc-关键设计"><span
|
|
class="toc-section-number">2.1.2</span> 关键设计</a></li>
|
|
<li><a href="#业务流程" id="toc-业务流程"><span
|
|
class="toc-section-number">2.1.3</span> 业务流程</a></li>
|
|
<li><a href="#核心数据" id="toc-核心数据"><span
|
|
class="toc-section-number">2.1.4</span> 核心数据</a></li>
|
|
</ul></li>
|
|
<li><a href="#up-002-组织用户与权限管理"
|
|
id="toc-up-002-组织用户与权限管理"><span
|
|
class="toc-section-number">2.2</span> UP-002 组织用户与权限管理</a>
|
|
<ul>
|
|
<li><a href="#功能说明-1" id="toc-功能说明-1"><span
|
|
class="toc-section-number">2.2.1</span> 功能说明</a></li>
|
|
<li><a href="#关键设计-1" id="toc-关键设计-1"><span
|
|
class="toc-section-number">2.2.2</span> 关键设计</a></li>
|
|
<li><a href="#主要规则" id="toc-主要规则"><span
|
|
class="toc-section-number">2.2.3</span> 主要规则</a></li>
|
|
</ul></li>
|
|
<li><a href="#up-003-参数字典与基础配置"
|
|
id="toc-up-003-参数字典与基础配置"><span
|
|
class="toc-section-number">2.3</span> UP-003 参数字典与基础配置</a>
|
|
<ul>
|
|
<li><a href="#功能说明-2" id="toc-功能说明-2"><span
|
|
class="toc-section-number">2.3.1</span> 功能说明</a></li>
|
|
<li><a href="#关键设计-2" id="toc-关键设计-2"><span
|
|
class="toc-section-number">2.3.2</span> 关键设计</a></li>
|
|
</ul></li>
|
|
<li><a href="#up-004-审计监控与运维支撑"
|
|
id="toc-up-004-审计监控与运维支撑"><span
|
|
class="toc-section-number">2.4</span> UP-004 审计监控与运维支撑</a>
|
|
<ul>
|
|
<li><a href="#功能说明-3" id="toc-功能说明-3"><span
|
|
class="toc-section-number">2.4.1</span> 功能说明</a></li>
|
|
<li><a href="#关键设计-3" id="toc-关键设计-3"><span
|
|
class="toc-section-number">2.4.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>
|
|
<ul>
|
|
<li><a href="#sec-position">文档定位</a></li>
|
|
<li><a href="#sec-content">统一平台详细设计正文</a>
|
|
<ul>
|
|
<li><a href="#mod-up-001">UP-001 统一认证与单点登录</a></li>
|
|
<li><a href="#mod-up-002">UP-002 组织用户与权限管理</a></li>
|
|
<li><a href="#mod-up-003">UP-003 参数字典与基础配置</a></li>
|
|
<li><a href="#mod-up-004">UP-004 审计监控与运维支撑</a></li>
|
|
</ul></li>
|
|
</ul>
|
|
<p><a id="sec-position"></a></p>
|
|
<h2 data-number="1.2" id="文档定位"><span
|
|
class="header-section-number">1.2</span> 文档定位</h2>
|
|
<p>本文档为 <code>01_Detailed_Design.md</code>
|
|
中“统一平台详细设计”章节的模块正文拆分稿，便于按模块独立维护。正式交付口径以主详设为准。</p>
|
|
<p><a id="sec-content"></a></p>
|
|
<h1 data-number="2" id="统一平台详细设计"><span
|
|
class="header-section-number">2</span> 统一平台详细设计</h1>
|
|
<p><a id="mod-up-001"></a></p>
|
|
<h2 data-number="2.1" id="up-001-统一认证与单点登录"><span
|
|
class="header-section-number">2.1</span> UP-001 统一认证与单点登录</h2>
|
|
<h3 data-number="2.1.1" id="功能说明"><span
|
|
class="header-section-number">2.1.1</span> 功能说明</h3>
|
|
<p>UP-001 为全系统提供统一身份认证与单点登录能力，支撑 PC
|
|
管理端、移动作业端、客户渠道及外部集成应用的统一接入。</p>
|
|
<h3 data-number="2.1.2" id="关键设计"><span
|
|
class="header-section-number">2.1.2</span> 关键设计</h3>
|
|
<ol type="1">
|
|
<li>支持用户名密码登录、短信验证码登录、第三方授权登录。</li>
|
|
<li>采用 OAuth2.0 + JWT 实现访问令牌签发与会话管理。</li>
|
|
<li>对外部系统开放标准认证接口，支持令牌续期与退出失效。</li>
|
|
<li>对高敏感操作支持 MFA 二次校验。</li>
|
|
</ol>
|
|
<h3 data-number="2.1.3" id="业务流程"><span
|
|
class="header-section-number">2.1.3</span> 业务流程</h3>
|
|
<pre class="mermaid"><code>sequenceDiagram
|
|
participant 用户
|
|
participant 接入端
|
|
participant 认证中心
|
|
participant 用户中心
|
|
|
|
用户->>接入端: 提交登录信息
|
|
接入端->>认证中心: 发起认证请求
|
|
认证中心->>用户中心: 校验用户/角色/状态
|
|
用户中心-->>认证中心: 返回校验结果
|
|
认证中心-->>接入端: 返回Token/权限上下文
|
|
接入端-->>用户: 登录成功并进入目标系统
|
|
</code></pre>
|
|
<h3 data-number="2.1.4" id="核心数据"><span
|
|
class="header-section-number">2.1.4</span> 核心数据</h3>
|
|
<ul>
|
|
<li><code>system_users</code>：用户基本信息。</li>
|
|
<li><code>system_oauth2_client</code>：客户端信息。</li>
|
|
<li><code>system_oauth2_access_token</code>：访问令牌。</li>
|
|
<li><code>system_oauth2_refresh_token</code>：刷新令牌。</li>
|
|
<li><code>system_login_log</code>：登录审计日志。</li>
|
|
</ul>
|
|
<p><a id="mod-up-002"></a></p>
|
|
<h2 data-number="2.2" id="up-002-组织用户与权限管理"><span
|
|
class="header-section-number">2.2</span> UP-002 组织用户与权限管理</h2>
|
|
<h3 data-number="2.2.1" id="功能说明-1"><span
|
|
class="header-section-number">2.2.1</span> 功能说明</h3>
|
|
<p>UP-002
|
|
管理组织机构、岗位、角色、菜单、数据权限和用户授权关系，是业务系统权限控制与数据隔离的基础。</p>
|
|
<h3 data-number="2.2.2" id="关键设计-1"><span
|
|
class="header-section-number">2.2.2</span> 关键设计</h3>
|
|
<ol type="1">
|
|
<li>支持集团—区域公司—营业所三级及以上组织结构。</li>
|
|
<li>基于 RBAC 实现菜单权限、按钮权限、数据权限。</li>
|
|
<li>支持多租户/多单位数据隔离与用户归属控制。</li>
|
|
<li>敏感操作如账务调整、退款、作废、签章回退必须经过权限校验。</li>
|
|
</ol>
|
|
<h3 data-number="2.2.3" id="主要规则"><span
|
|
class="header-section-number">2.2.3</span> 主要规则</h3>
|
|
<ul>
|
|
<li>角色权限与组织权限叠加生效。</li>
|
|
<li>业务数据默认按所属单位、片区、岗位范围过滤。</li>
|
|
<li>超权限查询、批量导出、敏感字段查看需单独授权。</li>
|
|
</ul>
|
|
<p><a id="mod-up-003"></a></p>
|
|
<h2 data-number="2.3" id="up-003-参数字典与基础配置"><span
|
|
class="header-section-number">2.3</span> UP-003 参数字典与基础配置</h2>
|
|
<h3 data-number="2.3.1" id="功能说明-2"><span
|
|
class="header-section-number">2.3.1</span> 功能说明</h3>
|
|
<p>UP-003
|
|
用于统一维护业务参数、地址参数、水价规则、短信模板、打印模板、字典数据与定时任务参数。</p>
|
|
<h3 data-number="2.3.2" id="关键设计-2"><span
|
|
class="header-section-number">2.3.2</span> 关键设计</h3>
|
|
<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>
|
|
<tr>
|
|
<td>任务参数</td>
|
|
<td>自动开账、对账、备份周期</td>
|
|
<td>运维调度</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<p><a id="mod-up-004"></a></p>
|
|
<h2 data-number="2.4" id="up-004-审计监控与运维支撑"><span
|
|
class="header-section-number">2.4</span> UP-004 审计监控与运维支撑</h2>
|
|
<h3 data-number="2.4.1" id="功能说明-3"><span
|
|
class="header-section-number">2.4.1</span> 功能说明</h3>
|
|
<p>UP-004
|
|
提供操作日志、登录日志、接口日志、异常监控、在线用户、任务监控、性能监控等能力。</p>
|
|
<h3 data-number="2.4.2" id="关键设计-3"><span
|
|
class="header-section-number">2.4.2</span> 关键设计</h3>
|
|
<ol type="1">
|
|
<li>所有核心业务操作写入统一审计日志。</li>
|
|
<li>接口调用成功率、响应时长、异常码进入监控平台。</li>
|
|
<li>定时任务执行结果、失败重试与人工补偿过程可追踪。</li>
|
|
<li>监控与告警支持短信、邮件、站内信等通知方式。</li>
|
|
</ol>
|
|
</body>
|
|
</html>
|