2024年12月19日
本文档为 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 |
当前并入账户绑定与账户切换能力 |
SYS-002 统一落账与回写。SYS-009、SYS-008、SYS-010
协同完成，客户服务模块不直接承载外部平台业务规则。说明：详细接口字段与报文以
../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 |
面向微信、支付宝、微网厅等渠道实现客户账户绑定、解绑、默认账户设置、多账户切换与身份校验。
biz_cust_app_bindsbiz_custbiz_accountIF-CS-001：渠道账户绑定、解绑、默认账户切换。IF-REV-001：客户与账户信息查询，校验绑定对象合法性。提供账单查询、缴费记录查询、用水分析、欠费查询、账户流水、历史账单等服务。
biz_custbiz_accountbiz_chargebiz_charge_detailbiz_invoiceIF-CS-002：账单、欠费、缴费、用水、发票等聚合查询。IF-REV-001：客户基础信息查询与状态校验。IF-REV-010：统计类查询场景复用营收统计接口能力。提供微信支付、支付宝支付、银行卡支付、预存款支付等在线缴费能力。
flowchart TD
A[提交缴费请求] --> B[校验账单与应缴金额]
B --> C[创建业务订单]
C --> D[调用SYS-009下单]
D --> E[接收支付回调/查询结果]
E --> F[更新核销状态]
F --> G[返回缴费结果]
SYS-009 回调/查询确认为准。biz_chargebiz_charge_detailbk_transactionbk_transaction_callbackIF-CS-003：客户渠道支付下单入口。IF-EXT-004、IF-EXT-005：支付下单协同与结果回写。IF-REV-006：账单核销与收费状态更新。在客户渠道中提供电子发票申请、查询、下载以及缴费后发票推送能力。
SYS-008 统一提供。biz_invoicebiz_cust_invoicebiz_invoice_taxrateIF-CS-004：客户侧发票申请与状态查询。IF-EXT-006、IF-EXT-007：发票开具协同与结果回写。IF-REV-008：营收侧发票主流程协同。提供营业网点查询、服务范围查看、办事指引与营业时间展示能力。
biz_outletsbiz_business_typesIF-CS-005：网点信息、可办事项、预约入口查询。提供更名、过户、联系方式变更、开票方式变更、一户多人口、自主抄表、换表申请等线上业务办理入口。
SYS-010 完成结果通知。biz_processbiz_process_transferbiz_content_attachIF-CS-006：办理申请提交、进度查询、补件上传。IF-EXT-008：办理结果通知协同。支持营业厅柜台二维码收款、票据关联、结果回传，是柜台收费场景对线上支付能力的补充入口。
flowchart TD
A[柜面发起扫码收款] --> B[生成支付订单]
B --> C[客户扫码支付]
C --> D[接收支付结果回写]
D --> E[更新账单核销状态]
E --> F[打印或展示收费凭证]
SYS-009 回传后更新收费状态。biz_chargebk_transactionbk_transaction_callbackIF-CS-007：柜面扫码支付订单创建与结果回写。IF-EXT-004、IF-EXT-005：支付渠道协同。IF-REV-006：收费核销与账单状态更新。