docs: align module numbering with architecture

This commit is contained in:
tangweijie 2026-03-18 15:09:59 +08:00
parent cc5d9e3fe7
commit 958c05d0fc
15 changed files with 469 additions and 123 deletions

View File

@ -133,6 +133,12 @@
| 2026-03-12 | OMX 多 Agent 治理层落地 | 1在根 `AGENTS.md` 中新增 OMX 多 Agent 协作补充,明确分层 AGENTS、任务路由矩阵、写冲突规则、范围控制基线与 worktree/tmux 约定2新增 `backend/AGENTS.md`,固化 backend 开发边界、最小实现策略与 BPM 接入规则3新增 `docs/design/04_Appendix/Archive/AGENTS.md`,明确 Archive 默认只读与来源回写规则4新增 `docs/design/00_Management/16_OMX_Multi_Agent_Guide.md`,统一 leader / writer / executor / verifier 分工与协作拓扑5更新 `00_Management/README.md` 收录新指南入口。 | 用户明确准备采用 `oh-my-codex` 进行多 Agent 开发,需要对现有 AGENTS 体系做分层化和路由化改造,避免现有规则在 Team Mode 下失效。 | 正面影响,当前项目从“单 agent 规则完备”提升为“多 agent 可控协作”;后续接入 OMX 时,目录级职责、写权限边界、范围基线与会话约定已经成型,可显著降低并发改稿和多 worker 写冲突风险。 |
| 2026-03-12 | REV-004 一期执行手册与 worktree/tmux 启动脚本落地 | 1新增 `docs/guides/REV004_ACCOUNTING_EXECUTION_PLAYBOOK.md`,将 `REV-004` 一期的范围、现状差距、最小改动方案、任务拆解、Codex Prompt 与验收清单固化为可执行手册2新增 `scripts/start-backend-codex-session.sh`,支持在 `backend/` 上创建或复用 worktree并拉起 `tmux + codex` 三窗口开发会话3更新 `scripts/README.md` 记录脚本用途。 | 用户要求不仅给建议,还要把“如何规划执行、如何进入 worktree、如何在 tmux 场景下协作”落成可直接使用的资产。 | 正面影响,开发启动动作从“口头建议”变为“可复制执行”;后续围绕 `REV-004/REV-003/REV-008` 的闭环开发可直接复用该脚本和手册,降低 worktree、tmux、Codex 协作的起步成本与操作偏差。 |
| 2026-03-13 | REV-004 一期范围正式文档收敛US1 | 1更新 `docs/design/02_Detailed_Design/12_REV_Detailed.md`,将 REV-004 一期范围收敛为水量调整、金额调整、退款、冲正、坏账申请五类场景并明确共性能力优先顺序、排除项与审批边界2重写 `docs/guides/REV004_ACCOUNTING_EXECUTION_PLAYBOOK.md`,将其从 backend 执行导向收敛为正式文档修订执行手册3同步 `docs/design/01_Overview/03_Summary_Design.md``specs/001-rev004-accounting/contracts/rev004-traceability-matrix.md` 的范围摘要与追溯说明4执行目标文档 `make validate-file``make check-links` 校验并通过。 | 用户要求在 implement 阶段先完成 REV-004 一期正式文档范围收敛,不把 backend 代码实现写成本轮已完成内容。 | 正面影响REV-004 一期边界、验收入口与追溯关系已在正式文档体系内闭环,后续 US2/US3 可直接在稳定范围上继续对齐接口、数据库与台账,不再受早期执行手册偏代码导向表述干扰。 |
| 2026-03-18 | 完成全仓旧模块编号残留审计 | 1新增 `docs/design/00_Management/18_Old_Module_Number_Audit.md`,对 `docs/design``docs/guides``specs` 中的 `METER-004``INST-004``INST-005` 及相关旧模块语义进行全仓审计2将命中项分为“必须修”“可保留历史描述”“Archive 原始资料”“合法保留的接口编号/子能力表达”四类3更新 `docs/design/00_Management/README.md` 收录审计清单入口。 | 用户要求执行全仓旧编号残留审计,明确哪些需要继续修、哪些应作为历史资料保留。 | 正面影响,后续旧编号治理从“按检索临时判断”转为“按清单分类处理”;正式文档、管理台账与 Archive 的处理边界更加清晰。 |
| 2026-03-18 | 旧模块编号残留收口与追溯链接修正 | 1更新 `docs/design/02_Detailed_Design/03_CA_Esignature_Supplement.md`,将文档定位从旧 `INST-004` 修正为 `INST-002 工程管理` 下的“合同签署与电子签章能力”专项补充2修正 `docs/design/02_Detailed_Design/02_Module_Traceability_Index.md``INST-002``INST-003` 的章节锚点确保跳转与当前三段式模块结构一致3复核 `docs/design/01_Overview/03_Summary_Design.md` 的主口径章节,确认残留 `IF-METER-004``IF-INST-004/005` 均为接口编号而非旧模块编号。 | 用户要求继续收口“旧编号视为错误”的相关正式文档,并区分必须修项与可保留历史描述。 | 正面影响,正式文档层的模块编号、追溯入口与专项补充挂接关系进一步统一,评审和检索时不会再因旧 `INST-004/005` 模块语义误跳转。 |
| 2026-03-18 | 基于整体架构图补齐模块清单并对齐详细设计承接关系 | 1新增 `docs/design/01_Overview/05_Module_Inventory.md`将整体架构图中的分层、子系统、模块与当前详设承接关系整理为统一清单2更新 `docs/design/01_Overview/README.md``docs/design/02_Detailed_Design/README.md`明确该清单作为模块枚举与承接核对入口3更新 `docs/design/02_Detailed_Design/01_Detailed_Design.md``docs/design/02_Detailed_Design/02_Module_Traceability_Index.md`,补充架构图模块清单与当前详设之间的映射说明,明确 `WECHAT-*``MOBILE-*``WORK-*` 等模块当前按业务域正文或协同能力承接。 | 用户要求根据 `output/preview/福建水务营收系统整体架构图.html` 形成模块清单,并以此为基线对齐 `02_Detailed_Design` 目录。 | 正面影响,架构图中的模块枚举与详细设计现状之间建立了稳定映射,后续评审时可直接判断“哪些模块已有正文、哪些是协同承接、哪些仍停留在架构层列示”,减少按图追文时的歧义。 |
| 2026-03-18 | 第二轮详细设计模块命名精对齐 | 1更新 `docs/design/02_Detailed_Design/13_CS_Detailed.md`,补充 `CS-*``WECHAT-*` 的模块映射说明并在章节标题中显式标注对应关系2更新 `docs/design/02_Detailed_Design/14_METER_Detailed.md`,明确架构图 `METER-001~003` 与当前四段式详设之间的映射3更新 `docs/design/02_Detailed_Design/15_INST_Detailed.md`,明确架构图三段式 `INST-*` 与当前五段式详设拆分之间的对应关系。 | 用户要求继续进行第二轮对齐,使详细设计正文与架构图模块名之间的对应关系更直接。 | 正面影响,评审者在查看模块正文时可直接识别“架构图编号 ↔ 详设章节”的关系,不需要在模块清单、主详设和正文之间来回换算。 |
| 2026-03-18 | 按“现有编号错误”原则修复表务与报装模块编号 | 1`14_METER_Detailed.md` 的正式模块编号修正为与架构图一致的 `METER-001 ~ METER-003`,并把表务工单、物联网同步降为 `METER-003` 下的子能力章节2`15_INST_Detailed.md` 的正式模块编号修正为与架构图一致的 `INST-001 ~ INST-003`并把踏勘方案、合同签章改为对应模块下的子能力章节3同步更新 `01_Detailed_Design.md``02_Module_Traceability_Index.md``05_Module_Inventory.md` 的模块摘要和追溯引用。 | 用户明确要求不再把现有编号视为“可映射差异”,而是按“编号错误”直接修复。 | 正面影响,`02_Detailed_Design` 目录中的正式模块编号已与整体架构图一致,后续评审、检索和跨文档引用不再需要额外做编号换算。 |
| 2026-03-18 | 同步修复接口设计与概要设计中的旧模块归属口径 | 1更新 `docs/design/03_Technical_Design/03_Interface_Design.md`,将 `IF-METER-002/003/004``IF-INST-002/003/004/005` 的归属模块同步到修正后的 `METER-001 ~ 003``INST-001 ~ 003` 体系2更新 `docs/design/01_Overview/03_Summary_Design.md` 中仍残留的旧 `IF-METER-004``IF-INST-005` 描述使其与接口主文档和架构图一致3补齐 `docs/design/02_Detailed_Design/01_Detailed_Design.md``docs/design/02_Detailed_Design/02_Module_Traceability_Index.md` 中尚未收口的范围描述。 | 用户要求把剩余相关文档一起修复,避免只改详细设计而其余专题仍保留旧编号。 | 正面影响,概要、详设、接口三层文档的模块归属口径已基本统一,后续查询接口归属和模块责任时不会再遇到新旧编号并存。 |
| 2026-03-12 | 工作范围对齐 `营业收费管理系统-概要设计说明书20250912` 基线 | 1`docs/design/04_Appendix/Archive/03_Design_Docs/营业收费管理系统-概要设计说明书20250912.docx` 转换为 `docs/design/04_Appendix/Archive/03_Design_Docs/营业收费管理系统-概要设计说明书20250912.md` 并抽取配套图片目录2`docs/design/01_Overview/03_Summary_Design.md` 补充历史来源对齐说明3`docs/design/01_Overview/01_System_Overview.md``docs/design/00_Management/08_AI_Agent_Maintenance_SOP.md``docs/design/00_Management/10_AI_Retrieval_Whitelist.md` 固化“工作范围以主文档与该 Archive 基线交集为准”的控制规则4更新 Archive 索引与附录入口。 | 用户明确要求后续工作范围与 `营业收费管理系统-概要设计说明书20250912.md` 对齐,避免设计与开发准备超出当前项目边界。 | 正面影响,后续文档补完、开发拆分和 AI Agent 执行时有了明确的范围控制基线;既能使用该历史稿进行边界收敛,又不会把历史名称、别名编号和旧接口体系直接带回正式主文档。 |
| 2026-03-12 | `Database/Interface` 迁移闭环 P0 补完 | 对两份技术主文档继续执行旧系统迁移闭环补完1`docs/design/03_Technical_Design/01_Database_Design.md``SYS-002 开账、收费与票据表` 后新增“旧系统历史台账迁移与只读查询口径”明确在线主模型承接范围、历史只读保留范围与迁移验收最低对账口径2`docs/design/03_Technical_Design/03_Interface_Design.md` 新增“历史查询与迁移校验接口口径”,将历史查询和迁移验收统一挂靠到既有 `IF-REV/CS/METER` 接口族3执行两份文档单文件校验并通过。 | 用户同意继续把迁移分析结论同步到数据库和接口主文档,形成从模块正文到技术主稿的闭环。 | 正面影响,`REV/CS/METER` 已补完的迁移口径不再停留在分模块正文,数据库和接口主文档已同步约束“哪些进在线模型、哪些保留历史只读、验收时按什么口径对账”;本周开发与迁移评审可直接以主文档为准,减少实现阶段对旧系统细粒度对象的误判。 |
| 2026-03-12 | `REV/CS/METER` 旧系统迁移缺口 P0 补完 | 基于 `docs/design/00_Management/15_Legacy_Migration_Gap_Analysis.md`对三份分模块详细设计执行旧系统迁移口径补完1`12_REV_Detailed.md` 增补定额共享/核定、特殊开账、柜台结账、红冲、发票关系、催缴停水、银行托收与微信配置等迁移说明2`13_CS_Detailed.md` 增补业务进度、开票方式变更、微客服后台设置与业务字段配置并补充对应核心数据与接口映射3`14_METER_Detailed.md` 增补业务清单、上报清单、问题回填、代办工单、停复水工单、水表检定及出入退废库等迁移设计4执行三份文档单文件校验并通过。 | 用户要求按迁移差异清单继续推进,把本周开发前必须补齐的 `REV/CS/METER` 模块缺口收敛为可开发设计。 | 正面影响,营收、客户服务、表务三大业务链路已从“主能力存在但迁移承接不足”提升为“旧功能承接方式、历史保留策略、实现入口与接口映射可追溯”;本周围绕账务、渠道、工单联动启动开发时,缺少旧系统语义承接导致的返工风险显著降低。 |

