oh-my-muse/design-docs/内容映射表.md

内容映射表（New-Design(新设计) V2）

• 版本：v5
• 更新日期：2026-05-19
• 目标读者：文档维护者/架构/前端/后端/产品
• 阅读时间：10–15 分钟
• 边界说明：本文件只做“内容归属与迁移策略”定义，不承载业务/架构细节；细节必须落到对应 V2 文档里，避免重复。

核心原则（别把简单事做复杂）

• 单一归属：一个概念只能有一个“主文档”，其他地方只能引用。
• 消灭特殊情况：重复解释=坏味道；用引用替代复制。
• 角色分离：产品/架构/后端/前端/流程各写各的，越界内容一律改为引用。

V2 目标文件清单（角色前缀 + 扁平结构）

• 入口：00-文档大纲.md
• 产品：
  • 产品-01-产品定位与核心价值.md
  • 产品-02-核心功能与交互边界.md
  • 产品-03-用户旅程与操作流程.md
• 架构：
  • 架构-01-系统全貌与边界上下文.md
  • 架构-02-核心数据结构与双轨模型.md
  • 架构-03-关键决策与原则(ADR).md
  • 架构-04-状态机与约束清单.md
• 后端：
  • 后端-01-领域模型与聚合设计.md
  • 后端-02-工程结构与模块职责.md
  • 后端-03-关键流程实现与接口契约.md
  • 后端-04-统一数据库Schema-v1.md
  • 后端-05-统一API契约-v1.md
• 前端：
  • 前端-01-工程结构与核心依赖.md
  • 前端-02-编辑器与影子层交互.md
  • 前端-03-元引擎与动态表单.md
• 流程：
  • 流程-01-产品操作流程(用户视角).md
  • 流程-02-系统处理流程(系统视角).md
• 专题：
  • 专题-01-正文建议接受(Accept Suggestion)实现规范.md
  • 专题-02-Sudowrite对标与Muse产品取舍.md
  • 专题-03-AI编排上下文与质量评测实现规范.md
• dev 路线图：
  • doc/dev/00-项目真实现状与目标差距.md
  • doc/dev/01-总体路线图与阶段依赖.md
  • doc/dev/02-S0-基础设施补齐.md 到 doc/dev/09-验收口径与退出条件.md

新产品形态内容归属（正式文档）

说明：

• 本节归属新增的新产品形态(Product Shape)内容，不属于历史 doc/new-design/ 迁移表，避免和旧源文档映射冲突。
• 临时改造文档删除后，以这里指向的正式文档为归属入口；本表只做导航，不重复定义字段、状态机、接口或表结构。

内容	正式归属	Notes
新产品形态(Product Shape)总体定义	产品-01 / 产品-02 / 产品-03 / 架构-01 / doc/dev/00 / doc/dev/01 / doc/dev/09	产品文档定义角色、价值和旅程；架构文档定义系统边界；dev 文档只承载阶段影响面和验收门禁，不写成新的工程大阶段。
管理员控制台(Admin Console)	产品-02 / 架构-01 / 后端-05 / 前端-01	产品-02 定功能边界；架构-01 定系统边界；后端-05 定接口；前端-01 定信息架构。
我的作品(My Works)	产品-02 / 产品-03 / 流程-01 / 前端-01	只做作品列表与入口；单作品深层流程归作品工作台。
作品工作台(Work Workspace)	产品-03 / 流程-01 / 前端-02	承载写作、规划、知识、导入、导出、记录与用量的单作品创作空间。
作品规划台(Planning Desk)	产品-02 / 产品-03 / 架构-02 / 前端-03	产品定义用户语言和 AI 辅助边界；模型归属仍看 架构-02，前端动态表单看 前端-03。
知识与一致性	产品-02 / 流程-01 / 架构-02 / 前端-02 / 后端-05	产品和流程定义用户动作；模型边界看 架构-02；编辑器侧交互看 前端-02；接口看 后端-05。
全局知识库(Global Knowledge Base) / 局域知识库(Local Knowledge Base)	架构-01 / 架构-02 / 后端-04 / 后端-05	架构定义边界和模型归属；表结构以 后端-04 为准；接口以 后端-05 为准。
个人中心(Personal Center)	产品-02 / 前端-01 / 后端-05 / doc/dev/09	承载个人信息、用量、配额、套餐、生成记录总览和授权摘要；不承载单作品深层创作或管理员配置。
使用日志	产品-02 / 后端-05 / 前端-01	普通用户可见的生成记录、任务记录、令牌(Token)使用和成本提示；系统审计不混入普通用户入口。
Sa-Token 认证授权基座	架构-01 / 架构-03 / 后端-01 / 后端-02 / 后端-04 / 后端-05 / 前端-01 / doc/dev/01 / doc/dev/09	Sa-Token 只负责登录认证、RBAC、接口鉴权、会话、当前用户和基础审计上下文；不替代 Muse 产品架构和 Shadow -> Canonical 业务规则。
AI 编排、检索上下文和质量评测合同	专题-03 / 流程-02 / 后端-03 / 后端-04 / 后端-05	专题-03 收束 RAGFlow、Graph Query Provider、Context Assembly、Agent/Prompt、Risk Routing、评测聚合和默认超级管理员初始化的跨文档目标设计；精确表结构和 API 仍看 后端-04 / 后端-05。

