zizi 33aad93bef 提交全维度文档review后的22项架构决策落地

基于产品/架构/流程/前端/后端五维度并行review，澄清并落地22项关键决策：

架构层：Governance按消费者归属拆散、MetaSchema独立模块、
Source传播改为事件驱动自治、去掉Candidate Decision Envelope
和needs_recheck中间状态、Neo4j决策为依赖RAGFlow GraphRAG

后端层：Entitlement统一为可变表+审计日志、API版本策略采用
X-API-Version Header、知识实体唯一键加scope字段

前端层：SSE实时通信（AI stream独立+事件统一）、正文持久化
IndexedDB安全网、Block粒度为场景/小节级

产品层：范围不变UX解决复杂度、知识确认默认自动+冲突时人工

2026-05-24 04:28:52 +08:00

4.8 KiB

Raw Blame History

整体文档一致性修复

日期：2026-05-24
适用范围：Muse 设计文档整体 review 后的 P0/P1 跨分册一致性修复。
文档性质：项目内 memorys 留痕，用于后续继续设计、review 或进入实现阶段时快速恢复关键边界。

1. 本次修复背景

在阶段 7 前后端架构文档完成后，对 design-docs/ 做了多角度整体 review，发现部分已完成分册之间仍存在 owner、状态、事实写入和产品能力 gate 的 P0 冲突。

本次修复是一次明确的跨阶段一致性修复例外：不是重新设计所有阶段，也不是进入阶段 8 索引整理，而是在用户确认后，按独立 owner 分组修复已经发现的阻断级问题。

2. 本次修复方式

修复任务拆为五个互不重叠的子代理任务：

架构与领域边界：修 架构-01/02/03/04。
后端 Schema/API/模块契约：修 后端-01/02/03/04/05。
产品 02 与市场原型：修 产品-02/02C/02F 和 02F 原型。
流程与专题：修 流程-01A/01B/02A/02B 与 专题-01/02/03/04。
前端文档：修 前端-01/02/03。

主代理最后做跨文档整合，补了 产品-03、来源状态命名和用户可见技术词残留，并更新阶段计划。

3. 已收口的关键口径

后续设计和实现必须继续承接以下结论。

MetaSchema 的逻辑 owner 固定为 Admin/Governance；物理表即使暂落 Content，也只能通过治理 facade 写入。Content 只承载或消费投影。
Agent、Tool Grant、Agent Runtime Permission Envelope 必须分层。AI runtime 只能消费服务端签发的权限包，不能自授权、扩权或绕过 owner 校验。
Market 只负责市场资产、授权、安装记录、来源侧 handoff、授权摘要和跳转审计。目标 owner 自己创建和消费 target precheck/session，Market 不写目标事实。
Import task/context 归 Work/Content；Parse Job、Chapter Parse Result、Chapter Review 归 AI Orchestration；Knowledge 只在章节审阅确认后创建或更新 Knowledge Draft。
动态字段没有跨 owner 的通用写接口。/dynamic-fields/validate 只做校验和路由建议，正式写入必须回到 Content、Planning、Knowledge、Agent 等 owner action。
Accept / Merge 写 Canonical 前必须消费或重算 Candidate Decision Envelope。硬闸门必须覆盖输出合规、静态检查、质量结果版本、来源状态、授权快照、作品资产 feature gate、expectedRevision 和幂等结果。（ADR-018 已决策去掉独立 Candidate Decision Envelope 概念封装，改为接受时实时对比来源状态；Agent Runtime Permission Envelope 仍保留，两者是不同概念。专题文档已同步更新。）
作品资产当前只允许阅读、收藏和授权记录。模板化、参考来源写入、AI 上下文绑定必须等待后续 feature gate、作品 owner 入口、使用检查、来源谱系、API/Schema 和失败回退闭合。
SourceStatus、SourceEventType、SourceActionPolicy 必须分层表达。SourceStatus 包含 delisted；SourceActionPolicy 包含 read_only，不能把 allowed/blocked/needs_recheck 当成来源事实状态。
来源撤权、召回、下架、阻断、owner 缺失和授权失效会影响候选接受、Local KB 来源型确认、生成上下文、绑定、导出任务和已签发下载凭证，但不能自动回滚已确认 Canonical。
用户可见原型和前端文案不能暴露 handoff token、precheckId、Tool Grant、Runtime Permission Envelope 等技术合同名；界面应使用跳转授权、使用检查、工具权限摘要、运行权限摘要等产品语言。

4. 后续继续时先检查

继续阶段 8 或进入实现阶段前，先检查：

design-docs/临时-产品形态阶段化重设计计划.md 中 D-045 和 C-006。
产品-02C/02F/03 中作品资产是否仍保持只读/收藏/授权记录的默认 gate。
后端-05 中动态字段是否仍没有跨 owner 泛写接口。
专题-01、流程-02B 和 前端-02 是否仍要求 Candidate Decision Envelope 硬闸门。（ADR-018 已决策去掉独立 Candidate Decision Envelope，改为实时对比；Agent Runtime Permission Envelope 仍保留。）
架构-01/02/04、后端-03/04/05、专题-03 是否仍统一 SourceStatus / SourceEventType / SourceActionPolicy。
阶段 8 已在 D-046 开始补 00-文档大纲.md 和 内容映射表.md 的四仓工程架构索引；后续仍需继续复核其他过期引用和 owner 映射。

5. 验证方式

本次修复完成后已执行：

git diff --check
阶段 8 文件未修改检查。
作品资产误开放关键词扫描。
动态字段泛写入口扫描。
SourceStatus / SourceEventType / SourceActionPolicy 旧口径扫描。
原型用户可见技术词扫描。

4.8 KiB Raw Blame History Unescape Escape