View File

@ -213,6 +213,22 @@
- [x] 新增 `15_SYS002_Requirement_Breakdown.md`,形成 `SYS002-REQ-001 ~ 015` 的统一需求拆解口径 ✅
- [x] 基于 `backend/sw-business``backend/sw-business-bank` 输出已实现 / 部分实现 / 未见实现评估结果 ✅
- [x] 形成 TAPD Story/Task 转换建议,可直接用于后续 TAPD 建模与跟踪 ✅
- [x] **完成整体架构图模块清单整理与详细设计承接对齐** ✅ (2026-03-18)
- [x] 新增 `docs/design/01_Overview/05_Module_Inventory.md`,整理整体架构图中的层级、子系统、模块与当前详设承接关系 ✅
- [x] 更新 `01_Overview/README.md``02_Detailed_Design/README.md`,明确模块清单作为模块枚举与承接核对入口 ✅
- [x] 更新 `01_Detailed_Design.md``02_Module_Traceability_Index.md`,补充 `WECHAT-*``MOBILE-*``WORK-*` 等架构图模块与当前详设正文之间的映射说明 ✅
- [x] **完成第二轮详细设计模块命名精对齐** ✅ (2026-03-18)
- [x] `13_CS_Detailed.md` 已补充 `CS-*``WECHAT-*` 的映射说明,并在章节标题中显式标注对应关系 ✅
- [x] `14_METER_Detailed.md` 已补充架构图 `METER-001~003` 与当前四段式详设之间的映射说明 ✅
- [x] `15_INST_Detailed.md` 已补充架构图三段式 `INST-*` 与当前五段式详设拆分之间的映射说明 ✅
- [x] **完成表务与报装模块编号纠偏修复** ✅ (2026-03-18)
- [x] `14_METER_Detailed.md` 的正式模块编号已修正为 `METER-001 ~ METER-003`,原 `METER-004` 降为子能力章节 ✅
- [x] `15_INST_Detailed.md` 的正式模块编号已修正为 `INST-001 ~ INST-003`,原 `INST-004 ~ INST-005` 降为子能力章节 ✅
- [x] `01_Detailed_Design.md``02_Module_Traceability_Index.md``05_Module_Inventory.md` 已同步更新模块摘要与链接引用 ✅
- [x] **完成接口设计与概要设计剩余旧编号清理** ✅ (2026-03-18)
- [x] `03_Interface_Design.md` 已将 `IF-METER-*``IF-INST-*` 的归属模块同步到修正后的编号体系 ✅
- [x] `03_Summary_Design.md` 中残留的 `IF-METER-004``IF-INST-005` 旧描述已回收至与接口主文档一致 ✅
- [x] `01_Project_Progress.md` 已记录本轮“详设 + 接口 + 概要”同步纠偏结果 ✅
### 📋 工作范围基线对齐
@ -259,6 +275,20 @@
- [x] 新增 `IF-INST-001/002/004/005` 的关键接口说明与字段级请求/响应定义 ✅
- [x] 统一主表映射、状态口径与 `last_reviewed` 日期 ✅
### 📋 旧模块编号残留收口
- [x] **完成正式文档中 `INST` 旧模块语义的残留收口** ✅ (2026-03-18)
- [x] 修正 `03_CA_Esignature_Supplement.md` 的文档定位,不再引用旧 `INST-004` 模块 ✅
- [x] 修正 `02_Module_Traceability_Index.md``INST-002``INST-003` 的章节跳转锚点 ✅
- [x] 复核 `03_Summary_Design.md` 主口径章节,确认保留项仅为 `IF-*` 接口编号,不再存在旧模块编号误用 ✅
### 📋 全仓旧编号残留审计
- [x] **完成全仓旧模块编号残留审计清单** ✅ (2026-03-18)
- [x] 新增 `18_Old_Module_Number_Audit.md`,覆盖 `docs/design``docs/guides``specs` 的旧编号扫描结果 ✅
- [x] 将命中项划分为“必须修”“可保留历史描述”“Archive 原始资料”“合法保留项”四类 ✅
- [x] 明确当前正式主文档体系中已无新增必须修项 ✅
### 📋 `15_INST_Detailed` 模板同步补完
- [x] **完成报装与签章模块结构与追溯增强** ✅ (2026-03-12)

View File