信息架构门禁归属

信息架构门禁(Information Architecture Gate, IA Gate)属于产品形态与文档对齐门禁，不是新的工程实现大阶段，也不重排 S0-S5 技术依赖。

Gate	正式归属	Notes
IA-0：角色边界与信息架构重构	doc/dev/01 / doc/dev/09 / 产品-02 / 架构-01 / 前端-01 / 后端-05	验收管理员、普通用户、个人中心的入口和权限边界。
IA-1：普通用户作品工作台	doc/dev/01 / doc/dev/09 / 产品-02 / 产品-03 / 流程-01 / 前端-01 / 前端-02	验收我的作品、作品工作台及单作品深层流程归属。
IA-2：管理员控制台	doc/dev/01 / doc/dev/09 / 产品-02 / 架构-01 / 流程-02 / 前端-01 / 后端-05	验收管理员配置能力、权限、审计和接口归属。
IA-3：作品规划台和高质量小说维度	doc/dev/01 / doc/dev/09 / 产品-02 / 产品-03 / 架构-02 / 前端-03	验收作品规划维度是否进入 AI 辅助、上下文或检查链路。

映射总表（Source → Target → Notes）

说明：

• 策略：保留=尽量原样迁移；改写=按 V2 边界重写；引用=只保留一句话 + 指向主文档。
• “主文档”负责给出定义/动机/约束；其他文档只能引用，不得重复解释。
• 本节只处理历史 doc/new-design/ 到 V2 文档的迁移；新产品形态和 IA gate 看上面的正式归属表。

doc/new-design/00-文档大纲设计.md

Source 章节	Target	策略	Notes
文档目标与读者/总体统计	00-文档大纲.md	改写	只保留“目标/读者/导航”，删除历史统计噪音。
各文档详细大纲	00-文档大纲.md	改写	作为 V2 索引骨架；文件名改为 V2。
ADR(架构决策记录) 列表与格式	架构-03-关键决策与原则(ADR).md	改写	ADR(架构决策记录) 是架构主文档；其他地方只能引用 ADR(架构决策记录) 编号。

doc/new-design/01-概要设计.md

