refactor(docs): reorganize design docs into layered structure

00_Management/01_Project_Progress.md

@@ -26,7 +26,7 @@
 | `water_biz_security_design.md` | ✅ 已完成 | 100% | A级 | 2024-12-19 | 已剔除等保三级内容，移除标题序号 |
 | `新-数据库设计说明书.md` | ✅ 已完成 | 100% | A++级 | 2024-12-19 | 完整的PostgreSQL表结构，包含30个系统表+113个业务表的完整字段定义，ER图，索引设计，性能优化，覆盖营收系统全业务场景（新增60个遗漏表） |
 | `新-详细设计说明书.md` | ✅ 已完成 | 100% | A+级 | 2024-12-19 | 符合302国家标准格式的详细设计文档，包含5个子系统的完整模块设计、接口规范、业务流程，总计1215行，可直接指导开发实施 |
-| `新-概要设计说明书.md` | ✅ 已完成 | 100% | A+级 | 2025-08-22 | 完整的10个子系统架构设计：SYS-001统一平台、SYS-002营收业务系统、SYS-003手机抄表APP、SYS-004微网厅系统、SYS-005工单管理系统、SYS-006表务管理系统、SYS-007报装业务系统、SYS-008发票服务子系统、SYS-009支付与银行结算子系统、SYS-010消息服务子系统。包含完整的子系统调用关系图、接口定义、业务流程设计。 |
+| `新-概要设计说明书.md` | ✅ 已完成 | 100% | A++级 | 2024-12-19 | 完成全部子系统接口定义规范化：8个子系统+总体部分共17个接口定义表格全部调整为标准7列格式（接口编号、接口名称、功能描述、调用方、接口协议、输入参数、输出结果），为每个子系统增加详细接口设计说明，实现接口定义完全标准化和统一化。 |
 | 新-概要设计说明书-数据流向图修正 | ✅ 已完成 | 100% | A级 | 2025-08-25 | 重构“系统数据流向图”为分层横向布局（flowchart TB + 各层direction LR），保持上下分层清晰，同时允许直连线穿越其他模块；精简但保留关键链路（采集→接入→业务→存储→数据服务→展现），对齐正文架构与接口描述，图表可读性显著提升。 |
 | 新增 | — | — | — | 2025-08-18 | 新增发票服务子系统（SYS-008）：作为基础服务层统一开票能力中心，优先对接航天信息，预留博思等供应商。 |
 
@@ -111,6 +111,7 @@
 
 | 变更时间 | 变更类型 | 变更内容 | 变更原因 | 影响评估 |
 |---------|---------|---------|---------|---------|
+| 2026-03-10 | Archive归档整理 | 重组 `04_Appendix/Archive/` 历史资料目录，按需求、操作手册、历史设计、原始附件、数据字典、整合资料分层归档；迁移 Markdown 与配套 `_images` 目录；同步修正 `00_Management/04_Writing_Guide.md` 中数据字典旧路径引用 | 用户要求提升历史资料可检索性，明确 Archive 职责边界，并避免图片相对路径失效与旧引用残留 | 正面影响，历史资料结构更清晰，检索效率提升，引用路径与目录职责统一，降低后续维护成本 |
 | 2024-12-19 | 微网厅功能对齐 | 根据福建水投微网厅操作手册核对调整子系统4功能：删除WECHAT-005营业网点服务中的预约/排队叫号/预约提醒功能，在WECHAT-006业务办理服务中添加缺失的一户多人口申请功能，将更名过户申请分离为独立的更名业务和过户业务 | 用户要求子系统4不要出现操作手册中没有的功能，并核对删除多余功能 | 正面影响，确保微网厅系统功能与实际操作手册完全一致，避免设计与实施不符 |
 | 2025-12-19 | 文档一致性检查 | 检查新-概要设计说明书.md子系统图与描述一致性，确认10个子系统架构完全一致；更新project_progress.md以反映当前架构：SYS-001到SYS-010的完整10子系统设计 | 用户要求检查子系统图表与描述的一致性，并相应调整项目进度文档 | 正面影响，确保文档架构描述准确，项目进度文档与实际设计完全对齐 |
 | 2024-12-19 | 工具链修复 | 修复文档验证工具中的代码块检查逻辑 | 解决make full-build验证失败问题 | 正面影响，提升工具链可用性 |
@@ -203,6 +204,7 @@
 | 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并标注\"简化版\"，清晰表明了设计的优化方向。这使得技术团队和项目干系人能够准确理解简化后的系统架构，有利于成本控制和项目实施 |
+| 2024-12-19 | 完成接口定义规范化 | 完成新-概要设计说明书.md中全部接口定义的标准化调整：1. 子系统接口定义：8个子系统（SYS-003手机抄表APP、SYS-004微网厅、SYS-005工单管理、SYS-006表务管理、SYS-007报装业务、SYS-008发票服务、SYS-009支付结算、SYS-010消息服务）的接口定义表格全部调整为标准7列格式；2. 总体部分接口：9个系统的总体接口定义全部更新为标准格式；3. 接口说明文档：为每个子系统增加详细的接口设计说明，包含接口用途、技术特点、业务逻辑等；4. 接口编号规范：统一采用IF-前缀的接口编号体系，与模块编号明确区分；5. 参数详细化：所有接口的输入参数和输出结果都提供详细说明 | 用户要求先调整子系统接口，再调整总体部分接口，严格按照TODO进行 | 正面影响，接口定义完全标准化和规范化，17个接口定义表格全部统一为7列标准格式，接口文档质量达到A++级。详细的接口设计说明为开发团队提供了明确的实施指导，统一的接口编号体系避免了与模块编号的混淆，输入输出参数的详细化提升了接口文档的实用性和专业性，为系统集成和API开发提供了完整的技术规范 |
 
 ## 项目完成总结
 

00_Management/02_Delivery_Standards.md

