From 0e85cb0d101bc846c26a949cff04b013230669d6 Mon Sep 17 00:00:00 2001 From: qiaoxinjiu Date: Tue, 26 May 2026 15:08:20 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=88=9D=E5=A7=8B=E5=8C=96=E5=A6=82?= =?UTF-8?q?=E6=84=BF=E7=9F=A5=E8=AF=86=E5=BA=93?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .obsidian/app.json | 1 + .obsidian/appearance.json | 3 + .obsidian/core-plugins.json | 33 + .obsidian/graph.json | 22 + .obsidian/workspace.json | 226 ++++ 00_首页/Agent问答入口.md | 55 + 00_首页/知识地图.md | 59 + 00_首页/知识库首页.md | 37 + 01_业务流程/README.md | 27 + 01_业务流程/业务对象字典.md | 30 + 01_业务流程/业务流程模板.md | 72 ++ 01_业务流程/业务补充验证记录.md | 36 + 01_业务流程/业务规则索引.md | 25 + .../AI驱动内部系统开发流程_V3_总览.md | 123 ++ 02_项目管理流程/README.md | 34 + 02_项目管理流程/常见问题FAQ.md | 65 ++ 02_项目管理流程/角色职责矩阵.md | 84 ++ 02_项目管理流程/阶段0_项目入口分级.md | 86 ++ 02_项目管理流程/阶段1_业务需求完整形成.md | 83 ++ 02_项目管理流程/阶段2.5_测试提前补漏.md | 79 ++ .../阶段2_高保真模型与业务对象确认.md | 81 ++ 02_项目管理流程/阶段3_研发协作与正式开发.md | 77 ++ 02_项目管理流程/阶段4_测试培训上线回流.md | 77 ++ 02_项目管理流程/阶段交付物清单.md | 42 + 02_项目管理流程/项目检查清单.md | 70 ++ 03_规范与模板/上线检查模板.md | 41 + 03_规范与模板/业务流程梳理模板.md | 15 + 03_规范与模板/业务规则与需求补充模板.md | 115 ++ 03_规范与模板/会议纪要模板.md | 36 + 03_规范与模板/需求说明模板.md | 52 + 04_Agent检索/关键词索引.md | 41 + 04_Agent检索/同义词表.md | 31 + 04_Agent检索/来源文件索引.md | 56 + 04_Agent检索/检索说明.md | 68 ++ 04_Agent检索/知识库持续更新与验证流程.md | 162 +++ 04_Agent检索/问答提示词.md | 48 + ...评价业务闭环_第三步_数据流与中间对象设计_v3.md | 1030 +++++++++++++++++ 05_需求文档/README.md | 78 ++ 05_需求文档/需求文档索引.md | 39 + 06_里程碑/README.md | 42 + 06_里程碑/里程碑索引.md | 29 + 06_里程碑/里程碑评审记录.md | 15 + 06_里程碑/阶段计划模板.md | 53 + 07_技术文档/README.md | 44 + 07_技术文档/技术决策记录.md | 15 + 07_技术文档/技术文档索引.md | 29 + 07_技术文档/接口说明模板.md | 51 + 07_技术文档/系统架构说明模板.md | 53 + 08_测试相关/README.md | 48 + 08_测试相关/上线检查模板.md | 44 + 08_测试相关/测试用例模板.md | 45 + 08_测试相关/测试用例索引.md | 30 + 08_测试相关/测试计划模板.md | 54 + 08_测试相关/缺陷记录模板.md | 53 + 08_测试相关/验收记录模板.md | 43 + ...价业务闭环_共用能力图与渠道专属流程_v2.2.md | 0 Git使用说明.md | 360 ++++++ 未命名.canvas | 1 + 欢迎.md | 23 + 59 files changed, 4371 insertions(+) create mode 100644 .obsidian/app.json create mode 100644 .obsidian/appearance.json create mode 100644 .obsidian/core-plugins.json create mode 100644 .obsidian/graph.json create mode 100644 .obsidian/workspace.json create mode 100644 00_首页/Agent问答入口.md create mode 100644 00_首页/知识地图.md create mode 100644 00_首页/知识库首页.md create mode 100644 01_业务流程/README.md create mode 100644 01_业务流程/业务对象字典.md create mode 100644 01_业务流程/业务流程模板.md create mode 100644 01_业务流程/业务补充验证记录.md create mode 100644 01_业务流程/业务规则索引.md create mode 100644 02_项目管理流程/AI驱动内部系统开发流程_V3_总览.md create mode 100644 02_项目管理流程/README.md create mode 100644 02_项目管理流程/常见问题FAQ.md create mode 100644 02_项目管理流程/角色职责矩阵.md create mode 100644 02_项目管理流程/阶段0_项目入口分级.md create mode 100644 02_项目管理流程/阶段1_业务需求完整形成.md create mode 100644 02_项目管理流程/阶段2.5_测试提前补漏.md create mode 100644 02_项目管理流程/阶段2_高保真模型与业务对象确认.md create mode 100644 02_项目管理流程/阶段3_研发协作与正式开发.md create mode 100644 02_项目管理流程/阶段4_测试培训上线回流.md create mode 100644 02_项目管理流程/阶段交付物清单.md create mode 100644 02_项目管理流程/项目检查清单.md create mode 100644 03_规范与模板/上线检查模板.md create mode 100644 03_规范与模板/业务流程梳理模板.md create mode 100644 03_规范与模板/业务规则与需求补充模板.md create mode 100644 03_规范与模板/会议纪要模板.md create mode 100644 03_规范与模板/需求说明模板.md create mode 100644 04_Agent检索/关键词索引.md create mode 100644 04_Agent检索/同义词表.md create mode 100644 04_Agent检索/来源文件索引.md create mode 100644 04_Agent检索/检索说明.md create mode 100644 04_Agent检索/知识库持续更新与验证流程.md create mode 100644 04_Agent检索/问答提示词.md create mode 100644 05_需求文档/20260517_USER评价业务闭环_第三步_数据流与中间对象设计_v3.md create mode 100644 05_需求文档/README.md create mode 100644 05_需求文档/需求文档索引.md create mode 100644 06_里程碑/README.md create mode 100644 06_里程碑/里程碑索引.md create mode 100644 06_里程碑/里程碑评审记录.md create mode 100644 06_里程碑/阶段计划模板.md create mode 100644 07_技术文档/README.md create mode 100644 07_技术文档/技术决策记录.md create mode 100644 07_技术文档/技术文档索引.md create mode 100644 07_技术文档/接口说明模板.md create mode 100644 07_技术文档/系统架构说明模板.md create mode 100644 08_测试相关/README.md create mode 100644 08_测试相关/上线检查模板.md create mode 100644 08_测试相关/测试用例模板.md create mode 100644 08_测试相关/测试用例索引.md create mode 100644 08_测试相关/测试计划模板.md create mode 100644 08_测试相关/缺陷记录模板.md create mode 100644 08_测试相关/验收记录模板.md create mode 100644 20260517_USER评价业务闭环_共用能力图与渠道专属流程_v2.2.md create mode 100644 Git使用说明.md create mode 100644 未命名.canvas create mode 100644 欢迎.md diff --git a/.obsidian/app.json b/.obsidian/app.json new file mode 100644 index 0000000..9e26dfe --- /dev/null +++ b/.obsidian/app.json @@ -0,0 +1 @@ +{} \ No newline at end of file diff --git a/.obsidian/appearance.json b/.obsidian/appearance.json new file mode 100644 index 0000000..4be7969 --- /dev/null +++ b/.obsidian/appearance.json @@ -0,0 +1,3 @@ +{ + "theme": "obsidian" +} \ No newline at end of file diff --git a/.obsidian/core-plugins.json b/.obsidian/core-plugins.json new file mode 100644 index 0000000..639b90d --- /dev/null +++ b/.obsidian/core-plugins.json @@ -0,0 +1,33 @@ +{ + "file-explorer": true, + "global-search": true, + "switcher": true, + "graph": true, + "backlink": true, + "canvas": true, + "outgoing-link": true, + "tag-pane": true, + "footnotes": false, + "properties": true, + "page-preview": true, + "daily-notes": true, + "templates": true, + "note-composer": true, + "command-palette": true, + "slash-command": false, + "editor-status": true, + "bookmarks": true, + "markdown-importer": false, + "zk-prefixer": false, + "random-note": false, + "outline": true, + "word-count": true, + "slides": false, + "audio-recorder": false, + "workspaces": false, + "file-recovery": true, + "publish": false, + "sync": true, + "bases": true, + "webviewer": false +} \ No newline at end of file diff --git a/.obsidian/graph.json b/.obsidian/graph.json new file mode 100644 index 0000000..ad48efa --- /dev/null +++ b/.obsidian/graph.json @@ -0,0 +1,22 @@ +{ + "collapse-filter": true, + "search": "", + "showTags": false, + "showAttachments": false, + "hideUnresolved": false, + "showOrphans": true, + "collapse-color-groups": false, + "colorGroups": [], + "collapse-display": false, + "showArrow": false, + "textFadeMultiplier": 0, + "nodeSizeMultiplier": 1, + "lineSizeMultiplier": 1, + "collapse-forces": true, + "centerStrength": 0.518713248970312, + "repelStrength": 10, + "linkStrength": 1, + "linkDistance": 250, + "scale": 0.9999999999999976, + "close": true +} \ No newline at end of file diff --git a/.obsidian/workspace.json b/.obsidian/workspace.json new file mode 100644 index 0000000..6827bd5 --- /dev/null +++ b/.obsidian/workspace.json @@ -0,0 +1,226 @@ +{ + "main": { + "id": "cbc7833e6ae0e16b", + "type": "split", + "children": [ + { + "id": "80711f127ce5a470", + "type": "tabs", + "children": [ + { + "id": "ff990f59633b7f33", + "type": "leaf", + "state": { + "type": "markdown", + "state": { + "file": "05_需求文档/20260517_USER评价业务闭环_第三步_数据流与中间对象设计_v3.md", + "mode": "source", + "source": false + }, + "icon": "lucide-file", + "title": "20260517_USER评价业务闭环_第三步_数据流与中间对象设计_v3" + } + } + ] + } + ], + "direction": "vertical" + }, + "left": { + "id": "ee9f886dd5e7ad74", + "type": "split", + "children": [ + { + "id": "a5fafeb928030213", + "type": "tabs", + "children": [ + { + "id": "5f88809baca22f4f", + "type": "leaf", + "state": { + "type": "file-explorer", + "state": { + "sortOrder": "alphabetical", + "autoReveal": false + }, + "icon": "lucide-folder-closed", + "title": "文件列表" + } + }, + { + "id": "444c717a69f391f1", + "type": "leaf", + "state": { + "type": "search", + "state": { + "query": "", + "matchingCase": false, + "explainSearch": false, + "collapseAll": false, + "extraContext": false, + "sortOrder": "alphabetical" + }, + "icon": "lucide-search", + "title": "搜索" + } + }, + { + "id": "6cdb50be8fd92385", + "type": "leaf", + "state": { + "type": "bookmarks", + "state": {}, + "icon": "lucide-bookmark", + "title": "书签" + } + } + ] + } + ], + "direction": "horizontal", + "width": 300 + }, + "right": { + "id": "d76d00fd901f4d51", + "type": "split", + "children": [ + { + "id": "c6e93b7c0a6b53a5", + "type": "tabs", + "children": [ + { + "id": "a3ca721552c50754", + "type": "leaf", + "state": { + "type": "backlink", + "state": { + "file": "05_需求文档/20260517_USER评价业务闭环_第三步_数据流与中间对象设计_v3.md", + "collapseAll": false, + "extraContext": false, + "sortOrder": "alphabetical", + "showSearch": false, + "searchQuery": "", + "backlinkCollapsed": false, + "unlinkedCollapsed": true + }, + "icon": "links-coming-in", + "title": "20260517_USER评价业务闭环_第三步_数据流与中间对象设计_v3 的反向链接列表" + } + }, + { + "id": "ffebe63020b4e178", + "type": "leaf", + "state": { + "type": "outgoing-link", + "state": { + "file": "05_需求文档/20260517_USER评价业务闭环_第三步_数据流与中间对象设计_v3.md", + "linksCollapsed": false, + "unlinkedCollapsed": true + }, + "icon": "links-going-out", + "title": "20260517_USER评价业务闭环_第三步_数据流与中间对象设计_v3 的出链列表" + } + }, + { + "id": "a137bd7bdab1bff0", + "type": "leaf", + "state": { + "type": "tag", + "state": { + "sortOrder": "frequency", + "useHierarchy": true, + "showSearch": false, + "searchQuery": "" + }, + "icon": "lucide-tags", + "title": "标签" + } + }, + { + "id": "9806bfea20ade829", + "type": "leaf", + "state": { + "type": "all-properties", + "state": { + "sortOrder": "frequency", + "showSearch": false, + "searchQuery": "" + }, + "icon": "lucide-archive", + "title": "添加笔记属性" + } + }, + { + "id": "adfd00e3ffdd3411", + "type": "leaf", + "state": { + "type": "outline", + "state": { + "file": "05_需求文档/20260517_USER评价业务闭环_第三步_数据流与中间对象设计_v3.md", + "followCursor": false, + "showSearch": false, + "searchQuery": "" + }, + "icon": "lucide-list", + "title": "20260517_USER评价业务闭环_第三步_数据流与中间对象设计_v3 的大纲" + } + } + ] + } + ], + "direction": "horizontal", + "width": 300, + "collapsed": true + }, + "left-ribbon": { + "hiddenItems": { + "switcher:打开快速切换": false, + "graph:查看关系图谱": false, + "canvas:新建白板": false, + "daily-notes:打开/创建今天的日记": false, + "templates:插入模板": false, + "command-palette:打开命令面板": false, + "bases:新建数据库": false + } + }, + "active": "ff990f59633b7f33", + "lastOpenFiles": [ + "Git使用说明.md", + "05_需求文档/20260517_USER评价业务闭环_第三步_数据流与中间对象设计_v3.md", + "02_项目管理流程/AI驱动内部系统开发流程_V3_总览.md", + "20260517_USER评价业务闭环_共用能力图与渠道专属流程_v2.2.md", + "00_首页/知识地图.md", + "未命名.canvas", + "08_测试相关/上线检查模板.md", + "08_测试相关/验收记录模板.md", + "08_测试相关/缺陷记录模板.md", + "08_测试相关/测试计划模板.md", + "08_测试相关/测试用例模板.md", + "08_测试相关/测试用例索引.md", + "08_测试相关/README.md", + "07_技术文档/技术决策记录.md", + "07_技术文档/接口说明模板.md", + "07_技术文档/系统架构说明模板.md", + "07_技术文档/技术文档索引.md", + "07_技术文档/README.md", + "06_里程碑/里程碑评审记录.md", + "06_里程碑/阶段计划模板.md", + "06_里程碑/里程碑索引.md", + "06_里程碑/README.md", + "08_测试相关", + "07_技术文档", + "06_里程碑", + "02_项目管理流程/阶段1_业务需求完整形成.md", + "05_需求文档/需求文档索引.md", + "05_需求文档/README.md", + "05_需求文档", + "01_业务流程/业务补充验证记录.md", + "04_Agent检索/知识库持续更新与验证流程.md", + "99_归档", + "04_Agent检索", + "03_规范与模板", + "02_项目管理流程", + "01_业务流程", + "00_首页" + ] +} \ No newline at end of file diff --git a/00_首页/Agent问答入口.md b/00_首页/Agent问答入口.md new file mode 100644 index 0000000..6059169 --- /dev/null +++ b/00_首页/Agent问答入口.md @@ -0,0 +1,55 @@ +--- +type: agent_entry +tags: [Agent, 问答, 检索] +aliases: [问答入口, Agent入口] +source: manual +status: active +owner: 内部技术团队 +updated: 2026-05 +--- + +# Agent 问答入口 + +当用户询问业务或项目流程时，Agent 应先检索本知识库 Markdown 文件，再组织回答。 + +## 推荐检索顺序 + +1. `05_需求文档/`：持续新增的业务需求、业务规则、需求变更。 +2. `06_里程碑/`：项目节点、阶段计划、阶段评审、上线节奏。 +3. `07_技术文档/`：架构、接口、数据模型、实现方案、技术决策。 +4. `08_测试相关/`：测试计划、测试用例、缺陷、验收、上线检查。 +5. `02_项目管理流程/`：阶段、角色、交付物、门禁、检查清单。 +6. `01_业务流程/`：具体业务流程、业务对象、业务规则。 +7. `04_Agent检索/`：关键词、同义词、回答规则、来源索引。 +8. `03_规范与模板/`：需要产出文档或表单时检索。 + +## 回答格式 + +- 先给结论。 +- 再按阶段、负责人、输入、关键动作、输出、检查点说明。 +- 最后注明来源文件。 +- 若知识库没有明确记录，回答“知识库未明确记录”，并说明建议补充到哪个文件。 + +## 示例问题 + +- 一个内部系统需求从提出到上线要走哪些阶段？ +- 阶段2.5测试提前补漏要产出什么？ +- 业务主管在项目入口分级中负责什么？ +- 什么时候需要前端提前参与需求收敛？ +- 新增一条业务规则后，怎么验证 Agent 能搜到？ +- 某个业务规则应该补充到哪个模板里？ +- 某个需求对应哪些测试用例？ +- 某个模块有哪些接口说明？ +- 这个项目当前处在哪个里程碑？ + +## 业务补充验证入口 + +- 需求文档目录：`05_需求文档/` +- 里程碑目录：`06_里程碑/` +- 技术文档目录：`07_技术文档/` +- 测试相关目录：`08_测试相关/` +- 需求文档索引：`05_需求文档/需求文档索引.md` +- 测试用例索引：`08_测试相关/测试用例索引.md` +- 模板：`03_规范与模板/业务规则与需求补充模板.md` +- 流程：`04_Agent检索/知识库持续更新与验证流程.md` +- 记录：`01_业务流程/业务补充验证记录.md` diff --git a/00_首页/知识地图.md b/00_首页/知识地图.md new file mode 100644 index 0000000..5a5ce10 --- /dev/null +++ b/00_首页/知识地图.md @@ -0,0 +1,59 @@ +--- +type: map +tags: [知识地图, 导航] +aliases: [知识库地图] +source: manual +status: active +owner: 内部技术团队 +updated: 2026-05 +--- + +# 知识地图 + +## 需求文档 + +- [[../05_需求文档/README|需求文档入口]] +- [[../05_需求文档/需求文档索引|需求文档索引]] +- [[../03_规范与模板/需求说明模板|需求说明模板]] +- [[../03_规范与模板/业务规则与需求补充模板|业务规则与需求补充模板]] +- [[../01_业务流程/业务规则索引|业务规则索引]] +- [[../01_业务流程/业务对象字典|业务对象字典]] + +## 里程碑 + +- [[../06_里程碑/README|里程碑入口]] +- [[../06_里程碑/里程碑索引|里程碑索引]] +- [[../06_里程碑/阶段计划模板|阶段计划模板]] +- [[../06_里程碑/里程碑评审记录|里程碑评审记录]] +- [[../02_项目管理流程/AI驱动内部系统开发流程_V3_总览|项目管理流程总览]] +- [[../02_项目管理流程/阶段交付物清单|阶段交付物清单]] +- [[../02_项目管理流程/项目检查清单|项目检查清单]] + +## 技术文档 + +- [[../07_技术文档/README|技术文档入口]] +- [[../07_技术文档/技术文档索引|技术文档索引]] +- [[../07_技术文档/系统架构说明模板|系统架构说明模板]] +- [[../07_技术文档/接口说明模板|接口说明模板]] +- [[../07_技术文档/技术决策记录|技术决策记录]] + +## 测试相关 + +- [[../08_测试相关/README|测试相关入口]] +- [[../08_测试相关/测试用例索引|测试用例索引]] +- [[../08_测试相关/测试用例模板|测试用例模板]] +- [[../08_测试相关/测试计划模板|测试计划模板]] +- [[../08_测试相关/缺陷记录模板|缺陷记录模板]] +- [[../08_测试相关/验收记录模板|验收记录模板]] +- [[../08_测试相关/上线检查模板|上线检查模板]] +- [[../02_项目管理流程/阶段2.5_测试提前补漏|阶段2.5 测试提前补漏]] +- [[../02_项目管理流程/阶段4_测试培训上线回流|阶段4 测试培训上线回流]] + +## Agent 检索 + +- [[../04_Agent检索/检索说明|检索说明]] +- [[../04_Agent检索/问答提示词|问答提示词]] +- [[../04_Agent检索/关键词索引|关键词索引]] +- [[../04_Agent检索/同义词表|同义词表]] +- [[../04_Agent检索/来源文件索引|来源文件索引]] +- [[../04_Agent检索/知识库持续更新与验证流程|持续更新与验证流程]] diff --git a/00_首页/知识库首页.md b/00_首页/知识库首页.md new file mode 100644 index 0000000..145e172 --- /dev/null +++ b/00_首页/知识库首页.md @@ -0,0 +1,37 @@ +--- +type: index +tags: [知识库, 首页, 如愿] +aliases: [如愿知识库首页, 知识库入口] +source: manual +status: active +owner: 内部技术团队 +updated: 2026-05 +--- + +# 如愿知识库首页 + +本知识库用于沉淀如愿内部系统建设中的业务流程、项目管理流程、角色职责、交付物、检查清单与 Agent 检索问答规范。 + +## 快速入口 + +- [[知识地图]] +- [[Agent问答入口]] +- [[../05_需求文档/README|需求文档]] +- [[../06_里程碑/README|里程碑]] +- [[../07_技术文档/README|技术文档]] +- [[../08_测试相关/README|测试相关]] +- [[../04_Agent检索/检索说明|Agent 检索说明]] + +## 当前权威来源 + +- 项目管理流程：`AI_驱动_内部系统开发流程_V3.docx` +- 适用范围：ERP、内部系统、小型业务系统、运营工具、AI 辅助开发项目。 + +## 使用原则 + +1. 需求类问题先查需求文档。 +2. 进度、节点、准入问题先查里程碑。 +3. 技术实现、接口、架构问题先查技术文档。 +4. 测试范围、用例、验收、缺陷问题先查测试相关。 +5. Agent 回答必须说明来源文件。 +6. 知识库没有明确记录时，不要猜测，应提示补充位置。 diff --git a/01_业务流程/README.md b/01_业务流程/README.md new file mode 100644 index 0000000..fc4aa26 --- /dev/null +++ b/01_业务流程/README.md @@ -0,0 +1,27 @@ +--- +type: index +tags: [业务流程, 入口] +aliases: [业务流程入口] +source: manual +status: active +owner: 业务主管 +updated: 2026-05 +--- + +# 业务流程 + +本目录用于沉淀真实业务流程。第一阶段先建立模板、业务对象字典和业务规则索引，后续按流程逐条补充。 + +## 当前文件 + +- [[业务流程模板]] +- [[业务对象字典]] +- [[业务规则索引]] + +## 录入要求 + +每条业务流程至少补充：流程名称、适用角色、触发条件、主流程、分支流程、异常处理、输入数据、输出结果、相关系统、业务规则、常见问题、关联项目管理阶段。 + +## 与项目管理流程的关系 + +业务流程内容主要用于支撑 [[../02_项目管理流程/阶段1_业务需求完整形成|阶段1 业务需求完整形成]] 和 [[../02_项目管理流程/阶段2_高保真模型与业务对象确认|阶段2 高保真模型与业务对象确认]]。 diff --git a/01_业务流程/业务对象字典.md b/01_业务流程/业务对象字典.md new file mode 100644 index 0000000..7044569 --- /dev/null +++ b/01_业务流程/业务对象字典.md @@ -0,0 +1,30 @@ +--- +type: dictionary +tags: [业务对象, 数据对象, 字典] +aliases: [业务对象模型, 对象字典] +source: manual +status: draft +owner: 业务主管 +updated: 2026-05 +--- + +# 业务对象字典 + +用于沉淀业务对象、字段、状态和生命周期，是页面、接口、数据库、测试、AI 提示词的共同基础。 + +## 对象清单 + +| 业务对象 | 定义 | 关键字段 | 状态 | 关联流程 | 备注 | +|---|---|---|---|---|---| +| | | | | | | + +## 维护规则 + +- 阶段2必须确认统一业务对象模型。 +- 新增页面、接口、数据库表或测试用例时，应回查本字典。 +- 字段含义、状态枚举和对象关系不明确时，不应进入正式开发。 + +## 关联条目 + +- [[../02_项目管理流程/阶段2_高保真模型与业务对象确认]] +- [[../02_项目管理流程/阶段交付物清单]] diff --git a/01_业务流程/业务流程模板.md b/01_业务流程/业务流程模板.md new file mode 100644 index 0000000..9929b54 --- /dev/null +++ b/01_业务流程/业务流程模板.md @@ -0,0 +1,72 @@ +--- +type: template +tags: [业务流程, 模板] +aliases: [业务流程梳理模板] +source: manual +status: active +owner: 业务主管 +updated: 2026-05 +--- + +# 业务流程模板 + +## 基本信息 + +- 流程名称： +- 适用部门： +- 适用角色： +- 相关系统： +- 流程负责人： +- 当前状态：draft / active / deprecated + +## 触发条件 + +说明什么情况下进入该流程。 + +## 前置条件 + +说明流程开始前必须满足的条件、权限、数据或审批。 + +## 主流程 + +1. +2. +3. + +## 分支流程 + +| 分支场景 | 判断条件 | 处理方式 | 负责人 | 输出 | +|---|---|---|---|---| +| | | | | | + +## 异常处理 + +| 异常场景 | 发现方式 | 处理方式 | 升级路径 | +|---|---|---|---| +| | | | | + +## 输入数据 + +| 数据项 | 来源 | 必填 | 说明 | +|---|---|---|---| +| | | | | + +## 输出结果 + +| 输出物 | 接收方 | 用途 | +|---|---|---| +| | | | + +## 业务规则 + +- + +## 常见问题 + +- 问： + 答： + +## 关联项目管理阶段 + +- [[../02_项目管理流程/阶段1_业务需求完整形成]] +- [[../02_项目管理流程/阶段2_高保真模型与业务对象确认]] diff --git a/01_业务流程/业务补充验证记录.md b/01_业务流程/业务补充验证记录.md new file mode 100644 index 0000000..21464cf --- /dev/null +++ b/01_业务流程/业务补充验证记录.md @@ -0,0 +1,36 @@ +--- +type: validation_log +tags: [业务流程, 业务规则, 验证记录, Agent检索] +aliases: [业务补充验证, Agent问答验证记录] +source: manual +status: active +owner: 产品经理 / 内部技术团队 +updated: 2026-05 +--- + +# 业务补充验证记录 + +## 使用说明 + +每次新增或修订 `01_业务流程/` 下的业务规则、需求或流程文档后，在此记录 Agent 检索验证结果。 + +## 验证记录 + +| 日期 | 业务域 | 新增/修订文件 | 验证问题 | 是否命中 | 来源文件 | 结果 | 待补充 | +|---|---|---|---|---|---|---|---| +| | | | | 是/否 | | 通过/失败 | | + +## 验证结论模板 + +```markdown +### YYYY-MM-DD 业务域_规则或需求名称 + +- 新增/修订文件： +- 已更新索引：业务规则索引 / 业务对象字典 / 关键词索引 / 同义词表 / 来源文件索引 +- 验证问题： + 1. + 2. + 3. +- 结论：通过 / 失败 +- 待补充： +``` diff --git a/01_业务流程/业务规则索引.md b/01_业务流程/业务规则索引.md new file mode 100644 index 0000000..b5db1f1 --- /dev/null +++ b/01_业务流程/业务规则索引.md @@ -0,0 +1,25 @@ +--- +type: index +tags: [业务规则, 索引] +aliases: [规则索引] +source: manual +status: draft +owner: 业务主管 +updated: 2026-05 +--- + +# 业务规则索引 + +用于集中记录跨流程复用的业务规则，避免规则散落在需求、页面和测试用例中。 + +| 规则编号 | 规则名称 | 适用流程 | 规则说明 | 来源 | 状态 | +|---|---|---|---|---|---| +| BR-001 | | | | | draft | + +## 维护要求 + +- 规则必须能追溯到业务流程或项目文档。 +- 涉及权限、状态流转、金额、时间、审批、异常处理的规则应优先沉淀。 +- 规则变更后，应同步检查测试用例和上线培训材料。 +- 新增规则建议使用 `03_规范与模板/业务规则与需求补充模板.md`。 +- 新增或修订后，按 `04_Agent检索/知识库持续更新与验证流程.md` 执行 Agent 检索验证。 diff --git a/02_项目管理流程/AI驱动内部系统开发流程_V3_总览.md b/02_项目管理流程/AI驱动内部系统开发流程_V3_总览.md new file mode 100644 index 0000000..e509662 --- /dev/null +++ b/02_项目管理流程/AI驱动内部系统开发流程_V3_总览.md @@ -0,0 +1,123 @@ +--- +type: process_overview +tags: [项目管理流程, AI驱动开发, ERP, 内部系统] +aliases: [AI驱动内部系统开发流程, 内部系统开发流程V3, ERP开发流程] +source: AI_驱动_内部系统开发流程_V3.docx +status: active +owner: 内部技术团队 +updated: 2026-05 +--- + +# AI 驱动内部系统开发流程 V3 总览 + +## 版本定位 + +本流程适用于公司当前阶段的 ERP、内部系统、小型业务系统、运营工具、AI 辅助开发项目。 + +核心目标不是让流程变复杂，而是解决以下问题： + +- 业务需求说不清。 +- AI 生成内容不完整。 +- 前端模型介入太晚。 +- 后端数据库设计被页面倒逼。 +- 测试太晚才发现需求漏项。 +- 项目完成后留下大量重复代码和技术债。 + +## 总体阶段 + +| 阶段 | 阶段名称 | 核心目标 | 核心负责人 | +|---|---|---|---| +| 阶段0 | 项目入口分级 | 判断项目是否值得做、走轻流程还是完整流程 | 业务主管 / 技术负责人 | +| 阶段1 | 业务需求完整形成 | 业务侧通过 Vibe Coding 跑完整需求 | 业务主管 / 业务人员 | +| 阶段2 | 高保真模型与业务对象确认 | 把完整但粗糙的需求收敛成可开发模型 | 前端 / 产品经理 | +| 阶段2.5 | 测试提前补漏 | 在开发前用测试视角发现需求漏洞 | 测试 | +| 阶段3 | 研发协作与正式开发 | 基于高保真模型进行模块化、安全、可维护开发 | 前端 / 后端 / 算法 | +| 阶段4 | 测试、培训、上线、回流 | 完成测试、培训、上线验收和问题回流 | 测试 / 业务主管 | +| 阶段5 | 技术债治理与能力沉淀 | 清理 AI 冗余代码并沉淀复用能力 | 技术负责人 | + +## 阶段门禁 + +| 门禁 | 通过标准 | +|---|---| +| Gate 0 | 项目入口通过：确认值得做，确认项目类型。 | +| Gate 1 | 需求完整通过：主流程、分支、页面、按钮、字段、状态大致完整。 | +| Gate 2 | 高保真模型通过：页面收敛、按钮行为、业务对象、状态、V1/V2 明确。 | +| Gate 2.5 | 测试补漏：测试用例初稿发现的阻塞问题已处理。 | +| Gate 3 | 开发联调通过：前后端、数据库、权限、安全、主要流程联调完成。 | +| Gate 4 | 上线验收通过：测试通过、业务确认、培训完成。 | +| Gate 5 | 技术债治理完成：重复代码、组件、接口、数据结构完成治理或进入债务池。 | + +## 完整版文件结构 + +- `00_项目入口分级.md` +- `01_主流程说明.md` +- `02_日常操作页面结构.md` +- `03_功能页面按钮盘点表.md` +- `04_分支流程_XXX.md` +- `05_异常流程_XXX.md` +- `06_VibeCoding页面验证记录.md` +- `07_高保真模型.html` +- `07_高保真模型说明.md` +- `08_项目周期与版本确认.md` +- `09_前端技术评审.md` +- `10_技术预检记录.md` +- `10A_统一业务对象模型.md` +- `10B_按钮行为矩阵.md` +- `11_测试用例初稿与需求补漏.md` +- `12_研发任务拆分与协作计划.md` +- `13_技术实现对接.md` +- `14_代码治理与安全规范.md` +- `15_开发问题与联调记录.md` +- `16_正式测试报告.md` +- `17_内部培训手册.md` +- `18_上线验收记录.md` +- `19_上线问题与回流需求.md` +- `20_技术债清单.md` +- `21_业务原子能力沉淀清单.md` +- `22_组件库与服务复用清单.md` +- `23_AI开发上下文模板更新记录.md` + +## 轻量版文件结构 + +小项目可以使用轻量版： + +- `00_项目入口分级.md` +- `01_业务需求包.md` +- `02_高保真模型包.md` +- `03_项目版本与技术预检.md` +- `04_测试用例初稿与需求补漏.md` +- `05_研发协作与技术实现包.md` +- `06_代码治理与安全规范.md` +- `07_测试培训上线包.md` +- `08_技术债与能力沉淀包.md` + +## 最终核心原则 + +- 先分级，再开发。 +- 阶段1追求需求完整，不追求产品完善。 +- Vibe Coding 页面只是需求原型，不直接进入生产。 +- 阶段2追求模型高效，前端必须深度参与。 +- 高保真模型确认后，才允许正式开发。 +- 统一业务对象模型是页面、接口、数据库、测试、AI 提示词的共同基础。 +- 性能、安全、权限、并发、日志、可回滚必须提前预检。 +- 测试提前补漏，不只是上线前找 Bug。 +- 研发阶段以代码质量、模块化、安全性、可维护性为中心。 +- AI 代码必须治理，不能直接堆进生产。 +- 每个项目都要沉淀业务原子能力。 +- 每完成 3-4 个项目，必须进行技术债治理。 + +## 一句话总结 + +这套流程不是为了让 AI 替代开发，而是让 AI 帮业务更快形成完整需求，让前端和产品把需求收敛成高保真模型，让研发团队基于模型高质量开发，让测试和技术债治理保障系统长期可用。 + +## 关联条目 + +- [[阶段0_项目入口分级]] +- [[阶段1_业务需求完整形成]] +- [[阶段2_高保真模型与业务对象确认]] +- [[阶段2.5_测试提前补漏]] +- [[阶段3_研发协作与正式开发]] +- [[阶段4_测试培训上线回流]] +- [[角色职责矩阵]] +- [[阶段交付物清单]] +- [[项目检查清单]] diff --git a/02_项目管理流程/README.md b/02_项目管理流程/README.md new file mode 100644 index 0000000..d85fe97 --- /dev/null +++ b/02_项目管理流程/README.md @@ -0,0 +1,34 @@ +--- +type: index +tags: [项目管理流程, AI驱动开发] +aliases: [项目管理流程入口, 开发流程入口] +source: AI_驱动_内部系统开发流程_V3.docx +status: active +owner: 内部技术团队 +updated: 2026-05 +--- + +# 项目管理流程 + +本目录基于 `AI_驱动_内部系统开发流程_V3.docx` 拆解，用于指导 ERP、内部系统、小型业务系统、运营工具、AI 辅助开发项目。 + +## 阶段文件 + +- [[AI驱动内部系统开发流程_V3_总览]] +- [[阶段0_项目入口分级]] +- [[阶段1_业务需求完整形成]] +- [[阶段2_高保真模型与业务对象确认]] +- [[阶段2.5_测试提前补漏]] +- [[阶段3_研发协作与正式开发]] +- [[阶段4_测试培训上线回流]] + +## 重组索引 + +- [[角色职责矩阵]] +- [[阶段交付物清单]] +- [[项目检查清单]] +- [[常见问题FAQ]] + +## 核心原则 + +先分级，再开发。阶段1追求需求完整，不追求产品完善。高保真模型确认后，才允许正式开发。测试要提前补漏。AI 代码必须治理，不能直接堆进生产。 diff --git a/02_项目管理流程/常见问题FAQ.md b/02_项目管理流程/常见问题FAQ.md new file mode 100644 index 0000000..6e7adbc --- /dev/null +++ b/02_项目管理流程/常见问题FAQ.md @@ -0,0 +1,65 @@ +--- +type: faq +tags: [项目管理流程, FAQ, 问答] +aliases: [流程常见问题, 项目管理问答] +source: AI_驱动_内部系统开发流程_V3.docx +status: active +owner: 内部技术团队 +updated: 2026-05 +--- + +# 常见问题 FAQ + +## 一个内部系统需求从提出到上线要走哪些阶段？ + +通常经过阶段0项目入口分级、阶段1业务需求完整形成、阶段2高保真模型与业务对象确认、阶段2.5测试提前补漏、阶段3研发协作与正式开发、阶段4测试培训上线回流。文档还定义了阶段5技术债治理与能力沉淀。 + +来源：[[AI驱动内部系统开发流程_V3_总览]] + +## 阶段0项目入口分级由谁负责？ + +由业务主管和技术负责人共同负责。业务主管判断业务价值和范围，技术负责人判断技术复杂度和风险。 + +来源：[[阶段0_项目入口分级]]、[[角色职责矩阵]] + +## 业务需求完整形成阶段的目标是什么？ + +业务侧通过 Vibe Coding 跑完整需求。阶段1追求需求完整，不追求产品完善。 + +来源：[[阶段1_业务需求完整形成]] + +## 阶段2.5测试提前补漏应该在什么时候发生？ + +发生在高保真模型确认后、正式开发前。 + +来源：[[阶段2.5_测试提前补漏]] + +## 阶段2.5测试提前补漏要产出什么？ + +主要产出 `11_测试用例初稿与需求补漏.md`，并形成需求补漏记录、阻塞问题清单和已关闭问题清单。 + +来源：[[阶段2.5_测试提前补漏]]、[[阶段交付物清单]] + +## 什么时候需要前端提前参与需求收敛？ + +阶段2必须由前端深度参与。若需求涉及多页面、复杂交互、权限、状态流转、数据结构或组件复用，前端应在需求收敛时提前参与。 + +来源：[[阶段2_高保真模型与业务对象确认]] + +## 研发协作与正式开发阶段如何保证模块化、安全和可维护？ + +依赖统一业务对象模型、研发任务拆分、技术实现对接、代码治理与安全规范、开发问题与联调记录。AI 代码必须经过治理，不能直接堆进生产。 + +来源：[[阶段3_研发协作与正式开发]] + +## 上线前需要检查哪些事项？ + +至少检查正式测试、主流程、分支流程、权限、异常、数据边界、内部培训手册、业务确认、上线问题回流机制。 + +来源：[[阶段4_测试培训上线回流]]、[[项目检查清单]] + +## Vibe Coding 页面能不能直接进入生产？ + +不能。Vibe Coding 页面只是需求原型，不直接进入生产。 + +来源：[[阶段1_业务需求完整形成]]、[[AI驱动内部系统开发流程_V3_总览]] diff --git a/02_项目管理流程/角色职责矩阵.md b/02_项目管理流程/角色职责矩阵.md new file mode 100644 index 0000000..a74f656 --- /dev/null +++ b/02_项目管理流程/角色职责矩阵.md @@ -0,0 +1,84 @@ +--- +type: responsibility_matrix +tags: [项目管理流程, 角色职责, RACI] +aliases: [角色职责, 职责矩阵, RACI] +source: AI_驱动_内部系统开发流程_V3.docx +status: active +owner: 内部技术团队 +updated: 2026-05 +--- + +# 角色职责矩阵 + +## 总览 + +| 角色 | 主要负责阶段 | 核心职责 | 典型产出 | +|---|---|---|---| +| 业务主管 | 阶段0、阶段1、阶段4 | 判断项目价值、明确主流程、确认业务完整性、上线验收 | 项目入口分级、主流程说明、业务验收口径、上线验收记录 | +| 业务人员 | 阶段1 | 补充分支流程、提供样本数据、验证真实操作路径 | 分支流程、异常流程、Vibe Coding 页面验证记录 | +| 产品经理 | 阶段2 | 收敛需求、组织高保真模型、明确版本范围 | 高保真模型说明、项目周期与版本确认 | +| 前端 | 阶段2、阶段3 | 深度参与模型收敛、页面结构、按钮行为、组件复用、前端开发 | 高保真模型、前端技术评审、按钮行为矩阵、前端实现 | +| 后端 | 阶段3 | 设计接口、数据库、权限、安全、日志、回滚和服务能力 | 技术实现对接、后端服务、接口和数据库方案 | +| 算法 | 阶段3 | 判断是否需要 AI，设计输入输出、置信度、人工审核和风险控制 | 算法适用性判断、算法输入输出说明、置信度规则 | +| 测试 | 阶段2.5、阶段4 | 提前写测试用例、发现需求漏洞、正式测试、培训材料、上线反馈 | 测试用例初稿、正式测试报告、内部培训手册、上线问题回流 | +| 技术负责人 | 阶段0、阶段5 | 技术分级、风险判断、技术债治理和能力沉淀 | 技术债清单、业务原子能力沉淀清单、组件库与服务复用清单 | + +## 业务主管 + +业务主管保证方向正确、主流程清楚、需求不漏大块。 + +职责： + +- 判断项目是否值得做。 +- 定义主流程。 +- 定义日常操作入口。 +- 明确业务人员每天先看什么页面。 +- 拆分分支流程，指定业务人员补充。 +- 确认异常流程。 +- 确认业务完整性。 +- 参与业务验收。 + +## 业务人员 + +业务人员负责具体分支流程和真实操作细节。 + +职责： + +- 补充分支流程。 +- 提供样本数据，例如 ASIN、订单、评论、用户、表格等真实样本。 +- 使用 Vibe Coding 跑页面，验证是否符合真实操作。 +- 补充异常场景。 + +## 算法 + +算法保证 AI 能力可控、可解释、可人工审核。 + +职责： + +- 判断是否需要 AI，避免为了 AI 而 AI。 +- 设计算法输入，明确模型需要哪些数据。 +- 设计算法输出，明确 AI 返回什么结果。 +- 制定置信度规则。 +- 制定人工审核机制。 +- 设计风险控制，确保 AI 判断错误时可以回退和纠正。 + +## 测试 + +测试不只是最后找 Bug，还要提前补漏，并负责内部培训材料。 + +职责： + +- 高保真模型出来后先写测试用例。 +- 用测试视角发现流程、按钮、权限遗漏。 +- 正式测试主流程、分支流程、权限、异常和数据。 +- 输出验收报告。 +- 将测试用例转成业务操作手册。 +- 记录上线问题并回流需求池。 + +## 关联条目 + +- [[AI驱动内部系统开发流程_V3_总览]] +- [[阶段0_项目入口分级]] +- [[阶段1_业务需求完整形成]] +- [[阶段2.5_测试提前补漏]] +- [[阶段4_测试培训上线回流]] diff --git a/02_项目管理流程/阶段0_项目入口分级.md b/02_项目管理流程/阶段0_项目入口分级.md new file mode 100644 index 0000000..66e6b25 --- /dev/null +++ b/02_项目管理流程/阶段0_项目入口分级.md @@ -0,0 +1,86 @@ +--- +type: process_stage +tags: [项目管理流程, 阶段0, 项目入口, 分级, 立项] +aliases: [项目入口分级, 入口分级, Gate 0, 立项分级] +source: AI_驱动_内部系统开发流程_V3.docx +status: active +owner: 业务主管 / 技术负责人 +updated: 2026-05 +--- + +# 阶段0 项目入口分级 + +## 核心目标 + +不是所有需求都应该进入完整开发流程。阶段0用于判断项目是否值得做，以及走轻流程还是完整流程。 + +## 负责人 + +- 业务主管 +- 技术负责人 + +## 输入 + +- 业务提出的问题或机会。 +- 现有系统痛点。 +- 业务收益、风险、范围的初步判断。 + +## 项目分类 + +| 类型 | 适用场景 | 流程要求 | +|---|---|---| +| S 类 | 小需求，单页面、小改动、无复杂数据 | 可简化阶段1和阶段2。 | +| M 类 | 中等需求，涉及多个页面、多个角色或状态流转 | 建议走完整阶段0-4。 | +| L 类 | 大型需求，涉及核心流程、多个部门、复杂权限、数据模型或算法 | 必须走完整流程，并强化技术预检和阶段门禁。 | + +## 关键动作 + +- 判断需求是否值得做。 +- 判断项目影响范围。 +- 判断是否需要完整流程。 +- 判断是否涉及复杂数据、权限、算法、外部系统或高风险流程。 +- 初步指定业务负责人和技术负责人。 + +## 输出/交付物 + +- `00_项目入口分级.md` +- 项目类型：S / M / L。 +- 是否进入完整流程的结论。 +- 初步负责人。 +- 初步范围和风险。 + +## 检查清单 + +- [ ] 是否确认需求要解决的真实业务问题？ +- [ ] 是否确认该需求值得做？ +- [ ] 是否确认项目类型？ +- [ ] 是否确认走轻流程还是完整流程？ +- [ ] 是否识别复杂权限、数据、算法、并发、安全或外部系统风险？ +- [ ] 是否明确业务主管和技术负责人？ + +## 风险点 + +- 小需求被过度流程化，降低效率。 +- 大需求被当成小需求处理，后续返工。 +- 没有识别权限、数据、安全、算法风险。 +- 没有业务负责人，需求持续漂移。 + +## Gate 0 通过标准 + +项目入口通过：确认值得做，确认项目类型。 + +## 常见问题 + +### 阶段0由谁负责？ + +由业务主管和技术负责人共同负责。业务主管判断业务价值和业务范围，技术负责人判断技术复杂度和风险。 + +### 小需求是否必须走完整流程？ + +不一定。S 类小需求可以简化阶段1和阶段2，但仍应保留基本入口判断、测试和上线验收。 + +## 关联条目 + +- [[AI驱动内部系统开发流程_V3_总览]] +- [[角色职责矩阵]] +- [[阶段交付物清单]] diff --git a/02_项目管理流程/阶段1_业务需求完整形成.md b/02_项目管理流程/阶段1_业务需求完整形成.md new file mode 100644 index 0000000..0de273d --- /dev/null +++ b/02_项目管理流程/阶段1_业务需求完整形成.md @@ -0,0 +1,83 @@ +--- +type: process_stage +tags: [项目管理流程, 阶段1, 业务需求, VibeCoding, 需求完整] +aliases: [业务需求完整形成, 提需求, 需求梳理, Gate 1] +source: AI_驱动_内部系统开发流程_V3.docx +status: active +owner: 业务主管 / 业务人员 +updated: 2026-05 +--- + +# 阶段1 业务需求完整形成 + +## 核心目标 + +业务侧通过 Vibe Coding 跑完整需求。阶段1追求需求完整，不追求产品完善。 + +## 负责人 + +- 业务主管 +- 业务人员 + +## 输入 + +- 阶段0入口分级结论。 +- 业务痛点、业务目标、现有流程。 +- 业务人员真实操作经验。 + +## 关键动作 + +- 梳理主流程。 +- 明确日常操作页面结构。 +- 盘点功能页面和按钮。 +- 补充分支流程。 +- 补充异常流程。 +- 使用 Vibe Coding 生成或验证需求原型。 +- 记录页面验证结果。 + +## 输出/交付物 + +- `01_主流程说明.md` +- `02_日常操作页面结构.md` +- `03_功能页面按钮盘点表.md` +- `04_分支流程_XXX.md` +- `05_异常流程_XXX.md` +- `06_VibeCoding页面验证记录.md` + +## 检查清单 + +- [ ] 主流程是否能从开始走到结束？ +- [ ] 日常操作入口是否清楚？ +- [ ] 页面、按钮、字段是否大致完整？ +- [ ] 分支流程是否由真实业务人员补充？ +- [ ] 异常流程是否覆盖无负责人、超时、数据缺失等情况？ +- [ ] Vibe Coding 原型是否经过业务侧走查？ +- [ ] 是否明确哪些内容只是原型，不可直接进入生产？ + +## 风险点 + +- 只描述主流程，漏掉分支和异常。 +- 把 Vibe Coding 页面当成可生产代码。 +- 业务主管只给方向，没有安排业务人员补充真实操作细节。 +- 页面、按钮、字段未盘点，导致阶段2和开发阶段返工。 + +## Gate 1 通过标准 + +需求完整通过：主流程、分支、页面、按钮、字段、状态大致完整。 + +## 常见问题 + +### 阶段1追求什么？ + +追求需求完整，不追求产品完善。页面可以粗糙，但业务流程、分支、异常、按钮、字段不能漏大块。 + +### Vibe Coding 页面能不能直接上线？ + +不能。Vibe Coding 页面只是需求原型，不直接进入生产。 + +## 关联条目 + +- [[阶段0_项目入口分级]] +- [[阶段2_高保真模型与业务对象确认]] +- [[角色职责矩阵]] +- [[阶段交付物清单]] diff --git a/02_项目管理流程/阶段2.5_测试提前补漏.md b/02_项目管理流程/阶段2.5_测试提前补漏.md new file mode 100644 index 0000000..681e503 --- /dev/null +++ b/02_项目管理流程/阶段2.5_测试提前补漏.md @@ -0,0 +1,79 @@ +--- +type: process_stage +tags: [项目管理流程, 阶段2.5, 测试, 需求补漏, 测试用例] +aliases: [测试提前补漏, 开发前测试, Gate 2.5, 测试用例初稿] +source: AI_驱动_内部系统开发流程_V3.docx +status: active +owner: 测试 +updated: 2026-05 +--- + +# 阶段2.5 测试提前补漏 + +## 核心目标 + +在开发前用测试视角发现需求漏洞。测试提前补漏，不只是上线前找 Bug。 + +## 负责人 + +- 测试 + +## 输入 + +- 高保真模型。 +- 高保真模型说明。 +- 统一业务对象模型。 +- 按钮行为矩阵。 +- 项目周期与版本确认。 + +## 关键动作 + +- 基于高保真模型先写测试用例初稿。 +- 从主流程、分支流程、权限、异常、数据、按钮行为视角检查遗漏。 +- 标记阻塞开发的问题。 +- 将需求漏洞回流给业务、产品、前端补齐。 +- 确认阻塞问题处理后再进入正式开发。 + +## 输出/交付物 + +- `11_测试用例初稿与需求补漏.md` +- 需求补漏记录。 +- 阻塞问题清单。 +- 已关闭问题清单。 + +## 检查清单 + +- [ ] 是否已基于高保真模型编写测试用例初稿？ +- [ ] 是否覆盖主流程？ +- [ ] 是否覆盖分支流程？ +- [ ] 是否覆盖权限？ +- [ ] 是否覆盖异常场景？ +- [ ] 是否覆盖关键数据和状态？ +- [ ] 是否覆盖按钮行为？ +- [ ] 测试发现的阻塞问题是否已关闭？ + +## 风险点 + +- 测试只在上线前介入，导致需求漏洞在开发后才暴露。 +- 测试用例只覆盖主流程，漏掉权限、异常、分支和数据边界。 +- 阻塞问题没有关闭就进入开发。 + +## Gate 2.5 通过标准 + +测试补漏：测试用例初稿发现的阻塞问题已处理。 + +## 常见问题 + +### 阶段2.5应该在什么时候发生？ + +发生在高保真模型确认后、正式开发前。 + +### 阶段2.5要产出什么？ + +主要产出 `11_测试用例初稿与需求补漏.md`，并形成需求补漏记录、阻塞问题清单和已关闭问题清单。 + +## 关联条目 + +- [[阶段2_高保真模型与业务对象确认]] +- [[阶段3_研发协作与正式开发]] +- [[项目检查清单]] diff --git a/02_项目管理流程/阶段2_高保真模型与业务对象确认.md b/02_项目管理流程/阶段2_高保真模型与业务对象确认.md new file mode 100644 index 0000000..a7f473e --- /dev/null +++ b/02_项目管理流程/阶段2_高保真模型与业务对象确认.md @@ -0,0 +1,81 @@ +--- +type: process_stage +tags: [项目管理流程, 阶段2, 高保真模型, 业务对象, 前端, 产品] +aliases: [高保真模型确认, 业务对象确认, Gate 2, 统一业务对象模型] +source: AI_驱动_内部系统开发流程_V3.docx +status: active +owner: 前端 / 产品经理 +updated: 2026-05 +--- + +# 阶段2 高保真模型与业务对象确认 + +## 核心目标 + +把完整但粗糙的需求收敛成可开发模型。阶段2追求模型高效，前端必须深度参与。 + +## 负责人 + +- 前端 +- 产品经理 + +## 输入 + +- 阶段1形成的主流程、页面结构、按钮盘点、分支流程、异常流程和 Vibe Coding 验证记录。 + +## 关键动作 + +- 将业务原型收敛为高保真模型。 +- 明确页面结构、交互、按钮行为和状态变化。 +- 确认业务对象、字段、状态和对象关系。 +- 明确 V1/V2 范围和项目周期。 +- 进行前端技术评审和技术预检。 +- 识别性能、安全、权限、并发、日志、可回滚等风险。 + +## 输出/交付物 + +- `07_高保真模型.html` +- `07_高保真模型说明.md` +- `08_项目周期与版本确认.md` +- `09_前端技术评审.md` +- `10_技术预检记录.md` +- `10A_统一业务对象模型.md` +- `10B_按钮行为矩阵.md` + +## 检查清单 + +- [ ] 页面是否已经从粗糙原型收敛成可开发模型？ +- [ ] 按钮行为是否明确？ +- [ ] 业务对象、字段、状态、对象关系是否明确？ +- [ ] V1/V2 范围是否明确？ +- [ ] 是否完成前端技术评审？ +- [ ] 是否完成性能、安全、权限、并发、日志、可回滚预检？ +- [ ] 是否明确高保真模型确认后才允许正式开发？ + +## 风险点 + +- 前端介入太晚，导致页面、接口、数据库互相倒逼。 +- 高保真模型只画页面，没有确认业务对象和状态。 +- 没有按钮行为矩阵，开发和测试无法对齐。 +- 未提前识别性能、安全、权限、并发、日志、回滚风险。 + +## Gate 2 通过标准 + +高保真模型通过：页面收敛、按钮行为、业务对象、状态、V1/V2 明确。 + +## 常见问题 + +### 什么时候需要前端提前参与？ + +阶段2必须由前端深度参与。若需求涉及多页面、复杂交互、权限、状态流转、数据结构或组件复用，前端应在需求收敛时提前参与。 + +### 统一业务对象模型为什么重要？ + +统一业务对象模型是页面、接口、数据库、测试、AI 提示词的共同基础。 + +## 关联条目 + +- [[阶段1_业务需求完整形成]] +- [[阶段2.5_测试提前补漏]] +- [[../01_业务流程/业务对象字典]] +- [[阶段交付物清单]] diff --git a/02_项目管理流程/阶段3_研发协作与正式开发.md b/02_项目管理流程/阶段3_研发协作与正式开发.md new file mode 100644 index 0000000..5264a03 --- /dev/null +++ b/02_项目管理流程/阶段3_研发协作与正式开发.md @@ -0,0 +1,77 @@ +--- +type: process_stage +tags: [项目管理流程, 阶段3, 研发协作, 正式开发, 代码治理, 安全] +aliases: [研发协作, 正式开发, Gate 3, 开发联调] +source: AI_驱动_内部系统开发流程_V3.docx +status: active +owner: 前端 / 后端 / 算法 +updated: 2026-05 +--- + +# 阶段3 研发协作与正式开发 + +## 核心目标 + +基于高保真模型进行模块化、安全、可维护开发。研发阶段以代码质量、模块化、安全性、可维护性为中心。 + +## 负责人 + +- 前端 +- 后端 +- 算法 + +## 输入 + +- 高保真模型。 +- 统一业务对象模型。 +- 按钮行为矩阵。 +- 测试用例初稿与需求补漏结果。 +- 技术预检记录。 + +## 关键动作 + +- 拆分研发任务与协作计划。 +- 进行前端、后端、算法技术实现对接。 +- 明确接口、数据库、权限、安全、日志和回滚方案。 +- 按代码治理与安全规范开发。 +- 记录开发问题与联调结果。 +- 治理 AI 生成代码，不能直接堆进生产。 + +## 输出/交付物 + +- `12_研发任务拆分与协作计划.md` +- `13_技术实现对接.md` +- `14_代码治理与安全规范.md` +- `15_开发问题与联调记录.md` + +## 检查清单 + +- [ ] 研发任务是否已拆分？ +- [ ] 前后端、数据库、权限、安全、主要流程是否联调完成？ +- [ ] 是否按统一业务对象模型设计接口和数据库？ +- [ ] 是否处理权限、安全、日志、可回滚？ +- [ ] AI 生成代码是否经过人工审查和治理？ +- [ ] 是否避免重复代码和不可维护堆叠？ + +## 风险点 + +- 开发直接从 Vibe Coding 原型开始，跳过高保真模型。 +- AI 生成代码未经治理直接进入生产。 +- 缺少模块边界、权限、安全、日志和回滚方案。 +- 前后端、数据库、测试使用的业务对象不一致。 + +## Gate 3 通过标准 + +开发联调通过：前后端、数据库、权限、安全、主要流程联调完成。 + +## 常见问题 + +### 阶段3如何保证模块化、安全和可维护？ + +依赖统一业务对象模型、研发任务拆分、技术实现对接、代码治理与安全规范、开发问题与联调记录。AI 代码必须经过治理，不能直接堆进生产。 + +## 关联条目 + +- [[阶段2.5_测试提前补漏]] +- [[阶段4_测试培训上线回流]] +- [[阶段交付物清单]] diff --git a/02_项目管理流程/阶段4_测试培训上线回流.md b/02_项目管理流程/阶段4_测试培训上线回流.md new file mode 100644 index 0000000..5edff8b --- /dev/null +++ b/02_项目管理流程/阶段4_测试培训上线回流.md @@ -0,0 +1,77 @@ +--- +type: process_stage +tags: [项目管理流程, 阶段4, 测试, 培训, 上线, 回流] +aliases: [测试培训上线回流, 上线验收, Gate 4] +source: AI_驱动_内部系统开发流程_V3.docx +status: active +owner: 测试 / 业务主管 +updated: 2026-05 +--- + +# 阶段4 测试培训上线回流 + +## 核心目标 + +完成测试、培训、上线验收和问题回流。测试保证系统真实可用，并帮助业务人员正确使用。 + +## 负责人 + +- 测试 +- 业务主管 + +## 输入 + +- 开发联调完成的系统。 +- 测试用例。 +- 高保真模型和业务对象模型。 +- 开发问题与联调记录。 + +## 关键动作 + +- 进行正式测试。 +- 验证主流程、分支流程、权限、异常和数据。 +- 输出正式测试报告。 +- 将测试用例转成业务操作手册或内部培训材料。 +- 组织业务确认和上线验收。 +- 记录上线问题并回流需求池。 + +## 输出/交付物 + +- `16_正式测试报告.md` +- `17_内部培训手册.md` +- `18_上线验收记录.md` +- `19_上线问题与回流需求.md` + +## 检查清单 + +- [ ] 正式测试是否通过？ +- [ ] 主流程是否验证通过？ +- [ ] 分支流程是否验证通过？ +- [ ] 权限是否验证通过？ +- [ ] 异常和数据边界是否验证通过？ +- [ ] 内部培训手册是否完成？ +- [ ] 业务主管是否完成上线确认？ +- [ ] 上线问题是否记录并回流？ + +## 风险点 + +- 只测功能，不测权限、异常、数据和实际操作路径。 +- 没有培训材料，业务人员不会用。 +- 上线问题没有进入回流需求池。 +- 业务主管未验收就上线。 + +## Gate 4 通过标准 + +上线验收通过：测试通过、业务确认、培训完成。 + +## 常见问题 + +### 上线前需要检查哪些事项？ + +至少检查正式测试、主流程、分支流程、权限、异常、数据边界、内部培训手册、业务确认、上线问题回流机制。 + +## 关联条目 + +- [[阶段3_研发协作与正式开发]] +- [[项目检查清单]] +- [[阶段交付物清单]] diff --git a/02_项目管理流程/阶段交付物清单.md b/02_项目管理流程/阶段交付物清单.md new file mode 100644 index 0000000..a03dc3b --- /dev/null +++ b/02_项目管理流程/阶段交付物清单.md @@ -0,0 +1,42 @@ +--- +type: deliverable_index +tags: [项目管理流程, 交付物, 文件清单] +aliases: [交付物清单, 文件结构, 产出物] +source: AI_驱动_内部系统开发流程_V3.docx +status: active +owner: 内部技术团队 +updated: 2026-05 +--- + +# 阶段交付物清单 + +## 完整版交付物 + +| 阶段 | 交付物 | +|---|---| +| 阶段0 | `00_项目入口分级.md` | +| 阶段1 | `01_主流程说明.md`、`02_日常操作页面结构.md`、`03_功能页面按钮盘点表.md`、`04_分支流程_XXX.md`、`05_异常流程_XXX.md`、`06_VibeCoding页面验证记录.md` | +| 阶段2 | `07_高保真模型.html`、`07_高保真模型说明.md`、`08_项目周期与版本确认.md`、`09_前端技术评审.md`、`10_技术预检记录.md`、`10A_统一业务对象模型.md`、`10B_按钮行为矩阵.md` | +| 阶段2.5 | `11_测试用例初稿与需求补漏.md` | +| 阶段3 | `12_研发任务拆分与协作计划.md`、`13_技术实现对接.md`、`14_代码治理与安全规范.md`、`15_开发问题与联调记录.md` | +| 阶段4 | `16_正式测试报告.md`、`17_内部培训手册.md`、`18_上线验收记录.md`、`19_上线问题与回流需求.md` | +| 阶段5 | `20_技术债清单.md`、`21_业务原子能力沉淀清单.md`、`22_组件库与服务复用清单.md`、`23_AI开发上下文模板更新记录.md` | + +## 轻量版交付物 + +| 阶段包 | 交付物 | +|---|---| +| 入口 | `00_项目入口分级.md` | +| 需求 | `01_业务需求包.md` | +| 模型 | `02_高保真模型包.md` | +| 预检 | `03_项目版本与技术预检.md` | +| 测试补漏 | `04_测试用例初稿与需求补漏.md` | +| 研发 | `05_研发协作与技术实现包.md` | +| 治理 | `06_代码治理与安全规范.md` | +| 上线 | `07_测试培训上线包.md` | +| 沉淀 | `08_技术债与能力沉淀包.md` | + +## 关联条目 + +- [[AI驱动内部系统开发流程_V3_总览]] +- [[项目检查清单]] diff --git a/02_项目管理流程/项目检查清单.md b/02_项目管理流程/项目检查清单.md new file mode 100644 index 0000000..33cab9d --- /dev/null +++ b/02_项目管理流程/项目检查清单.md @@ -0,0 +1,70 @@ +--- +type: checklist +tags: [项目管理流程, 检查清单, 门禁] +aliases: [项目门禁检查, 上线检查, 流程检查] +source: AI_驱动_内部系统开发流程_V3.docx +status: active +owner: 内部技术团队 +updated: 2026-05 +--- + +# 项目检查清单 + +## Gate 0 项目入口 + +- [ ] 确认项目值得做。 +- [ ] 确认项目类型：S / M / L。 +- [ ] 确认走轻流程还是完整流程。 +- [ ] 确认业务主管和技术负责人。 + +## Gate 1 需求完整 + +- [ ] 主流程完整。 +- [ ] 分支流程完整。 +- [ ] 页面、按钮、字段大致完整。 +- [ ] 状态大致完整。 +- [ ] Vibe Coding 页面已验证。 + +## Gate 2 高保真模型 + +- [ ] 页面已经收敛。 +- [ ] 按钮行为明确。 +- [ ] 业务对象明确。 +- [ ] 状态明确。 +- [ ] V1/V2 明确。 +- [ ] 性能、安全、权限、并发、日志、可回滚已预检。 + +## Gate 2.5 测试补漏 + +- [ ] 测试用例初稿已完成。 +- [ ] 主流程、分支、权限、异常、数据、按钮行为已检查。 +- [ ] 阻塞开发的问题已处理。 + +## Gate 3 开发联调 + +- [ ] 前后端联调完成。 +- [ ] 数据库联调完成。 +- [ ] 权限和安全联调完成。 +- [ ] 主要流程联调完成。 +- [ ] AI 代码已治理。 + +## Gate 4 上线验收 + +- [ ] 正式测试通过。 +- [ ] 业务确认完成。 +- [ ] 培训完成。 +- [ ] 上线问题回流机制明确。 + +## Gate 5 技术债治理 + +- [ ] 技术债已分类。 +- [ ] 必须立即处理的已处理。 +- [ ] 可延后的进入技术债池。 +- [ ] 可复用组件已沉淀。 +- [ ] 可复用后端服务已沉淀。 +- [ ] AI 开发上下文模板已更新。 + +## 关联条目 + +- [[AI驱动内部系统开发流程_V3_总览]] +- [[阶段交付物清单]] diff --git a/03_规范与模板/上线检查模板.md b/03_规范与模板/上线检查模板.md new file mode 100644 index 0000000..48059a7 --- /dev/null +++ b/03_规范与模板/上线检查模板.md @@ -0,0 +1,41 @@ +--- +type: template +tags: [模板, 上线检查] +aliases: [上线模板, 验收模板] +source: manual +status: active +owner: 测试 / 业务主管 +updated: 2026-05 +--- + +# 上线检查模板 + +## 基本信息 + +- 项目名称： +- 上线版本： +- 上线时间： +- 负责人： + +## 上线前检查 + +- [ ] 正式测试通过。 +- [ ] 主流程通过。 +- [ ] 分支流程通过。 +- [ ] 权限通过。 +- [ ] 异常和数据边界通过。 +- [ ] 培训材料完成。 +- [ ] 业务主管确认。 +- [ ] 回滚方案明确。 + +## 上线验收 + +| 验收项 | 验收人 | 结果 | 备注 | +|---|---|---|---| +| | | | | + +## 上线问题回流 + +| 问题 | 影响 | 处理优先级 | 负责人 | 状态 | +|---|---|---|---|---| +| | | | | | diff --git a/03_规范与模板/业务流程梳理模板.md b/03_规范与模板/业务流程梳理模板.md new file mode 100644 index 0000000..a85711f --- /dev/null +++ b/03_规范与模板/业务流程梳理模板.md @@ -0,0 +1,15 @@ +--- +type: template +tags: [模板, 业务流程] +aliases: [流程梳理模板] +source: manual +status: active +owner: 业务主管 +updated: 2026-05 +--- + +# 业务流程梳理模板 + +见 [[../01_业务流程/业务流程模板]]。 + +使用时复制该模板，并按真实业务流程命名保存到 `01_业务流程/` 下。 diff --git a/03_规范与模板/业务规则与需求补充模板.md b/03_规范与模板/业务规则与需求补充模板.md new file mode 100644 index 0000000..1502bda --- /dev/null +++ b/03_规范与模板/业务规则与需求补充模板.md @@ -0,0 +1,115 @@ +--- +type: template +tags: [模板, 业务规则, 需求补充, Agent检索] +aliases: [业务补充模板, 规则补充模板, 需求增量模板] +source: manual +status: active +owner: 业务主管 / 产品经理 +updated: 2026-05 +--- + +# 业务规则与需求补充模板 + +> 使用方式：每次新增或修订业务规则时，复制本模板到 `01_业务流程/` 下，并按 `业务域_规则或需求名称_YYYYMMDD.md` 命名。 + +## 1. 基本信息 + +| 字段 | 内容 | +|---|---| +| 业务域 | | +| 规则/需求名称 | | +| 提出人 | | +| 负责部门 | | +| 适用角色 | | +| 关联系统 | | +| 版本 | v1.0 | +| 生效状态 | draft / active / deprecated | +| 生效时间 | | +| 最近更新时间 | | + +## 2. 背景与目标 + +- 当前问题： +- 业务目标： +- 不解决的问题： + +## 3. 适用范围 + +- 适用场景： +- 不适用场景： +- 前置条件： + +## 4. 业务规则 + +| 编号 | 规则描述 | 触发条件 | 处理结果 | 优先级 | 例外情况 | +|---|---|---|---|---|---| +| BR-001 | | | | 高/中/低 | | + +## 5. 业务流程 + +### 5.1 主流程 + +1. +2. +3. + +### 5.2 分支流程 + +| 分支场景 | 判断条件 | 处理方式 | 输出结果 | +|---|---|---|---| +| | | | | + +### 5.3 异常处理 + +| 异常场景 | 识别方式 | 处理方式 | 负责人 | +|---|---|---|---| +| | | | | + +## 6. 数据与业务对象 + +| 业务对象 | 字段 | 字段含义 | 必填 | 来源 | 去向 | +|---|---|---|---|---|---| +| | | | 是/否 | | | + +## 7. 权限与操作 + +| 角色 | 可见范围 | 可执行操作 | 禁止操作 | +|---|---|---|---| +| | | | | + +## 8. 验收口径 + +| 验收点 | 通过标准 | 测试问题 | +|---|---|---| +| | | | + +## 9. Agent 检索字段 + +### 9.1 推荐关键词 + +- + +### 9.2 同义词/口语问法 + +| 用户可能问法 | 标准术语 | 推荐命中文件 | +|---|---|---| +| | | | + +### 9.3 标准问答 + +| 问题 | 期望答案要点 | 来源章节 | +|---|---|---| +| | | | + +## 10. 关联条目 + +- 关联业务流程： +- 关联项目管理阶段： +- 关联需求说明： +- 关联测试用例： + +## 11. 变更记录 + +| 日期 | 版本 | 变更内容 | 变更人 | +|---|---|---|---| +| | v1.0 | 新增 | | diff --git a/03_规范与模板/会议纪要模板.md b/03_规范与模板/会议纪要模板.md new file mode 100644 index 0000000..7f7d796 --- /dev/null +++ b/03_规范与模板/会议纪要模板.md @@ -0,0 +1,36 @@ +--- +type: template +tags: [模板, 会议纪要] +aliases: [会议记录模板] +source: manual +status: active +owner: 内部技术团队 +updated: 2026-05 +--- + +# 会议纪要模板 + +## 基本信息 + +- 会议主题： +- 时间： +- 参会人： +- 记录人： + +## 结论 + +| 编号 | 结论 | 负责人 | 截止时间 | +|---|---|---|---| +| | | | | + +## 待办 + +| 事项 | 负责人 | 截止时间 | 状态 | +|---|---|---|---| +| | | | | + +## 风险与问题 + +| 问题 | 影响 | 处理方式 | +|---|---|---| +| | | | diff --git a/03_规范与模板/需求说明模板.md b/03_规范与模板/需求说明模板.md new file mode 100644 index 0000000..016ef06 --- /dev/null +++ b/03_规范与模板/需求说明模板.md @@ -0,0 +1,52 @@ +--- +type: template +tags: [模板, 需求说明] +aliases: [需求模板, 业务需求包] +source: manual +status: active +owner: 产品经理 / 业务主管 +updated: 2026-05 +--- + +# 需求说明模板 + +## 背景与目标 + +- 背景： +- 要解决的问题： +- 目标用户： +- 预期收益： + +## 范围 + +- V1 范围： +- V2 范围： +- 不包含范围： + +## 主流程 + +1. +2. +3. + +## 页面与按钮 + +| 页面 | 按钮/操作 | 行为说明 | 权限 | 备注 | +|---|---|---|---|---| +| | | | | | + +## 业务对象 + +| 对象 | 字段 | 状态 | 说明 | +|---|---|---|---| +| | | | | + +## 分支与异常 + +| 场景 | 处理方式 | 负责人 | +|---|---|---| +| | | | + +## 验收口径 + +- diff --git a/04_Agent检索/关键词索引.md b/04_Agent检索/关键词索引.md new file mode 100644 index 0000000..d0a6150 --- /dev/null +++ b/04_Agent检索/关键词索引.md @@ -0,0 +1,41 @@ +--- +type: keyword_index +tags: [Agent, 关键词, 索引] +aliases: [关键词映射] +source: manual +status: active +owner: 内部技术团队 +updated: 2026-05 +--- + +# 关键词索引 + +| 关键词 | 推荐检索文件 | +|---|---| +| 内部系统开发流程 | `02_项目管理流程/AI驱动内部系统开发流程_V3_总览.md` | +| ERP 开发流程 | `02_项目管理流程/AI驱动内部系统开发流程_V3_总览.md` | +| 项目入口 | `02_项目管理流程/阶段0_项目入口分级.md` | +| 项目分级 | `02_项目管理流程/阶段0_项目入口分级.md` | +| S 类 / M 类 / L 类 | `02_项目管理流程/阶段0_项目入口分级.md` | +| 业务需求 | `02_项目管理流程/阶段1_业务需求完整形成.md` | +| Vibe Coding | `02_项目管理流程/阶段1_业务需求完整形成.md` | +| 高保真模型 | `02_项目管理流程/阶段2_高保真模型与业务对象确认.md` | +| 业务对象 | `02_项目管理流程/阶段2_高保真模型与业务对象确认.md`、`01_业务流程/业务对象字典.md` | +| 按钮行为 | `02_项目管理流程/阶段2_高保真模型与业务对象确认.md` | +| 测试提前补漏 | `02_项目管理流程/阶段2.5_测试提前补漏.md` | +| 测试用例初稿 | `02_项目管理流程/阶段2.5_测试提前补漏.md` | +| 正式开发 | `02_项目管理流程/阶段3_研发协作与正式开发.md` | +| 研发协作 | `02_项目管理流程/阶段3_研发协作与正式开发.md` | +| 代码治理 | `02_项目管理流程/阶段3_研发协作与正式开发.md`、`02_项目管理流程/AI驱动内部系统开发流程_V3_总览.md` | +| 上线验收 | `02_项目管理流程/阶段4_测试培训上线回流.md` | +| 内部培训 | `02_项目管理流程/阶段4_测试培训上线回流.md` | +| 问题回流 | `02_项目管理流程/阶段4_测试培训上线回流.md` | +| 技术债 | `02_项目管理流程/AI驱动内部系统开发流程_V3_总览.md`、`02_项目管理流程/项目检查清单.md` | +| 门禁 | `02_项目管理流程/项目检查清单.md` | +| 交付物 | `02_项目管理流程/阶段交付物清单.md` | +| 谁负责 | `02_项目管理流程/角色职责矩阵.md` | +| 业务规则补充 | `03_规范与模板/业务规则与需求补充模板.md`、`04_Agent检索/知识库持续更新与验证流程.md` | +| 需求补充 | `03_规范与模板/业务规则与需求补充模板.md`、`03_规范与模板/需求说明模板.md` | +| 新增业务流程 | `03_规范与模板/业务规则与需求补充模板.md`、`03_规范与模板/业务流程梳理模板.md` | +| 检索验证 | `04_Agent检索/知识库持续更新与验证流程.md`、`01_业务流程/业务补充验证记录.md` | +| Agent 问答验证 | `04_Agent检索/知识库持续更新与验证流程.md`、`01_业务流程/业务补充验证记录.md` | diff --git a/04_Agent检索/同义词表.md b/04_Agent检索/同义词表.md new file mode 100644 index 0000000..619b644 --- /dev/null +++ b/04_Agent检索/同义词表.md @@ -0,0 +1,31 @@ +--- +type: synonym_table +tags: [Agent, 同义词, 检索] +aliases: [口语映射, 术语映射] +source: manual +status: active +owner: 内部技术团队 +updated: 2026-05 +--- + +# 同义词表 + +| 用户说法 | 标准术语 | 推荐检索文件 | +|---|---|---| +| 提需求 | 业务需求完整形成 / 项目入口分级 | `阶段1_业务需求完整形成.md`、`阶段0_项目入口分级.md` | +| 立项 | 项目入口分级 | `阶段0_项目入口分级.md` | +| 原型 | Vibe Coding 页面 / 高保真模型 | `阶段1_业务需求完整形成.md`、`阶段2_高保真模型与业务对象确认.md` | +| 页面模型 | 高保真模型 | `阶段2_高保真模型与业务对象确认.md` | +| 字段字典 | 业务对象模型 | `阶段2_高保真模型与业务对象确认.md`、`业务对象字典.md` | +| 开发前测试 | 测试提前补漏 | `阶段2.5_测试提前补漏.md` | +| 测试先看 | 测试提前补漏 | `阶段2.5_测试提前补漏.md` | +| 开发怎么开始 | 研发协作与正式开发 | `阶段3_研发协作与正式开发.md` | +| 上线前要做什么 | 测试培训上线回流 / Gate 4 | `阶段4_测试培训上线回流.md`、`项目检查清单.md` | +| 谁来做 | 角色职责 | `角色职责矩阵.md` | +| 要交什么 | 阶段交付物 | `阶段交付物清单.md` | +| 检查点 | 阶段门禁 / 项目检查清单 | `项目检查清单.md` | +| AI 写的代码 | AI 代码治理 | `阶段3_研发协作与正式开发.md` | +| 加一条业务规则 | 业务规则补充 | `业务规则与需求补充模板.md`、`知识库持续更新与验证流程.md` | +| 补需求 | 需求补充 | `业务规则与需求补充模板.md`、`需求说明模板.md` | +| 新规则怎么写 | 业务规则与需求补充 | `业务规则与需求补充模板.md` | +| 怎么验证能不能搜到 | Agent 检索验证 | `知识库持续更新与验证流程.md`、`业务补充验证记录.md` | diff --git a/04_Agent检索/来源文件索引.md b/04_Agent检索/来源文件索引.md new file mode 100644 index 0000000..86e9da9 --- /dev/null +++ b/04_Agent检索/来源文件索引.md @@ -0,0 +1,56 @@ +--- +type: source_index +tags: [来源, 索引, Agent] +aliases: [来源索引, 原始文件] +source: manual +status: active +owner: 内部技术团队 +updated: 2026-05 +--- + +# 来源文件索引 + +## 原始来源 + +| 来源文件 | 路径 | 用途 | 状态 | +|---|---|---|---| +| AI_驱动_内部系统开发流程_V3.docx | `D:\\AIcoding\\WishFulfilled\\知识库\\AI_驱动_内部系统开发流程_V3.docx` | 项目管理流程权威来源 | active | + +## 拆解后的知识条目 + +| 条目 | 来源 | +|---|---| +| `02_项目管理流程/AI驱动内部系统开发流程_V3_总览.md` | AI_驱动_内部系统开发流程_V3.docx | +| `02_项目管理流程/阶段0_项目入口分级.md` | AI_驱动_内部系统开发流程_V3.docx | +| `02_项目管理流程/阶段1_业务需求完整形成.md` | AI_驱动_内部系统开发流程_V3.docx | +| `02_项目管理流程/阶段2_高保真模型与业务对象确认.md` | AI_驱动_内部系统开发流程_V3.docx | +| `02_项目管理流程/阶段2.5_测试提前补漏.md` | AI_驱动_内部系统开发流程_V3.docx | +| `02_项目管理流程/阶段3_研发协作与正式开发.md` | AI_驱动_内部系统开发流程_V3.docx | +| `02_项目管理流程/阶段4_测试培训上线回流.md` | AI_驱动_内部系统开发流程_V3.docx | +| `02_项目管理流程/角色职责矩阵.md` | AI_驱动_内部系统开发流程_V3.docx | +| `02_项目管理流程/阶段交付物清单.md` | AI_驱动_内部系统开发流程_V3.docx | +| `02_项目管理流程/项目检查清单.md` | AI_驱动_内部系统开发流程_V3.docx | +| `02_项目管理流程/常见问题FAQ.md` | AI_驱动_内部系统开发流程_V3.docx | + +## 业务补充来源 + +| 来源文件 | 路径 | 用途 | 状态 | +|---|---|---|---| +| 需求文档目录 | `05_需求文档/` | 持续存放新增业务需求、业务规则和需求变更文档 | active | +| 需求文档索引.md | `05_需求文档/需求文档索引.md` | 登记新增需求文档及 Agent 检索验证状态 | active | +| 业务规则与需求补充模板.md | `03_规范与模板/业务规则与需求补充模板.md` | 新增业务规则、需求、流程的标准模板 | active | +| 知识库持续更新与验证流程.md | `04_Agent检索/知识库持续更新与验证流程.md` | 规范新增文档后的索引同步和 Agent 检索验证 | active | +| 业务补充验证记录.md | `01_业务流程/业务补充验证记录.md` | 记录新增业务文档是否能被 Agent 检索并回答 | active | +| 里程碑目录 | `06_里程碑/` | 存放里程碑计划、阶段评审和项目节点材料 | active | +| 技术文档目录 | `07_技术文档/` | 存放架构、接口、数据模型、实现方案和技术决策 | active | +| 测试相关目录 | `08_测试相关/` | 存放测试计划、测试用例、缺陷、验收和上线检查材料 | active | + +## 维护要求 + +- 从原始 docx 更新流程时，需要同步更新阶段文件、角色职责矩阵、交付物清单、检查清单、FAQ、关键词索引和同义词表。 +- 新增业务规则、需求或流程文档时，原始需求文档统一放入 `05_需求文档/`，并同步更新需求文档索引、业务规则索引、业务对象字典、关键词索引、同义词表和本来源文件索引。 +- 新增里程碑材料统一放入 `06_里程碑/`，并同步更新里程碑索引。 +- 新增技术材料统一放入 `07_技术文档/`，并同步更新技术文档索引。 +- 新增测试材料统一放入 `08_测试相关/`，并同步更新测试用例索引或对应测试记录。 +- Agent 回答项目管理流程问题时，应优先引用拆解后的 Markdown 文件。 +- Agent 回答具体业务规则和需求问题时，应优先引用 `05_需求文档/` 下的正式需求文档；稳定流程可再引用 `01_业务流程/` 下的业务流程条目。 diff --git a/04_Agent检索/检索说明.md b/04_Agent检索/检索说明.md new file mode 100644 index 0000000..b1ce099 --- /dev/null +++ b/04_Agent检索/检索说明.md @@ -0,0 +1,68 @@ +--- +type: agent_retrieval_guide +tags: [Agent, 检索, 规则] +aliases: [Agent检索说明, 检索规则] +source: manual +status: active +owner: 内部技术团队 +updated: 2026-05 +--- + +# Agent 检索说明 + +## 目标 + +让 Agent 在回答业务流程和项目管理流程问题时，优先基于本地 Markdown 知识库检索，而不是凭空回答。 + +## 检索优先级 + +1. `05_需求文档/`：持续新增的业务需求、业务规则、需求变更和补充说明。 +2. `06_里程碑/`：项目节点、阶段计划、阶段评审和上线节奏。 +3. `07_技术文档/`：系统架构、数据模型、接口说明、实现方案和技术决策。 +4. `08_测试相关/`：测试计划、测试用例、缺陷记录、验收记录和上线检查。 +5. `02_项目管理流程/`：内部系统开发流程、阶段、角色、门禁、交付物、检查清单。 +6. `01_业务流程/`：真实业务流程、业务对象、业务规则。 +7. `04_Agent检索/`：关键词、同义词、来源索引、回答规则。 +8. `03_规范与模板/`：需要产出模板或文档时使用。 + +## 问题类型与命中文件 + +| 问题类型 | 优先文件 | +|---|---| +| 流程阶段 | `AI驱动内部系统开发流程_V3_总览.md`、各阶段文件 | +| 角色职责 | `角色职责矩阵.md` | +| 交付物 | `阶段交付物清单.md` | +| 门禁/检查 | `项目检查清单.md` | +| 常见问答 | `常见问题FAQ.md` | +| 业务对象 | `01_业务流程/业务对象字典.md`、`阶段2_高保真模型与业务对象确认.md` | +| 业务规则 | `05_需求文档/`、`05_需求文档/需求文档索引.md`、`01_业务流程/业务规则索引.md` | +| 业务需求 | `05_需求文档/`、`05_需求文档/需求文档索引.md` | +| 项目里程碑 | `06_里程碑/`、`06_里程碑/里程碑索引.md` | +| 技术实现 | `07_技术文档/`、`07_技术文档/技术文档索引.md` | +| 接口/数据模型 | `07_技术文档/接口说明模板.md`、具体接口文档、具体数据模型文档 | +| 测试用例 | `08_测试相关/`、`08_测试相关/测试用例索引.md` | +| 缺陷/验收/上线检查 | `08_测试相关/缺陷记录模板.md`、`08_测试相关/验收记录模板.md`、`08_测试相关/上线检查模板.md` | + +## 回答规则 + +- 先回答结论，再展开依据。 +- 流程问题按“阶段、负责人、输入、动作、输出、检查点”组织。 +- 角色问题按“负责阶段、核心职责、典型产出”组织。 +- 交付物问题列出文件名。 +- 业务规则和需求问题优先检索 `05_需求文档/` 下的正式需求文档，再检索 `05_需求文档/需求文档索引.md`、`01_业务流程/业务规则索引.md`、`关键词索引.md` 和 `同义词表.md`。 +- 里程碑问题优先检索 `06_里程碑/` 和 `06_里程碑/里程碑索引.md`。 +- 技术问题优先检索 `07_技术文档/` 和 `07_技术文档/技术文档索引.md`。 +- 测试问题优先检索 `08_测试相关/` 和 `08_测试相关/测试用例索引.md`。 +- 必须注明来源文件名。 +- 如果知识库未明确记录，不要推测，应回答“知识库未明确记录”，并建议补充到具体文件。 + +## 持续更新验证 + +新增业务规则、需求或流程文档后，按 [[知识库持续更新与验证流程]] 执行验证。 +新增文档应使用 `03_规范与模板/业务规则与需求补充模板.md`，正式需求文档保存到 `05_需求文档/`，验证结果记录到 `05_需求文档/需求文档索引.md` 和 `01_业务流程/业务补充验证记录.md`。 + +## 引用格式 + +建议在回答末尾使用： + +> 来源：`02_项目管理流程/阶段2.5_测试提前补漏.md` diff --git a/04_Agent检索/知识库持续更新与验证流程.md b/04_Agent检索/知识库持续更新与验证流程.md new file mode 100644 index 0000000..af14e97 --- /dev/null +++ b/04_Agent检索/知识库持续更新与验证流程.md @@ -0,0 +1,162 @@ +--- +type: validation_process +tags: [Agent, 检索, 知识库更新, 验证流程] +aliases: [知识库更新验证, Agent检索验证, 补充文档验证流程] +source: manual +status: active +owner: 内部技术团队 / 产品经理 +updated: 2026-05 +--- + +# 知识库持续更新与验证流程 + +## 1. 目标 + +确保业务规则、业务需求和流程补充后，Agent 能通过文件检索命中新内容，并基于知识库给出可追溯回答。 + +## 2. 更新入口 + +业务新增或修订时，优先使用： + +- `03_规范与模板/业务规则与需求补充模板.md` +- `03_规范与模板/需求说明模板.md` +- `03_规范与模板/业务流程梳理模板.md` + +补充后的正式需求文档统一保存到： + +- `05_需求文档/` + +如果文档已经沉淀为稳定业务流程，再同步拆解或引用到： + +- `01_业务流程/` + +推荐命名： + +```text +业务域_规则或需求名称_YYYYMMDD.md +``` + +示例： + +```text +采购_供应商准入规则_20260526.md +库存_出入库审批规则_20260526.md +销售_客户授信额度规则_20260526.md +``` + +## 3. 标准更新流程 + +### 步骤 1：新增补充文档 + +1. 复制 `业务规则与需求补充模板.md`。 +2. 保存到 `05_需求文档/`。 +3. 补全 Frontmatter：`type`、`tags`、`aliases`、`source`、`status`、`owner`、`updated`。 +4. 补全正文中的业务规则、流程、异常、权限、验收口径和 Agent 检索字段。 + +### 步骤 2：更新索引 + +新增业务文档后，同步更新： + +| 文件 | 更新内容 | +|---|---| +| `05_需求文档/需求文档索引.md` | 增加需求/规则名称、业务域、来源文件、状态和验证状态 | +| `01_业务流程/业务规则索引.md` | 增加规则名称、业务域、适用场景、来源文件 | +| `01_业务流程/业务对象字典.md` | 增加新增或变更的业务对象、字段、状态 | +| `04_Agent检索/关键词索引.md` | 增加关键词到新文件的映射 | +| `04_Agent检索/同义词表.md` | 增加口语问法与标准术语映射 | +| `04_Agent检索/来源文件索引.md` | 登记新增知识条目来源 | + +### 步骤 3：执行文件级检查 + +检查项： + +- 文件是否位于 `05_需求文档/`。 +- 文件名是否包含业务域、规则/需求名称、日期。 +- Frontmatter 是否完整。 +- 是否包含 `业务规则`、`业务流程`、`验收口径`、`Agent 检索字段`。 +- 索引文件是否已同步更新。 + +### 步骤 4：执行关键词检索验证 + +用新增文档中的关键词、别名、口语问法进行检索。 + +验证标准： + +- 至少 1 个正式关键词能命中新文档。 +- 至少 1 个口语问法能通过 `同义词表.md` 或 `关键词索引.md` 定位到新文档。 +- 检索结果能定位到具体文件，而不是只命中模板。 + +### 步骤 5：执行 Agent 问答验证 + +每次新增文档至少准备 3 类问题： + +| 类型 | 示例 | 通过标准 | +|---|---|---| +| 规则类 | `供应商准入有什么条件？` | 能回答规则条件、触发条件、处理结果 | +| 流程类 | `供应商准入流程怎么走？` | 能按步骤回答主流程和分支流程 | +| 异常类 | `供应商资料不完整怎么办？` | 能回答异常处理方式和负责人 | + +Agent 回答必须满足： + +1. 结论来自新增文档或已索引文件。 +2. 回答末尾注明来源文件名。 +3. 如果文档未记录，明确回答“知识库未明确记录”。 +4. 不得凭经验补充没有来源的业务规则。 + +### 步骤 6：记录验证结果 + +在新增业务文档末尾的 `变更记录` 或单独验证记录中记录： + +| 日期 | 验证问题 | 是否命中 | 来源文件 | 结果 | 待补充 | +|---|---|---|---|---|---| +| | | 是/否 | | 通过/失败 | | + +## 4. 验证用例模板 + +复制以下内容到新增业务文档的 `Agent 检索字段` 或验证记录中： + +```markdown +## Agent 检索验证 + +| 编号 | 用户问题 | 期望命中文件 | 期望答案要点 | 实际结果 | 状态 | +|---|---|---|---|---|---| +| Q1 | | | | | 未验证 | +| Q2 | | | | | 未验证 | +| Q3 | | | | | 未验证 | +``` + +## 5. 通过/失败判定 + +### 通过 + +- 新文档能被关键词检索到。 +- Agent 能引用新文档回答至少 3 个验证问题。 +- 回答没有明显幻觉。 +- 来源文件引用正确。 + +### 失败 + +出现任一情况视为失败： + +- 新文档只保存了，但没有更新关键词索引或同义词表。 +- Agent 命中了旧文件，未命中新文档。 +- Agent 回答没有引用来源。 +- Agent 编造了文档中不存在的业务规则。 +- 问题能检索到模板，但不能检索到正式业务文档。 + +失败后处理： + +1. 补充 `aliases`、`tags`、推荐关键词和同义词。 +2. 更新 `关键词索引.md` 和 `同义词表.md`。 +3. 将标准问答补充到新增文档的 `Agent 检索字段`。 +4. 重新执行验证。 + +## 6. Agent 验证提示词 + +```text +请只基于 D:\AIcoding\WishFulfilled\知识库\如愿知识库 下的 Markdown 文件回答。 +优先检索 05_需求文档、01_业务流程、02_项目管理流程、04_Agent检索。 +如果知识库没有明确记录，请回答“知识库未明确记录”，并说明建议补充到哪个文件。 +回答末尾必须列出来源文件。 +现在验证问题是：{用户问题} +``` diff --git a/04_Agent检索/问答提示词.md b/04_Agent检索/问答提示词.md new file mode 100644 index 0000000..e9e29e7 --- /dev/null +++ b/04_Agent检索/问答提示词.md @@ -0,0 +1,48 @@ +--- +type: agent_prompt +tags: [Agent, 提示词, 问答] +aliases: [Agent提示词, 知识库问答Prompt] +source: manual +status: active +owner: 内部技术团队 +updated: 2026-05 +--- + +# 问答提示词 + +## 系统提示词 + +你是如愿内部知识库问答 Agent。你必须优先检索本地 Markdown 知识库，再回答业务流程、项目管理流程、角色职责、交付物、检查清单和模板相关问题。 + +回答要求： + +1. 不要凭空编造知识库未记录的信息。 +2. 优先检索 `02_项目管理流程` 和 `01_业务流程`。 +3. 流程类问题按阶段、负责人、输入、关键动作、输出、检查点回答。 +4. 角色类问题优先检索 `角色职责矩阵.md`。 +5. 交付物类问题优先检索 `阶段交付物清单.md`。 +6. 门禁和检查类问题优先检索 `项目检查清单.md`。 +7. 每次回答末尾必须注明来源文件。 +8. 如果没有明确答案，回答“知识库未明确记录”，并说明建议补充到哪个文件。 + +## 用户问题改写规则 + +- “提需求”可映射为“项目入口分级”或“业务需求完整形成”。 +- “开发前测试”可映射为“阶段2.5 测试提前补漏”。 +- “原型”可映射为“Vibe Coding 页面”或“高保真模型”，需结合上下文区分。 +- “上线前检查”可映射为“Gate 4 上线验收”和“项目检查清单”。 +- “谁负责”优先查角色职责矩阵。 + +## 标准回答模板 + +结论： + +要点： + +1. 阶段/角色： +2. 输入： +3. 关键动作： +4. 输出： +5. 检查点： + +来源： diff --git a/05_需求文档/20260517_USER评价业务闭环_第三步_数据流与中间对象设计_v3.md b/05_需求文档/20260517_USER评价业务闭环_第三步_数据流与中间对象设计_v3.md new file mode 100644 index 0000000..436f43c --- /dev/null +++ b/05_需求文档/20260517_USER评价业务闭环_第三步_数据流与中间对象设计_v3.md @@ -0,0 +1,1030 @@ +# USER 评价业务闭环 — 第三步：数据流与中间对象设计 v3 + +## 文件信息 + +- 文件名称：`20260517_USER评价业务闭环_第三步_数据流与中间对象设计_v3.md` +- 项目路径：`C:\XCODE\USER` +- 当前版本：`v3` +- 最近更新：`2026-05-17` +- 上游文档： + - [工作基线 v1.2](20260517_USER评价业务闭环主流程与后续工作基线_v1.2.md) — 业务规则与额度口径 + - [共用能力图与渠道专属流程 v2.2](20260517_USER评价业务闭环_共用能力图与渠道专属流程_v2.2.md) — 每个节点的 查/写/状态/提醒/拦截 +- 前置版本： + - `数据流与中间对象需求_v1`（Codex，六层架构骨架） + - `数据流与中间对象设计_v1.1`（Codex，字段字典最全版） + - `第三步_数据流与中间表设计_v1`（字段级展开 + 流转时序） + - `第三步_数据流与中间表设计_v2`（吸收 Codex 优点的合并版） +- 合并策略：以 Codex v1.1 为主骨架（保留其完整字段字典和免评对象），补入 v2 的流转时序表、写入顺序图和快照策略。 +- 文件目的：作为第三步最终主稿，后续数据库物理设计、接口设计和页面点击读写设计均以此为准。 + +--- + +## 1. 第三步的目标 + +第三步不再回答"流程怎么走"，而是回答： + +1. 现有系统里已经有哪些数据可以复用。 +2. 为什么仅靠现有 `users / amazon_orders / review_plans / push_tasks / support_tickets / fraud_events` 不够。 +3. 必须新增哪些中间对象。 +4. 哪些是正式事务表，哪些只是快照，哪些可以先做成视图。 +5. 从需求形成到结果回流，数据怎样一层一层往下走。 + +--- + +## 2. 本步先给出的结论 + +### 2.1 不能再只围绕单一账号建模 + +后续所有关键判断都应围绕 **真实人**，而不是只看 JOYHUB ID / 邮箱 / 电话 / Amazon 账号 / 单次订单。JOYHUB 用户只是身份线索之一，真实人才是额度、历史、风险、跨渠道去重和客服上下文的主对象。 + +### 2.2 现有表能承载业务记录，但承载不了跨流程判断 + +既有表更接近"某一模块自己的账"，但前两步已确认的新需求需要额外的中间层：真实人跨账号归并、每次互动重判、人群入选/排除解释、额度预占与跨渠道去重、客服上下文、评价提交与展示拆分、退款比对。 + +### 2.3 第三步最重要的是把对象分层 + +本文件把数据对象分为六层： + +``` +源数据层 → 主实体层 → 桥接层 → 事件层 → 快照与决策层 → 结果回流层 +``` + +--- + +## 3. 数据设计原则 + +| 原则 | 说明 | +| --- | --- | +| 先识别真实人，再做额度与风险 | 否则 4/4/12 规则都会被多账号绕开 | +| 事件与快照分离 | 事件是原始事实，快照是某个时点的判断结果 | +| 当前态与历史态分离 | 当前视图可重算，历史决策必须留痕 | +| 计划、渠道、客服、风险状态分离 | 不能压成一个字段 | +| 用户提交与平台展示分离 | 真实提交计额度，Amazon 展示计计划完成 | +| 能解释"为什么" | 入选、排除、拦截、转人工都要能追溯 | +| 先复用现有对象，再补最小中间层 | 不为了建模漂亮重造全部旧表 | +| 对敏感数据分层处理 | 原值、标准化值、哈希/指纹、脱敏展示值应区分 | + +--- + +# 第一部分：现有数据源分析 + +## 4. 现有数据源盘点 + +| 数据源 | 当前可用内容 | 主要缺口 | +| --- | --- | --- | +| 现有 ERP 用户管理 | 用户 ID、用户名、注册时间、最近活跃、国家、性别、邮箱、绑定产品数、标签 | 仍是账号视角，不是真实人视角 | +| APP / 用户数据库 | JOYHUB ID、邮箱、设备号、设备型号/类型、系统版本、APP版本、绑定玩具、活跃与点击行为 | 需要设备变更轨迹和与订单/客服联动 | +| Amazon 订单 | 订单号、ASIN、站点、购买时间、订单状态、Profile ID、收件人姓名、收件地址等 | 需要标准化姓名/地址和收件人指纹 | +| Amazon 评价/Listing | ASIN、评分、评价数、差评数、评价缺口、展示结果 | 用户真实提交与平台展示要拆成两条事实 | +| 推送系统 | Push 计划、素材、任务、打开、点击、回复、投诉、退订 | IM/EDM/APP 语义不同，不能只用一套粗糙 push 结果 | +| 客服/TEL | 工单、通话、售后、答应配合、问题处理 | 需要和上下文卡、风险复检、跟进状态联动 | +| 黑名单/诈骗资料 | 黑名单、诈骗事件、双重退款、强弱关联 | 需要把风险信号与确认案件拆开 | +| OA 返款/Amazon 退款 | 内部返款与 Amazon 退款 | 缺统一比对对象 | +| JOYCOLLAB | KOC/KOL、内容、Code、点击、订单、转化、佣金 | 需要和 USER 计划/ASIN 结果打通 | + +### 4.1 Amazon 订单字段明细（结合表头.xlsx） + +| 字段 | 主要用途 | 涉密 | +| --- | --- | --- | +| 订单号 | 订单核验、真实人关联、退款比对 | 是 | +| 订单状态 | 判断是否撤销、退款、退货、换货 | - | +| 买家姓名 / 买家邮箱 | 身份关联 | 是 | +| 收件人 / 电话 | 真实人归并、风险判断 | 是 | +| 地址 / 城市 / 州 / 邮编 | 收件人归并、同址异名识别 | 是 | +| ASIN / MSKU / SKU / 品名 / 标题 | 产品匹配、计划归属 | - | +| 订购日期 / 发货时间 / 结算时间 | 时序判断 | - | +| 数量 / 单价 / 订单总金额 / 销售额 | 交易画像 | 是 | +| 是否退款 / 退款总金额 | 双重退款检测 | 是 | +| 请求评论状态 | 评价缺口判断 | - | +| 店铺 / 国家 / 销售渠道 | 站点匹配 | - | +| Order Item ID | 订单行级关联 | - | + +### 4.2 订单侧必须补的派生字段 + +| 字段 | 说明 | +| --- | --- | +| `recipient_name_normalized` | 标准化后的收件人姓名 | +| `recipient_address_normalized` | 标准化后的地址 | +| `recipient_fingerprint` | 由标准化姓名+地址生成的稳定指纹 | +| `address_fingerprint` | 仅地址指纹，用于识别同址异名 | + +--- + +## 5. 全局数据流 + +```mermaid +flowchart LR + subgraph S["源数据层"] + S1["现有ERP用户/标签/身份"] + S2["APP/设备/行为"] + S3["Amazon订单/评价/Listing"] + S4["IM/EDM/APP Push/TEL"] + S5["客服/工单/售后"] + S6["黑名单/OA返款/Amazon退款"] + S7["JOYCOLLAB"] + end + + subgraph M["主实体与桥接层"] + M1["真实人 person_profiles"] + M2["身份关联 person_identity_links"] + M3["订单/ASIN/计划/工单"] + M4["订单关联/路由/去重"] + end + + subgraph D["快照与决策层"] + D1["画像快照 person_feature_snapshots"] + D2["上下文卡 contact_context_snapshots"] + D3["额度台账/预占"] + D4["风险信号/风险案件"] + D5["人群快照/排除快照"] + D6["互动复检/路由决策"] + end + + subgraph E["事件层"] + E1["渠道事件"] + E2["客服/TEL事件"] + E3["退款事件"] + E4["评价提交事件"] + E5["免评执行事件"] + end + + subgraph R["结果回流层"] + R1["评价展示核验"] + R2["退款比对结果"] + R3["免评结果"] + R4["ASIN健康/计划完成"] + R5["绩效/审计/下一轮需求"] + end + + S1 & S2 & S3 --> M1 + S1 & S2 & S3 --> M2 + M1 & M2 & M3 --> D1 + M1 & M2 & M3 --> D2 + D1 --> D5 + D3 & D4 --> D5 + D5 --> D6 + D6 --> E1 + S4 --> E1 + S5 --> E2 + S6 --> E3 + E1 & E2 --> E4 + S7 --> E5 + E3 --> R2 + E4 --> R1 + E5 --> R3 + R1 & R2 & R3 --> R4 + R4 --> R5 + R5 --> M3 +``` + +--- + +# 第二部分：数据对象分层总表 + +## 6. 对象分层总表 + +| 分层 | 对象 | 说明 | +| --- | --- | --- | +| 源数据 | `users`、`devices`、`amazon_orders`、`asin_listings`、`push_tasks`、`support_tickets`、`fraud_events`、JOYCOLLAB 数据 | 现有或外部事实来源 | +| 主实体 | `person_profiles`、`request_tickets`、`review_plans`、`exemption_plans`、`risk_cases`、`blacklist_entities` | 核心业务主体 | +| 桥接 | `person_identity_links`、`user_order_links`、`plan_task_links`、`channel_route_decisions`、`channel_dedup_records` | 跨主体关系 | +| 事件 | `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` | 不可丢失的事实 | +| 快照/决策 | `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` | 为某次决策保留当时依据 | +| 结果/回流 | `review_display_checks`、`refund_match_results`、`exemption_result_snapshots`、`listing_health_snapshots`、`support_performance_snapshots` | 结果与复盘 | +| 治理 | `interaction_audit_logs`、`manual_review_tasks`、`export_logs`、`audit_logs` | 审计、复核、导出 | + +--- + +## 7. 现有对象如何处理 + +### 7.1 可以直接复用 + +| 现有对象 | 处理 | +| --- | --- | +| `request_tickets` | 保留，继续作为需求入口 | +| `amazon_orders` | 保留，补标准化姓名/地址与收件人指纹 | +| `asin_listings` | 保留，继续作为 ASIN/Listing 主档 | +| `support_tickets` | 保留，拆出跟进、分派和风险状态辅助表 | +| `fraud_events` | 保留，上游增加 `risk_signals`，下游衔接 `risk_cases/blacklist_entities` | +| `audit_logs` | 保留 | + +### 7.2 需要扩展 + +| 现有对象 | 需要补的能力 | +| --- | --- | +| `users` | 不再承担真实人主档，只保留 JOYHUB 账号层信息 | +| `devices` | 补设备型号、系统版本、APP版本、首次/最近出现、设备变化 | +| `review_plans` | 增加计划族或与 `exemption_plans` 分离 | +| `push_tasks` | 被更细的渠道事件表补充 | +| `support_tickets` | 增加与上下文卡、答应配合、风险复核、TEL 记录的关联 | + +### 7.3 必须新增 + +| 对象 | 原因 | +| --- | --- | +| `person_profiles` | 真实人主档 | +| `person_identity_links` | 多线索归并 | +| `person_feature_snapshots` | 画像解释 | +| `contact_context_snapshots` | 客服一屏上下文 | +| `person_quota_ledgers` | 4/4/12 统一额度 | +| `quota_reservations` | 并发占用与预警 | +| `audience_snapshots` | 人群生成留痕 | +| `audience_exclusions` | 排除原因留痕 | +| `channel_route_decisions` | 渠道路由解释 | +| `channel_dedup_records` | 跨渠道去重 | +| `interaction_recheck_records` | 每次有效互动重新判断留痕 | +| `refund_match_results` | 双重退款识别 | +| `review_display_checks` | 评价展示拆分 | + +--- + +# 第三部分：P0/P1/P2 优先级 + +## 8. P0：没有它们，主流程就不可靠 + +| 对象 | 类型 | 关键用途 | +| --- | --- | --- | +| `person_profiles` | 主实体 | 真实人主档 | +| `person_identity_links` | 桥接 | 账号、邮箱、电话、设备、Profile、收件人归并 | +| `person_feature_snapshots` | 快照 | 画像依据 | +| `contact_context_snapshots` | 快照 | 客服上下文卡 | +| `person_quota_ledgers` | 台账 | 4/4/12 统一额度 | +| `quota_reservations` | 台账 | 计划并发占用 | +| `risk_signals` | 事件 | 风险原始信号 | +| `risk_cases` | 主实体 | 风险案件 | +| `blacklist_entities` | 主实体 | 确认拦截对象 | +| `audience_snapshots` | 快照 | 某次人群生成结果 | +| `audience_exclusions` | 快照 | 排除原因 | +| `channel_route_decisions` | 决策 | 渠道路由 | +| `channel_dedup_records` | 决策 | 跨渠道去重 | +| `interaction_recheck_records` | 决策 | 每次有效互动重判 | + +## 9. P1：主流程可走，但没有它们会粗糙且难复盘 + +| 对象 | 类型 | 关键用途 | +| --- | --- | --- | +| `im_interaction_records` | 事件 | IM 细节 | +| `im_flow_tags` | 事件/派生 | IM 流程流转 | +| `edm_message_events` | 事件 | EDM 打开/点击/回复/退订 | +| `edm_user_behavior_profiles` | 快照 | EDM 画像 | +| `app_touch_events` | 事件 | APP Push 触达 | +| `tel_call_records` | 事件 | 电话全记录 | +| `support_followups` | 事务 | 答应配合跟进 | +| `support_assignment_logs` | 事件 | 分配与升级 | +| `review_submission_records` | 事件 | 用户真实提交评价 | +| `review_display_checks` | 结果 | Amazon 展示核验 | +| `exemption_plans` | 主实体 | 免评计划 | +| `exemption_plan_tasks` | 事务 | 免评任务 | +| `creator_content_records` | 事件 | KOC/KOL 内容 | +| `exemption_result_snapshots` | 结果 | 免评结果 | +| `amazon_refund_records` | 事件 | Amazon 退款 | +| `oa_refund_records` | 事件 | OA 返款 | +| `refund_match_results` | 结果 | 双重退款比对 | + +## 10. P2：管理、效率与治理增强 + +| 对象 | 类型 | 关键用途 | +| --- | --- | --- | +| `attendance_records` | 事务 | 出勤 | +| `shift_schedules` | 事务 | 排班 | +| `support_goal_records` | 事务 | 目标 | +| `support_performance_snapshots` | 快照 | 绩效 | +| `manual_review_tasks` | 事务 | 人工复核 | +| `interaction_audit_logs` | 审计 | 高敏动作审计 | + +--- + +# 第四部分：完整字段字典 + +## 11. 真实人与身份层 + +### 11.1 `person_profiles` + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `person_id` | PK | 真实人唯一标识 | +| `created_at` | datetime | 首次识别时间 | +| `updated_at` | datetime | 最近归并更新时间 | +| `merge_confidence` | enum | 高/中/低 | +| `status` | enum | 正常/观察中/已确认风险 | +| `primary_country` | string | 当前主要国家 | +| `primary_language` | string | 当前主要语言 | +| `latest_active_at` | datetime | 最近活跃时间 | +| `lifetime_review_submitted_count` | int | 累计真实提交评价数（跨账号合并） | +| `current_risk_level` | enum | 当前风险等级 | + +### 11.2 `person_identity_links` + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `link_id` | PK | 关联记录 ID | +| `person_id` | FK → person_profiles | 所属真实人 | +| `identity_type` | enum | JOYHUB_ID / EMAIL / PHONE / DEVICE / AMAZON_PROFILE / NAME_ADDRESS / PAYMENT / ORDER | +| `identity_value_hash` | string | 匹配索引 | +| `identity_value_encrypted` | string | 仅在必要时保存的加密原值 | +| `link_strength` | enum | 强/弱 | +| `confidence_score` | decimal | 归并置信度 | +| `evidence_summary` | text | 命中依据摘要 | +| `first_seen_at` | datetime | 首次发现时间 | +| `last_seen_at` | datetime | 最近确认时间 | +| `source_type` | enum | AMAZON_ORDER / JOYHUB / MANUAL / TEL / EMAIL / CS_TICKET | +| `is_active` | bool | 是否仍有效 | + +### 11.3 归并口径 + +| 场景 | 数据处理 | +| --- | --- | +| 标准化后姓名+地址完全一致 | 直接归并到同一真实人，link_strength=STRONG | +| 地址一致但姓名不同 | 记录弱关联，不直接合并 | +| 多个线索交叉命中 | 形成候选归并，记录证据和置信度 | +| 只有单个弱线索 | 不做直接归并，只写风险信号 | + +### 11.4 `contact_context_snapshots` + +| 字段组 | 字段 | 来源 | +| --- | --- | --- | +| 快照元数据 | `snapshot_id`、`person_id`、`snapshot_at`、`trigger_event` | 系统 | +| 当前身份 | `joyhub_ids[]`、`emails[]`、`phones[]`、`devices[]`、`amazon_profile_ids[]` | 身份关联 | +| 归并摘要 | `standardized_name_address`、`linked_person_count`、`merge_confidence` | 真实人/身份关联 | +| 历史交易 | `total_orders`、`last_order_at`、`total_refunds`、`total_oa_refunds`、`target_asin_purchases[]` | 订单/返款 | +| 历史服务 | `total_tickets`、`last_ticket_at`、`total_calls`、`last_call_at`、`open_promises[]` | 工单/电话 | +| 历史风险 | `blacklist_hits`、`strong_associations`、`weak_associations`、`fraud_cases`、`double_refund_flags` | 风险层 | +| 当前设备 | `device_count`、`latest_device_model`、`app_version`、`recent_device_change` | APP/设备 | +| 触达历史 | `im_recent[]`、`edm_recent[]`、`app_recent[]`、`tel_recent[]` | 渠道事件 | + +--- + +## 12. 画像、额度与人群层 + +### 12.1 `person_feature_snapshots` + +| 字段组 | 代表字段 | +| --- | --- | +| 快照元数据 | `feature_snapshot_id`、`person_id`、`snapshot_at`、`feature_version` | +| 基础画像 | `country`、`marketplace`、`language`、`gender`、`age_band`、`registered_at` | +| 产品关系 | `bound_toy_count`、`bound_categories[]`、`target_product_relation` | +| 交易画像 | `total_orders`、`last_order_at`、`purchase_frequency`、`bought_target_asin` | +| 行为画像 | `activity_score`、`open_rate`、`click_rate`、`reply_rate`、`review_rate`、`cooperation_rate` | +| 触达画像 | `im_reachable`、`edm_reachable`、`app_reachable`、`tel_reachable`、`last_touch_at` | +| 风险画像 | `risk_level`、`blacklist_hit`、`strong_link_count`、`weak_link_count`、`refund_anomaly_flag` | +| 计划画像 | `joined_plan_types[]`、`last_plan_result`、`lifetime_review_submitted_count` | + +### 12.2 三类画像用途 + +| 用途 | 说明 | 示例 | +| --- | --- | --- | +| **硬过滤** | 决定能不能进入人群池 | 黑名单、退订、强关联、超额、站点不符 | +| **匹配条件** | 决定适不适合当前计划 | 国家、性别、年龄段、绑定玩具、是否买过目标 ASIN | +| **排序权重** | 决定优先触达谁 | 活跃度、历史配合率、最近互动、打开/点击行为 | + +### 12.3 `person_quota_ledgers` + +> **HANDOFF：用户运营核心控制规则。** "4+4+12"全部按真实人统计，跨所有关联账号合并计算。一个人不管有几个 JOYHUB ID、几个 Amazon 账号——只要归并到同一个真实人，都受同一套额度控制。 +> +> 示例：真实人关联 3 个 JOYHUB ID（A/B/C），A 上提交 5 个 + B 上提交 4 个 + C 上提交 3 个 = 累计 12，**全部账号停回评/测评，后续仅免评。** + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `ledger_id` | PK | 台账记录 ID | +| `person_id` | FK → person_profiles | 真实人 | +| `period_key` | string | 自然月，如 `2026-05` | +| `quota_type` | enum | MONTHLY_REVIEW / MONTHLY_EXEMPTION / LIFETIME_REVIEW | +| `quota_limit` | int | 4 / 4 / 12 | +| `used` | int | 已完成 | +| `in_progress` | int | 进行中 | +| `reserved` | int | 已预占 | +| `available` | int | 剩余可用 = limit - used - in_progress - reserved | +| `updated_at` | datetime | 最近更新 | + +### 12.4 `quota_reservations` + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `reservation_id` | PK | 预占记录 | +| `person_id` | FK | 真实人 | +| `plan_id` | FK | 关联计划 | +| `quota_type` | enum | 测评/免评 | +| `reserved_count` | int | 预占数量 | +| `reserved_at` | datetime | 预占时间 | +| `expires_at` | datetime | 过期释放时间 | +| `status` | enum | 已预占/已使用/已释放/已过期 | + +### 12.5 `audience_snapshots` + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `snapshot_id` | PK | 人群快照 ID | +| `plan_id` | FK | 计划 | +| `batch_id` | string | 生成人群批次 | +| `person_id` | FK | 真实人 | +| `match_score` | decimal | 匹配得分 | +| `match_reasons` | JSON | 命中画像条件 | +| `quota_status` | enum | 充足/预警/超限 | +| `risk_status` | enum | 正常/弱风险/强风险 | +| `priority_rank` | int | 触达优先级 | +| `feature_snapshot_id` | FK | 当时引用的画像快照 | +| `snapshot_at` | datetime | 快照时间 | + +### 12.6 `audience_exclusions` + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `exclusion_id` | PK | 排除记录 | +| `plan_id` | FK | 计划 | +| `batch_id` | string | 批次 | +| `person_id` | FK | 真实人 | +| `exclusion_reason` | enum | BLACKLIST / UNSUBSCRIBED / QUOTA_EXCEEDED / FREQ_EXCEEDED / OPEN_TICKET / WRONG_COUNTRY / STRONG_RISK | +| `excluded_at` | datetime | 排除时间 | + +### 12.7 为什么一定需要这些中间表 + +| 对象 | 如果没有会怎样 | +| --- | --- | +| `person_feature_snapshots` | 无法解释当时的画像依据 | +| `audience_snapshots` | 无法复盘某次计划到底选中了谁 | +| `audience_exclusions` | 无法解释为什么用户没被选中 | +| `person_quota_ledgers` | 4/4/12 规则无法跨账号统一计算 | +| `quota_reservations` | 多个计划并发时会重复占用同一人额度 | + +--- + +## 13. 路由与互动复检层 + +### 13.1 `channel_route_decisions` + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `route_decision_id` | PK | 路由决策 ID | +| `plan_id` | FK | 计划 | +| `batch_id` | string | 人群批次 | +| `person_id` | FK | 真实人 | +| `candidate_channels` | JSON | 候选渠道 | +| `selected_channel` | enum | 实际选中渠道 | +| `excluded_channels` | JSON | 被排除渠道及原因 | +| `decision_factors` | JSON | 活跃、绑定、可达性、工单、额度、风险 | +| `decided_at` | datetime | 决策时间 | + +### 13.2 `channel_dedup_records` + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `dedup_id` | PK | 去重记录 | +| `person_id` | FK | 真实人 | +| `plan_id` | FK | 计划 | +| `selected_channel` | enum | 保留渠道 | +| `suppressed_channels` | JSON | 被抑制渠道 | +| `reason` | text | 去重原因 | +| `created_at` | datetime | 去重时间 | + +### 13.3 `interaction_recheck_records` + +每次有效互动后，记录本次重新做过哪些检查、结果是什么、为何继续或拦截。这是"每次互动重判"的落地证据。 + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `recheck_id` | PK | 复检记录 | +| `interaction_type` | enum | IM / EDM / APP / TEL / CS / REFUND | +| `interaction_id` | string | 触发互动 | +| `person_id` | FK | 真实人 | +| `context_snapshot_id` | FK | 上下文快照 | +| `quota_snapshot_ref` | string | 额度快照引用 | +| `risk_case_id` | FK | 关联风险案件 | +| `identity_result` | enum | 正常/新增关联/冲突 | +| `history_result` | enum | 无变化/有更新 | +| `quota_result` | enum | 充足/预警/超限 | +| `risk_result` | enum | 正常/弱风险/强风险 | +| `final_action` | enum | 继续/降级/转人工/暂停 | +| `checked_at` | datetime | 复检时间 | + +--- + +## 14. 风险层 + +### 14.1 `risk_signals` + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `signal_id` | PK | 风险信号 ID | +| `person_id` | FK | 真实人 | +| `signal_type` | enum | STRONG_HIT / WEAK_HIT / DOUBLE_REFUND / DEVICE_ANOMALY / ADDRESS_ANOMALY / BLACKLIST_HIT | +| `hit_dimensions` | JSON | 命中维度 | +| `source_event_id` | string | 触发事件 | +| `created_at` | datetime | 产生时间 | +| `resolved_at` | datetime | 解除时间 | +| `resolution` | enum | 确认风险/误报/观察中 | + +### 14.2 `risk_cases` + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `case_id` | PK | 风险案件 | +| `person_id` | FK | 真实人 | +| `source_type` | enum | CS_TICKET / TEL_CALL / PUSH_RESPONSE / REFUND / MANUAL | +| `source_id` | string | 来源对象 | +| `status` | enum | 待复核/复核中/确认诈骗/排除/已同步黑名单 | +| `reviewer_id` | FK | 复核人 | +| `reviewed_at` | datetime | 复核时间 | +| `sync_status` | enum | 未同步/同步中/已同步/同步失败 | + +### 14.3 `blacklist_entities` + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `blacklist_entity_id` | PK | 黑名单实体 | +| `entity_type` | enum | 邮箱/电话/设备/Profile/收款信息/真实人 | +| `entity_hash` | string | 匹配索引 | +| `risk_level` | enum | 风险等级 | +| `source_case_id` | FK | 来源案件 | +| `synced_at` | datetime | 同步时间 | +| `status` | enum | 生效/失效/待复核 | + +### 14.4 `manual_review_tasks` + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `task_id` | PK | 人工复核任务 | +| `person_id` | FK | 真实人 | +| `source_type` | enum | 风险/额度/渠道/退款 | +| `source_id` | string | 来源对象 | +| `task_reason` | text | 复核原因 | +| `status` | enum | 待处理/处理中/已完成/已关闭 | +| `owner_id` | FK | 负责人 | +| `created_at` | datetime | 创建时间 | + +--- + +## 15. 渠道事件层 + +### 15.1 `im_interaction_records` + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `im_record_id` | PK | IM 记录 | +| `person_id` | FK | 真实人 | +| `joyhub_id` | FK | JOYHUB 账号 | +| `plan_id` | FK | 关联计划 | +| `action_type` | enum | PUSH_CARD / USER_SUBMIT / USER_REPLY / REMINDER / NOTIFICATION | +| `card_type` | enum | REVIEW_CARD / EVALUATION_CARD / EXEMPTION_CARD / REMINDER_CARD | +| `user_submitted_data` | JSON | 订单号/返款账号/截图链接（涉密加密存储） | +| `order_validation_result` | enum | 通过/非测评单/非公司产品/格式错误/已撤销/已退款 | +| `tag_changes` | JSON | 本次产生的标签变化 | +| `created_at` | datetime | 事件时间 | + +### 15.2 `im_flow_tags` + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `flow_tag_id` | PK | 流程标签记录 | +| `person_id` | FK | 真实人 | +| `tag_code` | string | 流程标签 | +| `source_im_record_id` | FK | 来源 IM 事件 | +| `effective_from` | datetime | 生效时间 | +| `effective_to` | datetime | 失效时间 | + +### 15.3 `edm_message_events` + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `edm_event_id` | PK | EDM 事件 | +| `person_id` | FK | 真实人 | +| `email_hash` | string | 邮箱索引 | +| `campaign_id` | FK | 邮件任务 | +| `event_type` | enum | SENT / DELIVERED / OPENED / CLICKED / REPLIED / BOUNCED / UNSUBSCRIBED / COMPLAINED | +| `event_at` | datetime | 事件时间 | +| `click_target` | string | 点击目标 | + +### 15.4 `edm_user_behavior_profiles` + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `profile_id` | PK | EDM 行为画像 | +| `person_id` | FK | 真实人 | +| `latest_open_at` | datetime | 最近打开 | +| `latest_reply_at` | datetime | 最近回复 | +| `open_count_total` | int | 累计打开次数 | +| `zero_open_last_3` | bool | 最近 3 次 0 打开 | +| `zero_open_last_5` | bool | 最近 5 次 0 打开 | +| `clicked_review_link_without_reply_hours` | int | 点击评论链接但未回复时长 | +| `monthly_receive_count` | int | 当月收信次数 | +| `mail_type_counts` | JSON | 各邮件类型发送次数 | +| `mailbox_domain` | string | 邮箱后缀 | +| `is_unsubscribed` | bool | 是否退订 | +| `has_hard_bounce` | bool | 是否硬退信 | +| `snapshot_at` | datetime | 快照时间 | + +### 15.5 `app_touch_events` + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `app_event_id` | PK | APP 事件 | +| `person_id` | FK | 真实人 | +| `joyhub_id` | FK | JOYHUB 账号 | +| `push_type` | enum | PUSH / IN_APP / BANNER / POPUP | +| `event_type` | enum | SENT / DISPLAYED / CLICKED / DISMISSED / UNINSTALLED | +| `landing_page` | string | 落地页 | +| `event_at` | datetime | 事件时间 | + +### 15.6 `tel_call_records` + +| 字段 | 类型 | 说明 | 涉密 | +| --- | --- | --- | --- | +| `tel_record_id` | PK | 电话记录 | - | +| `person_id` | FK | 真实人 | - | +| `ticket_id` | FK | 关联工单 | - | +| `call_direction` | enum | INBOUND/OUTBOUND | - | +| `call_source` | enum | AMAZON_PAGE/MANUAL/PLAN_TASK/FOLLOWUP | - | +| `phone_hash` | string | 电话索引 | 是 | +| `call_at` | datetime | 通话时间 | - | +| `duration_seconds` | int | 通话时长 | - | +| `call_result` | enum | CONNECTED/NO_ANSWER/WRONG_NUMBER/DECLINED | - | +| `has_after_sale_issue` | bool | 是否有售后 | - | +| `issue_type` | enum | 问题类型 | - | +| `issue_description` | text | 问题描述 | - | +| `solution` | text | 处理方案 | - | +| `is_resolved` | bool | 是否解决 | - | +| `is_satisfied` | bool | 是否满意 | - | +| `invited_review` | bool | 是否邀请回评/测评 | - | +| `user_accepted` | bool | 是否接受 | - | +| `agent_id` | FK | 客服 | - | + +--- + +## 16. 客服层 + +### 16.1 `support_tickets` + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `ticket_id` | PK | 工单 | +| `person_id` | FK | 真实人 | +| `ticket_type` | enum | 差评跟进/测评跟进/回评跟进/紧急Listing/电话/售后/诈骗样品/KOL进度 | +| `source` | enum | AMAZON_OP/BRAND_OP/SYSTEM_AUTO/PUSH_ESCALATION/USER_REPLY/TEL_INBOUND | +| `source_id` | string | 来源对象 | +| `ticket_status` | enum | 待分配/已分配/处理中/等待用户/等待内部/已解决/疑似诈骗/已关闭 | +| `assigned_team` | FK | 客服组 | +| `assigned_agent` | FK | 客服 | +| `created_at` | datetime | 创建时间 | +| `first_response_at` | datetime | 首次回复 | +| `resolved_at` | datetime | 解决时间 | +| `closed_at` | datetime | 关闭时间 | +| `context_snapshot_id` | FK | 创建时上下文快照 | + +### 16.2 `support_followups` + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `followup_id` | PK | 跟进 | +| `ticket_id` | FK | 工单 | +| `person_id` | FK | 真实人 | +| `followup_status` | enum | 已答应配合/待分配/待提醒/等待提交/已提交评价/已提交反馈/超时/需再次联系/已关闭 | +| `promised_at` | datetime | 承诺时间 | +| `reminder_count` | int | 已提醒次数 | +| `last_reminder_at` | datetime | 最近提醒 | +| `deadline_at` | datetime | 截止时间 | +| `submitted_at` | datetime | 实际提交 | +| `submission_type` | enum | 评价/反馈 | + +### 16.3 `support_assignment_logs` + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `assignment_log_id` | PK | 分配日志 | +| `ticket_id` | FK | 工单 | +| `from_owner_id` | FK | 原负责人 | +| `to_owner_id` | FK | 新负责人 | +| `assign_type` | enum | 自动分配/组长分派/转派/升级 | +| `reason` | text | 原因 | +| `created_at` | datetime | 分配时间 | + +### 16.4 `plan_task_links` + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `link_id` | PK | 桥接 ID | +| `plan_id` | FK | 计划 | +| `task_type` | enum | IM_TASK/EDM_TASK/APP_TASK/TEL_TASK/CS_TASK/KOC_TASK | +| `task_id` | string | 各渠道任务 ID | +| `created_at` | datetime | 创建时间 | + +--- + +## 17. 评价与退款结果层 + +### 17.1 `review_submission_records` + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `submission_id` | PK | 提交记录 | +| `person_id` | FK | 真实人 | +| `plan_id` | FK | 计划 | +| `channel` | enum | IM/EDM/APP/TEL/CS | +| `source_event_id` | string | 来源事件 | +| `submitted_at` | datetime | 提交时间 | +| `submission_evidence` | JSON | 截图/链接 | +| `order_number_hash` | string | 订单索引 | +| `quota_counted` | bool | 是否已计入 12（提交时即为true） | + +### 17.2 `review_display_checks` + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `check_id` | PK | 核验记录 | +| `submission_id` | FK | 提交记录 | +| `asin` | string | ASIN | +| `check_at` | datetime | 核验时间 | +| `is_displayed` | bool | 是否展示 | +| `is_verifiable` | bool | 是否可核验 | +| `display_status` | enum | 展示确认/未展示/待核验 | +| `plan_completed` | bool | 是否计入计划完成（展示确认后才为true） | + +### 17.3 `amazon_refund_records` / `oa_refund_records` / `refund_match_results` + +| 对象 | 关键字段 | +| --- | --- | +| `amazon_refund_records` | `refund_id`、`order_number_hash`、`asin`、`refund_amount`、`refund_at`、`refund_reason` | +| `oa_refund_records` | `oa_refund_id`、`person_id`、`order_number_hash`、`refund_amount`、`refund_at` | +| `refund_match_results` | `match_id`、`order_number_hash`、`amazon_refund_id`、`oa_refund_id`、`match_status`、`amount_diff`、`matched_at` | + +--- + +## 18. 免评结果层 + +### 18.1 `exemption_plans` + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `exemption_plan_id` | PK | 免评计划 | +| `source_request_id` | FK | 来源需求 | +| `asin` | string | ASIN | +| `marketplace` | string | 站点 | +| `goal_type` | enum | 内容发布/引流/带货/权重 | +| `target_metrics` | JSON | 目标点击、Code、订单、销量、权重 | +| `status` | enum | 草稿/待审批/执行中/已完成/已关闭 | + +### 18.2 `exemption_plan_tasks` + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `task_id` | PK | 免评任务 | +| `exemption_plan_id` | FK | 免评计划 | +| `task_type` | enum | KOC/KOL/IM/EDM/APP/内容协同 | +| `owner_id` | FK | 负责人 | +| `status` | enum | 待执行/执行中/已完成/异常 | +| `created_at` | datetime | 创建时间 | + +### 18.3 `creator_content_records` + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `creator_content_id` | PK | 内容记录 | +| `exemption_task_id` | FK | 免评任务 | +| `creator_id` | string | KOC/KOL | +| `content_url` | string | 内容链接 | +| `published_at` | datetime | 发布时间 | +| `code_usage_count` | int | Code 使用量 | +| `click_count` | int | 点击量 | +| `order_count` | int | 带货订单 | +| `sales_amount` | decimal | 销售额 | + +### 18.4 `exemption_result_snapshots` + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `snapshot_id` | PK | 免评结果快照 | +| `exemption_plan_id` | FK | 免评计划 | +| `snapshot_at` | datetime | 快照时间 | +| `content_published_count` | int | 内容发布数 | +| `click_count` | int | 点击 | +| `code_usage_count` | int | Code 使用 | +| `order_count` | int | 订单 | +| `sales_amount` | decimal | 销售额 | +| `weight_change_summary` | text | 权重变化摘要 | + +--- + +## 19. 客服管理支撑层 + +| 对象 | 关键字段 | +| --- | --- | +| `attendance_records` | `record_id`、`agent_id`、`date`、`scheduled_hours`、`actual_hours`、`status` | +| `shift_schedules` | `shift_id`、`team_id`、`agent_id`、`date`、`shift_start`、`shift_end`、`max_tickets` | +| `support_goal_records` | `goal_id`、`agent_id`、`period_key`、`goal_type`、`target_value`、`current_value` | +| `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` | + +--- + +## 20. 逻辑关系总图 + +```mermaid +erDiagram + PERSON_PROFILES ||--o{ PERSON_IDENTITY_LINKS : "归并" + PERSON_PROFILES ||--o{ PERSON_FEATURE_SNAPSHOTS : "画像" + PERSON_PROFILES ||--o{ CONTACT_CONTEXT_SNAPSHOTS : "上下文" + PERSON_PROFILES ||--o{ PERSON_QUOTA_LEDGERS : "额度台账" + PERSON_PROFILES ||--o{ QUOTA_RESERVATIONS : "额度预占" + PERSON_PROFILES ||--o{ RISK_SIGNALS : "风险信号" + PERSON_PROFILES ||--o{ RISK_CASES : "风险案件" + PERSON_PROFILES ||--o{ AUDIENCE_SNAPSHOTS : "人群入选" + PERSON_PROFILES ||--o{ AUDIENCE_EXCLUSIONS : "人群排除" + PERSON_PROFILES ||--o{ CHANNEL_ROUTE_DECISIONS : "路由" + PERSON_PROFILES ||--o{ CHANNEL_DEDUP_RECORDS : "去重" + PERSON_PROFILES ||--o{ INTERACTION_RECHECK_RECORDS : "互动复检" + PERSON_PROFILES ||--o{ IM_INTERACTION_RECORDS : "IM" + PERSON_PROFILES ||--o{ IM_FLOW_TAGS : "IM标签" + PERSON_PROFILES ||--o{ EDM_MESSAGE_EVENTS : "EDM" + PERSON_PROFILES ||--o{ EDM_USER_BEHAVIOR_PROFILES : "EDM画像" + PERSON_PROFILES ||--o{ APP_TOUCH_EVENTS : "APP" + PERSON_PROFILES ||--o{ TEL_CALL_RECORDS : "TEL" + PERSON_PROFILES ||--o{ SUPPORT_TICKETS : "工单" + PERSON_PROFILES ||--o{ SUPPORT_FOLLOWUPS : "跟进" + PERSON_PROFILES ||--o{ REVIEW_SUBMISSION_RECORDS : "评价提交" + PERSON_PROFILES ||--o{ MANUAL_REVIEW_TASKS : "人工复核" + REVIEW_SUBMISSION_RECORDS ||--o{ REVIEW_DISPLAY_CHECKS : "展示核验" + SUPPORT_TICKETS ||--o{ SUPPORT_ASSIGNMENT_LOGS : "分配" + RISK_CASES ||--o{ BLACKLIST_ENTITIES : "同步" + AMAZON_REFUND_RECORDS ||--o{ REFUND_MATCH_RESULTS : "退款比对" + OA_REFUND_RECORDS ||--o{ REFUND_MATCH_RESULTS : "退款比对" + EXEMPTION_PLANS ||--o{ EXEMPTION_PLAN_TASKS : "任务" + EXEMPTION_PLAN_TASKS ||--o{ CREATOR_CONTENT_RECORDS : "内容" + EXEMPTION_PLANS ||--o{ EXEMPTION_RESULT_SNAPSHOTS : "结果" + REVIEW_PLANS ||--o{ PLAN_TASK_LINKS : "计划任务" + SHIFT_SCHEDULES ||--o{ SUPPORT_TICKETS : "排班分配" + ATTENDANCE_RECORDS }o--|| SHIFT_SCHEDULES : "出勤关联" +``` + +--- + +# 第五部分：数据流转 + +## 21. 关键流转时序 + +| 阶段 | 读（查） | 写 | 说明 | +| --- | --- | --- | --- | +| 真实人识别 | person_identity_links（已有线索） | person_profiles + person_identity_links（新线索） | 每次互动都先跑 | +| 画像生成 | person_profiles + 七组画像数据 + 各渠道事件 | person_feature_snapshots | 定期或触发式刷新 | +| 人群生成 | person_feature_snapshots + person_quota_ledgers + risk_signals | audience_snapshots + audience_exclusions + quota_reservations | 快照当下状态 | +| 路由决策 | audience_snapshots + 用户状态 + 渠道可达性 | channel_route_decisions + channel_dedup_records | 选定渠道+去重 | +| 渠道发送 | channel_route_decisions + quota_reservations + risk_signals（最新） | 各渠道事件表 | 发送前终校 | +| 用户回应 | person_identity_links + person_quota_ledgers + risk_signals（全部重读） | interaction_recheck_records + 渠道事件表更新 + im_flow_tags | 每次互动复检留痕 | +| 评价提交 | person_quota_ledgers（累计额度） | review_submission_records + person_quota_ledgers（+1） | 提交即计12 | +| Amazon 展示确认 | review_submission_records | review_display_checks + 计划完成度更新 | 展示才计完成 | +| 退款/返款 | amazon_refund_records + oa_refund_records | refund_match_results + risk_signals（如命中） | 双重退款检测 | + +## 22. 每次有效互动的标准写入顺序 + +```mermaid +flowchart LR + A["互动发生"] --> B["解析真实人
读 person_identity_links"] + B --> C["生成/更新上下文卡
写 contact_context_snapshots"] + C --> D["读取最新额度
读 person_quota_ledgers"] + D --> E["执行风险判断
读 risk_signals + blacklist"] + E --> F["写 interaction_recheck_records"] + F --> G{"结果"} + G -->|正常| H["继续业务"] + G -->|预警| I["继续 + 高亮提醒"] + G -->|拦截| J["暂停 + 转人工/风险链路"] +``` + +适用场景：主动推送后回复、用户再次联系、补充订单号、客服回访、TEL 来电、退款/返款/再次触达前。 + +--- + +# 第六部分：设计决策与边界 + +## 23. 对象分类 + +| 类型 | 对象 | 原因 | +| --- | --- | --- | +| **正式事务表** | `person_profiles`、`person_identity_links`、`support_tickets`、`support_followups`、`risk_cases`、`review_submission_records`、`quota_reservations` | 需要增删改和业务状态流转 | +| **不可变事件表** | `im_interaction_records`、`edm_message_events`、`app_touch_events`、`tel_call_records`、`amazon_refund_records`、`oa_refund_records`、`support_assignment_logs`、`im_flow_tags` | 事实一旦发生不应被覆盖 | +| **快照表** | `person_feature_snapshots`、`contact_context_snapshots`、`audience_snapshots`、`support_performance_snapshots`、`exemption_result_snapshots` | 需要保留某一时点状态以便复盘 | +| **决策表** | `channel_route_decisions`、`channel_dedup_records`、`interaction_recheck_records`、`refund_match_results` | 保存系统当时为什么这样判断 | +| **聚合画像** | `edm_user_behavior_profiles` | 由事件聚合推导，定期刷新 | +| **可先做视图** | 当前剩余额度、当前风险摘要、当前上下文卡、当前人群统计看板、当前绩效看板 | 可由底层对象实时聚合 | + +### 判断法 + +| 问题 | 如果答案是"是" | +| --- | --- | +| 后续需要追责"当时为什么这么做"吗 | 建正式表或决策表 | +| 数据后来会变，但历史判断不能跟着变吗 | 建快照 | +| 只是为了当前页面展示吗 | 优先做视图 | +| 一旦发生就不该被覆盖吗 | 建事件表 | + +## 24. 当前还不能只靠"老表扩列"解决的事情 + +| 问题 | 为什么不能只扩列 | +| --- | --- | +| 一个真实人多个账号 | `users` 是账号级，不是人级 | +| 每次互动重判 | 不是用户静态属性，而是一次次决策事实 | +| 人群为什么入选/排除 | 不是计划表字段，而是某一批次结果 | +| 多计划并发占额度 | 需要独立预占 | +| 用户提交与展示拆分 | 不是一个布尔值能表达 | +| 退款比对 | 需要两个来源事实加一个比对结果 | +| 客服上下文 | 不是工单表本身，而是跨源聚合视图+快照 | + +## 25. 当前可以先不做成物理表的内容 + +| 内容 | 当前建议 | +| --- | --- | +| 当前剩余额度 | 先由 `person_quota_ledgers + quota_reservations` 聚合成视图 | +| 当前风险摘要 | 先由 `risk_signals + risk_cases + blacklist_entities` 聚合成视图 | +| 当前客服上下文卡 | 前台读当前视图，关键接入动作时写 `contact_context_snapshots` | +| 当前人群统计看板 | 先基于 `audience_snapshots / exclusions` 聚合 | +| 当前绩效看板 | 先基于工单、通话、跟进事件聚合，后续再沉淀快照 | + +## 26. 外部数据引用原则 + +| 外部数据 | 所属系统 | USER 当前做法 | +| --- | --- | --- | +| Amazon 订单全量明细 | Amazon API/报表 | 导入关键字段，不把 USER 做成全量订单数仓 | +| JOYHUB 用户行为明细 | APP/用户系统 | 取摘要或增量同步，用于画像与上下文 | +| 黑名单全量数据 | 黑名单系统 | 引用并缓存关键维度，不重复建设 | +| JOYCOLLAB 全量内容与带货明细 | JOYCOLLAB | 同步 USER 闭环所需结果摘要 | +| 财务/人事原始表 | 财务/人事系统 | 导入必要摘要，不替代源系统 | + +## 27. 涉密字段处理 + +| 涉密字段 | 建议存储 | 建议查询 | +| --- | --- | --- | +| 订单号 | 哈希索引 + 加密原值 | 常规用哈希匹配 | +| 邮箱 | 哈希索引 + 脱敏展示 | 普通页面不暴露明文 | +| 电话 | 哈希索引 + 加密原值 | 仅授权角色可揭示 | +| 姓名/地址 | 标准化值 + 哈希/指纹 | 归并与风险用指纹 | +| 设备号 | 哈希索引 | 归并/风险用哈希 | +| IP | 脱敏存储 | 仅用于弱关联 | +| 收款信息 | 加密存储 | 财务/风险授权查看 | +| 返款金额/提成 | 权限控制 | 财务角色优先 | + +## 28. 快照策略 + +| 快照对象 | 生成时机 | 保留策略 | +| --- | --- | --- | +| `person_feature_snapshots` | 定期刷新 + 人群生成前触发 | 保留最近 N 版 + 每次人群生成引用的版本 | +| `contact_context_snapshots` | 用户接入/工单创建/拨打前/风险升级 | 每次生成新快照，保留全量历史 | +| `audience_snapshots` | 人群生成时 | 每次计划保留 | +| `edm_user_behavior_profiles` | EDM 画像定时刷新 | 按刷新批次保留 | +| `support_performance_snapshots` | 每日/每周/每月 | 按周期聚合保留 | +| `exemption_result_snapshots` | 免评执行阶段性同步 | 按结果周期保留 | + +--- + +# 第七部分：谁写谁读 + +## 29. 读写矩阵 + +| 对象 | 主要写入方 | 主要读取方 | 依赖它的动作 | +| --- | --- | --- | --- | +| `person_profiles` | 身份归并服务 | 用户运营、客服、风险 | 所有真实人级判断 | +| `person_identity_links` | 身份归并服务 | 风险、客服、订单核验 | 真实人识别 | +| `person_feature_snapshots` | 画像任务 | 人群生成、客服 | 画像筛选 | +| `contact_context_snapshots` | 上下文聚合服务 | 客服、用户运营 | 接入处理 | +| `person_quota_ledgers` | 额度服务 | 人群生成、渠道、客服 | 4/4/12 判断 | +| `quota_reservations` | 人群/计划服务 | 渠道、额度服务 | 发送前拦截 | +| `audience_snapshots` | 人群生成服务 | 计划、复盘 | 解释入选 | +| `channel_route_decisions` | 路由服务 | 推送、复盘 | 选渠道 | +| `interaction_recheck_records` | 互动复检服务 | 客服、风险、审计 | 决定继续/拦截 | +| `review_submission_records` | 客服/IM/TEL | 额度、计划、客服 | 计入12 | +| `review_display_checks` | 运营/系统 | 计划、ASIN看板 | 计入完成 | +| `refund_match_results` | 退款比对服务 | 风险、客服、财务 | 拦截双重退款 | + +--- + +## 30. 还需要确认但不阻塞第三步的事项 + +| 事项 | 影响 | +| --- | --- | +| Amazon 订单同步频率最终是否为 10 分钟 | 影响订单/退款数据新鲜度 | +| 黑名单系统最终通过 API、表格还是消息同步 | 影响 `blacklist_entities` 同步方式 | +| Amazon Profile ID 是否稳定获取 | 影响强关联覆盖率 | +| APP 设备型号能否拿到具体型号还是只到类型 | 影响客服展示颗粒度 | +| 年龄字段来自注册资料还是推断 | 影响画像可信度 | +| KOC/KOL 结果同步周期 | 影响免评结果快照频率 | + +--- + +## 31. 第四步入口 + +1. **把数据对象转成逻辑 ER 图**：以 §20 的 Mermaid ER 图为基础，明确主键、外键、1对多/多对多关系，区分复用旧表和新增表。 +2. **按关键链路补接口读写**： + 1. 真实人识别与上下文链路 + 2. 人群/额度/路由链路 + 3. 互动复检/风险链路 + 4. 评价提交/展示与退款比对链路 + 5. 免评结果链路 +3. **回到页面，把每一个点击绑定到明确的数据读写**。 + +--- + +## 32. 本版结论 + +v3 以 Codex v1.1 完整字段字典为主骨架，补入 v2 的流转时序表、写入顺序图和快照策略，形成最终统一主稿： + +1. 用 **真实人** 统一账号、订单、设备和风险 +2. 用 **画像快照** 解释人群生成 +3. 用 **额度台账+预占** 保护 4/4/12 规则（跨账号合并） +4. 用 **路由决策+去重记录** 控制多渠道协同 +5. 用 **互动复检记录** 落实"每次有效互动都重判" +6. 用 **退款比对结果** 识别双重退款 +7. 用 **评价提交记录+展示核验** 拆开用户事实和平台结果 +8. 用 **免评计划→任务→内容→结果快照** 让 KOC/KOL 闭环完整进入 USER 系统 diff --git a/05_需求文档/README.md b/05_需求文档/README.md new file mode 100644 index 0000000..5ce580c --- /dev/null +++ b/05_需求文档/README.md @@ -0,0 +1,78 @@ +--- +type: requirement_inbox +tags: [需求文档, 需求收集, 知识库更新, Agent] +aliases: [需求文档目录, 需求收集目录, 需求入口] +source: manual +status: active +owner: 产品经理 / 业务主管 +updated: 2026-05 +--- + +# 需求文档 + +本目录用于集中存放后续持续补充的业务需求文档、业务规则文档、流程补充文档和需求变更文档。 + +## 使用方式 + +1. 所有新增需求文档优先放入本目录。 +2. 建议使用 `03_规范与模板/需求说明模板.md` 或 `03_规范与模板/业务规则与需求补充模板.md` 创建文档。 +3. 文档确认有效后，同步更新业务流程索引和 Agent 检索索引。 +4. Agent 回答具体业务需求时，应优先检索本目录。 + +## 推荐命名 + +```text +业务域_需求或规则名称_YYYYMMDD.md +``` + +示例： + +```text +采购_供应商准入规则_20260526.md +库存_出入库审批规则_20260526.md +销售_客户授信额度需求_20260526.md +``` + +## 文档状态 + +每个需求文档建议在 Frontmatter 中维护 `status`： + +| 状态 | 含义 | +|---|---| +| draft | 草稿，尚未确认 | +| reviewing | 评审中 | +| active | 已确认，可作为 Agent 回答依据 | +| deprecated | 已废弃，仅归档参考 | + +## 必填内容 + +每个需求文档至少包含： + +- 需求背景 +- 适用范围 +- 涉及角色 +- 业务规则 +- 业务流程 +- 异常处理 +- 权限要求 +- 验收口径 +- Agent 检索字段 +- 变更记录 + +## 索引维护 + +新增或修改需求文档后，需要同步更新： + +- `05_需求文档/需求文档索引.md` +- `01_业务流程/业务规则索引.md` +- `01_业务流程/业务对象字典.md` +- `04_Agent检索/关键词索引.md` +- `04_Agent检索/同义词表.md` +- `04_Agent检索/来源文件索引.md` + +## 验证流程 + +新增需求文档后，按 `04_Agent检索/知识库持续更新与验证流程.md` 执行验证，并将验证结果记录到： + +- `05_需求文档/需求文档索引.md` +- `01_业务流程/业务补充验证记录.md` diff --git a/05_需求文档/需求文档索引.md b/05_需求文档/需求文档索引.md new file mode 100644 index 0000000..4c6f304 --- /dev/null +++ b/05_需求文档/需求文档索引.md @@ -0,0 +1,39 @@ +--- +type: requirement_index +tags: [需求文档, 索引, Agent检索] +aliases: [需求索引, 需求文档清单, 需求清单] +source: manual +status: active +owner: 产品经理 / 业务主管 +updated: 2026-05 +--- + +# 需求文档索引 + +本文件记录 `05_需求文档/` 下所有正式需求文档，供人工维护和 Agent 检索定位。 + +## 需求文档清单 + +| 编号 | 业务域 | 需求/规则名称 | 文件 | 状态 | 负责人 | 更新时间 | 验证状态 | +|---|---|---|---|---|---|---|---| +| | | | | | | | 未验证 | + +## Agent 检索关键词 + +| 关键词/问法 | 标准术语 | 命中文件 | 答案要点 | +|---|---|---|---| +| | | | | + +## 维护规则 + +1. 新增需求文档后，必须在“需求文档清单”新增一行。 +2. 每个需求文档至少维护 3 个可检索问法。 +3. `状态=active` 的文档可作为 Agent 回答依据。 +4. `status=draft/reviewing` 的文档只能作为草稿参考，Agent 回答时需说明尚未确认。 +5. `status=deprecated` 的文档不得作为当前规则依据，只能说明历史背景。 + +## 验证记录摘要 + +| 日期 | 文件 | 验证问题数 | 通过数 | 失败数 | 结论 | +|---|---|---:|---:|---:|---| +| | | | | | | diff --git a/06_里程碑/README.md b/06_里程碑/README.md new file mode 100644 index 0000000..d1f3b8b --- /dev/null +++ b/06_里程碑/README.md @@ -0,0 +1,42 @@ +--- +type: milestone_home +tags: [里程碑, 项目管理, 知识库] +aliases: [里程碑入口, 项目里程碑] +source: manual +status: active +owner: 项目经理 +updated: 2026-05 +--- + +# 里程碑 + +本目录用于存放项目阶段计划、里程碑节点、阶段评审记录和上线节奏说明。 + +## 二级入口 + +- [[里程碑索引]] +- [[阶段计划模板]] +- [[里程碑评审记录]] + +## 存放内容 + +- 项目启动节点 +- 需求评审节点 +- 原型/高保真确认节点 +- 开发启动节点 +- 测试准入节点 +- 上线检查节点 +- 复盘回流节点 + +## 命名建议 + +```text +项目名_里程碑计划_YYYYMMDD.md +项目名_阶段评审记录_YYYYMMDD.md +``` + +## 关联目录 + +- 需求依据：[[../05_需求文档/README|需求文档]] +- 流程依据：[[../02_项目管理流程/AI驱动内部系统开发流程_V3_总览|项目管理流程]] +- 测试准入：[[../08_测试相关/README|测试相关]] diff --git a/06_里程碑/里程碑索引.md b/06_里程碑/里程碑索引.md new file mode 100644 index 0000000..2b29ff5 --- /dev/null +++ b/06_里程碑/里程碑索引.md @@ -0,0 +1,29 @@ +--- +type: milestone_index +tags: [里程碑, 索引, Agent检索] +aliases: [里程碑清单, 项目节点索引] +source: manual +status: active +owner: 项目经理 +updated: 2026-05 +--- + +# 里程碑索引 + +## 里程碑文档清单 + +| 项目 | 里程碑名称 | 文件 | 阶段 | 负责人 | 计划时间 | 当前状态 | +|---|---|---|---|---|---|---| +| | | | | | | | + +## Agent 检索关键词 + +| 问法 | 标准术语 | 命中文件 | 答案要点 | +|---|---|---|---| +| | | | | + +## 维护规则 + +- 新增里程碑计划后，在本索引登记。 +- 每个里程碑应关联至少一个需求文档或项目管理阶段。 +- Agent 回答项目进度、节点、准入问题时，应引用本索引或具体里程碑文件。 diff --git a/06_里程碑/里程碑评审记录.md b/06_里程碑/里程碑评审记录.md new file mode 100644 index 0000000..2ee6c59 --- /dev/null +++ b/06_里程碑/里程碑评审记录.md @@ -0,0 +1,15 @@ +--- +type: milestone_review_log +tags: [里程碑, 评审, 记录] +aliases: [阶段评审记录, 里程碑评审] +source: manual +status: active +owner: 项目经理 +updated: 2026-05 +--- + +# 里程碑评审记录 + +| 日期 | 项目 | 阶段 | 评审结论 | 遗留问题 | 负责人 | 后续动作 | +|---|---|---|---|---|---|---| +| | | | | | | | diff --git a/06_里程碑/阶段计划模板.md b/06_里程碑/阶段计划模板.md new file mode 100644 index 0000000..82214f3 --- /dev/null +++ b/06_里程碑/阶段计划模板.md @@ -0,0 +1,53 @@ +--- +type: milestone_template +tags: [里程碑, 阶段计划, 模板] +aliases: [阶段计划, 里程碑模板] +source: manual +status: active +owner: 项目经理 +updated: 2026-05 +--- + +# 阶段计划模板 + +## 基本信息 + +| 项目 | 内容 | +|---|---| +| 项目名称 | | +| 关联需求 | | +| 当前阶段 | | +| 负责人 | | +| 计划开始 | | +| 计划结束 | | + +## 阶段目标 + + +## 输入材料 + +- 需求文档： +- 业务流程： +- 技术文档： +- 测试材料： + +## 关键任务 + +| 任务 | 负责人 | 截止时间 | 输出物 | 状态 | +|---|---|---|---|---| +| | | | | | + +## 阶段交付物 + + +## 准入/准出条件 + + +## 风险与阻塞 + + +## Agent 检索字段 + +- 关键词： +- 同义词： +- 典型问法： diff --git a/07_技术文档/README.md b/07_技术文档/README.md new file mode 100644 index 0000000..a824f9b --- /dev/null +++ b/07_技术文档/README.md @@ -0,0 +1,44 @@ +--- +type: technical_docs_home +tags: [技术文档, 架构, 开发, 知识库] +aliases: [技术文档入口, 技术资料] +source: manual +status: active +owner: 技术负责人 +updated: 2026-05 +--- + +# 技术文档 + +本目录用于存放系统架构、数据模型、接口说明、实现方案、部署说明和技术决策记录。 + +## 二级入口 + +- [[技术文档索引]] +- [[系统架构说明模板]] +- [[接口说明模板]] +- [[技术决策记录]] + +## 存放内容 + +- 系统架构说明 +- 模块设计说明 +- 数据表/业务对象设计 +- API 接口说明 +- 权限与安全设计 +- 部署与配置说明 +- 技术决策记录 + +## 命名建议 + +```text +系统或模块_技术方案_YYYYMMDD.md +系统或模块_接口说明_YYYYMMDD.md +系统或模块_数据模型_YYYYMMDD.md +``` + +## 关联目录 + +- 需求依据：[[../05_需求文档/README|需求文档]] +- 测试依据：[[../08_测试相关/README|测试相关]] +- 里程碑：[[../06_里程碑/README|里程碑]] diff --git a/07_技术文档/技术决策记录.md b/07_技术文档/技术决策记录.md new file mode 100644 index 0000000..cc763fd --- /dev/null +++ b/07_技术文档/技术决策记录.md @@ -0,0 +1,15 @@ +--- +type: adr_log +tags: [技术文档, 技术决策, ADR] +aliases: [技术决策, ADR] +source: manual +status: active +owner: 技术负责人 +updated: 2026-05 +--- + +# 技术决策记录 + +| 日期 | 决策主题 | 背景 | 决策结论 | 影响范围 | 关联需求/技术文档 | +|---|---|---|---|---|---| +| | | | | | | diff --git a/07_技术文档/技术文档索引.md b/07_技术文档/技术文档索引.md new file mode 100644 index 0000000..10bbd6d --- /dev/null +++ b/07_技术文档/技术文档索引.md @@ -0,0 +1,29 @@ +--- +type: technical_docs_index +tags: [技术文档, 索引, Agent检索] +aliases: [技术索引, 技术资料清单] +source: manual +status: active +owner: 技术负责人 +updated: 2026-05 +--- + +# 技术文档索引 + +## 技术文档清单 + +| 模块/系统 | 文档类型 | 文件 | 关联需求 | 负责人 | 更新时间 | 状态 | +|---|---|---|---|---|---|---| +| | | | | | | | + +## Agent 检索关键词 + +| 问法 | 标准术语 | 命中文件 | 答案要点 | +|---|---|---|---| +| | | | | + +## 维护规则 + +- 新增技术方案、接口说明、数据模型后，在本索引登记。 +- 技术文档必须关联需求文档或业务流程。 +- Agent 回答技术实现、接口、数据结构问题时，应优先检索本目录。 diff --git a/07_技术文档/接口说明模板.md b/07_技术文档/接口说明模板.md new file mode 100644 index 0000000..ff18e99 --- /dev/null +++ b/07_技术文档/接口说明模板.md @@ -0,0 +1,51 @@ +--- +type: api_template +tags: [技术文档, 接口, 模板] +aliases: [接口模板, API说明模板] +source: manual +status: active +owner: 技术负责人 +updated: 2026-05 +--- + +# 接口说明模板 + +## 基本信息 + +| 项目 | 内容 | +|---|---| +| 接口名称 | | +| 所属模块 | | +| 关联需求 | | +| 负责人 | | +| 状态 | draft | + +## 接口用途 + + +## 请求说明 + +| 字段 | 类型 | 必填 | 说明 | 示例 | +|---|---|---|---|---| +| | | | | | + +## 响应说明 + +| 字段 | 类型 | 说明 | 示例 | +|---|---|---|---| +| | | | | + +## 业务规则 + + +## 异常码 + +| 异常码 | 含义 | 处理方式 | +|---|---|---| +| | | | + +## Agent 检索字段 + +- 关键词： +- 同义词： +- 典型问法： diff --git a/07_技术文档/系统架构说明模板.md b/07_技术文档/系统架构说明模板.md new file mode 100644 index 0000000..a170729 --- /dev/null +++ b/07_技术文档/系统架构说明模板.md @@ -0,0 +1,53 @@ +--- +type: architecture_template +tags: [技术文档, 架构, 模板] +aliases: [架构说明模板] +source: manual +status: active +owner: 技术负责人 +updated: 2026-05 +--- + +# 系统架构说明模板 + +## 基本信息 + +| 项目 | 内容 | +|---|---| +| 系统/模块 | | +| 关联需求 | | +| 负责人 | | +| 状态 | draft | + +## 背景与目标 + + +## 架构说明 + + +## 模块划分 + +| 模块 | 职责 | 输入 | 输出 | 依赖 | +|---|---|---|---|---| +| | | | | | + +## 数据模型 + + +## 接口关系 + + +## 权限与安全 + + +## 异常与边界 + + +## 部署与配置 + + +## Agent 检索字段 + +- 关键词： +- 同义词： +- 典型问法： diff --git a/08_测试相关/README.md b/08_测试相关/README.md new file mode 100644 index 0000000..7895784 --- /dev/null +++ b/08_测试相关/README.md @@ -0,0 +1,48 @@ +--- +type: testing_home +tags: [测试, 测试用例, 验收, 知识库] +aliases: [测试相关入口, 测试文档] +source: manual +status: active +owner: 测试负责人 +updated: 2026-05 +--- + +# 测试相关 + +本目录用于存放测试计划、测试用例、测试报告、缺陷记录、验收记录和上线检查材料。 + +## 二级入口 + +- [[测试用例索引]] +- [[测试用例模板]] +- [[测试计划模板]] +- [[缺陷记录模板]] +- [[验收记录模板]] +- [[上线检查模板]] + +## 存放内容 + +- 测试计划 +- 测试用例 +- 测试执行记录 +- 缺陷记录 +- 验收记录 +- 上线检查记录 +- 回归测试说明 + +## 命名建议 + +```text +项目或模块_测试用例_YYYYMMDD.md +项目或模块_测试计划_YYYYMMDD.md +项目或模块_缺陷记录_YYYYMMDD.md +项目或模块_验收记录_YYYYMMDD.md +``` + +## 关联目录 + +- 需求依据：[[../05_需求文档/README|需求文档]] +- 技术依据：[[../07_技术文档/README|技术文档]] +- 里程碑依据：[[../06_里程碑/README|里程碑]] +- 流程依据：[[../02_项目管理流程/阶段2.5_测试提前补漏|阶段2.5 测试提前补漏]]、[[../02_项目管理流程/阶段4_测试培训上线回流|阶段4 测试培训上线回流]] diff --git a/08_测试相关/上线检查模板.md b/08_测试相关/上线检查模板.md new file mode 100644 index 0000000..37431c1 --- /dev/null +++ b/08_测试相关/上线检查模板.md @@ -0,0 +1,44 @@ +--- +type: go_live_checklist_template +tags: [上线检查, 测试, 模板] +aliases: [上线检查, 发布检查] +source: manual +status: active +owner: 测试负责人 / 项目经理 +updated: 2026-05 +--- + +# 上线检查模板 + +## 基本信息 + +| 项目 | 内容 | +|---|---| +| 项目/模块 | | +| 关联需求 | | +| 关联里程碑 | | +| 负责人 | | +| 检查日期 | | + +## 上线前检查项 + +| 检查项 | 负责人 | 结果 | 备注 | +|---|---|---|---| +| 需求已确认 | | | | +| 测试用例已执行 | | | | +| P0/P1 缺陷已关闭 | | | | +| 用户培训已完成 | | | | +| 回滚方案已确认 | | | | +| 数据备份已确认 | | | | + +## 上线结论 + + +## 回滚条件 + + +## Agent 检索字段 + +- 关键词： +- 同义词： +- 典型问法： diff --git a/08_测试相关/测试用例模板.md b/08_测试相关/测试用例模板.md new file mode 100644 index 0000000..17afc1f --- /dev/null +++ b/08_测试相关/测试用例模板.md @@ -0,0 +1,45 @@ +--- +type: test_case_template +tags: [测试用例, 测试, 模板] +aliases: [用例模板, 测试用例] +source: manual +status: active +owner: 测试负责人 +updated: 2026-05 +--- + +# 测试用例模板 + +## 基本信息 + +| 项目 | 内容 | +|---|---| +| 项目/模块 | | +| 关联需求 | | +| 关联技术文档 | | +| 测试负责人 | | +| 状态 | draft | + +## 测试范围 + + +## 前置条件 + + +## 测试用例 + +| 用例编号 | 场景 | 前置条件 | 操作步骤 | 预期结果 | 优先级 | 状态 | +|---|---|---|---|---|---|---| +| TC-001 | | | | | P1 | 未执行 | + +## 边界与异常场景 + + +## 验收口径 + + +## Agent 检索字段 + +- 关键词： +- 同义词： +- 典型问法： diff --git a/08_测试相关/测试用例索引.md b/08_测试相关/测试用例索引.md new file mode 100644 index 0000000..3aa09a8 --- /dev/null +++ b/08_测试相关/测试用例索引.md @@ -0,0 +1,30 @@ +--- +type: test_case_index +tags: [测试用例, 测试, 索引, Agent检索] +aliases: [测试用例清单, 用例索引] +source: manual +status: active +owner: 测试负责人 +updated: 2026-05 +--- + +# 测试用例索引 + +## 测试用例清单 + +| 编号 | 项目/模块 | 用例集名称 | 文件 | 关联需求 | 关联技术文档 | 负责人 | 状态 | 更新时间 | +|---|---|---|---|---|---|---|---|---| +| | | | | | | | 未验证 | | + +## Agent 检索关键词 + +| 问法 | 标准术语 | 命中文件 | 答案要点 | +|---|---|---|---| +| | | | | + +## 维护规则 + +- 新增测试用例后，必须在本索引登记。 +- 每个测试用例文件必须关联至少一个需求文档。 +- 若测试用例依赖接口、数据模型或技术方案，应关联技术文档。 +- Agent 回答测试范围、验收口径、缺陷复现问题时，应优先检索本目录。 diff --git a/08_测试相关/测试计划模板.md b/08_测试相关/测试计划模板.md new file mode 100644 index 0000000..dfe056f --- /dev/null +++ b/08_测试相关/测试计划模板.md @@ -0,0 +1,54 @@ +--- +type: test_plan_template +tags: [测试计划, 测试, 模板] +aliases: [测试计划模板] +source: manual +status: active +owner: 测试负责人 +updated: 2026-05 +--- + +# 测试计划模板 + +## 基本信息 + +| 项目 | 内容 | +|---|---| +| 项目/模块 | | +| 关联需求 | | +| 关联里程碑 | | +| 测试负责人 | | +| 计划周期 | | + +## 测试目标 + + +## 测试范围 + + +## 不在范围内 + + +## 测试资源 + + +## 测试安排 + +| 阶段 | 时间 | 负责人 | 输出物 | +|---|---|---|---| +| | | | | + +## 准入条件 + + +## 准出条件 + + +## 风险 + + +## Agent 检索字段 + +- 关键词： +- 同义词： +- 典型问法： diff --git a/08_测试相关/缺陷记录模板.md b/08_测试相关/缺陷记录模板.md new file mode 100644 index 0000000..fe5a795 --- /dev/null +++ b/08_测试相关/缺陷记录模板.md @@ -0,0 +1,53 @@ +--- +type: defect_template +tags: [缺陷, 测试, 模板] +aliases: [Bug记录模板, 缺陷记录] +source: manual +status: active +owner: 测试负责人 +updated: 2026-05 +--- + +# 缺陷记录模板 + +## 基本信息 + +| 项目 | 内容 | +|---|---| +| 缺陷编号 | BUG- | +| 项目/模块 | | +| 关联需求 | | +| 关联用例 | | +| 严重级别 | | +| 当前状态 | open | +| 负责人 | | + +## 问题描述 + + +## 复现步骤 + +1. +2. +3. + +## 实际结果 + + +## 预期结果 + + +## 影响范围 + + +## 修复结论 + + +## 回归验证 + + +## Agent 检索字段 + +- 关键词： +- 同义词： +- 典型问法： diff --git a/08_测试相关/验收记录模板.md b/08_测试相关/验收记录模板.md new file mode 100644 index 0000000..7e0a7fe --- /dev/null +++ b/08_测试相关/验收记录模板.md @@ -0,0 +1,43 @@ +--- +type: acceptance_template +tags: [验收, 测试, 模板] +aliases: [验收记录, UAT模板] +source: manual +status: active +owner: 测试负责人 / 业务负责人 +updated: 2026-05 +--- + +# 验收记录模板 + +## 基本信息 + +| 项目 | 内容 | +|---|---| +| 项目/模块 | | +| 关联需求 | | +| 关联测试用例 | | +| 验收负责人 | | +| 验收日期 | | +| 验收结论 | | + +## 验收范围 + + +## 验收结果 + +| 验收项 | 预期结果 | 实际结果 | 结论 | 备注 | +|---|---|---|---|---| +| | | | | | + +## 遗留问题 + + +## 上线建议 + + +## Agent 检索字段 + +- 关键词： +- 同义词： +- 典型问法： diff --git a/20260517_USER评价业务闭环_共用能力图与渠道专属流程_v2.2.md b/20260517_USER评价业务闭环_共用能力图与渠道专属流程_v2.2.md new file mode 100644 index 0000000..e69de29 diff --git a/Git使用说明.md b/Git使用说明.md new file mode 100644 index 0000000..5edd798 --- /dev/null +++ b/Git使用说明.md @@ -0,0 +1,360 @@ +--- +type: git_guide +tags: [Git, 版本管理, 知识库, 使用说明] +aliases: [Git说明, 仓库使用说明, 知识库提交说明] +source: manual +status: active +owner: 内部技术团队 +updated: 2026-05 +--- + +# Git 使用说明 + +本文档说明如愿知识库的 Git 仓库地址、目录结构、日常提交流程、多人协作规则和 Obsidian 图谱注意事项。 + +## 1. 仓库信息 + +远程仓库地址： + +```bash +https://wdxz-gitea.best-envision.com/qiaoxinjiu/Fulfilled-Knowledge.git +``` + +本地知识库目录： + +```text +D:\AIcoding\WishFulfilled\知识库\如愿知识库 +``` + +推荐使用 Obsidian 打开该目录作为 Vault。 + +## 2. 知识库主目录说明 + +```text +如愿知识库/ +├─ 00_首页/ # 知识库入口、知识地图、Agent 问答入口 +├─ 01_业务流程/ # 业务流程、业务对象、业务规则、补充验证记录 +├─ 02_项目管理流程/ # 项目阶段、角色职责、交付物、检查清单、FAQ +├─ 03_规范与模板/ # 需求、业务规则、会议、上线检查等模板 +├─ 04_Agent检索/ # 检索说明、关键词、同义词、来源文件索引 +├─ 05_需求文档/ # 正式需求文档、需求索引 +├─ 06_里程碑/ # 里程碑计划、阶段计划、评审记录 +├─ 07_技术文档/ # 技术方案、架构、接口、技术决策 +├─ 08_测试相关/ # 测试用例、测试计划、缺陷、验收、上线检查 +├─ 99_归档/ # 废弃或历史参考内容 +├─ 欢迎.md # Obsidian 入口 +└─ Git使用说明.md # 本文档 +``` + +## 3. 推荐阅读入口 + +首次使用时建议按以下顺序阅读： + +1. `欢迎.md` +2. `00_首页/知识库首页.md` +3. `00_首页/知识地图.md` +4. `00_首页/Agent问答入口.md` +5. `04_Agent检索/检索说明.md` +6. `04_Agent检索/来源文件索引.md` + +## 4. Agent 检索优先级 + +Agent 回答问题时，建议按以下顺序检索： + +1. `05_需求文档/`：正式需求、业务规则、需求变更。 +2. `06_里程碑/`：阶段节点、项目计划、评审记录。 +3. `07_技术文档/`：架构、接口、实现方案、技术决策。 +4. `08_测试相关/`：测试用例、测试计划、缺陷、验收、上线检查。 +5. `02_项目管理流程/`：项目阶段、角色、交付物、门禁、检查清单。 +6. `01_业务流程/`：业务流程、业务对象、业务规则。 +7. `04_Agent检索/`：关键词、同义词、来源索引、回答规则。 +8. `03_规范与模板/`：需要产出模板或文档时使用。 + +回答业务问题时，必须注明来源文件。 + +## 5. 新增文档规则 + +### 5.1 新增需求文档 + +放入目录： + +```text +05_需求文档/ +``` + +推荐命名： + +```text +业务域_需求或规则名称_YYYYMMDD.md +``` + +新增后同步维护： + +- `05_需求文档/需求文档索引.md` +- `01_业务流程/业务规则索引.md` +- `01_业务流程/业务对象字典.md` +- `04_Agent检索/关键词索引.md` +- `04_Agent检索/同义词表.md` +- `04_Agent检索/来源文件索引.md` + +### 5.2 新增里程碑文档 + +放入目录： + +```text +06_里程碑/ +``` + +推荐命名： + +```text +项目名_里程碑计划_YYYYMMDD.md +项目名_阶段评审记录_YYYYMMDD.md +``` + +新增后同步维护： + +- `06_里程碑/里程碑索引.md` +- `00_首页/知识地图.md`，如需新增主入口或二级入口。 + +### 5.3 新增技术文档 + +放入目录： + +```text +07_技术文档/ +``` + +推荐命名： + +```text +系统或模块_技术方案_YYYYMMDD.md +系统或模块_接口说明_YYYYMMDD.md +系统或模块_数据模型_YYYYMMDD.md +``` + +新增后同步维护： + +- `07_技术文档/技术文档索引.md` +- `04_Agent检索/关键词索引.md` +- `04_Agent检索/来源文件索引.md` + +### 5.4 新增测试用例 + +放入目录： + +```text +08_测试相关/ +``` + +推荐命名： + +```text +项目名_模块名_测试用例_YYYYMMDD.md +项目名_模块名_测试计划_YYYYMMDD.md +项目名_模块名_缺陷记录_YYYYMMDD.md +``` + +新增后同步维护： + +- `08_测试相关/测试用例索引.md` +- `08_测试相关/测试计划模板.md`，如计划结构发生变化。 +- `08_测试相关/缺陷记录模板.md`，如缺陷字段发生变化。 + +## 6. Obsidian 图谱说明 + +Obsidian 图谱会显示两类节点： + +1. 已存在的 Markdown 文件。 +2. 文档中链接到、但本地还不存在的 Markdown 文件。 + +例如文档中存在： + +```markdown +[工作基线 v1.2](20260517_USER评价业务闭环主流程与后续工作基线_v1.2.md) +``` + +即使该文件还没有放入目录，Obsidian 图谱也可能显示这个节点。这是“未创建链接 / dangling link”，不是目录里真的多了文件。 + +如果只想显示真实存在的文件，可以在 Obsidian 图谱里开启： + +```text +图谱视图 → 筛选 → 仅显示已有文件 +``` + +如果希望知识链路完整，应把被引用的上游文档也补充到对应目录。 + +## 7. 首次拉取仓库 + +在目标目录执行： + +```bash +git clone https://wdxz-gitea.best-envision.com/qiaoxinjiu/Fulfilled-Knowledge.git +``` + +然后用 Obsidian 打开克隆出的目录。 + +## 8. 日常更新流程 + +### 8.1 拉取最新内容 + +开始编辑前先拉取远程更新： + +```bash +git pull origin master +``` + +如果主分支后续改名为 `main`，则使用： + +```bash +git pull origin main +``` + +### 8.2 查看变更 + +```bash +git status +``` + +### 8.3 暂存变更 + +提交全部变更： + +```bash +git add . +``` + +只提交指定文件： + +```bash +git add 05_需求文档/需求文档索引.md +``` + +### 8.4 提交变更 + +提交信息建议包含动作和范围： + +```bash +git commit -m "docs: 更新需求文档索引" +``` + +常用提交前缀： + +| 前缀 | 用途 | +|---|---| +| `docs:` | 文档新增或修改 | +| `chore:` | 目录、配置、维护性调整 | +| `fix:` | 修正文档错误、链接错误 | +| `refactor:` | 调整结构但不改变内容含义 | +| `archive:` | 归档历史内容 | + +### 8.5 推送到远程 + +```bash +git push origin master +``` + +如果主分支为 `main`，则使用： + +```bash +git push origin main +``` + +## 9. 推荐的完整提交流程 + +```bash +git pull origin master +git status +git add . +git commit -m "docs: 更新如愿知识库" +git push origin master +``` + +## 10. 冲突处理原则 + +多人同时修改同一个文档时，可能出现冲突。 + +处理原则： + +1. 不要直接覆盖别人内容。 +2. 先阅读冲突区块。 +3. 保留双方有效内容。 +4. 删除 Git 冲突标记。 +5. 再执行提交。 + +冲突标记示例： + +```text +<<<<<<< HEAD +本地内容 +======= +远程内容 +>>>>>>> origin/master +``` + +处理完成后： + +```bash +git add 冲突文件.md +git commit -m "fix: 解决知识库文档冲突" +git push origin master +``` + +## 11. 不建议提交的内容 + +一般不建议提交： + +- 临时截图。 +- 临时导出文件。 +- 个人草稿。 +- 含账号、密码、Token、密钥的文件。 +- 含客户隐私或敏感原文的未脱敏文件。 + +如需沉淀敏感业务规则，应先脱敏，再放入知识库。 + +## 12. 提交前检查清单 + +提交前确认： + +- [ ] 新文档放在正确目录。 +- [ ] 文件名清晰，能表达业务域和用途。 +- [ ] 重要文档已写 Frontmatter。 +- [ ] 新增需求已维护 `05_需求文档/需求文档索引.md`。 +- [ ] 新增测试用例已维护 `08_测试相关/测试用例索引.md`。 +- [ ] 新增技术文档已维护 `07_技术文档/技术文档索引.md`。 +- [ ] 需要 Agent 检索的关键词已同步到 `04_Agent检索/关键词索引.md`。 +- [ ] 链接能正常跳转，或确认它是故意保留的上游虚链接。 +- [ ] 不包含密码、Token、密钥和未脱敏敏感数据。 + +## 13. 常见问题 + +### 13.1 为什么我只放了一个文档，图谱里出现多个节点？ + +因为文档中引用了其他 Markdown 文件。Obsidian 会把被链接但尚未创建的文件也显示为节点。 + +解决方式： + +- 图谱开启“仅显示已有文件”。 +- 或补齐被引用的上游文档。 + +### 13.2 README.md 为什么也会出现在图谱里？ + +因为 README.md 也是 Markdown 文件，Obsidian 会把它作为普通节点显示。 + +### 13.3 删除文件后图谱还有节点怎么办？ + +检查是否仍有其他文档链接到该文件。只要有链接，图谱仍可能显示虚节点。 + +### 13.4 Agent 回答问题应该依赖哪个目录？ + +优先依赖 `05_需求文档/`，其次是 `06_里程碑/`、`07_技术文档/`、`08_测试相关/`，再查流程、业务和检索规则目录。 + +## 14. 维护原则 + +1. 知识库不是文件堆积，而是可检索、可追溯、可回答的知识网络。 +2. 正式需求必须有索引。 +3. 关键业务规则必须有来源。 +4. 测试用例必须能追溯到需求。 +5. 技术文档必须能追溯到需求或业务流程。 +6. 里程碑必须能追溯到阶段目标和交付物。 +7. Agent 回答必须说明来源文件。 diff --git a/未命名.canvas b/未命名.canvas new file mode 100644 index 0000000..9e26dfe --- /dev/null +++ b/未命名.canvas @@ -0,0 +1 @@ +{} \ No newline at end of file diff --git a/欢迎.md b/欢迎.md new file mode 100644 index 0000000..479fc72 --- /dev/null +++ b/欢迎.md @@ -0,0 +1,23 @@ +--- +type: index +tags: [知识库, 入口] +aliases: [欢迎, 首页] +source: manual +status: active +owner: 内部技术团队 +updated: 2026-05 +--- + +# 欢迎使用如愿知识库 + +请从 [[00_首页/知识库首页]] 开始。 + +常用入口： + +- [[00_首页/知识地图]] +- [[00_首页/Agent问答入口]] +- [[05_需求文档/README|需求文档]] +- [[06_里程碑/README|里程碑]] +- [[07_技术文档/README|技术文档]] +- [[08_测试相关/README|测试相关]] +- [[04_Agent检索/检索说明]] \ No newline at end of file