41 lines
3.5 KiB
Markdown
41 lines
3.5 KiB
Markdown
# 任务书：开发 agent A3 —— P2-P5 前端编排闭环/报告/存档/面板
|
||
|
||
## 前置必读
|
||
1. docs/bioflow_team_context.md（环境事实 + 团队纪律，全部遵守）
|
||
2. 本任务书 + 模块职责边界
|
||
3. docs/PRD.md §16（FR-BIO-001~027）、docs/UI_SPEC.md §8（组件规格，逐字复刻 CSS 关键值，不得自行美化）
|
||
4. 服务器 ui/ 树为唯一权威（本地副本滞后）
|
||
|
||
## 职责范围（分四个小期，每期完成自测后交 T2 轮次测试，缺陷修复循环至清零再进下一小期）
|
||
A. P2 对话式编排闭环：
|
||
- utils/intent.js —— 生信意图分流（关键词：分析类动词+基因家族名/分析对象；存档复用句式「用 XXX 存档任务的方法帮我跑 xxxx」；漏判安全——不命中一律走原 qa 流）。词典以 docs/team/cases_bioflow_intent.md（T1 冻结，唯一事实源）为准，不得自造
|
||
- stores/chat.js —— sendBioflow() 动作（仿 sendDocgen 模式）+ bioflow 消息更新器（SSE 事件→patch 消息 blocks；断线重连回放快照整体刷新）
|
||
- components/chat/FlowPathCard.vue、FlowFormCard.vue（继续按钮+自动连续开关）、FlowFileCard.vue（拖拽+XHR 进度+服务器路径输入）、FlowProgressCard.vue（块类型 bioflow_progress；视觉沿用 PipelineCard 令牌，新增 failed/skipped 态、日志尾区、失败三选一、>10 阶段折叠）、FlowArchiveCard.vue
|
||
- AssistantMessage.vue —— 增加五类块分支（PipelineCard 本身零改动）
|
||
- Composer.vue —— 拖拽上传 + XHR 进度分支（生信文件经 BFF 反代直达 8098）
|
||
- i18n/bioflow.js —— 全部用户可见文案（不用 labels.js，红线）
|
||
B. P3 报告闭环：
|
||
- report 模板（docgen templates 体系增量新增，协调 TL）+ fig:// 图引用渲染（docgen 模板渲染器解析 fig://图id → base64）
|
||
- DocPane 复用（零改造目标）；图表调整 revise 触发与预览刷新
|
||
C. P4 存档与复用：
|
||
- 存档提示卡交互（命名/描述/放弃）、存档状态回复消息更新、复用发起（预填表单展示）
|
||
D. P5 生信任务面板：
|
||
- components/bench/BioJobsPane.vue（任务列表/阶段 DAG/进度/manifest+日志浏览/重跑）、BioArchivePane.vue（档案列表/详情回看/删除/复用发起）
|
||
- BenchPanel.vue + AppShell.vue 移动端 tab 条两处接入（TAB 数断言测试随改）
|
||
- 探活显隐：启动探测 /api/bioflow/health，不可达隐藏生信 TAB 与块分支
|
||
|
||
## 【红线零改动（动了即缺陷）】
|
||
ui/src/stores/modes.js、ui/src/i18n/labels.js、ui/src/stores/bench.js(store)、ui/src/api/qa.js、ui/src/sse/parser.js、PipelineCard.vue、services/docgen 既有代码（report 模板为增量新增，经 TL 协调）
|
||
|
||
## 【纪律再强调】
|
||
- 文案全部进 i18n/bioflow.js；类名遵循 UI_SPEC §8.7 复用约定；不 commit/push；不部署（dist 构建由 TL 执行）
|
||
- UI 规格冲突时以 UI_SPEC.md §8 为准
|
||
|
||
## 【自测要求】
|
||
- 每个组件写 Vitest 用例（L3/L4）：五卡片+两面板全状态 + UI 动作矩阵（点击/双击/悬停/键盘 Enter 与 Esc/拖入/悬停拖放/离开/聚焦/失焦/禁用/加载中）；意图分流与后端同用例表（cases_bioflow_intent.md）
|
||
- cd ui && npx vitest run（不依赖生产服务；SSE 用 mock）
|
||
- 自测结果写入 docs/team/report_bioflow_dev3.md（每小期一节：完成清单/用例数/通过数/已知限制）
|
||
|
||
## 【完成标准】
|
||
每个小期完成：报告更新 + 最终回复明确写「BIOFLOW DEV3 P{n} 完成」+ 自测通过数
|