@ -0,0 +1,106 @@
# 福建水务营收系统旧模块编号残留审计
## 审计信息
| 项目 | 内容 |
|---|---|
| 审计日期 | 2026-03-18 |
| 审计范围 | `docs/design``docs/guides``specs` |
| 审计目标 | 识别 `METER-004``INST-004``INST-005` 及其旧模块语义残留并区分“必须修”“可保留历史描述”“Archive 原始资料” |
| 审计原则 | 接口编号保留、正式模块编号纠偏、历史台账不篡改、Archive 默认只读 |
## 审计口径
本轮审计按以下规则判定:
1. `IF-METER-004``IF-INST-004``IF-INST-005` 属于接口编号,不视为旧模块编号错误。
2. `合同签署与电子签章能力` 作为 `INST-002 工程管理` 下的子能力表达,允许保留。
3. 正式文档中如果仍把 `INST-004``INST-005``METER-004` 当作当前正式模块编号使用,判定为“必须修”。
4. 管理台账、历史进度记录、既往任务记录中反映当时版本状态的内容,判定为“可保留历史描述”。
5. `docs/design/04_Appendix/Archive/` 下原始资料默认不改归类为“Archive 原始资料”。
## 审计结论摘要
| 类别 | 结论 |
|---|---|
| 必须修 | 0 项 |
| 可保留历史描述 | 9 项 |
| Archive 原始资料 | 8 项 |
| 合法保留的接口编号/子能力表达 | 已在正式文档中复核,无需修订 |
结论说明:
- 当前正式设计主文档体系中,未再发现把 `METER-004``INST-004``INST-005` 当作当前正式模块编号使用的残留。
- 正式文档中的命中项主要为接口编号引用,以及 `INST-002` 下“合同签署与电子签章能力”这一合法子能力表达。
- 需要继续保留关注的内容主要集中在管理台账中的历史记录表述,以及 Archive 原始资料中的旧口径。
## A. 必须修
本轮未发现新增“必须修”项。
说明:
- `docs/design/01_Overview``docs/design/02_Detailed_Design``docs/design/03_Technical_Design` 已复核。
- 当前命中均可解释为接口编号、当前子能力标题或已修正后的正确归属。
## B. 可保留历史描述
以下内容命中了旧编号或旧模块语义,但属于历史任务记录、阶段进度记录或当时版本状态说明,不建议直接改写历史事实:
| 文件 | 位置 | 命中内容 | 判定 |
|---|---|---|---|
| `docs/design/00_Management/03_Task_Checklist.md` | `#L289` | `INST-001~INST-005` 覆盖范围 | 历史任务描述 |
| `docs/design/00_Management/03_Task_Checklist.md` | `#L290` | `INST-001~INST-005` 模块补充 | 历史任务描述 |
| `docs/design/00_Management/03_Task_Checklist.md` | `#L298` | `METER-001~METER-004` 覆盖范围 | 历史任务描述 |
| `docs/design/00_Management/03_Task_Checklist.md` | `#L299` | `METER-001~METER-004` 模块补充 | 历史任务描述 |
| `docs/design/00_Management/03_Task_Checklist.md` | `#L301` | `METER-004` 关键规则 | 历史任务描述 |
| `docs/design/00_Management/03_Task_Checklist.md` | `#L1002` | `表务工单管理完整设计` | 历史命名残留 |
| `docs/design/00_Management/01_Project_Progress.md` | `#L146` | `INST-001~INST-005` 结构补完 | 历史进度记录 |
| `docs/design/00_Management/01_Project_Progress.md` | `#L147` | `METER-001~METER-004` 结构补完 | 历史进度记录 |
| `docs/design/00_Management/01_Project_Progress.md` | `#L234``#L247` | `表务工单管理` 等旧模块语义 | 历史方案演进记录 |
处理建议:
- 不直接改写原记录正文。
- 如后续需要对外输出“当前口径版台账”,应新增“历史口径说明”列或单独生成摘要,不覆盖原始进度记录。
## C. Archive 原始资料
以下内容位于 Archive属于需求原文、整合草稿或原始附件应保留原始口径
| 文件 | 位置 | 命中内容 | 判定 |
|---|---|---|---|
| `docs/design/04_Appendix/Archive/07_Integration/表务管理整合.md` | `#L5` | `表务工单管理系统` | 原始整合资料 |
| `docs/design/04_Appendix/Archive/07_Integration/表务水表功能整合.md` | `#L31` | `表务工单管理系统` | 原始整合资料 |
| `docs/design/04_Appendix/Archive/01_Requirements/营收系统_需求规格说明书.md` | `#L961` | `表务工单管理系统` | 原始需求资料 |
| `docs/design/04_Appendix/Archive/01_Requirements/202-营业收费管理系统需求规格说明书20240415.md` | `#L1150` | `表务工单管理系统` | 原始需求资料 |
| `docs/design/04_Appendix/Archive/01_Requirements/202-营业收费管理系统需求规格说明书20240412.md` | `#L1150` | `表务工单管理系统` | 原始需求资料 |
| `docs/design/04_Appendix/Archive/04_Original_Attachments/营收系统_需求规格说明书.md` | `#L771` | `表务工单管理系统` | 原始附件 |
| `docs/design/04_Appendix/Archive/04_Original_Attachments/202-营业收费管理系统需求规格说明书20240415.md` | `#L955` | `表务工单管理系统` | 原始附件 |
| `docs/design/04_Appendix/Archive/04_Original_Attachments/202-营业收费管理系统需求规格说明书20240412.md` | `#L955` | `表务工单管理系统` | 原始附件 |
处理建议:
- 保留原文,不在 Archive 内直接做“统一口径式”改写。
- 若正式文档需要引用这些资料,应通过当前主文档重新释义,而不是复用旧称谓。
## D. 正式文档中的合法保留项
以下命中项已复核,属于当前正确表达,不应误判为旧模块编号残留:
| 文件 | 典型位置 | 说明 |
|---|---|---|
| `docs/design/03_Technical_Design/03_Interface_Design.md` | `#L299``#L308``#L309` | `IF-METER-004``IF-INST-004``IF-INST-005` 为接口编号 |
| `docs/design/02_Detailed_Design/01_Detailed_Design.md` | `#L529``#L538``#L539` | 主详设接口总表中的接口编号引用 |
| `docs/design/02_Detailed_Design/02_Module_Traceability_Index.md` | `#L103``#L105``#L106` | 模块到接口的追溯引用,不是旧模块编号 |
| `docs/design/02_Detailed_Design/14_METER_Detailed.md` | `#L53``#L144``#L189` | `METER-003` 下引用 `IF-METER-004` |
| `docs/design/02_Detailed_Design/15_INST_Detailed.md` | `#L52``#L53``#L194``#L297` | `INST-002/003` 下引用 `IF-INST-004/005`,以及“合同签署与电子签章能力”子能力标题 |
| `docs/design/02_Detailed_Design/03_CA_Esignature_Supplement.md` | `#L27``#L88` | 已明确挂接到 `INST-002`,接口编号保留正常 |
| `docs/design/01_Overview/03_Summary_Design.md` | `#L938``#L3269``#L3375``#L3376` | 概要设计中的接口表保留接口编号正常 |
| `docs/design/02_Detailed_Design/12_REV_Detailed.md` | `#L197` | `REV-002` 开账链路对 `IF-METER-004` 的依赖引用正常 |
## 后续建议
1. 若需要对外给出“当前编号口径说明”,建议基于本清单单独输出一份“历史口径对照摘要”,不要直接改写历史台账。
2. 后续新增管理台账时,涉及旧版本范围可在正文后追加“该条为历史版本记录”说明,降低误读。
3. 后续如继续做全仓术语治理,可把“表务工单管理”等历史称谓纳入统一的“历史别名表”,仅做映射,不进入正式主稿。

View File

@ -20,6 +20,7 @@
- `12_AI_Weekly_Audit_Template.md`:每周抽检模板
- `13_AI_Weekly_Audit_2026W11.md`:首次周检记录示例
- `14_AI_Audit_Diff_Latest.md`自动化差异清单P2
- `18_Old_Module_Number_Audit.md`:旧模块编号残留审计清单
## 使用顺序(建议)

View File

@ -437,7 +437,7 @@ graph TB
**外部系统External Systems**
- CA电子签章用于报装资料签署、验章与存证INST-004 签章回执接口
- CA电子签章用于报装资料签署、验章与存证当前归属 `INST-002` 工程管理
- 银行托收代扣、回盘与对账经SYS-009
- 支付渠道:微信/支付宝/银联聚合等经SYS-009
- 发票供应商:航天/博思等税控平台经SYS-008
@ -3266,7 +3266,7 @@ graph TD
| IF-METER-001 | 库存查询接口 | 查询仓库库存状态和预警信息 | 工单/营收/报装系统 | HTTP/REST | 仓库编号、水表型号、库存状态 | 库存明细、预警状态、可用数量 |
| IF-METER-002 | 领用出库接口 | 支持换表/施工水表领用出库 | 工单管理系统 | HTTP/REST | 领用单号、水表型号、领用数量、领用人 | 出库状态、库存余量、领用凭证 |
| IF-METER-003 | 档案查询接口 | 查询水表设备档案信息 | 营收/工单/报装系统 | HTTP/REST | 水表编号、客户编号、查询类型 | 设备档案、安装历史、维修记录 |
| IF-METER-004 | 设备入库接口 | 新水表采购入库登记 | 采购管理系统 | HTTP/REST | 水表信息、入库数量、供应商信息 | 入库结果、库存更新状态 |
| IF-METER-004 | 集抄数据接收接口 | 接收远传抄表、异常告警并同步状态 | 物联网平台 | HTTP/REST | 设备标识、采集时间、读数值、告警信息 | 接收结果、校验状态、异常标记 |
| IF-METER-005 | 资产调拨接口 | 仓库间水表调拨转移 | 表务管理系统 | HTTP/REST | 调出仓库、调入仓库、调拨清单 | 调拨状态、库存变更结果 |
| IF-METER-006 | 盘点核实接口 | 定期盘点和库存核实 | 表务管理系统 | HTTP/REST | 盘点计划、盘点范围、盘点人员 | 盘点结果、差异分析、调整建议 |
@ -3373,7 +3373,7 @@ graph TD
| IF-INST-002 | 踏勘派工接口 | 现场踏勘任务派发 | 工单管理系统 | HTTP/REST | 报装单号、踏勘要求、预约时间 | 派工结果、踏勘人员、预计完成时间 |
| IF-INST-003 | 签章接口 | 调用CA系统进行电子签章 | CA电子签章系统 | HTTP/REST | 合同文档、签章类型、签章方信息 | 签章状态、签章文档、存证信息 |
| IF-INST-004 | 签章回执接口 | 接收CA系统签章完成回执 | CA电子签章系统 | HTTP/REST | 签章任务ID、签章结果、时间戳 | 接收确认、存档状态 |
| IF-INST-005 | 施工派工接口 | 安装施工任务派发 | 工单管理系统 | HTTP/REST | 报装单号、施工方案、材料清单 | 派工状态、施工队伍、开工时间 |
| IF-INST-005 | 报装归档接口 | 归档申请、合同、验收与签章回执资料 | 报装系统 | HTTP/REST | 报装单号、资料清单、签章回执、验收文档 | 归档状态、档案编号、存储位置 |
| IF-INST-006 | 验收通水接口 | 验收合格并开通供水 | 营收业务系统 | HTTP/REST | 报装单号、验收结果、水表信息 | 开户结果、客户编号、通水状态 |
| IF-INST-007 | 档案归档接口 | 竣工档案归档管理 | 档案管理系统 | HTTP/REST | 报装单号、竣工资料、验收文档 | 归档状态、档案编号、存储位置 |

View File

