From 12698c0f37b9a0b09efbc69333378e8fdbbb73d6 Mon Sep 17 00:00:00 2001 From: tangweijie <877588133@qq.com> Date: Thu, 12 Mar 2026 10:01:58 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=90=8C=E6=AD=A5INST=E6=A8=A1?= =?UTF-8?q?=E5=9D=97=E6=A8=A1=E6=9D=BF=E4=B8=8E=E5=BC=80=E5=8F=91=E9=97=AD?= =?UTF-8?q?=E7=8E=AF?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../00_Management/01_Project_Progress.md | 1 + .../design/00_Management/03_Task_Checklist.md | 9 ++ .../02_Detailed_Design/15_INST_Detailed.md | 152 +++++++++++++++++- 3 files changed, 159 insertions(+), 3 deletions(-) diff --git a/docs/design/00_Management/01_Project_Progress.md b/docs/design/00_Management/01_Project_Progress.md index 6656b86..1531876 100644 --- a/docs/design/00_Management/01_Project_Progress.md +++ b/docs/design/00_Management/01_Project_Progress.md @@ -114,6 +114,7 @@ > 说明：本表中的历史记录按当时原始表述保留；当前正式数据库口径统一以“达梦数据库 8.0+”为准。 +| 2026-03-12 | `15_INST_Detailed` 结构对齐补完（模板同步） | 对 `docs/design/02_Detailed_Design/15_INST_Detailed.md` 执行与 `REV/CS/METER` 同步的结构化补完：1）新增“报装模块统一约束”与“接口与数据追溯矩阵”；2）为 `INST-001~INST-005` 补充核心数据、接口映射与落地边界；3）为 `INST-001/002/003` 增加申请、踏勘、施工验收流程图；4）明确 `biz_process*`/`biz_content*` 为当前实现态口径，`installation_*` 为专题扩展口径。 | 用户要求优先补齐 `SYS-002` 文档内容，形成本周可直接支撑开发的闭环模块。 | 正面影响，`SYS-002` 四大业务模块正文结构统一，报装链路从受理到归档的开发边界更清晰；实现态与设计态口径分离后，可减少开发阶段对专题扩展表的误读。 | | 2026-03-11 | `14_METER_Detailed` 结构对齐补完（模板同步） | 对 `docs/design/02_Detailed_Design/14_METER_Detailed.md` 执行与 REV/CS 同步的结构化补完：1）新增“表务模块统一约束”与“接口与数据追溯矩阵”；2）为 `METER-001~METER-004` 补充核心数据、接口映射与落地边界；3）为 `METER-002` 增加工单处理流程图；4）为 `METER-004` 补充关键规则，明确 IoT 数据进入营收开账链路前的校验与异常处理边界。 | 用户要求继续同步分模块正文模板，提升表务模块评审可读性与跨文档追溯一致性。 | 正面影响，表务模块从简要提纲升级为可交付的结构化详细设计，设备档案、工单、库存、物联网接入与营收系统的协同边界更清晰，可降低联调与后续维护中的口径偏差。 | | 2026-03-11 | `13_CS_Detailed` 结构对齐补完（模板同步） | 对 `docs/design/02_Detailed_Design/13_CS_Detailed.md` 执行与 REV 同步的结构化补完：1）新增“客户服务模块统一约束”与“接口与数据追溯矩阵”；2）为 `CS-001~CS-007` 全模块补充“接口映射”；3）补充 `CS-005`、`CS-006` 核心数据与各模块落地边界；4）为 `CS-003`、`CS-007` 增加支付相关流程图，强化渠道侧到营收侧的协同链路表达。 | 用户要求继续将“统一约束 + 追溯矩阵 + 接口映射”模板同步到 `13_CS_Detailed.md`。 | 正面影响，客户服务模块文档结构与营收模块保持一致，接口追溯与评审路径更清晰；渠道受理与 `SYS-002/008/009/010` 协同边界明确，可降低后续改稿与联调阶段的口径偏差。 | | 2026-03-11 | `12_REV_Detailed` 设计补完（结构化增强） | 补完 `docs/design/02_Detailed_Design/12_REV_Detailed.md`：1）新增“营收模块统一约束”章节；2）新增“接口与数据追溯矩阵”，统一 `REV-001~REV-009` 对应 `IF-REV-*` 与核心数据域；3）为各 REV 模块补充“接口映射”段落；4）补齐 `REV-009` 缺失的“接口映射 + 落地边界”；5）为 `REV-004/005/006/008` 增加流程图，强化评审可读性与协同边界说明。 | 用户要求补完 `12_REV_Detailed.md`，并提升评审可交付性与跨文档追溯效率。 | 正面影响，营收模块正文从“说明型”提升为“可追溯、可评审、可维护”结构；接口、数据、协同边界更清晰，减少详细设计与接口/数据库专题之间的理解偏差。 | diff --git a/docs/design/00_Management/03_Task_Checklist.md b/docs/design/00_Management/03_Task_Checklist.md index db28924..5233e59 100644 --- a/docs/design/00_Management/03_Task_Checklist.md +++ b/docs/design/00_Management/03_Task_Checklist.md @@ -138,6 +138,15 @@ ## ✅ 最新完成任务 (持续更新) +### 📋 `15_INST_Detailed` 模板同步补完 + +- [x] **完成报装与签章模块结构与追溯增强** ✅ (2026-03-12) + - [x] 新增“报装模块统一约束”章节，明确流程主线、签章扩展和归档边界 ✅ + - [x] 新增“接口与数据追溯矩阵”，覆盖 `INST-001~INST-005` 的接口与数据域映射 ✅ + - [x] 为 `INST-001~INST-005` 全模块补充核心数据、接口映射与落地边界 ✅ + - [x] 为 `INST-001/002/003` 增加申请、踏勘、施工验收流程图 ✅ + - [x] 明确 `biz_process*`/`biz_content*` 为实现态、`installation_*` 为专题扩展口径 ✅ + ### 📋 `14_METER_Detailed` 模板同步补完 - [x] **完成表务模块结构与追溯增强** ✅ (2026-03-11) diff --git a/docs/design/02_Detailed_Design/15_INST_Detailed.md b/docs/design/02_Detailed_Design/15_INST_Detailed.md index ed27a2f..ea013cc 100644 --- a/docs/design/02_Detailed_Design/15_INST_Detailed.md +++ b/docs/design/02_Detailed_Design/15_INST_Detailed.md @@ -14,6 +14,8 @@ retrieval_priority: P1 - [文档定位](#sec-position) - [报装与签章详细设计正文](#sec-content) + - [报装模块统一约束](#sec-inst-rules) + - [接口与数据追溯矩阵](#sec-inst-trace) - [INST-001 报装申请与受理](#mod-inst-001) - [INST-002 现场踏勘与方案设计](#mod-inst-002) - [INST-003 施工验收与立户通水](#mod-inst-003) @@ -30,6 +32,30 @@ retrieval_priority: P1 # 报装与签章详细设计 + + +## 报装模块统一约束 + +1. 报装模块承担 `SYS-002` 中“申请受理、踏勘方案、施工验收、立户通水、合同签章、档案归档”的完整主流程，流程主线以 `biz_process*` 与 `biz_content*` 为当前实现态口径。 +2. 报装申请、踏勘结果、验收结果、签章回执、归档动作均必须通过流程节点驱动，不允许直接绕过业务过程修改主状态。 +3. 施工验收通过后，方可进入客户建档、水表绑定、账户初始化与通水确认，避免前后置业务状态错位。 +4. 电子签章专题表 `installation_*` 当前为“专题扩展口径”，若实施库结构与专题设计不一致，以实施库与主详设联合评审结果为准。 +5. 报装过程中的申请材料、验收附件、签章文件、存证回执必须统一归档并具备可检索、可追溯能力。 + + + +## 接口与数据追溯矩阵 + +> 说明：接口字段以 `../03_Technical_Design/03_Interface_Design.md` 为准，数据库口径以 `../03_Technical_Design/01_Database_Design.md` 为准。 + +| 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 报装申请与受理 @@ -38,12 +64,43 @@ retrieval_priority: P1 支持新装、改造、一户一表等业务的申请受理、资料提交、受理审核与流程发起。 +### 业务流程 + +```mermaid +flowchart TD + A[提交报装申请] --> B[采集申请信息与附件] + B --> C[受理校验] + C --> D{是否通过} + D -->|否| E[退回补充资料] + D -->|是| F[生成报装编号] + F --> G[创建流程实例] + G --> H[进入踏勘环节] +``` + ### 关键设计 - 统一采集申请人、地址、产权、用水性质、附件材料等信息。 - 支持政务平台、柜台、微网厅等多入口申请。 - 受理后自动生成报装编号并进入踏勘流程。 +### 核心数据 + +- `biz_process`：报装流程主表。 +- `biz_content`：申请资料主对象。 +- `biz_content_attach`：申请附件。 +- `installation_application`：报装申请映射对象（设计态）。 + +### 接口映射 + +- `IF-INST-001`：提交报装申请、申请资料与附件。 +- `IF-CS-006`：客户渠道办理入口可复用报装申请主线。 + +### 落地边界 + +- **已落地**：申请受理主流程、资料与附件采集、流程实例创建。 +- **部分落地**：不同报装类型的细化受理规则更多依赖流程和参数配置。 +- **文档先行**：`installation_application` 当前按设计态保留，不宣称为实施库既有事实表。 + ## INST-002 现场踏勘与方案设计 @@ -52,12 +109,41 @@ retrieval_priority: P1 组织现场勘查、工程条件确认、材料测算、施工方案与费用方案编制。 +### 业务流程 + +```mermaid +flowchart TD + A[接收踏勘任务] --> B[现场勘查与拍照] + B --> C[记录供水条件与施工约束] + C --> D[编制方案与费用] + D --> E[提交审核] + E --> F{审核是否通过} + F -->|否| G[退回修改] + F -->|是| H[进入施工或合同环节] +``` + ### 关键设计 1. 踏勘记录包括现场照片、供水接入条件、施工难点、估算费用。 2. 方案版本化管理，支持设计审核与退回修改。 3. 勘查结果直接驱动合同金额与施工计划。 +### 核心数据 + +- `biz_process_transfer`：节点流转与处理记录。 +- `biz_business_datas`：踏勘与方案扩展数据。 +- `biz_content_attach`：现场照片与附件资料。 + +### 接口映射 + +- `IF-INST-002`：回填踏勘结果、方案、审核结果。 + +### 落地边界 + +- **已落地**：踏勘流转、扩展数据回填、现场资料挂接。 +- **部分落地**：材料测算、工程造价等可能在扩展数据或外部附件中承载。 +- **文档先行**：复杂 BIM/预算系统联动不作为当前正式实现口径。 + ## INST-003 施工验收与立户通水 @@ -66,12 +152,44 @@ retrieval_priority: P1 完成施工派工、安装实施、竣工验收、立户建档和通水确认。 +### 业务流程 + +```mermaid +flowchart TD + A[下发施工任务] --> B[现场安装实施] + B --> C[录入装表与施工结果] + C --> D[提交竣工验收] + D --> E{验收是否通过} + E -->|否| F[整改后复验] + E -->|是| G[触发客户建档与水表绑定] + G --> H[初始化账户并确认通水] +``` + ### 关键设计 - 施工节点按派工、实施、验收、归档逐步留痕。 - 验收通过后自动触发客户建档、水表绑定和账户初始化。 - 与表务系统共享水表安装与换表数据。 +### 核心数据 + +- `biz_process`：施工与验收流程主线。 +- `biz_process_meter_install`：装表落地信息。 +- `biz_meter`：水表安装与状态回写对象。 +- `biz_cust`、`biz_account`：立户后续创建对象。 + +### 接口映射 + +- `IF-INST-005`：归档验收资料并提交最终办结信息。 +- `IF-METER-001`、`IF-METER-002`：装表与表务状态协同。 +- `IF-REV-001`：立户后客户主档进入营收主数据域。 + +### 落地边界 + +- **已落地**：施工验收主线、装表结果留痕、客户建档与水表绑定协同。 +- **部分落地**：施工派工计划与现场资源调度可能由外部施工管理工具承载。 +- **文档先行**：复杂工程项目管理和材料成本结转不作为当前正式开发边界。 + ## INST-004 合同签署与电子签章 @@ -132,9 +250,10 @@ sequenceDiagram | 数据对象 | 说明 | |---|---| -| `installation_contract` | 报装合同主表 | -| `installation_signature` | 电子签章记录表 | -| `installation_evidence` | 电子存证记录表 | +| `installation_contract` | 报装合同主表（设计态专题扩展） | +| `installation_signature` | 电子签章记录表（设计态专题扩展） | +| `installation_evidence` | 电子存证记录表（设计态专题扩展） | +| `installation_signature_template` | 签章模板与签署位置配置 | ### 关键规则 @@ -143,6 +262,17 @@ sequenceDiagram 3. 签署完成文件必须归档并生成可验证凭证。 4. 外部 CA 接口异常时应支持重试与人工补偿处理。 +### 接口映射 + +- `IF-INST-003`：发起合同签署任务并传递合同信息。 +- `IF-INST-004`：回写签章结果、时间戳和存证信息。 + +### 落地边界 + +- **已落地**：签章流程、签章回执、时间戳与存证协同设计口径已明确。 +- **部分落地**：`installation_*` 当前在数据库主文档中按专题扩展纳管，实施库需联合评审确认最终落表。 +- **文档先行**：多 CA 厂商切换、批量签署编排等高级能力暂不表述为当前既有实现。 + ## INST-005 档案归档与过程留痕 @@ -157,3 +287,19 @@ sequenceDiagram - 电子签章合同、验收附件、影像资料统一存储。 - 档案查询支持按申请编号、客户、地址、时间、状态检索。 +### 核心数据 + +- `biz_content_attach`：报装材料、验收附件、影像资料。 +- `installation_evidence`：签章存证与回执资料。 +- `biz_process`、`biz_process_transfer`：过程留痕主线。 + +### 接口映射 + +- `IF-INST-005`：归档申请、合同、验收资料与签章回执。 +- `IF-INST-004`：签章回执结果进入归档链路。 + +### 落地边界 + +- **已落地**：资料归档、过程日志留存、按申请维度检索的设计边界明确。 +- **部分落地**：全文检索、影像 OCR、外部档案系统联动可能由专项系统承载。 +- **文档先行**：长期电子档案治理和归档分层存储策略不作为当前应用开发首批范围。