Files
PlantAI-rag-new/docs/team/brief_bioflow_dev3_p2p5.md

3.5 KiB
Raw Permalink Blame History

任务书:开发 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} 完成」+ 自测通过数