title, author, date, documentclass, geometry, fontsize, mainfont, CJKmainfont
| title |
author |
date |
documentclass |
geometry |
fontsize |
mainfont |
CJKmainfont |
| 01_System_Overview |
系统设计团队 |
2024年12月19日 |
article |
margin=1in |
11pt |
PingFang SC |
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. 阅读路径建议
- 先阅读
03_Summary_Design.md，建立统一口径。
- 再阅读
02_System_Architecture.md，理解总体边界和架构原则。
- 对照
04_System_Diagrams.md，核对图文一致性。
- 按需进入详细设计、数据库和接口主文档。
8. 维护要求
- 本文档仅维护“概述级”信息，不引入实现细节。
- 出现与
03_Summary_Design.md 不一致时，以主文档为准并及时修正。
- 修改后至少执行：
make validate-file FILE=docs/design/01_Overview/01_System_Overview.mdmake check-links