Source 章节	Target	策略	Notes
1 系统定位与核心价值	产品-01-产品定位与核心价值.md	改写	去掉实现细节；保留“为谁/解决什么/价值”。
2 核心概念（总览）	架构-02-核心数据结构与双轨模型.md	改写	概念主文档归架构；产品文档只引用。
2.1 Canonical(规范数据) vs Shadow(待审层)	架构-02-核心数据结构与双轨模型.md	保留/改写	定义/边界/数据流规则在此；前后端分别写实现引用。
2.2 Block(文本块)（细粒度内容单元）	架构-02-核心数据结构与双轨模型.md + 后端-01-领域模型与聚合设计.md	改写	架构只说“数据结构与不变式”；后端说“聚合/版本/冲突”。
2.3 Knowledge Graph	架构-02-核心数据结构与双轨模型.md + 后端-01-领域模型与聚合设计.md	改写	架构：三层结构与能力边界；后端：实体/关系/存储策略。
2.4 Meta-driven(元结构驱动)	架构-02-核心数据结构与双轨模型.md + 前端-03-元引擎与动态表单.md	改写	架构：为什么；前端：怎么渲染；后端如涉及 schema 聚合再引用。
3 架构原则	架构-03-关键决策与原则(ADR).md	改写	原则要短、可执行；删除重复论述，保留检查清单。
4 顶层架构图/有界上下文	架构-01-系统全貌与边界上下文.md	改写	只保留 BC(有界上下文) 边界/协作规则；实现细节一律引用后端/前端。
4.2/4.3 数据流向总结	架构-01-系统全貌与边界上下文.md + 架构-02-核心数据结构与双轨模型.md	改写	“系统视角链路”放架构-01；“模型规则”放架构-02。
5 ADR(架构决策记录) 全部	架构-03-关键决策与原则(ADR).md	保留/改写	统一 ADR(架构决策记录) 编号与链接；产品/前后端引用编号即可。

doc/new-design/02-架构设计.md

Source 章节	Target	策略	Notes
1 技术栈选型（后端）	后端-02-工程结构与模块职责.md	改写	只保留“依赖/模块/职责”；把“为什么”留在 ADR(架构决策记录)。
1 技术栈选型（前端）	前端-01-工程结构与核心依赖.md	改写	依赖清单/目录结构归前端-01。
1 数据栈/AI 栈/Key 管理	后端-03-关键流程实现与接口契约.md	改写	这是后端契约与安全边界的一部分，不进架构文档。
2 部署架构（Docker Compose 等）	后端-02-工程结构与模块职责.md	引用	V2 不重复贴大段 compose；只保留入口与关键约束，必要时指向旧文档历史。
3 外部集成（New-API(接口)/Dify/Ragflow）	后端-03-关键流程实现与接口契约.md	改写	以“接口契约/失败模式/边界”组织，而不是配置粘贴。
4 数据架构（Schema(结构定义)/Redis/pgvector(向量扩展)）	架构-02-核心数据结构与双轨模型.md + 后端-01-领域模型与聚合设计.md	改写	架构讲模型与规则；后端讲落地与表/索引。
5 安全与认证	后端-03-关键流程实现与接口契约.md	改写	后端主文档；架构文档只引用安全边界。

doc/new-design/03-领域设计.md

Source 章节	Target	策略	Notes
DDD(领域驱动设计) 设计哲学/聚合根原则/BC(有界上下文) 划分	后端-01-领域模型与聚合设计.md + 架构-01-系统全貌与边界上下文.md	改写	BC(有界上下文) 边界归架构-01；聚合/不变式归后端-01。
Content BC(内容上下文) / Knowledge BC(知识上下文) / Admin BC(管理上下文) / AI BC(人工智能上下文) 模型	后端-01-领域模型与聚合设计.md	保留/改写	结构保留，术语统一为 V2；去掉与流程重复解释。
跨上下文协作/事件驱动/接口隔离	架构-01-系统全貌与边界上下文.md + 后端-03-关键流程实现与接口契约.md	改写	架构只定义协作规则；后端定义接口契约与事务边界。

doc/new-design/04-前端工程结构.md

Source 章节	Target	策略	Notes
技术架构/依赖/目录结构	前端-01-工程结构与核心依赖.md	保留/改写	保留可执行信息；删除与后端/部署无关噪音。
编辑器子系统（ParagraphBlock/插件/状态）	前端-02-编辑器与影子层交互.md	改写	以“编辑体验 + Shadow(待审层) 交互”为主线。
影子存储（Zustand(状态库)/TanStack Query(Query缓存库)）	前端-02-编辑器与影子层交互.md	改写	只讲前端侧的数据拥有与同步策略。
元引擎（Meta Engine(元引擎)）/动态表单	前端-03-元引擎与动态表单.md	保留/改写	与架构-02 的 Meta-driven(元结构驱动) 概念互相引用，不重复定义。

