weichen
647da98577
Why: Define the approved direction for one rule-driven Word renderer, all-template onboarding, human-readable traceability, and review-aware delivery before implementation starts. Evidence: SELF documentation checks passed for relative links, balanced code fences, JSON parsing, manifest SHA256 coverage, and git diff whitespace. Impact: Adds a 12-document review set and immutable review manifest; no runtime code, migration, deployment, or published rule changes. Refs: feature/rdm-two-trees-latest-templates
3.6 KiB
3.6 KiB
05 生命周期与流程
1. 文档生命周期
source-md draft
→ render preview
→ submit review
→ reviewer comments / tracked changes
→ author revision
→ review accepted
→ approval decision
→ approved + review artifacts frozen
→ superseded or retired by explicit change
文档内容、渲染规则和审签轮次是三个独立版本维度。任何一个变化都会生成新的 RenderRequest 和交付物，不覆盖先前批准文件。
2. 起草流程
- 成员或智能体创建 Markdown 候选。
- 系统为标题、段落、表格等节点分配稳定 ID。
- 来源材料进入笔记树，内容节点进入文档树，来源边进入追溯网。
- ProfileResolver 根据四级优先级选择规则并显示选择原因。
- 生成前检查必填字段、映射、来源权限和风险。
- WordAdapter 生成预览稿和诊断。
- 用户在阅读器和 Word 预览中检查内容与版式。
3. 提交审阅
提交动作冻结：
- Markdown 内容版本及哈希。
- CanonicalDocument 哈希。
- RenderProfile 快照及哈希。
- 模板和资产哈希。
- 文档树节点集合。
- 来源可见范围。
- 编制、审阅和批准职责。
冻结后发生的新编辑进入下一草稿，不改变本轮审阅对象。
4. 审阅循环
审阅人可以：
- 对节点或文本范围添加批注。
- 回复批注。
- 提出插入、删除、替换或移动建议。
- 将批注标记为已处理、拒绝或仍待处理。
- 退回修改或通过审阅。
编制人处理建议时形成新内容版本；系统保留修改前后、操作者、时间、原因、批注和来源关系。重新提交生成新审阅轮次或同轮修订，具体由项目策略配置，但不得覆盖旧修订。
5. 批准和双 Word 交付
批准人只能批准已经通过必需审阅、没有阻塞项且规则校验成功的冻结对象。批准事务完成后生成：
- 干净批准稿：接受已批准修订，显示正式文件控制和签署信息。
- 审阅留痕稿：保留修订、批注、回复、作者和时间。
- Markdown 源文件。
- 生成清单。
输出生成失败时批准决定仍保留，但交付状态为 generation-failed，不得伪装成已经交付；修复渲染问题后以同一冻结输入幂等重试。
6. 规则升级流程
- 提出规则升级提案，绑定旧规则、新规则、示例文档和影响分析。
- 生成新旧规则对照预览和诊断差异。
- 人工确认后发布新规则版本。
- 新文档默认使用新版本。
- 已有草稿可以显式升级；批准文档不自动升级。
- 升级后的文档重新进入审阅与批准。
7. 默认规则流程
普通文档未绑定专用规则时使用公司通用规则。系统必须在 UI 和清单中显示“公司通用规则”，不能让用户误认为采用了某个专用受控模板。
8. 用户上传参考文档生成规则（后续）
上传原件
→ 安全解析与原件保全
→ 样式/结构/资产分析
→ 生成候选规则与识别报告
→ 样例 Markdown 预览
→ 人工对照和修正规则
→ 自动校验
→ 管理员发布
候选规则始终是 draft。模型分析结果附置信度和未识别项；宏、外链、嵌入对象和未知 XML 明确隔离。没有人工评审和校验不得进入 published。
9. 下载体验
用户可选择：
- 下载 Markdown。
- 下载当前 Word。
- 下载批准稿。
- 下载审阅留痕稿。
- 下载全部交付包。
下载前重新检查当前权限。已撤权用户不能凭旧链接继续下载；历史交付物字节不因撤权而改变。