tangweijie/fujian_water_biz_doc
1
0
Fork 0
Code Issues Pull Requests 12 Actions Packages Projects Releases 1 Wiki Activity
fujian_water_biz_doc/output/13_CS_Detailed_processed.md

12 KiB
Raw Blame History

title, author, date, documentclass, geometry, fontsize, mainfont, CJKmainfont
title author date documentclass geometry fontsize mainfont CJKmainfont
13_CS_Detailed 系统设计团队 2024年12月19日 article margin=1in 11pt PingFang SC 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

福建水务营收系统详细设计-客户服务模块正文

章节导航（精简）

文档定位

本文档为 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）

功能说明

提供微信支付、支付宝支付、银行卡支付、预存款支付等在线缴费能力。

业务流程

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 柜面扫码支付

功能说明

支持营业厅柜台二维码收款、票据关联、结果回传，是柜台收费场景对线上支付能力的补充入口。

业务流程

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：收费核销与账单状态更新。

落地边界

  • 已落地：柜面扫码收款、支付回写、账单核销协同。
  • 部分落地：柜台班结与对账汇总由营收后台统一统计。
  • 文档先行：多终端并发收款冲突治理保留为后续优化方向。