@ -0,0 +1,146 @@
---
doc_id: OV-05-MODULE-INVENTORY
doc_role: support_document
authority: secondary
scope: 总体设计-模块清单
source_of_truth: false
last_reviewed: 2026-03-18
retrieval_priority: P1
---
# 福建水务营收系统模块清单
## 文档定位
本文档基于 `output/preview/福建水务营收系统整体架构图.html` 提炼系统分层、子系统与模块清单,用于提供:
1. 总体设计层的统一模块索引;
2. 详细设计目录的模块承接基线;
3. 后续对齐概要设计、详细设计、接口设计与数据库设计时的编号核对入口。
边界说明:
- 本文档只整理模块清单与承接关系,不替代 `03_Summary_Design.md` 的正式概要口径;
- 详细模块正文以 `../02_Detailed_Design/` 下主详设与模块正文为准;
- 基础服务子系统 `SYS-008``SYS-009``SYS-010` 在当前仓库中主要按“协同对象 / 外部能力”表达,不在详细设计层虚增平行主稿。
## 来源说明
| 来源 | 用途 |
| --- | --- |
| `output/preview/福建水务营收系统整体架构图.html` | 提取架构图中的层级、子系统、模块与集成关系 |
| `03_Summary_Design.md` | 核对系统名称、模块编号与当前正式口径 |
| `../02_Detailed_Design/01_Detailed_Design.md` | 核对详细设计当前已承接的模块范围 |
| `../02_Detailed_Design/02_Module_Traceability_Index.md` | 核对模块到接口/数据域的追溯入口 |
## 分层总览
| 层级 | 当前对象 |
| --- | --- |
| 表现层 | Web 管理端、手机抄表 APP、`SYS-004` 微网厅子系统、移动收费端 |
| 网关层 | API 网关、负载均衡、统一认证中心、监控日志 |
| 业务服务层 | `SYS-001` 统一平台、`SYS-002` 营收业务子系统、`SYS-003` 手机抄表 APP、`SYS-004` 微网厅子系统、`SYS-005` 工单管理子系统、`SYS-006` 表务管理子系统、`SYS-007` 报装业务子系统 |
| 基础服务层 | 权限服务、工作流引擎、消息队列、注册/配置中心、任务调度、文件服务、`SYS-008` 发票服务子系统、`SYS-009` 支付与银行结算子系统、`SYS-010` 消息服务子系统、摄像表 AI 系统(外部) |
| 数据层 | 达梦数据库主库、达梦数据库从库、Redis 缓存、MinIO 对象存储、备份存储 |
## 子系统模块清单
### SYS-001 统一平台
| 模块编号 | 模块名称 | 模块职责 | 详细设计承接 |
| --- | --- | --- | --- |
| `UP-001` | 单点登录模块 | OAuth2.0 + CAS、JWT 令牌认证、多种登录方式 | [11_UP_Detailed.md](../02_Detailed_Design/11_UP_Detailed.md) |
| `UP-002` | 系统管理模块 | 用户角色、部门组织、菜单权限配置 | [11_UP_Detailed.md](../02_Detailed_Design/11_UP_Detailed.md) |
| `UP-003` | 权限控制模块 | RBAC、菜单权限、数据权限 | [11_UP_Detailed.md](../02_Detailed_Design/11_UP_Detailed.md) |
| `UP-004` | 租户管理模块 | 多租户数据隔离、租户配置管理 | [11_UP_Detailed.md](../02_Detailed_Design/11_UP_Detailed.md) |
| `UP-005` | 系统监控模块 | 在线用户、性能监控、操作日志 | 当前并入统一平台运维支撑能力,在 [11_UP_Detailed.md](../02_Detailed_Design/11_UP_Detailed.md) 与技术专项中协同表达 |
### SYS-002 营收业务子系统
| 模块编号 | 模块名称 | 模块职责 | 详细设计承接 |
| --- | --- | --- | --- |
| `REV-001` | 客户资料管理 | 客户档案、分组管理、信息变更 | [12_REV_Detailed.md](../02_Detailed_Design/12_REV_Detailed.md) |
| `REV-002` | 抄表开账 | 抄表录入、复核开账、异常处理 | [12_REV_Detailed.md](../02_Detailed_Design/12_REV_Detailed.md) |
| `REV-003` | 营业收费 | 柜台收费、移动收费、在线缴费 | [12_REV_Detailed.md](../02_Detailed_Design/12_REV_Detailed.md) |
| `REV-004` | 账务处理 | 调账、退款、坏账处理 | [12_REV_Detailed.md](../02_Detailed_Design/12_REV_Detailed.md) |
| `REV-005` | 发票管理 | 开票、查询、作废,经 `SYS-008` 协同 | [12_REV_Detailed.md](../02_Detailed_Design/12_REV_Detailed.md) |
| `REV-006` | 催缴管理 | 欠费统计、催缴通知、停水管理 | [12_REV_Detailed.md](../02_Detailed_Design/12_REV_Detailed.md) |
| `REV-007` | 统计分析 | 多维统计、报表分析 | [12_REV_Detailed.md](../02_Detailed_Design/12_REV_Detailed.md) |
| `REV-008` | 代收业务 | 银行代扣、聚合支付,经 `SYS-009` 协同 | [12_REV_Detailed.md](../02_Detailed_Design/12_REV_Detailed.md) |
| `REV-009` | 业务参数配置 | 水价体系、水表参数、基础配置 | [12_REV_Detailed.md](../02_Detailed_Design/12_REV_Detailed.md) |
| `CS-001` ~ `CS-007` | 客户服务模块群 | 账户绑定、查询、缴费、电子发票、网点、业务办理、柜面扫码支付 | [13_CS_Detailed.md](../02_Detailed_Design/13_CS_Detailed.md) |
### SYS-003 手机抄表 APP
| 模块编号 | 模块名称 | 模块职责 | 详细设计承接 |
| --- | --- | --- | --- |
| `MOBILE-001` | 登录认证 | 机构编号、用户名密码、自动登录、令牌管理 | 当前按“移动作业端 / 抄表协同端”表达,能力散落在 [12_REV_Detailed.md](../02_Detailed_Design/12_REV_Detailed.md)、[14_METER_Detailed.md](../02_Detailed_Design/14_METER_Detailed.md) |
| `MOBILE-002` | 首页搜索 | 多维搜索、最近记录、任务快捷入口 | 同上 |
| `MOBILE-003` | 采集任务管理 | 任务列表、批量下载、单户采集、AI 识别、读数校验 | 同上 |
| `MOBILE-004` | 现场上报 | 异常上报、图片与定位采集、提交工单 | 同上 |
| `MOBILE-005` | 个人与设置 | 个人资料、偏好设置、缓存管理、安全退出 | 同上 |
| `MOBILE-006` | 数据同步 | 任务包增量同步、离线数据上传、冲突处理 | 同上 |
### SYS-004 微网厅子系统
| 模块编号 | 模块名称 | 模块职责 | 详细设计承接 |
| --- | --- | --- | --- |
| `WECHAT-001` | 账户绑定管理 | 微信授权、绑定解绑、多账户管理 | 当前与 `CS-001` 对齐承接于 [13_CS_Detailed.md](../02_Detailed_Design/13_CS_Detailed.md) |
| `WECHAT-002` | 信息查询服务 | 账单查询、用水历史、缴费记录、停水公告 | 当前与 `CS-002` 对齐承接于 [13_CS_Detailed.md](../02_Detailed_Design/13_CS_Detailed.md) |
| `WECHAT-003` | 在线缴费服务 | 快捷缴费、充值、多种支付方式 | 当前与 `CS-003` 对齐承接于 [13_CS_Detailed.md](../02_Detailed_Design/13_CS_Detailed.md) |
| `WECHAT-004` | 电子发票服务 | 发票查看、推送、电子发票管理 | 当前与 `CS-004` 对齐承接于 [13_CS_Detailed.md](../02_Detailed_Design/13_CS_Detailed.md) |
| `WECHAT-005` | 营业网点服务 | 网点查询、地图导航、预约服务 | 当前与 `CS-005` 对齐承接于 [13_CS_Detailed.md](../02_Detailed_Design/13_CS_Detailed.md) |
| `WECHAT-006` | 业务办理服务 | 联系方式/开票方式变更、更名过户、低保、换表、自主抄表 | 当前与 `CS-006` 对齐承接于 [13_CS_Detailed.md](../02_Detailed_Design/13_CS_Detailed.md) |
| `WECHAT-007` | 账户流水 | 历史缴费流水查询与导出 | 当前并入 `CS-002` 信息查询服务表达 |
| `WECHAT-008` | 账号与机构管理 | 切换机构、添加解绑客户、默认客户设置 | 当前并入 `CS-001` 账户绑定管理表达 |
### SYS-005 工单管理子系统
| 模块编号 | 模块名称 | 模块职责 | 详细设计承接 |
| --- | --- | --- | --- |
| `WORK-001` | 工单中心 | 统一受理、路由、分派、跟踪 | 当前按协同能力出现在 [13_CS_Detailed.md](../02_Detailed_Design/13_CS_Detailed.md)、[14_METER_Detailed.md](../02_Detailed_Design/14_METER_Detailed.md)、[15_INST_Detailed.md](../02_Detailed_Design/15_INST_Detailed.md) |
| `WORK-002` | 流程引擎 | 条件路由、并行/互斥网关、回退重审 | 当前作为流程支撑能力表达,不单列详设正文 |
| `WORK-003` | 监控预警 | 实时看板、超时预警、积压监控 | 当前并入运维/流程协同能力表达 |
| `WORK-004` | 绩效统计 | 处理时长分析、达成率统计、考核报表 | 当前并入统计与报表能力表达 |
### SYS-006 表务管理子系统
| 模块编号 | 模块名称 | 模块职责 | 详细设计承接 |
| --- | --- | --- | --- |
| `METER-001` | 表务基础管理 | 厂家、型号、口径、量程、检定周期等参数标准化 | [14_METER_Detailed.md](../02_Detailed_Design/14_METER_Detailed.md) |
| `METER-002` | 仓库与库存管理 | 入库、出库、盘点、调拨、库存预警 | [14_METER_Detailed.md](../02_Detailed_Design/14_METER_Detailed.md) |
| `METER-003` | 设备档案管理 | 唯一档案、状态流转、批次与质检记录追溯 | [14_METER_Detailed.md](../02_Detailed_Design/14_METER_Detailed.md) |
### SYS-007 报装业务子系统
| 模块编号 | 模块名称 | 模块职责 | 详细设计承接 |
| --- | --- | --- | --- |
| `INST-001` | 报装流程管理 | 端到端阶段流转、里程碑控制 | [15_INST_Detailed.md](../02_Detailed_Design/15_INST_Detailed.md) |
| `INST-002` | 工程管理 | 进度、资源、质量、安全管理,支持合同签订与电子签章 | [15_INST_Detailed.md](../02_Detailed_Design/15_INST_Detailed.md) |
| `INST-003` | 档案管理 | 资料归档、过程留痕、竣工档案、CA 签章/验章/存证 | [15_INST_Detailed.md](../02_Detailed_Design/15_INST_Detailed.md) |
### 基础服务子系统与外部能力
| 对象 | 模块职责 | 当前文档承接 |
| --- | --- | --- |
| `SYS-008` 发票服务子系统 | 统一开票网关、供应商适配器、发票管理、回执处理 | 概要层、接口设计、发票相关详细设计协同描述 |
| `SYS-009` 支付与银行结算子系统 | 聚合支付、代扣业务、资金清算、安全加密 | 概要层、接口设计、收费/代收相关详细设计协同描述 |
| `SYS-010` 消息服务子系统 | 统一消息网关、模板管理、微信通知、外部集成 | 概要层、接口设计、催缴/通知/客户服务协同描述 |
| 摄像表 AI 系统(外部) | 水表图像识别、读数识别、API 协同 | 概要层与抄表 / 表务协同描述 |
## 详细设计承接原则
1. 架构图中的模块清单可作为“模块枚举基线”,但不等同于必须一一拆出平行详设文档。
2. 当前 `02_Detailed_Design` 采用“业务域正文 + 追溯索引”的组织方式,允许多个架构层模块映射到同一详设正文。
3. `MOBILE-*``WECHAT-*``WORK-*` 目前以“渠道能力 / 协同能力 / 支撑能力”方式承接,不单独新增正式主稿。
4. 若后续需要把某一模块升级为独立详细设计正文,应先确认其已具备稳定边界、独立接口与核心数据域。
## 与详细设计的对齐建议
| 对齐对象 | 建议动作 |
| --- | --- |
| `../02_Detailed_Design/01_Detailed_Design.md` | 明确该主详设基于本模块清单承接哪些模块、哪些采用合并承接 |
| `../02_Detailed_Design/02_Module_Traceability_Index.md` | 增加“架构图模块编号 → 当前详设承接位置”的映射说明 |
| `../02_Detailed_Design/13_CS_Detailed.md` | 明确 `CS-*``WECHAT-*` 的对齐关系 |
| `../02_Detailed_Design/14_METER_Detailed.md` | 保持 `METER-001 ~ METER-003` 与架构图一致,多余内容降为子能力章节 |
| `../02_Detailed_Design/15_INST_Detailed.md` | 保持 `INST-001 ~ INST-003` 与架构图一致,多余内容降为子能力章节 |

