emoon-backend/docs/governance/存量文档迁移记录.md

历史文档盘点与迁移建议

项	内容
文档定位	基于 Docs as Code 生命周期规范，对现有 docs/ 历史文档进行分类、归属和迁移建议
生成日期	2026-06-17
依据	docs/文档中心.md、docs/governance/文档分类.md、docs/governance/元数据规范.md、docs/governance/生命周期流程.md
当前策略	已完成第一批元数据补充和第二批专题索引，暂不直接移动历史文件

1. 总体结论

当前 docs/ 下的历史文档主要问题不是“文档数量多”，而是缺少稳定主线：

• 同一需求的需求文档、设计文档、接口文档、开发计划分散在多个目录。
• 绝大多数历史文档没有 doc_id、feature_id、type、status 等元数据。
• 需求文档、架构文档、接口文档 目录按粗粒度类型堆放，无法表达需求生命周期。
• 历史开发计划已迁入对应 docs/initiatives/<feature_id>/dev-progress/ 目录。
• OpenAPI、接口说明、前端接入、后端技术设计之间有关联，但依赖关系只能靠文件名判断。
• 存在 .DS_Store 等系统文件，后续可清理。

建议按“先索引、再补元数据、最后迁移”的方式整理：

1. 建立本盘点文档，先形成全局视图。已完成。
2. 为核心历史文档补 Front Matter，不移动文件。已完成第一批。
3. 创建 docs/initiatives/<feature_id>/专题索引.md 作为专题索引。已完成第一批。
4. 将历史文档在专题索引中关联起来。
5. 确认没有外部链接依赖后，再分批移动文档。

2. 建议专题主线

2.1 FEAT-202605-001-ai-future-hospital-platform

定位：医梦 AI 未来医院总体方案、AI 中台二期三期、空海会议后的动线感知方案。

建议目录：

docs/initiatives/FEAT-202605-001-ai-future-hospital-platform/

建议纳入：

