4.8 KiB
4.8 KiB
dbtool-tui-v1 第二阶段 owner-backed issues
日期:2026-03-27
作者:CTO
对应 issue:CMP-33
当前判断
- 第一阶段 shell 已完成;第二阶段的目标是接入真实数据与真实执行状态,而不是继续堆占位界面。
- 第二阶段必须保持
db-app共享边界,不允许 TUI 走 CLI 文本解析旁路。 - 当前不新增招聘;先用 owner-backed issue 验证真实吞吐与依赖。
Issue 1:后端冻结 TUI live integration 契约
- 建议 owner:Senior Backend Engineer
- 目标:为 TUI 提供可直接消费的真实连接、inspect、query、export 集成边界
- 范围
- 明确 TUI 侧需要的
db-app请求 / 响应 / 错误对象 - 明确适合 worker / channel 回传的执行状态
- 补共享回归,防止 CLI / TUI 语义漂移
- 明确 TUI 侧需要的
- 非目标
- TUI 界面编码
- 新数据库能力
- 输入
TUI_BACKEND_CONTRACT.mdcrates/db-appplans/2026-03-27-dbtool-tui-v1-phase-2-scope.md
- 交付物
- 更新后的共享契约
- 对应回归测试
- 明确的 frontend 接入说明
- 验收标准
- frontend 可以不依赖 CLI 文本直接接入真实数据
- query / inspect / export 的状态和错误口径可稳定复用
Issue 2:前端接入真实连接与 schema browser
- 建议 owner:Senior Frontend Engineer
- 目标:让
Connections与Schema Browser从占位状态进入真实 shared app 数据流 - 范围
- 激活连接
- 展示连接成功 / 失败 / loading
- 拉取 schema / table / column
- 将活动连接上下文同步到 inspector / status 区
- 非目标
- query 执行
- result table 真实渲染
- 输入
apps/tuiapps/tui/README.mdTUI_BACKEND_CONTRACT.md- backend 契约 issue 结果
- 交付物
- 真实 connections / schema browser 接线
- 对应状态文案与错误提示
- 验收标准
- 用户可以在 TUI 内看到真实连接与真实 schema 结构
- loading / empty / error 状态保持可读
Issue 3:前端接入真实 query / results / export 工作流
- 建议 owner:Senior Frontend Engineer
- 目标:让
Query Editor、Results、Status & Activity进入真实执行闭环 - 范围
- 执行当前 query
- 展示成功结果、空结果、执行失败
- 展示当前结果集的 export 反馈
- 保持工作区上下文连续
- 非目标
- 高级 SQL 编辑器能力
- 多 tab / query history
- 输入
apps/tuiTUI_BACKEND_CONTRACT.md- backend 契约 issue 结果
- Issue 2 的连接 / schema 上下文
- 交付物
- 真实 query / results / export 接线
- 状态与错误反馈
- 验收标准
- 用户可以在一个 TUI 会话里完成 inspect -> edit -> run -> review -> export
- 错误与空结果不会退化成空白或瞬时提示
Issue 4:QA 固化第二阶段验收矩阵与回归
- 建议 owner:QA Engineer
- 目标:把第二阶段的 live integration 验收和第一阶段 shell 验收彻底分层
- 范围
- 连接激活验收
- schema browser live 数据验收
- query / empty / error / export 验收
- shell baseline 与非交互 smoke 的回归归类
- 非目标
- 新功能定义
- release 流水线扩展
- 输入
TUI_ACCEPTANCE_CHECKLIST.mdTUI_REGRESSION_CHECKLIST.mdTUI_TEST_STRATEGY.md- 阶段 2 后端 / 前端 issue 交付结果
- 交付物
- 更新后的验收矩阵
- 可重复执行的阶段 2 回归清单
- 验收标准
- QA 文档能区分 shell baseline 和 live integration
- 每个关键用户流都有明确通过 / 失败判断
Issue 5:PM 跟踪第二阶段节奏与依赖
- 建议 owner:Project Manager
- 目标:保持第二阶段 issue、依赖和项目状态可见,避免再次出现状态漂移
- 范围
- 依赖图更新
- 项目状态同步
- 关键路径和 blocker 更新
- 非目标
- 技术方案变更
- 实现工作
- 输入
plans/2026-03-26-dbtool-tui-v1-delivery-tracking.md- 新创建的阶段 2 owner-backed issues
- 交付物
- 更新后的 delivery tracking 文档
- 当前关键路径、blocker、owner 分布
- 验收标准
- 项目状态与 issue 面一致
- 第二阶段主路径对 CTO / CEO 可见
Sequencing
- 后端冻结 TUI live integration 契约
- 前端接入真实连接与 schema browser
- 前端接入真实 query / results / export
- QA 固化第二阶段验收矩阵与回归
- PM 跟踪第二阶段节奏与依赖
Gating
- Issue 1 未完成前,Issue 2 / 3 不得绕过 shared app 直接写业务旁路
- Issue 2 未完成前,Issue 3 不应假定活动连接上下文已经稳定
- Issue 4 不能替代实现 issue,只负责把结果转成可审计验收路径
- Issue 5 不应把“项目 planned”继续保留到第二阶段已经开工之后