fujian_water_biz_doc/output/02_Module_Traceability_Index_processed.md

9.5 KiB
Raw Blame History

title, author, date, documentclass, geometry, fontsize, mainfont, CJKmainfont
title author date documentclass geometry fontsize mainfont CJKmainfont
02_Module_Traceability_Index 系统设计团队 2024年12月19日 article margin=1in 11pt PingFang SC PingFang SC

doc_id: DT-02-TRACE doc_role: support_document authority: secondary scope: 详细设计追溯索引 source_of_truth: false last_reviewed: 2026-03-11 retrieval_priority: P1

福建水务营收系统模块追溯索引

章节导航(精简)

文档定位

本文档用于提供“模块编号 → 主详设章节 → 关键接口 → 关键数据域”的统一检索入口,服务于:

  1. 需求评审与影响范围分析;
  2. 开发联调阶段的问题定位;
  3. AI Agent 检索时的快速跳转。

边界说明:

  • 本文档是追溯索引,不替代主详设内容;
  • 详细设计权威口径以 01_Detailed_Design.md 为准;
  • 模块正文承载于 11_UP_Detailed.md12_REV_Detailed.md13_CS_Detailed.md14_METER_Detailed.md15_INST_Detailed.md
  • 数据表字段定义以 03_Technical_Design/01_Database_Design.md 为主,03_Technical_Design/02_Table_Specs.md 仅用于历史映射补充;
  • 接口参数细项以 03_Technical_Design/03_Interface_Design.md 为准。

追溯使用规则

  1. 先按模块编号定位至主详设章节,再查看接口与数据域映射;
  2. 发现模块描述与接口/数据口径冲突时,以主详设为第一参照,并同步修订技术专项文档;
  3. 本文档仅保留“可追溯最小必要信息”,不重复搬运完整设计正文;
  4. 基础服务子系统SYS-008/009/010在详细设计层按接口协同描述不在此索引中虚增平行模块。
  5. 架构图层面的完整模块枚举以 ../01_Overview/05_Module_Inventory.md 为核对入口;本索引只保留当前详细设计实际承接的模块与必要映射说明。

子系统级追溯矩阵

子系统/能力域 模块范围 模块正文定位 主要技术专题
统一平台 UP-001 ~ UP-004 统一平台模块正文 接口设计安全设计
营收业务 REV-001 ~ REV-009 营收业务模块正文 数据库设计接口设计
客户服务 CS-001 ~ CS-007 客户服务模块正文 接口设计安全设计
表务管理 METER-001 ~ METER-003 表务模块正文 数据库设计接口设计
报装与签章 INST-001 ~ INST-003 报装与签章模块正文 CA 补充说明安全设计

架构图模块承接映射

架构图对象 当前详设承接方式 说明
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 接口与协同承接 当前不在详细设计目录新增平行主稿,主要在概要、接口和相关业务正文中描述

模块级追溯矩阵

模块编号 模块名称 模块正文定位 关键数据域(摘要) 关键接口编号(摘要) 主要协同对象
UP-001 统一认证与单点登录 章节 用户、令牌、登录日志 IF-UP-001IF-UP-002 各接入端、统一平台
UP-002 组织用户与权限管理 章节 组织、岗位、角色、权限 IF-UP-003 各业务模块
UP-003 参数字典与基础配置 章节 字典、价格、地址、任务参数 IF-UP-004 营收、表务、报装
UP-004 审计监控与运维支撑 章节 操作日志、接口日志、任务日志 IF-UP-003(审计关联) 运维平台、消息服务
REV-001 客户资料管理 章节 客户、账户、联系人、绑定关系 IF-REV-001 客户服务、表务、报装
REV-002 抄表开账 章节 抄表任务、读数、账单主明细 IF-REV-004IF-REV-005 抄表APP、IoT、表务
REV-003 营业收费 章节 营业账、交易流水、回调记录 IF-REV-006 SYS-009 支付结算
REV-004 账务处理 章节 账单调整、日志、审批留痕 IF-REV-007 财务、营收后台
REV-005 发票与税务处理 章节 发票主记录、税率、开票信息 IF-REV-008 SYS-008 发票服务
REV-006 催缴与通知 章节 欠费账单、催缴结果 IF-REV-009 SYS-010 消息服务
REV-007 统计分析 章节 客户、抄表、收费、渠道聚合 IF-REV-010 报表与管理端
REV-008 代收与银行业务 章节 渠道、签约、批次、对账、结算 IF-REV-011 银行、SYS-009
REV-009 业务参数配置 章节 参数配置、页面配置、价格模板 IF-REV-012 统一平台、营收模块
CS-001 账户绑定管理 章节 渠道绑定、客户账户 IF-CS-001 微信、支付宝、微网厅
CS-002 信息查询服务 章节 账单、缴费、发票、流水 IF-CS-002 客户渠道、营收系统
CS-003 在线缴费服务 章节 订单、交易、回调 IF-CS-003 SYS-009 支付结算
CS-004 电子发票服务 章节 发票申请、税率、下载记录 IF-CS-004 SYS-008 发票服务
CS-005 营业网点服务 章节 网点信息、业务范围 IF-CS-005 客户渠道
CS-006 业务办理服务 章节 办理申请、办理状态 IF-CS-006 工单系统、消息服务
CS-007 柜面扫码支付 章节 柜面订单、流水、核销状态 IF-CS-007 营业厅、SYS-009
METER-001 表务基础管理 章节 基础参数、水表主档、状态 IF-METER-001 营收、报装
METER-002 仓库与库存管理 章节 库存、出入库、退库、报废 IF-METER-003 仓储管理端
METER-003 设备档案管理 章节 设备档案、工单留痕、远程同步 IF-METER-001IF-METER-002IF-METER-004 工单系统、移动作业、IoT 平台
INST-001 报装流程管理 章节 申请单、资料附件、踏勘方案 IF-INST-001IF-INST-002 柜台、微网厅、政务、报装人员
INST-002 工程管理 章节 施工节点、验收结果、签章协同 IF-INST-003IF-INST-004IF-INST-005 表务、客户建档、泛微 CA
INST-003 档案管理 章节 档案、回执、过程日志 IF-INST-005 报装、档案管理

维护机制

更新本索引时遵循以下顺序:

  1. 先更新 01_Detailed_Design.md 中模块主内容;
  2. 再同步本索引中的“模块定位/接口编号/数据域摘要”;
  3. 如涉及接口变化,同步更新 03_Technical_Design/03_Interface_Design.md
  4. 完成后至少执行:
    • make validate-file FILE=docs/design/02_Detailed_Design/01_Detailed_Design.md
    • make validate-file FILE=docs/design/02_Detailed_Design/02_Module_Traceability_Index.md
    • make check-links