---
title: "01_System_Overview"
author: "系统设计团队"
date: "2024年12月19日"
documentclass: article
geometry: margin=1in
fontsize: 11pt
mainfont: "PingFang SC"
CJKmainfont: "PingFang SC"
---

---
doc_id: HL-01-OVERVIEW
doc_role: supporting_document
authority: supporting
scope: 总体设计-系统概述
source_of_truth: false
last_reviewed: 2026-03-11
retrieval_priority: P1
---

# 福建水务营收系统系统概述

## 1. 文档定位

本文档用于说明福建水务营收系统的建设背景、目标、范围边界、涉众角色与基础术语，作为总体设计层的导览入口。  
详细的模块设计、接口定义、数据结构与部署实现，以主文档和专项文档为准，不在本文重复展开。

## 2. 项目背景与建设目标

### 2.1 项目背景

福建水务营收系统面向水务企业营收管理与客户服务全流程，覆盖抄表、开账、收费、账务、工单、表务、报装与渠道服务。  
项目目标是将分散业务统一到可评审、可交付、可持续维护的体系下，支撑集团化与多组织协同。

### 2.2 建设目标

- 建立统一平台能力，支撑认证、权限、组织、参数、租户与审计监控。
- 建立营收业务主链路，覆盖客户、计量、收费、账务与客服服务。
- 建立独立业务子系统，支撑移动抄表、工单、表务与报装场景。
- 建立基础服务子系统，统一发票、支付结算、消息能力。
- 满足安全合规、国产化适配与持续交付要求。

## 3. 系统范围与边界

### 3.1 范围内

| 分类 | 范围说明 |
| --- | --- |
| 平台能力 | 统一认证、权限、租户、组织、参数、监控 |
| 核心业务 | 客户资料、抄表开账、营业收费、账务处理、发票、催缴、统计 |
| 业务子系统 | 手机抄表 APP、微网厅、工单管理、表务管理、报装业务 |
| 基础服务 | 发票服务、支付与银行结算、消息服务 |
| 外部集成 | 银行、第三方支付、短信/邮件/站内信、物联网、CA 能力 |

### 3.2 范围外

| 分类 | 说明 |
| --- | --- |
| 代码实现细节 | 具体类设计、SQL、接口字段定义 |
| 运维脚本实现 | 启停脚本、部署脚本、监控规则细项 |
| 测试用例细节 | 测试步骤、断言口径、执行结果 |

## 4. 涉众与角色

| 角色 | 关注重点 |
| --- | --- |
| 项目管理与评审人员 | 范围边界、建设目标、交付范围 |
| 架构与开发人员 | 子系统职责、总体边界、协同关系 |
| 测试与运维人员 | 系统分层、部署原则、安全与可运维约束 |
| 甲方技术人员 | 交付口径一致性、可追溯性、后续维护可行性 |

## 5. 术语与缩略语（概要层）

### 5.1 业务术语

| 术语 | 说明 |
| --- | --- |
| 营收业务系统（SYS-002） | 核心营收业务承载子系统 |
| 微网厅（SYS-004） | 面向外部客户服务的线上渠道 |
| 表务管理（SYS-006） | 水表设备与库存相关管理域 |
| 报装业务（SYS-007） | 新装/改装/流程办理相关业务域 |

### 5.2 技术术语

| 术语 | 说明 |
| --- | --- |
| SSO | 单点登录能力 |
| RBAC | 基于角色的访问控制 |
| OAuth2.0 + CAS | 统一认证与单点登录协议组合 |
| IF- 编号 | 接口编号前缀，用于与模块编号区分 |

## 6. 关联文档

### 6.1 本目录文档

- 系统架构说明：`02_System_Architecture.md`
- 概要设计主文档（单一真源）：`03_Summary_Design.md`
- 总体图谱文档：`04_System_Diagrams.md`

### 6.2 跨目录主文档

- 详细设计主文档：`../02_Detailed_Design/01_Detailed_Design.md`
- 数据库设计主文档：`../03_Technical_Design/01_Database_Design.md`
- 接口设计主文档：`../03_Technical_Design/03_Interface_Design.md`
- 安全设计主文档：`../03_Technical_Design/04_Security_Design.md`
- 部署设计主文档：`../03_Technical_Design/05_Deployment_Design.md`

### 6.3 对齐与核对资料

- 后端现状：`../../guides/BACKEND_CURRENT_STATUS.md`
- 后端表映射：`../../guides/BACKEND_TABLE_MAPPING.md`
- 历史资料归档：`../04_Appendix/Archive/`

## 7. 阅读路径建议

1. 先阅读 `03_Summary_Design.md`，建立统一口径。
2. 再阅读 `02_System_Architecture.md`，理解总体边界和架构原则。
3. 对照 `04_System_Diagrams.md`，核对图文一致性。
4. 按需进入详细设计、数据库和接口主文档。

## 8. 维护要求

- 本文档仅维护“概述级”信息，不引入实现细节。
- 出现与 `03_Summary_Design.md` 不一致时，以主文档为准并及时修正。
- 修改后至少执行：
  - `make validate-file FILE=docs/design/01_Overview/01_System_Overview.md`
  - `make check-links`