6.3 KiB
6.3 KiB
materials_index.md — PM Workspace 资料资产索引
生成日期：2026-10-08 | 维护规则：新增重要资源时必须同步更新本文件（CLAUDE.md §5.4） 当前项目：禅道（ZenTao）相关 —
codes/zentao、codes/web_zentao变更记录：2026-10-08 旧项目（fly-home-flow / Unicompay / 日日顺）残留资产已全部清理，本索引同步移除 LEGACY 段落；清理详情见.claude/memory/project_memory.md变更记录：2026-10-08 生成当前项目 CodeMap（L1）与 DomainMap（D1），位于assets/zentao/
一、当前项目资产（✅ 可用于证据引用）
1.1 代码资产
| 资料ID | 名称 | 路径 | 类型 | 简要说明 | 推荐场景 | 阅读深度 |
|---|---|---|---|---|---|---|
| CODE-001 | zentao 后端代码 | codes/zentao/ |
源代码 | 禅道后端源码（当前项目主代码库） | What / How | 按需定位 |
| CODE-002 | web_zentao 前端代码 | codes/web_zentao/ |
源代码 | 禅道前端源码 | What / How | 按需定位 |
注：当前项目尚无已生成的 CodeMap / DomainMap 资产。 若后续需要生成 PRD/FRD 并引用证据，建议先对
codes/zentao、codes/web_zentao运行 codemap / domainmap 技能生成新的资产到独立目录（如assets/zentao/codemap/）。
1.2 知识图谱资产（CodeMap / DomainMap）
| 资料ID | 名称 | 路径 | 类型 | 简要说明 | 推荐场景 | 阅读深度 |
|---|---|---|---|---|---|---|
| CODEMAP-001 | 项目主索引 | assets/zentao/codemap/_index.yaml |
CodeMap | 禅道项目整体索引：双平台统计、模块分布 | What | 仅定位 |
| CODEMAP-002 | 项目上下文 | assets/zentao/codemap/context/_project_context.yaml |
CodeMap | 项目定位、核心角色、11 大业务模块、实体清单 | What / Why | 精读 |
| CODEMAP-003 | 技术栈 | assets/zentao/codemap/context/_tech_stack.yaml |
CodeMap | 后端 SpringBoot3.3+Java17+MyBatisPlus / 前端 Vue2+ElementUI+Electron | How | 精读 |
| CODEMAP-004 | Java 符号索引 | assets/zentao/codemap/symbols/java/_symbols_index.yaml |
CodeMap | 70 Controller/143 Service/70 Entity/69 Mapper 按 11 模块归类 | How | 精读 |
| CODEMAP-005 | Vue 符号索引 | assets/zentao/codemap/symbols/vue/_symbols_index.yaml |
CodeMap | 446 视图、7 路由模块、30 API 模块、话务组件族 | How | 精读 |
| DOMAINMAP-001 | 领域主索引 | assets/zentao/domainmap/_index.yaml |
DomainMap | 领域统计与章节导航 | What | 仅定位 |
| DOMAINMAP-002 | 实体索引 | assets/zentao/domainmap/entities/_entities_index.yaml |
DomainMap | 70 实体按 11 域归类（含禅道 zt_* 表映射） | What / How | 精读 |
| DOMAINMAP-003 | 流程索引 | assets/zentao/domainmap/processes/_processes_index.yaml |
DomainMap | 9 大业务流程（需求/任务/Bug/测试/发布/看板/绩效/运维/权限） | Why / How | 精读 |
| DOMAINMAP-004 | 规则索引 | assets/zentao/domainmap/rules/_rules_index.yaml |
DomainMap | 12 规则集，含用户故事 14 态、任务 7 态、Bug 3 类等真实状态机取值 | How / Check | 精读 |
| DOMAINMAP-005 | 术语表 | assets/zentao/domainmap/glossary/_glossary_index.yaml |
DomainMap | 40 条业务术语（禅道概念 + 二开扩展） | What | 掠读 |
⚠️ 两份图谱均为 L1/D1 快速扫描级（仅索引，无详情文件）。 证据引用格式：
[CODEMAP:assets/zentao/codemap/...]、[DOMAINMAP:assets/zentao/domainmap/...]
1.3 用户资料 / 文档
| 资料ID | 名称 | 路径 | 类型 | 简要说明 | 推荐场景 | 阅读深度 |
|---|---|---|---|---|---|---|
| SRC-001 | AI下的开发SOP流程（新版） | docs/AI下的开发SOP流程（新版）.pdf |
用户资料 | AI 协作开发 SOP 流程说明文档 | What / Why | 精读 |
| SRC-002 | 信息技术部绩效考核标准 | docs/信息技术部绩效考核标准-新版 - AI下的考核方案.xlsx |
用户资料 | AI 下的绩效考核方案表格 | Why | 掠读 |
1.4 PRD 会话工作区（进行中 / 已完成）
| 资料ID | 名称 | 路径 | 类型 | 简要说明 | 推荐场景 | 阅读深度 |
|---|---|---|---|---|---|---|
| SESSION-001 | ai-sop PRD 会话 | prds/ai-sop-20260723-1024/ |
PRD工作区 | 「AI下的开发SOP」PRD 会话（含 prd.md、decision_log、questions、materials 等完整结构） | What / Why / How | 精读 |
| SESSION-002 | ai-sop tgassist 归档工作区 | workspace/specs/ai-sop-20260723-1024/ |
SpecWorkspace | 上述 PRD 的回溯归档（tgassist 结构 34 文件）：00_meta 门禁档案 + 01_input 冻结基线 + 04_design + 07_council 决策留痕 | Check / 追溯 | 精读 |
| SRC-003 | 禅道AI通道接口文档 v1.0 | prds/ai-sop-20260723-1024/materials/禅道AI通道接口文档_v1.0.docx |
用户资料 | 禅道 AI 通道接口定义（.docx） | How | 精读 |
SESSION-001 内部已自带会话级
materials_index.md，处理该需求时优先读会话内索引。
二、Runtime 证据
| 状态 | 说明 |
|---|---|
| ❌ 暂无 | 本 Workspace 尚无 materials/ 运行时截图/接口证据存档。需要时通过 chrome-devtools MCP 采集并存入 materials/ 后更新本索引。 |
三、使用规则重申
- 当前项目证据优先级：
CODE-001/002（代码）→ 新生成的 CodeMap/DomainMap（建议路径assets/zentao/）→SRC-*用户资料 - 索引同步：新增/删除重要资源时，必须同步更新本文件（CLAUDE.md §5.4）
- 证据缺口：当前项目尚无 CodeMap/DomainMap/Runtime 证据，生成 PRD/FRD 前需先补齐或显式标记
[ASSUMPTION] - 红线：旧项目（fly-home-flow）资产已全部删除，若在任何角落发现其残留引用，禁止作为当前项目证据，并应报告清理
四、证据缺口清单（Check 阶段）
| 缺口 | 影响 | 下一步 |
|---|---|---|
| L1 仅索引，无 API/调用链/公式详情 | 按需升级 L2-L4 增量生成 | |
| D1 仅索引，无运行态采集与页面流程 | 按需升级 D2-D4 增量生成 | |
| 当前项目无 Runtime 截图 | 无法验证运行态行为（菜单树、真实页面字段） | 通过 chrome-devtools MCP 采集并存入 materials/ |