Files
Fulfilled-Knowledge/Understand-Anything-main/understand-anything-plugin/packages/dashboard/public/knowledge-graph.json
2026-05-27 15:40:32 +08:00

2000 lines
194 KiB
JSON
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
{
"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 IDA/B/CA 上提交 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"
]
}
]
}