105 lines
4.2 KiB
Markdown
105 lines
4.2 KiB
Markdown
# 术语表
|
||
|
||
按字母/拼音首字母排序。同一术语只在系统的一个语境里有定义，避免歧义。
|
||
|
||
## A
|
||
|
||
### Agent
|
||
本系统中指 AI 代理 — 自主完成某项分析/拆解工作的 LLM 调用单元，输出**草案**而非最终数据。所有 Agent 定义见 `agent-spec.md`。
|
||
|
||
### AI 草案 (AI Draft)
|
||
由 Agent 生成、未经用户确认的实体，带 `aiDraft: true` 标记。视觉上在列表里有紫色左边线和「AI 草案」徽章。用户编辑保存后标记自动清除。
|
||
|
||
### Assignee
|
||
任务负责人。在 DevTask / TestCase / Bug 中表示当前承接此任务/用例/缺陷的人员名（不是用户 ID，是 `member.name`）。
|
||
|
||
## B
|
||
|
||
### Bug
|
||
缺陷实体。直接挂在版本上（`versionId` 必填），可追溯到 TestCase（`testCaseId` 可选）。状态机：`open → fixing → fixed → verifying → closed/rejected`。
|
||
|
||
## C
|
||
|
||
### CapsuleStages
|
||
版本详情页的胶囊式阶段进度条组件。展示调研 → 产品方案 → UI → 开发 → 测试 → 已发布的阶段流转。
|
||
|
||
## D
|
||
|
||
### DevTask
|
||
开发任务实体。状态机：`todo → in_progress → testing → submitted`。`submitted` 是终态（开发交付完成）。
|
||
|
||
### Drawer
|
||
侧边抽屉式弹层。系统中所有详情都用 Drawer 呈现，统一 `shadow-2xl`，可在内部完成状态流转。
|
||
|
||
## E
|
||
|
||
### 引擎（Engine）
|
||
跨模块的纯函数派生层，避免 store 互相调用。
|
||
- `linkage-engine.ts`：从 DevTask 状态派生需求"实际进度"
|
||
- `workspace-engine.ts`：聚合所有 store 数据为统一 WorkItem
|
||
|
||
## P
|
||
|
||
### Plan / VersionPlan
|
||
版本下的计划任务（调研 / 产品方案 / UI 设计三类）。状态机：`pending → in_progress → completed`。完成时提交「成果」（链接或文件 + 标题）。
|
||
|
||
### Priority
|
||
优先级标识：P0 / P1 / P2 / P3 / P4。P0 最高，P4 最低。
|
||
|
||
### Product
|
||
产品 — 顶层组织容器。一个产品包含多个项目和需求池。
|
||
|
||
### Project
|
||
项目 — 产品下的子单位。一个项目包含多个版本。
|
||
|
||
### Prototype
|
||
原型 — 产品方案产物，通常是 Axure 导出的 HTML 集合。系统中只保存 URL，不缓存内容。
|
||
|
||
### Prototype Note
|
||
原型批注。Axure 等工具中以 `QY0007` 等编号形式标注的业务规则说明。Agent 拆解任务时的核心输入之一。
|
||
|
||
## Q
|
||
|
||
### Quality Loop（质量闭环）
|
||
TestCase + Bug 共同构成的质量验收环路。版本是否能发布的判断维度。
|
||
|
||
## R
|
||
|
||
### Reference（引用）
|
||
任务/用例的来源标记，类型为 `requirement` / `prototype_note` / `external`。所有任务/用例必须至少有 1 条引用（人工或 AI 生成都需要）。
|
||
|
||
### Requirement
|
||
需求实体。语义层（解释为什么做），不驱动流程。状态机：`pending_review → adopted → planned → developing → testing → released → closed`（rejected 可回 pending_review）。
|
||
|
||
## S
|
||
|
||
### Sprint
|
||
迭代 — 项目内的时间盒（1-4 周）。当前 V1 暂未启用 Sprint 实体，使用 Version 替代。
|
||
|
||
### Stage（阶段）
|
||
版本执行流程的语义段：调研 / 产品方案 / UI 设计 / 开发 / 测试 / 已发布。每个 Stage 可派生进度。
|
||
|
||
### 超管
|
||
拥有 `role.permissions` 含 `'*'` 的用户。可见所有版本（绕过 `version.members` 过滤），可执行所有操作。
|
||
|
||
## T
|
||
|
||
### TestCase
|
||
测试用例。主归属版本（`versionId` 必填），需求是可选标签（`requirementId` 可选）。
|
||
|
||
## V
|
||
|
||
### Version
|
||
版本 — 项目下的发布单位。**所有任务都归属版本**，是状态流转的执行主线。
|
||
|
||
### VersionWithContext
|
||
派生类型 — 在 Version 基础上扩展 productId/productName/projectId/projectName 等上下文字段，用于跨页面展示。
|
||
|
||
## W
|
||
|
||
### 无需求ID分组
|
||
AI 拆解时，原型里有明确功能批注但没有匹配到版本关联需求时形成的任务/用例分组。它只有展示用 `requirementName`，没有正式 `requirementId`，不进入需求池，也不加入版本关联需求列表。列表中展示为 `无需求ID · {需求名称}`，不额外显示“原型发现”标记。
|
||
|
||
### WorkItem
|
||
工作台聚合实体。把 DevTask / TestCase / Bug / Plan 等不同实体统一为同一形状，给"与我相关"页面用。
|