2026-09-17-document-consistency-remediation.md 3.4 KB

文档口径一致性整改实施计划

For Codex: REQUIRED SUB-SKILL: Use executing-plans to implement this plan task-by-task.

目标: 将当前项目治理文档、Demo 验收口径、模块状态元数据和文档校验工具同步到 develop@924d843 的可验证事实,同时保留历史材料的追溯价值。

方法: 以《项目总控入口》和《功能模块总进度表》作为唯一当前事实源。HIS 四模块保持 整改中(Demo),直至宿主视觉走查留存证据;仅更新当前口径或增加追溯说明,绝不倒改历史审查结论和生产业务裁定。

技术范围: Markdown、目录名称与 Node.js 文档链接校验脚本;不修改病案复印页面功能、旧源码、真实接口或生产配置。


Task 1: 建立可重复的文档校验基线

Files:

  • Modify: 04-新项目源码_source/项目源码/pri-smart-hospital-miniprogram/scripts/validate-doc-links.js
  • Test: 以仓库根目录执行该脚本

Steps:

  1. 修正脚本的仓库根目录解析,使其覆盖四个既定文档根目录。
  2. 先运行验证,确认现有三个静态审查链接因路径错误而失败。
  3. 修复静态审查记录中的相对链接。
  4. 再运行校验,确认无断链。

Task 2: 同步唯一当前状态与源码证据

Files:

  • Modify: 01-项目文档_docs/00-项目管理/项目总控入口.md
  • Modify: 01-项目文档_docs/00-项目管理/03-交付验收/功能模块总进度表.md
  • Modify: 4 个 HIS Demo 模块目录及其状态元数据
  • Rename: 4 个 开发中(Demo)_MRC-PC-* 目录为 整改中(Demo)_MRC-PC-*

Steps:

  1. 写明 HIS 源码整改和离线自检已合入 develop@924d843,但没有宿主视觉验收证据,状态不越级。
  2. 将进度表的分支/基线改为可验证集成提交和当前待办。
  3. 同步四模块的目录、README、规格 YAML、分支记录和复审记录为 整改中(Demo)。
  4. 新增当前同步风险,不倒改已关闭的历史问题记录。

Task 3: 同步授权 Demo 的验收与模块范围

Files:

  • Modify: 01-项目文档_docs/00-项目管理/03-交付验收/Demo MVP验收执行清单.md
  • Modify: MRC-PC-ORDER-001/002/003 的当前 Demo 说明、页面清单和状态矩阵

Steps:

  1. 明确驳回、改价、批量、交付变更、撤销/回退、预览均可作为 HIS 端本地 Mock 演示。
  2. 保留真实 HIS、支付、物流、身份、病案、网络和持久化的禁止边界。
  3. 将验收路径改为覆盖授权的关键节点,而不把这些节点误列为不可用。

Task 4: 收口小程序状态、历史基线和历史材料标识

Files:

  • Modify: 7 个小程序模块的 08-OpenSpec与分支.md;必要时 MRC-MP-ORDER-001 当前口径
  • Modify: 01-项目文档_docs/07-项目记录/README.md 或适当索引文件

Steps:

  1. 将小程序模块的当前状态统一为 开发中(Demo),并保留历史基线仅作追溯。
  2. 在进度表中区分“实现集成提交”与“当前分支基线”,避免旧提交被误作当前 HEAD。
  3. 为未来日期预生成材料建立显式索引/警示,不逐份修改历史记录。

Task 5: 复核、集成与提交

Steps:

  1. 运行链接校验、11 个 Demo OpenSpec strict 校验、状态/禁止范围扫描和 git diff --check。
  2. 复核 HIS 8 个离线用例并核对 develop 当前提交。
  3. 提交整改分支,串行合并回 develop,再次验证后推送。