doc/new-design/05-后端工程结构.md

Source 章节	Target	策略	Notes
Maven(构建工具) 多模块/目录结构/包规范	后端-02-工程结构与模块职责.md	保留/改写	这是后端工程主入口；别把流程/产品混进来。
Spring AI 集成/配置	后端-03-关键流程实现与接口契约.md	改写	以“调用链路/失败模式/Key 边界”为主。
关键服务（Ner/Consistency/ShadowRepo）	后端-03-关键流程实现与接口契约.md	改写	以流程阶段组织；服务实现细节少说，多说契约与边界。
API(接口) 端点清单	后端-03-关键流程实现与接口契约.md	改写	收敛成“端点/输入输出/权限/事务边界”表格。

doc/new-design/06-产品操作流程.md

Source 章节	Target	策略	Notes
流程总览/用户旅程地图	产品-03-用户旅程与操作流程.md + 流程-01-产品操作流程(用户视角).md	改写	产品文档给“旅程/决策点”；流程文档给“步骤化可执行流程”。
主流程详解（步骤 1-5）	流程-01-产品操作流程(用户视角).md	保留/改写	按步骤重写，补齐输入/输出与决策点。
UI(界面) 交互关键点（Editor/ShadowPanel）	产品-02-核心功能与交互边界.md + 前端-02-编辑器与影子层交互.md	改写	产品只定义边界与行为；前端说实现机制。
用户决策点（触发AI/冲突处理）	产品-02-核心功能与交互边界.md + 流程-01-产品操作流程(用户视角).md	改写	决策点应短且明确；技术解释引用架构/后端。

doc/new-design/07-业务处理流程.md

Source 章节	Target	策略	Notes
流程总览/五阶段模型	流程-02-系统处理流程(系统视角).md	保留/改写	这是系统视角主文档，按 Phase 组织。
Phase I–V 核心流程	流程-02-系统处理流程(系统视角).md + 后端-03-关键流程实现与接口契约.md	改写	流程文档讲“状态机/数据流”；后端文档讲“接口/事务/错误”。
数据流转/一致性保证	架构-02-核心数据结构与双轨模型.md + 后端-03-关键流程实现与接口契约.md	改写	模型规则归架构-02；一致性手段归后端-03。
触发机制/事件总线/未来智能体编排	架构-03-关键决策与原则(ADR).md + 后端-03-关键流程实现与接口契约.md	引用	未来项别在流程文档里发散；留 ADR(架构决策记录)/后端引用。

重复概念的“主文档”归属（强制）

• 双轨（Canonical(规范数据)/Shadow(待审层)）：主文档 架构-02-核心数据结构与双轨模型.md
• 有界上下文（BC(有界上下文)）与协作规则：主文档 架构-01-系统全貌与边界上下文.md
• ADR(架构决策记录)/原则：主文档 架构-03-关键决策与原则(ADR).md
• 产品旅程与决策点：主文档 产品-03-用户旅程与操作流程.md（步骤细化在 流程-01）
• 系统五阶段处理模型：主文档 流程-02-系统处理流程(系统视角).md
• AI 编排、检索上下文和质量评测合同：主文档 专题-03-AI编排上下文与质量评测实现规范.md
• 状态机与约束：主文档 架构-04-状态机与约束清单.md
• 后端模块职责：主文档 后端-02-工程结构与模块职责.md
• 统一数据库表结构：主文档 后端-04-统一数据库Schema-v1.md
• 统一接口(API)契约：主文档 后端-05-统一API契约-v1.md
• 产品形态与 IA gate：主文档 doc/dev/01-总体路线图与阶段依赖.md 和 doc/dev/09-验收口径与退出条件.md