{
  "version": "1.0.0",
  "kind": "codebase",
  "project": {
    "name": "如愿知识库",
    "languages": [
      "markdown"
    ],
    "frameworks": [
      "Understand-Anything",
      "Obsidian"
    ],
    "description": "按需求文档、里程碑、技术文档、测试相关、Agent检索组织的流程式知识库。",
    "analyzedAt": "2026-05-26T10:06:42.129970+00:00",
    "gitCommitHash": ""
  },
  "nodes": [
    {
      "id": "doc:00_首页/Agent问答入口",
      "type": "document",
      "name": "Agent 问答入口",
      "filePath": "00_首页/Agent问答入口.md",
      "summary": "当用户询问业务或项目流程时，Agent 应先检索本知识库 Markdown 文件，再组织回答。",
      "tags": [
        "00_首页",
        "Agent检索"
      ],
      "complexity": "simple",
      "knowledgeMeta": {
        "content": "---\ntype: agent_entry\ntags: [Agent, 问答, 检索]\naliases: [问答入口, Agent入口]\nsource: manual\nstatus: active\nowner: 内部技术团队\nupdated: 2026-05\n---\n\n# Agent 问答入口\n\n当用户询问业务或项目流程时，Agent 应先检索本知识库 Markdown 文件，再组织回答。\n\n## 推荐检索顺序\n\n1. `05_需求文档/`：持续新增的业务需求、业务规则、需求变更。\n2. `06_里程碑/`：项目节点、阶段计划、阶段评审、上线节奏。\n3. `07_技术文档/`：架构、接口、数据模型、实现方案、技术决策。\n4. `08_测试相关/`：测试计划、测试用例、缺陷、验收、上线检查。\n5. `02_项目管理流程/`：阶段、角色、交付物、门禁、检查清单。\n6. `01_业务流程/`：具体业务流程、业务对象、业务规则。\n7. `04_Agent检索/`：关键词、同义词、回答规则、来源索引。\n8. `03_规范与模板/`：需要产出文档或表单时检索。\n\n## 回答格式\n\n- 先给结论。\n- 再按阶段、负责人、输入、关键动作、输出、检查点说明。\n- 最后注明来源文件。\n- 若知识库没有明确记录，回答“知识库未明确记录”，并说明建议补充到哪个文件。\n\n## 示例问题\n\n- 一个内部系统需求从提出到上线要走哪些阶段？\n- 阶段2.5测试提前补漏要产出什么？\n- 业务主管在项目入口分级中负责什么？\n- 什么时候需要前端提前参与需求收敛？\n- 新增一条业务规则后，怎么验证 Agent 能搜到？\n- 某个业务规则应该补充到哪个模板里？\n- 某个需求对应哪些测试用例？\n- 某个模块有哪些接口说明？\n- 这个项目当前处在哪个里程碑？\n\n## 业务补充验证入口\n\n- 需求文档目录：`05_需求文档/`\n- 里程碑目录：`06_里程碑/`\n- 技术文档目录：`07_技术文档/`\n- 测试相关目录：`08_测试相关/`\n- 需求文档索引：`05_需求文档/需求文档索引.md`\n- 测试用例索引：`08_测试相关/测试用例索引.md`\n- 模板：`03_规范与模板/业务规则与需求补充模板.md`\n- 流程：`04_Agent检索/知识库持续更新与验证流程.md`\n- 记录：`01_业务流程/业务补充验证记录.md`\n",
        "wikilinks": [],
        "category": "layer-overview"
      }
    },
    {
      "id": "doc:00_首页/知识地图",
      "type": "document",
      "name": "知识地图",
      "filePath": "00_首页/知识地图.md",
      "summary": "- [[../知识库使用说明|知识库使用说明]]",
      "tags": [
        "00_首页"
      ],
      "complexity": "simple",
      "knowledgeMeta": {
        "content": "---\ntype: map\ntags: [知识地图, 导航]\naliases: [知识库地图]\nsource: manual\nstatus: active\nowner: 内部技术团队\nupdated: 2026-05\n---\n\n# 知识地图\n\n## 使用说明\n\n- [[../知识库使用说明|知识库使用说明]]\n- [[../Git使用说明|Git 使用说明]]\n\n## 需求文档\n\n- [[../05_需求文档/README|需求文档入口]]\n- [[../05_需求文档/需求文档索引|需求文档索引]]\n- [[../03_规范与模板/需求说明模板|需求说明模板]]\n- [[../03_规范与模板/业务规则与需求补充模板|业务规则与需求补充模板]]\n- [[../01_业务流程/业务规则索引|业务规则索引]]\n- [[../01_业务流程/业务对象字典|业务对象字典]]\n\n## 里程碑\n\n- [[../06_里程碑/README|里程碑入口]]\n- [[../06_里程碑/里程碑索引|里程碑索引]]\n- [[../06_里程碑/阶段计划模板|阶段计划模板]]\n- [[../06_里程碑/里程碑评审记录|里程碑评审记录]]\n- [[../02_项目管理流程/AI驱动内部系统开发流程_V3_总览|项目管理流程总览]]\n- [[../02_项目管理流程/阶段交付物清单|阶段交付物清单]]\n- [[../02_项目管理流程/项目检查清单|项目检查清单]]\n\n## 技术文档\n\n- [[../07_技术文档/README|技术文档入口]]\n- [[../07_技术文档/技术文档索引|技术文档索引]]\n- [[../07_技术文档/系统架构说明模板|系统架构说明模板]]\n- [[../07_技术文档/接口说明模板|接口说明模板]]\n- [[../07_技术文档/技术决策记录|技术决策记录]]\n\n## 测试相关\n\n- [[../08_测试相关/README|测试相关入口]]\n- [[../08_测试相关/测试用例索引|测试用例索引]]\n- [[../08_测试相关/测试用例模板|测试用例模板]]\n- [[../08_测试相关/测试计划模板|测试计划模板]]\n- [[../08_测试相关/缺陷记录模板|缺陷记录模板]]\n- [[../08_测试相关/验收记录模板|验收记录模板]]\n- [[../08_测试相关/上线检查模板|上线检查模板]]\n- [[../02_项目管理流程/阶段2.5_测试提前补漏|阶段2.5 测试提前补漏]]\n- [[../02_项目管理流程/阶段4_测试培训上线回流|阶段4 测试培训上线回流]]\n\n## Agent 检索\n\n- [[../04_Agent检索/检索说明|检索说明]]\n- [[../04_Agent检索/问答提示词|问答提示词]]\n- [[../04_Agent检索/关键词索引|关键词索引]]\n- [[../04_Agent检索/同义词表|同义词表]]\n- [[../04_Agent检索/来源文件索引|来源文件索引]]\n- [[../04_Agent检索/知识库持续更新与验证流程|持续更新与验证流程]]\n",
        "wikilinks": [],
        "category": "layer-overview"
      }
    },
    {
      "id": "doc:00_首页/知识库首页",
      "type": "document",
      "name": "如愿知识库首页",
      "filePath": "00_首页/知识库首页.md",
      "summary": "本知识库用于沉淀如愿内部系统建设中的业务流程、项目管理流程、角色职责、交付物、检查清单与 Agent 检索问答规范。",
      "tags": [
        "00_首页"
      ],
      "complexity": "simple",
      "knowledgeMeta": {
        "content": "---\ntype: index\ntags: [知识库, 首页, 如愿]\naliases: [如愿知识库首页, 知识库入口]\nsource: manual\nstatus: active\nowner: 内部技术团队\nupdated: 2026-05\n---\n\n# 如愿知识库首页\n\n本知识库用于沉淀如愿内部系统建设中的业务流程、项目管理流程、角色职责、交付物、检查清单与 Agent 检索问答规范。\n\n## 快速入口\n\n- [[../知识库使用说明|知识库使用说明]]\n- [[知识地图]]\n- [[Agent问答入口]]\n- [[../05_需求文档/README|需求文档]]\n- [[../06_里程碑/README|里程碑]]\n- [[../07_技术文档/README|技术文档]]\n- [[../08_测试相关/README|测试相关]]\n- [[../04_Agent检索/检索说明|Agent 检索说明]]\n\n## 当前权威来源\n\n- 项目管理流程：`AI_驱动_内部系统开发流程_V3.docx`\n- 适用范围：ERP、内部系统、小型业务系统、运营工具、AI 辅助开发项目。\n\n## 使用原则\n\n1. 需求类问题先查需求文档。\n2. 进度、节点、准入问题先查里程碑。\n3. 技术实现、接口、架构问题先查技术文档。\n4. 测试范围、用例、验收、缺陷问题先查测试相关。\n5. Agent 回答必须说明来源文件。\n6. 知识库没有明确记录时，不要猜测，应提示补充位置。\n",
        "wikilinks": [],
        "category": "layer-overview"
      }
    },
    {
      "id": "doc:02_项目管理流程/AI驱动内部系统开发流程_V3_总览",
      "type": "document",
      "name": "AI 驱动内部系统开发流程 V3 总览",
      "filePath": "02_项目管理流程/AI驱动内部系统开发流程_V3_总览.md",
      "summary": "本流程适用于公司当前阶段的 ERP、内部系统、小型业务系统、运营工具、AI 辅助开发项目。",
      "tags": [
        "02_项目管理流程"
      ],
      "complexity": "simple",
      "knowledgeMeta": {
        "content": "---\ntype: process_overview\ntags: [项目管理流程, AI驱动开发, ERP, 内部系统]\naliases: [AI驱动内部系统开发流程, 内部系统开发流程V3, ERP开发流程]\nsource: AI_驱动_内部系统开发流程_V3.docx\nstatus: active\nowner: 内部技术团队\nupdated: 2026-05\n---\n\n# AI 驱动内部系统开发流程 V3 总览\n\n## 版本定位\n\n本流程适用于公司当前阶段的 ERP、内部系统、小型业务系统、运营工具、AI 辅助开发项目。\n\n核心目标不是让流程变复杂，而是解决以下问题：\n\n- 业务需求说不清。\n- AI 生成内容不完整。\n- 前端模型介入太晚。\n- 后端数据库设计被页面倒逼。\n- 测试太晚才发现需求漏项。\n- 项目完成后留下大量重复代码和技术债。\n\n## 总体阶段\n\n| 阶段 | 阶段名称 | 核心目标 | 核心负责人 |\n|---|---|---|---|\n| 阶段0 | 项目入口分级 | 判断项目是否值得做、走轻流程还是完整流程 | 业务主管 / 技术负责人 |\n| 阶段1 | 业务需求完整形成 | 业务侧通过 Vibe Coding 跑完整需求 | 业务主管 / 业务人员 |\n| 阶段2 | 高保真模型与业务对象确认 | 把完整但粗糙的需求收敛成可开发模型 | 前端 / 产品经理 |\n| 阶段2.5 | 测试提前补漏 | 在开发前用测试视角发现需求漏洞 | 测试 |\n| 阶段3 | 研发协作与正式开发 | 基于高保真模型进行模块化、安全、可维护开发 | 前端 / 后端 / 算法 |\n| 阶段4 | 测试、培训、上线、回流 | 完成测试、培训、上线验收和问题回流 | 测试 / 业务主管 |\n| 阶段5 | 技术债治理与能力沉淀 | 清理 AI 冗余代码并沉淀复用能力 | 技术负责人 |\n\n## 阶段门禁\n\n| 门禁 | 通过标准 |\n|---|---|\n| Gate 0 | 项目入口通过：确认值得做，确认项目类型。 |\n| Gate 1 | 需求完整通过：主流程、分支、页面、按钮、字段、状态大致完整。 |\n| Gate 2 | 高保真模型通过：页面收敛、按钮行为、业务对象、状态、V1/V2 明确。 |\n| Gate 2.5 | 测试补漏：测试用例初稿发现的阻塞问题已处理。 |\n| Gate 3 | 开发联调通过：前后端、数据库、权限、安全、主要流程联调完成。 |\n| Gate 4 | 上线验收通过：测试通过、业务确认、培训完成。 |\n| Gate 5 | 技术债治理完成：重复代码、组件、接口、数据结构完成治理或进入债务池。 |\n\n## 完整版文件结构\n\n- `00_项目入口分级.md`\n- `01_主流程说明.md`\n- `02_日常操作页面结构.md`\n- `03_功能页面按钮盘点表.md`\n- `04_分支流程_XXX.md`\n- `05_异常流程_XXX.md`\n- `06_VibeCoding页面验证记录.md`\n- `07_高保真模型.html`\n- `07_高保真模型说明.md`\n- `08_项目周期与版本确认.md`\n- `09_前端技术评审.md`\n- `10_技术预检记录.md`\n- `10A_统一业务对象模型.md`\n- `10B_按钮行为矩阵.md`\n- `11_测试用例初稿与需求补漏.md`\n- `12_研发任务拆分与协作计划.md`\n- `13_技术实现对接.md`\n- `14_代码治理与安全规范.md`\n- `15_开发问题与联调记录.md`\n- `16_正式测试报告.md`\n- `17_内部培训手册.md`\n- `18_上线验收记录.md`\n- `19_上线问题与回流需求.md`\n- `20_技术债清单.md`\n- `21_业务原子能力沉淀清单.md`\n- `22_组件库与服务复用清单.md`\n- `23_AI开发上下文模板更新记录.md`\n\n## 轻量版文件结构\n\n小项目可以使用轻量版：\n\n- `00_项目入口分级.md`\n- `01_业务需求包.md`\n- `02_高保真模型包.md`\n- `03_项目版本与技术预检.md`\n- `04_测试用例初稿与需求补漏.md`\n- `05_研发协作与技术实现包.md`\n- `06_代码治理与安全规范.md`\n- `07_测试培训上线包.md`\n- `08_技术债与能力沉淀包.md`\n\n## 最终核心原则\n\n- 先分级，再开发。\n- 阶段1追求需求完整，不追求产品完善。\n- Vibe Coding 页面只是需求原型，不直接进入生产。\n- 阶段2追求模型高效，前端必须深度参与。\n- 高保真模型确认后，才允许正式开发。\n- 统一业务对象模型是页面、接口、数据库、测试、AI 提示词的共同基础。\n- 性能、安全、权限、并发、日志、可回滚必须提前预检。\n- 测试提前补漏，不只是上线前找 Bug。\n- 研发阶段以代码质量、模块化、安全性、可维护性为中心。\n- AI 代码必须治理，不能直接堆进生产。\n- 每个项目都要沉淀业务原子能力。\n- 每完成 3-4 个项目，必须进行技术债治理。\n\n## 一句话总结\n\n这套流程不是为了让 AI 替代开发，而是让 AI 帮业务更快形成完整需求，让前端和产品把需求收敛成高保真模型，让研发团队基于模型高质量开发，让测试和技术债治理保障系统长期可用。\n\n## 关联条目\n\n- [[阶段0_项目入口分级]]\n- [[阶段1_业务需求完整形成]]\n- [[阶段2_高保真模型与业务对象确认]]\n- [[阶段2.5_测试提前补漏]]\n- [[阶段3_研发协作与正式开发]]\n- [[阶段4_测试培训上线回流]]\n- [[角色职责矩阵]]\n- [[阶段交付物清单]]\n- [[项目检查清单]]\n",
        "wikilinks": [],
        "category": "layer-milestones"
      }
    },
    {
      "id": "doc:02_项目管理流程/README",
      "type": "document",
      "name": "项目管理流程",
      "filePath": "02_项目管理流程/README.md",
      "summary": "本目录基于 `AI_驱动_内部系统开发流程_V3.docx` 拆解，用于指导 ERP、内部系统、小型业务系统、运营工具、AI 辅助开发项目。",
      "tags": [
        "02_项目管理流程"
      ],
      "complexity": "simple",
      "knowledgeMeta": {
        "content": "---\ntype: index\ntags: [项目管理流程, AI驱动开发]\naliases: [项目管理流程入口, 开发流程入口]\nsource: AI_驱动_内部系统开发流程_V3.docx\nstatus: active\nowner: 内部技术团队\nupdated: 2026-05\n---\n\n# 项目管理流程\n\n本目录基于 `AI_驱动_内部系统开发流程_V3.docx` 拆解，用于指导 ERP、内部系统、小型业务系统、运营工具、AI 辅助开发项目。\n\n## 阶段文件\n\n- [[AI驱动内部系统开发流程_V3_总览]]\n- [[阶段0_项目入口分级]]\n- [[阶段1_业务需求完整形成]]\n- [[阶段2_高保真模型与业务对象确认]]\n- [[阶段2.5_测试提前补漏]]\n- [[阶段3_研发协作与正式开发]]\n- [[阶段4_测试培训上线回流]]\n\n## 重组索引\n\n- [[角色职责矩阵]]\n- [[阶段交付物清单]]\n- [[项目检查清单]]\n- [[常见问题FAQ]]\n\n## 核心原则\n\n先分级，再开发。阶段1追求需求完整，不追求产品完善。高保真模型确认后，才允许正式开发。测试要提前补漏。AI 代码必须治理，不能直接堆进生产。\n",
        "wikilinks": [],
        "category": "layer-milestones"
      }
    },
    {
      "id": "doc:02_项目管理流程/常见问题FAQ",
      "type": "document",
      "name": "常见问题 FAQ",
      "filePath": "02_项目管理流程/常见问题FAQ.md",
      "summary": "通常经过阶段0项目入口分级、阶段1业务需求完整形成、阶段2高保真模型与业务对象确认、阶段2.5测试提前补漏、阶段3研发协作与正式开发、阶段4测试培训上线回流。文档还定义了阶段5技术债治理与能力沉淀。",
      "tags": [
        "02_项目管理流程"
      ],
      "complexity": "simple",
      "knowledgeMeta": {
        "content": "---\ntype: faq\ntags: [项目管理流程, FAQ, 问答]\naliases: [流程常见问题, 项目管理问答]\nsource: AI_驱动_内部系统开发流程_V3.docx\nstatus: active\nowner: 内部技术团队\nupdated: 2026-05\n---\n\n# 常见问题 FAQ\n\n## 一个内部系统需求从提出到上线要走哪些阶段？\n\n通常经过阶段0项目入口分级、阶段1业务需求完整形成、阶段2高保真模型与业务对象确认、阶段2.5测试提前补漏、阶段3研发协作与正式开发、阶段4测试培训上线回流。文档还定义了阶段5技术债治理与能力沉淀。\n\n来源：[[AI驱动内部系统开发流程_V3_总览]]\n\n## 阶段0项目入口分级由谁负责？\n\n由业务主管和技术负责人共同负责。业务主管判断业务价值和范围，技术负责人判断技术复杂度和风险。\n\n来源：[[阶段0_项目入口分级]]、[[角色职责矩阵]]\n\n## 业务需求完整形成阶段的目标是什么？\n\n业务侧通过 Vibe Coding 跑完整需求。阶段1追求需求完整，不追求产品完善。\n\n来源：[[阶段1_业务需求完整形成]]\n\n## 阶段2.5测试提前补漏应该在什么时候发生？\n\n发生在高保真模型确认后、正式开发前。\n\n来源：[[阶段2.5_测试提前补漏]]\n\n## 阶段2.5测试提前补漏要产出什么？\n\n主要产出 `11_测试用例初稿与需求补漏.md`，并形成需求补漏记录、阻塞问题清单和已关闭问题清单。\n\n来源：[[阶段2.5_测试提前补漏]]、[[阶段交付物清单]]\n\n## 什么时候需要前端提前参与需求收敛？\n\n阶段2必须由前端深度参与。若需求涉及多页面、复杂交互、权限、状态流转、数据结构或组件复用，前端应在需求收敛时提前参与。\n\n来源：[[阶段2_高保真模型与业务对象确认]]\n\n## 研发协作与正式开发阶段如何保证模块化、安全和可维护？\n\n依赖统一业务对象模型、研发任务拆分、技术实现对接、代码治理与安全规范、开发问题与联调记录。AI 代码必须经过治理，不能直接堆进生产。\n\n来源：[[阶段3_研发协作与正式开发]]\n\n## 上线前需要检查哪些事项？\n\n至少检查正式测试、主流程、分支流程、权限、异常、数据边界、内部培训手册、业务确认、上线问题回流机制。\n\n来源：[[阶段4_测试培训上线回流]]、[[项目检查清单]]\n\n## Vibe Coding 页面能不能直接进入生产？\n\n不能。Vibe Coding 页面只是需求原型，不直接进入生产。\n\n来源：[[阶段1_业务需求完整形成]]、[[AI驱动内部系统开发流程_V3_总览]]\n",
        "wikilinks": [],
        "category": "layer-milestones"
      }
    },
    {
      "id": "doc:02_项目管理流程/角色职责矩阵",
      "type": "document",
      "name": "角色职责矩阵",
      "filePath": "02_项目管理流程/角色职责矩阵.md",
      "summary": "业务主管保证方向正确、主流程清楚、需求不漏大块。",
      "tags": [
        "02_项目管理流程"
      ],
      "complexity": "simple",
      "knowledgeMeta": {
        "content": "---\ntype: responsibility_matrix\ntags: [项目管理流程, 角色职责, RACI]\naliases: [角色职责, 职责矩阵, RACI]\nsource: AI_驱动_内部系统开发流程_V3.docx\nstatus: active\nowner: 内部技术团队\nupdated: 2026-05\n---\n\n# 角色职责矩阵\n\n## 总览\n\n| 角色 | 主要负责阶段 | 核心职责 | 典型产出 |\n|---|---|---|---|\n| 业务主管 | 阶段0、阶段1、阶段4 | 判断项目价值、明确主流程、确认业务完整性、上线验收 | 项目入口分级、主流程说明、业务验收口径、上线验收记录 |\n| 业务人员 | 阶段1 | 补充分支流程、提供样本数据、验证真实操作路径 | 分支流程、异常流程、Vibe Coding 页面验证记录 |\n| 产品经理 | 阶段2 | 收敛需求、组织高保真模型、明确版本范围 | 高保真模型说明、项目周期与版本确认 |\n| 前端 | 阶段2、阶段3 | 深度参与模型收敛、页面结构、按钮行为、组件复用、前端开发 | 高保真模型、前端技术评审、按钮行为矩阵、前端实现 |\n| 后端 | 阶段3 | 设计接口、数据库、权限、安全、日志、回滚和服务能力 | 技术实现对接、后端服务、接口和数据库方案 |\n| 算法 | 阶段3 | 判断是否需要 AI，设计输入输出、置信度、人工审核和风险控制 | 算法适用性判断、算法输入输出说明、置信度规则 |\n| 测试 | 阶段2.5、阶段4 | 提前写测试用例、发现需求漏洞、正式测试、培训材料、上线反馈 | 测试用例初稿、正式测试报告、内部培训手册、上线问题回流 |\n| 技术负责人 | 阶段0、阶段5 | 技术分级、风险判断、技术债治理和能力沉淀 | 技术债清单、业务原子能力沉淀清单、组件库与服务复用清单 |\n\n## 业务主管\n\n业务主管保证方向正确、主流程清楚、需求不漏大块。\n\n职责：\n\n- 判断项目是否值得做。\n- 定义主流程。\n- 定义日常操作入口。\n- 明确业务人员每天先看什么页面。\n- 拆分分支流程，指定业务人员补充。\n- 确认异常流程。\n- 确认业务完整性。\n- 参与业务验收。\n\n## 业务人员\n\n业务人员负责具体分支流程和真实操作细节。\n\n职责：\n\n- 补充分支流程。\n- 提供样本数据，例如 ASIN、订单、评论、用户、表格等真实样本。\n- 使用 Vibe Coding 跑页面，验证是否符合真实操作。\n- 补充异常场景。\n\n## 算法\n\n算法保证 AI 能力可控、可解释、可人工审核。\n\n职责：\n\n- 判断是否需要 AI，避免为了 AI 而 AI。\n- 设计算法输入，明确模型需要哪些数据。\n- 设计算法输出，明确 AI 返回什么结果。\n- 制定置信度规则。\n- 制定人工审核机制。\n- 设计风险控制，确保 AI 判断错误时可以回退和纠正。\n\n## 测试\n\n测试不只是最后找 Bug，还要提前补漏，并负责内部培训材料。\n\n职责：\n\n- 高保真模型出来后先写测试用例。\n- 用测试视角发现流程、按钮、权限遗漏。\n- 正式测试主流程、分支流程、权限、异常和数据。\n- 输出验收报告。\n- 将测试用例转成业务操作手册。\n- 记录上线问题并回流需求池。\n\n## 关联条目\n\n- [[AI驱动内部系统开发流程_V3_总览]]\n- [[阶段0_项目入口分级]]\n- [[阶段1_业务需求完整形成]]\n- [[阶段2.5_测试提前补漏]]\n- [[阶段4_测试培训上线回流]]\n",
        "wikilinks": [],
        "category": "layer-milestones"
      }
    },
    {
      "id": "doc:02_项目管理流程/阶段0_项目入口分级",
      "type": "document",
      "name": "阶段0 项目入口分级",
      "filePath": "02_项目管理流程/阶段0_项目入口分级.md",
      "summary": "不是所有需求都应该进入完整开发流程。阶段0用于判断项目是否值得做，以及走轻流程还是完整流程。",
      "tags": [
        "02_项目管理流程"
      ],
      "complexity": "simple",
      "knowledgeMeta": {
        "content": "---\ntype: process_stage\ntags: [项目管理流程, 阶段0, 项目入口, 分级, 立项]\naliases: [项目入口分级, 入口分级, Gate 0, 立项分级]\nsource: AI_驱动_内部系统开发流程_V3.docx\nstatus: active\nowner: 业务主管 / 技术负责人\nupdated: 2026-05\n---\n\n# 阶段0 项目入口分级\n\n## 核心目标\n\n不是所有需求都应该进入完整开发流程。阶段0用于判断项目是否值得做，以及走轻流程还是完整流程。\n\n## 负责人\n\n- 业务主管\n- 技术负责人\n\n## 输入\n\n- 业务提出的问题或机会。\n- 现有系统痛点。\n- 业务收益、风险、范围的初步判断。\n\n## 项目分类\n\n| 类型 | 适用场景 | 流程要求 |\n|---|---|---|\n| S 类 | 小需求，单页面、小改动、无复杂数据 | 可简化阶段1和阶段2。 |\n| M 类 | 中等需求，涉及多个页面、多个角色或状态流转 | 建议走完整阶段0-4。 |\n| L 类 | 大型需求，涉及核心流程、多个部门、复杂权限、数据模型或算法 | 必须走完整流程，并强化技术预检和阶段门禁。 |\n\n## 关键动作\n\n- 判断需求是否值得做。\n- 判断项目影响范围。\n- 判断是否需要完整流程。\n- 判断是否涉及复杂数据、权限、算法、外部系统或高风险流程。\n- 初步指定业务负责人和技术负责人。\n\n## 输出/交付物\n\n- `00_项目入口分级.md`\n- 项目类型：S / M / L。\n- 是否进入完整流程的结论。\n- 初步负责人。\n- 初步范围和风险。\n\n## 检查清单\n\n- [ ] 是否确认需求要解决的真实业务问题？\n- [ ] 是否确认该需求值得做？\n- [ ] 是否确认项目类型？\n- [ ] 是否确认走轻流程还是完整流程？\n- [ ] 是否识别复杂权限、数据、算法、并发、安全或外部系统风险？\n- [ ] 是否明确业务主管和技术负责人？\n\n## 风险点\n\n- 小需求被过度流程化，降低效率。\n- 大需求被当成小需求处理，后续返工。\n- 没有识别权限、数据、安全、算法风险。\n- 没有业务负责人，需求持续漂移。\n\n## Gate 0 通过标准\n\n项目入口通过：确认值得做，确认项目类型。\n\n## 常见问题\n\n### 阶段0由谁负责？\n\n由业务主管和技术负责人共同负责。业务主管判断业务价值和业务范围，技术负责人判断技术复杂度和风险。\n\n### 小需求是否必须走完整流程？\n\n不一定。S 类小需求可以简化阶段1和阶段2，但仍应保留基本入口判断、测试和上线验收。\n\n## 关联条目\n\n- [[AI驱动内部系统开发流程_V3_总览]]\n- [[角色职责矩阵]]\n- [[阶段交付物清单]]\n",
        "wikilinks": [],
        "category": "layer-milestones"
      }
    },
    {
      "id": "doc:02_项目管理流程/阶段1_业务需求完整形成",
      "type": "document",
      "name": "阶段1 业务需求完整形成",
      "filePath": "02_项目管理流程/阶段1_业务需求完整形成.md",
      "summary": "业务侧通过 Vibe Coding 跑完整需求。阶段1追求需求完整，不追求产品完善。",
      "tags": [
        "02_项目管理流程",
        "需求文档"
      ],
      "complexity": "simple",
      "knowledgeMeta": {
        "content": "---\ntype: process_stage\ntags: [项目管理流程, 阶段1, 业务需求, VibeCoding, 需求完整]\naliases: [业务需求完整形成, 提需求, 需求梳理, Gate 1]\nsource: AI_驱动_内部系统开发流程_V3.docx\nstatus: active\nowner: 业务主管 / 业务人员\nupdated: 2026-05\n---\n\n# 阶段1 业务需求完整形成\n\n## 核心目标\n\n业务侧通过 Vibe Coding 跑完整需求。阶段1追求需求完整，不追求产品完善。\n\n## 负责人\n\n- 业务主管\n- 业务人员\n\n## 输入\n\n- 阶段0入口分级结论。\n- 业务痛点、业务目标、现有流程。\n- 业务人员真实操作经验。\n\n## 关键动作\n\n- 梳理主流程。\n- 明确日常操作页面结构。\n- 盘点功能页面和按钮。\n- 补充分支流程。\n- 补充异常流程。\n- 使用 Vibe Coding 生成或验证需求原型。\n- 记录页面验证结果。\n\n## 输出/交付物\n\n- `01_主流程说明.md`\n- `02_日常操作页面结构.md`\n- `03_功能页面按钮盘点表.md`\n- `04_分支流程_XXX.md`\n- `05_异常流程_XXX.md`\n- `06_VibeCoding页面验证记录.md`\n\n## 检查清单\n\n- [ ] 主流程是否能从开始走到结束？\n- [ ] 日常操作入口是否清楚？\n- [ ] 页面、按钮、字段是否大致完整？\n- [ ] 分支流程是否由真实业务人员补充？\n- [ ] 异常流程是否覆盖无负责人、超时、数据缺失等情况？\n- [ ] Vibe Coding 原型是否经过业务侧走查？\n- [ ] 是否明确哪些内容只是原型，不可直接进入生产？\n\n## 风险点\n\n- 只描述主流程，漏掉分支和异常。\n- 把 Vibe Coding 页面当成可生产代码。\n- 业务主管只给方向，没有安排业务人员补充真实操作细节。\n- 页面、按钮、字段未盘点，导致阶段2和开发阶段返工。\n\n## Gate 1 通过标准\n\n需求完整通过：主流程、分支、页面、按钮、字段、状态大致完整。\n\n## 常见问题\n\n### 阶段1追求什么？\n\n追求需求完整，不追求产品完善。页面可以粗糙，但业务流程、分支、异常、按钮、字段不能漏大块。\n\n### Vibe Coding 页面能不能直接上线？\n\n不能。Vibe Coding 页面只是需求原型，不直接进入生产。\n\n## 关联条目\n\n- [[阶段0_项目入口分级]]\n- [[阶段2_高保真模型与业务对象确认]]\n- [[角色职责矩阵]]\n- [[阶段交付物清单]]\n",
        "wikilinks": [],
        "category": "layer-milestones"
      }
    },
    {
      "id": "doc:02_项目管理流程/阶段2.5_测试提前补漏",
      "type": "document",
      "name": "阶段2.5 测试提前补漏",
      "filePath": "02_项目管理流程/阶段2.5_测试提前补漏.md",
      "summary": "在开发前用测试视角发现需求漏洞。测试提前补漏，不只是上线前找 Bug。",
      "tags": [
        "02_项目管理流程",
        "测试相关"
      ],
      "complexity": "simple",
      "knowledgeMeta": {
        "content": "---\ntype: process_stage\ntags: [项目管理流程, 阶段2.5, 测试, 需求补漏, 测试用例]\naliases: [测试提前补漏, 开发前测试, Gate 2.5, 测试用例初稿]\nsource: AI_驱动_内部系统开发流程_V3.docx\nstatus: active\nowner: 测试\nupdated: 2026-05\n---\n\n# 阶段2.5 测试提前补漏\n\n## 核心目标\n\n在开发前用测试视角发现需求漏洞。测试提前补漏，不只是上线前找 Bug。\n\n## 负责人\n\n- 测试\n\n## 输入\n\n- 高保真模型。\n- 高保真模型说明。\n- 统一业务对象模型。\n- 按钮行为矩阵。\n- 项目周期与版本确认。\n\n## 关键动作\n\n- 基于高保真模型先写测试用例初稿。\n- 从主流程、分支流程、权限、异常、数据、按钮行为视角检查遗漏。\n- 标记阻塞开发的问题。\n- 将需求漏洞回流给业务、产品、前端补齐。\n- 确认阻塞问题处理后再进入正式开发。\n\n## 输出/交付物\n\n- `11_测试用例初稿与需求补漏.md`\n- 需求补漏记录。\n- 阻塞问题清单。\n- 已关闭问题清单。\n\n## 检查清单\n\n- [ ] 是否已基于高保真模型编写测试用例初稿？\n- [ ] 是否覆盖主流程？\n- [ ] 是否覆盖分支流程？\n- [ ] 是否覆盖权限？\n- [ ] 是否覆盖异常场景？\n- [ ] 是否覆盖关键数据和状态？\n- [ ] 是否覆盖按钮行为？\n- [ ] 测试发现的阻塞问题是否已关闭？\n\n## 风险点\n\n- 测试只在上线前介入，导致需求漏洞在开发后才暴露。\n- 测试用例只覆盖主流程，漏掉权限、异常、分支和数据边界。\n- 阻塞问题没有关闭就进入开发。\n\n## Gate 2.5 通过标准\n\n测试补漏：测试用例初稿发现的阻塞问题已处理。\n\n## 常见问题\n\n### 阶段2.5应该在什么时候发生？\n\n发生在高保真模型确认后、正式开发前。\n\n### 阶段2.5要产出什么？\n\n主要产出 `11_测试用例初稿与需求补漏.md`，并形成需求补漏记录、阻塞问题清单和已关闭问题清单。\n\n## 关联条目\n\n- [[阶段2_高保真模型与业务对象确认]]\n- [[阶段3_研发协作与正式开发]]\n- [[项目检查清单]]\n",
        "wikilinks": [],
        "category": "layer-milestones"
      }
    },
    {
      "id": "doc:02_项目管理流程/阶段2_高保真模型与业务对象确认",
      "type": "document",
      "name": "阶段2 高保真模型与业务对象确认",
      "filePath": "02_项目管理流程/阶段2_高保真模型与业务对象确认.md",
      "summary": "把完整但粗糙的需求收敛成可开发模型。阶段2追求模型高效，前端必须深度参与。",
      "tags": [
        "02_项目管理流程"
      ],
      "complexity": "simple",
      "knowledgeMeta": {
        "content": "---\ntype: process_stage\ntags: [项目管理流程, 阶段2, 高保真模型, 业务对象, 前端, 产品]\naliases: [高保真模型确认, 业务对象确认, Gate 2, 统一业务对象模型]\nsource: AI_驱动_内部系统开发流程_V3.docx\nstatus: active\nowner: 前端 / 产品经理\nupdated: 2026-05\n---\n\n# 阶段2 高保真模型与业务对象确认\n\n## 核心目标\n\n把完整但粗糙的需求收敛成可开发模型。阶段2追求模型高效，前端必须深度参与。\n\n## 负责人\n\n- 前端\n- 产品经理\n\n## 输入\n\n- 阶段1形成的主流程、页面结构、按钮盘点、分支流程、异常流程和 Vibe Coding 验证记录。\n\n## 关键动作\n\n- 将业务原型收敛为高保真模型。\n- 明确页面结构、交互、按钮行为和状态变化。\n- 确认业务对象、字段、状态和对象关系。\n- 明确 V1/V2 范围和项目周期。\n- 进行前端技术评审和技术预检。\n- 识别性能、安全、权限、并发、日志、可回滚等风险。\n\n## 输出/交付物\n\n- `07_高保真模型.html`\n- `07_高保真模型说明.md`\n- `08_项目周期与版本确认.md`\n- `09_前端技术评审.md`\n- `10_技术预检记录.md`\n- `10A_统一业务对象模型.md`\n- `10B_按钮行为矩阵.md`\n\n## 检查清单\n\n- [ ] 页面是否已经从粗糙原型收敛成可开发模型？\n- [ ] 按钮行为是否明确？\n- [ ] 业务对象、字段、状态、对象关系是否明确？\n- [ ] V1/V2 范围是否明确？\n- [ ] 是否完成前端技术评审？\n- [ ] 是否完成性能、安全、权限、并发、日志、可回滚预检？\n- [ ] 是否明确高保真模型确认后才允许正式开发？\n\n## 风险点\n\n- 前端介入太晚，导致页面、接口、数据库互相倒逼。\n- 高保真模型只画页面，没有确认业务对象和状态。\n- 没有按钮行为矩阵，开发和测试无法对齐。\n- 未提前识别性能、安全、权限、并发、日志、回滚风险。\n\n## Gate 2 通过标准\n\n高保真模型通过：页面收敛、按钮行为、业务对象、状态、V1/V2 明确。\n\n## 常见问题\n\n### 什么时候需要前端提前参与？\n\n阶段2必须由前端深度参与。若需求涉及多页面、复杂交互、权限、状态流转、数据结构或组件复用，前端应在需求收敛时提前参与。\n\n### 统一业务对象模型为什么重要？\n\n统一业务对象模型是页面、接口、数据库、测试、AI 提示词的共同基础。\n\n## 关联条目\n\n- [[阶段1_业务需求完整形成]]\n- [[阶段2.5_测试提前补漏]]\n- [[../01_业务流程/业务对象字典]]\n- [[阶段交付物清单]]\n",
        "wikilinks": [],
        "category": "layer-milestones"
      }
    },
    {
      "id": "doc:02_项目管理流程/阶段3_研发协作与正式开发",
      "type": "document",
      "name": "阶段3 研发协作与正式开发",
      "filePath": "02_项目管理流程/阶段3_研发协作与正式开发.md",
      "summary": "基于高保真模型进行模块化、安全、可维护开发。研发阶段以代码质量、模块化、安全性、可维护性为中心。",
      "tags": [
        "02_项目管理流程"
      ],
      "complexity": "simple",
      "knowledgeMeta": {
        "content": "---\ntype: process_stage\ntags: [项目管理流程, 阶段3, 研发协作, 正式开发, 代码治理, 安全]\naliases: [研发协作, 正式开发, Gate 3, 开发联调]\nsource: AI_驱动_内部系统开发流程_V3.docx\nstatus: active\nowner: 前端 / 后端 / 算法\nupdated: 2026-05\n---\n\n# 阶段3 研发协作与正式开发\n\n## 核心目标\n\n基于高保真模型进行模块化、安全、可维护开发。研发阶段以代码质量、模块化、安全性、可维护性为中心。\n\n## 负责人\n\n- 前端\n- 后端\n- 算法\n\n## 输入\n\n- 高保真模型。\n- 统一业务对象模型。\n- 按钮行为矩阵。\n- 测试用例初稿与需求补漏结果。\n- 技术预检记录。\n\n## 关键动作\n\n- 拆分研发任务与协作计划。\n- 进行前端、后端、算法技术实现对接。\n- 明确接口、数据库、权限、安全、日志和回滚方案。\n- 按代码治理与安全规范开发。\n- 记录开发问题与联调结果。\n- 治理 AI 生成代码，不能直接堆进生产。\n\n## 输出/交付物\n\n- `12_研发任务拆分与协作计划.md`\n- `13_技术实现对接.md`\n- `14_代码治理与安全规范.md`\n- `15_开发问题与联调记录.md`\n\n## 检查清单\n\n- [ ] 研发任务是否已拆分？\n- [ ] 前后端、数据库、权限、安全、主要流程是否联调完成？\n- [ ] 是否按统一业务对象模型设计接口和数据库？\n- [ ] 是否处理权限、安全、日志、可回滚？\n- [ ] AI 生成代码是否经过人工审查和治理？\n- [ ] 是否避免重复代码和不可维护堆叠？\n\n## 风险点\n\n- 开发直接从 Vibe Coding 原型开始，跳过高保真模型。\n- AI 生成代码未经治理直接进入生产。\n- 缺少模块边界、权限、安全、日志和回滚方案。\n- 前后端、数据库、测试使用的业务对象不一致。\n\n## Gate 3 通过标准\n\n开发联调通过：前后端、数据库、权限、安全、主要流程联调完成。\n\n## 常见问题\n\n### 阶段3如何保证模块化、安全和可维护？\n\n依赖统一业务对象模型、研发任务拆分、技术实现对接、代码治理与安全规范、开发问题与联调记录。AI 代码必须经过治理，不能直接堆进生产。\n\n## 关联条目\n\n- [[阶段2.5_测试提前补漏]]\n- [[阶段4_测试培训上线回流]]\n- [[阶段交付物清单]]\n",
        "wikilinks": [],
        "category": "layer-milestones"
      }
    },
    {
      "id": "doc:02_项目管理流程/阶段4_测试培训上线回流",
      "type": "document",
      "name": "阶段4 测试培训上线回流",
      "filePath": "02_项目管理流程/阶段4_测试培训上线回流.md",
      "summary": "完成测试、培训、上线验收和问题回流。测试保证系统真实可用，并帮助业务人员正确使用。",
      "tags": [
        "02_项目管理流程",
        "测试相关"
      ],
      "complexity": "simple",
      "knowledgeMeta": {
        "content": "---\ntype: process_stage\ntags: [项目管理流程, 阶段4, 测试, 培训, 上线, 回流]\naliases: [测试培训上线回流, 上线验收, Gate 4]\nsource: AI_驱动_内部系统开发流程_V3.docx\nstatus: active\nowner: 测试 / 业务主管\nupdated: 2026-05\n---\n\n# 阶段4 测试培训上线回流\n\n## 核心目标\n\n完成测试、培训、上线验收和问题回流。测试保证系统真实可用，并帮助业务人员正确使用。\n\n## 负责人\n\n- 测试\n- 业务主管\n\n## 输入\n\n- 开发联调完成的系统。\n- 测试用例。\n- 高保真模型和业务对象模型。\n- 开发问题与联调记录。\n\n## 关键动作\n\n- 进行正式测试。\n- 验证主流程、分支流程、权限、异常和数据。\n- 输出正式测试报告。\n- 将测试用例转成业务操作手册或内部培训材料。\n- 组织业务确认和上线验收。\n- 记录上线问题并回流需求池。\n\n## 输出/交付物\n\n- `16_正式测试报告.md`\n- `17_内部培训手册.md`\n- `18_上线验收记录.md`\n- `19_上线问题与回流需求.md`\n\n## 检查清单\n\n- [ ] 正式测试是否通过？\n- [ ] 主流程是否验证通过？\n- [ ] 分支流程是否验证通过？\n- [ ] 权限是否验证通过？\n- [ ] 异常和数据边界是否验证通过？\n- [ ] 内部培训手册是否完成？\n- [ ] 业务主管是否完成上线确认？\n- [ ] 上线问题是否记录并回流？\n\n## 风险点\n\n- 只测功能，不测权限、异常、数据和实际操作路径。\n- 没有培训材料，业务人员不会用。\n- 上线问题没有进入回流需求池。\n- 业务主管未验收就上线。\n\n## Gate 4 通过标准\n\n上线验收通过：测试通过、业务确认、培训完成。\n\n## 常见问题\n\n### 上线前需要检查哪些事项？\n\n至少检查正式测试、主流程、分支流程、权限、异常、数据边界、内部培训手册、业务确认、上线问题回流机制。\n\n## 关联条目\n\n- [[阶段3_研发协作与正式开发]]\n- [[项目检查清单]]\n- [[阶段交付物清单]]\n",
        "wikilinks": [],
        "category": "layer-milestones"
      }
    },
    {
      "id": "doc:02_项目管理流程/阶段交付物清单",
      "type": "document",
      "name": "阶段交付物清单",
      "filePath": "02_项目管理流程/阶段交付物清单.md",
      "summary": "- [[AI驱动内部系统开发流程_V3_总览]]",
      "tags": [
        "02_项目管理流程"
      ],
      "complexity": "simple",
      "knowledgeMeta": {
        "content": "---\ntype: deliverable_index\ntags: [项目管理流程, 交付物, 文件清单]\naliases: [交付物清单, 文件结构, 产出物]\nsource: AI_驱动_内部系统开发流程_V3.docx\nstatus: active\nowner: 内部技术团队\nupdated: 2026-05\n---\n\n# 阶段交付物清单\n\n## 完整版交付物\n\n| 阶段 | 交付物 |\n|---|---|\n| 阶段0 | `00_项目入口分级.md` |\n| 阶段1 | `01_主流程说明.md`、`02_日常操作页面结构.md`、`03_功能页面按钮盘点表.md`、`04_分支流程_XXX.md`、`05_异常流程_XXX.md`、`06_VibeCoding页面验证记录.md` |\n| 阶段2 | `07_高保真模型.html`、`07_高保真模型说明.md`、`08_项目周期与版本确认.md`、`09_前端技术评审.md`、`10_技术预检记录.md`、`10A_统一业务对象模型.md`、`10B_按钮行为矩阵.md` |\n| 阶段2.5 | `11_测试用例初稿与需求补漏.md` |\n| 阶段3 | `12_研发任务拆分与协作计划.md`、`13_技术实现对接.md`、`14_代码治理与安全规范.md`、`15_开发问题与联调记录.md` |\n| 阶段4 | `16_正式测试报告.md`、`17_内部培训手册.md`、`18_上线验收记录.md`、`19_上线问题与回流需求.md` |\n| 阶段5 | `20_技术债清单.md`、`21_业务原子能力沉淀清单.md`、`22_组件库与服务复用清单.md`、`23_AI开发上下文模板更新记录.md` |\n\n## 轻量版交付物\n\n| 阶段包 | 交付物 |\n|---|---|\n| 入口 | `00_项目入口分级.md` |\n| 需求 | `01_业务需求包.md` |\n| 模型 | `02_高保真模型包.md` |\n| 预检 | `03_项目版本与技术预检.md` |\n| 测试补漏 | `04_测试用例初稿与需求补漏.md` |\n| 研发 | `05_研发协作与技术实现包.md` |\n| 治理 | `06_代码治理与安全规范.md` |\n| 上线 | `07_测试培训上线包.md` |\n| 沉淀 | `08_技术债与能力沉淀包.md` |\n\n## 关联条目\n\n- [[AI驱动内部系统开发流程_V3_总览]]\n- [[项目检查清单]]\n",
        "wikilinks": [],
        "category": "layer-milestones"
      }
    },
    {
      "id": "doc:02_项目管理流程/项目检查清单",
      "type": "document",
      "name": "项目检查清单",
      "filePath": "02_项目管理流程/项目检查清单.md",
      "summary": "- [ ] 确认项目值得做。",
      "tags": [
        "02_项目管理流程"
      ],
      "complexity": "simple",
      "knowledgeMeta": {
        "content": "---\ntype: checklist\ntags: [项目管理流程, 检查清单, 门禁]\naliases: [项目门禁检查, 上线检查, 流程检查]\nsource: AI_驱动_内部系统开发流程_V3.docx\nstatus: active\nowner: 内部技术团队\nupdated: 2026-05\n---\n\n# 项目检查清单\n\n## Gate 0 项目入口\n\n- [ ] 确认项目值得做。\n- [ ] 确认项目类型：S / M / L。\n- [ ] 确认走轻流程还是完整流程。\n- [ ] 确认业务主管和技术负责人。\n\n## Gate 1 需求完整\n\n- [ ] 主流程完整。\n- [ ] 分支流程完整。\n- [ ] 页面、按钮、字段大致完整。\n- [ ] 状态大致完整。\n- [ ] Vibe Coding 页面已验证。\n\n## Gate 2 高保真模型\n\n- [ ] 页面已经收敛。\n- [ ] 按钮行为明确。\n- [ ] 业务对象明确。\n- [ ] 状态明确。\n- [ ] V1/V2 明确。\n- [ ] 性能、安全、权限、并发、日志、可回滚已预检。\n\n## Gate 2.5 测试补漏\n\n- [ ] 测试用例初稿已完成。\n- [ ] 主流程、分支、权限、异常、数据、按钮行为已检查。\n- [ ] 阻塞开发的问题已处理。\n\n## Gate 3 开发联调\n\n- [ ] 前后端联调完成。\n- [ ] 数据库联调完成。\n- [ ] 权限和安全联调完成。\n- [ ] 主要流程联调完成。\n- [ ] AI 代码已治理。\n\n## Gate 4 上线验收\n\n- [ ] 正式测试通过。\n- [ ] 业务确认完成。\n- [ ] 培训完成。\n- [ ] 上线问题回流机制明确。\n\n## Gate 5 技术债治理\n\n- [ ] 技术债已分类。\n- [ ] 必须立即处理的已处理。\n- [ ] 可延后的进入技术债池。\n- [ ] 可复用组件已沉淀。\n- [ ] 可复用后端服务已沉淀。\n- [ ] AI 开发上下文模板已更新。\n\n## 关联条目\n\n- [[AI驱动内部系统开发流程_V3_总览]]\n- [[阶段交付物清单]]\n",
        "wikilinks": [],
        "category": "layer-milestones"
      }
    },
    {
      "id": "doc:04_Agent检索/关键词索引",
      "type": "document",
      "name": "关键词索引",
      "filePath": "04_Agent检索/关键词索引.md",
      "summary": "知识库文档。",
      "tags": [
        "04_Agent检索",
        "Agent检索"
      ],
      "complexity": "simple",
      "knowledgeMeta": {
        "content": "---\ntype: keyword_index\ntags: [Agent, 关键词, 索引]\naliases: [关键词映射]\nsource: manual\nstatus: active\nowner: 内部技术团队\nupdated: 2026-05\n---\n\n# 关键词索引\n\n| 关键词 | 推荐检索文件 |\n|---|---|\n| 内部系统开发流程 | `02_项目管理流程/AI驱动内部系统开发流程_V3_总览.md` |\n| ERP 开发流程 | `02_项目管理流程/AI驱动内部系统开发流程_V3_总览.md` |\n| 项目入口 | `02_项目管理流程/阶段0_项目入口分级.md` |\n| 项目分级 | `02_项目管理流程/阶段0_项目入口分级.md` |\n| S 类 / M 类 / L 类 | `02_项目管理流程/阶段0_项目入口分级.md` |\n| 业务需求 | `02_项目管理流程/阶段1_业务需求完整形成.md` |\n| Vibe Coding | `02_项目管理流程/阶段1_业务需求完整形成.md` |\n| 高保真模型 | `02_项目管理流程/阶段2_高保真模型与业务对象确认.md` |\n| 业务对象 | `02_项目管理流程/阶段2_高保真模型与业务对象确认.md`、`01_业务流程/业务对象字典.md` |\n| 按钮行为 | `02_项目管理流程/阶段2_高保真模型与业务对象确认.md` |\n| 测试提前补漏 | `02_项目管理流程/阶段2.5_测试提前补漏.md` |\n| 测试用例初稿 | `02_项目管理流程/阶段2.5_测试提前补漏.md` |\n| 正式开发 | `02_项目管理流程/阶段3_研发协作与正式开发.md` |\n| 研发协作 | `02_项目管理流程/阶段3_研发协作与正式开发.md` |\n| 代码治理 | `02_项目管理流程/阶段3_研发协作与正式开发.md`、`02_项目管理流程/AI驱动内部系统开发流程_V3_总览.md` |\n| 上线验收 | `02_项目管理流程/阶段4_测试培训上线回流.md` |\n| 内部培训 | `02_项目管理流程/阶段4_测试培训上线回流.md` |\n| 问题回流 | `02_项目管理流程/阶段4_测试培训上线回流.md` |\n| 技术债 | `02_项目管理流程/AI驱动内部系统开发流程_V3_总览.md`、`02_项目管理流程/项目检查清单.md` |\n| 门禁 | `02_项目管理流程/项目检查清单.md` |\n| 交付物 | `02_项目管理流程/阶段交付物清单.md` |\n| 谁负责 | `02_项目管理流程/角色职责矩阵.md` |\n| 业务规则补充 | `03_规范与模板/业务规则与需求补充模板.md`、`04_Agent检索/知识库持续更新与验证流程.md` |\n| 需求补充 | `03_规范与模板/业务规则与需求补充模板.md`、`03_规范与模板/需求说明模板.md` |\n| 新增业务流程 | `03_规范与模板/业务规则与需求补充模板.md`、`03_规范与模板/业务流程梳理模板.md` |\n| 检索验证 | `04_Agent检索/知识库持续更新与验证流程.md`、`01_业务流程/业务补充验证记录.md` |\n| Agent 问答验证 | `04_Agent检索/知识库持续更新与验证流程.md`、`01_业务流程/业务补充验证记录.md` |\n",
        "wikilinks": [],
        "category": "layer-agent"
      }
    },
    {
      "id": "doc:04_Agent检索/同义词表",
      "type": "document",
      "name": "同义词表",
      "filePath": "04_Agent检索/同义词表.md",
      "summary": "知识库文档。",
      "tags": [
        "04_Agent检索",
        "Agent检索"
      ],
      "complexity": "simple",
      "knowledgeMeta": {
        "content": "---\ntype: synonym_table\ntags: [Agent, 同义词, 检索]\naliases: [口语映射, 术语映射]\nsource: manual\nstatus: active\nowner: 内部技术团队\nupdated: 2026-05\n---\n\n# 同义词表\n\n| 用户说法 | 标准术语 | 推荐检索文件 |\n|---|---|---|\n| 提需求 | 业务需求完整形成 / 项目入口分级 | `阶段1_业务需求完整形成.md`、`阶段0_项目入口分级.md` |\n| 立项 | 项目入口分级 | `阶段0_项目入口分级.md` |\n| 原型 | Vibe Coding 页面 / 高保真模型 | `阶段1_业务需求完整形成.md`、`阶段2_高保真模型与业务对象确认.md` |\n| 页面模型 | 高保真模型 | `阶段2_高保真模型与业务对象确认.md` |\n| 字段字典 | 业务对象模型 | `阶段2_高保真模型与业务对象确认.md`、`业务对象字典.md` |\n| 开发前测试 | 测试提前补漏 | `阶段2.5_测试提前补漏.md` |\n| 测试先看 | 测试提前补漏 | `阶段2.5_测试提前补漏.md` |\n| 开发怎么开始 | 研发协作与正式开发 | `阶段3_研发协作与正式开发.md` |\n| 上线前要做什么 | 测试培训上线回流 / Gate 4 | `阶段4_测试培训上线回流.md`、`项目检查清单.md` |\n| 谁来做 | 角色职责 | `角色职责矩阵.md` |\n| 要交什么 | 阶段交付物 | `阶段交付物清单.md` |\n| 检查点 | 阶段门禁 / 项目检查清单 | `项目检查清单.md` |\n| AI 写的代码 | AI 代码治理 | `阶段3_研发协作与正式开发.md` |\n| 加一条业务规则 | 业务规则补充 | `业务规则与需求补充模板.md`、`知识库持续更新与验证流程.md` |\n| 补需求 | 需求补充 | `业务规则与需求补充模板.md`、`需求说明模板.md` |\n| 新规则怎么写 | 业务规则与需求补充 | `业务规则与需求补充模板.md` |\n| 怎么验证能不能搜到 | Agent 检索验证 | `知识库持续更新与验证流程.md`、`业务补充验证记录.md` |\n",
        "wikilinks": [],
        "category": "layer-agent"
      }
    },
    {
      "id": "doc:04_Agent检索/来源文件索引",
      "type": "document",
      "name": "来源文件索引",
      "filePath": "04_Agent检索/来源文件索引.md",
      "summary": "- 从原始 docx 更新流程时，需要同步更新阶段文件、角色职责矩阵、交付物清单、检查清单、FAQ、关键词索引和同义词表。",
      "tags": [
        "04_Agent检索",
        "Agent检索"
      ],
      "complexity": "simple",
      "knowledgeMeta": {
        "content": "---\ntype: source_index\ntags: [来源, 索引, Agent]\naliases: [来源索引, 原始文件]\nsource: manual\nstatus: active\nowner: 内部技术团队\nupdated: 2026-05\n---\n\n# 来源文件索引\n\n## 原始来源\n\n| 来源文件 | 路径 | 用途 | 状态 |\n|---|---|---|---|\n| AI_驱动_内部系统开发流程_V3.docx | `D:\\\\AIcoding\\\\WishFulfilled\\\\知识库\\\\AI_驱动_内部系统开发流程_V3.docx` | 项目管理流程权威来源 | active |\n\n## 拆解后的知识条目\n\n| 条目 | 来源 |\n|---|---|\n| `02_项目管理流程/AI驱动内部系统开发流程_V3_总览.md` | AI_驱动_内部系统开发流程_V3.docx |\n| `02_项目管理流程/阶段0_项目入口分级.md` | AI_驱动_内部系统开发流程_V3.docx |\n| `02_项目管理流程/阶段1_业务需求完整形成.md` | AI_驱动_内部系统开发流程_V3.docx |\n| `02_项目管理流程/阶段2_高保真模型与业务对象确认.md` | AI_驱动_内部系统开发流程_V3.docx |\n| `02_项目管理流程/阶段2.5_测试提前补漏.md` | AI_驱动_内部系统开发流程_V3.docx |\n| `02_项目管理流程/阶段3_研发协作与正式开发.md` | AI_驱动_内部系统开发流程_V3.docx |\n| `02_项目管理流程/阶段4_测试培训上线回流.md` | AI_驱动_内部系统开发流程_V3.docx |\n| `02_项目管理流程/角色职责矩阵.md` | AI_驱动_内部系统开发流程_V3.docx |\n| `02_项目管理流程/阶段交付物清单.md` | AI_驱动_内部系统开发流程_V3.docx |\n| `02_项目管理流程/项目检查清单.md` | AI_驱动_内部系统开发流程_V3.docx |\n| `02_项目管理流程/常见问题FAQ.md` | AI_驱动_内部系统开发流程_V3.docx |\n\n## 业务补充来源\n\n| 来源文件 | 路径 | 用途 | 状态 |\n|---|---|---|---|\n| 需求文档目录 | `05_需求文档/` | 持续存放新增业务需求、业务规则和需求变更文档 | active |\n| 需求文档索引.md | `05_需求文档/需求文档索引.md` | 登记新增需求文档及 Agent 检索验证状态 | active |\n| 业务规则与需求补充模板.md | `03_规范与模板/业务规则与需求补充模板.md` | 新增业务规则、需求、流程的标准模板 | active |\n| 知识库持续更新与验证流程.md | `04_Agent检索/知识库持续更新与验证流程.md` | 规范新增文档后的索引同步和 Agent 检索验证 | active |\n| 业务补充验证记录.md | `01_业务流程/业务补充验证记录.md` | 记录新增业务文档是否能被 Agent 检索并回答 | active |\n| 里程碑目录 | `06_里程碑/` | 存放里程碑计划、阶段评审和项目节点材料 | active |\n| 技术文档目录 | `07_技术文档/` | 存放架构、接口、数据模型、实现方案和技术决策 | active |\n| 测试相关目录 | `08_测试相关/` | 存放测试计划、测试用例、缺陷、验收和上线检查材料 | active |\n\n## 维护要求\n\n- 从原始 docx 更新流程时，需要同步更新阶段文件、角色职责矩阵、交付物清单、检查清单、FAQ、关键词索引和同义词表。\n- 新增业务规则、需求或流程文档时，原始需求文档统一放入 `05_需求文档/`，并同步更新需求文档索引、业务规则索引、业务对象字典、关键词索引、同义词表和本来源文件索引。\n- 新增里程碑材料统一放入 `06_里程碑/`，并同步更新里程碑索引。\n- 新增技术材料统一放入 `07_技术文档/`，并同步更新技术文档索引。\n- 新增测试材料统一放入 `08_测试相关/`，并同步更新测试用例索引或对应测试记录。\n- Agent 回答项目管理流程问题时，应优先引用拆解后的 Markdown 文件。\n- Agent 回答具体业务规则和需求问题时，应优先引用 `05_需求文档/` 下的正式需求文档；稳定流程可再引用 `01_业务流程/` 下的业务流程条目。\n",
        "wikilinks": [],
        "category": "layer-agent"
      }
    },
    {
      "id": "doc:04_Agent检索/检索说明",
      "type": "document",
      "name": "Agent 检索说明",
      "filePath": "04_Agent检索/检索说明.md",
      "summary": "让 Agent 在回答业务流程和项目管理流程问题时，优先基于本地 Markdown 知识库检索，而不是凭空回答。",
      "tags": [
        "04_Agent检索",
        "Agent检索"
      ],
      "complexity": "simple",
      "knowledgeMeta": {
        "content": "---\ntype: agent_retrieval_guide\ntags: [Agent, 检索, 规则]\naliases: [Agent检索说明, 检索规则]\nsource: manual\nstatus: active\nowner: 内部技术团队\nupdated: 2026-05\n---\n\n# Agent 检索说明\n\n## 目标\n\n让 Agent 在回答业务流程和项目管理流程问题时，优先基于本地 Markdown 知识库检索，而不是凭空回答。\n\n## 检索优先级\n\n1. `05_需求文档/`：持续新增的业务需求、业务规则、需求变更和补充说明。\n2. `06_里程碑/`：项目节点、阶段计划、阶段评审和上线节奏。\n3. `07_技术文档/`：系统架构、数据模型、接口说明、实现方案和技术决策。\n4. `08_测试相关/`：测试计划、测试用例、缺陷记录、验收记录和上线检查。\n5. `02_项目管理流程/`：内部系统开发流程、阶段、角色、门禁、交付物、检查清单。\n6. `01_业务流程/`：真实业务流程、业务对象、业务规则。\n7. `04_Agent检索/`：关键词、同义词、来源索引、回答规则。\n8. `03_规范与模板/`：需要产出模板或文档时使用。\n\n## 问题类型与命中文件\n\n| 问题类型 | 优先文件 |\n|---|---|\n| 流程阶段 | `AI驱动内部系统开发流程_V3_总览.md`、各阶段文件 |\n| 角色职责 | `角色职责矩阵.md` |\n| 交付物 | `阶段交付物清单.md` |\n| 门禁/检查 | `项目检查清单.md` |\n| 常见问答 | `常见问题FAQ.md` |\n| 业务对象 | `01_业务流程/业务对象字典.md`、`阶段2_高保真模型与业务对象确认.md` |\n| 业务规则 | `05_需求文档/`、`05_需求文档/需求文档索引.md`、`01_业务流程/业务规则索引.md` |\n| 业务需求 | `05_需求文档/`、`05_需求文档/需求文档索引.md` |\n| 项目里程碑 | `06_里程碑/`、`06_里程碑/里程碑索引.md` |\n| 技术实现 | `07_技术文档/`、`07_技术文档/技术文档索引.md` |\n| 接口/数据模型 | `07_技术文档/接口说明模板.md`、具体接口文档、具体数据模型文档 |\n| 测试用例 | `08_测试相关/`、`08_测试相关/测试用例索引.md` |\n| 缺陷/验收/上线检查 | `08_测试相关/缺陷记录模板.md`、`08_测试相关/验收记录模板.md`、`08_测试相关/上线检查模板.md` |\n\n## 回答规则\n\n- 先回答结论，再展开依据。\n- 流程问题按“阶段、负责人、输入、动作、输出、检查点”组织。\n- 角色问题按“负责阶段、核心职责、典型产出”组织。\n- 交付物问题列出文件名。\n- 业务规则和需求问题优先检索 `05_需求文档/` 下的正式需求文档，再检索 `05_需求文档/需求文档索引.md`、`01_业务流程/业务规则索引.md`、`关键词索引.md` 和 `同义词表.md`。\n- 里程碑问题优先检索 `06_里程碑/` 和 `06_里程碑/里程碑索引.md`。\n- 技术问题优先检索 `07_技术文档/` 和 `07_技术文档/技术文档索引.md`。\n- 测试问题优先检索 `08_测试相关/` 和 `08_测试相关/测试用例索引.md`。\n- 必须注明来源文件名。\n- 如果知识库未明确记录，不要推测，应回答“知识库未明确记录”，并建议补充到具体文件。\n\n## 持续更新验证\n\n新增业务规则、需求或流程文档后，按 [[知识库持续更新与验证流程]] 执行验证。\n新增文档应使用 `03_规范与模板/业务规则与需求补充模板.md`，正式需求文档保存到 `05_需求文档/`，验证结果记录到 `05_需求文档/需求文档索引.md` 和 `01_业务流程/业务补充验证记录.md`。\n\n## 引用格式\n\n建议在回答末尾使用：\n\n> 来源：`02_项目管理流程/阶段2.5_测试提前补漏.md`\n",
        "wikilinks": [],
        "category": "layer-agent"
      }
    },
    {
      "id": "doc:04_Agent检索/知识库持续更新与验证流程",
      "type": "document",
      "name": "知识库持续更新与验证流程",
      "filePath": "04_Agent检索/知识库持续更新与验证流程.md",
      "summary": "确保业务规则、业务需求和流程补充后，Agent 能通过文件检索命中新内容，并基于知识库给出可追溯回答。",
      "tags": [
        "04_Agent检索",
        "Agent检索"
      ],
      "complexity": "simple",
      "knowledgeMeta": {
        "content": "---\ntype: validation_process\ntags: [Agent, 检索, 知识库更新, 验证流程]\naliases: [知识库更新验证, Agent检索验证, 补充文档验证流程]\nsource: manual\nstatus: active\nowner: 内部技术团队 / 产品经理\nupdated: 2026-05\n---\n\n# 知识库持续更新与验证流程\n\n## 1. 目标\n\n确保业务规则、业务需求和流程补充后，Agent 能通过文件检索命中新内容，并基于知识库给出可追溯回答。\n\n## 2. 更新入口\n\n业务新增或修订时，优先使用：\n\n- `03_规范与模板/业务规则与需求补充模板.md`\n- `03_规范与模板/需求说明模板.md`\n- `03_规范与模板/业务流程梳理模板.md`\n\n补充后的正式需求文档统一保存到：\n\n- `05_需求文档/`\n\n如果文档已经沉淀为稳定业务流程，再同步拆解或引用到：\n\n- `01_业务流程/`\n\n推荐命名：\n\n```text\n业务域_规则或需求名称_YYYYMMDD.md\n```\n\n示例：\n\n```text\n采购_供应商准入规则_20260526.md\n库存_出入库审批规则_20260526.md\n销售_客户授信额度规则_20260526.md\n```\n\n## 3. 标准更新流程\n\n### 步骤 1：新增补充文档\n\n1. 复制 `业务规则与需求补充模板.md`。\n2. 保存到 `05_需求文档/`。\n3. 补全 Frontmatter：`type`、`tags`、`aliases`、`source`、`status`、`owner`、`updated`。\n4. 补全正文中的业务规则、流程、异常、权限、验收口径和 Agent 检索字段。\n\n### 步骤 2：更新索引\n\n新增业务文档后，同步更新：\n\n| 文件 | 更新内容 |\n|---|---|\n| `05_需求文档/需求文档索引.md` | 增加需求/规则名称、业务域、来源文件、状态和验证状态 |\n| `01_业务流程/业务规则索引.md` | 增加规则名称、业务域、适用场景、来源文件 |\n| `01_业务流程/业务对象字典.md` | 增加新增或变更的业务对象、字段、状态 |\n| `04_Agent检索/关键词索引.md` | 增加关键词到新文件的映射 |\n| `04_Agent检索/同义词表.md` | 增加口语问法与标准术语映射 |\n| `04_Agent检索/来源文件索引.md` | 登记新增知识条目来源 |\n\n### 步骤 3：执行文件级检查\n\n检查项：\n\n- 文件是否位于 `05_需求文档/`。\n- 文件名是否包含业务域、规则/需求名称、日期。\n- Frontmatter 是否完整。\n- 是否包含 `业务规则`、`业务流程`、`验收口径`、`Agent 检索字段`。\n- 索引文件是否已同步更新。\n\n### 步骤 4：执行关键词检索验证\n\n用新增文档中的关键词、别名、口语问法进行检索。\n\n验证标准：\n\n- 至少 1 个正式关键词能命中新文档。\n- 至少 1 个口语问法能通过 `同义词表.md` 或 `关键词索引.md` 定位到新文档。\n- 检索结果能定位到具体文件，而不是只命中模板。\n\n### 步骤 5：执行 Agent 问答验证\n\n每次新增文档至少准备 3 类问题：\n\n| 类型 | 示例 | 通过标准 |\n|---|---|---|\n| 规则类 | `供应商准入有什么条件？` | 能回答规则条件、触发条件、处理结果 |\n| 流程类 | `供应商准入流程怎么走？` | 能按步骤回答主流程和分支流程 |\n| 异常类 | `供应商资料不完整怎么办？` | 能回答异常处理方式和负责人 |\n\nAgent 回答必须满足：\n\n1. 结论来自新增文档或已索引文件。\n2. 回答末尾注明来源文件名。\n3. 如果文档未记录，明确回答“知识库未明确记录”。\n4. 不得凭经验补充没有来源的业务规则。\n\n### 步骤 6：记录验证结果\n\n在新增业务文档末尾的 `变更记录` 或单独验证记录中记录：\n\n| 日期 | 验证问题 | 是否命中 | 来源文件 | 结果 | 待补充 |\n|---|---|---|---|---|---|\n|  |  | 是/否 |  | 通过/失败 |  |\n\n## 4. 验证用例模板\n\n复制以下内容到新增业务文档的 `Agent 检索字段` 或验证记录中：\n\n```markdown\n## Agent 检索验证\n\n| 编号 | 用户问题 | 期望命中文件 | 期望答案要点 | 实际结果 | 状态 |\n|---|---|---|---|---|---|\n| Q1 |  |  |  |  | 未验证 |\n| Q2 |  |  |  |  | 未验证 |\n| Q3 |  |  |  |  | 未验证 |\n```\n\n## 5. 通过/失败判定\n\n### 通过\n\n- 新文档能被关键词检索到。\n- Agent 能引用新文档回答至少 3 个验证问题。\n- 回答没有明显幻觉。\n- 来源文件引用正确。\n\n### 失败\n\n出现任一情况视为失败：\n\n- 新文档只保存了，但没有更新关键词索引或同义词表。\n- Agent 命中了旧文件，未命中新文档。\n- Agent 回答没有引用来源。\n- Agent 编造了文档中不存在的业务规则。\n- 问题能检索到模板，但不能检索到正式业务文档。\n\n失败后处理：\n\n1. 补充 `aliases`、`tags`、推荐关键词和同义词。\n2. 更新 `关键词索引.md` 和 `同义词表.md`。\n3. 将标准问答补充到新增文档的 `Agent 检索字段`。\n4. 重新执行验证。\n\n## 6. Agent 验证提示词\n\n```text\n请只基于 D:\\AIcoding\\WishFulfilled\\知识库\\如愿知识库 下的 Markdown 文件回答。\n优先检索 05_需求文档、01_业务流程、02_项目管理流程、04_Agent检索。\n如果知识库没有明确记录，请回答“知识库未明确记录”，并说明建议补充到哪个文件。\n回答末尾必须列出来源文件。\n现在验证问题是：{用户问题}\n```\n",
        "wikilinks": [],
        "category": "layer-agent"
      }
    },
    {
      "id": "doc:04_Agent检索/问答提示词",
      "type": "document",
      "name": "问答提示词",
      "filePath": "04_Agent检索/问答提示词.md",
      "summary": "你是如愿内部知识库问答 Agent。你必须优先检索本地 Markdown 知识库，再回答业务流程、项目管理流程、角色职责、交付物、检查清单和模板相关问题。",
      "tags": [
        "04_Agent检索",
        "Agent检索"
      ],
      "complexity": "simple",
      "knowledgeMeta": {
        "content": "---\ntype: agent_prompt\ntags: [Agent, 提示词, 问答]\naliases: [Agent提示词, 知识库问答Prompt]\nsource: manual\nstatus: active\nowner: 内部技术团队\nupdated: 2026-05\n---\n\n# 问答提示词\n\n## 系统提示词\n\n你是如愿内部知识库问答 Agent。你必须优先检索本地 Markdown 知识库，再回答业务流程、项目管理流程、角色职责、交付物、检查清单和模板相关问题。\n\n回答要求：\n\n1. 不要凭空编造知识库未记录的信息。\n2. 优先检索 `02_项目管理流程` 和 `01_业务流程`。\n3. 流程类问题按阶段、负责人、输入、关键动作、输出、检查点回答。\n4. 角色类问题优先检索 `角色职责矩阵.md`。\n5. 交付物类问题优先检索 `阶段交付物清单.md`。\n6. 门禁和检查类问题优先检索 `项目检查清单.md`。\n7. 每次回答末尾必须注明来源文件。\n8. 如果没有明确答案，回答“知识库未明确记录”，并说明建议补充到哪个文件。\n\n## 用户问题改写规则\n\n- “提需求”可映射为“项目入口分级”或“业务需求完整形成”。\n- “开发前测试”可映射为“阶段2.5 测试提前补漏”。\n- “原型”可映射为“Vibe Coding 页面”或“高保真模型”，需结合上下文区分。\n- “上线前检查”可映射为“Gate 4 上线验收”和“项目检查清单”。\n- “谁负责”优先查角色职责矩阵。\n\n## 标准回答模板\n\n结论：\n\n要点：\n\n1. 阶段/角色：\n2. 输入：\n3. 关键动作：\n4. 输出：\n5. 检查点：\n\n来源：\n",
        "wikilinks": [],
        "category": "layer-agent"
      }
    },
    {
      "id": "doc:05_需求文档/20260517_USER评价业务闭环_第三步_数据流与中间对象设计_v3",
      "type": "document",
      "name": "USER 评价业务闭环 — 第三步：数据流与中间对象设计 v3",
      "filePath": "05_需求文档/20260517_USER评价业务闭环_第三步_数据流与中间对象设计_v3.md",
      "summary": "- 文件名称：`20260517_USER评价业务闭环_第三步_数据流与中间对象设计_v3.md`",
      "tags": [
        "05_需求文档",
        "需求文档"
      ],
      "complexity": "moderate",
      "knowledgeMeta": {
        "content": "# USER 评价业务闭环 — 第三步：数据流与中间对象设计 v3\n\n## 文件信息\n\n- 文件名称：`20260517_USER评价业务闭环_第三步_数据流与中间对象设计_v3.md`\n- 项目路径：`C:\\XCODE\\USER`\n- 当前版本：`v3`\n- 最近更新：`2026-05-17`\n- 上游文档：\n  - [工作基线 v1.2](20260517_USER评价业务闭环主流程与后续工作基线_v1.2.md) — 业务规则与额度口径\n  - [共用能力图与渠道专属流程 v2.2](20260517_USER评价业务闭环_共用能力图与渠道专属流程_v2.2.md) — 每个节点的 查/写/状态/提醒/拦截\n- 前置版本：\n  - `数据流与中间对象需求_v1`（Codex，六层架构骨架）\n  - `数据流与中间对象设计_v1.1`（Codex，字段字典最全版）\n  - `第三步_数据流与中间表设计_v1`（字段级展开 + 流转时序）\n  - `第三步_数据流与中间表设计_v2`（吸收 Codex 优点的合并版）\n- 合并策略：以 Codex v1.1 为主骨架（保留其完整字段字典和免评对象），补入 v2 的流转时序表、写入顺序图和快照策略。\n- 文件目的：作为第三步最终主稿，后续数据库物理设计、接口设计和页面点击读写设计均以此为准。\n\n---\n\n## 1. 第三步的目标\n\n第三步不再回答\"流程怎么走\"，而是回答：\n\n1. 现有系统里已经有哪些数据可以复用。\n2. 为什么仅靠现有 `users / amazon_orders / review_plans / push_tasks / support_tickets / fraud_events` 不够。\n3. 必须新增哪些中间对象。\n4. 哪些是正式事务表，哪些只是快照，哪些可以先做成视图。\n5. 从需求形成到结果回流，数据怎样一层一层往下走。\n\n---\n\n## 2. 本步先给出的结论\n\n### 2.1 不能再只围绕单一账号建模\n\n后续所有关键判断都应围绕 **真实人**，而不是只看 JOYHUB ID / 邮箱 / 电话 / Amazon 账号 / 单次订单。JOYHUB 用户只是身份线索之一，真实人才是额度、历史、风险、跨渠道去重和客服上下文的主对象。\n\n### 2.2 现有表能承载业务记录，但承载不了跨流程判断\n\n既有表更接近\"某一模块自己的账\"，但前两步已确认的新需求需要额外的中间层：真实人跨账号归并、每次互动重判、人群入选/排除解释、额度预占与跨渠道去重、客服上下文、评价提交与展示拆分、退款比对。\n\n### 2.3 第三步最重要的是把对象分层\n\n本文件把数据对象分为六层：\n\n```\n源数据层 → 主实体层 → 桥接层 → 事件层 → 快照与决策层 → 结果回流层\n```\n\n---\n\n## 3. 数据设计原则\n\n| 原则 | 说明 |\n| --- | --- |\n| 先识别真实人，再做额度与风险 | 否则 4/4/12 规则都会被多账号绕开 |\n| 事件与快照分离 | 事件是原始事实，快照是某个时点的判断结果 |\n| 当前态与历史态分离 | 当前视图可重算，历史决策必须留痕 |\n| 计划、渠道、客服、风险状态分离 | 不能压成一个字段 |\n| 用户提交与平台展示分离 | 真实提交计额度，Amazon 展示计计划完成 |\n| 能解释\"为什么\" | 入选、排除、拦截、转人工都要能追溯 |\n| 先复用现有对象，再补最小中间层 | 不为了建模漂亮重造全部旧表 |\n| 对敏感数据分层处理 | 原值、标准化值、哈希/指纹、脱敏展示值应区分 |\n\n---\n\n# 第一部分：现有数据源分析\n\n## 4. 现有数据源盘点\n\n| 数据源 | 当前可用内容 | 主要缺口 |\n| --- | --- | --- |\n| 现有 ERP 用户管理 | 用户 ID、用户名、注册时间、最近活跃、国家、性别、邮箱、绑定产品数、标签 | 仍是账号视角，不是真实人视角 |\n| APP / 用户数据库 | JOYHUB ID、邮箱、设备号、设备型号/类型、系统版本、APP版本、绑定玩具、活跃与点击行为 | 需要设备变更轨迹和与订单/客服联动 |\n| Amazon 订单 | 订单号、ASIN、站点、购买时间、订单状态、Profile ID、收件人姓名、收件地址等 | 需要标准化姓名/地址和收件人指纹 |\n| Amazon 评价/Listing | ASIN、评分、评价数、差评数、评价缺口、展示结果 | 用户真实提交与平台展示要拆成两条事实 |\n| 推送系统 | Push 计划、素材、任务、打开、点击、回复、投诉、退订 | IM/EDM/APP 语义不同，不能只用一套粗糙 push 结果 |\n| 客服/TEL | 工单、通话、售后、答应配合、问题处理 | 需要和上下文卡、风险复检、跟进状态联动 |\n| 黑名单/诈骗资料 | 黑名单、诈骗事件、双重退款、强弱关联 | 需要把风险信号与确认案件拆开 |\n| OA 返款/Amazon 退款 | 内部返款与 Amazon 退款 | 缺统一比对对象 |\n| JOYCOLLAB | KOC/KOL、内容、Code、点击、订单、转化、佣金 | 需要和 USER 计划/ASIN 结果打通 |\n\n### 4.1 Amazon 订单字段明细（结合表头.xlsx）\n\n| 字段 | 主要用途 | 涉密 |\n| --- | --- | --- |\n| 订单号 | 订单核验、真实人关联、退款比对 | 是 |\n| 订单状态 | 判断是否撤销、退款、退货、换货 | - |\n| 买家姓名 / 买家邮箱 | 身份关联 | 是 |\n| 收件人 / 电话 | 真实人归并、风险判断 | 是 |\n| 地址 / 城市 / 州 / 邮编 | 收件人归并、同址异名识别 | 是 |\n| ASIN / MSKU / SKU / 品名 / 标题 | 产品匹配、计划归属 | - |\n| 订购日期 / 发货时间 / 结算时间 | 时序判断 | - |\n| 数量 / 单价 / 订单总金额 / 销售额 | 交易画像 | 是 |\n| 是否退款 / 退款总金额 | 双重退款检测 | 是 |\n| 请求评论状态 | 评价缺口判断 | - |\n| 店铺 / 国家 / 销售渠道 | 站点匹配 | - |\n| Order Item ID | 订单行级关联 | - |\n\n### 4.2 订单侧必须补的派生字段\n\n| 字段 | 说明 |\n| --- | --- |\n| `recipient_name_normalized` | 标准化后的收件人姓名 |\n| `recipient_address_normalized` | 标准化后的地址 |\n| `recipient_fingerprint` | 由标准化姓名+地址生成的稳定指纹 |\n| `address_fingerprint` | 仅地址指纹，用于识别同址异名 |\n\n---\n\n## 5. 全局数据流\n\n```mermaid\nflowchart LR\n    subgraph S[\"源数据层\"]\n        S1[\"现有ERP用户/标签/身份\"]\n        S2[\"APP/设备/行为\"]\n        S3[\"Amazon订单/评价/Listing\"]\n        S4[\"IM/EDM/APP Push/TEL\"]\n        S5[\"客服/工单/售后\"]\n        S6[\"黑名单/OA返款/Amazon退款\"]\n        S7[\"JOYCOLLAB\"]\n    end\n\n    subgraph M[\"主实体与桥接层\"]\n        M1[\"真实人 person_profiles\"]\n        M2[\"身份关联 person_identity_links\"]\n        M3[\"订单/ASIN/计划/工单\"]\n        M4[\"订单关联/路由/去重\"]\n    end\n\n    subgraph D[\"快照与决策层\"]\n        D1[\"画像快照 person_feature_snapshots\"]\n        D2[\"上下文卡 contact_context_snapshots\"]\n        D3[\"额度台账/预占\"]\n        D4[\"风险信号/风险案件\"]\n        D5[\"人群快照/排除快照\"]\n        D6[\"互动复检/路由决策\"]\n    end\n\n    subgraph E[\"事件层\"]\n        E1[\"渠道事件\"]\n        E2[\"客服/TEL事件\"]\n        E3[\"退款事件\"]\n        E4[\"评价提交事件\"]\n        E5[\"免评执行事件\"]\n    end\n\n    subgraph R[\"结果回流层\"]\n        R1[\"评价展示核验\"]\n        R2[\"退款比对结果\"]\n        R3[\"免评结果\"]\n        R4[\"ASIN健康/计划完成\"]\n        R5[\"绩效/审计/下一轮需求\"]\n    end\n\n    S1 & S2 & S3 --> M1\n    S1 & S2 & S3 --> M2\n    M1 & M2 & M3 --> D1\n    M1 & M2 & M3 --> D2\n    D1 --> D5\n    D3 & D4 --> D5\n    D5 --> D6\n    D6 --> E1\n    S4 --> E1\n    S5 --> E2\n    S6 --> E3\n    E1 & E2 --> E4\n    S7 --> E5\n    E3 --> R2\n    E4 --> R1\n    E5 --> R3\n    R1 & R2 & R3 --> R4\n    R4 --> R5\n    R5 --> M3\n```\n\n---\n\n# 第二部分：数据对象分层总表\n\n## 6. 对象分层总表\n\n| 分层 | 对象 | 说明 |\n| --- | --- | --- |\n| 源数据 | `users`、`devices`、`amazon_orders`、`asin_listings`、`push_tasks`、`support_tickets`、`fraud_events`、JOYCOLLAB 数据 | 现有或外部事实来源 |\n| 主实体 | `person_profiles`、`request_tickets`、`review_plans`、`exemption_plans`、`risk_cases`、`blacklist_entities` | 核心业务主体 |\n| 桥接 | `person_identity_links`、`user_order_links`、`plan_task_links`、`channel_route_decisions`、`channel_dedup_records` | 跨主体关系 |\n| 事件 | `im_interaction_records`、`im_flow_tags`、`edm_message_events`、`app_touch_events`、`tel_call_records`、`review_submission_records`、`amazon_refund_records`、`oa_refund_records`、`support_assignment_logs` | 不可丢失的事实 |\n| 快照/决策 | `person_feature_snapshots`、`contact_context_snapshots`、`person_quota_ledgers`、`quota_reservations`、`audience_snapshots`、`audience_exclusions`、`interaction_recheck_records`、`edm_user_behavior_profiles`、`channel_route_decisions`、`channel_dedup_records` | 为某次决策保留当时依据 |\n| 结果/回流 | `review_display_checks`、`refund_match_results`、`exemption_result_snapshots`、`listing_health_snapshots`、`support_performance_snapshots` | 结果与复盘 |\n| 治理 | `interaction_audit_logs`、`manual_review_tasks`、`export_logs`、`audit_logs` | 审计、复核、导出 |\n\n---\n\n## 7. 现有对象如何处理\n\n### 7.1 可以直接复用\n\n| 现有对象 | 处理 |\n| --- | --- |\n| `request_tickets` | 保留，继续作为需求入口 |\n| `amazon_orders` | 保留，补标准化姓名/地址与收件人指纹 |\n| `asin_listings` | 保留，继续作为 ASIN/Listing 主档 |\n| `support_tickets` | 保留，拆出跟进、分派和风险状态辅助表 |\n| `fraud_events` | 保留，上游增加 `risk_signals`，下游衔接 `risk_cases/blacklist_entities` |\n| `audit_logs` | 保留 |\n\n### 7.2 需要扩展\n\n| 现有对象 | 需要补的能力 |\n| --- | --- |\n| `users` | 不再承担真实人主档，只保留 JOYHUB 账号层信息 |\n| `devices` | 补设备型号、系统版本、APP版本、首次/最近出现、设备变化 |\n| `review_plans` | 增加计划族或与 `exemption_plans` 分离 |\n| `push_tasks` | 被更细的渠道事件表补充 |\n| `support_tickets` | 增加与上下文卡、答应配合、风险复核、TEL 记录的关联 |\n\n### 7.3 必须新增\n\n| 对象 | 原因 |\n| --- | --- |\n| `person_profiles` | 真实人主档 |\n| `person_identity_links` | 多线索归并 |\n| `person_feature_snapshots` | 画像解释 |\n| `contact_context_snapshots` | 客服一屏上下文 |\n| `person_quota_ledgers` | 4/4/12 统一额度 |\n| `quota_reservations` | 并发占用与预警 |\n| `audience_snapshots` | 人群生成留痕 |\n| `audience_exclusions` | 排除原因留痕 |\n| `channel_route_decisions` | 渠道路由解释 |\n| `channel_dedup_records` | 跨渠道去重 |\n| `interaction_recheck_records` | 每次有效互动重新判断留痕 |\n| `refund_match_results` | 双重退款识别 |\n| `review_display_checks` | 评价展示拆分 |\n\n---\n\n# 第三部分：P0/P1/P2 优先级\n\n## 8. P0：没有它们，主流程就不可靠\n\n| 对象 | 类型 | 关键用途 |\n| --- | --- | --- |\n| `person_profiles` | 主实体 | 真实人主档 |\n| `person_identity_links` | 桥接 | 账号、邮箱、电话、设备、Profile、收件人归并 |\n| `person_feature_snapshots` | 快照 | 画像依据 |\n| `contact_context_snapshots` | 快照 | 客服上下文卡 |\n| `person_quota_ledgers` | 台账 | 4/4/12 统一额度 |\n| `quota_reservations` | 台账 | 计划并发占用 |\n| `risk_signals` | 事件 | 风险原始信号 |\n| `risk_cases` | 主实体 | 风险案件 |\n| `blacklist_entities` | 主实体 | 确认拦截对象 |\n| `audience_snapshots` | 快照 | 某次人群生成结果 |\n| `audience_exclusions` | 快照 | 排除原因 |\n| `channel_route_decisions` | 决策 | 渠道路由 |\n| `channel_dedup_records` | 决策 | 跨渠道去重 |\n| `interaction_recheck_records` | 决策 | 每次有效互动重判 |\n\n## 9. P1：主流程可走，但没有它们会粗糙且难复盘\n\n| 对象 | 类型 | 关键用途 |\n| --- | --- | --- |\n| `im_interaction_records` | 事件 | IM 细节 |\n| `im_flow_tags` | 事件/派生 | IM 流程流转 |\n| `edm_message_events` | 事件 | EDM 打开/点击/回复/退订 |\n| `edm_user_behavior_profiles` | 快照 | EDM 画像 |\n| `app_touch_events` | 事件 | APP Push 触达 |\n| `tel_call_records` | 事件 | 电话全记录 |\n| `support_followups` | 事务 | 答应配合跟进 |\n| `support_assignment_logs` | 事件 | 分配与升级 |\n| `review_submission_records` | 事件 | 用户真实提交评价 |\n| `review_display_checks` | 结果 | Amazon 展示核验 |\n| `exemption_plans` | 主实体 | 免评计划 |\n| `exemption_plan_tasks` | 事务 | 免评任务 |\n| `creator_content_records` | 事件 | KOC/KOL 内容 |\n| `exemption_result_snapshots` | 结果 | 免评结果 |\n| `amazon_refund_records` | 事件 | Amazon 退款 |\n| `oa_refund_records` | 事件 | OA 返款 |\n| `refund_match_results` | 结果 | 双重退款比对 |\n\n## 10. P2：管理、效率与治理增强\n\n| 对象 | 类型 | 关键用途 |\n| --- | --- | --- |\n| `attendance_records` | 事务 | 出勤 |\n| `shift_schedules` | 事务 | 排班 |\n| `support_goal_records` | 事务 | 目标 |\n| `support_performance_snapshots` | 快照 | 绩效 |\n| `manual_review_tasks` | 事务 | 人工复核 |\n| `interaction_audit_logs` | 审计 | 高敏动作审计 |\n\n---\n\n# 第四部分：完整字段字典\n\n## 11. 真实人与身份层\n\n### 11.1 `person_profiles`\n\n| 字段 | 类型 | 说明 |\n| --- | --- | --- |\n| `person_id` | PK | 真实人唯一标识 |\n| `created_at` | datetime | 首次识别时间 |\n| `updated_at` | datetime | 最近归并更新时间 |\n| `merge_confidence` | enum | 高/中/低 |\n| `status` | enum | 正常/观察中/已确认风险 |\n| `primary_country` | string | 当前主要国家 |\n| `primary_language` | string | 当前主要语言 |\n| `latest_active_at` | datetime | 最近活跃时间 |\n| `lifetime_review_submitted_count` | int | 累计真实提交评价数（跨账号合并） |\n| `current_risk_level` | enum | 当前风险等级 |\n\n### 11.2 `person_identity_links`\n\n| 字段 | 类型 | 说明 |\n| --- | --- | --- |\n| `link_id` | PK | 关联记录 ID |\n| `person_id` | FK → person_profiles | 所属真实人 |\n| `identity_type` | enum | JOYHUB_ID / EMAIL / PHONE / DEVICE / AMAZON_PROFILE / NAME_ADDRESS / PAYMENT / ORDER |\n| `identity_value_hash` | string | 匹配索引 |\n| `identity_value_encrypted` | string | 仅在必要时保存的加密原值 |\n| `link_strength` | enum | 强/弱 |\n| `confidence_score` | decimal | 归并置信度 |\n| `evidence_summary` | text | 命中依据摘要 |\n| `first_seen_at` | datetime | 首次发现时间 |\n| `last_seen_at` | datetime | 最近确认时间 |\n| `source_type` | enum | AMAZON_ORDER / JOYHUB / MANUAL / TEL / EMAIL / CS_TICKET |\n| `is_active` | bool | 是否仍有效 |\n\n### 11.3 归并口径\n\n| 场景 | 数据处理 |\n| --- | --- |\n| 标准化后姓名+地址完全一致 | 直接归并到同一真实人，link_strength=STRONG |\n| 地址一致但姓名不同 | 记录弱关联，不直接合并 |\n| 多个线索交叉命中 | 形成候选归并，记录证据和置信度 |\n| 只有单个弱线索 | 不做直接归并，只写风险信号 |\n\n### 11.4 `contact_context_snapshots`\n\n| 字段组 | 字段 | 来源 |\n| --- | --- | --- |\n| 快照元数据 | `snapshot_id`、`person_id`、`snapshot_at`、`trigger_event` | 系统 |\n| 当前身份 | `joyhub_ids[]`、`emails[]`、`phones[]`、`devices[]`、`amazon_profile_ids[]` | 身份关联 |\n| 归并摘要 | `standardized_name_address`、`linked_person_count`、`merge_confidence` | 真实人/身份关联 |\n| 历史交易 | `total_orders`、`last_order_at`、`total_refunds`、`total_oa_refunds`、`target_asin_purchases[]` | 订单/返款 |\n| 历史服务 | `total_tickets`、`last_ticket_at`、`total_calls`、`last_call_at`、`open_promises[]` | 工单/电话 |\n| 历史风险 | `blacklist_hits`、`strong_associations`、`weak_associations`、`fraud_cases`、`double_refund_flags` | 风险层 |\n| 当前设备 | `device_count`、`latest_device_model`、`app_version`、`recent_device_change` | APP/设备 |\n| 触达历史 | `im_recent[]`、`edm_recent[]`、`app_recent[]`、`tel_recent[]` | 渠道事件 |\n\n---\n\n## 12. 画像、额度与人群层\n\n### 12.1 `person_feature_snapshots`\n\n| 字段组 | 代表字段 |\n| --- | --- |\n| 快照元数据 | `feature_snapshot_id`、`person_id`、`snapshot_at`、`feature_version` |\n| 基础画像 | `country`、`marketplace`、`language`、`gender`、`age_band`、`registered_at` |\n| 产品关系 | `bound_toy_count`、`bound_categories[]`、`target_product_relation` |\n| 交易画像 | `total_orders`、`last_order_at`、`purchase_frequency`、`bought_target_asin` |\n| 行为画像 | `activity_score`、`open_rate`、`click_rate`、`reply_rate`、`review_rate`、`cooperation_rate` |\n| 触达画像 | `im_reachable`、`edm_reachable`、`app_reachable`、`tel_reachable`、`last_touch_at` |\n| 风险画像 | `risk_level`、`blacklist_hit`、`strong_link_count`、`weak_link_count`、`refund_anomaly_flag` |\n| 计划画像 | `joined_plan_types[]`、`last_plan_result`、`lifetime_review_submitted_count` |\n\n### 12.2 三类画像用途\n\n| 用途 | 说明 | 示例 |\n| --- | --- | --- |\n| **硬过滤** | 决定能不能进入人群池 | 黑名单、退订、强关联、超额、站点不符 |\n| **匹配条件** | 决定适不适合当前计划 | 国家、性别、年龄段、绑定玩具、是否买过目标 ASIN |\n| **排序权重** | 决定优先触达谁 | 活跃度、历史配合率、最近互动、打开/点击行为 |\n\n### 12.3 `person_quota_ledgers`\n\n> **HANDOFF：用户运营核心控制规则。** \"4+4+12\"全部按真实人统计，跨所有关联账号合并计算。一个人不管有几个 JOYHUB ID、几个 Amazon 账号——只要归并到同一个真实人，都受同一套额度控制。\n>\n> 示例：真实人关联 3 个 JOYHUB ID（A/B/C），A 上提交 5 个 + B 上提交 4 个 + C 上提交 3 个 = 累计 12，**全部账号停回评/测评，后续仅免评。**\n\n| 字段 | 类型 | 说明 |\n| --- | --- | --- |\n| `ledger_id` | PK | 台账记录 ID |\n| `person_id` | FK → person_profiles | 真实人 |\n| `period_key` | string | 自然月，如 `2026-05` |\n| `quota_type` | enum | MONTHLY_REVIEW / MONTHLY_EXEMPTION / LIFETIME_REVIEW |\n| `quota_limit` | int | 4 / 4 / 12 |\n| `used` | int | 已完成 |\n| `in_progress` | int | 进行中 |\n| `reserved` | int | 已预占 |\n| `available` | int | 剩余可用 = limit - used - in_progress - reserved |\n| `updated_at` | datetime | 最近更新 |\n\n### 12.4 `quota_reservations`\n\n| 字段 | 类型 | 说明 |\n| --- | --- | --- |\n| `reservation_id` | PK | 预占记录 |\n| `person_id` | FK | 真实人 |\n| `plan_id` | FK | 关联计划 |\n| `quota_type` | enum | 测评/免评 |\n| `reserved_count` | int | 预占数量 |\n| `reserved_at` | datetime | 预占时间 |\n| `expires_at` | datetime | 过期释放时间 |\n| `status` | enum | 已预占/已使用/已释放/已过期 |\n\n### 12.5 `audience_snapshots`\n\n| 字段 | 类型 | 说明 |\n| --- | --- | --- |\n| `snapshot_id` | PK | 人群快照 ID |\n| `plan_id` | FK | 计划 |\n| `batch_id` | string | 生成人群批次 |\n| `person_id` | FK | 真实人 |\n| `match_score` | decimal | 匹配得分 |\n| `match_reasons` | JSON | 命中画像条件 |\n| `quota_status` | enum | 充足/预警/超限 |\n| `risk_status` | enum | 正常/弱风险/强风险 |\n| `priority_rank` | int | 触达优先级 |\n| `feature_snapshot_id` | FK | 当时引用的画像快照 |\n| `snapshot_at` | datetime | 快照时间 |\n\n### 12.6 `audience_exclusions`\n\n| 字段 | 类型 | 说明 |\n| --- | --- | --- |\n| `exclusion_id` | PK | 排除记录 |\n| `plan_id` | FK | 计划 |\n| `batch_id` | string | 批次 |\n| `person_id` | FK | 真实人 |\n| `exclusion_reason` | enum | BLACKLIST / UNSUBSCRIBED / QUOTA_EXCEEDED / FREQ_EXCEEDED / OPEN_TICKET / WRONG_COUNTRY / STRONG_RISK |\n| `excluded_at` | datetime | 排除时间 |\n\n### 12.7 为什么一定需要这些中间表\n\n| 对象 | 如果没有会怎样 |\n| --- | --- |\n| `person_feature_snapshots` | 无法解释当时的画像依据 |\n| `audience_snapshots` | 无法复盘某次计划到底选中了谁 |\n| `audience_exclusions` | 无法解释为什么用户没被选中 |\n| `person_quota_ledgers` | 4/4/12 规则无法跨账号统一计算 |\n| `quota_reservations` | 多个计划并发时会重复占用同一人额度 |\n\n---\n\n## 13. 路由与互动复检层\n\n### 13.1 `channel_route_decisions`\n\n| 字段 | 类型 | 说明 |\n| --- | --- | --- |\n| `route_decision_id` | PK | 路由决策 ID |\n| `plan_id` | FK | 计划 |\n| `batch_id` | string | 人群批次 |\n| `person_id` | FK | 真实人 |\n| `candidate_channels` | JSON | 候选渠道 |\n| `selected_channel` | enum | 实际选中渠道 |\n| `excluded_channels` | JSON | 被排除渠道及原因 |\n| `decision_factors` | JSON | 活跃、绑定、可达性、工单、额度、风险 |\n| `decided_at` | datetime | 决策时间 |\n\n### 13.2 `channel_dedup_records`\n\n| 字段 | 类型 | 说明 |\n| --- | --- | --- |\n| `dedup_id` | PK | 去重记录 |\n| `person_id` | FK | 真实人 |\n| `plan_id` | FK | 计划 |\n| `selected_channel` | enum | 保留渠道 |\n| `suppressed_channels` | JSON | 被抑制渠道 |\n| `reason` | text | 去重原因 |\n| `created_at` | datetime | 去重时间 |\n\n### 13.3 `interaction_recheck_records`\n\n每次有效互动后，记录本次重新做过哪些检查、结果是什么、为何继续或拦截。这是\"每次互动重判\"的落地证据。\n\n| 字段 | 类型 | 说明 |\n| --- | --- | --- |\n| `recheck_id` | PK | 复检记录 |\n| `interaction_type` | enum | IM / EDM / APP / TEL / CS / REFUND |\n| `interaction_id` | string | 触发互动 |\n| `person_id` | FK | 真实人 |\n| `context_snapshot_id` | FK | 上下文快照 |\n| `quota_snapshot_ref` | string | 额度快照引用 |\n| `risk_case_id` | FK | 关联风险案件 |\n| `identity_result` | enum | 正常/新增关联/冲突 |\n| `history_result` | enum | 无变化/有更新 |\n| `quota_result` | enum | 充足/预警/超限 |\n| `risk_result` | enum | 正常/弱风险/强风险 |\n| `final_action` | enum | 继续/降级/转人工/暂停 |\n| `checked_at` | datetime | 复检时间 |\n\n---\n\n## 14. 风险层\n\n### 14.1 `risk_signals`\n\n| 字段 | 类型 | 说明 |\n| --- | --- | --- |\n| `signal_id` | PK | 风险信号 ID |\n| `person_id` | FK | 真实人 |\n| `signal_type` | enum | STRONG_HIT / WEAK_HIT / DOUBLE_REFUND / DEVICE_ANOMALY / ADDRESS_ANOMALY / BLACKLIST_HIT |\n| `hit_dimensions` | JSON | 命中维度 |\n| `source_event_id` | string | 触发事件 |\n| `created_at` | datetime | 产生时间 |\n| `resolved_at` | datetime | 解除时间 |\n| `resolution` | enum | 确认风险/误报/观察中 |\n\n### 14.2 `risk_cases`\n\n| 字段 | 类型 | 说明 |\n| --- | --- | --- |\n| `case_id` | PK | 风险案件 |\n| `person_id` | FK | 真实人 |\n| `source_type` | enum | CS_TICKET / TEL_CALL / PUSH_RESPONSE / REFUND / MANUAL |\n| `source_id` | string | 来源对象 |\n| `status` | enum | 待复核/复核中/确认诈骗/排除/已同步黑名单 |\n| `reviewer_id` | FK | 复核人 |\n| `reviewed_at` | datetime | 复核时间 |\n| `sync_status` | enum | 未同步/同步中/已同步/同步失败 |\n\n### 14.3 `blacklist_entities`\n\n| 字段 | 类型 | 说明 |\n| --- | --- | --- |\n| `blacklist_entity_id` | PK | 黑名单实体 |\n| `entity_type` | enum | 邮箱/电话/设备/Profile/收款信息/真实人 |\n| `entity_hash` | string | 匹配索引 |\n| `risk_level` | enum | 风险等级 |\n| `source_case_id` | FK | 来源案件 |\n| `synced_at` | datetime | 同步时间 |\n| `status` | enum | 生效/失效/待复核 |\n\n### 14.4 `manual_review_tasks`\n\n| 字段 | 类型 | 说明 |\n| --- | --- | --- |\n| `task_id` | PK | 人工复核任务 |\n| `person_id` | FK | 真实人 |\n| `source_type` | enum | 风险/额度/渠道/退款 |\n| `source_id` | string | 来源对象 |\n| `task_reason` | text | 复核原因 |\n| `status` | enum | 待处理/处理中/已完成/已关闭 |\n| `owner_id` | FK | 负责人 |\n| `created_at` | datetime | 创建时间 |\n\n---\n\n## 15. 渠道事件层\n\n### 15.1 `im_interaction_records`\n\n| 字段 | 类型 | 说明 |\n| --- | --- | --- |\n| `im_record_id` | PK | IM 记录 |\n| `person_id` | FK | 真实人 |\n| `joyhub_id` | FK | JOYHUB 账号 |\n| `plan_id` | FK | 关联计划 |\n| `action_type` | enum | PUSH_CARD / USER_SUBMIT / USER_REPLY / REMINDER / NOTIFICATION |\n| `card_type` | enum | REVIEW_CARD / EVALUATION_CARD / EXEMPTION_CARD / REMINDER_CARD |\n| `user_submitted_data` | JSON | 订单号/返款账号/截图链接（涉密加密存储） |\n| `order_validation_result` | enum | 通过/非测评单/非公司产品/格式错误/已撤销/已退款 |\n| `tag_changes` | JSON | 本次产生的标签变化 |\n| `created_at` | datetime | 事件时间 |\n\n### 15.2 `im_flow_tags`\n\n| 字段 | 类型 | 说明 |\n| --- | --- | --- |\n| `flow_tag_id` | PK | 流程标签记录 |\n| `person_id` | FK | 真实人 |\n| `tag_code` | string | 流程标签 |\n| `source_im_record_id` | FK | 来源 IM 事件 |\n| `effective_from` | datetime | 生效时间 |\n| `effective_to` | datetime | 失效时间 |\n\n### 15.3 `edm_message_events`\n\n| 字段 | 类型 | 说明 |\n| --- | --- | --- |\n| `edm_event_id` | PK | EDM 事件 |\n| `person_id` | FK | 真实人 |\n| `email_hash` | string | 邮箱索引 |\n| `campaign_id` | FK | 邮件任务 |\n| `event_type` | enum | SENT / DELIVERED / OPENED / CLICKED / REPLIED / BOUNCED / UNSUBSCRIBED / COMPLAINED |\n| `event_at` | datetime | 事件时间 |\n| `click_target` | string | 点击目标 |\n\n### 15.4 `edm_user_behavior_profiles`\n\n| 字段 | 类型 | 说明 |\n| --- | --- | --- |\n| `profile_id` | PK | EDM 行为画像 |\n| `person_id` | FK | 真实人 |\n| `latest_open_at` | datetime | 最近打开 |\n| `latest_reply_at` | datetime | 最近回复 |\n| `open_count_total` | int | 累计打开次数 |\n| `zero_open_last_3` | bool | 最近 3 次 0 打开 |\n| `zero_open_last_5` | bool | 最近 5 次 0 打开 |\n| `clicked_review_link_without_reply_hours` | int | 点击评论链接但未回复时长 |\n| `monthly_receive_count` | int | 当月收信次数 |\n| `mail_type_counts` | JSON | 各邮件类型发送次数 |\n| `mailbox_domain` | string | 邮箱后缀 |\n| `is_unsubscribed` | bool | 是否退订 |\n| `has_hard_bounce` | bool | 是否硬退信 |\n| `snapshot_at` | datetime | 快照时间 |\n\n### 15.5 `app_touch_events`\n\n| 字段 | 类型 | 说明 |\n| --- | --- | --- |\n| `app_event_id` | PK | APP 事件 |\n| `person_id` | FK | 真实人 |\n| `joyhub_id` | FK | JOYHUB 账号 |\n| `push_type` | enum | PUSH / IN_APP / BANNER / POPUP |\n| `event_type` | enum | SENT / DISPLAYED / CLICKED / DISMISSED / UNINSTALLED |\n| `landing_page` | string | 落地页 |\n| `event_at` | datetime | 事件时间 |\n\n### 15.6 `tel_call_records`\n\n| 字段 | 类型 | 说明 | 涉密 |\n| --- | --- | --- | --- |\n| `tel_record_id` | PK | 电话记录 | - |\n| `person_id` | FK | 真实人 | - |\n| `ticket_id` | FK | 关联工单 | - |\n| `call_direction` | enum | INBOUND/OUTBOUND | - |\n| `call_source` | enum | AMAZON_PAGE/MANUAL/PLAN_TASK/FOLLOWUP | - |\n| `phone_hash` | string | 电话索引 | 是 |\n| `call_at` | datetime | 通话时间 | - |\n| `duration_seconds` | int | 通话时长 | - |\n| `call_result` | enum | CONNECTED/NO_ANSWER/WRONG_NUMBER/DECLINED | - |\n| `has_after_sale_issue` | bool | 是否有售后 | - |\n| `issue_type` | enum | 问题类型 | - |\n| `issue_description` | text | 问题描述 | - |\n| `solution` | text | 处理方案 | - |\n| `is_resolved` | bool | 是否解决 | - |\n| `is_satisfied` | bool | 是否满意 | - |\n| `invited_review` | bool | 是否邀请回评/测评 | - |\n| `user_accepted` | bool | 是否接受 | - |\n| `agent_id` | FK | 客服 | - |\n\n---\n\n## 16. 客服层\n\n### 16.1 `support_tickets`\n\n| 字段 | 类型 | 说明 |\n| --- | --- | --- |\n| `ticket_id` | PK | 工单 |\n| `person_id` | FK | 真实人 |\n| `ticket_type` | enum | 差评跟进/测评跟进/回评跟进/紧急Listing/电话/售后/诈骗样品/KOL进度 |\n| `source` | enum | AMAZON_OP/BRAND_OP/SYSTEM_AUTO/PUSH_ESCALATION/USER_REPLY/TEL_INBOUND |\n| `source_id` | string | 来源对象 |\n| `ticket_status` | enum | 待分配/已分配/处理中/等待用户/等待内部/已解决/疑似诈骗/已关闭 |\n| `assigned_team` | FK | 客服组 |\n| `assigned_agent` | FK | 客服 |\n| `created_at` | datetime | 创建时间 |\n| `first_response_at` | datetime | 首次回复 |\n| `resolved_at` | datetime | 解决时间 |\n| `closed_at` | datetime | 关闭时间 |\n| `context_snapshot_id` | FK | 创建时上下文快照 |\n\n### 16.2 `support_followups`\n\n| 字段 | 类型 | 说明 |\n| --- | --- | --- |\n| `followup_id` | PK | 跟进 |\n| `ticket_id` | FK | 工单 |\n| `person_id` | FK | 真实人 |\n| `followup_status` | enum | 已答应配合/待分配/待提醒/等待提交/已提交评价/已提交反馈/超时/需再次联系/已关闭 |\n| `promised_at` | datetime | 承诺时间 |\n| `reminder_count` | int | 已提醒次数 |\n| `last_reminder_at` | datetime | 最近提醒 |\n| `deadline_at` | datetime | 截止时间 |\n| `submitted_at` | datetime | 实际提交 |\n| `submission_type` | enum | 评价/反馈 |\n\n### 16.3 `support_assignment_logs`\n\n| 字段 | 类型 | 说明 |\n| --- | --- | --- |\n| `assignment_log_id` | PK | 分配日志 |\n| `ticket_id` | FK | 工单 |\n| `from_owner_id` | FK | 原负责人 |\n| `to_owner_id` | FK | 新负责人 |\n| `assign_type` | enum | 自动分配/组长分派/转派/升级 |\n| `reason` | text | 原因 |\n| `created_at` | datetime | 分配时间 |\n\n### 16.4 `plan_task_links`\n\n| 字段 | 类型 | 说明 |\n| --- | --- | --- |\n| `link_id` | PK | 桥接 ID |\n| `plan_id` | FK | 计划 |\n| `task_type` | enum | IM_TASK/EDM_TASK/APP_TASK/TEL_TASK/CS_TASK/KOC_TASK |\n| `task_id` | string | 各渠道任务 ID |\n| `created_at` | datetime | 创建时间 |\n\n---\n\n## 17. 评价与退款结果层\n\n### 17.1 `review_submission_records`\n\n| 字段 | 类型 | 说明 |\n| --- | --- | --- |\n| `submission_id` | PK | 提交记录 |\n| `person_id` | FK | 真实人 |\n| `plan_id` | FK | 计划 |\n| `channel` | enum | IM/EDM/APP/TEL/CS |\n| `source_event_id` | string | 来源事件 |\n| `submitted_at` | datetime | 提交时间 |\n| `submission_evidence` | JSON | 截图/链接 |\n| `order_number_hash` | string | 订单索引 |\n| `quota_counted` | bool | 是否已计入 12（提交时即为true） |\n\n### 17.2 `review_display_checks`\n\n| 字段 | 类型 | 说明 |\n| --- | --- | --- |\n| `check_id` | PK | 核验记录 |\n| `submission_id` | FK | 提交记录 |\n| `asin` | string | ASIN |\n| `check_at` | datetime | 核验时间 |\n| `is_displayed` | bool | 是否展示 |\n| `is_verifiable` | bool | 是否可核验 |\n| `display_status` | enum | 展示确认/未展示/待核验 |\n| `plan_completed` | bool | 是否计入计划完成（展示确认后才为true） |\n\n### 17.3 `amazon_refund_records` / `oa_refund_records` / `refund_match_results`\n\n| 对象 | 关键字段 |\n| --- | --- |\n| `amazon_refund_records` | `refund_id`、`order_number_hash`、`asin`、`refund_amount`、`refund_at`、`refund_reason` |\n| `oa_refund_records` | `oa_refund_id`、`person_id`、`order_number_hash`、`refund_amount`、`refund_at` |\n| `refund_match_results` | `match_id`、`order_number_hash`、`amazon_refund_id`、`oa_refund_id`、`match_status`、`amount_diff`、`matched_at` |\n\n---\n\n## 18. 免评结果层\n\n### 18.1 `exemption_plans`\n\n| 字段 | 类型 | 说明 |\n| --- | --- | --- |\n| `exemption_plan_id` | PK | 免评计划 |\n| `source_request_id` | FK | 来源需求 |\n| `asin` | string | ASIN |\n| `marketplace` | string | 站点 |\n| `goal_type` | enum | 内容发布/引流/带货/权重 |\n| `target_metrics` | JSON | 目标点击、Code、订单、销量、权重 |\n| `status` | enum | 草稿/待审批/执行中/已完成/已关闭 |\n\n### 18.2 `exemption_plan_tasks`\n\n| 字段 | 类型 | 说明 |\n| --- | --- | --- |\n| `task_id` | PK | 免评任务 |\n| `exemption_plan_id` | FK | 免评计划 |\n| `task_type` | enum | KOC/KOL/IM/EDM/APP/内容协同 |\n| `owner_id` | FK | 负责人 |\n| `status` | enum | 待执行/执行中/已完成/异常 |\n| `created_at` | datetime | 创建时间 |\n\n### 18.3 `creator_content_records`\n\n| 字段 | 类型 | 说明 |\n| --- | --- | --- |\n| `creator_content_id` | PK | 内容记录 |\n| `exemption_task_id` | FK | 免评任务 |\n| `creator_id` | string | KOC/KOL |\n| `content_url` | string | 内容链接 |\n| `published_at` | datetime | 发布时间 |\n| `code_usage_count` | int | Code 使用量 |\n| `click_count` | int | 点击量 |\n| `order_count` | int | 带货订单 |\n| `sales_amount` | decimal | 销售额 |\n\n### 18.4 `exemption_result_snapshots`\n\n| 字段 | 类型 | 说明 |\n| --- | --- | --- |\n| `snapshot_id` | PK | 免评结果快照 |\n| `exemption_plan_id` | FK | 免评计划 |\n| `snapshot_at` | datetime | 快照时间 |\n| `content_published_count` | int | 内容发布数 |\n| `click_count` | int | 点击 |\n| `code_usage_count` | int | Code 使用 |\n| `order_count` | int | 订单 |\n| `sales_amount` | decimal | 销售额 |\n| `weight_change_summary` | text | 权重变化摘要 |\n\n---\n\n## 19. 客服管理支撑层\n\n| 对象 | 关键字段 |\n| --- | --- |\n| `attendance_records` | `record_id`、`agent_id`、`date`、`scheduled_hours`、`actual_hours`、`status` |\n| `shift_schedules` | `shift_id`、`team_id`、`agent_id`、`date`、`shift_start`、`shift_end`、`max_tickets` |\n| `support_goal_records` | `goal_id`、`agent_id`、`period_key`、`goal_type`、`target_value`、`current_value` |\n| `support_performance_snapshots` | `snapshot_id`、`agent_id`、`period_key`、`tickets_handled`、`messages_sent`、`first_response_avg_sec`、`rso_orders`、`rdo_orders`、`reviews_obtained`、`review_completion_rate`、`monthly_target`、`monthly_completed` |\n\n---\n\n## 20. 逻辑关系总图\n\n```mermaid\nerDiagram\n    PERSON_PROFILES ||--o{ PERSON_IDENTITY_LINKS : \"归并\"\n    PERSON_PROFILES ||--o{ PERSON_FEATURE_SNAPSHOTS : \"画像\"\n    PERSON_PROFILES ||--o{ CONTACT_CONTEXT_SNAPSHOTS : \"上下文\"\n    PERSON_PROFILES ||--o{ PERSON_QUOTA_LEDGERS : \"额度台账\"\n    PERSON_PROFILES ||--o{ QUOTA_RESERVATIONS : \"额度预占\"\n    PERSON_PROFILES ||--o{ RISK_SIGNALS : \"风险信号\"\n    PERSON_PROFILES ||--o{ RISK_CASES : \"风险案件\"\n    PERSON_PROFILES ||--o{ AUDIENCE_SNAPSHOTS : \"人群入选\"\n    PERSON_PROFILES ||--o{ AUDIENCE_EXCLUSIONS : \"人群排除\"\n    PERSON_PROFILES ||--o{ CHANNEL_ROUTE_DECISIONS : \"路由\"\n    PERSON_PROFILES ||--o{ CHANNEL_DEDUP_RECORDS : \"去重\"\n    PERSON_PROFILES ||--o{ INTERACTION_RECHECK_RECORDS : \"互动复检\"\n    PERSON_PROFILES ||--o{ IM_INTERACTION_RECORDS : \"IM\"\n    PERSON_PROFILES ||--o{ IM_FLOW_TAGS : \"IM标签\"\n    PERSON_PROFILES ||--o{ EDM_MESSAGE_EVENTS : \"EDM\"\n    PERSON_PROFILES ||--o{ EDM_USER_BEHAVIOR_PROFILES : \"EDM画像\"\n    PERSON_PROFILES ||--o{ APP_TOUCH_EVENTS : \"APP\"\n    PERSON_PROFILES ||--o{ TEL_CALL_RECORDS : \"TEL\"\n    PERSON_PROFILES ||--o{ SUPPORT_TICKETS : \"工单\"\n    PERSON_PROFILES ||--o{ SUPPORT_FOLLOWUPS : \"跟进\"\n    PERSON_PROFILES ||--o{ REVIEW_SUBMISSION_RECORDS : \"评价提交\"\n    PERSON_PROFILES ||--o{ MANUAL_REVIEW_TASKS : \"人工复核\"\n    REVIEW_SUBMISSION_RECORDS ||--o{ REVIEW_DISPLAY_CHECKS : \"展示核验\"\n    SUPPORT_TICKETS ||--o{ SUPPORT_ASSIGNMENT_LOGS : \"分配\"\n    RISK_CASES ||--o{ BLACKLIST_ENTITIES : \"同步\"\n    AMAZON_REFUND_RECORDS ||--o{ REFUND_MATCH_RESULTS : \"退款比对\"\n    OA_REFUND_RECORDS ||--o{ REFUND_MATCH_RESULTS : \"退款比对\"\n    EXEMPTION_PLANS ||--o{ EXEMPTION_PLAN_TASKS : \"任务\"\n    EXEMPTION_PLAN_TASKS ||--o{ CREATOR_CONTENT_RECORDS : \"内容\"\n    EXEMPTION_PLANS ||--o{ EXEMPTION_RESULT_SNAPSHOTS : \"结果\"\n    REVIEW_PLANS ||--o{ PLAN_TASK_LINKS : \"计划任务\"\n    SHIFT_SCHEDULES ||--o{ SUPPORT_TICKETS : \"排班分配\"\n    ATTENDANCE_RECORDS }o--|| SHIFT_SCHEDULES : \"出勤关联\"\n```\n\n---\n\n# 第五部分：数据流转\n\n## 21. 关键流转时序\n\n| 阶段 | 读（查） | 写 | 说明 |\n| --- | --- | --- | --- |\n| 真实人识别 | person_identity_links（已有线索） | person_profiles + person_identity_links（新线索） | 每次互动都先跑 |\n| 画像生成 | person_profiles + 七组画像数据 + 各渠道事件 | person_feature_snapshots | 定期或触发式刷新 |\n| 人群生成 | person_feature_snapshots + person_quota_ledgers + risk_signals | audience_snapshots + audience_exclusions + quota_reservations | 快照当下状态 |\n| 路由决策 | audience_snapshots + 用户状态 + 渠道可达性 | channel_route_decisions + channel_dedup_records | 选定渠道+去重 |\n| 渠道发送 | channel_route_decisions + quota_reservations + risk_signals（最新） | 各渠道事件表 | 发送前终校 |\n| 用户回应 | person_identity_links + person_quota_ledgers + risk_signals（全部重读） | interaction_recheck_records + 渠道事件表更新 + im_flow_tags | 每次互动复检留痕 |\n| 评价提交 | person_quota_ledgers（累计额度） | review_submission_records + person_quota_ledgers（+1） | 提交即计12 |\n| Amazon 展示确认 | review_submission_records | review_display_checks + 计划完成度更新 | 展示才计完成 |\n| 退款/返款 | amazon_refund_records + oa_refund_records | refund_match_results + risk_signals（如命中） | 双重退款检测 |\n\n## 22. 每次有效互动的标准写入顺序\n\n```mermaid\nflowchart LR\n    A[\"互动发生\"] --> B[\"解析真实人<br/>读 person_identity_links\"]\n    B --> C[\"生成/更新上下文卡<br/>写 contact_context_snapshots\"]\n    C --> D[\"读取最新额度<br/>读 person_quota_ledgers\"]\n    D --> E[\"执行风险判断<br/>读 risk_signals + blacklist\"]\n    E --> F[\"写 interaction_recheck_records\"]\n    F --> G{\"结果\"}\n    G -->|正常| H[\"继续业务\"]\n    G -->|预警| I[\"继续 + 高亮提醒\"]\n    G -->|拦截| J[\"暂停 + 转人工/风险链路\"]\n```\n\n适用场景：主动推送后回复、用户再次联系、补充订单号、客服回访、TEL 来电、退款/返款/再次触达前。\n\n---\n\n# 第六部分：设计决策与边界\n\n## 23. 对象分类\n\n| 类型 | 对象 | 原因 |\n| --- | --- | --- |\n| **正式事务表** | `person_profiles`、`person_identity_links`、`support_tickets`、`support_followups`、`risk_cases`、`review_submission_records`、`quota_reservations` | 需要增删改和业务状态流转 |\n| **不可变事件表** | `im_interaction_records`、`edm_message_events`、`app_touch_events`、`tel_call_records`、`amazon_refund_records`、`oa_refund_records`、`support_assignment_logs`、`im_flow_tags` | 事实一旦发生不应被覆盖 |\n| **快照表** | `person_feature_snapshots`、`contact_context_snapshots`、`audience_snapshots`、`support_performance_snapshots`、`exemption_result_snapshots` | 需要保留某一时点状态以便复盘 |\n| **决策表** | `channel_route_decisions`、`channel_dedup_records`、`interaction_recheck_records`、`refund_match_results` | 保存系统当时为什么这样判断 |\n| **聚合画像** | `edm_user_behavior_profiles` | 由事件聚合推导，定期刷新 |\n| **可先做视图** | 当前剩余额度、当前风险摘要、当前上下文卡、当前人群统计看板、当前绩效看板 | 可由底层对象实时聚合 |\n\n### 判断法\n\n| 问题 | 如果答案是\"是\" |\n| --- | --- |\n| 后续需要追责\"当时为什么这么做\"吗 | 建正式表或决策表 |\n| 数据后来会变，但历史判断不能跟着变吗 | 建快照 |\n| 只是为了当前页面展示吗 | 优先做视图 |\n| 一旦发生就不该被覆盖吗 | 建事件表 |\n\n## 24. 当前还不能只靠\"老表扩列\"解决的事情\n\n| 问题 | 为什么不能只扩列 |\n| --- | --- |\n| 一个真实人多个账号 | `users` 是账号级，不是人级 |\n| 每次互动重判 | 不是用户静态属性，而是一次次决策事实 |\n| 人群为什么入选/排除 | 不是计划表字段，而是某一批次结果 |\n| 多计划并发占额度 | 需要独立预占 |\n| 用户提交与展示拆分 | 不是一个布尔值能表达 |\n| 退款比对 | 需要两个来源事实加一个比对结果 |\n| 客服上下文 | 不是工单表本身，而是跨源聚合视图+快照 |\n\n## 25. 当前可以先不做成物理表的内容\n\n| 内容 | 当前建议 |\n| --- | --- |\n| 当前剩余额度 | 先由 `person_quota_ledgers + quota_reservations` 聚合成视图 |\n| 当前风险摘要 | 先由 `risk_signals + risk_cases + blacklist_entities` 聚合成视图 |\n| 当前客服上下文卡 | 前台读当前视图，关键接入动作时写 `contact_context_snapshots` |\n| 当前人群统计看板 | 先基于 `audience_snapshots / exclusions` 聚合 |\n| 当前绩效看板 | 先基于工单、通话、跟进事件聚合，后续再沉淀快照 |\n\n## 26. 外部数据引用原则\n\n| 外部数据 | 所属系统 | USER 当前做法 |\n| --- | --- | --- |\n| Amazon 订单全量明细 | Amazon API/报表 | 导入关键字段，不把 USER 做成全量订单数仓 |\n| JOYHUB 用户行为明细 | APP/用户系统 | 取摘要或增量同步，用于画像与上下文 |\n| 黑名单全量数据 | 黑名单系统 | 引用并缓存关键维度，不重复建设 |\n| JOYCOLLAB 全量内容与带货明细 | JOYCOLLAB | 同步 USER 闭环所需结果摘要 |\n| 财务/人事原始表 | 财务/人事系统 | 导入必要摘要，不替代源系统 |\n\n## 27. 涉密字段处理\n\n| 涉密字段 | 建议存储 | 建议查询 |\n| --- | --- | --- |\n| 订单号 | 哈希索引 + 加密原值 | 常规用哈希匹配 |\n| 邮箱 | 哈希索引 + 脱敏展示 | 普通页面不暴露明文 |\n| 电话 | 哈希索引 + 加密原值 | 仅授权角色可揭示 |\n| 姓名/地址 | 标准化值 + 哈希/指纹 | 归并与风险用指纹 |\n| 设备号 | 哈希索引 | 归并/风险用哈希 |\n| IP | 脱敏存储 | 仅用于弱关联 |\n| 收款信息 | 加密存储 | 财务/风险授权查看 |\n| 返款金额/提成 | 权限控制 | 财务角色优先 |\n\n## 28. 快照策略\n\n| 快照对象 | 生成时机 | 保留策略 |\n| --- | --- | --- |\n| `person_feature_snapshots` | 定期刷新 + 人群生成前触发 | 保留最近 N 版 + 每次人群生成引用的版本 |\n| `contact_context_snapshots` | 用户接入/工单创建/拨打前/风险升级 | 每次生成新快照，保留全量历史 |\n| `audience_snapshots` | 人群生成时 | 每次计划保留 |\n| `edm_user_behavior_profiles` | EDM 画像定时刷新 | 按刷新批次保留 |\n| `support_performance_snapshots` | 每日/每周/每月 | 按周期聚合保留 |\n| `exemption_result_snapshots` | 免评执行阶段性同步 | 按结果周期保留 |\n\n---\n\n# 第七部分：谁写谁读\n\n## 29. 读写矩阵\n\n| 对象 | 主要写入方 | 主要读取方 | 依赖它的动作 |\n| --- | --- | --- | --- |\n| `person_profiles` | 身份归并服务 | 用户运营、客服、风险 | 所有真实人级判断 |\n| `person_identity_links` | 身份归并服务 | 风险、客服、订单核验 | 真实人识别 |\n| `person_feature_snapshots` | 画像任务 | 人群生成、客服 | 画像筛选 |\n| `contact_context_snapshots` | 上下文聚合服务 | 客服、用户运营 | 接入处理 |\n| `person_quota_ledgers` | 额度服务 | 人群生成、渠道、客服 | 4/4/12 判断 |\n| `quota_reservations` | 人群/计划服务 | 渠道、额度服务 | 发送前拦截 |\n| `audience_snapshots` | 人群生成服务 | 计划、复盘 | 解释入选 |\n| `channel_route_decisions` | 路由服务 | 推送、复盘 | 选渠道 |\n| `interaction_recheck_records` | 互动复检服务 | 客服、风险、审计 | 决定继续/拦截 |\n| `review_submission_records` | 客服/IM/TEL | 额度、计划、客服 | 计入12 |\n| `review_display_checks` | 运营/系统 | 计划、ASIN看板 | 计入完成 |\n| `refund_match_results` | 退款比对服务 | 风险、客服、财务 | 拦截双重退款 |\n\n---\n\n## 30. 还需要确认但不阻塞第三步的事项\n\n| 事项 | 影响 |\n| --- | --- |\n| Amazon 订单同步频率最终是否为 10 分钟 | 影响订单/退款数据新鲜度 |\n| 黑名单系统最终通过 API、表格还是消息同步 | 影响 `blacklist_entities` 同步方式 |\n| Amazon Profile ID 是否稳定获取 | 影响强关联覆盖率 |\n| APP 设备型号能否拿到具体型号还是只到类型 | 影响客服展示颗粒度 |\n| 年龄字段来自注册资料还是推断 | 影响画像可信度 |\n| KOC/KOL 结果同步周期 | 影响免评结果快照频率 |\n\n---\n\n## 31. 第四步入口\n\n1. **把数据对象转成逻辑 ER 图**：以 §20 的 Mermaid ER 图为基础，明确主键、外键、1对多/多对多关系，区分复用旧表和新增表。\n2. **按关键链路补接口读写**：\n   1. 真实人识别与上下文链路\n   2. 人群/额度/路由链路\n   3. 互动复检/风险链路\n   4. 评价提交/展示与退款比对链路\n   5. 免评结果链路\n3. **回到页面，把每一个点击绑定到明确的数据读写**。\n\n---\n\n## 32. 本版结论\n\nv3 以 Codex v1.1 完整字段字典为主骨架，补入 v2 的流转时序表、写入顺序图和快照策略，形成最终统一主稿：\n\n1. 用 **真实人** 统一账号、订单、设备和风险\n2. 用 **画像快照** 解释人群生成\n3. 用 **额度台账+预占** 保护 4/4/12 规则（跨账号合并）\n4. 用 **路由决策+去重记录** 控制多渠道协同\n5. 用 **互动复检记录** 落实\"每次有效互动都重判\"\n6. 用 **退款比对结果** 识别双重退款\n7. 用 **评价提交记录+展示核验** 拆开用户事实和平台结果\n8. 用 **免评计划→任务→内容→结果快照** 让 KOC/KOL 闭环完整进入 USER 系统\n",
        "wikilinks": [],
        "category": "layer-requirements"
      }
    },
    {
      "id": "doc:05_需求文档/README",
      "type": "document",
      "name": "需求文档",
      "filePath": "05_需求文档/README.md",
      "summary": "本目录用于集中存放后续持续补充的业务需求文档、业务规则文档、流程补充文档和需求变更文档。",
      "tags": [
        "05_需求文档",
        "需求文档"
      ],
      "complexity": "simple",
      "knowledgeMeta": {
        "content": "---\ntype: requirement_inbox\ntags: [需求文档, 需求收集, 知识库更新, Agent]\naliases: [需求文档目录, 需求收集目录, 需求入口]\nsource: manual\nstatus: active\nowner: 产品经理 / 业务主管\nupdated: 2026-05\n---\n\n# 需求文档\n\n本目录用于集中存放后续持续补充的业务需求文档、业务规则文档、流程补充文档和需求变更文档。\n\n## 使用方式\n\n1. 所有新增需求文档优先放入本目录。\n2. 建议使用 `03_规范与模板/需求说明模板.md` 或 `03_规范与模板/业务规则与需求补充模板.md` 创建文档。\n3. 文档确认有效后，同步更新业务流程索引和 Agent 检索索引。\n4. Agent 回答具体业务需求时，应优先检索本目录。\n\n## 推荐命名\n\n```text\n业务域_需求或规则名称_YYYYMMDD.md\n```\n\n示例：\n\n```text\n采购_供应商准入规则_20260526.md\n库存_出入库审批规则_20260526.md\n销售_客户授信额度需求_20260526.md\n```\n\n## 文档状态\n\n每个需求文档建议在 Frontmatter 中维护 `status`：\n\n| 状态 | 含义 |\n|---|---|\n| draft | 草稿，尚未确认 |\n| reviewing | 评审中 |\n| active | 已确认，可作为 Agent 回答依据 |\n| deprecated | 已废弃，仅归档参考 |\n\n## 必填内容\n\n每个需求文档至少包含：\n\n- 需求背景\n- 适用范围\n- 涉及角色\n- 业务规则\n- 业务流程\n- 异常处理\n- 权限要求\n- 验收口径\n- Agent 检索字段\n- 变更记录\n\n## 索引维护\n\n新增或修改需求文档后，需要同步更新：\n\n- `05_需求文档/需求文档索引.md`\n- `01_业务流程/业务规则索引.md`\n- `01_业务流程/业务对象字典.md`\n- `04_Agent检索/关键词索引.md`\n- `04_Agent检索/同义词表.md`\n- `04_Agent检索/来源文件索引.md`\n\n## 验证流程\n\n新增需求文档后，按 `04_Agent检索/知识库持续更新与验证流程.md` 执行验证，并将验证结果记录到：\n\n- `05_需求文档/需求文档索引.md`\n- `01_业务流程/业务补充验证记录.md`\n",
        "wikilinks": [],
        "category": "layer-requirements"
      }
    },
    {
      "id": "doc:05_需求文档/需求文档索引",
      "type": "document",
      "name": "需求文档索引",
      "filePath": "05_需求文档/需求文档索引.md",
      "summary": "本文件记录 `05_需求文档/` 下所有正式需求文档，供人工维护和 Agent 检索定位。",
      "tags": [
        "05_需求文档",
        "需求文档"
      ],
      "complexity": "simple",
      "knowledgeMeta": {
        "content": "---\ntype: requirement_index\ntags: [需求文档, 索引, Agent检索]\naliases: [需求索引, 需求文档清单, 需求清单]\nsource: manual\nstatus: active\nowner: 产品经理 / 业务主管\nupdated: 2026-05\n---\n\n# 需求文档索引\n\n本文件记录 `05_需求文档/` 下所有正式需求文档，供人工维护和 Agent 检索定位。\n\n## 需求文档清单\n\n| 编号 | 业务域 | 需求/规则名称 | 文件 | 状态 | 负责人 | 更新时间 | 验证状态 |\n|---|---|---|---|---|---|---|---|\n|  |  |  |  |  |  |  | 未验证 |\n\n## Agent 检索关键词\n\n| 关键词/问法 | 标准术语 | 命中文件 | 答案要点 |\n|---|---|---|---|\n|  |  |  |  |\n\n## 维护规则\n\n1. 新增需求文档后，必须在“需求文档清单”新增一行。\n2. 每个需求文档至少维护 3 个可检索问法。\n3. `状态=active` 的文档可作为 Agent 回答依据。\n4. `status=draft/reviewing` 的文档只能作为草稿参考，Agent 回答时需说明尚未确认。\n5. `status=deprecated` 的文档不得作为当前规则依据，只能说明历史背景。\n\n## 验证记录摘要\n\n| 日期 | 文件 | 验证问题数 | 通过数 | 失败数 | 结论 |\n|---|---|---:|---:|---:|---|\n|  |  |  |  |  |  |\n",
        "wikilinks": [],
        "category": "layer-requirements"
      }
    },
    {
      "id": "doc:06_里程碑/README",
      "type": "document",
      "name": "里程碑",
      "filePath": "06_里程碑/README.md",
      "summary": "本目录用于存放项目阶段计划、里程碑节点、阶段评审记录和上线节奏说明。",
      "tags": [
        "06_里程碑",
        "里程碑"
      ],
      "complexity": "simple",
      "knowledgeMeta": {
        "content": "---\ntype: milestone_home\ntags: [里程碑, 项目管理, 知识库]\naliases: [里程碑入口, 项目里程碑]\nsource: manual\nstatus: active\nowner: 项目经理\nupdated: 2026-05\n---\n\n# 里程碑\n\n本目录用于存放项目阶段计划、里程碑节点、阶段评审记录和上线节奏说明。\n\n## 二级入口\n\n- [[里程碑索引]]\n- [[阶段计划模板]]\n- [[里程碑评审记录]]\n\n## 存放内容\n\n- 项目启动节点\n- 需求评审节点\n- 原型/高保真确认节点\n- 开发启动节点\n- 测试准入节点\n- 上线检查节点\n- 复盘回流节点\n\n## 命名建议\n\n```text\n项目名_里程碑计划_YYYYMMDD.md\n项目名_阶段评审记录_YYYYMMDD.md\n```\n\n## 关联目录\n\n- 需求依据：[[../05_需求文档/README|需求文档]]\n- 流程依据：[[../02_项目管理流程/AI驱动内部系统开发流程_V3_总览|项目管理流程]]\n- 测试准入：[[../08_测试相关/README|测试相关]]\n",
        "wikilinks": [],
        "category": "layer-milestones"
      }
    },
    {
      "id": "doc:06_里程碑/里程碑索引",
      "type": "document",
      "name": "里程碑索引",
      "filePath": "06_里程碑/里程碑索引.md",
      "summary": "- 新增里程碑计划后，在本索引登记。",
      "tags": [
        "06_里程碑",
        "里程碑"
      ],
      "complexity": "simple",
      "knowledgeMeta": {
        "content": "---\ntype: milestone_index\ntags: [里程碑, 索引, Agent检索]\naliases: [里程碑清单, 项目节点索引]\nsource: manual\nstatus: active\nowner: 项目经理\nupdated: 2026-05\n---\n\n# 里程碑索引\n\n## 里程碑文档清单\n\n| 项目 | 里程碑名称 | 文件 | 阶段 | 负责人 | 计划时间 | 当前状态 |\n|---|---|---|---|---|---|---|\n|  |  |  |  |  |  |  |\n\n## Agent 检索关键词\n\n| 问法 | 标准术语 | 命中文件 | 答案要点 |\n|---|---|---|---|\n|  |  |  |  |\n\n## 维护规则\n\n- 新增里程碑计划后，在本索引登记。\n- 每个里程碑应关联至少一个需求文档或项目管理阶段。\n- Agent 回答项目进度、节点、准入问题时，应引用本索引或具体里程碑文件。\n",
        "wikilinks": [],
        "category": "layer-milestones"
      }
    },
    {
      "id": "doc:06_里程碑/里程碑评审记录",
      "type": "document",
      "name": "里程碑评审记录",
      "filePath": "06_里程碑/里程碑评审记录.md",
      "summary": "知识库文档。",
      "tags": [
        "06_里程碑",
        "里程碑"
      ],
      "complexity": "simple",
      "knowledgeMeta": {
        "content": "---\ntype: milestone_review_log\ntags: [里程碑, 评审, 记录]\naliases: [阶段评审记录, 里程碑评审]\nsource: manual\nstatus: active\nowner: 项目经理\nupdated: 2026-05\n---\n\n# 里程碑评审记录\n\n| 日期 | 项目 | 阶段 | 评审结论 | 遗留问题 | 负责人 | 后续动作 |\n|---|---|---|---|---|---|---|\n|  |  |  |  |  |  |  |\n",
        "wikilinks": [],
        "category": "layer-milestones"
      }
    },
    {
      "id": "doc:06_里程碑/阶段计划模板",
      "type": "document",
      "name": "阶段计划模板",
      "filePath": "06_里程碑/阶段计划模板.md",
      "summary": "- 需求文档：",
      "tags": [
        "06_里程碑",
        "里程碑"
      ],
      "complexity": "simple",
      "knowledgeMeta": {
        "content": "---\ntype: milestone_template\ntags: [里程碑, 阶段计划, 模板]\naliases: [阶段计划, 里程碑模板]\nsource: manual\nstatus: active\nowner: 项目经理\nupdated: 2026-05\n---\n\n# 阶段计划模板\n\n## 基本信息\n\n| 项目 | 内容 |\n|---|---|\n| 项目名称 |  |\n| 关联需求 |  |\n| 当前阶段 |  |\n| 负责人 |  |\n| 计划开始 |  |\n| 计划结束 |  |\n\n## 阶段目标\n\n\n## 输入材料\n\n- 需求文档：\n- 业务流程：\n- 技术文档：\n- 测试材料：\n\n## 关键任务\n\n| 任务 | 负责人 | 截止时间 | 输出物 | 状态 |\n|---|---|---|---|---|\n|  |  |  |  |  |\n\n## 阶段交付物\n\n\n## 准入/准出条件\n\n\n## 风险与阻塞\n\n\n## Agent 检索字段\n\n- 关键词：\n- 同义词：\n- 典型问法：\n",
        "wikilinks": [],
        "category": "layer-milestones"
      }
    },
    {
      "id": "doc:07_技术文档/README",
      "type": "document",
      "name": "技术文档",
      "filePath": "07_技术文档/README.md",
      "summary": "本目录用于存放系统架构、数据模型、接口说明、实现方案、部署说明和技术决策记录。",
      "tags": [
        "07_技术文档",
        "技术文档"
      ],
      "complexity": "simple",
      "knowledgeMeta": {
        "content": "---\ntype: technical_docs_home\ntags: [技术文档, 架构, 开发, 知识库]\naliases: [技术文档入口, 技术资料]\nsource: manual\nstatus: active\nowner: 技术负责人\nupdated: 2026-05\n---\n\n# 技术文档\n\n本目录用于存放系统架构、数据模型、接口说明、实现方案、部署说明和技术决策记录。\n\n## 二级入口\n\n- [[技术文档索引]]\n- [[系统架构说明模板]]\n- [[接口说明模板]]\n- [[技术决策记录]]\n\n## 存放内容\n\n- 系统架构说明\n- 模块设计说明\n- 数据表/业务对象设计\n- API 接口说明\n- 权限与安全设计\n- 部署与配置说明\n- 技术决策记录\n\n## 命名建议\n\n```text\n系统或模块_技术方案_YYYYMMDD.md\n系统或模块_接口说明_YYYYMMDD.md\n系统或模块_数据模型_YYYYMMDD.md\n```\n\n## 关联目录\n\n- 需求依据：[[../05_需求文档/README|需求文档]]\n- 测试依据：[[../08_测试相关/README|测试相关]]\n- 里程碑：[[../06_里程碑/README|里程碑]]\n",
        "wikilinks": [],
        "category": "layer-technical"
      }
    },
    {
      "id": "doc:07_技术文档/技术决策记录",
      "type": "document",
      "name": "技术决策记录",
      "filePath": "07_技术文档/技术决策记录.md",
      "summary": "知识库文档。",
      "tags": [
        "07_技术文档",
        "技术文档"
      ],
      "complexity": "simple",
      "knowledgeMeta": {
        "content": "---\ntype: adr_log\ntags: [技术文档, 技术决策, ADR]\naliases: [技术决策, ADR]\nsource: manual\nstatus: active\nowner: 技术负责人\nupdated: 2026-05\n---\n\n# 技术决策记录\n\n| 日期 | 决策主题 | 背景 | 决策结论 | 影响范围 | 关联需求/技术文档 |\n|---|---|---|---|---|---|\n|  |  |  |  |  |  |\n",
        "wikilinks": [],
        "category": "layer-technical"
      }
    },
    {
      "id": "doc:07_技术文档/技术文档索引",
      "type": "document",
      "name": "技术文档索引",
      "filePath": "07_技术文档/技术文档索引.md",
      "summary": "- 新增技术方案、接口说明、数据模型后，在本索引登记。",
      "tags": [
        "07_技术文档",
        "技术文档"
      ],
      "complexity": "simple",
      "knowledgeMeta": {
        "content": "---\ntype: technical_docs_index\ntags: [技术文档, 索引, Agent检索]\naliases: [技术索引, 技术资料清单]\nsource: manual\nstatus: active\nowner: 技术负责人\nupdated: 2026-05\n---\n\n# 技术文档索引\n\n## 技术文档清单\n\n| 模块/系统 | 文档类型 | 文件 | 关联需求 | 负责人 | 更新时间 | 状态 |\n|---|---|---|---|---|---|---|\n|  |  |  |  |  |  |  |\n\n## Agent 检索关键词\n\n| 问法 | 标准术语 | 命中文件 | 答案要点 |\n|---|---|---|---|\n|  |  |  |  |\n\n## 维护规则\n\n- 新增技术方案、接口说明、数据模型后，在本索引登记。\n- 技术文档必须关联需求文档或业务流程。\n- Agent 回答技术实现、接口、数据结构问题时，应优先检索本目录。\n",
        "wikilinks": [],
        "category": "layer-technical"
      }
    },
    {
      "id": "doc:07_技术文档/接口说明模板",
      "type": "document",
      "name": "接口说明模板",
      "filePath": "07_技术文档/接口说明模板.md",
      "summary": "- 关键词：",
      "tags": [
        "07_技术文档",
        "技术文档"
      ],
      "complexity": "simple",
      "knowledgeMeta": {
        "content": "---\ntype: api_template\ntags: [技术文档, 接口, 模板]\naliases: [接口模板, API说明模板]\nsource: manual\nstatus: active\nowner: 技术负责人\nupdated: 2026-05\n---\n\n# 接口说明模板\n\n## 基本信息\n\n| 项目 | 内容 |\n|---|---|\n| 接口名称 |  |\n| 所属模块 |  |\n| 关联需求 |  |\n| 负责人 |  |\n| 状态 | draft |\n\n## 接口用途\n\n\n## 请求说明\n\n| 字段 | 类型 | 必填 | 说明 | 示例 |\n|---|---|---|---|---|\n|  |  |  |  |  |\n\n## 响应说明\n\n| 字段 | 类型 | 说明 | 示例 |\n|---|---|---|---|\n|  |  |  |  |\n\n## 业务规则\n\n\n## 异常码\n\n| 异常码 | 含义 | 处理方式 |\n|---|---|---|\n|  |  |  |\n\n## Agent 检索字段\n\n- 关键词：\n- 同义词：\n- 典型问法：\n",
        "wikilinks": [],
        "category": "layer-technical"
      }
    },
    {
      "id": "doc:07_技术文档/系统架构说明模板",
      "type": "document",
      "name": "系统架构说明模板",
      "filePath": "07_技术文档/系统架构说明模板.md",
      "summary": "- 关键词：",
      "tags": [
        "07_技术文档",
        "技术文档"
      ],
      "complexity": "simple",
      "knowledgeMeta": {
        "content": "---\ntype: architecture_template\ntags: [技术文档, 架构, 模板]\naliases: [架构说明模板]\nsource: manual\nstatus: active\nowner: 技术负责人\nupdated: 2026-05\n---\n\n# 系统架构说明模板\n\n## 基本信息\n\n| 项目 | 内容 |\n|---|---|\n| 系统/模块 |  |\n| 关联需求 |  |\n| 负责人 |  |\n| 状态 | draft |\n\n## 背景与目标\n\n\n## 架构说明\n\n\n## 模块划分\n\n| 模块 | 职责 | 输入 | 输出 | 依赖 |\n|---|---|---|---|---|\n|  |  |  |  |  |\n\n## 数据模型\n\n\n## 接口关系\n\n\n## 权限与安全\n\n\n## 异常与边界\n\n\n## 部署与配置\n\n\n## Agent 检索字段\n\n- 关键词：\n- 同义词：\n- 典型问法：\n",
        "wikilinks": [],
        "category": "layer-technical"
      }
    },
    {
      "id": "doc:08_测试相关/README",
      "type": "document",
      "name": "测试相关",
      "filePath": "08_测试相关/README.md",
      "summary": "本目录用于存放测试计划、测试用例、测试报告、缺陷记录、验收记录和上线检查材料。",
      "tags": [
        "08_测试相关",
        "测试相关"
      ],
      "complexity": "simple",
      "knowledgeMeta": {
        "content": "---\ntype: testing_home\ntags: [测试, 测试用例, 验收, 知识库]\naliases: [测试相关入口, 测试文档]\nsource: manual\nstatus: active\nowner: 测试负责人\nupdated: 2026-05\n---\n\n# 测试相关\n\n本目录用于存放测试计划、测试用例、测试报告、缺陷记录、验收记录和上线检查材料。\n\n## 二级入口\n\n- [[测试用例索引]]\n- [[测试用例模板]]\n- [[测试计划模板]]\n- [[缺陷记录模板]]\n- [[验收记录模板]]\n- [[上线检查模板]]\n\n## 存放内容\n\n- 测试计划\n- 测试用例\n- 测试执行记录\n- 缺陷记录\n- 验收记录\n- 上线检查记录\n- 回归测试说明\n\n## 命名建议\n\n```text\n项目或模块_测试用例_YYYYMMDD.md\n项目或模块_测试计划_YYYYMMDD.md\n项目或模块_缺陷记录_YYYYMMDD.md\n项目或模块_验收记录_YYYYMMDD.md\n```\n\n## 关联目录\n\n- 需求依据：[[../05_需求文档/README|需求文档]]\n- 技术依据：[[../07_技术文档/README|技术文档]]\n- 里程碑依据：[[../06_里程碑/README|里程碑]]\n- 流程依据：[[../02_项目管理流程/阶段2.5_测试提前补漏|阶段2.5 测试提前补漏]]、[[../02_项目管理流程/阶段4_测试培训上线回流|阶段4 测试培训上线回流]]\n",
        "wikilinks": [],
        "category": "layer-testing"
      }
    },
    {
      "id": "doc:08_测试相关/上线检查模板",
      "type": "document",
      "name": "上线检查模板",
      "filePath": "08_测试相关/上线检查模板.md",
      "summary": "- 关键词：",
      "tags": [
        "08_测试相关",
        "测试相关"
      ],
      "complexity": "simple",
      "knowledgeMeta": {
        "content": "---\ntype: go_live_checklist_template\ntags: [上线检查, 测试, 模板]\naliases: [上线检查, 发布检查]\nsource: manual\nstatus: active\nowner: 测试负责人 / 项目经理\nupdated: 2026-05\n---\n\n# 上线检查模板\n\n## 基本信息\n\n| 项目 | 内容 |\n|---|---|\n| 项目/模块 |  |\n| 关联需求 |  |\n| 关联里程碑 |  |\n| 负责人 |  |\n| 检查日期 |  |\n\n## 上线前检查项\n\n| 检查项 | 负责人 | 结果 | 备注 |\n|---|---|---|---|\n| 需求已确认 |  |  |  |\n| 测试用例已执行 |  |  |  |\n| P0/P1 缺陷已关闭 |  |  |  |\n| 用户培训已完成 |  |  |  |\n| 回滚方案已确认 |  |  |  |\n| 数据备份已确认 |  |  |  |\n\n## 上线结论\n\n\n## 回滚条件\n\n\n## Agent 检索字段\n\n- 关键词：\n- 同义词：\n- 典型问法：\n",
        "wikilinks": [],
        "category": "layer-testing"
      }
    },
    {
      "id": "doc:08_测试相关/测试用例模板",
      "type": "document",
      "name": "测试用例模板",
      "filePath": "08_测试相关/测试用例模板.md",
      "summary": "- 关键词：",
      "tags": [
        "08_测试相关",
        "测试相关"
      ],
      "complexity": "simple",
      "knowledgeMeta": {
        "content": "---\ntype: test_case_template\ntags: [测试用例, 测试, 模板]\naliases: [用例模板, 测试用例]\nsource: manual\nstatus: active\nowner: 测试负责人\nupdated: 2026-05\n---\n\n# 测试用例模板\n\n## 基本信息\n\n| 项目 | 内容 |\n|---|---|\n| 项目/模块 |  |\n| 关联需求 |  |\n| 关联技术文档 |  |\n| 测试负责人 |  |\n| 状态 | draft |\n\n## 测试范围\n\n\n## 前置条件\n\n\n## 测试用例\n\n| 用例编号 | 场景 | 前置条件 | 操作步骤 | 预期结果 | 优先级 | 状态 |\n|---|---|---|---|---|---|---|\n| TC-001 |  |  |  |  | P1 | 未执行 |\n\n## 边界与异常场景\n\n\n## 验收口径\n\n\n## Agent 检索字段\n\n- 关键词：\n- 同义词：\n- 典型问法：\n",
        "wikilinks": [],
        "category": "layer-testing"
      }
    },
    {
      "id": "doc:08_测试相关/测试用例索引",
      "type": "document",
      "name": "测试用例索引",
      "filePath": "08_测试相关/测试用例索引.md",
      "summary": "- 新增测试用例后，必须在本索引登记。",
      "tags": [
        "08_测试相关",
        "测试相关"
      ],
      "complexity": "simple",
      "knowledgeMeta": {
        "content": "---\ntype: test_case_index\ntags: [测试用例, 测试, 索引, Agent检索]\naliases: [测试用例清单, 用例索引]\nsource: manual\nstatus: active\nowner: 测试负责人\nupdated: 2026-05\n---\n\n# 测试用例索引\n\n## 测试用例清单\n\n| 编号 | 项目/模块 | 用例集名称 | 文件 | 关联需求 | 关联技术文档 | 负责人 | 状态 | 更新时间 |\n|---|---|---|---|---|---|---|---|---|\n|  |  |  |  |  |  |  | 未验证 |  |\n\n## Agent 检索关键词\n\n| 问法 | 标准术语 | 命中文件 | 答案要点 |\n|---|---|---|---|\n|  |  |  |  |\n\n## 维护规则\n\n- 新增测试用例后，必须在本索引登记。\n- 每个测试用例文件必须关联至少一个需求文档。\n- 若测试用例依赖接口、数据模型或技术方案，应关联技术文档。\n- Agent 回答测试范围、验收口径、缺陷复现问题时，应优先检索本目录。\n",
        "wikilinks": [],
        "category": "layer-testing"
      }
    },
    {
      "id": "doc:08_测试相关/测试计划模板",
      "type": "document",
      "name": "测试计划模板",
      "filePath": "08_测试相关/测试计划模板.md",
      "summary": "- 关键词：",
      "tags": [
        "08_测试相关",
        "测试相关"
      ],
      "complexity": "simple",
      "knowledgeMeta": {
        "content": "---\ntype: test_plan_template\ntags: [测试计划, 测试, 模板]\naliases: [测试计划模板]\nsource: manual\nstatus: active\nowner: 测试负责人\nupdated: 2026-05\n---\n\n# 测试计划模板\n\n## 基本信息\n\n| 项目 | 内容 |\n|---|---|\n| 项目/模块 |  |\n| 关联需求 |  |\n| 关联里程碑 |  |\n| 测试负责人 |  |\n| 计划周期 |  |\n\n## 测试目标\n\n\n## 测试范围\n\n\n## 不在范围内\n\n\n## 测试资源\n\n\n## 测试安排\n\n| 阶段 | 时间 | 负责人 | 输出物 |\n|---|---|---|---|\n|  |  |  |  |\n\n## 准入条件\n\n\n## 准出条件\n\n\n## 风险\n\n\n## Agent 检索字段\n\n- 关键词：\n- 同义词：\n- 典型问法：\n",
        "wikilinks": [],
        "category": "layer-testing"
      }
    },
    {
      "id": "doc:08_测试相关/缺陷记录模板",
      "type": "document",
      "name": "缺陷记录模板",
      "filePath": "08_测试相关/缺陷记录模板.md",
      "summary": "1.",
      "tags": [
        "08_测试相关",
        "测试相关"
      ],
      "complexity": "simple",
      "knowledgeMeta": {
        "content": "---\ntype: defect_template\ntags: [缺陷, 测试, 模板]\naliases: [Bug记录模板, 缺陷记录]\nsource: manual\nstatus: active\nowner: 测试负责人\nupdated: 2026-05\n---\n\n# 缺陷记录模板\n\n## 基本信息\n\n| 项目 | 内容 |\n|---|---|\n| 缺陷编号 | BUG- |\n| 项目/模块 |  |\n| 关联需求 |  |\n| 关联用例 |  |\n| 严重级别 |  |\n| 当前状态 | open |\n| 负责人 |  |\n\n## 问题描述\n\n\n## 复现步骤\n\n1. \n2. \n3. \n\n## 实际结果\n\n\n## 预期结果\n\n\n## 影响范围\n\n\n## 修复结论\n\n\n## 回归验证\n\n\n## Agent 检索字段\n\n- 关键词：\n- 同义词：\n- 典型问法：\n",
        "wikilinks": [],
        "category": "layer-testing"
      }
    },
    {
      "id": "doc:08_测试相关/验收记录模板",
      "type": "document",
      "name": "验收记录模板",
      "filePath": "08_测试相关/验收记录模板.md",
      "summary": "- 关键词：",
      "tags": [
        "08_测试相关",
        "测试相关"
      ],
      "complexity": "simple",
      "knowledgeMeta": {
        "content": "---\ntype: acceptance_template\ntags: [验收, 测试, 模板]\naliases: [验收记录, UAT模板]\nsource: manual\nstatus: active\nowner: 测试负责人 / 业务负责人\nupdated: 2026-05\n---\n\n# 验收记录模板\n\n## 基本信息\n\n| 项目 | 内容 |\n|---|---|\n| 项目/模块 |  |\n| 关联需求 |  |\n| 关联测试用例 |  |\n| 验收负责人 |  |\n| 验收日期 |  |\n| 验收结论 |  |\n\n## 验收范围\n\n\n## 验收结果\n\n| 验收项 | 预期结果 | 实际结果 | 结论 | 备注 |\n|---|---|---|---|---|\n|  |  |  |  |  |\n\n## 遗留问题\n\n\n## 上线建议\n\n\n## Agent 检索字段\n\n- 关键词：\n- 同义词：\n- 典型问法：\n",
        "wikilinks": [],
        "category": "layer-testing"
      }
    },
    {
      "id": "doc:欢迎",
      "type": "document",
      "name": "欢迎使用如愿知识库",
      "filePath": "欢迎.md",
      "summary": "请从 [[00_首页/知识库首页]] 开始。",
      "tags": [
        "欢迎.md"
      ],
      "complexity": "simple",
      "knowledgeMeta": {
        "content": "---\ntype: index\ntags: [知识库, 入口]\naliases: [欢迎, 首页]\nsource: manual\nstatus: active\nowner: 内部技术团队\nupdated: 2026-05\n---\n\n# 欢迎使用如愿知识库\n\n请从 [[00_首页/知识库首页]] 开始。\n\n常用入口：\n\n- [[知识库使用说明]]\n- [[00_首页/知识地图]]\n- [[00_首页/Agent问答入口]]\n- [[05_需求文档/README|需求文档]]\n- [[06_里程碑/README|里程碑]]\n- [[07_技术文档/README|技术文档]]\n- [[08_测试相关/README|测试相关]]\n- [[04_Agent检索/检索说明]]",
        "wikilinks": [],
        "category": "layer-overview"
      }
    },
    {
      "id": "doc:知识库使用说明",
      "type": "document",
      "name": "如愿知识库使用说明",
      "filePath": "知识库使用说明.md",
      "summary": "本文档说明如愿知识库的用途、目录结构、文档存放规则、索引维护规则、Obsidian 图谱使用方式，以及 Agent 如何基于知识库回答问题。",
      "tags": [
        "知识库使用说明.md"
      ],
      "complexity": "moderate",
      "knowledgeMeta": {
        "content": "---\ntype: knowledge_base_guide\ntags: [知识库, 使用说明, Obsidian, Agent检索]\naliases: [如愿知识库使用说明, 知识库操作说明, 知识库维护说明]\nsource: manual\nstatus: active\nowner: 内部技术团队\nupdated: 2026-05\n---\n\n# 如愿知识库使用说明\n\n本文档说明如愿知识库的用途、目录结构、文档存放规则、索引维护规则、Obsidian 图谱使用方式，以及 Agent 如何基于知识库回答问题。\n\n## 1. 知识库定位\n\n如愿知识库用于沉淀内部系统建设过程中的：\n\n- 业务需求\n- 业务规则\n- 业务流程\n- 项目里程碑\n- 技术方案\n- 测试用例\n- 缺陷与验收记录\n- Agent 检索规则\n\n知识库不是单纯存文件，而是要形成可检索、可追溯、可被 Agent 引用回答的知识网络。\n\n## 2. 推荐打开方式\n\n推荐使用 Obsidian 打开以下目录作为 Vault：\n\n```text\nD:\\AIcoding\\WishFulfilled\\知识库\\如愿知识库\n```\n\n打开后建议从以下入口开始：\n\n1. [[欢迎]]\n2. [[00_首页/知识库首页]]\n3. [[00_首页/知识地图]]\n4. [[00_首页/Agent问答入口]]\n5. [[04_Agent检索/检索说明]]\n\n## 3. 主目录说明\n\n```text\n如愿知识库/\n├─ 00_首页/              # 首页、知识地图、Agent 问答入口\n├─ 01_业务流程/          # 业务流程、业务对象、业务规则、补充验证记录\n├─ 02_项目管理流程/      # 项目阶段、角色职责、交付物、检查清单、FAQ\n├─ 03_规范与模板/        # 需求、业务规则、会议、上线检查等模板\n├─ 04_Agent检索/         # 检索说明、关键词、同义词、来源文件索引\n├─ 05_需求文档/          # 正式需求文档、需求索引\n├─ 06_里程碑/            # 里程碑计划、阶段计划、评审记录\n├─ 07_技术文档/          # 技术方案、系统架构、接口说明、技术决策\n├─ 08_测试相关/          # 测试用例、测试计划、缺陷、验收、上线检查\n├─ 99_归档/              # 历史文档、废弃文档、仅供参考内容\n├─ 欢迎.md               # Obsidian 入口页\n├─ 知识库使用说明.md     # 本文档\n└─ Git使用说明.md        # Git 仓库协作说明\n```\n\n## 4. 日常使用入口\n\n| 使用场景 | 优先入口 |\n|---|---|\n| 想了解知识库整体结构 | [[00_首页/知识地图]] |\n| 想让 Agent 回答业务问题 | [[00_首页/Agent问答入口]] |\n| 查看或新增需求 | [[05_需求文档/README]] |\n| 查看或新增里程碑 | [[06_里程碑/README]] |\n| 查看或新增技术方案 | [[07_技术文档/README]] |\n| 查看或新增测试用例 | [[08_测试相关/README]] |\n| 查看项目管理阶段 | [[02_项目管理流程/AI驱动内部系统开发流程_V3_总览]] |\n| 查看 Agent 检索规则 | [[04_Agent检索/检索说明]] |\n| 查看来源依据 | [[04_Agent检索/来源文件索引]] |\n\n## 5. 文档应该放在哪里\n\n### 5.1 需求文档\n\n放入：\n\n```text\n05_需求文档/\n```\n\n适合存放：\n\n- 正式需求说明\n- 业务规则说明\n- 需求变更说明\n- 业务补充说明\n- 产品口径说明\n\n推荐命名：\n\n```text\n业务域_需求或规则名称_YYYYMMDD.md\n```\n\n示例：\n\n```text\nUSER评价业务闭环_数据流与中间对象设计_20260517.md\n采购_供应商准入规则_20260526.md\n库存_出入库审批规则_20260526.md\n```\n\n新增后应同步维护：\n\n- [[05_需求文档/需求文档索引]]\n- [[01_业务流程/业务规则索引]]，如涉及业务规则\n- [[01_业务流程/业务对象字典]]，如涉及新增业务对象\n- [[04_Agent检索/关键词索引]]，如需要 Agent 检索命中\n- [[04_Agent检索/来源文件索引]]，如是新的权威来源\n\n### 5.2 里程碑文档\n\n放入：\n\n```text\n06_里程碑/\n```\n\n适合存放：\n\n- 项目里程碑计划\n- 阶段计划\n- 阶段评审记录\n- 上线节奏\n- 准入/准出记录\n\n推荐命名：\n\n```text\n项目名_里程碑计划_YYYYMMDD.md\n项目名_阶段评审记录_YYYYMMDD.md\n```\n\n新增后应同步维护：\n\n- [[06_里程碑/里程碑索引]]\n\n### 5.3 技术文档\n\n放入：\n\n```text\n07_技术文档/\n```\n\n适合存放：\n\n- 系统架构说明\n- 数据模型说明\n- 接口说明\n- 模块设计\n- 技术方案\n- 部署说明\n- 技术决策记录\n\n推荐命名：\n\n```text\n系统或模块_技术方案_YYYYMMDD.md\n系统或模块_接口说明_YYYYMMDD.md\n系统或模块_数据模型_YYYYMMDD.md\n```\n\n新增后应同步维护：\n\n- [[07_技术文档/技术文档索引]]\n- [[04_Agent检索/关键词索引]]，如需要 Agent 检索\n- [[04_Agent检索/来源文件索引]]，如是新的技术依据\n\n### 5.4 测试相关文档\n\n放入：\n\n```text\n08_测试相关/\n```\n\n适合存放：\n\n- 测试计划\n- 测试用例\n- 缺陷记录\n- 验收记录\n- 上线检查\n- 回归测试记录\n\n推荐命名：\n\n```text\n项目名_模块名_测试计划_YYYYMMDD.md\n项目名_模块名_测试用例_YYYYMMDD.md\n项目名_模块名_缺陷记录_YYYYMMDD.md\n项目名_模块名_验收记录_YYYYMMDD.md\n```\n\n新增后应同步维护：\n\n- [[08_测试相关/测试用例索引]]\n- 关联需求文档\n- 关联里程碑或测试阶段\n\n测试用例必须能追溯到需求来源。\n\n### 5.5 业务流程文档\n\n放入：\n\n```text\n01_业务流程/\n```\n\n适合存放：\n\n- 已稳定的业务流程\n- 业务对象定义\n- 业务规则索引\n- 业务补充验证记录\n\n如果是新需求或尚未确认的业务规则，优先放入 `05_需求文档/`，确认稳定后再沉淀到 `01_业务流程/`。\n\n### 5.6 模板文档\n\n放入：\n\n```text\n03_规范与模板/\n```\n\n适合存放：\n\n- 需求说明模板\n- 业务规则补充模板\n- 会议纪要模板\n- 上线检查模板\n- 通用文档模板\n\n模板只用于复用格式，不应存放具体项目内容。\n\n### 5.7 归档文档\n\n放入：\n\n```text\n99_归档/\n```\n\n适合存放：\n\n- 已废弃文档\n- 历史版本\n- 仅供参考内容\n- 不再作为当前依据的旧规则\n\n归档文档不应作为 Agent 当前回答依据，除非问题明确询问历史背景。\n\n## 6. Agent 检索优先级\n\nAgent 回答问题时，按以下顺序查找依据：\n\n1. `05_需求文档/`：正式需求、业务规则、需求变更。\n2. `06_里程碑/`：项目节点、阶段计划、阶段评审、上线节奏。\n3. `07_技术文档/`：系统架构、数据模型、接口说明、实现方案、技术决策。\n4. `08_测试相关/`：测试计划、测试用例、缺陷记录、验收记录、上线检查。\n5. `02_项目管理流程/`：内部系统开发流程、阶段、角色、门禁、交付物、检查清单。\n6. `01_业务流程/`：真实业务流程、业务对象、业务规则。\n7. `04_Agent检索/`：关键词、同义词、来源索引、回答规则。\n8. `03_规范与模板/`：需要产出模板或文档时使用。\n\nAgent 回答必须注明来源文件。\n\n## 7. 不同问题应该查哪里\n\n| 问题类型 | 优先查找位置 |\n|---|---|\n| 某个需求是什么 | `05_需求文档/`、`05_需求文档/需求文档索引.md` |\n| 某个业务规则是什么 | `05_需求文档/`、`01_业务流程/业务规则索引.md` |\n| 某个业务对象怎么定义 | `01_业务流程/业务对象字典.md`、相关需求文档 |\n| 项目当前到哪个阶段 | `06_里程碑/`、`06_里程碑/里程碑索引.md` |\n| 某阶段要交付什么 | `02_项目管理流程/阶段交付物清单.md` |\n| 技术怎么实现 | `07_技术文档/`、`07_技术文档/技术文档索引.md` |\n| 接口怎么设计 | `07_技术文档/`、具体接口说明文档 |\n| 数据模型怎么设计 | `07_技术文档/`、具体数据模型文档、需求文档 |\n| 测试用例在哪里 | `08_测试相关/`、`08_测试相关/测试用例索引.md` |\n| 缺陷如何记录 | `08_测试相关/缺陷记录模板.md` |\n| 上线前检查什么 | `08_测试相关/上线检查模板.md`、`02_项目管理流程/项目检查清单.md` |\n| Agent 为什么这样回答 | `04_Agent检索/检索说明.md`、`04_Agent检索/来源文件索引.md` |\n\n## 8. 新增文档标准流程\n\n新增文档建议按以下流程操作：\n\n```text\n确定文档类型\n  ↓\n放入对应目录\n  ↓\n按推荐命名规则命名\n  ↓\n补充 Frontmatter\n  ↓\n正文写清背景、规则、流程、验收口径\n  ↓\n补充 Agent 检索字段\n  ↓\n更新对应索引\n  ↓\n更新关键词/来源文件索引\n  ↓\n在 Obsidian 中检查链接和图谱\n```\n\n## 9. 推荐 Frontmatter\n\n每个正式文档建议在顶部维护 Frontmatter：\n\n```yaml\n---\ntype: requirement\ntags: [需求文档, USER评价业务闭环]\naliases: [数据流与中间对象设计]\nsource: manual\nstatus: active\nowner: 产品经理\nupdated: 2026-05-26\n---\n```\n\n常用字段：\n\n| 字段 | 说明 |\n|---|---|\n| `type` | 文档类型，如 requirement、technical_doc、test_case、milestone |\n| `tags` | 标签，用于 Obsidian 和 Agent 检索 |\n| `aliases` | 别名，便于搜索同义叫法 |\n| `source` | 来源，如 manual、docx、meeting、requirement |\n| `status` | 状态，如 draft、reviewing、active、deprecated |\n| `owner` | 负责人 |\n| `updated` | 最近更新时间 |\n\n## 10. 文档状态说明\n\n| 状态 | 含义 | Agent 使用规则 |\n|---|---|---|\n| `draft` | 草稿 | 只能作为参考，回答时需说明尚未确认 |\n| `reviewing` | 评审中 | 可引用但需说明仍在评审 |\n| `active` | 已确认 | 可作为正式回答依据 |\n| `deprecated` | 已废弃 | 不作为当前规则依据，只能说明历史背景 |\n\n## 11. 索引维护规则\n\n### 11.1 需求索引\n\n新增需求文档后，维护：\n\n```text\n05_需求文档/需求文档索引.md\n```\n\n至少登记：\n\n- 编号\n- 业务域\n- 需求/规则名称\n- 文件路径\n- 状态\n- 负责人\n- 更新时间\n- 验证状态\n\n### 11.2 里程碑索引\n\n新增里程碑后，维护：\n\n```text\n06_里程碑/里程碑索引.md\n```\n\n至少登记：\n\n- 项目\n- 里程碑名称\n- 文件\n- 阶段\n- 负责人\n- 计划时间\n- 当前状态\n\n### 11.3 技术文档索引\n\n新增技术文档后，维护：\n\n```text\n07_技术文档/技术文档索引.md\n```\n\n至少登记：\n\n- 模块/系统\n- 文档类型\n- 文件\n- 关联需求\n- 负责人\n- 更新时间\n- 状态\n\n### 11.4 测试用例索引\n\n新增测试用例后，维护：\n\n```text\n08_测试相关/测试用例索引.md\n```\n\n至少登记：\n\n- 项目\n- 模块\n- 用例名称\n- 文件\n- 关联需求\n- 测试类型\n- 状态\n- 负责人\n\n## 12. Obsidian 链接规则\n\n推荐使用 Obsidian 双链：\n\n```markdown\n[[05_需求文档/需求文档索引]]\n[[07_技术文档/技术文档索引]]\n[[08_测试相关/测试用例索引]]\n```\n\n也可以使用 Markdown 链接：\n\n```markdown\n[需求文档索引](05_需求文档/需求文档索引.md)\n```\n\n优先建议使用双链，方便图谱建立关系。\n\n## 13. Obsidian 图谱说明\n\nObsidian 图谱会显示两类节点：\n\n1. 已存在的 Markdown 文件。\n2. 文档中链接到、但本地还不存在的 Markdown 文件。\n\n如果你只放了一个文件，但图谱出现多个节点，通常是因为该文件引用了其他文档。\n\n示例：\n\n```markdown\n[工作基线 v1.2](20260517_USER评价业务闭环主流程与后续工作基线_v1.2.md)\n```\n\n即使这个文件尚未放入目录，Obsidian 也可能在图谱中显示它。这是“未创建链接 / dangling link”，不是目录里真的多了文件。\n\n如果只想显示真实存在的文件，可在图谱中开启：\n\n```text\n图谱视图 → 筛选 → 仅显示已有文件\n```\n\n如果希望知识链路完整，应把被引用的上游文档补充到对应目录。\n\n## 14. 知识地图维护规则\n\n知识地图文件：\n\n```text\n00_首页/知识地图.md\n```\n\n知识地图只维护主入口和关键二级入口，不需要把每个具体项目文档都放进去。\n\n推荐主结构：\n\n```text\n知识地图\n├─ 需求文档\n├─ 里程碑\n├─ 技术文档\n├─ 测试相关\n└─ Agent 检索\n```\n\n新增普通需求、测试用例、技术方案时，一般只维护对应索引，不需要直接改知识地图。\n\n只有新增重要分类或核心入口时，才更新知识地图。\n\n## 15. Agent 回答规则\n\nAgent 基于知识库回答问题时，应遵守：\n\n1. 先查知识库，再回答。\n2. 优先引用 `active` 状态文档。\n3. 先给结论，再展开依据。\n4. 需求问题优先查需求文档。\n5. 技术问题优先查技术文档。\n6. 测试问题优先查测试相关。\n7. 里程碑问题优先查里程碑。\n8. 如果知识库没有明确记录，回答“知识库未明确记录”。\n9. 不要根据经验补充未记录的事实。\n10. 回答末尾必须说明来源文件。\n\n推荐引用格式：\n\n```text\n来源：05_需求文档/xxx.md\n```\n\n## 16. 测试用例管理要求\n\n测试用例应单独存放在：\n\n```text\n08_测试相关/\n```\n\n每个测试用例应尽量包含：\n\n- 用例编号\n- 关联需求\n- 测试模块\n- 前置条件\n- 操作步骤\n- 预期结果\n- 实际结果\n- 优先级\n- 状态\n- 负责人\n\n测试用例必须关联需求文档或业务规则，避免出现无法追溯来源的测试项。\n\n## 17. 文档关系建议\n\n推荐建立以下关系：\n\n```text\n需求文档\n  ↓\n里程碑 / 阶段计划\n  ↓\n技术文档\n  ↓\n测试计划 / 测试用例\n  ↓\n缺陷记录 / 验收记录\n  ↓\n上线检查 / 复盘回流\n```\n\n每个下游文档应尽量写明上游来源。\n\n示例：\n\n```markdown\n## 关联文档\n\n- 需求来源：[[05_需求文档/xxx需求文档]]\n- 技术方案：[[07_技术文档/xxx技术方案]]\n- 测试用例：[[08_测试相关/xxx测试用例]]\n```\n\n## 18. 不建议放入知识库的内容\n\n不建议直接放入：\n\n- 密码\n- Token\n- API Key\n- 未脱敏客户隐私\n- 未脱敏订单号、电话、邮箱、地址\n- 临时截图\n- 个人草稿\n- 与项目无关的资料\n\n如果必须记录敏感业务规则，应先脱敏再写入知识库。\n\n## 19. 提交前检查清单\n\n新增或修改文档后，检查：\n\n- [ ] 文件放在正确目录。\n- [ ] 文件名能表达业务域和用途。\n- [ ] 正式文档已写 Frontmatter。\n- [ ] 文档状态正确。\n- [ ] 关键业务规则有来源。\n- [ ] 需求文档已更新需求文档索引。\n- [ ] 技术文档已更新技术文档索引。\n- [ ] 测试用例已更新测试用例索引。\n- [ ] 重要关键词已补充到关键词索引。\n- [ ] 需要追溯的来源已补充到来源文件索引。\n- [ ] Obsidian 链接可以正常跳转，或确认是有意保留的上游虚链接。\n- [ ] 不包含密码、Token、密钥和未脱敏敏感信息。\n\n## 20. 常见问题\n\n### 20.1 为什么只放一个文档，图谱显示多个节点？\n\n因为文档中链接了其他 Markdown 文件。Obsidian 会把被链接但尚未创建的文件也显示成节点。\n\n### 20.2 README.md 为什么会出现在图谱里？\n\n因为 README.md 也是 Markdown 文件，Obsidian 会把它作为普通节点显示。\n\n### 20.3 一个具体项目文档要不要加到知识地图？\n\n通常不需要。具体项目文档登记到对应索引即可。知识地图只放主入口和关键二级入口。\n\n### 20.4 需求文档和业务流程怎么区分？\n\n- 尚在新增、变更、评审中的内容放 `05_需求文档/`。\n- 已稳定、可复用的业务流程沉淀到 `01_业务流程/`。\n\n### 20.5 测试用例应该跟需求还是技术文档关联？\n\n优先关联需求文档；如果测试点来自技术实现细节，再补充关联技术文档。\n\n### 20.6 Agent 回答错了怎么办？\n\n优先检查：\n\n1. 对应文档是否存在。\n2. 文档是否放在正确目录。\n3. 索引是否维护。\n4. 关键词或同义词是否缺失。\n5. 来源文件索引是否登记。\n6. 文档状态是否为 `active`。\n\n必要时更新：\n\n- [[04_Agent检索/关键词索引]]\n- [[04_Agent检索/同义词表]]\n- [[04_Agent检索/来源文件索引]]\n- [[04_Agent检索/知识库持续更新与验证流程]]\n\n## 21. 维护原则\n\n1. 文档要放对目录。\n2. 正式内容要有来源。\n3. 关键文档要有索引。\n4. 测试用例要能追溯需求。\n5. 技术文档要能追溯需求或业务流程。\n6. 里程碑要能追溯阶段目标和交付物。\n7. Agent 回答要能追溯来源文件。\n8. 废弃内容要归档，不要混在当前依据中。\n9. 敏感信息要脱敏。\n10. 知识库持续维护比一次性整理更重要。\n",
        "wikilinks": [],
        "category": "layer-overview"
      }
    },
    {
      "id": "flow:layer-overview",
      "type": "document",
      "name": "1. 知识库入口",
      "summary": "知识库使用说明、首页、知识地图和问答入口。先从这里理解知识库结构与检索方式。",
      "tags": [
        "流程入口",
        "知识库入口"
      ],
      "complexity": "simple",
      "knowledgeMeta": {
        "content": "# 知识库入口\n\n知识库使用说明、首页、知识地图和问答入口。先从这里理解知识库结构与检索方式。\n\n本层包含 5 个文档。点击右侧 Files 或在本层详情中选择具体文档查看内容。",
        "wikilinks": [],
        "category": "layer-overview"
      }
    },
    {
      "id": "flow:layer-requirements",
      "type": "document",
      "name": "2. 需求文档",
      "summary": "所有正式需求、业务规则、需求变更和需求索引。点击本层可查看全部需求文档并检索。",
      "tags": [
        "流程入口",
        "需求文档"
      ],
      "complexity": "simple",
      "knowledgeMeta": {
        "content": "# 需求文档\n\n所有正式需求、业务规则、需求变更和需求索引。点击本层可查看全部需求文档并检索。\n\n本层包含 3 个文档。点击右侧 Files 或在本层详情中选择具体文档查看内容。",
        "wikilinks": [],
        "category": "layer-requirements"
      }
    },
    {
      "id": "flow:layer-milestones",
      "type": "document",
      "name": "3. 里程碑",
      "summary": "项目阶段计划、里程碑节点、评审记录、准入准出和交付物节奏。",
      "tags": [
        "流程入口",
        "里程碑"
      ],
      "complexity": "simple",
      "knowledgeMeta": {
        "content": "# 里程碑\n\n项目阶段计划、里程碑节点、评审记录、准入准出和交付物节奏。\n\n本层包含 16 个文档。点击右侧 Files 或在本层详情中选择具体文档查看内容。",
        "wikilinks": [],
        "category": "layer-milestones"
      }
    },
    {
      "id": "flow:layer-technical",
      "type": "document",
      "name": "4. 技术文档",
      "summary": "系统架构、数据模型、接口说明、技术方案和技术决策。",
      "tags": [
        "流程入口",
        "技术文档"
      ],
      "complexity": "simple",
      "knowledgeMeta": {
        "content": "# 技术文档\n\n系统架构、数据模型、接口说明、技术方案和技术决策。\n\n本层包含 5 个文档。点击右侧 Files 或在本层详情中选择具体文档查看内容。",
        "wikilinks": [],
        "category": "layer-technical"
      }
    },
    {
      "id": "flow:layer-testing",
      "type": "document",
      "name": "5. 测试相关",
      "summary": "测试计划、测试用例、缺陷记录、验收记录和上线检查。",
      "tags": [
        "流程入口",
        "测试相关"
      ],
      "complexity": "simple",
      "knowledgeMeta": {
        "content": "# 测试相关\n\n测试计划、测试用例、缺陷记录、验收记录和上线检查。\n\n本层包含 7 个文档。点击右侧 Files 或在本层详情中选择具体文档查看内容。",
        "wikilinks": [],
        "category": "layer-testing"
      }
    },
    {
      "id": "flow:layer-agent",
      "type": "document",
      "name": "6. Agent检索",
      "summary": "检索说明、关键词、同义词、来源索引和持续更新验证流程。",
      "tags": [
        "流程入口",
        "Agent检索"
      ],
      "complexity": "simple",
      "knowledgeMeta": {
        "content": "# Agent检索\n\n检索说明、关键词、同义词、来源索引和持续更新验证流程。\n\n本层包含 6 个文档。点击右侧 Files 或在本层详情中选择具体文档查看内容。",
        "wikilinks": [],
        "category": "layer-agent"
      }
    }
  ],
  "edges": [
    {
      "source": "flow:layer-overview",
      "target": "flow:layer-requirements",
      "type": "documents",
      "direction": "forward",
      "description": "知识库主流程",
      "weight": 1.0
    },
    {
      "source": "flow:layer-requirements",
      "target": "flow:layer-milestones",
      "type": "documents",
      "direction": "forward",
      "description": "知识库主流程",
      "weight": 1.0
    },
    {
      "source": "flow:layer-milestones",
      "target": "flow:layer-technical",
      "type": "documents",
      "direction": "forward",
      "description": "知识库主流程",
      "weight": 1.0
    },
    {
      "source": "flow:layer-technical",
      "target": "flow:layer-testing",
      "type": "documents",
      "direction": "forward",
      "description": "知识库主流程",
      "weight": 1.0
    },
    {
      "source": "flow:layer-testing",
      "target": "flow:layer-agent",
      "type": "documents",
      "direction": "forward",
      "description": "知识库主流程",
      "weight": 1.0
    },
    {
      "source": "flow:layer-overview",
      "target": "doc:00_首页/Agent问答入口",
      "type": "documents",
      "direction": "forward",
      "description": "本层文档",
      "weight": 0.65
    },
    {
      "source": "flow:layer-overview",
      "target": "doc:00_首页/知识地图",
      "type": "documents",
      "direction": "forward",
      "description": "本层文档",
      "weight": 0.65
    },
    {
      "source": "flow:layer-overview",
      "target": "doc:00_首页/知识库首页",
      "type": "documents",
      "direction": "forward",
      "description": "本层文档",
      "weight": 0.65
    },
    {
      "source": "flow:layer-overview",
      "target": "doc:欢迎",
      "type": "documents",
      "direction": "forward",
      "description": "本层文档",
      "weight": 0.65
    },
    {
      "source": "flow:layer-overview",
      "target": "doc:知识库使用说明",
      "type": "documents",
      "direction": "forward",
      "description": "本层文档",
      "weight": 0.65
    },
    {
      "source": "flow:layer-requirements",
      "target": "doc:05_需求文档/20260517_USER评价业务闭环_第三步_数据流与中间对象设计_v3",
      "type": "documents",
      "direction": "forward",
      "description": "本层文档",
      "weight": 0.65
    },
    {
      "source": "flow:layer-requirements",
      "target": "doc:05_需求文档/README",
      "type": "documents",
      "direction": "forward",
      "description": "本层文档",
      "weight": 0.65
    },
    {
      "source": "flow:layer-requirements",
      "target": "doc:05_需求文档/需求文档索引",
      "type": "documents",
      "direction": "forward",
      "description": "本层文档",
      "weight": 0.65
    },
    {
      "source": "flow:layer-milestones",
      "target": "doc:02_项目管理流程/AI驱动内部系统开发流程_V3_总览",
      "type": "documents",
      "direction": "forward",
      "description": "本层文档",
      "weight": 0.65
    },
    {
      "source": "flow:layer-milestones",
      "target": "doc:02_项目管理流程/README",
      "type": "documents",
      "direction": "forward",
      "description": "本层文档",
      "weight": 0.65
    },
    {
      "source": "flow:layer-milestones",
      "target": "doc:02_项目管理流程/常见问题FAQ",
      "type": "documents",
      "direction": "forward",
      "description": "本层文档",
      "weight": 0.65
    },
    {
      "source": "flow:layer-milestones",
      "target": "doc:02_项目管理流程/角色职责矩阵",
      "type": "documents",
      "direction": "forward",
      "description": "本层文档",
      "weight": 0.65
    },
    {
      "source": "flow:layer-milestones",
      "target": "doc:02_项目管理流程/阶段0_项目入口分级",
      "type": "documents",
      "direction": "forward",
      "description": "本层文档",
      "weight": 0.65
    },
    {
      "source": "flow:layer-milestones",
      "target": "doc:02_项目管理流程/阶段1_业务需求完整形成",
      "type": "documents",
      "direction": "forward",
      "description": "本层文档",
      "weight": 0.65
    },
    {
      "source": "flow:layer-milestones",
      "target": "doc:02_项目管理流程/阶段2.5_测试提前补漏",
      "type": "documents",
      "direction": "forward",
      "description": "本层文档",
      "weight": 0.65
    },
    {
      "source": "flow:layer-milestones",
      "target": "doc:02_项目管理流程/阶段2_高保真模型与业务对象确认",
      "type": "documents",
      "direction": "forward",
      "description": "本层文档",
      "weight": 0.65
    },
    {
      "source": "flow:layer-milestones",
      "target": "doc:02_项目管理流程/阶段3_研发协作与正式开发",
      "type": "documents",
      "direction": "forward",
      "description": "本层文档",
      "weight": 0.65
    },
    {
      "source": "flow:layer-milestones",
      "target": "doc:02_项目管理流程/阶段4_测试培训上线回流",
      "type": "documents",
      "direction": "forward",
      "description": "本层文档",
      "weight": 0.65
    },
    {
      "source": "flow:layer-milestones",
      "target": "doc:02_项目管理流程/阶段交付物清单",
      "type": "documents",
      "direction": "forward",
      "description": "本层文档",
      "weight": 0.65
    },
    {
      "source": "flow:layer-milestones",
      "target": "doc:02_项目管理流程/项目检查清单",
      "type": "documents",
      "direction": "forward",
      "description": "本层文档",
      "weight": 0.65
    },
    {
      "source": "flow:layer-milestones",
      "target": "doc:06_里程碑/README",
      "type": "documents",
      "direction": "forward",
      "description": "本层文档",
      "weight": 0.65
    },
    {
      "source": "flow:layer-milestones",
      "target": "doc:06_里程碑/里程碑索引",
      "type": "documents",
      "direction": "forward",
      "description": "本层文档",
      "weight": 0.65
    },
    {
      "source": "flow:layer-milestones",
      "target": "doc:06_里程碑/里程碑评审记录",
      "type": "documents",
      "direction": "forward",
      "description": "本层文档",
      "weight": 0.65
    },
    {
      "source": "flow:layer-milestones",
      "target": "doc:06_里程碑/阶段计划模板",
      "type": "documents",
      "direction": "forward",
      "description": "本层文档",
      "weight": 0.65
    },
    {
      "source": "flow:layer-technical",
      "target": "doc:07_技术文档/README",
      "type": "documents",
      "direction": "forward",
      "description": "本层文档",
      "weight": 0.65
    },
    {
      "source": "flow:layer-technical",
      "target": "doc:07_技术文档/技术决策记录",
      "type": "documents",
      "direction": "forward",
      "description": "本层文档",
      "weight": 0.65
    },
    {
      "source": "flow:layer-technical",
      "target": "doc:07_技术文档/技术文档索引",
      "type": "documents",
      "direction": "forward",
      "description": "本层文档",
      "weight": 0.65
    },
    {
      "source": "flow:layer-technical",
      "target": "doc:07_技术文档/接口说明模板",
      "type": "documents",
      "direction": "forward",
      "description": "本层文档",
      "weight": 0.65
    },
    {
      "source": "flow:layer-technical",
      "target": "doc:07_技术文档/系统架构说明模板",
      "type": "documents",
      "direction": "forward",
      "description": "本层文档",
      "weight": 0.65
    },
    {
      "source": "flow:layer-testing",
      "target": "doc:08_测试相关/README",
      "type": "documents",
      "direction": "forward",
      "description": "本层文档",
      "weight": 0.65
    },
    {
      "source": "flow:layer-testing",
      "target": "doc:08_测试相关/上线检查模板",
      "type": "documents",
      "direction": "forward",
      "description": "本层文档",
      "weight": 0.65
    },
    {
      "source": "flow:layer-testing",
      "target": "doc:08_测试相关/测试用例模板",
      "type": "documents",
      "direction": "forward",
      "description": "本层文档",
      "weight": 0.65
    },
    {
      "source": "flow:layer-testing",
      "target": "doc:08_测试相关/测试用例索引",
      "type": "documents",
      "direction": "forward",
      "description": "本层文档",
      "weight": 0.65
    },
    {
      "source": "flow:layer-testing",
      "target": "doc:08_测试相关/测试计划模板",
      "type": "documents",
      "direction": "forward",
      "description": "本层文档",
      "weight": 0.65
    },
    {
      "source": "flow:layer-testing",
      "target": "doc:08_测试相关/缺陷记录模板",
      "type": "documents",
      "direction": "forward",
      "description": "本层文档",
      "weight": 0.65
    },
    {
      "source": "flow:layer-testing",
      "target": "doc:08_测试相关/验收记录模板",
      "type": "documents",
      "direction": "forward",
      "description": "本层文档",
      "weight": 0.65
    },
    {
      "source": "flow:layer-agent",
      "target": "doc:04_Agent检索/关键词索引",
      "type": "documents",
      "direction": "forward",
      "description": "本层文档",
      "weight": 0.65
    },
    {
      "source": "flow:layer-agent",
      "target": "doc:04_Agent检索/同义词表",
      "type": "documents",
      "direction": "forward",
      "description": "本层文档",
      "weight": 0.65
    },
    {
      "source": "flow:layer-agent",
      "target": "doc:04_Agent检索/来源文件索引",
      "type": "documents",
      "direction": "forward",
      "description": "本层文档",
      "weight": 0.65
    },
    {
      "source": "flow:layer-agent",
      "target": "doc:04_Agent检索/检索说明",
      "type": "documents",
      "direction": "forward",
      "description": "本层文档",
      "weight": 0.65
    },
    {
      "source": "flow:layer-agent",
      "target": "doc:04_Agent检索/知识库持续更新与验证流程",
      "type": "documents",
      "direction": "forward",
      "description": "本层文档",
      "weight": 0.65
    },
    {
      "source": "flow:layer-agent",
      "target": "doc:04_Agent检索/问答提示词",
      "type": "documents",
      "direction": "forward",
      "description": "本层文档",
      "weight": 0.65
    },
    {
      "source": "doc:04_Agent检索/知识库持续更新与验证流程",
      "target": "doc:00_首页/Agent问答入口",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:05_需求文档/需求文档索引",
      "target": "doc:00_首页/Agent问答入口",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:08_测试相关/测试用例索引",
      "target": "doc:00_首页/Agent问答入口",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:02_项目管理流程/AI驱动内部系统开发流程_V3_总览",
      "target": "doc:04_Agent检索/关键词索引",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:02_项目管理流程/角色职责矩阵",
      "target": "doc:04_Agent检索/关键词索引",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:02_项目管理流程/阶段0_项目入口分级",
      "target": "doc:04_Agent检索/关键词索引",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:02_项目管理流程/阶段1_业务需求完整形成",
      "target": "doc:04_Agent检索/关键词索引",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:02_项目管理流程/阶段2.5_测试提前补漏",
      "target": "doc:04_Agent检索/关键词索引",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:02_项目管理流程/阶段2_高保真模型与业务对象确认",
      "target": "doc:04_Agent检索/关键词索引",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:02_项目管理流程/阶段3_研发协作与正式开发",
      "target": "doc:04_Agent检索/关键词索引",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:02_项目管理流程/阶段4_测试培训上线回流",
      "target": "doc:04_Agent检索/关键词索引",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:02_项目管理流程/阶段交付物清单",
      "target": "doc:04_Agent检索/关键词索引",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:02_项目管理流程/项目检查清单",
      "target": "doc:04_Agent检索/关键词索引",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:04_Agent检索/知识库持续更新与验证流程",
      "target": "doc:04_Agent检索/关键词索引",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:02_项目管理流程/角色职责矩阵",
      "target": "doc:04_Agent检索/同义词表",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:02_项目管理流程/阶段0_项目入口分级",
      "target": "doc:04_Agent检索/同义词表",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:02_项目管理流程/阶段1_业务需求完整形成",
      "target": "doc:04_Agent检索/同义词表",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:02_项目管理流程/阶段2.5_测试提前补漏",
      "target": "doc:04_Agent检索/同义词表",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:02_项目管理流程/阶段2_高保真模型与业务对象确认",
      "target": "doc:04_Agent检索/同义词表",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:02_项目管理流程/阶段3_研发协作与正式开发",
      "target": "doc:04_Agent检索/同义词表",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:02_项目管理流程/阶段4_测试培训上线回流",
      "target": "doc:04_Agent检索/同义词表",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:02_项目管理流程/阶段交付物清单",
      "target": "doc:04_Agent检索/同义词表",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:02_项目管理流程/项目检查清单",
      "target": "doc:04_Agent检索/同义词表",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:04_Agent检索/知识库持续更新与验证流程",
      "target": "doc:04_Agent检索/同义词表",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:02_项目管理流程/AI驱动内部系统开发流程_V3_总览",
      "target": "doc:04_Agent检索/来源文件索引",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:02_项目管理流程/常见问题FAQ",
      "target": "doc:04_Agent检索/来源文件索引",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:02_项目管理流程/角色职责矩阵",
      "target": "doc:04_Agent检索/来源文件索引",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:02_项目管理流程/阶段0_项目入口分级",
      "target": "doc:04_Agent检索/来源文件索引",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:02_项目管理流程/阶段1_业务需求完整形成",
      "target": "doc:04_Agent检索/来源文件索引",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:02_项目管理流程/阶段2.5_测试提前补漏",
      "target": "doc:04_Agent检索/来源文件索引",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:02_项目管理流程/阶段2_高保真模型与业务对象确认",
      "target": "doc:04_Agent检索/来源文件索引",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:02_项目管理流程/阶段3_研发协作与正式开发",
      "target": "doc:04_Agent检索/来源文件索引",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:02_项目管理流程/阶段4_测试培训上线回流",
      "target": "doc:04_Agent检索/来源文件索引",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:02_项目管理流程/阶段交付物清单",
      "target": "doc:04_Agent检索/来源文件索引",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:02_项目管理流程/项目检查清单",
      "target": "doc:04_Agent检索/来源文件索引",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:04_Agent检索/知识库持续更新与验证流程",
      "target": "doc:04_Agent检索/来源文件索引",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:05_需求文档/需求文档索引",
      "target": "doc:04_Agent检索/来源文件索引",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:02_项目管理流程/AI驱动内部系统开发流程_V3_总览",
      "target": "doc:04_Agent检索/检索说明",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:02_项目管理流程/常见问题FAQ",
      "target": "doc:04_Agent检索/检索说明",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:02_项目管理流程/角色职责矩阵",
      "target": "doc:04_Agent检索/检索说明",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:02_项目管理流程/阶段2.5_测试提前补漏",
      "target": "doc:04_Agent检索/检索说明",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:02_项目管理流程/阶段2_高保真模型与业务对象确认",
      "target": "doc:04_Agent检索/检索说明",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:02_项目管理流程/阶段交付物清单",
      "target": "doc:04_Agent检索/检索说明",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:02_项目管理流程/项目检查清单",
      "target": "doc:04_Agent检索/检索说明",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:04_Agent检索/关键词索引",
      "target": "doc:04_Agent检索/检索说明",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:04_Agent检索/同义词表",
      "target": "doc:04_Agent检索/检索说明",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:05_需求文档/需求文档索引",
      "target": "doc:04_Agent检索/检索说明",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:06_里程碑/里程碑索引",
      "target": "doc:04_Agent检索/检索说明",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:07_技术文档/技术文档索引",
      "target": "doc:04_Agent检索/检索说明",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:07_技术文档/接口说明模板",
      "target": "doc:04_Agent检索/检索说明",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:08_测试相关/上线检查模板",
      "target": "doc:04_Agent检索/检索说明",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:08_测试相关/测试用例索引",
      "target": "doc:04_Agent检索/检索说明",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:08_测试相关/缺陷记录模板",
      "target": "doc:04_Agent检索/检索说明",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:08_测试相关/验收记录模板",
      "target": "doc:04_Agent检索/检索说明",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:04_Agent检索/关键词索引",
      "target": "doc:04_Agent检索/知识库持续更新与验证流程",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:04_Agent检索/同义词表",
      "target": "doc:04_Agent检索/知识库持续更新与验证流程",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:04_Agent检索/来源文件索引",
      "target": "doc:04_Agent检索/知识库持续更新与验证流程",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:05_需求文档/需求文档索引",
      "target": "doc:04_Agent检索/知识库持续更新与验证流程",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:02_项目管理流程/角色职责矩阵",
      "target": "doc:04_Agent检索/问答提示词",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:02_项目管理流程/阶段交付物清单",
      "target": "doc:04_Agent检索/问答提示词",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:02_项目管理流程/项目检查清单",
      "target": "doc:04_Agent检索/问答提示词",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:04_Agent检索/关键词索引",
      "target": "doc:05_需求文档/README",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:04_Agent检索/同义词表",
      "target": "doc:05_需求文档/README",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:04_Agent检索/来源文件索引",
      "target": "doc:05_需求文档/README",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:04_Agent检索/知识库持续更新与验证流程",
      "target": "doc:05_需求文档/README",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:05_需求文档/需求文档索引",
      "target": "doc:05_需求文档/README",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:00_首页/知识地图",
      "target": "doc:知识库使用说明",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:02_项目管理流程/README",
      "target": "doc:知识库使用说明",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:02_项目管理流程/阶段交付物清单",
      "target": "doc:知识库使用说明",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:02_项目管理流程/项目检查清单",
      "target": "doc:知识库使用说明",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:04_Agent检索/来源文件索引",
      "target": "doc:知识库使用说明",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:04_Agent检索/检索说明",
      "target": "doc:知识库使用说明",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:05_需求文档/README",
      "target": "doc:知识库使用说明",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:05_需求文档/需求文档索引",
      "target": "doc:知识库使用说明",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:06_里程碑/README",
      "target": "doc:知识库使用说明",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:06_里程碑/里程碑索引",
      "target": "doc:知识库使用说明",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:07_技术文档/README",
      "target": "doc:知识库使用说明",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:07_技术文档/技术文档索引",
      "target": "doc:知识库使用说明",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:08_测试相关/README",
      "target": "doc:知识库使用说明",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:08_测试相关/上线检查模板",
      "target": "doc:知识库使用说明",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:08_测试相关/测试用例索引",
      "target": "doc:知识库使用说明",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:08_测试相关/缺陷记录模板",
      "target": "doc:知识库使用说明",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    },
    {
      "source": "doc:欢迎",
      "target": "doc:知识库使用说明",
      "type": "depends_on",
      "direction": "forward",
      "description": "文档引用关系",
      "weight": 0.7
    }
  ],
  "layers": [
    {
      "id": "layer-overview",
      "name": "知识库入口",
      "description": "知识库使用说明、首页、知识地图和问答入口。先从这里理解知识库结构与检索方式。",
      "nodeIds": [
        "flow:layer-overview",
        "doc:00_首页/Agent问答入口",
        "doc:00_首页/知识地图",
        "doc:00_首页/知识库首页",
        "doc:欢迎",
        "doc:知识库使用说明"
      ]
    },
    {
      "id": "layer-requirements",
      "name": "需求文档",
      "description": "所有正式需求、业务规则、需求变更和需求索引。点击本层可查看全部需求文档并检索。",
      "nodeIds": [
        "flow:layer-requirements",
        "doc:05_需求文档/20260517_USER评价业务闭环_第三步_数据流与中间对象设计_v3",
        "doc:05_需求文档/README",
        "doc:05_需求文档/需求文档索引"
      ]
    },
    {
      "id": "layer-milestones",
      "name": "里程碑",
      "description": "项目阶段计划、里程碑节点、评审记录、准入准出和交付物节奏。",
      "nodeIds": [
        "flow:layer-milestones",
        "doc:02_项目管理流程/AI驱动内部系统开发流程_V3_总览",
        "doc:02_项目管理流程/README",
        "doc:02_项目管理流程/常见问题FAQ",
        "doc:02_项目管理流程/角色职责矩阵",
        "doc:02_项目管理流程/阶段0_项目入口分级",
        "doc:02_项目管理流程/阶段1_业务需求完整形成",
        "doc:02_项目管理流程/阶段2.5_测试提前补漏",
        "doc:02_项目管理流程/阶段2_高保真模型与业务对象确认",
        "doc:02_项目管理流程/阶段3_研发协作与正式开发",
        "doc:02_项目管理流程/阶段4_测试培训上线回流",
        "doc:02_项目管理流程/阶段交付物清单",
        "doc:02_项目管理流程/项目检查清单",
        "doc:06_里程碑/README",
        "doc:06_里程碑/里程碑索引",
        "doc:06_里程碑/里程碑评审记录",
        "doc:06_里程碑/阶段计划模板"
      ]
    },
    {
      "id": "layer-technical",
      "name": "技术文档",
      "description": "系统架构、数据模型、接口说明、技术方案和技术决策。",
      "nodeIds": [
        "flow:layer-technical",
        "doc:07_技术文档/README",
        "doc:07_技术文档/技术决策记录",
        "doc:07_技术文档/技术文档索引",
        "doc:07_技术文档/接口说明模板",
        "doc:07_技术文档/系统架构说明模板"
      ]
    },
    {
      "id": "layer-testing",
      "name": "测试相关",
      "description": "测试计划、测试用例、缺陷记录、验收记录和上线检查。",
      "nodeIds": [
        "flow:layer-testing",
        "doc:08_测试相关/README",
        "doc:08_测试相关/上线检查模板",
        "doc:08_测试相关/测试用例模板",
        "doc:08_测试相关/测试用例索引",
        "doc:08_测试相关/测试计划模板",
        "doc:08_测试相关/缺陷记录模板",
        "doc:08_测试相关/验收记录模板"
      ]
    },
    {
      "id": "layer-agent",
      "name": "Agent检索",
      "description": "检索说明、关键词、同义词、来源索引和持续更新验证流程。",
      "nodeIds": [
        "flow:layer-agent",
        "doc:04_Agent检索/关键词索引",
        "doc:04_Agent检索/同义词表",
        "doc:04_Agent检索/来源文件索引",
        "doc:04_Agent检索/检索说明",
        "doc:04_Agent检索/知识库持续更新与验证流程",
        "doc:04_Agent检索/问答提示词"
      ]
    }
  ],
  "tour": [
    {
      "order": 1,
      "title": "知识库入口",
      "description": "知识库使用说明、首页、知识地图和问答入口。先从这里理解知识库结构与检索方式。",
      "nodeIds": [
        "flow:layer-overview"
      ]
    },
    {
      "order": 2,
      "title": "需求文档",
      "description": "所有正式需求、业务规则、需求变更和需求索引。点击本层可查看全部需求文档并检索。",
      "nodeIds": [
        "flow:layer-requirements"
      ]
    },
    {
      "order": 3,
      "title": "里程碑",
      "description": "项目阶段计划、里程碑节点、评审记录、准入准出和交付物节奏。",
      "nodeIds": [
        "flow:layer-milestones"
      ]
    },
    {
      "order": 4,
      "title": "技术文档",
      "description": "系统架构、数据模型、接口说明、技术方案和技术决策。",
      "nodeIds": [
        "flow:layer-technical"
      ]
    },
    {
      "order": 5,
      "title": "测试相关",
      "description": "测试计划、测试用例、缺陷记录、验收记录和上线检查。",
      "nodeIds": [
        "flow:layer-testing"
      ]
    },
    {
      "order": 6,
      "title": "Agent检索",
      "description": "检索说明、关键词、同义词、来源索引和持续更新验证流程。",
      "nodeIds": [
        "flow:layer-agent"
      ]
    }
  ]
}