fujian_water_biz_doc/00_Management/07_Migration_Mapping_Template.md

2.4 KiB

福建水务营收系统文档迁移映射表模板

1. 使用说明

  • 本模板用于目录整理、文件迁移、编号调整、引用修复等结构性变更。
  • 每次结构调整必须新建一个“批次记录”,并在完成后归档到项目进度。
  • 迁移时必须保证 Markdown 与同名 _images/ 目录成组处理。

2. 批次信息

项目 内容
批次编号 DG-YYYYMMDD-01
变更主题 目录治理批次(示例)
发起日期 YYYY-MM-DD
执行人 待填写
复核人 待填写
状态 进行中 / 已完成

3. 迁移映射明细

序号 旧路径 新路径 对象类型 是否含 _images 链接修复状态 编号同步状态 执行人 复核结果
1 旧文件路径 新文件路径 正式文档 / Archive / 附件 是 / 否 未开始 / 已完成 不涉及 / 已完成 待填写 待复核

4. 引用修复清单

序号 受影响文件 引用类型 修复前 修复后 验证结果
1 00_Management/04_Writing_Guide.md 相对路径 旧引用 新引用 通过 / 未通过

5. 校验记录

校验项 命令 结果 时间 备注
单文档校验 make validate-file FILE=<目标文件> 通过 / 未通过 YYYY-MM-DD HH:mm
全库链接校验 make check-links 通过 / 未通过 YYYY-MM-DD HH:mm
Mermaid 校验 make validate-mermaid 通过 / 未通过 YYYY-MM-DD HH:mm
AI 治理基线校验 make check-ai-governance 通过 / 未通过 YYYY-MM-DD HH:mm

6. 风险与回退

风险项 触发条件 应对策略 回退动作
图片失链 _images 未同步迁移 补迁并批量修复引用 回退到迁移前路径
章节锚点失效 标题重命名未同步 全文检索并修复锚点 恢复旧标题并逐步迁移
口径冲突 主文档与历史文档冲突 以主文档统一口径为准 暂停发布并复核

7. 收口确认

完成前需全部勾选:

  • 迁移映射表字段已完整填写
  • 所有受影响链接已修复并验证通过
  • 模块/接口编号及正文引用已同步
  • 00_Management/01_Project_Progress.md 已登记
  • 00_Management/03_Task_Checklist.md 已勾选