---
title: "13_CS_Detailed"
author: "系统设计团队"
date: "2024年12月19日"
documentclass: article
geometry: margin=1in
fontsize: 11pt
mainfont: "PingFang SC"
CJKmainfont: "PingFang SC"
---
---
doc_id: DT-13-CS
doc_role: module_body
authority: secondary
scope: 详细设计-客户服务
source_of_truth: false
last_reviewed: 2026-03-18
retrieval_priority: P1
---
# 福建水务营收系统详细设计-客户服务模块正文
## 章节导航（精简）
- [文档定位](#sec-position)
- [架构图模块对齐说明](#sec-cs-alignment)
- [客户服务详细设计正文](#sec-content)
- [客户服务模块统一约束](#sec-cs-rules)
- [接口与数据追溯矩阵](#sec-cs-trace)
- [CS-001 账户绑定管理](#mod-cs-001)
- [CS-002 信息查询服务](#mod-cs-002)
- [CS-003 在线缴费服务](#mod-cs-003)
- [CS-004 电子发票服务](#mod-cs-004)
- [CS-005 营业网点服务](#mod-cs-005)
- [CS-006 业务办理服务](#mod-cs-006)
- [CS-007 柜面扫码支付](#mod-cs-007)
## 文档定位
本文档为 `01_Detailed_Design.md` 中“客户服务模块详细设计”章节的模块正文拆分稿，便于按模块独立维护。正式交付口径以主详设为准。
## 架构图模块对齐说明
整体架构图中，客户渠道相关模块同时使用了 `CS-*` 与 `WECHAT-*` 两套编号：
- `CS-*` 用于 `SYS-002` 营收业务子系统中的客户服务模块群表达；
- `WECHAT-*` 用于 `SYS-004` 微网厅子系统中的渠道形态表达。
当前详细设计采用“能力域优先”的承接方式，即以 `CS-*` 作为正式详细设计编号，将 `WECHAT-*` 视为渠道侧同源能力映射，不另建平行正式主稿。
| 架构图模块 | 当前详设承接章节 | 说明 |
| --- | --- | --- |
| `WECHAT-001` 账户绑定管理 | `CS-001` | 微网厅渠道形态映射到统一账户绑定能力 |
| `WECHAT-002` 信息查询服务 | `CS-002` | 微网厅账单、发票、流水查询能力映射 |
| `WECHAT-003` 在线缴费服务 | `CS-003` | 微网厅渠道缴费入口映射 |
| `WECHAT-004` 电子发票服务 | `CS-004` | 微网厅电子发票查看/推送/下载映射 |
| `WECHAT-005` 营业网点服务 | `CS-005` | 微网厅网点查询与预约引导映射 |
| `WECHAT-006` 业务办理服务 | `CS-006` | 微网厅线上办理入口映射 |
| `WECHAT-007` 账户流水 | `CS-002` | 当前并入信息查询服务，不单列平行正文 |
| `WECHAT-008` 账号与机构管理 | `CS-001` | 当前并入账户绑定与账户切换能力 |
# 客户服务模块详细设计
## 客户服务模块统一约束
1. 客户服务模块负责渠道侧受理与展示，核心账务、发票、通知结果均由 `SYS-002` 统一落账与回写。
2. 支付、发票、消息分别通过 `SYS-009`、`SYS-008`、`SYS-010` 协同完成，客户服务模块不直接承载外部平台业务规则。
3. 账户绑定、在线支付、发票申请、业务办理等关键动作必须进行身份校验与权限校验，禁止匿名高风险操作。
4. 支付与发票场景必须具备幂等控制，避免重复下单、重复开票、重复回写导致业务状态不一致。
5. 渠道请求、结果回写、人工补偿动作应保留可追溯日志，满足审计与争议处理要求。
## 接口与数据追溯矩阵
> 说明：详细接口字段与报文以 `../03_Technical_Design/03_Interface_Design.md` 为准。
| CS 模块 | 关键接口 | 核心数据域（摘要） | 主要协同对象 |
|---|---|---|---|
| CS-001 账户绑定管理 | `IF-CS-001` | `biz_cust_app_binds`、`biz_cust`、`biz_account` | 微信、支付宝、微网厅 |
| CS-002 信息查询服务 | `IF-CS-002` | `biz_charge*`、`biz_reading_data`、`biz_invoice` | 客户渠道、`SYS-002` |
| CS-003 在线缴费服务 | `IF-CS-003` | `biz_charge*`、`biz_collection`、`bk_transaction*` | `SYS-009` |
| CS-004 电子发票服务 | `IF-CS-004` | `biz_invoice*`、`biz_cust_invoice` | `SYS-008` |
| CS-005 营业网点服务 | `IF-CS-005` | `biz_outlets`、`biz_business_types` | 客户渠道 |
| CS-006 业务办理服务 | `IF-CS-006` | `biz_process*`、`biz_content_attach` | 工单系统、`SYS-010` |
| CS-007 柜面扫码支付 | `IF-CS-007` | `biz_collection`、`bk_transaction*`、`biz_charge` | 营业厅、`SYS-009` |
## CS-001 账户绑定管理（对齐 WECHAT-001 / WECHAT-008）
### 功能说明
面向微信、支付宝、微网厅等渠道实现客户账户绑定、解绑、默认账户设置、多账户切换与身份校验。
### 关键规则
1. 一个渠道账户可绑定多个用水账户。
2. 绑定、解绑、默认账户变更等敏感操作需进行身份校验。
3. 已销户、冻结或限制服务的账户不得新增绑定。
### 核心数据
- `biz_cust_app_binds`
- `biz_cust`
- `biz_account`
### 接口映射
- `IF-CS-001`：渠道账户绑定、解绑、默认账户切换。
- `IF-REV-001`：客户与账户信息查询，校验绑定对象合法性。
### 落地边界
- **已落地**：渠道绑定关系、客户与账户主数据引用。
- **部分落地**：多渠道同账号合并策略依赖业务规则与运营配置共同控制。
- **文档先行**：跨渠道统一身份画像与复杂合并规则仅保留设计语义。
## CS-002 信息查询服务（对齐 WECHAT-002 / WECHAT-007）
### 功能说明
提供账单查询、缴费记录查询、用水分析、欠费查询、账户流水、历史账单等服务。
### 关键设计
1. 查询范围严格限制在已绑定客户与账户范围内。
2. 账单、缴费、发票、办理进度等数据通过 SYS-002 标准接口聚合展示。
3. 常用历史数据支持按最近周期快速查询。
### 核心数据
- `biz_cust`
- `biz_account`
- `biz_charge`
- `biz_charge_detail`
- `biz_invoice`
### 接口映射
- `IF-CS-002`：账单、欠费、缴费、用水、发票等聚合查询。
- `IF-REV-001`：客户基础信息查询与状态校验。
- `IF-REV-010`：统计类查询场景复用营收统计接口能力。
### 落地边界
- **已落地**：账单、缴费、发票、客户信息等基础查询链路。
- **部分落地**：部分专题分析更多依赖报表端，不在渠道侧单独建模。
- **文档先行**：个性化推荐与预测分析不作为当前已实现能力表述。
## CS-003 在线缴费服务（对齐 WECHAT-003）
### 功能说明
提供微信支付、支付宝支付、银行卡支付、预存款支付等在线缴费能力。
### 业务流程
```mermaid
flowchart TD
A[提交缴费请求] --> B[校验账单与应缴金额]
B --> C[创建业务订单]
C --> D[调用SYS-009下单]
D --> E[接收支付回调/查询结果]
E --> F[更新核销状态]
F --> G[返回缴费结果]
```
### 关键规则
1. 下单前再次校验账单未缴状态和应缴金额。
2. 支付结果以 `SYS-009` 回调/查询确认为准。
3. 对失败订单支持补单、查询与结果回写。
### 核心数据
- `biz_charge`
- `biz_charge_detail`
- `bk_transaction`
- `bk_transaction_callback`
### 接口映射
- `IF-CS-003`：客户渠道支付下单入口。
- `IF-EXT-004`、`IF-EXT-005`：支付下单协同与结果回写。
- `IF-REV-006`：账单核销与收费状态更新。
### 落地边界
- **已落地**：渠道下单、支付回调、账单核销主链路。
- **部分落地**：失败补偿策略部分由支付平台与人工复核协同处理。
- **文档先行**：复杂营销组合支付与分账能力暂不宣称为已实现。
## CS-004 电子发票服务（对齐 WECHAT-004）
### 功能说明
在客户渠道中提供电子发票申请、查询、下载以及缴费后发票推送能力。
### 关键设计
1. 电子发票开具能力经 `SYS-008` 统一提供。
2. 发票申请与客户开票信息、缴费记录和账单状态联动校验。
3. 发票结果支持下载、查看和渠道推送。
### 核心数据
- `biz_invoice`
- `biz_cust_invoice`
- `biz_invoice_taxrate`
### 接口映射
- `IF-CS-004`：客户侧发票申请与状态查询。
- `IF-EXT-006`、`IF-EXT-007`：发票开具协同与结果回写。
- `IF-REV-008`：营收侧发票主流程协同。
### 落地边界
- **已落地**：发票申请、开票信息校验、开票结果回写。
- **部分落地**：红冲、补开等复杂票据后处理以发票服务能力为主。
- **文档先行**：多税率拆票、批量异步重试等高级策略仅保留设计语义。
## CS-005 营业网点服务（对齐 WECHAT-005）
### 功能说明
提供营业网点查询、服务范围查看、办事指引与营业时间展示能力。
### 关键设计
1. 网点信息展示地址、联系电话、营业时间与可办理业务范围。
2. 网点服务以查询与引导为主，不在本模块中虚构额外业务实体表。
3. 与 CS-006 业务办理服务协同，支持从网点查询跳转到线上办理。
### 核心数据
- `biz_outlets`
- `biz_business_types`
### 接口映射
- `IF-CS-005`：网点信息、可办事项、预约入口查询。
### 落地边界
- **已落地**：网点查询与办事引导能力。
- **部分落地**：预约排队等能力可能由外部排队系统承载。
- **文档先行**：导航路线规划与实时客流预测仅保留扩展方向。
## CS-006 业务办理服务（对齐 WECHAT-006）
### 功能说明
提供更名、过户、联系方式变更、开票方式变更、一户多人口、自主抄表、换表申请等线上业务办理入口。
### 关键设计
1. 业务办理统一调用工单/流程能力，不与后台流程表重复建模。
2. 办理结果与客户资料、工单状态、报装或表务流程联动更新。
3. 触达通知通过 `SYS-010` 完成结果通知。
### 核心数据
- `biz_process`
- `biz_process_transfer`
- `biz_content_attach`
### 接口映射
- `IF-CS-006`：办理申请提交、进度查询、补件上传。
- `IF-EXT-008`：办理结果通知协同。
### 落地边界
- **已落地**：办理申请、进度查询、补件与状态联动。
- **部分落地**：复杂跨部门并行审批流程依赖后端流程引擎配置。
- **文档先行**：智能预审与自动分单规则暂不表述为已实现能力。
## CS-007 柜面扫码支付
### 功能说明
支持营业厅柜台二维码收款、票据关联、结果回传，是柜台收费场景对线上支付能力的补充入口。
### 业务流程
```mermaid
flowchart TD
A[柜面发起扫码收款] --> B[生成支付订单]
B --> C[客户扫码支付]
C --> D[接收支付结果回写]
D --> E[更新账单核销状态]
E --> F[打印或展示收费凭证]
```
### 关键设计
1. 柜面扫码支付与 REV-003 营业收费统一核销口径。
2. 支付结果与交易流水经 `SYS-009` 回传后更新收费状态。
3. 支持支付凭证、发票申请与收费记录联动。
### 核心数据
- `biz_charge`
- `bk_transaction`
- `bk_transaction_callback`
### 接口映射
- `IF-CS-007`：柜面扫码支付订单创建与结果回写。
- `IF-EXT-004`、`IF-EXT-005`：支付渠道协同。
- `IF-REV-006`：收费核销与账单状态更新。
### 落地边界
- **已落地**：柜面扫码收款、支付回写、账单核销协同。
- **部分落地**：柜台班结与对账汇总由营收后台统一统计。
- **文档先行**：多终端并发收款冲突治理保留为后续优化方向。