View File

@ -12,6 +12,7 @@
| `02_System_Architecture.md` | 总体架构说明(分层、技术栈、边界) | 与主文档架构口径保持一致 |
| `03_Summary_Design.md` | **概要设计主文档(单一真源)** | 优先维护;涉及范围变更时同步其余文档 |
| `04_System_Diagrams.md` | 图谱文档(图文配套) | 只维护图示与图注,不重复大段正文 |
| `05_Module_Inventory.md` | 模块清单(架构图模块枚举与详设承接映射) | 用于模块编号核对与详设对齐,不替代概要主稿 |
## 与目录外文档的关系
@ -24,6 +25,7 @@
2. `01_System_Overview.md`(查看背景与术语)
3. `02_System_Architecture.md`(查看架构细节)
4. `04_System_Diagrams.md`(对照图示核对一致性)
5. `05_Module_Inventory.md`(核对子系统与模块承接关系)
## 维护规则

View File

@ -98,11 +98,13 @@ retrieval_priority: P0
12. `docs/design/03_Technical_Design/04_Security_Design.md`
13. `docs/design/03_Technical_Design/05_Deployment_Design.md`
14. 福建水投相关业务操作手册及需求说明资料
15. `docs/design/01_Overview/05_Module_Inventory.md`
<a id="sec-module-files"></a>
## 模块正文文件索引
- 总体层模块清单与承接映射:`docs/design/01_Overview/05_Module_Inventory.md`
- 统一平台模块正文:`docs/design/02_Detailed_Design/11_UP_Detailed.md`
- 营收业务模块正文:`docs/design/02_Detailed_Design/12_REV_Detailed.md`
- 客户服务模块正文:`docs/design/02_Detailed_Design/13_CS_Detailed.md`
@ -233,10 +235,17 @@ graph TB
|---|---|---|
| 统一平台 | 提供统一认证、组织、权限、参数、审计与监控基础能力 | UP-001 ~ UP-004 |
| 营收业务 | 覆盖客户、抄表、收费、账务、发票、催缴、统计、代收与业务工单 | REV-001 ~ REV-009 |
| 表务管理 | 覆盖水表档案、表务工单、仓储、生命周期与物联网接入 | METER-001 ~ METER-004 |
| 报装与签章 | 覆盖受理、踏勘、施工、签约、电子签章、归档 | INST-001 ~ INST-005 |
| 表务管理 | 覆盖水表基础参数、仓储库存、设备档案以及工单和物联网同步等支撑能力 | METER-001 ~ METER-003 |
| 报装与签章 | 覆盖报装流程管理、工程管理、档案管理及其下挂签章归档能力 | INST-001 ~ INST-003 |
| 客户服务模块 | 覆盖账户绑定、信息查询、在线缴费、电子发票、网点服务、业务办理与柜面扫码支付 | CS-001 ~ CS-007 |
### 与架构图模块清单的承接说明
1. 架构图中的模块枚举基线以 `../01_Overview/05_Module_Inventory.md` 为准。
2. 当前详细设计采用“业务域正文承接多个架构层模块”的组织方式,不强制为 `MOBILE-*``WECHAT-*``WORK-*` 单独建立平行正式主稿。
3. `WECHAT-*` 当前按客户服务渠道视角并入 `CS-*` 体系承接;`MOBILE-*` 当前作为抄表与表务协同端能力分散承接于营收与表务正文;`WORK-*` 当前作为工单协同与流程支撑能力在客户服务、表务、报装正文中交叉引用。
4. 若后续需要新增独立正文,必须先确认该模块已具备稳定边界、独立接口和核心数据域,并同步更新概要设计与追溯索引。
<a id="sec-module-detail"></a>
<a id="sec-platform-detail"></a>
@ -322,9 +331,8 @@ graph TB
| 模块编号 | 模块名称 | 设计摘要 | 正文链接 |
|---|---|---|---|
| `METER-001` | 表务基础管理 | 水表档案、状态与参数基础管理 | [METER-001](./14_METER_Detailed.md#mod-meter-001) |
| `METER-002` | 表务工单管理 | 换表、移表、校表、维修等工单处理 | [METER-002](./14_METER_Detailed.md#mod-meter-002) |
| `METER-003` | 仓储与生命周期管理 | 入出库、退库、报废与生命周期追踪 | [METER-003](./14_METER_Detailed.md#mod-meter-003) |
| `METER-004` | 物联网接入与数据同步 | 集抄与IoT数据接入、同步与异常处理 | [METER-004](./14_METER_Detailed.md#mod-meter-004) |
| `METER-002` | 仓库与库存管理 | 入库、出库、退库、报废与库存预警 | [METER-002](./14_METER_Detailed.md#mod-meter-002) |
| `METER-003` | 设备档案管理 | 设备主档、状态流转、工单协同与远传同步 | [METER-003](./14_METER_Detailed.md#mod-meter-003) |
## 正文入口
@ -342,11 +350,9 @@ graph TB
| 模块编号 | 模块名称 | 设计摘要 | 正文链接 |
|---|---|---|---|
| `INST-001` | 报装申请与受理 | 多入口申请受理、资料采集与流程发起 | [INST-001](./15_INST_Detailed.md#mod-inst-001) |
| `INST-002` | 现场踏勘与方案设计 | 踏勘记录、方案编制与版本化管理 | [INST-002](./15_INST_Detailed.md#mod-inst-002) |
| `INST-003` | 施工验收与立户通水 | 施工节点留痕、验收、立户通水协同 | [INST-003](./15_INST_Detailed.md#mod-inst-003) |
| `INST-004` | 合同签署与电子签章 | 合同签署、签章、时间戳与存证协同 | [INST-004](./15_INST_Detailed.md#mod-inst-004) |
| `INST-005` | 档案归档与过程留痕 | 材料归档、回执留存与过程可追溯 | [INST-005](./15_INST_Detailed.md#mod-inst-005) |
| `INST-001` | 报装流程管理 | 申请受理、踏勘流转与方案编制 | [INST-001](./15_INST_Detailed.md#mod-inst-001) |
| `INST-002` | 工程管理 | 施工验收、立户通水与合同签章协同 | [INST-002](./15_INST_Detailed.md#mod-inst-003) |
| `INST-003` | 档案管理 | 材料归档、签章回执留存与过程可追溯 | [INST-003](./15_INST_Detailed.md#mod-inst-005) |
## 正文入口

View File

@ -44,6 +44,7 @@ retrieval_priority: P1
2. 发现模块描述与接口/数据口径冲突时,以主详设为第一参照,并同步修订技术专项文档;
3. 本文档仅保留“可追溯最小必要信息”,不重复搬运完整设计正文;
4. 基础服务子系统SYS-008/009/010在详细设计层按接口协同描述不在此索引中虚增平行模块。
5. 架构图层面的完整模块枚举以 `../01_Overview/05_Module_Inventory.md` 为核对入口;本索引只保留当前详细设计实际承接的模块与必要映射说明。
<a id="sec-subsystem-matrix"></a>
@ -54,8 +55,22 @@ retrieval_priority: P1
| 统一平台 | `UP-001 ~ UP-004` | [统一平台模块正文](./11_UP_Detailed.md#sec-content) | [接口设计](../03_Technical_Design/03_Interface_Design.md)、[安全设计](../03_Technical_Design/04_Security_Design.md) |
| 营收业务 | `REV-001 ~ REV-009` | [营收业务模块正文](./12_REV_Detailed.md#sec-content) | [数据库设计](../03_Technical_Design/01_Database_Design.md)、[接口设计](../03_Technical_Design/03_Interface_Design.md) |
| 客户服务 | `CS-001 ~ CS-007` | [客户服务模块正文](./13_CS_Detailed.md#sec-content) | [接口设计](../03_Technical_Design/03_Interface_Design.md)、[安全设计](../03_Technical_Design/04_Security_Design.md) |
| 表务管理 | `METER-001 ~ METER-004` | [表务模块正文](./14_METER_Detailed.md#sec-content) | [数据库设计](../03_Technical_Design/01_Database_Design.md)、[接口设计](../03_Technical_Design/03_Interface_Design.md) |
| 报装与签章 | `INST-001 ~ INST-005` | [报装与签章模块正文](./15_INST_Detailed.md#sec-content) | [CA 补充说明](./03_CA_Esignature_Supplement.md)、[安全设计](../03_Technical_Design/04_Security_Design.md) |
| 表务管理 | `METER-001 ~ METER-003` | [表务模块正文](./14_METER_Detailed.md#sec-content) | [数据库设计](../03_Technical_Design/01_Database_Design.md)、[接口设计](../03_Technical_Design/03_Interface_Design.md) |
| 报装与签章 | `INST-001 ~ INST-003` | [报装与签章模块正文](./15_INST_Detailed.md#sec-content) | [CA 补充说明](./03_CA_Esignature_Supplement.md)、[安全设计](../03_Technical_Design/04_Security_Design.md) |
## 架构图模块承接映射
| 架构图对象 | 当前详设承接方式 | 说明 |
| --- | --- | --- |
| `UP-001 ~ UP-005` | `11_UP_Detailed.md` | `UP-005` 当前并入统一平台运维支撑能力表达 |
| `REV-001 ~ REV-009` | `12_REV_Detailed.md` | 与营收业务主链路一一对齐 |
| `CS-001 ~ CS-007` | `13_CS_Detailed.md` | 与客户服务正文一一对齐 |
| `WECHAT-001 ~ WECHAT-008` | `13_CS_Detailed.md` | 当前作为渠道侧映射,不单独拆出微网厅平行详设 |
| `MOBILE-001 ~ MOBILE-006` | `12_REV_Detailed.md` + `14_METER_Detailed.md` | 当前作为移动抄表 / 现场作业协同能力承接 |
| `WORK-001 ~ WORK-004` | 协同承接 | 当前在客户服务、表务、报装正文中按工单 / 流程支撑能力引用 |
| 架构图 `METER-001 ~ METER-003` | `14_METER_Detailed.md` | 当前详设已修正为与架构图一致的三段式编号,多余内容改为子能力章节 |
| 架构图 `INST-001 ~ INST-003` | `15_INST_Detailed.md` | 当前详设已修正为与架构图一致的三段式编号,多余内容改为子能力章节 |
| `SYS-008/009/010` | 接口与协同承接 | 当前不在详细设计目录新增平行主稿,主要在概要、接口和相关业务正文中描述 |
<a id="sec-module-matrix"></a>
@ -83,15 +98,12 @@ retrieval_priority: P1
| `CS-005` | 营业网点服务 | [章节](./13_CS_Detailed.md#mod-cs-005) | 网点信息、业务范围 | `IF-CS-005` | 客户渠道 |
| `CS-006` | 业务办理服务 | [章节](./13_CS_Detailed.md#mod-cs-006) | 办理申请、办理状态 | `IF-CS-006` | 工单系统、消息服务 |
| `CS-007` | 柜面扫码支付 | [章节](./13_CS_Detailed.md#mod-cs-007) | 柜面订单、流水、核销状态 | `IF-CS-007` | 营业厅、`SYS-009` |
| `METER-001` | 表务基础管理 | [章节](./14_METER_Detailed.md#mod-meter-001) | 水表档案、状态、参数 | `IF-METER-001` | 营收、报装 |
| `METER-002` | 表务工单管理 | [章节](./14_METER_Detailed.md#mod-meter-002) | 换表/移表工单、处理结果 | `IF-METER-002` | 工单系统、移动作业 |
| `METER-003` | 仓储与生命周期管理 | [章节](./14_METER_Detailed.md#mod-meter-003) | 库存、出入库、报废 | `IF-METER-003` | 仓储管理端 |
| `METER-004` | 物联网接入与数据同步 | [章节](./14_METER_Detailed.md#mod-meter-004) | 远程抄表数据、异常告警 | `IF-METER-004` | IoT 平台、营收开账 |
| `INST-001` | 报装申请与受理 | [章节](./15_INST_Detailed.md#mod-inst-001) | 申请单、资料附件 | `IF-INST-001` | 柜台、微网厅、政务 |
| `INST-002` | 现场踏勘与方案设计 | [章节](./15_INST_Detailed.md#mod-inst-002) | 踏勘记录、方案版本 | `IF-INST-002` | 报装人员 |
| `INST-003` | 施工验收与立户通水 | [章节](./15_INST_Detailed.md#mod-inst-003) | 施工节点、验收结果 | `IF-INST-005`(归档协同) | 表务、客户建档 |
| `INST-004` | 合同签署与电子签章 | [章节](./15_INST_Detailed.md#mod-inst-004) | 合同、签章、存证 | `IF-INST-003``IF-INST-004` | 泛微 CA |
| `INST-005` | 档案归档与过程留痕 | [章节](./15_INST_Detailed.md#mod-inst-005) | 档案、回执、过程日志 | `IF-INST-005` | 报装、档案管理 |
| `METER-001` | 表务基础管理 | [章节](./14_METER_Detailed.md#mod-meter-001) | 基础参数、水表主档、状态 | `IF-METER-001` | 营收、报装 |
| `METER-002` | 仓库与库存管理 | [章节](./14_METER_Detailed.md#mod-meter-002) | 库存、出入库、退库、报废 | `IF-METER-003` | 仓储管理端 |
| `METER-003` | 设备档案管理 | [章节](./14_METER_Detailed.md#mod-meter-003) | 设备档案、工单留痕、远程同步 | `IF-METER-001``IF-METER-002``IF-METER-004` | 工单系统、移动作业、IoT 平台 |
| `INST-001` | 报装流程管理 | [章节](./15_INST_Detailed.md#mod-inst-001) | 申请单、资料附件、踏勘方案 | `IF-INST-001``IF-INST-002` | 柜台、微网厅、政务、报装人员 |
| `INST-002` | 工程管理 | [章节](./15_INST_Detailed.md#mod-inst-002) | 施工节点、验收结果、签章协同 | `IF-INST-003``IF-INST-004``IF-INST-005` | 表务、客户建档、泛微 CA |
| `INST-003` | 档案管理 | [章节](./15_INST_Detailed.md#mod-inst-003) | 档案、回执、过程日志 | `IF-INST-005` | 报装、档案管理 |
<a id="sec-maintenance"></a>

View File

@ -24,7 +24,7 @@ retrieval_priority: P1
## 文档定位与边界
本文件是 `01_Detailed_Design.md``INST-004 合同签署与电子签章`的专项补充文档,重点补充:
本文件是 `01_Detailed_Design.md``INST-002 工程管理` 下“合同签署与电子签章能力”的专项补充文档,重点补充:
1. 泛微 CA 接口对接边界与字段约定;
2. 签章任务状态流转、异常补偿和运维观测点;
@ -169,4 +169,3 @@ stateDiagram-v2
1. 涉及 CA 字段或签名算法变更,需先更新本补充文档与接口设计文档;
2. 发布前执行联调清单:签署成功、签署失败、回执重放、超时补偿;
3. 发布后至少观察一个完整业务周期,确认签章成功率与回执时延稳定。

View File

@ -4,7 +4,7 @@ doc_role: module_body
authority: secondary
scope: 详细设计-客户服务
source_of_truth: false
last_reviewed: 2026-03-11
last_reviewed: 2026-03-18
retrieval_priority: P1
---
@ -13,6 +13,7 @@ retrieval_priority: P1
## 章节导航(精简)
- [文档定位](#sec-position)
- [架构图模块对齐说明](#sec-cs-alignment)
- [客户服务详细设计正文](#sec-content)
- [客户服务模块统一约束](#sec-cs-rules)
- [接口与数据追溯矩阵](#sec-cs-trace)
@ -30,6 +31,28 @@ retrieval_priority: P1
本文档为 `01_Detailed_Design.md` 中“客户服务模块详细设计”章节的模块正文拆分稿,便于按模块独立维护。正式交付口径以主详设为准。
<a id="sec-cs-alignment"></a>
## 架构图模块对齐说明
整体架构图中,客户渠道相关模块同时使用了 `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` | 当前并入账户绑定与账户切换能力 |
<a id="sec-content"></a>
# 客户服务模块详细设计
@ -62,7 +85,7 @@ retrieval_priority: P1
<a id="mod-cs-001"></a>
## CS-001 账户绑定管理
## CS-001 账户绑定管理(对齐 WECHAT-001 / WECHAT-008
### 功能说明
@ -93,7 +116,7 @@ retrieval_priority: P1
<a id="mod-cs-002"></a>
## CS-002 信息查询服务
## CS-002 信息查询服务(对齐 WECHAT-002 / WECHAT-007
### 功能说明
@ -127,7 +150,7 @@ retrieval_priority: P1
<a id="mod-cs-003"></a>
## CS-003 在线缴费服务
## CS-003 在线缴费服务(对齐 WECHAT-003
### 功能说明
@ -172,7 +195,7 @@ flowchart TD
<a id="mod-cs-004"></a>
## CS-004 电子发票服务
## CS-004 电子发票服务(对齐 WECHAT-004
### 功能说明
@ -204,7 +227,7 @@ flowchart TD
<a id="mod-cs-005"></a>
## CS-005 营业网点服务
## CS-005 营业网点服务(对齐 WECHAT-005
### 功能说明
@ -233,7 +256,7 @@ flowchart TD
<a id="mod-cs-006"></a>
## CS-006 业务办理服务
## CS-006 业务办理服务(对齐 WECHAT-006
### 功能说明

View File

@ -4,7 +4,7 @@ doc_role: module_body
authority: secondary
scope: 详细设计-表务管理
source_of_truth: false
last_reviewed: 2026-03-11
last_reviewed: 2026-03-18
retrieval_priority: P1
---
@ -17,9 +17,8 @@ retrieval_priority: P1
- [表务模块统一约束](#sec-meter-rules)
- [接口与数据追溯矩阵](#sec-meter-trace)
- [METER-001 表务基础管理](#mod-meter-001)
- [METER-002 表务工单管理](#mod-meter-002)
- [METER-003 仓储与生命周期管理](#mod-meter-003)
- [METER-004 物联网接入与数据同步](#mod-meter-004)
- [METER-002 仓库与库存管理](#mod-meter-002)
- [METER-003 设备档案管理](#mod-meter-003)
<a id="sec-position"></a>
@ -50,9 +49,8 @@ retrieval_priority: P1
| METER 模块 | 关键接口 | 核心数据域(摘要) | 主要协同对象 |
|---|---|---|---|
| METER-001 表务基础管理 | `IF-METER-001` | `biz_meter``biz_meter_model``biz_meter_caliber``biz_meter_range` | 营收、报装 |
| METER-002 表务工单管理 | `IF-METER-002` | `biz_meter_log``biz_process``biz_process_transfer` | 移动作业、工单流转 |
| METER-003 仓储与生命周期管理 | `IF-METER-003` | `biz_meter_in_out``biz_meter_in_out_rel``biz_meter` | 仓储管理端 |
| METER-004 物联网接入与数据同步 | `IF-METER-004` | `biz_meter_read``biz_reading_data``biz_last_reading` | IoT 平台、营收开账 |
| METER-002 仓库与库存管理 | `IF-METER-003` | `biz_meter_in_out``biz_meter_in_out_rel``biz_meter` | 仓储管理端 |
| METER-003 设备档案管理 | `IF-METER-001``IF-METER-002``IF-METER-004` | `biz_meter``biz_meter_log``biz_process*``biz_meter_read``biz_reading_data``biz_last_reading` | 工单系统、移动作业、IoT 平台、营收开账 |
<a id="mod-meter-001"></a>
@ -89,60 +87,16 @@ retrieval_priority: P1
<a id="mod-meter-002"></a>
## METER-002 表务工单管理
## METER-002 仓库与库存管理
### 功能说明
处理换表、移表、拆表、复装、校表、稽查、维修等表务工单。
### 业务流程
```mermaid
flowchart TD
A[创建表务工单] --> B[派发现场任务]
B --> C[现场处理并采集结果]
C --> D[回写旧表/新表信息]
D --> E[更新水表状态与客户绑定]
E --> F[写入过程日志与附件]
F --> G[工单办结]
```
### 关键设计
1. 工单类型决定必填字段、处理流程和附件要求。
2. 换表工单需同时记录旧表拆除信息与新表安装信息。
3. 表务工单完成后同步更新水表档案与客户绑定关系。
### 核心数据
- `biz_meter_log`:表务过程留痕。
- `biz_process`:工单流程主表。
- `biz_process_transfer`:转办与流转记录。
- `biz_meter`:表计状态回写对象。
### 接口映射
- `IF-METER-002`:换表、移表、校表、维修等处理结果提交。
- `IF-CS-006`:客户渠道办理结果与表务工单协同。
### 落地边界
- **已落地**:表务工单过程留痕、流程流转与状态回写能力。
- **部分落地**:不同工单类型的细化节点主要依赖流程配置,不一定全部存在独立业务表。
- **文档先行**:复杂多部门并行会签和跨区域协同不宣称为当前独立实现模块。
<a id="mod-meter-003"></a>
## METER-003 仓储与生命周期管理
### 功能说明
管理新表入库、领用、出库、退库、报废及全生命周期追踪。
管理新表入库、领用、出库、退库、报废及库存预警,是架构图中“仓库与库存管理”模块的正式承接章节。
### 关键设计
1. 库存动作以批次和明细双层结构记录,支持领用、退库、报废等全过程追溯。
2. 水表生命周期状态与库存动作联动更新,避免“账上在库、现场在用”不一致。
2. 库存状态与设备生命周期联动更新,避免“账上在库、现场在用”不一致。
3. 报废、退库等高风险动作需保留审批或责任人留痕。
### 核心数据
@ -158,13 +112,46 @@ flowchart TD
### 落地边界
- **已落地**:出入库主明细、生命周期状态回写、动作留痕。
- **已落地**:出入库主明细、库存状态回写、动作留痕。
- **部分落地**:仓位优化、库龄分析等能力可能通过报表层实现,而非独立业务对象。
- **文档先行**:跨仓调拨优化和自动补货策略仅保留设计方向。
- **文档先行**:自动补货策略与仓网优化仅保留设计方向。
<a id="mod-meter-003"></a>
## METER-003 设备档案管理
### 功能说明
管理水表唯一电子档案、状态流转、安装历史、质检追溯,并统一承接表务工单和物联网同步相关能力。
### 关键设计
1. 一块水表对应唯一档案主记录,覆盖在库、在用、待检、故障、报废等状态。
2. 设备档案同时关联安装历史、维修记录、库存动作与最近有效读数,形成全生命周期追溯闭环。
3. 表务工单和远传同步能力属于设备档案管理下的实施态支撑能力,不再作为独立模块编号表达。
### 核心数据
- `biz_meter`:水表主档与状态主对象。
- `biz_meter_log`:设备过程留痕与工单回写对象。
- `biz_process``biz_process_transfer`:表务工单流程主线。
- `biz_meter_read``biz_reading_data``biz_last_reading`:读数、状态与同步对象。
### 接口映射
- `IF-METER-001`:查询水表档案、状态与生命周期信息。
- `IF-METER-002`:换表、移表、校表、维修等处理结果提交。
- `IF-METER-004`:远传抄表、告警与状态同步接收。
### 落地边界
- **已落地**:设备主档、状态流转、工单留痕、远传同步与异常标记能力。
- **部分落地**:质检批次、厂家评价、复杂设备健康评分等附属对象可能由扩展字段、附件或报表层承接。
- **文档先行**:预测性维护和实时控制指令不作为当前正式实现口径。
<a id="mod-meter-004"></a>
## METER-004 物联网接入与数据同步
### 物联网接入与数据同步能力
### 功能说明
@ -208,3 +195,27 @@ flowchart TD
- **已落地**:远传数据接入、基础校验、异常标记与读数同步。
- **部分落地**:复杂设备诊断与厂家私有协议适配更多由外部 IoT 平台承载。
- **文档先行**:边缘计算、实时控制指令等能力不作为当前正式实现口径。
<a id="mod-meter-002-workflow"></a>
### 表务工单协同能力
处理换表、移表、拆表、复装、校表、稽查、维修等表务工单,是 `METER-003` 设备档案管理的实施态过程能力。
#### 业务流程
```mermaid
flowchart TD
A[创建表务工单] --> B[派发现场任务]
B --> C[现场处理并采集结果]
C --> D[回写旧表/新表信息]
D --> E[更新水表状态与客户绑定]
E --> F[写入过程日志与附件]
F --> G[工单办结]
```
#### 关键规则
1. 工单类型决定必填字段、处理流程和附件要求。
2. 换表工单需同时记录旧表拆除信息与新表安装信息。
3. 工单完成后同步更新设备档案、客户绑定关系与安装历史。

View File

@ -4,7 +4,7 @@ doc_role: module_body
authority: secondary
scope: 详细设计-报装与签章
source_of_truth: false
last_reviewed: 2026-03-11
last_reviewed: 2026-03-18
retrieval_priority: P1
---
@ -16,11 +16,9 @@ retrieval_priority: P1
- [报装与签章详细设计正文](#sec-content)
- [报装模块统一约束](#sec-inst-rules)
- [接口与数据追溯矩阵](#sec-inst-trace)
- [INST-001 报装申请与受理](#mod-inst-001)
- [INST-002 现场踏勘与方案设计](#mod-inst-002)
- [INST-003 施工验收与立户通水](#mod-inst-003)
- [INST-004 合同签署与电子签章](#mod-inst-004)
- [INST-005 档案归档与过程留痕](#mod-inst-005)
- [INST-001 报装流程管理](#mod-inst-001)
- [INST-002 工程管理](#mod-inst-002)
- [INST-003 档案管理](#mod-inst-003)
<a id="sec-position"></a>
@ -50,19 +48,17 @@ retrieval_priority: P1
| INST 模块 | 关键接口 | 核心数据域(摘要) | 主要协同对象 |
|---|---|---|---|
| INST-001 报装申请与受理 | `IF-INST-001` | `biz_process``biz_content``biz_content_attach` | 柜台、微网厅、政务平台 |
| INST-002 现场踏勘与方案设计 | `IF-INST-002` | `biz_process_transfer``biz_business_datas` | 报装人员 |
| INST-003 施工验收与立户通水 | `IF-INST-005` | `biz_process_meter_install``biz_process``biz_meter` | 表务、客户建档 |
| INST-004 合同签署与电子签章 | `IF-INST-003``IF-INST-004` | `installation_contract``installation_signature``installation_evidence` | 泛微 CA |
| INST-005 档案归档与过程留痕 | `IF-INST-005` | `biz_content_attach``installation_evidence`、过程日志 | 报装、档案管理 |
| INST-001 报装流程管理 | `IF-INST-001``IF-INST-002` | `biz_process``biz_content``biz_content_attach``biz_process_transfer``biz_business_datas` | 柜台、微网厅、政务平台、报装人员 |
| INST-002 工程管理 | `IF-INST-003``IF-INST-004``IF-INST-005` | `biz_process_meter_install``biz_process``biz_meter``installation_contract``installation_signature``installation_evidence` | 表务、客户建档、泛微 CA |
| INST-003 档案管理 | `IF-INST-005` | `biz_content_attach``installation_evidence`、过程日志 | 报装、档案管理 |
<a id="mod-inst-001"></a>
## INST-001 报装申请与受
## INST-001 报装流程管
### 功能说明
支持新装、改造、一户一表等业务的申请受理、资料提交、受理审核与流程发起
承接新装、改造、一户一表等业务从申请受理到现场踏勘、方案编制的前半段主流程,是架构图中“报装流程管理”模块的正式承接章节
### 业务流程
@ -93,17 +89,18 @@ flowchart TD
### 接口映射
- `IF-INST-001`:提交报装申请、申请资料与附件。
- `IF-INST-002`:回填踏勘结果、方案、审核结果。
- `IF-CS-006`:客户渠道办理入口可复用报装申请主线。
### 落地边界
- **已落地**:申请受理主流程、资料与附件采集、流程实例创建。
- **部分落地**:不同报装类型的细化受理规则更多依赖流程和参数配置。
- **部分落地**:不同报装类型的细化受理规则、踏勘方案差异更多依赖流程和参数配置。
- **文档先行**`installation_application` 当前按设计态保留,不宣称为实施库既有事实表。
<a id="mod-inst-002"></a>
## INST-002 现场踏勘与方案设计
### 踏勘与方案设计能力
### 功能说明
@ -146,11 +143,11 @@ flowchart TD
<a id="mod-inst-003"></a>
## INST-003 施工验收与立户通水
## INST-002 工程管理
### 功能说明
完成施工派工、安装实施、竣工验收、立户建档和通水确认
承接施工派工、安装实施、竣工验收、立户通水以及合同签章协同,是架构图中“工程管理”模块的正式承接章节
### 业务流程
@ -181,6 +178,8 @@ flowchart TD
### 接口映射
- `IF-INST-005`:归档验收资料并提交最终办结信息。
- `IF-INST-003`:发起电子签章任务并传输合同信息。
- `IF-INST-004`:回写签章结果、时间戳和存证信息。
- `IF-METER-001``IF-METER-002`:装表与表务状态协同。
- `IF-REV-001`:立户后客户主档进入营收主数据域。
@ -192,7 +191,7 @@ flowchart TD
<a id="mod-inst-004"></a>
## INST-004 合同签署与电子签章
### 合同签署与电子签章能力
### 功能说明
@ -275,7 +274,7 @@ sequenceDiagram
<a id="mod-inst-005"></a>
## INST-005 档案归档与过程留痕
## INST-003 档案管理
### 功能说明

View File

@ -18,6 +18,11 @@
- `14_METER_Detailed.md`:表务模块正文
- `15_INST_Detailed.md`:报装与签章模块正文
## 上游对齐基线
- 总体层模块枚举与承接关系以 `../01_Overview/05_Module_Inventory.md` 作为核对入口;
- 当架构图中的模块名称与当前详设正文命名不完全一致时,应优先补充“映射说明”,而不是直接新建平行详设文件。
## 维护原则
- 详细设计应与概要设计、数据库设计、接口设计保持一致

View File

@ -294,19 +294,19 @@ retrieval_priority: P0
| 接口编号 | 接口名称 | 归属模块 | 主要用途 | 主要数据对象 |
|---------|----------|----------|----------|-------------|
| IF-METER-001 | 水表档案查询接口 | METER-001 | 查询水表档案、状态与生命周期信息 | `biz_meter``biz_meter_model``biz_meter_caliber``biz_meter_range` |
| IF-METER-002 | 表务工单处理接口 | METER-002 | 提交换表、移表、校表、维修等工单处理结果 | `biz_meter_log``biz_process``biz_process_transfer` |
| IF-METER-003 | 库存出入库接口 | METER-003 | 处理领用、退库、报废等库存动作 | `biz_meter_in_out``biz_meter_in_out_rel` |
| IF-METER-004 | 集抄数据接收接口 | METER-004 | 接收远传抄表、异常告警并同步状态 | `biz_reading_data``biz_meter_read``biz_last_reading` |
| IF-METER-002 | 表务工单处理接口 | METER-003 | 提交换表、移表、校表、维修等工单处理结果 | `biz_meter_log``biz_process``biz_process_transfer` |
| IF-METER-003 | 库存出入库接口 | METER-002 | 处理领用、退库、报废等库存动作 | `biz_meter_in_out``biz_meter_in_out_rel` |
| IF-METER-004 | 集抄数据接收接口 | METER-003 | 接收远传抄表、异常告警并同步状态 | `biz_reading_data``biz_meter_read``biz_last_reading` |
### INST 接口清单
| 接口编号 | 接口名称 | 归属模块 | 主要用途 | 主要数据对象 |
|---------|----------|----------|----------|-------------|
| IF-INST-001 | 报装申请提交接口 | INST-001 | 提交报装申请、附件与基础资料 | `biz_process``biz_content``biz_content_attach` |
| IF-INST-002 | 踏勘结果回填接口 | INST-002 | 回填现场踏勘、方案与审核结果 | `biz_process_transfer``biz_business_datas` |
| IF-INST-003 | 合同签署发起接口 | INST-004 | 发起电子签章任务并传输合同信息 | `installation_contract``installation_signature` |
| IF-INST-004 | 签章回执接口 | INST-004 | 回写签章结果、时间戳和存证信息 | `installation_signature``installation_evidence` |
| IF-INST-005 | 报装归档接口 | INST-005 | 归档申请、合同、验收与签章回执资料 | `biz_content_attach``installation_evidence` |
| IF-INST-002 | 踏勘结果回填接口 | INST-001 | 回填现场踏勘、方案与审核结果 | `biz_process_transfer``biz_business_datas` |
| IF-INST-003 | 合同签署发起接口 | INST-002 | 发起电子签章任务并传输合同信息 | `installation_contract``installation_signature` |
| IF-INST-004 | 签章回执接口 | INST-002 | 回写签章结果、时间戳和存证信息 | `installation_signature``installation_evidence` |
| IF-INST-005 | 报装归档接口 | INST-003 | 归档申请、合同、验收与签章回执资料 | `biz_content_attach``installation_evidence` |
## 关键内部接口说明
@ -542,7 +542,7 @@ retrieval_priority: P0
| 项目 | 说明 |
|------|------|
| 接口编号 | IF-METER-002 |
| 归属模块 | METER-002 |
| 归属模块 | METER-003 |
| 请求方式 | POST |
| 请求路径 | `/admin-api/meter/work-order/handle` |
| 功能描述 | 提交换表、移表、校表、维修等工单处理结果并回写设备状态 |
@ -553,7 +553,7 @@ retrieval_priority: P0
| 项目 | 说明 |
|------|------|
| 接口编号 | IF-METER-003 |
| 归属模块 | METER-003 |
| 归属模块 | METER-002 |
| 请求方式 | POST |
| 请求路径 | `/admin-api/meter/stock/in-out` |
| 功能描述 | 处理领用、退库、报废等库存动作并更新生命周期状态 |
@ -564,7 +564,7 @@ retrieval_priority: P0
| 项目 | 说明 |
|------|------|
| 接口编号 | IF-METER-004 |
| 归属模块 | METER-004 |
| 归属模块 | METER-003 |
| 请求方式 | POST |
| 请求路径 | `/admin-api/meter/iot/reading/receive` |
| 功能描述 | 接收远传抄表、设备状态和异常告警并同步读数状态 |
@ -586,7 +586,7 @@ retrieval_priority: P0
| 项目 | 说明 |
|------|------|
| 接口编号 | IF-INST-002 |
| 归属模块 | INST-002 |
| 归属模块 | INST-001 |
| 请求方式 | POST |
| 请求路径 | `/admin-api/installation/survey/result` |
| 功能描述 | 回填现场踏勘结果、方案版本和审核结论 |
@ -597,7 +597,7 @@ retrieval_priority: P0
| 项目 | 说明 |
|------|------|
| 接口编号 | IF-INST-003 |
| 归属模块 | INST-004 |
| 归属模块 | INST-002 |
| 请求方式 | POST |
| 请求路径 | `/admin-api/installation/contract/sign/initiate` |
| 功能描述 | 发起报装合同签署流程,并与 CA 系统协同处理签章、时间戳和存证 |
@ -608,7 +608,7 @@ retrieval_priority: P0
| 项目 | 说明 |
|------|------|
| 接口编号 | IF-INST-004 |
| 归属模块 | INST-004 |
| 归属模块 | INST-002 |
| 请求方式 | POST |
| 请求路径 | `/admin-api/installation/contract/sign/callback` |
| 功能描述 | 回写签章结果、时间戳、存证回执与签章文件地址 |
@ -619,7 +619,7 @@ retrieval_priority: P0
| 项目 | 说明 |
|------|------|
| 接口编号 | IF-INST-005 |
| 归属模块 | INST-005 |
| 归属模块 | INST-003 |
| 请求方式 | POST |
| 请求路径 | `/admin-api/installation/archive/submit` |
| 功能描述 | 归档申请资料、验收附件、合同文件与签章回执 |