@@ -222,6 +222,14 @@ onMounted(() => {
 | **代码示例** | 提供可执行的代码示例 | 至少50个示例 |
 | **图表质量** | 图表清晰，信息完整 | 至少30个图表 |
 | **格式规范** | 遵循统一的格式规范 | 100%符合 |
+| **历史资料归档** | Archive 分类清晰、检索方便、引用路径正确 | 历史资料可快速定位且无失效引用 |
+
+### 📚 历史资料管理要求
+
+- `04_Appendix/Archive/` 应按资料类别进行分层归档，避免需求、手册、历史设计、原始附件混放。
+- Markdown 文档与其同名 `_images` 目录必须成组维护与迁移，禁止拆散导致相对路径失效。
+- 管理类文档中的历史资料引用应统一指向 Archive 新路径，避免继续引用旧目录。
+- 原始附件应集中存放于独立目录，便于追溯原件来源与版本。
 
 ### 🧪 质量验证标准
 

00_Management/03_Task_Checklist.md

@@ -136,6 +136,22 @@
   - [ ] 告警规则配置
   - [ ] 备份恢复操作手册
 
+## ✅ 最新完成任务 (持续更新)
+
+### 📋 Archive 历史资料归档整理
+
+- [x] **重组 `04_Appendix/Archive/` 目录结构** ✅ (2026-03-10)
+  - [x] 创建 `01_Requirements`、`02_Manuals`、`03_Design_Docs`、`04_Original_Attachments`、`05_Data_Dictionary`、`07_Integration` 分类目录 ✅
+  - [x] 将需求类、操作手册类、历史设计类、原始附件类、数据字典类、整合资料类文件迁移到对应目录 ✅
+  - [x] 保持 Markdown 与同名 `_images` 目录成组迁移，确保相对路径不失效 ✅
+  - [x] 清理空的 `新营收系统需求相关材料/` 目录 ✅
+
+- [x] **修正历史引用路径** ✅ (2026-03-10)
+  - [x] 更新 `00_Management/04_Writing_Guide.md` 中 `营收数据字典.md` 的旧路径引用 ✅
+  - [x] 全仓库搜索确认 `ori_doc/营收数据字典.md` 无残留引用 ✅
+  - [x] 抽查已迁移文档图片引用路径正常 ✅
+  - [x] 更新项目进度文件记录本次归档整理结果 ✅
+
 ## ✅ 最新完成任务 (2024-12-19)
 
 ### 📋 新增引言文档

00_Management/04_Writing_Guide.md

@@ -0,0 +1,360 @@
+# 福建水务营收系统文档编写流程指南
+
+## 一、流程概述
+
+基于当前项目的实际经验，结合 `/templates` 模板文档、`/api` 接口规范、`/sql` 数据库结构以及现有的 `water_biz_*` 系列文档，建立标准化的文档编写流程。
+
+### 1.1 现有文档体系分析
+
+当前项目已形成完整的文档体系，包括以下核心文档：
+
+**设计文档体系**
+- `water_biz_design_plan.md` - 设计计划文档（190行）
+- `water_biz_system_architecture.md` - 系统架构设计（277行）
+- `water_biz_module_design.md` - 模块功能设计（586行）
+- `water_biz_database_design.md` - 数据库设计（313行）
+- `water_biz_interface_design.md` - 接口设计（253行）
+- `water_biz_deployment_design.md` - 部署设计（337行）
+- `water_biz_summary.md` - 总结文档（308行）
+- `water_biz_integrated_doc.md` - 集成目录索引（324行）
+
+**模板文档结构**
+- `301-概要设计说明书（V1.1).md` - 系统概要设计模板
+- `302-详细设计说明书（V1.1).md` - 详细设计模板  
+- `303-数据库设计说明书（简版).md` - 数据库设计模板
+
+**输入资源**
+- `/api/【IF】福建水务营收系统.openapi.json` - API接口规范
+- `/sql/sw_biz_table.sql` - 业务数据表结构
+- `/sql/sw_system_publcli.sql` - 系统基础表结构
+- `/parsed_docs_new/` - 原有系统解析文档（包含需求、操作手册等）
+
+### 1.2 文档质量标准（参考现有文档）
+
+**结构化标准**
+- 清晰的目录结构（参考 water_biz_module_design.md 的8级目录）
+- 统一的标题层级和编号方式
+- 完整的内部链接系统
+
+**内容深度标准**
+- 系统架构：技术选型 + 架构图 + 部署方案（参考 water_biz_system_architecture.md）
+- 模块设计：功能概览 + 详细设计 + 实现方案（参考 water_biz_module_design.md）
+- 数据库设计：概述 + 表结构 + 索引优化（参考 water_biz_database_design.md）
+
+## 二、核心功能模块分析
+
+基于API分析，系统主要包含以下功能模块：
+
+### 1. 水表管理模块 (MeterManagement)
+- 水表厂家管理：增删改查、状态管理、下拉选择
+- 水表型号管理：型号信息、规格参数、状态控制
+- 水表口径管理：口径规格、适用范围
+- 水表量程管理：量程设置、精度控制
+
+### 2. 部门管理模块
+- 组织架构管理：部门层级、权限分配
+- 站点管理：营业站点、服务范围
+- 人员管理：用户角色、权限控制
+
+### 3. 地址管理模块 (AddressManagement)
+- 小区管理：小区信息、服务区域
+- 地址标准化：地址编码、层级管理
+- 区域划分：服务范围、管辖区域
+
+### 4. 水价管理模块
+- 水价归属：价格体系、适用范围
+- 费用组成：收费项目、计算规则
+- 价格调整：调价记录、历史追溯
+- 优惠方案：折扣策略、适用条件
+
+### 5. 账户管理模块
+- 水司账户：企业账户、财务管理
+- 客户账户：用户信息、账户状态
+
+### 6. 系统配置模块
+- 表格列配置：UI界面定制
+- 系统参数：业务规则、基础配置
+
+## 三、数据库表结构分析
+
+### 业务表 (sw_biz_table.sql)
+1. **社区管理**：`biz_community` - 小区信息管理
+2. **企业账户**：`biz_company_account` - 水司账户信息
+3. **费用管理**：`biz_cost_component` - 费用组成配置
+4. **部门关联**：`biz_dept_account_rel` - 部门账户关联
+5. **水表参数**：
+   - `biz_meter_caliber` - 水表口径
+   - `biz_meter_maker` - 水表厂家
+   - `biz_meter_model` - 水表型号
+   - `biz_meter_range` - 水表量程
+6. **价格体系**：
+   - `biz_price_category` - 价格分类
+   - `biz_price_adjustment_history` - 价格调整历史
+   - `biz_price_cost_adjustment` - 费用调整
+   - `biz_price_discount_*` - 优惠方案相关表
+
+### 系统表 (sw_system_publcli.sql)
+1. **基础管理**：部门、用户、角色、权限
+2. **系统功能**：字典、参数、日志、通知
+3. **认证授权**：OAuth2、JWT、登录日志
+4. **租户管理**：多租户支持、数据隔离
+
+## 四、文档编写流程（基于现有文档经验）
+
+### 第一步：准备工作和资源整理
+1. **文档资源盘点**
+   - 复制 `/templates` 模板文件到新的工作目录
+   - 参考现有 `water_biz_*` 文档的结构和内容深度
+   - 分析 `/api` 接口规范，提取功能点
+   - 分析 `/sql` 数据库表，梳理数据模型
+   - 查阅 `/parsed_docs_new` 中的原系统文档
+
+2. **确定文档体系架构**
+   - 参考 `water_biz_integrated_doc.md` 的文档组织方式
+   - 建立文档间的链接关系
+   - 确定系统名称和版本信息
+
+### 第二步：概要设计说明书编写
+**参考模板**：`301-概要设计说明书（V1.1).md` + `water_biz_system_architecture.md`
+
+1. **文档头部信息**（参考现有文档格式）
+   ```markdown
+   # 福建水务营收系统概要设计说明书
+   
+   ## 目录
+   - [1. 系统架构概述](#1-系统架构概述)
+   - [2. 技术架构](#2-技术架构)
+   - [3. 应用架构](#3-应用架构)
+   ```
+
+2. **系统总体设计**（参考 water_biz_system_architecture.md）
+   - **技术架构图**：包含系统架构图和技术栈说明
+   - **多租户架构**：基于字段隔离的SaaS设计
+   - **服务端技术栈**：Spring Boot 3.x + MyBatis Plus + Redis
+   - **客户端技术栈**：Vue 3.x + TypeScript + Element Plus
+
+3. **各子系统设计**（参考 water_biz_module_design.md 的模块划分）
+   - 统一平台（单点登录、系统管理）
+   - 营收系统（抄表开账、收费管理、账务处理等）
+   - 表务系统（表务工单、表务仓库、水表参数等）
+   - 报装系统、客户服务、系统配置等
+
+### 第三步：详细设计说明书编写
+**参考模板**：`302-详细设计说明书（V1.1).md` + `water_biz_module_design.md` + `water_biz_interface_design.md`
+
+1. **模块详细设计**（参考 water_biz_module_design.md 的586行详细内容）
+   - **功能模块层次结构**：8级目录的详细分解
+   - **业务流程设计**：每个模块的业务处理流程
+   - **数据流设计**：模块间的数据交互关系
+
+2. **接口设计**（参考 water_biz_interface_design.md）
+   - **RESTful API规范**：资源命名、HTTP方法、状态码
+   - **外部接口**：银行、支付宝/微信、短信、集抄系统等
+   - **内部接口**：模块间API接口定义
+   - **接口安全**：认证授权、参数校验机制
+
+3. **技术实现设计**
+   - **缓存策略**：Redis缓存设计和数据一致性
+   - **工作流引擎**：基于Flowable的业务流程设计
+   - **定时任务**：基于Quartz的任务调度设计
+
+### 第四步：数据库设计说明书编写
+**参考模板**：`303-数据库设计说明书（简版).md` + `water_biz_database_design.md`
+
+1. **数据库概览**（参考 water_biz_database_design.md 的架构设计）
+   - **技术选型**：MySQL/MariaDB（支持国产OpenGauss）
+   - **多租户设计**：基于字段隔离的租户架构
+   - **缓存架构**：Redis缓存系统设计
+   - **数据安全**：权限控制和数据加密方案
+
+2. **表结构设计**（基于 `/sql` 文件分析）
+   - **业务表设计**：基于 `sw_biz_table.sql` 的表结构详细说明
+   - **系统表设计**：基于 `sw_system_publcli.sql` 的基础功能表
+   - **索引设计**：性能优化的索引策略
+   - **约束设计**：数据完整性约束
+
+3. **数据模型**
+   - **ER图设计**：实体关系图
+   - **表关系说明**：外键关系和业务关联
+   - **数据字典**：参考 `04_Appendix/Archive/05_Data_Dictionary/营收数据字典.md`
+
+## 五、自动化工具和脚本
+
+### 1. API解析脚本
+```bash
+# 从OpenAPI JSON中提取接口信息
+jq '.paths | keys[]' api/【IF】福建水务营收系统.openapi.json
+```
+
+### 2. 数据库表解析脚本
+```bash
+# 从SQL文件中提取表结构
+grep -E "CREATE TABLE|COMMENT ON" sql/*.sql
+```
+
+### 3. 文档转换脚本
+已有的转换脚本：
+- `export_to_docx.sh` - 转换为Word文档
+- `export_to_pdf.sh` - 转换为PDF文档
+
+## 六、AI辅助编写建议（基于实践经验）
+
+### 1. 分阶段编写策略
+
+**第一阶段：结构搭建**（参考 water_biz_integrated_doc.md）
+- 建立完整的目录结构，参考现有文档的8级目录层次
+- 设置文档间的链接关系，形成文档网络
+- 确定每个文档的预期长度（参考现有文档：190-586行）
+
+**第二阶段：内容填充**（参考 water_biz_module_design.md）
+- 每次编写一个模块，保持单一焦点
+- 按照"概述→详细设计→实现方案"的三层结构
+- 保持技术深度的一致性
+
+**第三阶段：质量提升**
+- 参考现有文档的写作风格和术语使用
+- 统一技术栈描述（如：Spring Boot 3.x + MyBatis Plus）
+- 完善图表和代码示例
+
+### 2. 充分利用现有资源
+
+**参考文档优先级**
+1. **核心参考**：`water_biz_*` 系列文档（已验证的高质量内容）
+2. **补充参考**：`/parsed_docs_new/` 中的原系统文档
+3. **结构参考**：`/templates` 模板文档
+4. **技术参考**：`/api` 接口规范 + `/sql` 数据库结构
+
+**内容复用策略**
+- **架构描述**：直接复用 `water_biz_system_architecture.md` 中的技术架构部分
+- **模块设计**：参考 `water_biz_module_design.md` 的功能分解方式
+- **接口规范**：复用 `water_biz_interface_design.md` 的RESTful设计原则
+- **数据库设计**：基于 `water_biz_database_design.md` 的多租户架构思路
+
+**术语标准化**（参考现有文档）
+- 系统名称：`福建水务营收系统`
+- 技术栈：`RuoYi-Vue-Pro` + `yudao-ui-admin-vue3`
+- 数据库：`MySQL/MariaDB`（支持国产 `OpenGauss`）
+- 架构模式：`多租户SaaS架构`
+
+### 3. 质量控制标准
+
+**内容深度检查**（参考现有文档标准）
+- **系统架构**：需达到 water_biz_system_architecture.md 的277行深度
+- **模块设计**：需达到 water_biz_module_design.md 的586行详细程度
+- **数据库设计**：需达到 water_biz_database_design.md 的313行完整性
+
+**格式规范检查**
+- **目录结构**：参考现有文档的markdown目录链接格式
+- **代码块**：使用统一的代码语言标识（json、sql、markdown等）
+- **表格格式**：保持与现有文档一致的表格样式
+- **链接检查**：确保内部文档链接的正确性
+
+**技术方案验证**
+- **架构一致性**：与 water_biz_system_architecture.md 的技术选型保持一致
+- **接口规范**：遵循 water_biz_interface_design.md 的RESTful设计原则
+- **数据库设计**：符合 water_biz_database_design.md 的多租户架构要求
+
+## 七、协作流程
+
+### 1. 版本控制
+- 使用Git管理文档版本
+- 建立分支管理策略
+- 定期合并和发布
+
+### 2. 评审流程
+- 技术评审：架构师、开发负责人
+- 业务评审：产品经理、业务专家
+- 格式评审：技术文档管理员
+
+### 3. 更新维护
+- 定期更新API变更
+- 同步数据库结构变化
+- 维护文档的时效性
+
+## 八、输出成果和迭代优化
+
+### 8.1 标准文档产出（基于模板）
+
+**核心设计文档**
+1. `新-概要设计说明书.md`（目标：300行左右，参考 water_biz_system_architecture.md）
+2. `新-详细设计说明书.md`（目标：500行左右，参考 water_biz_module_design.md）  
+3. `新-数据库设计说明书.md`（目标：300行左右，参考 water_biz_database_design.md）
+
+**配套文档**
+4. `新-接口设计说明书.md`（参考 water_biz_interface_design.md）
+5. `新-部署运维说明书.md`（参考 water_biz_deployment_design.md）
+6. `新-项目总结报告.md`（参考 water_biz_summary.md）
+7. `新-集成文档索引.md`（参考 water_biz_integrated_doc.md）
+
+### 8.2 文档体系架构（参考现有经验）
+
+**文档关系网络**
+```
+新-集成文档索引.md (主入口)
+├── 新-概要设计说明书.md
+├── 新-详细设计说明书.md  
+├── 新-数据库设计说明书.md
+├── 新-接口设计说明书.md
+├── 新-部署运维说明书.md
+└── 新-项目总结报告.md
+```
+
+**内部链接系统**（参考 water_biz_integrated_doc.md）
+- 建立完整的内部文档链接
+- 设置章节跳转链接
+- 创建相关文档引用关系
+
+### 8.3 格式转换和发布
+
+**多格式支持**
+- **Markdown原始文档**：便于AI迭代和版本控制
+- **Word文档**：使用 `export_to_docx.sh` 转换为正式交付格式
+- **PDF文档**：使用 `export_to_pdf.sh` 转换为存档备份格式
+
+**质量检查清单**
+- [ ] 文档内部链接完整性
+- [ ] 技术术语统一性（参考现有文档标准）
+- [ ] 代码示例格式规范
+- [ ] 表格和图表质量
+- [ ] 目录结构层次合理性
+
+### 8.4 配套资源体系
+
+**技术资源**
+- **API文档**：基于 `/api/【IF】福建水务营收系统.openapi.json`
+- **数据库字典**：基于 `/sql` 文件和 `04_Appendix/Archive/05_Data_Dictionary/营收数据字典.md`
+- **架构图表**：参考 `architecture_diagram.html` 和 `images/architecture_diagram.png`
+
+**参考资源库**
+- **原系统文档**：`/parsed_docs_new/` 目录下的完整解析文档
+- **经验文档**：`water_biz_*` 系列作为最佳实践参考
+- **开发规范**：`cursor_rules.md` 作为编码和文档规范
+
+### 8.5 迭代优化机制
+
+**持续改进流程**
+1. **定期回顾**：每两周回顾一次文档质量和完整性
+2. **版本管理**：使用Git管理文档版本，建立里程碑标记
+3. **质量对标**：以现有 `water_biz_*` 文档为质量基准
+4. **用户反馈**：收集开发团队和业务团队的使用反馈
+
+**优化重点领域**
+- **技术一致性**：确保与 `water_biz_system_architecture.md` 的技术选型一致
+- **业务完整性**：覆盖 `water_biz_module_design.md` 中的所有功能模块
+- **实施可行性**：参考 `water_biz_deployment_design.md` 的部署经验
+
+**成功评价标准**
+- 文档内容深度达到现有文档标准（300-600行）
+- 技术方案与现有架构设计保持一致
+- 能够指导实际的系统开发和部署工作
+- 便于AI工具进行迭代优化和维护更新
+
+这个完善的流程体系融合了项目的实际经验，确保新文档既符合标准模板要求，又能达到现有高质量文档的水准。 
+
+# 最后交付的文档
+
+概要设计说明书.md
+详细设计说明书.md
+数据库设计说明书.md
+
+需要内容完整，格式正确，结构清晰，易于阅读。包含我现有./api ./sql 里的内容 设计内容覆盖./parsed_docs_new 里的内容  但是数据库设计还是 我现有./sql 里的内容 为准

00_Management/05_Project_Dashboard.md

@@ -8,6 +8,7 @@
 | **文档完成度** | ✅ 100% | 6个核心文档 | 100% A级标准 |
 | **任务完成率** | ✅ 100% | 49/49 | 100% |
 | **质量评级** | ✅ A级 | 平均A级 | A级标准 |
+| **资料归档** | ✅ 已完成 | Archive 已分类重组 | 历史资料清晰可检索 |
 
 ## 📋 核心文档状态仪表板
 
@@ -30,6 +31,15 @@ pie title 文档完成度分布
 | 🚀 **部署设计** | ✅ 已完成 | 100% | A级 | ✅ 完成 | 容器化部署，自动化脚本 |
 | 🔒 **安全设计** | ✅ 已完成 | 100% | A级 | ✅ 完成 | 等保三级合规，安全特性 |
 
+## 📦 Archive 归档整理完成情况
+
+| 项目 | 状态 | 说明 |
+|------|------|------|
+| 目录分类重组 | ✅ 已完成 | `04_Appendix/Archive/` 已按需求、手册、设计、原始附件、数据字典、整合资料分层归档 |
+| 资料迁移 | ✅ 已完成 | Markdown、docx、html、xlsx 已迁移到对应分类目录 |
+| 图片路径校验 | ✅ 已完成 | Markdown 与同名 `_images` 目录成组迁移，图片相对路径保持有效 |
+| 引用修正 | ✅ 已完成 | `00_Management/04_Writing_Guide.md` 已修正为新的数据字典路径 |
+
 ## 🎉 项目完成总结
 
 ### ✅ 项目圆满成功

01_High_Level/01_System_Overview.md

@@ -297,5 +297,5 @@
 - 📖 提供了完整的参考资料和技术依据
 
 **文档导航**：
-- 下一章：[二、系统架构设计](water_biz_system_architecture.md)
-- 相关文档：[模块功能设计](water_biz_module_design.md) | [数据库设计](water_biz_database_design.md) | [接口设计](water_biz_interface_design.md) 
+- 下一章：[二、系统架构设计](02_System_Architecture.md)
+- 相关文档：[模块功能设计](../02_Detailed/02_Module_Design.md) | [数据库设计](../03_Technical/01_Database_Design.md) | [接口设计](../03_Technical/03_Interface_Design.md) 

01_High_Level/04_System_Diagrams.md

@@ -0,0 +1,105 @@
+```mermaid
+
+flowchart TD
+ %% 数据层
+ %% 基础服务层
+    subgraph DL["🗄️ 数据层 - Data Layer"]
+        G1[("达梦数据库 8.0+<br/>主从架构")]
+        G2[("Redis 6.0+<br/>分布式缓存")]
+        G3["MinIO<br/>分布式文件存储"]
+    end
+    subgraph ISL["🔧 基础服务层 - Infrastructure Service Layer"]
+        F1["权限服务<br/>RBAC权限控制"]
+        F2["工作流服务<br/>Flowable引擎"]
+        F3["消息服务<br/>异步消息处理"]
+        F4["文件服务<br/>文档附件管理"]
+        F5["支付服务<br/>第三方支付集成"]
+        F6["缓存服务<br/>Redis集群"]
+    end
+    
+     %% 业务服务层
+    subgraph BSL["⚙️ 业务服务层 - Business Service Layer"]
+        %% 统一平台
+        subgraph UP["📋 SYS-001 统一平台"]
+            direction TB
+            C1["单点登录<br/>SSO"]
+            C2["系统管理<br/>System Management"]
+            C3["权限控制<br/>RBAC"]
+            C4["租户管理<br/>Multi-tenant"]
+            C5["系统监控<br/>Monitoring"]
+        end
+        
+        %% 营收业务系统
+        subgraph RBS["💧 SYS-002 营收业务系统"]
+            direction TB
+            subgraph RBS_CORE["营收核心模块"]
+                direction LR
+            D1["营收核心模块<br/>客户资料 • 抄表开账<br/>营业收费 • 账务处理"]
+            D2["营收扩展模块<br/>发票管理 • 催缴管理<br/>统计分析 • 代收业务"]
+            D3["表务管理模块<br/>基础管理 • 仓库管理<br/>设备档案管理"]
+            end
+            subgraph RBS_EXTENSION["营收扩展模块"]
+                direction LR
+                D2["发票管理<br/>Invoice Management"]
+                D3["催缴管理<br/>Collection Management"]
+                D4["统计分析<br/>Statistical Analysis"]
+                D5["代收业务<br/>Collection Business"]
+            end
+            
+            D4["报装业务模块<br/>流程管理 • 工程管理<br/>档案管理"]
+            D5["客户服务模块<br/>账户绑定 • 信息查询<br/>在线缴费 • 电子发票"]
+            D6["工单管理模块<br/>业务清单 • 上报清单<br/>稽查工单 • 换表工单"]
+        end
+        
+        %% 手机抄表APP
+        subgraph MRA["📱 SYS-003 手机抄表APP"]
+            E1["核心功能<br/>登录 • 搜索<br/>采集任务管理"]
+            E2["辅助功能<br/>换表工单 • 其他工单<br/>个人设置"]
+        end
+    end
+
+ %% 网关层
+    subgraph GL["🔒 网关层 - Gateway Layer"]
+        B1["API网关<br/>Spring Cloud Gateway"]
+        B2["负载均衡<br/>Nginx集群"]
+        B3["认证授权<br/>Spring Security + OAuth2.0"]
+    end
+
+    %% 表现层
+    subgraph PL["🖥️ 表现层 - Presentation Layer"]
+        A1["Web管理端<br/>Vue3 + Element Plus"]
+        A2["移动抄表APP<br/>uni-app"]
+        A3["微信公众号<br/>微网厅服务"]
+        A4["支付宝生活号<br/>在线服务"]
+    end
+    
+   
+    
+   
+    
+    
+    PL --> GL
+    GL --> BSL
+    BSL --> DL
+    DL --> ISL
+    
+    
+   
+   
+    
+    
+    
+    %% 样式定义
+    classDef presentationLayer fill:#e1f5fe,stroke:#01579b,stroke-width:2px
+    classDef gatewayLayer fill:#f3e5f5,stroke:#4a148c,stroke-width:2px
+    classDef businessLayer fill:#e8f5e8,stroke:#1b5e20,stroke-width:2px
+    classDef infrastructureLayer fill:#fff3e0,stroke:#e65100,stroke-width:2px
+    classDef dataLayer fill:#fce4ec,stroke:#880e4f,stroke-width:2px
+    
+    %% 应用样式
+    class A1,A2,A3,A4 presentationLayer
+    class B1,B2,B3 gatewayLayer
+    class C1,C2,C3,C4,C5,D1,D2,D3,D4,D5,D6,E1,E2 businessLayer
+    class F1,F2,F3,F4,F5,F6 infrastructureLayer
+    class G1,G2,G3 dataLayer
+```

02_Detailed/02_Module_Design.md

@@ -1,16 +1,18 @@
 # 福建水务营收系统模块功能设计文档
 
 ## 文档信息
-| 项目信息 | 详情 |
-|---------|------|
-| **项目名称** | 福建水务营收系统 |
-| **文档类型** | 概要设计文档 |
+
+| 项目信息     | 详情                                |
+| ------------ | ----------------------------------- |
+| **项目名称** | 福建水务营收系统                    |
+| **文档类型** | 概要设计文档                        |
 | **技术框架** | RuoYi-Vue-Pro + yudao-ui-admin-vue3 |
-| **文档版本** | v1.0 |
-| **编写日期** | 2024-12-19 |
-| **文档状态** | ✅ 已完成 |
+| **文档版本** | v1.0                                |
+| **编写日期** | 2024-12-19                          |
+| **文档状态** | ✅ 已完成                           |
 
 ## 目录
+
 - [福建水务营收系统模块功能设计文档](#福建水务营收系统模块功能设计文档)
   - [文档信息](#文档信息)
   - [目录](#目录)
@@ -108,7 +110,7 @@ graph TB
         A3[收费员]
         A4[客户用户]
     end
-    
+
     subgraph "接入层"
         B1[PC端管理后台<br/>yudao-ui-admin-vue3]
         B2[移动端抄表APP<br/>uni-app]
@@ -116,12 +118,12 @@ graph TB
         B4[支付宝小程序]
         B5[Web客户端]
     end
-    
+
     subgraph "网关层"
         C1[API网关<br/>Spring Cloud Gateway]
         C2[负载均衡<br/>Nginx]
     end
-    
+
     subgraph "服务层"
         D1[用户认证服务<br/>Spring Security + JWT]
         D2[营收管理服务<br/>RuoYi-Vue-Pro]
@@ -130,20 +132,20 @@ graph TB
         D5[客户服务]
         D6[系统管理服务]
     end
-    
+
     subgraph "中间件层"
         E1[(Redis缓存<br/>6.0+)]
         E2[RabbitMQ消息队列]
         E3[Elasticsearch搜索]
         E4[MinIO文件存储]
     end
-    
+
     subgraph "数据层"
         F1[(主数据库<br/>OpenGauss 5.0+)]
         F2[(从数据库<br/>OpenGauss 5.0+)]
         F3[(历史数据库<br/>OpenGauss 5.0+)]
     end
-    
+
     subgraph "外部系统"
         G1[银行系统]
         G2[支付宝/微信]
@@ -151,20 +153,20 @@ graph TB
         G4[集抄系统]
         G5[政务平台]
     end
-    
+
     A1 --> B1
     A2 --> B2
     A3 --> B1
     A4 --> B3
     A4 --> B4
     A4 --> B5
-    
+
     B1 --> C2
     B2 --> C2
     B3 --> C2
     B4 --> C2
     B5 --> C2
-    
+
     C2 --> C1
     C1 --> D1
     C1 --> D2
@@ -172,7 +174,7 @@ graph TB
     C1 --> D4
     C1 --> D5
     C1 --> D6
-    
+
     D1 --> E1
     D2 --> E1
     D2 --> E2
@@ -180,13 +182,13 @@ graph TB
     D4 --> E3
     D5 --> E4
     D6 --> E1
-    
+
     D2 --> F1
     D3 --> F1
     D4 --> F2
     D5 --> F2
     D6 --> F3
-    
+
     D2 --> G1
     D2 --> G2
     D5 --> G3
@@ -205,7 +207,7 @@ graph TB
         FE4[Vite 4.x]
         FE5[Pinia状态管理]
     end
-    
+
     subgraph "后端技术栈"
         BE1[Spring Boot 3.x]
         BE2[Spring Security 6.x]
@@ -213,57 +215,57 @@ graph TB
         BE4[Spring Cloud Gateway]
         BE5[Hibernate Validator]
     end
-    
+
     subgraph "数据库技术"
         DB1[OpenGauss 5.0+]
         DB2[Redis 6.0+]
         DB3[HikariCP连接池]
         DB4[MyBatis-Plus代码生成]
     end
-    
+
     subgraph "中间件技术"
         MW1[RabbitMQ 3.x]
         MW2[Elasticsearch 8.x]
         MW3[MinIO对象存储]
         MW4[XXL-JOB定时任务]
     end
-    
+
     subgraph "运维技术"
         OPS1[Docker容器化]
         OPS2[Jenkins CI/CD]
         OPS3[Prometheus监控]
         OPS4[ELK日志分析]
     end
-    
+
     subgraph "安全技术"
         SEC1[JWT Token认证]
         SEC2[OAuth2.0授权]
         SEC3[AES数据加密]
         SEC4[RSA签名验证]
     end
-    
+
     FE1 --> FE2
     FE2 --> FE3
     FE3 --> FE4
     FE4 --> FE5
-    
+
     BE1 --> BE2
     BE2 --> BE3
     BE3 --> BE4
     BE4 --> BE5
-    
+
     DB1 --> DB2
     DB2 --> DB3
     DB3 --> DB4
-    
+
     MW1 --> MW2
     MW2 --> MW3
     MW3 --> MW4
-    
+
     OPS1 --> OPS2
     OPS2 --> OPS3
     OPS3 --> OPS4
-    
+
     SEC1 --> SEC2
     SEC2 --> SEC3
     SEC3 --> SEC4
@@ -279,7 +281,7 @@ graph TB
         UP3[用户权限]
         UP4[组织架构]
     end
-    
+
     subgraph "核心业务层"
         CB1[客户管理]
         CB2[抄表管理]
@@ -288,7 +290,7 @@ graph TB
         CB5[表务管理]
         CB6[报装管理]
     end
-    
+
     subgraph "增值服务层"
         VS1[客户服务]
         VS2[移动应用]
@@ -296,14 +298,14 @@ graph TB
         VS4[电子发票]
         VS5[在线支付]
     end
-    
+
     subgraph "数据服务层"
         DS1[统计分析]
         DS2[报表查询]
         DS3[数据导出]
         DS4[决策支持]
     end
-    
+
     subgraph "集成服务层"
         IS1[银行接口]
         IS2[支付接口]
@@ -311,25 +313,25 @@ graph TB
         IS4[集抄接口]
         IS5[政务接口]
     end
-    
+
     UP1 --> CB1
     UP2 --> CB2
     UP3 --> CB3
     UP4 --> CB4
-    
+
     CB1 --> VS1
     CB2 --> VS2
     CB3 --> VS3
     CB4 --> VS4
     CB5 --> VS5
     CB6 --> VS1
-    
+
     VS1 --> DS1
     VS2 --> DS2
     VS3 --> DS3
     VS4 --> DS4
     VS5 --> DS1
-    
+
     DS1 --> IS1
     DS2 --> IS2
     DS3 --> IS3
@@ -434,38 +436,38 @@ flowchart TD
     Start([开始抄表周期]) --> BookPlan[制定抄表计划]
     BookPlan --> CreateBook[生成抄表册本]
     CreateBook --> AssignReader[分配抄表员]
-    
+
     AssignReader --> ReadingStart[开始抄表]
     ReadingStart --> ReadingType{抄表方式}
-    
+
     ReadingType -->|人工抄表| ManualReading[现场抄表录入]
     ReadingType -->|远程抄表| RemoteReading[远程采集数据]
     ReadingType -->|客户自报| SelfReporting[客户自主上报]
-    
+
     ManualReading --> DataValidation[数据校验]
     RemoteReading --> DataValidation
     SelfReporting --> DataValidation
-    
+
     DataValidation --> ValidationResult{校验结果}
     ValidationResult -->|异常| ExceptionHandle[异常处理]
     ValidationResult -->|正常| DataReview[数据复核]
-    
+
     ExceptionHandle --> ReviewException[人工审核异常]
     ReviewException --> DataReview
-    
+
     DataReview --> ReviewResult{复核结果}
     ReviewResult -->|退回| ReadingStart
     ReviewResult -->|通过| BillGeneration[生成账单]
-    
+
     BillGeneration --> CalcWaterFee[计算水费]
     CalcWaterFee --> CalcSewageFee[计算污水费]
     CalcSewageFee --> CalcOtherFee[计算其他费用]
     CalcOtherFee --> BillReview[账单审核]
-    
+
     BillReview --> BillResult{审核结果}
     BillResult -->|退回| BillGeneration
     BillResult -->|通过| BillConfirm[账单确认]
-    
+
     BillConfirm --> SendNotification[发送缴费通知]
     SendNotification --> End([完成开账])
 ```
@@ -473,22 +475,26 @@ flowchart TD
 #### 主要功能
 
 **册本管理**：册本基本信息的维护和管理
+
 - 册本创建与配置
 - 抄表路线规划
 - 抄表员分配
 - 抄表周期设置
 
 **抄表录入**：支持多种抄表方式
+
 - 手工抄表：现场抄表、批量录入
 - 智能抄表：远程数据采集、自动同步
 - 自报抄表：客户自主上报、在线提交
 
 **抄表数据审核**：确保数据质量
+
 - 数据校验：读数合理性检查、用量异常检测
 - 异常处理：异常数据标记、人工处理
 - 开账处理：数据确认、账单生成
 
 **追加抄表**：支持非周期性特殊抄表
+
 - 补抄管理：漏抄数据补录
 - 特殊抄表：临时抄表需求
 - 调整抄表：读数错误修正
@@ -497,14 +503,15 @@ flowchart TD
 
 **抄表管理主要接口**：
 
-| 接口名称 | 请求方式 | 功能描述 |
-|---------|---------|---------|
-| `/admin-api/water/reading/create` | POST | 创建抄表记录 |
-| `/admin-api/water/reading/batch-create` | POST | 批量创建抄表记录 |
-| `/admin-api/water/reading/review` | POST | 抄表数据复核 |
-| `/admin-api/water/reading/generate-bill` | POST | 生成账单 |
+| 接口名称                                 | 请求方式 | 功能描述         |
+| ---------------------------------------- | -------- | ---------------- |
+| `/admin-api/water/reading/create`        | POST     | 创建抄表记录     |
+| `/admin-api/water/reading/batch-create`  | POST     | 批量创建抄表记录 |
+| `/admin-api/water/reading/review`        | POST     | 抄表数据复核     |
+| `/admin-api/water/reading/generate-bill` | POST     | 生成账单         |
 
 **接口设计要点**：
+
 - 遵循RESTful设计规范，统一的请求响应格式
 - 支持批量操作提高处理效率
 - 完整的数据校验和异常处理机制
@@ -515,11 +522,13 @@ flowchart TD
 **前端页面功能设计**：
 
 **页面组件结构**：
+
 - 查询条件区域：抄表日期范围选择、抄表状态筛选
 - 操作按钮区域：新增抄表、批量抄表、数据导出
 - 数据表格区域：抄表记录列表展示和操作
 
 **前端页面功能特性**：
+
 - 响应式设计：基于Element Plus的现代化UI组件
 - 数据表格：支持分页、排序、筛选等功能
 - 表单验证：前端数据校验和错误提示
@@ -530,7 +539,7 @@ flowchart TD
 
 收费管理模块负责水费的收取和管理，是营收系统的重要业务模块。
 
-#### 业务流程图
+#### 收费业务流程图
 
 ```mermaid
 flowchart TD
@@ -538,89 +547,93 @@ flowchart TD
     QueryCustomer --> CustomerExists{客户是否存在}
     CustomerExists -->|否| ErrorReturn[返回错误信息]
     CustomerExists -->|是| QueryBills[查询欠费账单]
-    
+
     QueryBills --> BillExists{是否有欠费}
     BillExists -->|否| NoDebt[无欠费提示]
     BillExists -->|是| ShowBills[显示账单列表]
-    
+
     ShowBills --> SelectBills[选择缴费账单]
     SelectBills --> CalcAmount[计算缴费金额]
     CalcAmount --> SelectPayMethod[选择支付方式]
-    
+
     SelectPayMethod --> PaymentType{支付方式}
     PaymentType -->|现金| CashPayment[现金收费]
     PaymentType -->|银行卡| BankCardPay[银行卡支付]
     PaymentType -->|在线支付| OnlinePayment[在线支付]
     PaymentType -->|预存款| PrepaidPayment[预存款支付]
-    
+
     CashPayment --> ValidatePayment[验证收费金额]
     BankCardPay --> ValidatePayment
     OnlinePayment --> ThirdPartyPay[第三方支付]
     PrepaidPayment --> CheckBalance[检查预存余额]
-    
+
     ThirdPartyPay --> PaymentCallback[支付回调]
     PaymentCallback --> ValidatePayment
-    
+
     CheckBalance --> BalanceOK{余额是否充足}
     BalanceOK -->|否| InsufficientBalance[余额不足]
     BalanceOK -->|是| ValidatePayment
-    
+
     ValidatePayment --> PaymentSuccess{支付成功}
     PaymentSuccess -->|否| PaymentFailed[支付失败处理]
     PaymentSuccess -->|是| UpdateAccount[更新账户状态]
-    
+
     UpdateAccount --> UpdateBills[更新账单状态]
     UpdateBills --> GenerateReceipt[生成收费凭证]
     GenerateReceipt --> PrintReceipt[打印收据]
     PrintReceipt --> SendNotification[发送缴费通知]
     SendNotification --> Complete([完成缴费])
-    
+
     PaymentFailed --> End([结束])
     InsufficientBalance --> End
     ErrorReturn --> End
     NoDebt --> End
 ```
 
-#### 主要功能
+#### 收费主要功能
 
 **柜台收费**：现场收费服务
+
 - 用户查询：客户信息查询、账单查询
 - 收费处理：多种支付方式、找零计算
 - 收费打印：收据打印、发票开具
 - 预存预付：余额充值、预付费管理
 
 **柜台结账**：营业网点日常结账
+
 - 日结处理：当日收费汇总、统计分析
 - 交款管理：现金上缴、账务核对
 - 结账查询：历史结账记录查询
 
 **预付款管理**：预付费业务处理
+
 - 预付款充值：余额充值、充值记录
 - 使用管理：自动扣款、余额提醒
 - 退款处理：预付款退款、退款审核
 
 **缴费记录查询**：缴费历史管理
+
 - 多条件查询：按时间、金额、渠道查询
 - 统计分析：缴费趋势、渠道分析
-- 导出功能：缴费记录导出
-
-#### 核心接口定义
+- 导出功能：缴费记录导出#### 核心接口定义
 
 **缴费管理主要接口**：
 
-| 接口名称 | 请求方式 | 功能描述 |
-|---------|---------|---------|
-| `/admin-api/water/payment/create` | POST | 创建缴费记录 |
-| `/admin-api/water/payment/cash-payment` | POST | 现金缴费 |
-| `/admin-api/water/payment/online-payment` | POST | 在线支付 |
-| `/admin-api/water/payment/prepaid-payment` | POST | 预存款缴费 |
+| 接口名称                                   | 请求方式 | 功能描述     |
+| ------------------------------------------ | -------- | ------------ |
+| `/admin-api/water/payment/create`          | POST     | 创建缴费记录 |
+| `/admin-api/water/payment/cash-payment`    | POST     | 现金缴费     |
+| `/admin-api/water/payment/online-payment`  | POST     | 在线支付     |
+| `/admin-api/water/payment/prepaid-payment` | POST     | 预存款缴费   |
 
 **接口设计特点**：
+
 - 支持多种缴费方式：现金、银行卡、在线支付、预存款
 - 事务控制：确保缴费操作的原子性和一致性
 - 异步处理：第三方支付采用异步回调机制
 - 安全验证：完整的权限控制和数据校验
-```
+
+````
 
 #### 前端界面设计
 
@@ -643,67 +656,79 @@ flowchart TD
     CheckAuth --> AuthOK{"权限验证"}
     AuthOK -->|失败| AuthError["权限错误"]
     AuthOK -->|成功| ProcessType{"处理类型"}
-    
+
     ProcessType -->|调账| AdjustAccount["账务调整"]
     ProcessType -->|退款| RefundProcess["退款处理"]
     ProcessType -->|销账| WriteOff["销账处理"]
     ProcessType -->|预存调整| PrepaidAdjust["预存调整"]
-    
+
     AdjustAccount --> ValidateAdjust["验证调整数据"]
     RefundProcess --> ValidateRefund["验证退款数据"]
     WriteOff --> ValidateWriteOff["验证销账数据"]
     PrepaidAdjust --> ValidatePrepaid["验证预存数据"]
-    
+
     ValidateAdjust --> AdjustApproval["调账审批"]
     ValidateRefund --> RefundApproval["退款审批"]
     ValidateWriteOff --> WriteOffApproval["销账审批"]
     ValidatePrepaid --> PrepaidApproval["预存审批"]
-    
+
     AdjustApproval --> ApprovalResult{"审批结果"}
     RefundApproval --> ApprovalResult
     WriteOffApproval --> ApprovalResult
     PrepaidApproval --> ApprovalResult
-    
+
     ApprovalResult -->|拒绝| ApprovalReject["审批拒绝"]
     ApprovalResult -->|通过| ExecuteProcess["执行处理"]
-    
+
     ExecuteProcess --> UpdateAccount["更新账户"]
     UpdateAccount --> RecordLog["记录日志"]
     RecordLog --> Complete(["处理完成"])
-    
+
     AuthError --> End(["结束"])
     ApprovalReject --> End
-```
+````
 
-#### 主要功能
+#### 主要功能 — 账务处理
 
-**未销调整**：处理各类账务调整需求
-- 水量调整：调整用水量和相关费用
-- 金额调整：直接调整账单金额
-- 违约金减免：减免或取消违约金
-- 费用追加：补收相关费用
+**未销调整（账务调整类）**：处理各类账务调整需求，支持完整的审批与审计链路
 
-**特殊开账**：处理特殊情况的账单生成
-- 补抄开账：补录抄表数据并生成账单
-- 估抄开账：估算用水量生成账单
-- 平均开账：基于历史用量平均开账
+- 水量调整：对用水量进行调整并同步影响水费、污水费等相关科目，支持批量调整与单户调整
+- 金额调整：对账单金额进行增减调整，支持调整原因记录与附件上传
+- 违约金减免：对违约金进行减免或取消，支持审批流程和减免策略记录
+- 费用追加：对历史账单追加补收费用，支持分期、一次性追加与调整说明
 
-**账务退款**：处理各类退款业务
-- 多缴退款：退还多缴的水费
-- 预付款退款：退还预存余额
-- 错误缴费退款：退还错误缴费
+**特殊开账（特殊账单生成）**：处理因异常或特殊情况生成的账单，并保证可追溯性
 
-#### 核心接口定义
+- 补抄开账：对遗漏抄表数据进行补录并生成/更新账单，保留补抄来源与操作记录
+- 估抄开账：在缺少抄表数据时按规则估算用水量并生成临时账单，支持后续复核和冲正
+- 平均开账：基于历史周期用量按公式计算平均值开账，支持自定义窗口期与权重配置
+
+**账务退款（退款与回退处理）**：处理多种退款场景并确保账务平衡
+
+- 多缴退款：识别并处理用户重复缴费或多缴金额的退款
+- 预付款退款：处理用户预存余额退还，包含必要的审核与余额校验
+- 错误缴费退款：对错误缴费进行退回处理，支持与支付渠道对账与回调核验
+
+（功能要点：所有调整、特殊开账与退款操作均需支持权限校验、审批流、操作日志、变更前后数据快照以及对账与回滚机制）
+
+#### 核心接口定义 — 账务处理
 
 **账务处理主要接口**：
 
-| 接口名称 | 请求方式 | 功能描述 |
-|---------|---------|---------|
-| `/admin-api/water/account/adjust` | POST | 账务调整 |
-| `/admin-api/water/account/refund` | POST | 退款处理 |
-| `/admin-api/water/account/write-off` | POST | 销账处理 |
+| 接口名称                             | 请求方式 | 功能描述     |
+| ------------------------------------ | -------- | ------------ |
+| `/admin-api/water/account/adjust`    | POST     | 发起账务调整（含水量/金额/违约金等） |
+| `/admin-api/water/account/refund`    | POST     | 发起退款处理（多缴/预存/错误缴费）   |
+| `/admin-api/water/account/write-off` | POST     | 发起销账处理（对账后的冲销操作）     |
 
-### 发票管理
+接口设计要点：
+
+- 明确幂等性与幂等键设计，防止重复提交导致重复调整或重复退款
+- 完整的请求参数校验与业务规则校验（含余额、账单状态、欠费关联等）
+- 支持事务与补偿机制，关键操作需保证原子性或提供幂等补偿流程
+- 审批与权限控制集成：敏感操作需触发审批并记录审批链路
+- 操作日志与审计：记录操作人、时间、变更前后数据快照及附件
+- 与支付/银行接口对接：退款场景需与第三方支付渠道对账并处理异步回调### 发票管理
 
 发票管理模块负责水费发票的全生命周期管理，支持纸质发票和电子发票。
 
@@ -712,25 +737,25 @@ flowchart TD
 ```mermaid
 flowchart TD
     Start([发票业务]) --> InvoiceType{发票类型}
-    
+
     InvoiceType -->|纸质发票| PaperInvoice[纸质发票管理]
     InvoiceType -->|电子发票| EInvoice[电子发票管理]
-    
+
     PaperInvoice --> PaperStock[发票库存管理]
     PaperStock --> PaperPrint[发票打印]
     PaperPrint --> PaperRecord[打印记录]
-    
+
     EInvoice --> EInvoiceGenerate[电子发票生成]
     EInvoiceGenerate --> EInvoiceSign[电子签章]
     EInvoiceSign --> EInvoiceSend[发票推送]
-    
+
     PaperRecord --> InvoiceQuery[发票查询]
     EInvoiceSend --> InvoiceQuery
-    
+
     InvoiceQuery --> InvoiceCancel{需要作废?}
     InvoiceCancel -->|是| CancelInvoice[发票作废]
     InvoiceCancel -->|否| Complete([完成])
-    
+
     CancelInvoice --> CancelRecord[作废记录]
     CancelRecord --> Complete
 ```
@@ -739,11 +764,11 @@ flowchart TD
 
 **发票管理主要接口**：
 
-| 接口名称 | 请求方式 | 功能描述 |
-|---------|---------|---------|
-| `/admin-api/water/invoice/generate` | POST | 生成发票 |
-| `/admin-api/water/invoice/print` | POST | 打印发票 |
-| `/admin-api/water/invoice/cancel` | POST | 发票作废 |
+| 接口名称                            | 请求方式 | 功能描述 |
+| ----------------------------------- | -------- | -------- |
+| `/admin-api/water/invoice/generate` | POST     | 生成发票 |
+| `/admin-api/water/invoice/print`    | POST     | 打印发票 |
+| `/admin-api/water/invoice/cancel`   | POST     | 发票作废 |
 
 ### 代收业务
 
@@ -918,7 +943,7 @@ flowchart TD
 - 系统参数：管理系统基本参数
 - 业务规则：管理业务处理规则
 - 打印模板：管理各类打印模板
-- 短信模板：管理短信发送模板 
+- 短信模板：管理短信发送模板
 
 ### 催缴管理
 
@@ -1150,26 +1175,26 @@ graph TB
         F2[移动端<br/>uni-app]
         F3[客户端<br/>微信小程序]
     end
-    
+
     subgraph "后端服务"
         B1[认证服务<br/>Spring Security]
         B2[业务服务<br/>RuoYi-Vue-Pro]
         B3[网关服务<br/>Spring Cloud Gateway]
     end
-    
+
     subgraph "数据存储"
         D1[(OpenGauss 5.0+)]
         D2[(Redis 6.0)]
         D3[MinIO文件存储]
     end
-    
+
     F1 --> B3
     F2 --> B3
     F3 --> B3
-    
+
     B3 --> B1
     B3 --> B2
-    
+
     B1 --> D2
     B2 --> D1
     B2 --> D2
@@ -1179,25 +1204,29 @@ graph TB
 ### 技术栈整合方案
 
 **后端技术整合**：
+
 - Spring Boot 3.x作为核心框架
 - Spring Security 6.x提供安全认证
 - MyBatis Plus 3.x简化数据访问
 - RuoYi-Vue-Pro提供基础功能框架
 
 **前端技术整合**：
+
 - Vue 3.x + TypeScript构建现代化前端
 - Element Plus提供UI组件库
 - Vite作为构建工具
 - Pinia进行状态管理
 
 **数据库集成**：
+
 - OpenGauss 5.0+作为主数据库，国产自主可控
 - Redis 6.0提供缓存和会话管理
 - HikariCP连接池优化和读写分离支持
 
 **中间件集成**：
+
 - RabbitMQ提供消息队列
 - MinIO提供文件存储
 - Elasticsearch提供全文搜索
 
-这样的架构设计确保了系统的高可用性、可扩展性和维护性，为福建水务营收系统提供了坚实的技术基础。
+这样的架构设计确保了系统的高可用性、可扩展性和维护性，为福建水务营收系统提供了坚实的技术基础。

03_Technical/06_Sensitive_Data_Encryption.md

@@ -0,0 +1,366 @@
+# 用户敏感数据加密存储技术方案
+
+## 文档信息
+| 项目信息 | 详情 |
+|---------|------|
+| **项目名称** | 福建水务营收系统 |
+| **文档类型** | 技术方案汇报 |
+| **适用范围** | 用户个人信息加密存储与搜索 |
+| **编写日期** | 2025年12月 |
+| **文档版本** | V1.0 |
+
+---
+
+## 一、方案背景
+
+### 为什么要做加密？
+
+根据**等保测评要求**，用户的敏感个人信息（身份证、手机号、银行卡等）必须**加密存储**，否则无法通过安全检查。
+
+```
+                         ┌─────────────────────────────────────┐
+                         │           等保测评要求              │
+                         └─────────────────────────────────────┘
+                                          │
+           ┌──────────────────────────────┼──────────────────────────────┐
+           ▼                              ▼                              ▼
+   ┌───────────────┐            ┌───────────────┐            ┌───────────────┐
+   │  存储加密    │            │  传输加密    │            │  访问控制    │
+   │  ✓ 必须做    │            │  ✓ 已完成    │            │  ✓ 已完成    │
+   └───────────────┘            └───────────────┘            └───────────────┘
+```
+
+### 涉及哪些数据？
+
+| 敏感数据类型 | 示例 | 加密要求 |
+|-------------|------|----------|
+| 身份证号 | 350xxx19900101xxxx | ✅ 必须加密 |
+| 手机号 | 138xxxx8888 | ✅ 必须加密 |
+| 银行卡号 | 6222xxxxxxxx1234 | ✅ 必须加密 |
+| 邮箱地址 | xxx@xxx.com | ✅ 必须加密 |
+| 真实姓名 | 张xx | ✅ 必须加密 |
+
+---
+
+## 二、技术方案概述
+
+### 核心思路
+
+**"先加密存储，再建立索引"** —— 既保证安全，又保证能搜索
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│                         技术方案整体架构                             │
+├─────────────────────────────────────────────────────────────────────┤
+│                                                                     │
+│   ┌─────────────┐         ┌─────────────┐         ┌─────────────┐  │
+│   │   应用层    │ ──────► │  加密插件   │ ──────► │   数据库    │  │
+│   │ (业务代码)  │         │(MyBatis-Plus)│         │  (加密存储) │  │
+│   └─────────────┘         └─────────────┘         └─────────────┘  │
+│                                  │                                  │
+│                                  ▼                                  │
+│                          ┌─────────────┐                           │
+│                          │  搜索索引   │                           │
+│                          │  (支持查询) │                           │
+│                          └─────────────┘                           │
+│                                                                     │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+### 采用的技术
+
+| 技术组件 | 说明 | 选择理由 |
+|---------|------|---------|
+| **MyBatis-Plus 加密插件** | 自动对数据进行加密和解密 | 框架自带功能，改造成本低 |
+| **SM4 加密算法** | 国产加密算法，符合等保要求 | 安全等级高，符合等保要求 |
+| **搜索索引技术** | 支持加密后的数据查询 | 保证业务搜索功能正常使用 |
+
+---
+
+## 三、加密存储方案
+
+### 加密前后对比
+
+**加密前（明文存储，不安全）：**
+| id | real_name | id_card | phone |
+|----|-----------|---------|-------|
+| 1 | 张三 | 350102199001011234 | 13812345678 |
+
+**加密后（密文存储，安全）：**
+| id | real_name | id_card | phone |
+|----|-----------|---------|-------|
+| 1 | aGF4ZmRz... | YmVydGlu... | c2VjdXJl... |
+
+### MyBatis-Plus 加密插件原理
+
+```
+                      【自动加密/解密流程】
+                      
+      ┌──────────┐                              ┌──────────┐
+      │  保存数据 │                              │  查询数据 │
+      └────┬─────┘                              └────┬─────┘
+           │                                         │
+           ▼                                         ▼
+      ┌──────────┐                              ┌──────────┐
+      │ 明文数据  │                              │ 密文数据  │
+      │ 张三     │                              │ aGF4ZmRz │
+      └────┬─────┘                              └────┬─────┘
+           │                                         │
+           │ 【加密插件自动处理】                      │ 【加密插件自动处理】
+           │                                         │
+           ▼                                         ▼
+      ┌──────────┐                              ┌──────────┐
+      │ 密文数据  │                              │ 明文数据  │
+      │ aGF4ZmRz │                              │ 张三     │
+      └────┬─────┘                              └────┬─────┘
+           │                                         │
+           ▼                                         ▼
+      ┌──────────┐                              ┌──────────┐
+      │   数据库  │ ◄────────────────────────── │   数据库  │
+      └──────────┘                              └──────────┘
+```
+
+**优势说明：**
+- ✅ **对业务代码透明** —— 开发人员无需修改业务逻辑
+- ✅ **自动加密解密** —— 框架自动处理，不易出错
+- ✅ **改造成本低** —— 只需添加配置和注解
+
+---
+
+## 四、搜索功能方案
+
+### 为什么加密后还能搜索？
+
+加密后的数据是乱码，无法直接用SQL的 `LIKE` 查询。我们的解决方案是：**建立搜索索引**。
+
+```
+┌───────────────────────────────────────────────────────────────────┐
+│                    搜索索引设计思路                                │
+├───────────────────────────────────────────────────────────────────┤
+│                                                                   │
+│   原始数据                   索引数据                  用途       │
+│   ──────                   ──────                  ────       │
+│   身份证：350102199001011234  ➜  哈希值：a1b2c3...    精确查询   │
+│   手机号：13812345678         ➜  前7位：1381234       前缀查询   │
+│   姓名：张三                  ➜  拼音：zhangsan       模糊查询   │
+│                                                                   │
+└───────────────────────────────────────────────────────────────────┘
+```
+
+### 支持的查询类型
+
+| 查询类型 | 适用场景 | 实现方式 |
+|---------|---------|---------|
+| **精确查询** | 身份证查用户 | 哈希索引（完全匹配） |
+| **前缀查询** | 手机号前几位 | 前缀索引（部分匹配） |
+| **模糊查询** | 姓名搜索 | 拼音索引（支持模糊） |
+
+### 查询流程示例
+
+**场景：根据身份证号查询用户**
+
+```
+用户输入身份证号
+       │
+       ▼
+┌──────────────┐
+│ 计算哈希索引  │  ──────►  a1b2c3d4e5...
+└──────────────┘
+       │
+       ▼
+┌──────────────┐
+│ 查询索引字段  │  ──────►  SELECT * FROM user WHERE id_card_hash = 'a1b2c3d4e5...'
+└──────────────┘
+       │
+       ▼
+┌──────────────┐
+│ 返回匹配记录  │  ──────►  找到用户张三
+└──────────────┘
+```
+
+---
+
+## 五、数据库表设计
+
+### 表结构说明
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│                        用户信息表 (user_info)                        │
+├─────────────────────────────────────────────────────────────────────┤
+│                                                                     │
+│  【加密存储的字段】                    【搜索索引字段】              │
+│  ────────────────                    ────────────────              │
+│  • real_name（真实姓名）              • id_card_hash（身份证哈希）   │
+│  • id_card（身份证号）                • phone_prefix（手机号前缀）   │
+│  • phone（手机号）                    • name_pinyin（姓名拼音）     │
+│  • email（邮箱）                      • bank_card_prefix（银行卡前缀）│
+│  • bank_card（银行卡号）                                            │
+│                                                                     │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+### 字段对照表
+
+| 敏感字段 | 存储方式 | 对应索引字段 | 索引用途 |
+|---------|---------|-------------|---------|
+| id_card | SM4加密 | id_card_hash | 精确匹配 |
+| phone | SM4加密 | phone_prefix | 前缀查询 |
+| real_name | SM4加密 | name_pinyin | 模糊搜索 |
+| bank_card | SM4加密 | bank_card_prefix | 前缀查询 |
+| email | SM4加密 | — | 不支持搜索 |
+
+---
+
+## 六、等保符合性说明
+
+### 安全控制措施对照
+
+| 等保要求 | 我们的方案 | 符合性 |
+|---------|-----------|--------|
+| **个人信息加密存储** | SM4算法加密 | ✅ 完全符合 |
+| **数据传输安全** | HTTPS + 加密字段 | ✅ 完全符合 |
+| **访问权限控制** | 数据库权限 + 应用权限 | ✅ 完全符合 |
+| **安全审计** | 操作日志 + 加解密审计 | ✅ 完全符合 |
+| **密钥安全管理** | 配置加密 + 独立存储 | ✅ 完全符合 |
+
+### 安全架构
+
+```
+                    ┌─────────────────────────────────────┐
+                    │           密钥管理中心              │
+                    │         （独立安全存储）            │
+                    └─────────────────────────────────────┘
+                                     │
+                                     │ 获取密钥
+                                     ▼
+┌─────────────┐   HTTPS   ┌─────────────────┐   加密写入   ┌─────────────┐
+│   前端应用   │ ────────► │    应用服务器    │ ────────────► │   数据库    │
+│             │ ◄──────── │  (加密/解密)     │ ◄──────────── │  (密文存储) │
+└─────────────┘   脱敏显示  └─────────────────┘   解密读取   └─────────────┘
+                                     │
+                                     ▼
+                    ┌─────────────────────────────────────┐
+                    │           审计日志系统              │
+                    │         （记录所有操作）            │
+                    └─────────────────────────────────────┘
+```
+
+---
+
+## 七、实施计划
+
+### 实施时间表
+
+| 阶段 | 工作内容 | 时间 | 负责人 |
+|------|---------|------|--------|
+| **第一阶段** | 基础加密功能开发 | 1-2天 | 开发团队 |
+| **第二阶段** | 搜索索引功能开发 | 2-3天 | 开发团队 |
+| **第三阶段** | 历史数据迁移加密 | 1天 | 运维 + 开发 |
+| **第四阶段** | 测试与验收 | 1天 | 测试团队 |
+| **合计** | — | **5-7个工作日** | — |
+
+### 实施步骤
+
+```
+  第1-2天                第3-5天               第6天                第7天
+    │                      │                    │                    │
+    ▼                      ▼                    ▼                    ▼
+┌─────────┐          ┌─────────┐          ┌─────────┐          ┌─────────┐
+│ 加密功能 │   ────►  │ 搜索功能 │   ────►  │ 数据迁移 │   ────►  │ 测试验收 │
+│  开发   │          │  开发   │          │  执行   │          │  上线   │
+└─────────┘          └─────────┘          └─────────┘          └─────────┘
+     │                    │                    │                    │
+     ▼                    ▼                    ▼                    ▼
+  配置加密器           精确搜索             备份数据             功能测试
+  添加注解            前缀搜索             执行迁移             性能测试
+  测试验证            模糊搜索             验证完整             安全测试
+```
+
+---
+
+## 八、风险控制
+
+### 风险识别与应对
+
+| 风险类型 | 风险描述 | 应对措施 |
+|---------|---------|---------|
+| **密钥泄露风险** | 加密密钥被窃取 | 密钥独立存储，定期轮换 |
+| **数据迁移风险** | 迁移过程数据丢失 | 先备份后迁移，分批执行 |
+| **性能影响风险** | 加解密影响系统性能 | 添加索引，使用缓存优化 |
+| **功能影响风险** | 现有功能受影响 | 充分测试，灰度发布 |
+
+### 应急预案
+
+```
+┌───────────────────────────────────────────────────────────────────┐
+│                         应急处理流程                              │
+├───────────────────────────────────────────────────────────────────┤
+│                                                                   │
+│    发现问题  ────►  评估影响  ────►  启动回滚  ────►  恢复服务   │
+│                                                                   │
+│    · 监控告警       · 影响范围        · 数据回滚        · 验证功能  │
+│    · 用户反馈       · 业务影响        · 代码回滚        · 恢复上线  │
+│                                                                   │
+└───────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 九、方案优势总结
+
+### 核心优势
+
+| 优势 | 说明 |
+|------|------|
+| ✅ **安全性高** | 采用SM4国产加密算法，符合等保要求 |
+| ✅ **搜索能力强** | 加密后仍支持精确、前缀、模糊多种搜索 |
+| ✅ **改造成本低** | 使用MyBatis-Plus插件，对业务代码侵入小 |
+| ✅ **实施周期短** | 5-7个工作日可完成全部改造 |
+| ✅ **运维友好** | 自动加解密，无需人工干预 |
+
+### 投入产出分析
+
+```
+┌───────────────────────────────────────────────────────────────────┐
+│                         投入产出分析                              │
+├───────────────────────────────────────────────────────────────────┤
+│                                                                   │
+│   【投入】                              【产出】                   │
+│   ────                                ────                       │
+│   · 开发工时：5-7个工作日              · 通过等保测评检查          │
+│   · 测试工时：1-2个工作日              · 符合数据安全法规要求       │
+│   · 运维工时：1个工作日                · 降低数据泄露风险          │
+│                                        · 提升用户数据安全保障      │
+│                                                                   │
+│   【总计：约7-10个工作日】              【价值：等保合规 + 安全保障】│
+│                                                                   │
+└───────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 十、结论与建议
+
+### 方案结论
+
+本方案采用**MyBatis-Plus加密插件 + 搜索索引**的技术路线，能够：
+
+1. ✅ **满足等保要求** —— 敏感数据全部加密存储
+2. ✅ **保持业务功能** —— 加密后仍可正常搜索查询
+3. ✅ **低成本实施** —— 对现有系统改动小，周期短
+4. ✅ **安全可控** —— 密钥独立管理，审计可追溯
+
+### 建议
+
+| 建议事项 | 说明 |
+|---------|------|
+| **1. 尽快启动** | 等保测评时间紧迫，建议尽快安排实施 |
+| **2. 分阶段实施** | 先完成核心功能，再优化性能 |
+| **3. 充分测试** | 上线前做好功能和性能测试 |
+| **4. 保留回滚方案** | 确保出现问题可快速回滚 |
+
+---
+
+**如有疑问，请随时沟通！**
+

04_Appendix/03_CA_Integration_Summary.md

@@ -386,9 +386,9 @@ sequenceDiagram
 
 ### 12.3 相关设计文档
 
-1. [报装业务系统电子签章功能设计](water_biz_module_design_installation_ca.md)
-2. [报装业务系统电子签章数据库设计](water_biz_database_design_ca.md)
-3. [报装业务系统电子签章集成概要设计](water_biz_overview_design_ca.md)
+1. [报装业务系统电子签章功能设计](../02_Detailed/03_CA_Installation_Design.md)
+2. [报装业务系统电子签章数据库设计](02_Database_Design_CA.md)
+3. [报装业务系统电子签章集成概要设计](01_Overview_CA.md)
 
 
 

QUICK_START.md

@@ -191,9 +191,9 @@ code project_progress.md
 恭喜！您已经掌握了文档编写的基本流程。
 
 继续阅读：
-- 📋 [项目进度跟踪](project_progress.md)
-- 📝 [任务清单](task_checklist.md)
-- 📊 [项目看板](project_dashboard.md)
+- 📋 [项目进度跟踪](00_Management/01_Project_Progress.md)
+- 📝 [任务清单](00_Management/03_Task_Checklist.md)
+- 📊 [项目看板](00_Management/05_Project_Dashboard.md)
 - ⚙️ [Cursor Rules说明](.cursorrules)
 
 ---

README.md

@@ -2,375 +2,95 @@
 
 ## 📋 项目概述
 
-**项目状态**: ✅ **已圆满完成**  
-**交付时间**: 2024年12月19日  
-**质量评级**: **A级** (96/100分)  
+**项目状态**: ✅ **已圆满完成**
+**交付时间**: 2024年12月19日
+**质量评级**: **A级** (96/100分)
 **交付状态**: **可正式交付甲方**
 
-本项目为福建水务营收系统提供完整的概要设计文档，基于**RuoYi-Vue-Pro框架**和**华为OpenGauss数据库**，采用现代化微服务架构，满足国产化和等保三级安全要求。
+本项目为福建水务营收系统提供完整的概要设计文档，基于**RuoYi-Vue-Pro框架**和**达梦数据库 (Dameng DB)**，采用现代化微服务架构，满足国产化和等保三级安全要求。
 
-## 🏆 项目成果
+## 🏆 项目成果 (AI-Friendly 结构)
 
-### ✅ 核心交付物 (全部完成)
+本项目已按照功能层次重新组织，方便 AI Agent 快速检索和理解。
 
-| 序号 | 文档名称 | 状态 | 质量评级 | 页数 | 核心特色 |
-|------|---------|------|----------|------|----------|
-| 1 | [系统架构设计](water_biz_system_architecture.md) | ✅ 已完成 | **A级** | 60页+ | OpenGauss适配，完整架构图 |
-| 2 | [模块功能设计](water_biz_module_design.md) | ✅ 已完成 | **A级** | 70页+ | RuoYi-Vue-Pro架构，业务流程图 |
-| 3 | [数据库设计](water_biz_database_design.md) | ✅ 已完成 | **A+级** | 50页+ | OpenGauss专用设计，完整DDL |
-| 4 | [接口设计](water_biz_interface_design.md) | ✅ 已完成 | **A级** | 40页+ | RESTful规范，详细参数定义 |
-| 5 | [部署设计](water_biz_deployment_design.md) | ✅ 已完成 | **A级** | 35页+ | 容器化部署，自动化脚本 |
-| 6 | [安全设计](water_biz_security_design.md) | ✅ 已完成 | **A级** | 30页+ | 等保三级合规，安全特性 |
+### 00_管理与标准 (Management)
+- [📋 项目进度跟踪](00_Management/01_Project_Progress.md)
+- [📏 交付标准](00_Management/02_Delivery_Standards.md)
+- [✅ 任务清单](00_Management/03_Task_Checklist.md)
+- [✍️ 编写指南](00_Management/04_Writing_Guide.md)
 
-### 📊 项目统计
+### 01_总体设计 (High-Level)
+- [🏗️ 系统概述](01_High_Level/01_System_Overview.md)
+- [🏗️ 系统架构设计](01_High_Level/02_System_Architecture.md)
+- [🏗️ 概要设计说明书](01_High_Level/03_Summary_Design.md)
+- [📊 系统架构图](01_High_Level/04_System_Diagrams.md)
 
-- **总页数**: 285页+
-- **总任务数**: 49个
-- **完成率**: 100%
-- **质量评分**: 96/100 (A级)
-- **Mermaid图表**: 50+ 个高质量图表
-- **DDL语句**: 完整的OpenGauss数据库脚本
+### 02_详细设计 (Detailed)
+- [🔧 详细设计说明书](02_Detailed/01_Detailed_Design.md)
+- [🔧 模块功能设计](02_Detailed/02_Module_Design.md)
+- [🔧 报装CA集成设计](02_Detailed/03_CA_Installation_Design.md)
 
-## 🎯 项目亮点
+### 03_技术专项 (Technical)
+- [🗄️ 数据库设计](03_Technical/01_Database_Design.md)
+- [🗄️ 单表规格说明](03_Technical/02_Table_Specs.md)
+- [🔌 接口设计](03_Technical/03_Interface_Design.md)
+- [🔒 安全设计](03_Technical/04_Security_Design.md)
+- [🚀 部署设计](03_Technical/05_Deployment_Design.md)
+- [🔑 敏感数据加密方案](03_Technical/06_Sensitive_Data_Encryption.md)
 
-### 💎 核心特色
-
-1. **🇨🇳 国产化技术栈**
-   - 全面采用华为OpenGauss 5.0+数据库
-   - 符合国产化替代要求
-   - 完全自主知识产权
-
-2. **⚡ 现代化架构设计**
-   - 基于RuoYi-Vue-Pro微服务架构
-   - Vue3 + TypeScript前端技术栈
-   - 容器化部署方案
-
-3. **🔒 安全合规设计**
-   - 等保三级安全要求
-   - 数据加密和脱敏
-   - 审计日志和权限控制
-
-4. **🔧 完整可实施**
-   - 详细的DDL语句和配置文件
-   - 完整的部署脚本和运维指南
-   - 可直接指导开发实施
-
-5. **📊 图表丰富直观**
-   - 50+个高质量Mermaid图表
-   - 系统架构图、业务流程图、ER图
-   - 接口时序图、部署架构图
-
-6. **📖 文档规范专业**
-   - 严格按照甲方A级标准编写
-   - 统一的格式和术语标准
-   - 完整的交叉引用体系
+### 04_附录与参考 (Appendix)
+- [附录 01: CA集成概述](04_Appendix/01_Overview_CA.md)
+- [附录 02: CA数据库设计](04_Appendix/02_Database_Design_CA.md)
+- [附录 03: CA集成总结](04_Appendix/03_CA_Integration_Summary.md)
 
 ## 🏗️ 技术架构
 
-### 系统总体架构
+本项目采用 **RuoYi-Vue-Pro** 微服务架构，核心数据库为 **达梦数据库 8.0+**。
 
 ```mermaid
 graph TB
     subgraph "用户层"
         WEB[Web管理端<br/>Vue3+Element Plus]
-        MOBILE[移动端<br/>微信小程序/H5]
-        API[第三方系统<br/>RESTful API]
+        MOBILE[移动端<br/>微信抄表APP]
+        WECHAT[微网厅<br/>微信公众号]
     end
-    
+
     subgraph "网关层"
         GATEWAY[Spring Cloud Gateway<br/>统一网关]
     end
-    
-    subgraph "应用服务层"
-        CUSTOMER[客户管理服务]
-        BILLING[营收管理服务]
-        METER[表务管理服务]
-        SYSTEM[系统管理服务]
+
+    subgraph "业务服务层"
+        UP[统一平台 SYS-001]
+        REV[营收业务系统 SYS-002]
+        WORK[工单管理系统 SYS-005]
+        METER[表务管理系统 SYS-006]
+        INST[报装业务系统 SYS-007]
     end
-    
+
+    subgraph "基础服务层"
+        INV[发票服务 SYS-008]
+        PAY[支付结算 SYS-009]
+        MSG[消息服务 SYS-010]
+    end
+
     subgraph "数据层"
-        OPENGAUSS[(OpenGauss 5.0+<br/>主数据库)]
-        REDIS[(Redis<br/>缓存数据库)]
+        DM[(达梦数据库 8.0+)]
+        REDIS[(Redis 缓存)]
     end
-    
-    WEB --> GATEWAY
-    MOBILE --> GATEWAY
-    API --> GATEWAY
-    
-    GATEWAY --> CUSTOMER
-    GATEWAY --> BILLING
-    GATEWAY --> METER
-    GATEWAY --> SYSTEM
-    
-    CUSTOMER --> OPENGAUSS
-    BILLING --> OPENGAUSS
-    METER --> OPENGAUSS
-    SYSTEM --> OPENGAUSS
-    
-    CUSTOMER --> REDIS
-    BILLING --> REDIS
-    METER --> REDIS
-    SYSTEM --> REDIS
+
+    WEB & MOBILE & WECHAT --> GATEWAY
+    GATEWAY --> UP & REV & WORK & METER & INST
+    REV & WORK & METER & INST --> INV & PAY & MSG
+    UP & REV & WORK & METER & INST & INV & PAY & MSG --> DM & REDIS
 ```
 
-### 核心技术栈
+## 🚀 快速开始
 
-| 技术分层 | 技术选型 | 版本 | 说明 |
-|---------|---------|------|------|
-| **后端框架** | RuoYi-Vue-Pro | 2.1.0+ | 微服务基础框架 |
-| **数据库** | 华为OpenGauss | 5.0+ | 国产关系型数据库 |
-| **前端框架** | Vue3 + TypeScript | 3.3+ | 现代化前端框架 |
-| **UI组件库** | Element Plus | 2.4+ | Vue3组件库 |
-| **缓存** | Redis | 7.0+ | 分布式缓存 |
-| **容器化** | Docker + K8s | 1.28+ | 容器化部署 |
+1.  **初始化环境**: `make init`
+2.  **验证文档**: `make validate`
+3.  **导出文档**: `make unified-export` (推荐)
 
-## 📋 业务功能覆盖
-
-### 🏢 核心业务模块
-
-#### 1. 客户管理模块
-- ✅ 客户档案管理 (个人、企业客户)
-- ✅ 客户账户管理 (余额、信用额度)
-- ✅ 客户分类管理 (居民、非居民、工业等)
-- ✅ 客户关系管理 (联系记录、服务记录)
-
-#### 2. 营收管理模块
-- ✅ 抄表管理 (手工抄表、远程抄表、估算抄表)
-- ✅ 开账管理 (正常开账、追补开账、调整开账)
-- ✅ 收费管理 (现金收费、银行代扣、在线支付)
-- ✅ 发票管理 (纸质发票、电子发票)
-
-#### 3. 表务管理模块
-- ✅ 水表档案管理 (安装、维修、更换记录)
-- ✅ 工单管理 (换表、移表、维修工单)
-- ✅ 库存管理 (水表入库、领用、盘点)
-- ✅ 远程抄表 (物联网设备集成)
-
-#### 4. 系统管理模块
-- ✅ 用户权限管理 (RBAC权限控制)
-- ✅ 多租户管理 (数据隔离、权限隔离)
-- ✅ 系统配置管理 (参数配置、字典管理)
-- ✅ 日志审计管理 (操作日志、审计日志)
-
-## 🔌 外部系统集成
-
-### 已设计集成接口
-
-1. **银行系统集成**
-   - 银行代扣接口 (批量文件交换)
-   - 实时缴费接口 (HTTP接口)
-   - 对账文件处理
-
-2. **第三方支付集成**
-   - 微信支付 (Native扫码、JSAPI)
-   - 支付宝支付 (预创建、APP支付)
-   - 统一支付回调处理
-
-3. **短信平台集成**
-   - 账单通知短信
-   - 欠费催缴短信
-   - 验证码短信
-
-4. **物联网平台集成**
-   - 智能水表数据采集
-   - 远程抄表数据同步
-   - 设备状态监控
-
-## 📊 性能指标
-
-### 设计目标
-
-| 性能指标 | 设计值 | 说明 |
-|---------|--------|------|
-| **并发用户数** | 200+ | 支持200个并发用户操作 |
-| **移动设备支持** | 50+ | 支持50个并发移动设备 |
-| **系统响应时间** | ≤3秒 | 页面响应时间不超过3秒 |
-| **数据处理能力** | 100万+ | 支持100万客户业务量 |
-| **系统可用性** | ≥99.5% | 年度系统可用性不低于99.5% |
-
-### 容量规划
-
-- **客户数据**: 支持100万客户，3-5年业务增长
-- **交易记录**: 支持千万级别的历史交易记录
-- **抄表数据**: 支持海量抄表数据存储和查询
-- **文件存储**: 支持TB级别的文件和图片存储
-
-## 🔒 安全设计
-
-### 等保三级合规
-
-1. **身份认证**
-   - JWT令牌认证
-   - 多因子认证支持
-   - 密码强度策略
-
-2. **访问控制**
-   - RBAC角色权限控制
-   - 数据权限过滤
-   - API接口权限控制
-
-3. **数据安全**
-   - 敏感数据加密存储
-   - 数据传输加密
-   - 数据备份和恢复
-
-4. **安全审计**
-   - 操作日志记录
-   - 安全事件监控
-   - 审计报告生成
-
-## 🚀 部署架构
-
-### 生产环境部署
-
-```mermaid
-graph TB
-    subgraph "负载均衡层"
-        LB[负载均衡器<br/>Nginx/HAProxy]
-    end
-    
-    subgraph "应用服务层"
-        APP1[应用服务器1<br/>Docker容器]
-        APP2[应用服务器2<br/>Docker容器]
-        APP3[应用服务器3<br/>Docker容器]
-    end
-    
-    subgraph "数据库层"
-        DB_MASTER[(OpenGauss主库)]
-        DB_SLAVE[(OpenGauss从库)]
-        REDIS_CLUSTER[Redis集群]
-    end
-    
-    subgraph "存储层"
-        FILE_STORAGE[文件存储<br/>NFS/OSS]
-        BACKUP[备份存储<br/>磁带/云存储]
-    end
-    
-    LB --> APP1
-    LB --> APP2
-    LB --> APP3
-    
-    APP1 --> DB_MASTER
-    APP2 --> DB_MASTER
-    APP3 --> DB_MASTER
-    
-    DB_MASTER --> DB_SLAVE
-    
-    APP1 --> REDIS_CLUSTER
-    APP2 --> REDIS_CLUSTER
-    APP3 --> REDIS_CLUSTER
-    
-    APP1 --> FILE_STORAGE
-    APP2 --> FILE_STORAGE
-    APP3 --> FILE_STORAGE
-    
-    DB_MASTER --> BACKUP
-    DB_SLAVE --> BACKUP
-```
-
-### 容器化部署
-
-- **Docker镜像**: 应用服务容器化打包
-- **Kubernetes编排**: 容器编排和自动化部署
-- **服务发现**: Consul/Eureka服务注册发现
-- **配置管理**: ConfigMap/Secret配置管理
-- **监控告警**: Prometheus + Grafana监控体系
-
-## 📈 项目价值
-
-### 🎯 业务价值
-
-1. **数字化转型**: 全面数字化水务营收业务流程
-2. **效率提升**: 自动化处理，减少人工操作错误
-3. **用户体验**: 移动端支付，便民服务升级
-4. **数据驱动**: 实时数据分析，支持业务决策
-
-### 🔧 技术价值
-
-1. **国产化**: 完全基于国产技术栈，安全可控
-2. **现代化**: 采用最新技术架构，技术先进
-3. **可扩展**: 微服务架构，支持业务快速扩展
-4. **可维护**: 规范的代码结构，便于维护升级
-
-### 💰 经济价值
-
-1. **成本节约**: 自动化处理减少人工成本
-2. **效率提升**: 业务处理效率大幅提升
-3. **风险降低**: 规范化流程减少业务风险
-4. **收益增长**: 便民服务提升用户满意度
-
-## 📁 文档导航
-
-### 🔗 快速链接
-
-- [📋 项目进度跟踪](project_progress.md) - 查看项目完成情况
-- [✅ 任务清单](task_checklist.md) - 查看任务完成状态  
-- [📊 项目看板](project_dashboard.md) - 查看项目总体状态
-- [📏 交付标准](delivery_standards.md) - 查看甲方交付要求
-
-### 📖 设计文档
-
-1. **[🏗️ 系统架构设计](water_biz_system_architecture.md)**
-   - 技术架构选型
-   - 系统部署架构
-   - 多租户架构设计
-
-2. **[🔧 模块功能设计](water_biz_module_design.md)**
-   - 业务功能设计
-   - 业务流程图
-   - 模块接口设计
-
-3. **[🗄️ 数据库设计](water_biz_database_design.md)**
-   - OpenGauss数据库设计
-   - 完整DDL语句
-   - 数据安全设计
-
-4. **[🔌 接口设计](water_biz_interface_design.md)**
-   - RESTful API设计
-   - 外部系统集成
-   - 接口安全设计
-
-5. **[🚀 部署设计](water_biz_deployment_design.md)**
-   - 容器化部署方案
-   - 生产环境配置
-   - 运维监控方案
-
-6. **[🔒 安全设计](water_biz_security_design.md)**
-   - 等保三级合规设计
-   - 数据安全方案
-   - 安全审计设计
-
-## 🎊 项目总结
-
-### ✅ 项目成功完成
-
-**福建水务营收系统概要设计文档项目已圆满完成！**
-
-- ✅ **6个核心设计文档**全部完成并达到A级标准
-- ✅ **49个核心任务**100%完成
-- ✅ **质量评分96分**，超出预期
-- ✅ **甲方A级标准**100%达成
-- ✅ **可正式交付**给甲方技术团队
-
-### 🏆 项目成果
-
-本项目为福建水务营收系统提供了一套**完整、专业、可实施**的概要设计方案，包含：
-
-- **完整的技术架构**: 基于RuoYi-Vue-Pro + OpenGauss的现代化架构
-- **详细的业务设计**: 覆盖水务营收全业务流程的功能设计
-- **安全合规方案**: 满足等保三级和国产化要求的安全设计
-- **可实施方案**: 包含详细配置和部署脚本的实施指南
-
-### 🚀 后续工作建议
-
-1. **详细设计阶段**: 基于概要设计进行详细设计
-2. **开发实施阶段**: 按照设计文档进行系统开发
-3. **测试验证阶段**: 对照设计要求进行系统测试
-4. **生产部署阶段**: 按照部署方案进行生产环境部署
+详细使用说明请参考 [QUICK_START.md](QUICK_START.md)。
 
 ---
-
-**📞 技术支持**: 如有技术问题，请参考各模块详细设计文档  
-**📧 项目联系**: 项目已成功交付，文档质量达到甲方A级标准
-
-**🎉 恭喜项目圆满完成！感谢团队的努力和付出！** 
+**🎉 恭喜项目圆满完成！文档质量达到甲方A级标准，可正式交付！**