当前文档	建议类型	建议状态	说明
docs/initiatives/FEAT-202605-001-ai-future-hospital-platform/需求文档.md	prd	approved	总体业务和方案口径
docs/initiatives/FEAT-202605-001-ai-future-hospital-platform/概要设计.md	outline-design 或 design	approved	二期三期技术方案和商业闭环设计
docs/initiatives/FEAT-202605-001-ai-future-hospital-platform/meeting-notes/空海会议动线感知影响说明.md	meeting 或 design	approved	会议结论到需求、架构、接口的映射
docs/initiatives/FEAT-202605-001-ai-future-hospital-platform/research/感知动线视频脚本.md	research	draft	感知动线视频脚本，可作为展示材料
docs/initiatives/FEAT-202605-001-ai-future-hospital-platform/research/感知动线演示.html	research	draft	感知动线演示资产
docs/initiatives/FEAT-202605-001-ai-future-hospital-platform/assets/*.png	assets	不适用	架构图和方案图，应被专题 README 引用

缺口：

• 缺少标准 需求录入.md。
• 缺少专题 专题索引.md。
• 缺少明确的 测试计划.md 和 测试结果.md。
• 若未来继续推进实现，应拆出更小的子 feature_id。

2.2 FEAT-202606-001-unified-entry-client

定位：统一入口客户端、终端 Web Demo、挂号演示闭环、前后端联调契约。

建议目录：

docs/initiatives/FEAT-202606-001-unified-entry-client/

建议纳入：

当前文档	建议类型	建议状态	说明
docs/initiatives/FEAT-202606-001-unified-entry-client/需求文档.md	prd	approved	演示范围、关键流程和边界
docs/initiatives/FEAT-202606-001-unified-entry-client/详细设计.md	outline-design 或 detailed-design	approved	统一入口完整技术方案
docs/initiatives/FEAT-202606-001-unified-entry-client/design/前端工程启动指南.md	detailed-design	approved	前端工程结构和启动规范
docs/initiatives/FEAT-202606-001-unified-entry-client/前端接入指引.md	api 或 detailed-design	approved	前端接入、鉴权、SSE 和卡片约定
docs/initiatives/FEAT-202606-001-unified-entry-client/MVP接口契约.md	api	approved	MVP 接口契约
docs/api/openapi/医梦AI中台开放平台接口-v1.2.openapi.yaml	api	approved	OpenAPI 契约
docs/initiatives/FEAT-202606-001-unified-entry-client/对外接口联调基准.md	api	approved	对外接口联调基准
docs/initiatives/FEAT-202606-001-unified-entry-client/dev-progress/终端客户端MVP实施计划.md	dev-progress	implemented	终端客户端 MVP 实施计划
docs/initiatives/FEAT-202606-001-unified-entry-client/dev-progress/演示闭环纵向任务拆分.md	dev-progress	implemented	纵向任务拆分
docs/initiatives/FEAT-202606-001-unified-entry-client/dev-progress/终端Web演示实施计划.md	dev-progress	implemented	前端 Web Demo 实施计划
docs/initiatives/FEAT-202606-001-unified-entry-client/dev-progress/统一入口挂号演示实施计划.md	dev-progress	implemented	挂号演示闭环实施计划
docs/initiatives/FEAT-202606-001-unified-entry-client/design/终端Web演示设计.md	design	approved	Web Demo UI 设计规格

缺口：

• 缺少标准 需求录入.md。
• 缺少专题 专题索引.md 汇总索引。
• 缺少统一的 测试计划.md 和 测试结果.md，当前验证信息分散在开发计划中。
• 建议为 OpenAPI 和 Markdown 接口文档建立明确主从关系：OpenAPI 为准，Markdown 记录联调说明。

2.3 FEAT-202606-002-fastgpt-integration

定位：FastGPT 作为医梦 AI Agent 实现层之一接入。

建议目录：

docs/initiatives/FEAT-202606-002-fastgpt-integration/

建议纳入：

当前文档	建议类型	建议状态	说明
docs/initiatives/FEAT-202606-002-fastgpt-integration/FastGPT接入技术方案.md	outline-design 或 detailed-design	reviewing	接入方案、边界和实现建议

缺口：

• 缺少 需求录入.md 和 需求文档.md。
• 缺少 ADR。该文档涉及外部系统接入和架构边界，建议补 ADR-202606-001-fastgpt-integration.md。
• 缺少接口契约文档。若接入已经进入实现，应补 接口说明.md 或适配器接口说明。
• 缺少测试计划和测试结果。

2.4 FEAT-202606-003-sqlite-his-mock-mcp-tools

定位：SQLite Mock HIS、MCP Tool、挂号演示的工具链能力。

建议目录：

docs/initiatives/FEAT-202606-003-sqlite-his-mock-mcp-tools/

建议纳入：

当前文档	建议类型	建议状态	说明
docs/initiatives/FEAT-202606-003-sqlite-his-mock-mcp-tools/dev-progress/SQLite-HIS-Mock-MCP工具实施计划.md	detailed-design 或 dev-progress	implemented	SQLite HIS Mock 和 MCP Tools 实施计划

缺口：

• 建议作为 FEAT-202606-001-unified-entry-client 的子专题关联。
• 缺少 需求录入.md、需求文档.md、测试结果.md。
• 如果该能力后续会保留为正式 Mock HIS 工具，应补充 接口说明.md 和运行手册。

2.5 FEAT-202606-004-opd-triage-agent

定位：门诊分诊智能体 Prompt。

建议目录：

docs/initiatives/FEAT-202606-004-opd-triage-agent/

建议纳入：

当前文档	建议类型	建议状态	说明
docs/initiatives/FEAT-202606-004-opd-triage-agent/分诊智能体提示词.md	prompt	approved	Dify 分诊智能体 System Prompt

缺口：

• 缺少 需求录入.md，无法追溯 Prompt 需求来源。
• 缺少 需求文档.md，需要明确适用科室、禁用行为、验收标准。
• 缺少 测试计划.md 和 测试结果.md，建议补充典型症状、红旗症状、多轮上下文测试集。

2.6 FEAT-202605-002-knowledge-base-frontend

定位：知识库管理模块前端页面生成提示词。

建议目录：

docs/initiatives/FEAT-202605-002-knowledge-base-frontend/

建议纳入：

当前文档	建议类型	建议状态	说明
docs/initiatives/FEAT-202605-002-knowledge-base-frontend/知识库管理前端提示词.md	prompt 或 api	draft	Vue 前端生成提示词，包含知识库 API 清单和页面结构

缺口：

• 缺少需求来源和当前实现状态。
• 文档同时包含 Prompt、API、前端页面设计，建议拆分为 需求文档.md、接口说明.md、详细设计.md 或保留为历史 Prompt 并补元数据。

3. 长期规范和工程治理文档

这些文档不应归入单个需求专题，建议迁移到长期目录。

当前文档	建议目标	建议类型	说明
docs/standards/AI中台工程约束.md	docs/standards/AI中台工程约束.md	standard	工程红线、模块边界、接口归属
docs/standards/工程规约生效说明.md	docs/standards/工程规约生效说明.md	standard	规约生效机制和架构测试说明
docs/architecture/legacy/历史架构违规基线.txt	docs/architecture/legacy/历史架构违规基线.txt	standard	历史违规基线
docs/architecture/legacy/历史基线治理计划.md	docs/architecture/legacy/历史基线治理计划.md	dev-progress 或 standard	历史基线治理计划
docs/agents/domain.md	docs/agents/domain.md	standard	Agent 领域文档索引，保留原位
docs/agents/issue-tracker.md	docs/agents/issue-tracker.md	standard	本地议题追踪规范，保留原位
docs/agents/triage-labels.md	docs/agents/triage-labels.md	standard	议题标签规范，保留原位

缺口：

• docs/standards/ 目录尚未创建。
• 长期规范也应补 Front Matter，但通常不需要 feature_id。
• 历史基线治理若继续推进，可以单独创建一个治理专题。

4. 模板和治理文档

以下文档是当前 Docs as Code 体系本身的规范和模板，保留原位：

当前文档	类型	说明
docs/文档中心.md	standard	生命周期总入口
docs/governance/文档分类.md	standard	分类和编号规则
docs/governance/元数据规范.md	standard	元数据规范
docs/governance/生命周期流程.md	standard	生命周期流程
docs/templates/*.md	模板	生命周期文档模板

建议后续为 docs/governance/*.md 补充 Front Matter。

5. 建议迁移批次

第一批：只补元数据，不移动文件（已完成）

目标：降低风险，让 Agent 先能基于 doc_id、type、status 检索。

优先文档：

• docs/initiatives/FEAT-202605-001-ai-future-hospital-platform/需求文档.md：已补 PRD-202605-001
• docs/initiatives/FEAT-202605-001-ai-future-hospital-platform/概要设计.md：已补 ODS-202606-001
• docs/standards/AI中台工程约束.md：已补 STD-202605-001
• docs/standards/工程规约生效说明.md：已补 STD-202605-002
• docs/initiatives/FEAT-202606-001-unified-entry-client/需求文档.md：已补 PRD-202606-001
• docs/initiatives/FEAT-202606-001-unified-entry-client/详细设计.md：已补 DDS-202606-001
• docs/initiatives/FEAT-202606-001-unified-entry-client/MVP接口契约.md：已补 API-202606-001
• docs/initiatives/FEAT-202606-001-unified-entry-client/对外接口联调基准.md：已补 API-202606-002
• docs/initiatives/FEAT-202606-002-fastgpt-integration/FastGPT接入技术方案.md：已补 DDS-202606-002
• docs/initiatives/FEAT-202606-004-opd-triage-agent/分诊智能体提示词.md：已补 PMT-202606-001
• docs/initiatives/FEAT-202605-002-knowledge-base-frontend/知识库管理前端提示词.md：已补 PMT-202605-001
• docs/initiatives/FEAT-202605-001-ai-future-hospital-platform/meeting-notes/空海会议动线感知影响说明.md：已补 MTG-202606-001
• docs/initiatives/FEAT-202605-001-ai-future-hospital-platform/research/感知动线视频脚本.md：已补 RSH-202606-001
• docs/initiatives/FEAT-202606-001-unified-entry-client/design/前端工程启动指南.md：已补 DDS-202606-003
• docs/initiatives/FEAT-202606-001-unified-entry-client/前端接入指引.md：已补 API-202606-003
• docs/initiatives/FEAT-202606-001-unified-entry-client/dev-progress/终端客户端MVP实施计划.md：已补 DEV-202605-001
• docs/initiatives/FEAT-202606-001-unified-entry-client/dev-progress/演示闭环纵向任务拆分.md：已补 DEV-202606-001
• docs/initiatives/FEAT-202606-001-unified-entry-client/dev-progress/终端Web演示实施计划.md：已补 DEV-202606-002
• docs/initiatives/FEAT-202606-001-unified-entry-client/dev-progress/统一入口挂号演示实施计划.md：已补 DEV-202606-003
• docs/initiatives/FEAT-202606-003-sqlite-his-mock-mcp-tools/dev-progress/SQLite-HIS-Mock-MCP工具实施计划.md：已补 DEV-202606-004
• docs/initiatives/FEAT-202606-001-unified-entry-client/design/终端Web演示设计.md：已补 DES-202606-001

说明：docs/api/openapi/医梦AI中台开放平台接口-v1.2.openapi.yaml 是 OpenAPI 契约文件， 本批次未直接写入 Markdown Front Matter，避免改变接口契约结构；通过专题索引进行关联。

第二批：建立专题索引（已完成）

目标：不移动历史文档，只创建 docs/initiatives/<feature_id>/专题索引.md，把现有文档挂进去。

建议先建：

• FEAT-202605-001-ai-future-hospital-platform
• FEAT-202605-002-knowledge-base-frontend
• FEAT-202606-001-unified-entry-client
• FEAT-202606-002-fastgpt-integration
• FEAT-202606-003-sqlite-his-mock-mcp-tools
• FEAT-202606-004-opd-triage-agent

第三批：补生命周期缺口

目标：为仍在推进的专题补齐关键文档。

优先补：

专题	优先补充
AI 未来医院总体方案	需求录入.md、专题 专题索引.md
统一入口客户端	专题 专题索引.md、测试计划.md、测试结果.md
FastGPT 接入	需求录入.md、需求文档.md、ADR、测试计划.md
分诊智能体	需求文档.md、测试计划.md、测试结果.md

第四批：移动文件

目标：在确认没有外部链接依赖后，将历史文档逐步移动到新目录。

移动时应遵守：

• 原位置保留迁移说明或索引链接。
• PR 中明确列出旧路径和新路径。
• 同步更新所有内部链接。
• OpenAPI 文件移动前，确认生成脚本、前端 SDK、接口文档引用路径不会断。

6. 当前阶段判断

当前阶段：历史文档整理的“盘点阶段”。

已有文档：

• Docs as Code 生命周期手册
• 文档分类、元数据、生命周期规范
• 多类生命周期模板
• 本历史文档盘点与迁移建议
• 第一批核心历史文档 Front Matter
• docs/initiatives/ 专题索引

缺口：

• 尚未为全部历史文档补 Front Matter。
• 尚未为每个专题补齐 需求录入.md、测试计划.md、测试结果.md 等生命周期缺口。
• 尚未建立 docs/standards/ 和 docs/api/ 新目录。
• 尚未处理 .DS_Store 等非文档文件。

下一步：

1. 为仍在推进的专题补 需求录入.md、测试计划.md、测试结果.md。
2. 为剩余历史文档补 Front Matter。
3. 建立 docs/standards/ 和 docs/api/ 新目录，但移动前先确认引用。
4. 最后决定是否移动旧目录中的文件。

警示：

不要直接大规模移动历史文档。当前很多文档互相引用旧路径，直接移动会破坏现有链接和 Agent 读取习惯。