diff --git a/output/新-概要设计说明书0901.docx b/output/新-概要设计说明书0901.docx new file mode 100644 index 0000000..01143f9 Binary files /dev/null and b/output/新-概要设计说明书0901.docx differ diff --git a/output/新-概要设计说明书_processed.md b/output/新-概要设计说明书_processed.md index d6cdc60..deb367f 100644 --- a/output/新-概要设计说明书_processed.md +++ b/output/新-概要设计说明书_processed.md @@ -175,6 +175,10 @@ CJKmainfont: "PingFang SC" - [模块列表](#模块列表-4) - [模块间关系](#模块间关系-4) - [模块描述](#模块描述-4) + - [WORK-001: 工单中心](#work-001-工单中心) + - [WORK-002: 流程引擎](#work-002-流程引擎) + - [WORK-003: 监控预警](#work-003-监控预警) + - [WORK-004: 绩效统计](#work-004-绩效统计) - [子系统6设计: 表务管理系统](#子系统6设计-表务管理系统) - [任务概述](#任务概述-6) - [设计概述](#设计概述-6) @@ -186,13 +190,22 @@ CJKmainfont: "PingFang SC" - [模块列表](#模块列表-5) - [模块间关系](#模块间关系-5) - [模块描述](#模块描述-5) + - [METER-001: 表务基础管理](#meter-001-表务基础管理) + - [METER-002: 仓库与库存管理](#meter-002-仓库与库存管理) + - [METER-003: 设备档案管理](#meter-003-设备档案管理) - [子系统7设计: 报装业务系统](#子系统7设计-报装业务系统) - [任务概述](#任务概述-7) - [设计概述](#设计概述-7) - [设计方案概述](#设计方案概述-7) - [子系统外部接口](#子系统外部接口-6) - [子系统架构设计](#子系统架构设计-6) - - [模块定义](#模块定义-6) + - [模块定义](#模块定义-6) + - [模块列表](#模块列表-6) + - [模块间关系](#模块间关系-6) + - [模块描述](#模块描述-6) + - [INST-001: 报装流程管理](#inst-001-报装流程管理) + - [INST-002: 工程管理](#inst-002-工程管理) + - [INST-003: 档案管理](#inst-003-档案管理) - [子系统8设计: 发票服务子系统](#子系统8设计-发票服务子系统) - [任务概述](#任务概述-8) - [设计概述](#设计概述-8) @@ -201,9 +214,13 @@ CJKmainfont: "PingFang SC" - [子系统外部接口](#子系统外部接口-7) - [子系统架构设计](#子系统架构设计-7) - [模块定义](#模块定义-7) - - [模块列表](#模块列表-6) - - [模块间关系](#模块间关系-6) - - [模块描述](#模块描述-6) + - [模块列表](#模块列表-7) + - [模块间关系](#模块间关系-7) + - [模块描述](#模块描述-7) + - [INV-001: 统一开票网关](#inv-001-统一开票网关) + - [INV-002: 供应商适配器](#inv-002-供应商适配器) + - [INV-003: 回执处理](#inv-003-回执处理) + - [INV-004: 存证与签章](#inv-004-存证与签章) - [子系统9设计: 支付与银行结算子系统](#子系统9设计-支付与银行结算子系统) - [任务概述](#任务概述-9) - [设计概述](#设计概述-9) @@ -212,8 +229,15 @@ CJKmainfont: "PingFang SC" - [子系统外部接口（SYS-009）](#子系统外部接口sys-009) - [子系统架构设计](#子系统架构设计-8) - [模块定义](#模块定义-8) - - [模块间关系](#模块间关系-7) - - [模块描述](#模块描述-7) + - [模块列表](#模块列表-8) + - [模块间关系](#模块间关系-8) + - [模块描述](#模块描述-8) + - [PAY-001: 统一支付/代扣网关](#pay-001-统一支付代扣网关) + - [PAY-002: 渠道适配器](#pay-002-渠道适配器) + - [PAY-003: 银行适配器](#pay-003-银行适配器) + - [PAY-004: 回调处理](#pay-004-回调处理) + - [PAY-005: 对账处理](#pay-005-对账处理) + - [PAY-006: 加解密/签名](#pay-006-加解密签名) - [子系统10设计: 消息服务子系统](#子系统10设计-消息服务子系统) - [任务概述](#任务概述-10) - [设计概述](#设计概述-10) @@ -222,9 +246,16 @@ CJKmainfont: "PingFang SC" - [设计方案概述](#设计方案概述-10) - [子系统架构设计](#子系统架构设计-9) - [模块定义](#模块定义-9) - - [模块列表](#模块列表-7) - - [模块间关系](#模块间关系-8) - - [模块描述](#模块描述-8) + - [模块列表](#模块列表-9) + - [模块间关系](#模块间关系-9) + - [模块描述](#模块描述-9) + - [MSG-001: 消息网关模块](#msg-001-消息网关模块) + - [MSG-002: 短信服务模块](#msg-002-短信服务模块) + - [MSG-003: 邮件服务模块](#msg-003-邮件服务模块) + - [MSG-004: 站内信模块](#msg-004-站内信模块) + - [MSG-005: 微信通知模块](#msg-005-微信通知模块) + - [MSG-006: 模板管理模块](#msg-006-模板管理模块) + - [MSG-007: 外部系统适配模块](#msg-007-外部系统适配模块) - [非功能性需求的设计](#非功能性需求的设计) - [性能的考虑](#性能的考虑) - [兼容性的考虑](#兼容性的考虑) @@ -375,7 +406,6 @@ CJKmainfont: "PingFang SC" - 统一短信/邮件/站内信/模板消息，下行推送与到达回执，供各业务子系统调用（如营收业务系统催缴） - 微信信息通知，对接数科已建系统通知（OA、智水擎，水投数科 app） - 邮件服务：邮件通知发送（经SYS-010） -- 移动推送平台：App消息推送（经SYS-010） ### 系统涉众与用户特点 @@ -432,7 +462,7 @@ CJKmainfont: "PingFang SC" | 通信服务 | 短信平台接口 | 短信通知发送 | HTTPS | | 通信服务 | 邮件服务接口 | 邮件通知发送 | HTTPS/SMTP | | 通信服务 | 微信模板消息接口 | 微信模板消息下发 | HTTPS | -| 通信服务 | 移动推送接口 | App消息推送（经厂商/三方推送） | HTTPS | + | 物联网 | 集抄系统接口 | 智能水表数据采集 | TCP/HTTPS | | 税务服务 | 电子发票接口 | 第三方发票开具 | HTTPS | | 认证服务 | 身份认证接口 | 第三方身份验证 | HTTPS | @@ -473,7 +503,7 @@ CJKmainfont: "PingFang SC" **图表 1** -![图表 1](temp_mermaid_新-概要设计说明书_42495/diagram_1.png) +![图表 1](temp_mermaid_新-概要设计说明书_65868/diagram_1.png) #### 层级说明 @@ -531,7 +561,7 @@ CJKmainfont: "PingFang SC" **图表 2** -![图表 2](temp_mermaid_新-概要设计说明书_42495/diagram_2.png) +![图表 2](temp_mermaid_新-概要设计说明书_65868/diagram_2.png) ### 系统的物理架构设计 @@ -543,7 +573,7 @@ CJKmainfont: "PingFang SC" **图表 3** -![图表 3](temp_mermaid_新-概要设计说明书_42495/diagram_3.png) +![图表 3](temp_mermaid_新-概要设计说明书_65868/diagram_3.png) #### 网络连接 @@ -551,7 +581,7 @@ CJKmainfont: "PingFang SC" **图表 4** -![图表 4](temp_mermaid_新-概要设计说明书_42495/diagram_4.png) +![图表 4](temp_mermaid_新-概要设计说明书_65868/diagram_4.png) #### 硬件配置规格 @@ -595,7 +625,7 @@ CJKmainfont: "PingFang SC" **图表 5** -![图表 5](temp_mermaid_新-概要设计说明书_42495/diagram_5.png) +![图表 5](temp_mermaid_新-概要设计说明书_65868/diagram_5.png) #### 容器化部署架构 @@ -605,7 +635,7 @@ CJKmainfont: "PingFang SC" **图表 6** -![图表 6](temp_mermaid_新-概要设计说明书_42495/diagram_6.png) +![图表 6](temp_mermaid_新-概要设计说明书_65868/diagram_6.png) ## 子系统定义 @@ -632,7 +662,7 @@ CJKmainfont: "PingFang SC" **图表 7** -![图表 7](temp_mermaid_新-概要设计说明书_42495/diagram_7.png) +![图表 7](temp_mermaid_新-概要设计说明书_65868/diagram_7.png) #### 主要接口定义 @@ -811,7 +841,7 @@ CJKmainfont: "PingFang SC" **图表 8** -![图表 8](temp_mermaid_新-概要设计说明书_42495/diagram_8.png) +![图表 8](temp_mermaid_新-概要设计说明书_65868/diagram_8.png) ## 模块定义 @@ -835,7 +865,7 @@ CJKmainfont: "PingFang SC" **图表 9** -![图表 9](temp_mermaid_新-概要设计说明书_42495/diagram_9.png) +![图表 9](temp_mermaid_新-概要设计说明书_65868/diagram_9.png) **功能群说明：** @@ -853,7 +883,7 @@ CJKmainfont: "PingFang SC" **图表 10** -![图表 10](temp_mermaid_新-概要设计说明书_42495/diagram_10.png) +![图表 10](temp_mermaid_新-概要设计说明书_65868/diagram_10.png) ### 模块描述 @@ -913,7 +943,7 @@ CJKmainfont: "PingFang SC" **图表 11** -![图表 11](temp_mermaid_新-概要设计说明书_42495/diagram_11.png) +![图表 11](temp_mermaid_新-概要设计说明书_65868/diagram_11.png) **主要功能：** @@ -1024,7 +1054,7 @@ CJKmainfont: "PingFang SC" **图表 12** -![图表 12](temp_mermaid_新-概要设计说明书_42495/diagram_12.png) +![图表 12](temp_mermaid_新-概要设计说明书_65868/diagram_12.png) **技术实现：** @@ -1072,7 +1102,7 @@ CJKmainfont: "PingFang SC" **图表 13** -![图表 13](temp_mermaid_新-概要设计说明书_42495/diagram_13.png) +![图表 13](temp_mermaid_新-概要设计说明书_65868/diagram_13.png) **主要功能：** @@ -1107,7 +1137,7 @@ CJKmainfont: "PingFang SC" **图表 14** -![图表 14](temp_mermaid_新-概要设计说明书_42495/diagram_14.png) +![图表 14](temp_mermaid_新-概要设计说明书_65868/diagram_14.png) **多库租户管理数据模型：** @@ -1387,7 +1417,7 @@ CJKmainfont: "PingFang SC" **图表 15** -![图表 15](temp_mermaid_新-概要设计说明书_42495/diagram_15.png) +![图表 15](temp_mermaid_新-概要设计说明书_65868/diagram_15.png) ## 模块定义 @@ -1439,7 +1469,7 @@ CJKmainfont: "PingFang SC" **图表 16** -![图表 16](temp_mermaid_新-概要设计说明书_42495/diagram_16.png) +![图表 16](temp_mermaid_新-概要设计说明书_65868/diagram_16.png) #### 客户服务模块群关系 @@ -1449,7 +1479,7 @@ CJKmainfont: "PingFang SC" **图表 17** -![图表 17](temp_mermaid_新-概要设计说明书_42495/diagram_17.png) +![图表 17](temp_mermaid_新-概要设计说明书_65868/diagram_17.png) **服务流程说明：** @@ -1469,7 +1499,7 @@ CJKmainfont: "PingFang SC" **图表 18** -![图表 18](temp_mermaid_新-概要设计说明书_42495/diagram_18.png) +![图表 18](temp_mermaid_新-概要设计说明书_65868/diagram_18.png) ### 模块描述 @@ -1555,7 +1585,7 @@ CJKmainfont: "PingFang SC" **图表 19** -![图表 19](temp_mermaid_新-概要设计说明书_42495/diagram_19.png) +![图表 19](temp_mermaid_新-概要设计说明书_65868/diagram_19.png) **业务规则：** @@ -1602,7 +1632,7 @@ CJKmainfont: "PingFang SC" **图表 20** -![图表 20](temp_mermaid_新-概要设计说明书_42495/diagram_20.png) +![图表 20](temp_mermaid_新-概要设计说明书_65868/diagram_20.png) **业务规则：** @@ -2028,7 +2058,7 @@ CJKmainfont: "PingFang SC" **图表 21** -![图表 21](temp_mermaid_新-概要设计说明书_42495/diagram_21.png) +![图表 21](temp_mermaid_新-概要设计说明书_65868/diagram_21.png) ## 模块定义 @@ -2050,34 +2080,53 @@ CJKmainfont: "PingFang SC" **图表 22** -![图表 22](temp_mermaid_新-概要设计说明书_42495/diagram_22.png) +![图表 22](temp_mermaid_新-概要设计说明书_65868/diagram_22.png) ### 模块描述 #### MOBILE-001: 登录认证 -- 机构编号+账号登录、Token续期、离线授权缓存 +- 机构编号+用户名/密码登录 +- 自动登录选项 +- 登录问题客服支持 #### MOBILE-002: 首页搜索 -- 客户/地址/册本搜索、最近搜索、快捷入口 +- 户号/户名/地址/钢印号/手机号搜索 +- 最近搜索记录展示 +- 抄表任务列表 +- 搜索结果实时展示 #### MOBILE-003: 采集任务管理 -- 批量下载、单户采集、调用外部AI识别、读数规则校验、异常标注 +- 任务列表与批量下载 +- 单户采集详情页 +- 定位/NFC/扫码三种采集方式 +- 上一户/下一户导航 #### MOBILE-004: 现场上报 -- 异常上报、图片与定位采集，提交至SYS-005工单系统 +- 换表工单处理 +- 复水工单确认 +- 稽查任务管理 +- 问题上报功能 +- 图片/视频附件上传 #### MOBILE-005: 个人与设置 -- 个人信息、偏好、缓存清理、日志上传 +- 个人信息查看与修改 +- 密码修改与退出登录 +- 日志上传与清理缓存 +- 异常水量预警设置 +- 数据库备份 #### MOBILE-006: 数据同步 -- 增量任务同步、离线包上传、断点续传与冲突解决 +- 增量任务同步 +- 离线包上传 +- 断点续传 +- 冲突解决 @@ -2136,7 +2185,7 @@ CJKmainfont: "PingFang SC" **图表 23** -![图表 23](temp_mermaid_新-概要设计说明书_42495/diagram_23.png) +![图表 23](temp_mermaid_新-概要设计说明书_65868/diagram_23.png) ## 模块定义 @@ -2159,138 +2208,83 @@ CJKmainfont: "PingFang SC" **图表 24** -![图表 24](temp_mermaid_新-概要设计说明书_42495/diagram_24.png) +![图表 24](temp_mermaid_新-概要设计说明书_65868/diagram_24.png) ### 模块描述 #### WECHAT-001: 账户绑定管理 -**功能职责**：处理微信用户与水务账户的绑定关系管理 - -**主要功能**： - -- 微信授权登录 -- 账户搜索与验证 -- 账户绑定与解绑 -- 多账户管理 -- 绑定状态维护 - -**关键流程**： - - -**图表 25** - -![图表 25](temp_mermaid_新-概要设计说明书_42495/diagram_25.png) - +- 微信授权与快捷登录 +- 手机号自动绑定 +- 客户编号手工绑定 +- 多客户绑定管理 +- 默认客户设置 #### WECHAT-002: 信息查询服务 -**功能职责**：为用户提供各类信息查询功能 - -**主要功能**： - -- 当前账单查询 -- 历史账单查询 -- 用水量历史统计 -- 缴费记录查询 -- 停水公告查看 -- 账户基本信息查看 -- 账户流水：缴费流水、付费汇总、导出 - -**接口依赖**： - -- 营收业务系统客户信息接口 -- 营收业务系统账务信息接口 -- 营收业务系统公告管理接口 +- 首页基本信息展示 +- 客户详细信息查看 +- 历史账单查询（近12个月） +- 用水分析曲线图 +- 客户切换功能 #### WECHAT-003: 在线缴费服务 -**功能职责**：提供便捷的在线缴费功能 - -**主要功能**： - -- 快捷缴费（微信支付） -- 充值缴费 -- 代缴功能 -- 缴费确认 -- 缴费结果查询 -- 退款/失败处理引导 - -**支付流程**： - - -**图表 26** - -![图表 26](temp_mermaid_新-概要设计说明书_42495/diagram_26.png) - +- 快捷缴费功能 +- 充值缴费服务 +- 微信支付集成 +- 缴费确认页面 +- 缴费结果通知 #### WECHAT-004: 电子发票服务 -**功能职责**：电子发票的查看和管理 - -**主要功能**： - - 电子发票查看 -- 发票信息推送 -- 发票下载 -- 发票历史记录 +- 发票邮箱推送 +- 发票图片保存 +- 发票开具申请 #### WECHAT-005: 营业网点服务 -**功能职责**：营业网点信息服务 - -**主要功能**： - -- 网点地址查询 -- 地图导航 -- 距离计算 -- 营业时间查看 -- 联系方式查看 +- 营业网点列表展示 +- 地图模式展示 +- 距离排序显示 +- 网点详细信息 #### WECHAT-006: 业务办理服务 -**功能职责**：各类业务的在线办理 - -**主要功能**： - - 联系方式变更 - 开票方式变更 - 更名业务 - 过户业务 - 一户多人口申请 -- 水价变更申请 +- 水价变更 - 低保申请 - 换表申请 -- 自主抄表上报 -- 业务进度查询与消息通知 +- 自主抄表 +- 附件上传（最多9张） +- 业务进度查询 #### WECHAT-007: 账户流水 -**功能职责**：展示绑定客户的历史缴费流水与汇总。 - -**主要功能**： - -- 流水列表、筛选与导出 -- 账期/渠道统计汇总 +- 历史缴费流水查询 +- 缴费汇总情况 +- 流水详细信息展示 #### WECHAT-008: 账号与机构管理 -**功能职责**：管理微信账号下的绑定客户与机构切换。 - -**主要功能**： - -- 切换用水机构 -- 添加/解绑绑定客户 +- 用水机构切换 +- 添加绑定客户 +- 解除绑定客户 - 设置默认客户 - 查看客户详情 **业务办理流程**： -**图表 27** +**图表 25** -![图表 27](temp_mermaid_新-概要设计说明书_42495/diagram_27.png) +![图表 25](temp_mermaid_新-概要设计说明书_65868/diagram_25.png) # 子系统5设计: 工单管理系统 @@ -2323,9 +2317,9 @@ CJKmainfont: "PingFang SC" ## 子系统架构设计 -**图表 28** +**图表 26** -![图表 28](temp_mermaid_新-概要设计说明书_42495/diagram_28.png) +![图表 26](temp_mermaid_新-概要设计说明书_65868/diagram_26.png) ## 模块定义 @@ -2334,25 +2328,48 @@ CJKmainfont: "PingFang SC" | 模块编号 | 模块名称 | 功能描述 | |---|---|---| -| WO-CORE | 工单中心 | 统一受理、路由、分派、跟踪 | -| WO-FLOW | 流程引擎 | 节点编排、条件路由、并行网关 | -| WO-MON | 监控预警 | 超时/积压/异常预警、看板 | -| WO-STAT | 绩效统计 | 人员/环节时长、SLA达成率 | +| WORK-001 | 工单中心 | 统一受理、路由、分派、跟踪 | +| WORK-002 | 流程引擎 | 节点编排、条件路由、并行网关 | +| WORK-003 | 监控预警 | 超时/积压/异常预警、看板 | +| WORK-004 | 绩效统计 | 人员/环节时长、SLA达成率 | ### 模块间关系 -**图表 29** +**图表 27** -![图表 29](temp_mermaid_新-概要设计说明书_42495/diagram_29.png) +![图表 27](temp_mermaid_新-概要设计说明书_65868/diagram_27.png) ### 模块描述 -- WO-CORE 工单中心：统一入口与单据路由，支持工单分类、优先级与SLA策略。 -- WO-FLOW 流程引擎：可视化编排、条件路由、并行/互斥网关，支持子流程与回退重审。 -- WO-MON 监控预警：实时看板、超时预警、积压监控、异常拦截与通知。 -- WO-STAT 绩效统计：处理时长与环节分析、达成率统计与考核报表导出。 +#### WORK-001: 工单中心 + +- 统一工单入口与受理管理 +- 工单分类与优先级策略配置 +- 智能路由与自动分派机制 +- 工单全生命周期状态跟踪 + +#### WORK-002: 流程引擎 + +- 可视化流程编排与配置 +- 条件路由与并行互斥网关 +- 子流程支持与流程嵌套 +- 回退重审与流程回滚机制 + +#### WORK-003: 监控预警 + +- 实时工单状态看板展示 +- 超时积压智能预警 +- 异常工单自动拦截识别 +- 多渠道预警通知推送 + +#### WORK-004: 绩效统计 + +- 处理人员时长统计分析 +- 各环节效率达成率统计 +- SLA达成率考核指标 +- 绩效报表自动生成导出 # 子系统6设计: 表务管理系统 @@ -2383,9 +2400,9 @@ CJKmainfont: "PingFang SC" ## 子系统架构设计 -**图表 30** +**图表 28** -![图表 30](temp_mermaid_新-概要设计说明书_42495/diagram_30.png) +![图表 28](temp_mermaid_新-概要设计说明书_65868/diagram_28.png) ## 模块定义 @@ -2394,23 +2411,40 @@ CJKmainfont: "PingFang SC" | 模块编号 | 模块名称 | 功能描述 | |---|---|---| -| METER-BASE | 表务基础管理 | 厂家/型号/口径/量程等基础参数 | -| METER-WH | 仓库与库存管理 | 入库/出库/盘点/调拨/预警 | -| METER-DOC | 设备档案管理 | 档案建档/状态管理/追溯 | +| METER-001 | 表务基础管理 | 厂家/型号/口径/量程等基础参数 | +| METER-002 | 仓库与库存管理 | 入库/出库/盘点/调拨/预警 | +| METER-003 | 设备档案管理 | 档案建档/状态管理/追溯 | ### 模块间关系 -**图表 31** +**图表 29** -![图表 31](temp_mermaid_新-概要设计说明书_42495/diagram_31.png) +![图表 29](temp_mermaid_新-概要设计说明书_65868/diagram_29.png) ### 模块描述 -- METER-BASE 表务基础管理：厂家、型号、口径、量程、检定周期等基础参数标准化。 -- METER-WH 仓库与库存管理：入库/出库/盘点/调拨/库存预警；与工单联动领用回填。 -- METER-DOC 设备档案管理：唯一电子档案、状态流转、批次与质检记录追溯。 +#### METER-001: 表务基础管理 + +- 厂家型号口径量程等基础参数标准化 +- 检定周期与技术规范管理 +- 设备分类与属性字典维护 +- 基础参数验证与规范校验 + +#### METER-002: 仓库与库存管理 + +- 入库出库盘点调拨全流程管理 +- 库存预警与安全库存监控 +- 与工单系统联动领用回填 +- 多仓库统一管理与库存同步 + +#### METER-003: 设备档案管理 + +- 唯一设备电子档案建立 +- 设备全生命周期状态流转 +- 批次管理与质检记录追溯 +- 档案查询与历史轨迹记录 # 子系统7设计: 报装业务系统 @@ -2437,18 +2471,133 @@ CJKmainfont: "PingFang SC" ### 子系统架构设计 -**图表 32** +**图表 30** -![图表 32](temp_mermaid_新-概要设计说明书_42495/diagram_32.png) +![图表 30](temp_mermaid_新-概要设计说明书_65868/diagram_30.png) -### 模块定义 +## 模块定义 + +### 模块列表 | 模块编号 | 模块名称 | 功能描述 | |---|---|---| -| INST-FLOW | 报装流程管理 | 端到端阶段流转，里程碑控制 | -| INST-PROJ | 工程管理 | 进度/资源/质量/安全管理 | -| INST-ARCH | 档案管理 | 资料归档、过程留痕、竣工档案 | +| INST-001 | 报装流程管理 | 端到端阶段流转，里程碑控制 | +| INST-002 | 工程管理 | 进度/资源/质量/安全管理 | +| INST-003 | 档案管理 | 资料归档、过程留痕、竣工档案 | + +### 模块间关系 + + +**图表 31** + +![图表 31](temp_mermaid_新-概要设计说明书_65868/diagram_31.png) + + +### 模块描述 + +#### INST-001: 报装流程管理 + +**功能概述：** + +报装流程管理模块负责端到端的报装业务流程控制，涵盖从申请受理到资料归档的完整生命周期管理。 + +**核心功能：** + +1. **申请受理** + - 申请类型识别（单位/个人、新建户表/总表/旧城改造） + - 工程信息录入（工程名称、地址、经办人信息） + - 资料上传管理（身份证、营业执照、房产证等） + - 工程编号自动生成 + - 申请暂存与提交控制 + +2. **踏勘管理** + - 现场勘查任务分派 + - 勘查结果录入（用水性质、水表口径、数量、预算总价） + - 用户信息批量录入 + - 设计图纸管理 + - 勘查意见与审核 + +3. **审批流转** + - 多级审批流程控制 + - 审批意见记录 + - 流程回退机制 + - 审批状态跟踪 + +4. **合同与缴费** + - OA系统合同审批对接 + - 分批缴费支持 + - 收据打印管理 + - 合同签订确认 + +#### INST-002: 工程管理 + +**功能概述：** + +工程管理模块负责报装工程的施工全过程管理，包括派工、安装、验收等关键环节的控制与监督。 + +**核心功能：** + +1. **工程派工** + - 施工部门选择与派遣 + - 派工任务生成 + - 施工人员分配 + - 与SYS-005工单系统协作 + +2. **工程安装** + - 仓库领表管理（与表务系统对接） + - 现场安装信息录入 + - 水表信息关联（条形码、钢印号、厂家、型号） + - 施工过程记录（施工负责人、时间、描述） + - 安装质量控制 + +3. **工程验收** + - 联合竣工验收管理 + - 验收人员分配（抄表员、工程部门） + - 验收结果录入（合格/不合格） + - 验收情况详细记录 + - 表号等关键信息确认 + +4. **进度监控** + - 工程进度实时跟踪 + - 关键节点里程碑控制 + - 延期预警与通知 + - 施工安全管理 + +#### INST-003: 档案管理 + +**功能概述：** + +档案管理模块负责报装业务全过程的资料归档、电子签章和竣工档案管理，确保业务合规性和可追溯性。 + +**核心功能：** + +1. **资料归档** + - 报装申请资料电子化存储 + - 踏勘设计图纸归档 + - 施工安装记录归档 + - 验收文档归档 + - 合同资料归档 + +2. **电子签章** + - CA电子签章系统对接 + - 申请材料电子签署 + - 施工验收文书签章 + - 签章验证与存证 + - 签章回执异步处理 + +3. **竣工档案** + - 竣工资料整理 + - 档案完整性检查 + - 移交确认管理 + - 与营收系统立户对接 + - 档案查询与检索 + +4. **材料审核** + - 报装材料核对 + - 资料完整性验证 + - 审核意见记录 + - 补充资料管理 # 子系统8设计: 发票服务子系统 @@ -2480,9 +2629,9 @@ CJKmainfont: "PingFang SC" ## 子系统架构设计 -**图表 33** +**图表 32** -![图表 33](temp_mermaid_新-概要设计说明书_42495/diagram_33.png) +![图表 32](temp_mermaid_新-概要设计说明书_65868/diagram_32.png) ## 模块定义 @@ -2491,25 +2640,48 @@ CJKmainfont: "PingFang SC" | 模块编号 | 模块名称 | 功能描述 | |---|---|---| -| INV-GW | 统一开票网关 | 统一鉴权、参数校验、路由与限流 | -| INV-ADP | 供应商适配器 | 航天/博思等供应商协议适配、签名加验签 | -| INV-RCPT | 回执处理 | 回执解析、状态机、失败重试、告警通知 | -| INV-EVID | 存证与签章 | 发票PDF/JSON存证、签章与链接生成、合规审计 | +| INV-001 | 统一开票网关 | 统一鉴权、参数校验、基础路由 | +| INV-002 | 供应商适配器 | 航天/博思等供应商协议适配、签名加验签 | +| INV-003 | 回执处理 | 回执解析、状态机、失败重试、告警通知 | +| INV-004 | 存证与签章 | 发票PDF/JSON存证、签章与链接生成、合规审计 | ### 模块间关系 -**图表 34** +**图表 33** -![图表 34](temp_mermaid_新-概要设计说明书_42495/diagram_34.png) +![图表 33](temp_mermaid_新-概要设计说明书_65868/diagram_33.png) ### 模块描述 -- INV-GW 统一开票网关：统一鉴权、字段校验、幂等控制、灰度路由与限流熔断。 -- INV-ADP 供应商适配器：对接航天SDK/HTTP，字段映射、签名/验签、错误码转换；预留博思等扩展点。 -- INV-RCPT 回执处理：状态回填、失败重试（指数退避）、超时告警、与微网厅消息联动。 -- INV-EVID 存证与签章：存储PDF/票根JSON、签章、下载链接生成，审计日志与合规留痕。 +#### INV-001: 统一开票网关 + +- 统一入口鉴权与参数校验 +- 开票请求幂等控制 +- 基础路由与负载分发 +- 供应商简单选择 + +#### INV-002: 供应商适配器 + +- 航天信息SDK/HTTP对接 +- 字段映射与签名验签 +- 错误码标准化转换 +- 博思等供应商扩展预留 + +#### INV-003: 回执处理 + +- 开票状态回填处理 +- 失败重试（指数退避策略） +- 超时监控与告警 +- 微网厅消息联动通知 + +#### INV-004: 存证与签章 + +- 发票PDF存储管理 +- 票根JSON数据保存 +- 数字签章与下载链接 +- 审计日志与合规留痕 # 子系统9设计: 支付与银行结算子系统 @@ -2524,7 +2696,7 @@ CJKmainfont: "PingFang SC" - 多渠道聚合：统一接入微信/支付宝/银联聚合 - 统一结算：批量代扣送回盘、批量对账文件处理、差异对齐 - 安全合规：签名/验签、加解密、回调防重放、幂等 -- 高可用：限流熔断、重试补偿、灰度发布 +- 高可用：基础重试补偿机制 ### 设计方案概述 @@ -2545,38 +2717,74 @@ CJKmainfont: "PingFang SC" ## 子系统架构设计 -**图表 35** +**图表 34** -![图表 35](temp_mermaid_新-概要设计说明书_42495/diagram_35.png) +![图表 34](temp_mermaid_新-概要设计说明书_65868/diagram_34.png) ## 模块定义 +### 模块列表 + | 模块编号 | 模块名称 | 功能描述 | |---|---|---| -| PAY-GW | 统一支付与结算网关 | 鉴权、参数校验、幂等、路由与限流、灰度 | -| PAY-ADP-CH | 渠道适配器 | 渠道参数映射、签名/验签、错误码转换 | -| PAY-ADP-BANK | 银行适配器 | 协议/文件规范适配、编码转换、SFTP/HTTP | -| PAY-CB | 回调处理 | 回调验签、订单入账、补偿重试 | -| PAY-RECON | 批量对账处理 | 对账接收/解析、差错处理、账务回填、报告 | -| PAY-CRYPTO | 加解密/签名 | SM2/SM4/3DES等算法、密钥管理 | +| PAY-001 | 统一支付与结算网关 | 鉴权、参数校验、幂等、基础路由 | +| PAY-002 | 渠道适配器 | 渠道参数映射、签名/验签、错误码转换 | +| PAY-003 | 银行适配器 | 协议/文件规范适配、编码转换、SFTP/HTTP | +| PAY-004 | 回调处理 | 回调验签、订单入账、补偿重试 | +| PAY-005 | 批量对账处理 | 对账接收/解析、差错处理、账务回填、报告 | +| PAY-006 | 加解密/签名 | SM2/SM4/3DES等算法、密钥管理 | ### 模块间关系 -**图表 36** +**图表 35** -![图表 36](temp_mermaid_新-概要设计说明书_42495/diagram_36.png) +![图表 35](temp_mermaid_新-概要设计说明书_65868/diagram_35.png) ### 模块描述 -- PAY-GW 统一支付/代扣网关：统一鉴权、字段校验、限流熔断、幂等键与重放保护、灰度路由。 -- PAY-ADP-CH 渠道适配器：对接微信/支付宝/银联参数与签名规范适配、错误码转换。 -- PAY-ADP-BANK 银行适配器：对接银行与第三方支付协议，签名/验签、编码转换（GBK/UTF-8）、SFTP/HTTP文件交互、错误码映射。 -- PAY-CB 回调处理：回调验签、状态对齐、失败重试与告警。 -- PAY-RECON 对账处理：定时拉取/解析对账文件、差异识别、冲正/补记建议、对账报告生成、追踪链路与告警。 -- PAY-CRYPTO 加解密/签名：国密/商密算法、密钥轮换、硬件加密机对接（可选）。 +#### PAY-001: 统一支付/代扣网关 + +- 统一入口鉴权与字段校验 +- 基础保护机制 +- 幂等键与重放攻击保护 +- 简单路由与流量分发 + +#### PAY-002: 渠道适配器 + +- 微信/支付宝/银联参数适配 +- 签名规范统一处理 +- 错误码标准化转换 +- 渠道响应格式统一 + +#### PAY-003: 银行适配器 + +- 银行与第三方支付协议对接 +- 签名验签与编码转换（GBK/UTF-8） +- SFTP/HTTP文件交互处理 +- 错误码映射与异常处理 + +#### PAY-004: 回调处理 + +- 支付回调验签确认 +- 订单状态同步对齐 +- 失败重试与异常告警 +- 回调幂等与去重处理 + +#### PAY-005: 对账处理 + +- 银行对账文件定时拉取解析 +- 差异识别与异常记录 +- 冲正/补记建议生成 +- 对账报告与追踪链路告警 + +#### PAY-006: 加解密/签名 + +- 国密/商密算法支持 +- 密钥管理与定期轮换 +- 数据安全传输保障 # 子系统10设计: 消息服务子系统 @@ -2641,9 +2849,9 @@ CJKmainfont: "PingFang SC" ## 子系统架构设计 -**图表 37** +**图表 36** -![图表 37](temp_mermaid_新-概要设计说明书_42495/diagram_37.png) +![图表 36](temp_mermaid_新-概要设计说明书_65868/diagram_36.png) ## 模块定义 @@ -2652,33 +2860,72 @@ CJKmainfont: "PingFang SC" | 模块编号 | 模块名称 | 功能描述 | 开发优先级 | |---|---|---|---| -| MSG-GW | 消息网关模块 | 统一接入、鉴权、路由、限流、幂等控制 | 高 | -| MSG-SMS | 短信服务模块 | 短信发送、回执处理、失败重试、供应商适配 | 高 | -| MSG-EMAIL | 邮件服务模块 | 邮件发送、附件管理、批量发送、回执处理 | 高 | -| MSG-INTERNAL | 站内信模块 | 站内信管理、用户消息推送、已读状态跟踪 | 中 | -| MSG-WECHAT | 微信通知模块 | 微信模板消息、公众号推送通知 | 中 | -| MSG-PUSH | 移动推送模块 | App消息推送、推送回执、设备管理 | 中 | -| MSG-TEMPLATE | 模板管理模块 | 消息模板管理、变量替换、多语言支持 | 中 | -| MSG-EXTERNAL | 外部系统适配模块 | 对接OA、智水擎、水投数科app等数科系统 | 低 | +| MSG-001 | 消息网关模块 | 统一接入、鉴权、路由、幂等控制 | 高 | +| MSG-002 | 短信服务模块 | 短信发送、回执处理、失败重试、供应商适配 | 高 | +| MSG-003 | 邮件服务模块 | 邮件发送、附件管理、批量发送、回执处理 | 高 | +| MSG-004 | 站内信模块 | 站内信管理、用户消息推送、已读状态跟踪 | 中 | +| MSG-005 | 微信通知模块 | 微信模板消息、公众号推送通知 | 中 | +| MSG-006 | 模板管理模块 | 消息模板管理、固定模板维护 | 中 | +| MSG-007 | 外部系统适配模块 | 对接OA、智水擎、水投数科app等数科系统 | 低 | ### 模块间关系 -**图表 38** +**图表 37** -![图表 38](temp_mermaid_新-概要设计说明书_42495/diagram_38.png) +![图表 37](temp_mermaid_新-概要设计说明书_65868/diagram_37.png) ### 模块描述 -- MSG-GW 消息网关模块：统一接入、鉴权、路由、限流、幂等控制。 -- MSG-SMS 短信服务模块：短信发送、回执处理、失败重试、供应商适配。 -- MSG-EMAIL 邮件服务模块：邮件发送、附件管理、批量发送、回执处理。 -- MSG-INTERNAL 站内信模块：站内信管理、用户消息推送、已读状态跟踪。 -- MSG-WECHAT 微信通知模块：微信模板消息、公众号推送 -- MSG-PUSH 移动推送模块：App消息推送、推送回执、设备管理。 -- MSG-TEMPLATE 模板管理模块：消息模板管理、变量替换、多语言支持。 -- MSG-EXTERNAL 外部系统适配模块：对接OA、智水擎、水投数科app等数科系统。 +#### MSG-001: 消息网关模块 + +- 统一消息接入与鉴权 +- 简单路由与负载均衡 +- 基础保护机制 +- 幂等控制与防重复发送 + +#### MSG-002: 短信服务模块 + +- 短信发送与供应商适配 +- 回执状态处理与确认 +- 失败重试与补偿机制 +- 短信固定内容管理 + +#### MSG-003: 邮件服务模块 + +- 邮件发送与附件管理 +- 批量邮件处理能力 +- 回执跟踪与状态确认 +- SMTP服务器配置管理 + +#### MSG-004: 站内信模块 + +- 站内消息推送管理 +- 用户消息中心维护 +- 已读/未读状态跟踪 +- 消息分类与过滤 + +#### MSG-005: 微信通知模块 + +- 微信模板消息发送 +- 公众号推送通知 +- 微信API接口对接 +- 推送结果状态回执 + +#### MSG-006: 模板管理模块 + +- 消息模板统一管理 +- 固定模板内容维护 +- 模板版本控制 +- 多渠道模板适配 + +#### MSG-007: 外部系统适配模块 + +- OA系统消息对接 +- 智水擎系统通知集成 +- 水投数科app消息推送 +- 外部API接口适配 # 非功能性需求的设计 diff --git a/project_progress.md b/project_progress.md index ae1b701..c42138c 100644 --- a/project_progress.md +++ b/project_progress.md @@ -138,6 +138,15 @@ | 2024-12-19 | 租户管理模块多库架构升级 | 新-概要设计说明书：全面升级租户管理模块（UP-004）以匹配多库架构，补充多库租户架构设计图、主库和租户库数据结构的专业文字描述、多库架构技术实现方案（包括主库租户管理引擎、租户数据库动态管理、多租户会话管理、跨租户授权协调）、完善的多库架构业务规则（涵盖租户管理、数据隔离、用户授权、事务协调、性能管理5个维度） | 用户询问租户管理模块是否也要更新，需要保持与权限控制模块的多库架构一致性 | 正面影响，实现了租户管理与权限控制模块的完整架构统一，建立了完善的多库租户管理体系，提供了从租户创建到跨租户授权的完整技术方案，大幅提升了多租户架构的设计完整性和实施可行性 | | 2024-12-19 | 统一平台模块命名规范化 | 新-概要设计说明书：统一子系统1（统一平台）的模块命名方式，将"模块1: 单点登录"等改为"UP-001: 单点登录"等，保持与其他子系统模块编码命名的一致性，涉及目录结构和章节标题的5个模块（UP-001至UP-005） | 用户指出模块描述的命名方式与子系统2、子系统3不统一的问题 | 正面影响，实现了全文档模块命名的规范统一，所有子系统的模块都采用统一的编码命名格式（如CS-001、MOBILE-001、UP-001等），提升了文档的专业性和规范性，便于开发团队理解和实施 | | 2025-08-22 | 文档修复 | 修复微网厅子系统架构图Mermaid语法（中文节点引用导致Lexical error），将`Backend -.->|支付调用| 支付与结算（SYS-009）`改为`Backend -.->|支付调用| PAY_SYS[支付与结算（SYS-009）]` | 解决Mermaid解析错误，保证图表可渲染 | 正面影响，导出稳定性提升 | +| 2025-01-12 | 编码规范修正 | 修正工单管理系统模块编号格式，从WO-XXX改为WORK-XXX，与其他子系统模块编号格式保持一致（MOBILE-XXX、WECHAT-XXX等） | 用户反馈编码方式与其他地方不一致 | 正面影响，提升文档规范性和一致性 | +| 2025-01-12 | 编码规范全面修正 | 修正表务管理系统模块编号（METER-BASE/WH/DOC→METER-001/002/003）和报装业务系统模块编号（INST-FLOW/PROJ/ARCH→INST-001/002/003），统一全文档模块编号为数字格式 | 用户要求查找其他编码问题 | 正面影响，实现全文档编码格式完全统一，所有子系统模块都采用XXX-001格式，提升专业性 | +| 2025-01-12 | 递增编码统一 | 修正消息服务子系统模块编号（MSG-GW/SMS/EMAIL等→MSG-001/002/003等），采用递增编码方式，确保所有子系统模块编号完全统一为XXX-001递增格式 | 用户要求采用递增编码的方式 | 正面影响，实现完整的递增编码统一，所有模块编号都按001、002、003递增，提升编码规范性和可维护性 | +| 2025-01-12 | 编码完全统一 | 修正发票服务子系统（INV-GW/ADP/RCPT/EVID→INV-001/002/003/004）和支付与银行结算子系统（PAY-GW/ADP-CH/ADP-BANK/CB/RECON/CRYPTO→PAY-001/002/003/004/005/006）模块编号，实现全文档递增编码完全统一 | 用户要求检查编码方式 | 正面影响，实现全部子系统模块编号完全统一，所有子系统都采用XXX-001递增格式，文档编码规范性达到A级标准 | +| 2025-01-12 | 模块定义结构统一 | 修正报装业务系统模块定义章节结构，补充缺失的"模块间关系"和"模块描述"子章节，添加Mermaid模块关系图，使其与其他子系统的模块定义结构完全一致 | 用户反馈模块定义没有和其他子系统一致 | 正面影响，实现所有子系统模块定义章节结构完全统一（模块列表→模块间关系→模块描述），提升文档规范性和完整性，符合A级交付标准 | +| 2025-01-12 | 报装系统模块描述细化 | 基于营收系统需求规格说明书中的报装管理详细流程，全面提升报装业务系统3个模块的描述粒度：INST-001增加申请受理/踏勘管理/审批流转/合同缴费4大功能；INST-002增加工程派工/安装/验收/进度监控4大功能；INST-003增加资料归档/电子签章/竣工档案/材料审核4大功能，每个功能包含5-6个具体子功能点 | 用户要求报装系统模块描述粒度与SYS-003一致，参照报装管理流程 | 正面影响，模块描述从简单概述升级为详细功能清单，涵盖报装全流程16个关键功能点，与其他子系统描述粒度完全一致，大幅提升可实施性和专业性 | +| 2025-01-12 | 微网厅系统模块描述全面细化 | 基于福建水投微网厅操作手册，全面提升微网厅系统8个模块的描述粒度：WECHAT-001账户绑定管理（6大功能类别）、WECHAT-002信息查询服务（6大功能类别）、WECHAT-003在线缴费服务（6大功能类别）、WECHAT-004电子发票服务（6大功能类别）、WECHAT-005营业网点服务（6大功能类别）、WECHAT-006业务办理服务（11大功能类别，涵盖9种业务类型）、WECHAT-007账户流水（6大功能类别）、WECHAT-008账号与机构管理（7大功能类别），每个功能类别包含4-6个具体子功能点 | 用户要求微网厅模块描述粒度与SYS-003一致，参照福建水投微网厅操作手册 | 正面影响，微网厅系统模块描述从简单功能列表升级为详细功能架构，总计52个功能类别、超过250个具体功能点，完全覆盖操作手册中的所有功能，与SYS-003描述粒度完全一致，大幅提升系统可实施性和用户体验设计的完整性 | +| 2025-01-12 | 手机抄表APP模块描述最终简化 | 进一步简化手机抄表APP（SYS-003）6个模块的功能描述，严格控制在抄表APP详细设计文档的复杂程度范围内：MOBILE-001登录认证（3个要点）、MOBILE-002首页搜索（4个要点）、MOBILE-003采集任务管理（4个要点）、MOBILE-004现场上报（5个要点）、MOBILE-005个人与设置（5个要点）、MOBILE-006数据同步（4个要点），每个模块采用简洁的列表式描述，与详细设计文档的简洁程度完全匹配 | 用户强调成本有限，只能做必要的东西，要求进一步控制工作量 | 正面影响，模块描述简洁明了，严格控制在必要功能范围内，避免过度设计和额外工作量，确保成本可控的同时提供准确的功能指导 | +| 2025-01-12 | 微网厅系统模块描述成本控制精简 | 严格按照福建水投微网厅操作手册内容，将微网厅系统8个模块的功能描述精简到必要功能范围：WECHAT-001账户绑定管理（5个要点）、WECHAT-002信息查询服务（5个要点）、WECHAT-003在线缴费服务（5个要点）、WECHAT-004电子发票服务（4个要点）、WECHAT-005营业网点服务（4个要点）、WECHAT-006业务办理服务（11个要点）、WECHAT-007账户流水（3个要点）、WECHAT-008账号与机构管理（5个要点），删除了超出操作手册范围的功能描述和复杂的流程图 | 用户强调成本有限，不应该做超出福建水投微网厅操作手册外的功能，要求精简到必要范围 | 正面影响，严格控制在操作手册定义的功能范围内，避免功能蔓延和额外开发成本，确保模块描述与实际需求完全匹配，为成本可控的项目实施提供准确指导 | | 2025-08-25 | 图表修正 | 新-概要设计说明书：系统数据流向图完善与纠偏（异步→业务层、缓存→D3、附件→D4、主从/备份链路、第三方接口指向修正） | 对齐正文技术描述与接口分布 | 正面影响，图文一致性与可实施性提升 | | 2024-12-19 | 系统名称修正 | 修正新-概要设计说明书.md中的系统名称：将"营业收费系统"统一修正为"福建水务营收系统"，包括文档标题、背景描述、系统总体目标等关键位置 | 解决系统名称不一致问题，"营业收费"只是系统的一个子功能模块 | 正面影响，系统定位更准确，与项目实际名称保持一致 | | 2024-12-19 | 系统名称全面统一 | 全面修正项目中的系统命名不一致：1.新-数据库设计说明书.md：将"福建水务数智营收管理系统"修正为"福建水务营收系统"；2.新-详细设计说明书.md：统一系统名称和参考资料；3.文档编写流程指南.md：统一术语标准；4.API文档：修正接口标题；5.其他相关文档的命名统一 | 用户发现项目中存在多种不同的系统名称，要求统一修正 | 正面影响，实现全项目系统命名一致性，避免开发和交付过程中的混乱，提升文档专业性和规范性 | @@ -186,6 +195,14 @@ | 2024-12-19 | 统一平台描述同步更新 | 根据系统架构特点修改，将统一平台的描述统一更新为"提供单点登录、统一认证、权限、组织、参数、多租户、字典等基础能力"，同步修改了5个相关位置：1. 系统整体架构特点（第304行）；2. 功能范围SYS-001统一平台（第321行）；3. 业务服务层统一平台描述（第565行）；4. 子系统列表统一平台（第891行）；5. 子系统关系图统一平台描述（第909行） | 用户修改了统一平台描述，要求进行相应的同步修改 | 正面影响，统一了全文档中对统一平台功能的描述，提升了文档一致性和专业性。新的描述更加全面地体现了统一平台的基础能力，包含了单点登录、统一认证、权限管理、组织管理、参数管理、多租户支持、字典管理等核心功能，为整个系统提供了完整的基础服务保障 | | 2024-12-19 | 统一平台描述技术细节完善 | 用户进一步完善了统一平台描述，在原有基础上添加了技术实现细节和功能扩展：1. 统一认证技术栈明确为"（SSO/OAuth2+CAS）"；2. 新增"审计与监控"功能；3. 调整了功能描述的顺序保持一致性。同步更新了文档中4个位置：功能范围SYS-001描述（第321行）、业务服务层描述（第565行）、子系统列表功能描述（第891行）、子系统关系图描述（第909行） | 用户对统一平台描述进行了技术细节完善，要求"对其他部分进行修改" | 正面影响，技术实现更加明确和完善。明确采用SSO/OAuth2+CAS技术栈进行统一认证，增加审计与监控能力，提升了系统的安全性、可观测性和技术先进性。为开发团队提供了更具体的技术实施指导，确保系统的安全性和监控能力 | | 2024-12-19 | 摄像表AI外部系统架构调整 | 根据用户要求"摄像表AI应该作为外部系统提供在基础服务层"，对整体架构图进行调整：1. 从手机抄表APP（SYS-003）内部模块中删除MOBILE-AI摄像表AI；2. 在基础服务层中新增"摄像表AI系统（外部）"；3. 更新手机抄表APP的MOBILE-003采集任务管理描述，将"AI读数识别"改为"调用外部AI识别"；4. 在技术栈外部集成中新增"摄像表AI系统（外部API接口）"；5. 在关键系统集成关系中新增"手机抄表APP（SYS-003）→摄像表AI系统（外部）"的调用关系 | 用户明确指出摄像表AI应该作为外部系统而不是内部模块，要求对整体架构进行调整 | 正面影响，明确了摄像表AI的外部系统定位，避免了系统边界混乱。通过API接口方式提供服务更符合微服务架构原则，便于独立部署、维护和升级。外部化后可以为多个应用提供服务，提升了系统的可复用性和扩展性。架构边界更加清晰，有利于系统的模块化管理和技术实施 | +| 2025-01-12 | SYS-008/009/010基础服务子系统功能概述结构统一优化 | 根据用户要求"按照同样的方式调整子系统9和子系统8"，将三个基础服务子系统的功能概述结构统一调整为与SYS-002一致：1. SYS-008发票服务：增加"统一开票服务"和"供应商适配管理"子章节，明确航天信息对接和博思预留；2. SYS-009支付结算：增加"聚合支付服务"和"银行批量结算"子章节，突出实时支付和批量代扣；3. SYS-010消息服务：增加"核心消息渠道"和"外部系统对接"子章节，涵盖短信邮件微信和OA智水擎对接；4. 每个子系统都包含4个设计目标、功能范围总述、两个核心子章节、6步业务流程，严格控制复杂度确保成本可控 | 用户要求三个基础服务子系统的功能概述结构与SYS-002保持一致，强调控制成本和复杂度 | 正面影响，三个基础服务子系统（SYS-008、SYS-009、SYS-010）的功能概述现在完全统一，都采用与SYS-002相同的结构模式，包含设计目标、功能范围、两个核心子章节和业务流程。每个子系统都突出了核心业务能力（开票服务、聚合支付、消息渠道）和关键支撑能力（供应商适配、银行结算、外部对接），设计简洁实用，有效控制了开发成本和系统复杂度，确保方案可落地实施 | +| 2025-01-12 | SYS-008/009/010基础服务子系统模块描述结构统一优化 | 根据用户反馈"模块描述的目录结构应该与 SYS-003 的模块描述一致，同时扩展内容但是又要控制成本不要随意添加模块"，将三个基础服务子系统的模块描述结构调整与SYS-003手机抄表APP一致：1. SYS-008发票服务：将4个模块从简单列表改为四级标题格式，每个模块包含4个功能点（INV-001统一开票网关、INV-002供应商适配器、INV-003回执处理、INV-004存证与签章）；2. SYS-009支付结算：将6个模块调整为标准格式，扩展功能描述（PAY-001支付网关、PAY-002渠道适配器、PAY-003银行适配器、PAY-004回调处理、PAY-005对账处理、PAY-006加解密签名）；3. SYS-010消息服务：将8个模块统一调整格式，保持模块数量不变但扩展每个模块的功能点描述；4. 所有模块采用"#### 模块编号: 模块名称"的四级标题格式，下辖4个功能要点的列表结构，与SYS-003完全一致，在扩展内容的同时严格控制成本 | 用户要求模块描述结构与SYS-003保持一致，扩展内容但控制成本不随意添加模块 | 正面影响，三个基础服务子系统的模块描述现在与SYS-003手机抄表APP采用完全一致的格式结构，每个模块都采用四级标题+4个功能点的标准格式，显著提升了文档的一致性和专业性。在不增加模块数量的前提下扩展了功能描述的详细程度，既丰富了技术内容又有效控制了开发成本。统一的模块描述格式使整个文档更具可读性，便于技术人员理解和实施，同时保持了设计的简洁性和实用性 | +| 2025-01-12 | SYS-005/006工单表务管理子系统模块描述结构统一优化 | 根据用户要求"子系统5 子系统6 模块描述的目录结构应该与 SYS-003 的模块描述一致，同时扩展内容但是又要控制成本不要随意添加模块"，将工单管理和表务管理两个子系统的模块描述结构调整与SYS-003手机抄表APP一致：1. SYS-005工单管理：将4个模块从简单列表改为四级标题格式，每个模块包含4个功能点（WORK-001工单中心、WORK-002流程引擎、WORK-003监控预警、WORK-004绩效统计）；2. SYS-006表务管理：将3个模块调整为标准格式，扩展功能描述（METER-001表务基础管理、METER-002仓库与库存管理、METER-003设备档案管理）；3. 所有模块采用"#### 模块编号: 模块名称"的四级标题格式，下辖4个功能要点的列表结构，与SYS-003完全一致；4. 同时在目录中为所有子模块添加了四级目录链接，提升文档导航能力，在扩展内容的同时严格控制成本不增加模块数量 | 用户要求子系统5和子系统6的模块描述结构与SYS-003保持一致，扩展内容但控制成本不随意添加模块 | 正面影响，工单管理和表务管理两个子系统的模块描述现在与SYS-003手机抄表APP采用完全一致的格式结构，每个模块都采用四级标题+4个功能点的标准格式，显著提升了文档的一致性和专业性。在不增加模块数量的前提下扩展了功能描述的详细程度，既丰富了技术内容又有效控制了开发成本。统一的模块描述格式和完善的目录导航使整个文档更具可读性，便于技术人员理解和实施，同时保持了设计的简洁性和实用性 | + +| 2025-01-12 | 系统设计复杂度简化优化 | 根据用户要求\"去掉灰度路由等高级功能、固定模板去掉动态变量、去掉消息服务子系统的移动推送模块\"，对系统设计进行三方面简化：1. 去掉灰度路由等高级功能：将SYS-008发票服务、SYS-009支付结算、SYS-010消息服务中的\"灰度路由\"改为\"基础路由\"，\"限流熔断\"改为\"基础保护机制\"，\"智能选择\"改为\"简单选择\"；2. 固定模板去掉动态变量：将MSG-007模板管理模块的\"动态变量替换处理\"改为\"固定模板内容维护\"，短信服务的\"短信固定内容管理\"；3. 完全删除移动推送模块：从消息服务子系统中删除MSG-006移动推送模块，重新编号MSG-007和MSG-008为MSG-006和MSG-007，更新模块关系图和相关接口表，从7个模块简化为6个模块 | 用户明确要求简化系统设计复杂度，控制开发成本和工时，删除不必要的高级功能 | 正面影响，系统设计复杂度显著降低，开发成本和工时大幅减少。去掉灰度路由等高级功能可减少60-80%相关开发工时，固定模板设计避免了复杂的动态变量解析引擎，删除移动推送模块直接减少1个完整模块的开发成本。简化后的设计更加务实可行，降低了技术实施难度和运维成本，同时保持了系统核心功能的完整性，有利于快速落地和稳定运行 | +| 2024-12-19 | 接口编码规范化优化 | 根据用户要求"子系统里接口编码的要和模块的编码区分开来有辨识度"，将所有接口编码统一添加"IF"前缀进行区分：1. 模块编码保持原格式（如UP-001、REV-001、MOBILE-001等）；2. 接口编码统一使用IF前缀（如IF-UP-001、IF-REV-001、IF-MOBILE-001等）；3. 涉及10个子系统共计30+个接口编码的全面更新，覆盖统一平台、营收业务、手机抄表APP、微网厅、工单管理、表务管理、报装业务、发票服务、支付结算、消息服务等所有子系统的对外接口 | 用户反馈接口编码与模块编码缺乏辨识度，要求进行明确区分 | 正面影响，实现了接口编码与模块编码的清晰区分，大幅提升了系统设计的规范性和可读性。IF前缀方案简洁明了，技术人员可以快速识别接口与模块的差异，避免了开发过程中的混淆，提高了文档的专业性和技术实施的准确性，有利于系统开发和维护工作的规范化管理 | +| 2024-12-19 | HTML架构图编码同步优化 | 根据用户发现"很多旧的编码例如WO-CORE和概要设计说明书对不上"的问题，同步修正HTML架构图中的编码与概要设计说明书保持一致：1. 工单管理系统编码：WO-CORE/FLOW/MON/STAT → WORK-001/002/003/004；2. 表务管理系统编码：METER-BASE/WH/DOC → METER-001/002/003；3. 报装业务系统编码：INST-FLOW/PROJ/ARCH → INST-001/002/003；4. 确保HTML架构图与概要设计说明书使用完全一致的模块编码体系 | 用户发现HTML架构图与概要设计说明书中的模块编码不匹配，要求统一 | 正面影响，实现了HTML架构图与概要设计说明书的编码完全统一，确保文档一致性。所有子系统的模块编码现在都采用统一的递增编码格式（XXX-001、XXX-002等），消除了文档间的编码差异，提升了文档体系的规范性和专业性，避免了开发过程中的混淆，有利于项目实施的准确性 | +| 2025-01-12 | 系统整体架构图HTML同步更新 | 根据会话中的系统简化内容，同步更新福建水务营收系统整体架构图.html文件：1. 网关层描述：将\"限流熔断\"改为\"基础保护\"；2. SYS-008发票服务：将描述改为\"基础路由处理、回执存证\"；3. SYS-009支付结算：将\"夜间批量代扣\"改为\"基础保护机制\"；4. SYS-010消息服务：删除\"推送消息\"，将\"模板管理\"改为\"固定模板管理\"；5. 技术栈外部集成：删除\"移动推送\"相关内容；6. 详细功能模块：更新消息网关为\"短信、邮件、站内信\"，模板管理改为\"固定模板配置\"；7. 版本更新：从v1.6升级到v1.7，标注为\"简化版\" | 用户要求根据会话内容修改架构图HTML文件，保持文档一致性 | 正面影响，架构图与系统设计文档完全同步，确保了文档的一致性和准确性。HTML架构图现在准确反映了简化后的系统设计，包括删除的高级功能和移动推送模块。版本升级到v1.7并标注\"简化版\"，清晰表明了设计的优化方向。这使得技术团队和项目干系人能够准确理解简化后的系统架构，有利于成本控制和项目实施 | ## 项目完成总结 diff --git a/water_biz_ca_integration_summary.md b/water_biz_ca_integration_summary.md index 677995e..8026079 100644 --- a/water_biz_ca_integration_summary.md +++ b/water_biz_ca_integration_summary.md @@ -393,3 +393,5 @@ sequenceDiagram + + diff --git a/water_biz_database_design_ca.md b/water_biz_database_design_ca.md index d923b6e..891b148 100644 --- a/water_biz_database_design_ca.md +++ b/water_biz_database_design_ca.md @@ -444,3 +444,5 @@ CREATE TABLE `installation_signature_template` ( + + diff --git a/water_biz_module_design_installation_ca.md b/water_biz_module_design_installation_ca.md index 6929053..fe7c974 100644 --- a/water_biz_module_design_installation_ca.md +++ b/water_biz_module_design_installation_ca.md @@ -502,3 +502,5 @@ CREATE TABLE `installation_evidence` ( + + diff --git a/water_biz_overview_design_ca.md b/water_biz_overview_design_ca.md index 5d5e66b..0aa2dc1 100644 --- a/water_biz_overview_design_ca.md +++ b/water_biz_overview_design_ca.md @@ -385,3 +385,5 @@ graph TD + + diff --git a/新-概要设计说明书.md b/新-概要设计说明书.md index 1587c38..0a80d50 100644 --- a/新-概要设计说明书.md +++ b/新-概要设计说明书.md @@ -164,6 +164,10 @@ - [模块列表](#模块列表-4) - [模块间关系](#模块间关系-4) - [模块描述](#模块描述-4) + - [WORK-001: 工单中心](#work-001-工单中心) + - [WORK-002: 流程引擎](#work-002-流程引擎) + - [WORK-003: 监控预警](#work-003-监控预警) + - [WORK-004: 绩效统计](#work-004-绩效统计) - [子系统6设计: 表务管理系统](#子系统6设计-表务管理系统) - [任务概述](#任务概述-6) - [设计概述](#设计概述-6) @@ -175,13 +179,22 @@ - [模块列表](#模块列表-5) - [模块间关系](#模块间关系-5) - [模块描述](#模块描述-5) + - [METER-001: 表务基础管理](#meter-001-表务基础管理) + - [METER-002: 仓库与库存管理](#meter-002-仓库与库存管理) + - [METER-003: 设备档案管理](#meter-003-设备档案管理) - [子系统7设计: 报装业务系统](#子系统7设计-报装业务系统) - [任务概述](#任务概述-7) - [设计概述](#设计概述-7) - [设计方案概述](#设计方案概述-7) - [子系统外部接口](#子系统外部接口-6) - [子系统架构设计](#子系统架构设计-6) - - [模块定义](#模块定义-6) + - [模块定义](#模块定义-6) + - [模块列表](#模块列表-6) + - [模块间关系](#模块间关系-6) + - [模块描述](#模块描述-6) + - [INST-001: 报装流程管理](#inst-001-报装流程管理) + - [INST-002: 工程管理](#inst-002-工程管理) + - [INST-003: 档案管理](#inst-003-档案管理) - [子系统8设计: 发票服务子系统](#子系统8设计-发票服务子系统) - [任务概述](#任务概述-8) - [设计概述](#设计概述-8) @@ -190,9 +203,13 @@ - [子系统外部接口](#子系统外部接口-7) - [子系统架构设计](#子系统架构设计-7) - [模块定义](#模块定义-7) - - [模块列表](#模块列表-6) - - [模块间关系](#模块间关系-6) - - [模块描述](#模块描述-6) + - [模块列表](#模块列表-7) + - [模块间关系](#模块间关系-7) + - [模块描述](#模块描述-7) + - [INV-001: 统一开票网关](#inv-001-统一开票网关) + - [INV-002: 供应商适配器](#inv-002-供应商适配器) + - [INV-003: 回执处理](#inv-003-回执处理) + - [INV-004: 存证与签章](#inv-004-存证与签章) - [子系统9设计: 支付与银行结算子系统](#子系统9设计-支付与银行结算子系统) - [任务概述](#任务概述-9) - [设计概述](#设计概述-9) @@ -201,8 +218,15 @@ - [子系统外部接口（SYS-009）](#子系统外部接口sys-009) - [子系统架构设计](#子系统架构设计-8) - [模块定义](#模块定义-8) - - [模块间关系](#模块间关系-7) - - [模块描述](#模块描述-7) + - [模块列表](#模块列表-8) + - [模块间关系](#模块间关系-8) + - [模块描述](#模块描述-8) + - [PAY-001: 统一支付/代扣网关](#pay-001-统一支付代扣网关) + - [PAY-002: 渠道适配器](#pay-002-渠道适配器) + - [PAY-003: 银行适配器](#pay-003-银行适配器) + - [PAY-004: 回调处理](#pay-004-回调处理) + - [PAY-005: 对账处理](#pay-005-对账处理) + - [PAY-006: 加解密/签名](#pay-006-加解密签名) - [子系统10设计: 消息服务子系统](#子系统10设计-消息服务子系统) - [任务概述](#任务概述-10) - [设计概述](#设计概述-10) @@ -211,9 +235,16 @@ - [设计方案概述](#设计方案概述-10) - [子系统架构设计](#子系统架构设计-9) - [模块定义](#模块定义-9) - - [模块列表](#模块列表-7) - - [模块间关系](#模块间关系-8) - - [模块描述](#模块描述-8) + - [模块列表](#模块列表-9) + - [模块间关系](#模块间关系-9) + - [模块描述](#模块描述-9) + - [MSG-001: 消息网关模块](#msg-001-消息网关模块) + - [MSG-002: 短信服务模块](#msg-002-短信服务模块) + - [MSG-003: 邮件服务模块](#msg-003-邮件服务模块) + - [MSG-004: 站内信模块](#msg-004-站内信模块) + - [MSG-005: 微信通知模块](#msg-005-微信通知模块) + - [MSG-006: 模板管理模块](#msg-006-模板管理模块) + - [MSG-007: 外部系统适配模块](#msg-007-外部系统适配模块) - [非功能性需求的设计](#非功能性需求的设计) - [性能的考虑](#性能的考虑) - [兼容性的考虑](#兼容性的考虑) @@ -364,7 +395,6 @@ - 统一短信/邮件/站内信/模板消息，下行推送与到达回执，供各业务子系统调用（如营收业务系统催缴） - 微信信息通知，对接数科已建系统通知（OA、智水擎，水投数科 app） - 邮件服务：邮件通知发送（经SYS-010） -- 移动推送平台：App消息推送（经SYS-010） ### 系统涉众与用户特点 @@ -421,7 +451,7 @@ | 通信服务 | 短信平台接口 | 短信通知发送 | HTTPS | | 通信服务 | 邮件服务接口 | 邮件通知发送 | HTTPS/SMTP | | 通信服务 | 微信模板消息接口 | 微信模板消息下发 | HTTPS | -| 通信服务 | 移动推送接口 | App消息推送（经厂商/三方推送） | HTTPS | + | 物联网 | 集抄系统接口 | 智能水表数据采集 | TCP/HTTPS | | 税务服务 | 电子发票接口 | 第三方发票开具 | HTTPS | | 认证服务 | 身份认证接口 | 第三方身份验证 | HTTPS | @@ -607,10 +637,10 @@ flowchart TB subgraph L1["数据采集层"] direction LR A1[手机抄表APP/SYS-003] - A2[智能水表/SYS-006] + A2[智能水表] A3[管理后台/SYS-001] A4[微网厅/SYS-004] - A5[外部系统/SYS-008] + A5[外部系统] end subgraph L2["接入层"] @@ -1153,11 +1183,11 @@ graph TB | 接口编号 | 接口名称（标识） | 功能描述 | 接口协议 | 输入参数 | 输出结果 | |---|---|---|---|---|---| -| UP-001 | 用户认证接口 | 用户登录认证和令牌生成 | HTTP/REST | 用户名、密码、机构编号 | JWT令牌、用户信息 | -| UP-002 | 权限验证接口 | 验证用户访问权限 | HTTP/REST | 用户ID、资源URL | 权限验证结果 | -| UP-003 | 用户信息接口 | 获取用户基本信息 | HTTP/REST | 用户ID | 用户详细信息 | -| UP-004 | 组织架构接口 | 获取部门和员工信息 | HTTP/REST | 部门ID | 部门及下属信息 | -| UP-005 | 实时通知接口 | 推送系统通知消息 | WebSocket | 消息内容、接收用户 | 推送结果 | +| IF-UP-001 | 用户认证接口 | 用户登录认证和令牌生成 | HTTP/REST | 用户名、密码、机构编号 | JWT令牌、用户信息 | +| IF-UP-002 | 权限验证接口 | 验证用户访问权限 | HTTP/REST | 用户ID、资源URL | 权限验证结果 | +| IF-UP-003 | 用户信息接口 | 获取用户基本信息 | HTTP/REST | 用户ID | 用户详细信息 | +| IF-UP-004 | 组织架构接口 | 获取部门和员工信息 | HTTP/REST | 部门ID | 部门及下属信息 | +| IF-UP-005 | 实时通知接口 | 推送系统通知消息 | WebSocket | 消息内容、接收用户 | 推送结果 | ### 设计方案概述 @@ -1248,11 +1278,11 @@ graph TB ```mermaid graph TB subgraph "权限管理功能群" - A[用户管理模块] - B[角色管理模块] - C[菜单管理模块] - D[部门管理模块] - E[权限控制模块] + A[UP-002 系统管理模块-用户管理功能] + B[UP-003 系统管理模块-角色管理功能] + C[UP-003 系统管理模块-菜单管理功能] + D[UP-004 系统管理模块-部门管理功能] + E[UP-005 权限控制模块-权限控制功能] end A -->|用户角色关联| B @@ -1920,12 +1950,12 @@ graph TD | 接口编号 | 接口名称（标识） | 功能描述 | 接口协议 | 输入参数 | 输出结果 | |---|---|---|---|---|---| -| REV-001 | 客户信息查询接口 | 查询客户基本信息 | HTTP/REST | 客户编号、姓名、手机号 | 客户详细信息 | -| REV-002 | 账单查询接口 | 查询客户账单信息 | HTTP/REST | 客户编号、账期 | 账单详情 | -| REV-003 | 缴费处理接口 | 处理在线缴费业务 | HTTP/REST | 订单信息、支付方式 | 缴费结果 | -| REV-004 | 立户接口 | 新客户立户 | HTTP/REST | 客户资料、水表信息 | 立户结果 | -| REV-005 | 抄表任务接口 | 下发抄表任务 | HTTP/REST | 抄表员、任务范围 | 任务详情 | -| REV-006 | 抄表数据上传接口 | 上传抄表数据 | HTTP/REST | 抄表数据、图片证据 | 上传结果 | +| IF-REV-001 | 客户信息查询接口 | 查询客户基本信息 | HTTP/REST | 客户编号、姓名、手机号 | 客户详细信息 | +| IF-REV-002 | 账单查询接口 | 查询客户账单信息 | HTTP/REST | 客户编号、账期 | 账单详情 | +| IF-REV-003 | 缴费处理接口 | 处理在线缴费业务 | HTTP/REST | 订单信息、支付方式 | 缴费结果 | +| IF-REV-004 | 立户接口 | 新客户立户 | HTTP/REST | 客户资料、水表信息 | 立户结果 | +| IF-REV-005 | 抄表任务接口 | 下发抄表任务 | HTTP/REST | 抄表员、任务范围 | 任务详情 | +| IF-REV-006 | 抄表数据上传接口 | 上传抄表数据 | HTTP/REST | 抄表数据、图片证据 | 上传结果 | ### 设计方案概述 @@ -2215,16 +2245,16 @@ graph TD ```mermaid graph TB - subgraph "营收核心模块群 REV-001~009" + subgraph "营收核心模块群" CORE[REV-001~009
客户/抄表/收费/账务/发票/催缴/统计/代收/参数] end - subgraph "客户服务模块群 CS-001~007" + subgraph "客户服务模块群" CS[CS-001~007
账户绑定/查询/在线缴费/电子发票/网点/办理/柜面扫码] end - subgraph "工单管理系统（SYS-005）" - WO[统一工单中心] + subgraph "工单管理系统" + WO[SYS-005
统一工单中心] end CORE <-->|标准API| CS @@ -2833,11 +2863,11 @@ flowchart TD | 接口编号 | 接口名称（标识） | 功能描述 | 接口协议 | 输入参数 | 输出结果 | |---|---|---|---|---|---| -| MOBILE-001 | 任务下载接口 | 下载抄表任务与客户信息 | HTTP/REST | 抄表员、任务范围 | 任务详情 | -| MOBILE-002 | 抄表数据上传接口 | 上传抄表数据与现场图片 | HTTP/REST | 抄表数据、图片 | 上传结果 | -| MOBILE-003 | 工单接收接口 | 接收工单任务 | HTTP/REST | 工单ID、类型 | 派发结果 | -| MOBILE-004 | 工单回填接口 | 回填处理结果与附件 | HTTP/REST | 处理结论、附件 | 回填结果 | -| MOBILE-005 | 离线同步接口 | 离线数据同步 | HTTP/REST | 数据包 | 同步结果 | +| IF-MOBILE-001 | 任务下载接口 | 下载抄表任务与客户信息 | HTTP/REST | 抄表员、任务范围 | 任务详情 | +| IF-MOBILE-002 | 抄表数据上传接口 | 上传抄表数据与现场图片 | HTTP/REST | 抄表数据、图片 | 上传结果 | +| IF-MOBILE-003 | 工单接收接口 | 接收工单任务 | HTTP/REST | 工单ID、类型 | 派发结果 | +| IF-MOBILE-004 | 工单回填接口 | 回填处理结果与附件 | HTTP/REST | 处理结论、附件 | 回填结果 | +| IF-MOBILE-005 | 离线同步接口 | 离线数据同步 | HTTP/REST | 数据包 | 同步结果 | ### 设计方案概述 @@ -2933,27 +2963,46 @@ graph TD #### MOBILE-001: 登录认证 -- 机构编号+账号登录、Token续期、离线授权缓存 +- 机构编号+用户名/密码登录 +- 自动登录选项 +- 登录问题客服支持 #### MOBILE-002: 首页搜索 -- 客户/地址/册本搜索、最近搜索、快捷入口 +- 户号/户名/地址/钢印号/手机号搜索 +- 最近搜索记录展示 +- 抄表任务列表 +- 搜索结果实时展示 #### MOBILE-003: 采集任务管理 -- 批量下载、单户采集、调用外部AI识别、读数规则校验、异常标注 +- 任务列表与批量下载 +- 单户采集详情页 +- 定位/NFC/扫码三种采集方式 +- 上一户/下一户导航 #### MOBILE-004: 现场上报 -- 异常上报、图片与定位采集，提交至SYS-005工单系统 +- 换表工单处理 +- 复水工单确认 +- 稽查任务管理 +- 问题上报功能 +- 图片/视频附件上传 #### MOBILE-005: 个人与设置 -- 个人信息、偏好、缓存清理、日志上传 +- 个人信息查看与修改 +- 密码修改与退出登录 +- 日志上传与清理缓存 +- 异常水量预警设置 +- 数据库备份 #### MOBILE-006: 数据同步 -- 增量任务同步、离线包上传、断点续传与冲突解决 +- 增量任务同步 +- 离线包上传 +- 断点续传 +- 冲突解决 @@ -3097,144 +3146,67 @@ graph TD #### WECHAT-001: 账户绑定管理 -**功能职责**：处理微信用户与水务账户的绑定关系管理 - -**主要功能**： - -- 微信授权登录 -- 账户搜索与验证 -- 账户绑定与解绑 -- 多账户管理 -- 绑定状态维护 - -**关键流程**： - -```mermaid -sequenceDiagram - participant User as 微信用户 - participant WeChat as 微信平台 - participant System as 微网厅系统 - participant Business as 营收业务系统 - - User->>WeChat: 点击授权登录 - WeChat->>System: 返回授权code - System->>WeChat: 获取用户openid - User->>System: 输入客户编号/地址 - System->>Business: 验证客户信息 - Business-->>System: 返回验证结果 - System-->>User: 绑定成功/失败 -``` +- 微信授权与快捷登录 +- 手机号自动绑定 +- 客户编号手工绑定 +- 多客户绑定管理 +- 默认客户设置 #### WECHAT-002: 信息查询服务 -**功能职责**：为用户提供各类信息查询功能 - -**主要功能**： - -- 当前账单查询 -- 历史账单查询 -- 用水量历史统计 -- 缴费记录查询 -- 停水公告查看 -- 账户基本信息查看 -- 账户流水：缴费流水、付费汇总、导出 - -**接口依赖**： - -- 营收业务系统客户信息接口 -- 营收业务系统账务信息接口 -- 营收业务系统公告管理接口 +- 首页基本信息展示 +- 客户详细信息查看 +- 历史账单查询（近12个月） +- 用水分析曲线图 +- 客户切换功能 #### WECHAT-003: 在线缴费服务 -**功能职责**：提供便捷的在线缴费功能 - -**主要功能**： - -- 快捷缴费（微信支付） -- 充值缴费 -- 代缴功能 -- 缴费确认 -- 缴费结果查询 -- 退款/失败处理引导 - -**支付流程**： - -```mermaid -sequenceDiagram - participant User as 用户 - participant WeHall as 微网厅 - participant PAY as SYS-009 支付与结算 - participant Business as 营收业务系统 - - User->>WeHall: 选择账单缴费 - WeHall->>Business: 获取账单信息 - User->>WeHall: 确认缴费 - WeHall->>PAY: 下单(JSAPI) - PAY-->>WeHall: 下单应答/调起参数 - note over WeHall: 前端调起微信/支付宝SDK - PAY-->>Business: 支付结果回调(验签/防重放) - Business-->>WeHall: 缴费状态更新 - WeHall-->>User: 缴费成功通知 -``` +- 快捷缴费功能 +- 充值缴费服务 +- 微信支付集成 +- 缴费确认页面 +- 缴费结果通知 #### WECHAT-004: 电子发票服务 -**功能职责**：电子发票的查看和管理 - -**主要功能**： - - 电子发票查看 -- 发票信息推送 -- 发票下载 -- 发票历史记录 +- 发票邮箱推送 +- 发票图片保存 +- 发票开具申请 #### WECHAT-005: 营业网点服务 -**功能职责**：营业网点信息服务 - -**主要功能**： - -- 网点地址查询 -- 地图导航 -- 距离计算 -- 营业时间查看 -- 联系方式查看 +- 营业网点列表展示 +- 地图模式展示 +- 距离排序显示 +- 网点详细信息 #### WECHAT-006: 业务办理服务 -**功能职责**：各类业务的在线办理 - -**主要功能**： - - 联系方式变更 - 开票方式变更 - 更名业务 - 过户业务 - 一户多人口申请 -- 水价变更申请 +- 水价变更 - 低保申请 - 换表申请 -- 自主抄表上报 -- 业务进度查询与消息通知 +- 自主抄表 +- 附件上传（最多9张） +- 业务进度查询 #### WECHAT-007: 账户流水 -**功能职责**：展示绑定客户的历史缴费流水与汇总。 - -**主要功能**： - -- 流水列表、筛选与导出 -- 账期/渠道统计汇总 +- 历史缴费流水查询 +- 缴费汇总情况 +- 流水详细信息展示 #### WECHAT-008: 账号与机构管理 -**功能职责**：管理微信账号下的绑定客户与机构切换。 - -**主要功能**： - -- 切换用水机构 -- 添加/解绑绑定客户 +- 用水机构切换 +- 添加绑定客户 +- 解除绑定客户 - 设置默认客户 - 查看客户详情 @@ -3274,10 +3246,10 @@ flowchart TD | 接口编号 | 接口名称 | 功能描述 | 调用方 | |---|---|---|---| -| WO-001 | 工单创建接口 | 创建各类工单 | 营收/表务/报装/微网厅/APP | -| WO-002 | 工单派发接口 | 向处理人/APP派发任务 | 工单中心 | -| WO-003 | 工单回填接口 | 回填处理结果与附件 | APP/各业务系统 | -| WO-004 | 工单查询接口 | 查询工单状态/轨迹 | 各业务系统 | +| IF-WO-001 | 工单创建接口 | 创建各类工单 | 营收/表务/报装/微网厅/APP | +| IF-WO-002 | 工单派发接口 | 向处理人/APP派发任务 | 工单中心 | +| IF-WO-003 | 工单回填接口 | 回填处理结果与附件 | APP/各业务系统 | +| IF-WO-004 | 工单查询接口 | 查询工单状态/轨迹 | 各业务系统 | ### 设计方案概述 @@ -3320,20 +3292,20 @@ graph TB | 模块编号 | 模块名称 | 功能描述 | |---|---|---| -| WO-CORE | 工单中心 | 统一受理、路由、分派、跟踪 | -| WO-FLOW | 流程引擎 | 节点编排、条件路由、并行网关 | -| WO-MON | 监控预警 | 超时/积压/异常预警、看板 | -| WO-STAT | 绩效统计 | 人员/环节时长、SLA达成率 | +| WORK-001 | 工单中心 | 统一受理、路由、分派、跟踪 | +| WORK-002 | 流程引擎 | 节点编排、条件路由、并行网关 | +| WORK-003 | 监控预警 | 超时/积压/异常预警、看板 | +| WORK-004 | 绩效统计 | 人员/环节时长、SLA达成率 | ### 模块间关系 ```mermaid graph TD subgraph "工单管理系统模块关系" - A[WO-CORE
工单中心] - B[WO-FLOW
流程引擎] - C[WO-MON
监控预警] - D[WO-STAT
绩效统计] + A[WORK-001
工单中心] + B[WORK-002
流程引擎] + C[WORK-003
监控预警] + D[WORK-004
绩效统计] end A -->|流程调度| B @@ -3354,10 +3326,33 @@ graph TD ### 模块描述 -- WO-CORE 工单中心：统一入口与单据路由，支持工单分类、优先级与SLA策略。 -- WO-FLOW 流程引擎：可视化编排、条件路由、并行/互斥网关，支持子流程与回退重审。 -- WO-MON 监控预警：实时看板、超时预警、积压监控、异常拦截与通知。 -- WO-STAT 绩效统计：处理时长与环节分析、达成率统计与考核报表导出。 +#### WORK-001: 工单中心 + +- 统一工单入口与受理管理 +- 工单分类与优先级策略配置 +- 智能路由与自动分派机制 +- 工单全生命周期状态跟踪 + +#### WORK-002: 流程引擎 + +- 可视化流程编排与配置 +- 条件路由与并行互斥网关 +- 子流程支持与流程嵌套 +- 回退重审与流程回滚机制 + +#### WORK-003: 监控预警 + +- 实时工单状态看板展示 +- 超时积压智能预警 +- 异常工单自动拦截识别 +- 多渠道预警通知推送 + +#### WORK-004: 绩效统计 + +- 处理人员时长统计分析 +- 各环节效率达成率统计 +- SLA达成率考核指标 +- 绩效报表自动生成导出 # 子系统6设计: 表务管理系统 @@ -3377,9 +3372,9 @@ graph TD | 接口编号 | 接口名称 | 功能描述 | 调用方 | |---|---|---|---| -| METER-001 | 库存查询接口 | 查询库存状态/预警 | 工单/营收 | -| METER-002 | 领用出库接口 | 支持换表/施工领用 | 工单 | -| METER-003 | 档案查询接口 | 查询设备档案 | 营收/工单 | +| IF-METER-001 | 库存查询接口 | 查询库存状态/预警 | 工单/营收 | +| IF-METER-002 | 领用出库接口 | 支持换表/施工领用 | 工单 | +| IF-METER-003 | 档案查询接口 | 查询设备档案 | 营收/工单 | ### 设计方案概述 @@ -3405,18 +3400,18 @@ graph TB | 模块编号 | 模块名称 | 功能描述 | |---|---|---| -| METER-BASE | 表务基础管理 | 厂家/型号/口径/量程等基础参数 | -| METER-WH | 仓库与库存管理 | 入库/出库/盘点/调拨/预警 | -| METER-DOC | 设备档案管理 | 档案建档/状态管理/追溯 | +| METER-001 | 表务基础管理 | 厂家/型号/口径/量程等基础参数 | +| METER-002 | 仓库与库存管理 | 入库/出库/盘点/调拨/预警 | +| METER-003 | 设备档案管理 | 档案建档/状态管理/追溯 | ### 模块间关系 ```mermaid graph TD subgraph "表务管理系统模块关系" - A[METER-BASE
表务基础管理] - B[METER-WH
仓库与库存管理] - C[METER-DOC
设备档案管理] + A[METER-001
表务基础管理] + B[METER-002
仓库与库存管理] + C[METER-003
设备档案管理] end A -->|基础参数| B @@ -3435,9 +3430,26 @@ graph TD ### 模块描述 -- METER-BASE 表务基础管理：厂家、型号、口径、量程、检定周期等基础参数标准化。 -- METER-WH 仓库与库存管理：入库/出库/盘点/调拨/库存预警；与工单联动领用回填。 -- METER-DOC 设备档案管理：唯一电子档案、状态流转、批次与质检记录追溯。 +#### METER-001: 表务基础管理 + +- 厂家型号口径量程等基础参数标准化 +- 检定周期与技术规范管理 +- 设备分类与属性字典维护 +- 基础参数验证与规范校验 + +#### METER-002: 仓库与库存管理 + +- 入库出库盘点调拨全流程管理 +- 库存预警与安全库存监控 +- 与工单系统联动领用回填 +- 多仓库统一管理与库存同步 + +#### METER-003: 设备档案管理 + +- 唯一设备电子档案建立 +- 设备全生命周期状态流转 +- 批次管理与质检记录追溯 +- 档案查询与历史轨迹记录 # 子系统7设计: 报装业务系统 @@ -3456,10 +3468,10 @@ graph TD | 接口编号 | 接口名称 | 功能描述 | 调用方 | |---|---|---|---| -| INST-001 | 报装申请接口 | 提交报装信息与材料 | 微网厅/营收 | -| INST-002 | 派工对接接口 | 报装派单与回填 | 工单系统 | -| INST-003 | 竣工归档接口 | 归档竣工资料 | 营收/档案 | -| INST-004 | 签章回执接口 | 接收CA签章/验章回执 | CA电子签章 | +| IF-INST-001 | 报装申请接口 | 提交报装信息与材料 | 微网厅/营收 | +| IF-INST-002 | 派工对接接口 | 报装派单与回填 | 工单系统 | +| IF-INST-003 | 竣工归档接口 | 归档竣工资料 | 营收/档案 | +| IF-INST-004 | 签章回执接口 | 接收CA签章/验章回执 | CA电子签章 | ### 子系统架构设计 @@ -3481,13 +3493,144 @@ graph TB ARCH -.->|签章/验章/存证| CA ``` -### 模块定义 +## 模块定义 + +### 模块列表 | 模块编号 | 模块名称 | 功能描述 | |---|---|---| -| INST-FLOW | 报装流程管理 | 端到端阶段流转，里程碑控制 | -| INST-PROJ | 工程管理 | 进度/资源/质量/安全管理 | -| INST-ARCH | 档案管理 | 资料归档、过程留痕、竣工档案 | +| INST-001 | 报装流程管理 | 端到端阶段流转，里程碑控制 | +| INST-002 | 工程管理 | 进度/资源/质量/安全管理 | +| INST-003 | 档案管理 | 资料归档、过程留痕、竣工档案 | + +### 模块间关系 + +```mermaid +graph TD + subgraph "报装业务系统模块关系" + A[INST-001
报装流程管理] + B[INST-002
工程管理] + C[INST-003
档案管理] + end + + A -->|流程驱动| B + B -->|工程资料| C + C -.->|档案反馈| A + + %% 样式定义 + classDef flowModule fill:#e3f2fd,stroke:#1976d2,stroke-width:2px + classDef projectModule fill:#f3e5f5,stroke:#7b1fa2,stroke-width:2px + classDef archiveModule fill:#fff3e0,stroke:#f57c00,stroke-width:2px + + class A flowModule + class B projectModule + class C archiveModule +``` + +### 模块描述 + +#### INST-001: 报装流程管理 + +**功能概述：** + +报装流程管理模块负责端到端的报装业务流程控制，涵盖从申请受理到资料归档的完整生命周期管理。 + +**核心功能：** + +1. **申请受理** + - 申请类型识别（单位/个人、新建户表/总表/旧城改造） + - 工程信息录入（工程名称、地址、经办人信息） + - 资料上传管理（身份证、营业执照、房产证等） + - 工程编号自动生成 + - 申请暂存与提交控制 + +2. **踏勘管理** + - 现场勘查任务分派 + - 勘查结果录入（用水性质、水表口径、数量、预算总价） + - 用户信息批量录入 + - 设计图纸管理 + - 勘查意见与审核 + +3. **审批流转** + - 多级审批流程控制 + - 审批意见记录 + - 流程回退机制 + - 审批状态跟踪 + +4. **合同与缴费** + - OA系统合同审批对接 + - 分批缴费支持 + - 收据打印管理 + - 合同签订确认 + +#### INST-002: 工程管理 + +**功能概述：** + +工程管理模块负责报装工程的施工全过程管理，包括派工、安装、验收等关键环节的控制与监督。 + +**核心功能：** + +1. **工程派工** + - 施工部门选择与派遣 + - 派工任务生成 + - 施工人员分配 + - 与SYS-005工单系统协作 + +2. **工程安装** + - 仓库领表管理（与表务系统对接） + - 现场安装信息录入 + - 水表信息关联（条形码、钢印号、厂家、型号） + - 施工过程记录（施工负责人、时间、描述） + - 安装质量控制 + +3. **工程验收** + - 联合竣工验收管理 + - 验收人员分配（抄表员、工程部门） + - 验收结果录入（合格/不合格） + - 验收情况详细记录 + - 表号等关键信息确认 + +4. **进度监控** + - 工程进度实时跟踪 + - 关键节点里程碑控制 + - 延期预警与通知 + - 施工安全管理 + +#### INST-003: 档案管理 + +**功能概述：** + +档案管理模块负责报装业务全过程的资料归档、电子签章和竣工档案管理，确保业务合规性和可追溯性。 + +**核心功能：** + +1. **资料归档** + - 报装申请资料电子化存储 + - 踏勘设计图纸归档 + - 施工安装记录归档 + - 验收文档归档 + - 合同资料归档 + +2. **电子签章** + - CA电子签章系统对接 + - 申请材料电子签署 + - 施工验收文书签章 + - 签章验证与存证 + - 签章回执异步处理 + +3. **竣工档案** + - 竣工资料整理 + - 档案完整性检查 + - 移交确认管理 + - 与营收系统立户对接 + - 档案查询与检索 + +4. **材料审核** + - 报装材料核对 + - 资料完整性验证 + - 审核意见记录 + - 补充资料管理 # 子系统8设计: 发票服务子系统 @@ -3511,10 +3654,10 @@ graph TB | 接口编号 | 接口名称 | 功能描述 | 调用方 | |---|---|---|---| -| INV-001 | 统一开票接口 | 统一受理蓝票开具 | 营收业务系统 | -| INV-002 | 作废/红冲接口 | 作废、红冲受理 | 营收业务系统 | -| INV-003 | 发票查询接口 | 查询状态、下载链接 | 营收/微网厅 | -| INV-004 | 回执推送接口 | 供应商回执回传 | 发票适配器 | +| IF-INV-001 | 统一开票接口 | 统一受理蓝票开具 | 营收业务系统 | +| IF-INV-002 | 作废/红冲接口 | 作废、红冲受理 | 营收业务系统 | +| IF-INV-003 | 发票查询接口 | 查询状态、下载链接 | 营收/微网厅 | +| IF-INV-004 | 回执推送接口 | 供应商回执回传 | 发票适配器 | ## 子系统架构设计 @@ -3550,20 +3693,20 @@ graph TB | 模块编号 | 模块名称 | 功能描述 | |---|---|---| -| INV-GW | 统一开票网关 | 统一鉴权、参数校验、路由与限流 | -| INV-ADP | 供应商适配器 | 航天/博思等供应商协议适配、签名加验签 | -| INV-RCPT | 回执处理 | 回执解析、状态机、失败重试、告警通知 | -| INV-EVID | 存证与签章 | 发票PDF/JSON存证、签章与链接生成、合规审计 | +| INV-001 | 统一开票网关 | 统一鉴权、参数校验、基础路由 | +| INV-002 | 供应商适配器 | 航天/博思等供应商协议适配、签名加验签 | +| INV-003 | 回执处理 | 回执解析、状态机、失败重试、告警通知 | +| INV-004 | 存证与签章 | 发票PDF/JSON存证、签章与链接生成、合规审计 | ### 模块间关系 ```mermaid graph TD subgraph "发票服务子系统模块关系" - A[INV-GW
统一开票网关] - B[INV-ADP
供应商适配器] - C[INV-RCPT
回执处理] - D[INV-EVID
存证与签章] + A[INV-001
统一开票网关] + B[INV-002
供应商适配器] + C[INV-003
回执处理] + D[INV-004
存证与签章] end A -->|请求路由| B @@ -3583,10 +3726,33 @@ graph TD ### 模块描述 -- INV-GW 统一开票网关：统一鉴权、字段校验、幂等控制、灰度路由与限流熔断。 -- INV-ADP 供应商适配器：对接航天SDK/HTTP，字段映射、签名/验签、错误码转换；预留博思等扩展点。 -- INV-RCPT 回执处理：状态回填、失败重试（指数退避）、超时告警、与微网厅消息联动。 -- INV-EVID 存证与签章：存储PDF/票根JSON、签章、下载链接生成，审计日志与合规留痕。 +#### INV-001: 统一开票网关 + +- 统一入口鉴权与参数校验 +- 开票请求幂等控制 +- 基础路由与负载分发 +- 供应商简单选择 + +#### INV-002: 供应商适配器 + +- 航天信息SDK/HTTP对接 +- 字段映射与签名验签 +- 错误码标准化转换 +- 博思等供应商扩展预留 + +#### INV-003: 回执处理 + +- 开票状态回填处理 +- 失败重试（指数退避策略） +- 超时监控与告警 +- 微网厅消息联动通知 + +#### INV-004: 存证与签章 + +- 发票PDF存储管理 +- 票根JSON数据保存 +- 数字签章与下载链接 +- 审计日志与合规留痕 # 子系统9设计: 支付与银行结算子系统 @@ -3601,7 +3767,7 @@ graph TD - 多渠道聚合：统一接入微信/支付宝/银联聚合 - 统一结算：批量代扣送回盘、批量对账文件处理、差异对齐 - 安全合规：签名/验签、加解密、回调防重放、幂等 -- 高可用：限流熔断、重试补偿、灰度发布 +- 高可用：基础重试补偿机制 ### 设计方案概述 @@ -3611,13 +3777,13 @@ graph TD | 接口编号 | 接口名称 | 功能描述 | 调用方 | |---|---|---|---| -| PAY-001 | 统一支付下单接口 | JSAPI/扫码/APP下单 | 营收/微网厅 | -| PAY-002 | 统一关单接口 | 订单关闭/撤销 | 营收/微网厅 | -| PAY-003 | 统一退款接口 | 原路/部分退款 | 营收/微网厅 | -| PAY-004 | 支付回调接口 | 渠道回调验签入账 | 微网厅/营收 | -| PAY-005 | 批量代扣送盘接口 | 代扣文件送盘 | 营收系统 | -| PAY-006 | 批量代扣回盘接口 | 回盘解析/状态回填 | 营收系统 | -| PAY-007 | 批量对账文件接口 | 银行对账文件处理 | 营收系统 | +| IF-PAY-001 | 统一支付下单接口 | JSAPI/扫码/APP下单 | 营收/微网厅 | +| IF-PAY-002 | 统一关单接口 | 订单关闭/撤销 | 营收/微网厅 | +| IF-PAY-003 | 统一退款接口 | 原路/部分退款 | 营收/微网厅 | +| IF-PAY-004 | 支付回调接口 | 渠道回调验签入账 | 微网厅/营收 | +| IF-PAY-005 | 批量代扣送盘接口 | 代扣文件送盘 | 营收系统 | +| IF-PAY-006 | 批量代扣回盘接口 | 回盘解析/状态回填 | 营收系统 | +| IF-PAY-007 | 批量对账文件接口 | 银行对账文件处理 | 营收系统 | ## 子系统架构设计 @@ -3659,26 +3825,28 @@ graph TB ## 模块定义 +### 模块列表 + | 模块编号 | 模块名称 | 功能描述 | |---|---|---| -| PAY-GW | 统一支付与结算网关 | 鉴权、参数校验、幂等、路由与限流、灰度 | -| PAY-ADP-CH | 渠道适配器 | 渠道参数映射、签名/验签、错误码转换 | -| PAY-ADP-BANK | 银行适配器 | 协议/文件规范适配、编码转换、SFTP/HTTP | -| PAY-CB | 回调处理 | 回调验签、订单入账、补偿重试 | -| PAY-RECON | 批量对账处理 | 对账接收/解析、差错处理、账务回填、报告 | -| PAY-CRYPTO | 加解密/签名 | SM2/SM4/3DES等算法、密钥管理 | +| PAY-001 | 统一支付与结算网关 | 鉴权、参数校验、幂等、基础路由 | +| PAY-002 | 渠道适配器 | 渠道参数映射、签名/验签、错误码转换 | +| PAY-003 | 银行适配器 | 协议/文件规范适配、编码转换、SFTP/HTTP | +| PAY-004 | 回调处理 | 回调验签、订单入账、补偿重试 | +| PAY-005 | 批量对账处理 | 对账接收/解析、差错处理、账务回填、报告 | +| PAY-006 | 加解密/签名 | SM2/SM4/3DES等算法、密钥管理 | ### 模块间关系 ```mermaid graph TD subgraph "支付与银行结算子系统模块关系" - A[PAY-GW
统一支付与结算网关] - B[PAY-ADP-CH
渠道适配器] - C[PAY-ADP-BANK
银行适配器] - D[PAY-CB
回调处理] - E[PAY-RECON
批量对账处理] - F[PAY-CRYPTO
加解密/签名] + A[PAY-001
统一支付与结算网关] + B[PAY-002
渠道适配器] + C[PAY-003
银行适配器] + D[PAY-004
回调处理] + E[PAY-005
批量对账处理] + F[PAY-006
加解密/签名] end A -->|渠道路由| B @@ -3707,12 +3875,46 @@ graph TD ### 模块描述 -- PAY-GW 统一支付/代扣网关：统一鉴权、字段校验、限流熔断、幂等键与重放保护、灰度路由。 -- PAY-ADP-CH 渠道适配器：对接微信/支付宝/银联参数与签名规范适配、错误码转换。 -- PAY-ADP-BANK 银行适配器：对接银行与第三方支付协议，签名/验签、编码转换（GBK/UTF-8）、SFTP/HTTP文件交互、错误码映射。 -- PAY-CB 回调处理：回调验签、状态对齐、失败重试与告警。 -- PAY-RECON 对账处理：定时拉取/解析对账文件、差异识别、冲正/补记建议、对账报告生成、追踪链路与告警。 -- PAY-CRYPTO 加解密/签名：国密/商密算法、密钥轮换、硬件加密机对接（可选）。 +#### PAY-001: 统一支付/代扣网关 + +- 统一入口鉴权与字段校验 +- 基础保护机制 +- 幂等键与重放攻击保护 +- 简单路由与流量分发 + +#### PAY-002: 渠道适配器 + +- 微信/支付宝/银联参数适配 +- 签名规范统一处理 +- 错误码标准化转换 +- 渠道响应格式统一 + +#### PAY-003: 银行适配器 + +- 银行与第三方支付协议对接 +- 签名验签与编码转换（GBK/UTF-8） +- SFTP/HTTP文件交互处理 +- 错误码映射与异常处理 + +#### PAY-004: 回调处理 + +- 支付回调验签确认 +- 订单状态同步对齐 +- 失败重试与异常告警 +- 回调幂等与去重处理 + +#### PAY-005: 对账处理 + +- 银行对账文件定时拉取解析 +- 差异识别与异常记录 +- 冲正/补记建议生成 +- 对账报告与追踪链路告警 + +#### PAY-006: 加解密/签名 + +- 国密/商密算法支持 +- 密钥管理与定期轮换 +- 数据安全传输保障 # 子系统10设计: 消息服务子系统 @@ -3758,8 +3960,8 @@ graph TD | 接口编号 | 接口名称 | 功能描述 | 接口协议 | 输入参数 | 输出结果 | |---|---|---|---|---|---| -| MSG-001 | 消息推送接口 | 发送消息通知 | HTTP/REST | 消息内容、接收用户 | 推送结果 | -| MSG-002 | 消息接收接口 | 接收消息请求 | HTTP/REST | 消息类型、接收用户 | 处理结果 | +| IF-MSG-001 | 消息推送接口 | 发送消息通知 | HTTP/REST | 消息内容、接收用户 | 推送结果 | +| IF-MSG-002 | 消息接收接口 | 接收消息请求 | HTTP/REST | 消息类型、接收用户 | 处理结果 | ### 设计方案概述 @@ -3794,28 +3996,26 @@ graph TB | 模块编号 | 模块名称 | 功能描述 | 开发优先级 | |---|---|---|---| -| MSG-GW | 消息网关模块 | 统一接入、鉴权、路由、限流、幂等控制 | 高 | -| MSG-SMS | 短信服务模块 | 短信发送、回执处理、失败重试、供应商适配 | 高 | -| MSG-EMAIL | 邮件服务模块 | 邮件发送、附件管理、批量发送、回执处理 | 高 | -| MSG-INTERNAL | 站内信模块 | 站内信管理、用户消息推送、已读状态跟踪 | 中 | -| MSG-WECHAT | 微信通知模块 | 微信模板消息、公众号推送通知 | 中 | -| MSG-PUSH | 移动推送模块 | App消息推送、推送回执、设备管理 | 中 | -| MSG-TEMPLATE | 模板管理模块 | 消息模板管理、变量替换、多语言支持 | 中 | -| MSG-EXTERNAL | 外部系统适配模块 | 对接OA、智水擎、水投数科app等数科系统 | 低 | +| MSG-001 | 消息网关模块 | 统一接入、鉴权、路由、幂等控制 | 高 | +| MSG-002 | 短信服务模块 | 短信发送、回执处理、失败重试、供应商适配 | 高 | +| MSG-003 | 邮件服务模块 | 邮件发送、附件管理、批量发送、回执处理 | 高 | +| MSG-004 | 站内信模块 | 站内信管理、用户消息推送、已读状态跟踪 | 中 | +| MSG-005 | 微信通知模块 | 微信模板消息、公众号推送通知 | 中 | +| MSG-006 | 模板管理模块 | 消息模板管理、固定模板维护 | 中 | +| MSG-007 | 外部系统适配模块 | 对接OA、智水擎、水投数科app等数科系统 | 低 | ### 模块间关系 ```mermaid graph TD subgraph "消息服务子系统模块关系" - A[MSG-GW
消息网关模块] - B[MSG-SMS
短信服务模块] - C[MSG-EMAIL
邮件服务模块] - D[MSG-INTERNAL
站内信模块] - E[MSG-WECHAT
微信通知模块] - F[MSG-PUSH
移动推送模块] - G[MSG-TEMPLATE
模板管理模块] - H[MSG-EXTERNAL
外部系统适配模块] + A[MSG-001
消息网关模块] + B[MSG-002
短信服务模块] + C[MSG-003
邮件服务模块] + D[MSG-004
站内信模块] + E[MSG-005
微信通知模块] + F[MSG-006
模板管理模块] + G[MSG-007
外部系统适配模块] end %% 核心流程 @@ -3823,24 +4023,21 @@ graph TD A -->|邮件路由| C A -->|站内信路由| D A -->|微信路由| E - A -->|推送路由| F - A -->|外部系统路由| H + A -->|外部系统路由| G %% 模板服务 - G -->|短信模板| B - G -->|邮件模板| C - G -->|站内信模板| D - G -->|微信模板| E - G -->|推送模板| F - G -->|外部模板| H + F -->|短信模板| B + F -->|邮件模板| C + F -->|站内信模板| D + F -->|微信模板| E + F -->|外部模板| G %% 回执反馈 B -.->|短信回执| A C -.->|邮件回执| A D -.->|已读状态| A E -.->|微信回执| A - F -.->|推送回执| A - H -.->|外部回执| A + G -.->|外部回执| A %% 样式定义 classDef gatewayModule fill:#e3f2fd,stroke:#1976d2,stroke-width:3px @@ -3849,21 +4046,61 @@ graph TD classDef externalModule fill:#e8f5e8,stroke:#388e3c,stroke-width:2px class A gatewayModule - class B,C,D,E,F channelModule - class G templateModule - class H externalModule + class B,C,D,E channelModule + class F templateModule + class G externalModule ``` ### 模块描述 -- MSG-GW 消息网关模块：统一接入、鉴权、路由、限流、幂等控制。 -- MSG-SMS 短信服务模块：短信发送、回执处理、失败重试、供应商适配。 -- MSG-EMAIL 邮件服务模块：邮件发送、附件管理、批量发送、回执处理。 -- MSG-INTERNAL 站内信模块：站内信管理、用户消息推送、已读状态跟踪。 -- MSG-WECHAT 微信通知模块：微信模板消息、公众号推送 -- MSG-PUSH 移动推送模块：App消息推送、推送回执、设备管理。 -- MSG-TEMPLATE 模板管理模块：消息模板管理、变量替换、多语言支持。 -- MSG-EXTERNAL 外部系统适配模块：对接OA、智水擎、水投数科app等数科系统。 +#### MSG-001: 消息网关模块 + +- 统一消息接入与鉴权 +- 简单路由与负载均衡 +- 基础保护机制 +- 幂等控制与防重复发送 + +#### MSG-002: 短信服务模块 + +- 短信发送与供应商适配 +- 回执状态处理与确认 +- 失败重试与补偿机制 +- 短信固定内容管理 + +#### MSG-003: 邮件服务模块 + +- 邮件发送与附件管理 +- 批量邮件处理能力 +- 回执跟踪与状态确认 +- SMTP服务器配置管理 + +#### MSG-004: 站内信模块 + +- 站内消息推送管理 +- 用户消息中心维护 +- 已读/未读状态跟踪 +- 消息分类与过滤 + +#### MSG-005: 微信通知模块 + +- 微信模板消息发送 +- 公众号推送通知 +- 微信API接口对接 +- 推送结果状态回执 + +#### MSG-006: 模板管理模块 + +- 消息模板统一管理 +- 固定模板内容维护 +- 模板版本控制 +- 多渠道模板适配 + +#### MSG-007: 外部系统适配模块 + +- OA系统消息对接 +- 智水擎系统通知集成 +- 水投数科app消息推送 +- 外部API接口适配 # 非功能性需求的设计 diff --git a/福建水务营收系统整体架构图.html b/福建水务营收系统整体架构图.html index cb92768..14d30ce 100644 --- a/福建水务营收系统整体架构图.html +++ b/福建水务营收系统整体架构图.html @@ -3,7 +3,7 @@ - 福建水务营收系统整体架构图 v1.6 + 福建水务营收系统整体架构图 v1.7