4.2 KiB
术语表
按字母/拼音首字母排序。同一术语只在系统的一个语境里有定义，避免歧义。
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 等不同实体统一为同一形状，给"与我相关"页面用。