83 lines
6.3 KiB
Markdown
83 lines
6.3 KiB
Markdown
# 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/` 后更新本索引。 |
|
||
|
||
---
|
||
|
||
## 三、使用规则重申
|
||
|
||
1. **当前项目证据优先级**：`CODE-001/002`（代码）→ 新生成的 CodeMap/DomainMap（建议路径 `assets/zentao/`）→ `SRC-*` 用户资料
|
||
2. **索引同步**：新增/删除重要资源时，必须同步更新本文件（CLAUDE.md §5.4）
|
||
3. **证据缺口**：当前项目尚无 CodeMap/DomainMap/Runtime 证据，生成 PRD/FRD 前需先补齐或显式标记 `[ASSUMPTION]`
|
||
4. **红线**：旧项目（fly-home-flow）资产已全部删除，若在任何角落发现其残留引用，禁止作为当前项目证据，并应报告清理
|
||
|
||
---
|
||
|
||
## 四、证据缺口清单（Check 阶段）
|
||
|
||
| 缺口 | 影响 | 下一步 |
|
||
|------|------|--------|
|
||
| ~~当前项目无 CodeMap~~ ✅ 已补齐（L1） | L1 仅索引，无 API/调用链/公式详情 | 按需升级 L2-L4 增量生成 |
|
||
| ~~当前项目无 DomainMap~~ ✅ 已补齐（D1） | D1 仅索引，无运行态采集与页面流程 | 按需升级 D2-D4 增量生成 |
|
||
| 当前项目无 Runtime 截图 | 无法验证运行态行为（菜单树、真实页面字段） | 通过 chrome-devtools MCP 采集并存入 `materials/` |
|