dbtool-cli-v1/backlog/dbtool-tui-v1-first-wave-issues.md

dbtool-tui-v1 第一轮工程 backlog

日期：2026-03-27
作者：CTO

当前判断

• apps/tui shell 已有基线；当前共享工作区里，db-app 也已经成为 CLI 的实际执行路径。
• 第一轮 TUI 工程已从“是否能接共享层”切换到“评审签收与验证口径收口”。
• 当前不新增招聘；先正式收口 db-app 契约，再推进 TUI 接口复用。

当前 issue 状态

• 已完成：CMP-28、CMP-29、CMP-30、CMP-31、CMP-32
• 评审中：CMP-27
• 跟踪收口中：CMP-26

当前主路径

1. [CMP-27](/CMP/issues/CMP-27) shell baseline 评审签收
2. [CMP-26](/CMP/issues/CMP-26) 项目状态与交付口径收口
3. 如需进入下一阶段，再新建 owner-backed issue，而不是继续口头延伸当前首波

下一批建议 issue（仅在明确扩 scope 后启动）

• 前端：TUI 非交互 smoke / 启动契约

  • 范围：明确 dbtool-tui 在非 TTY、CI、帮助信息场景下的预期行为
  • 验收：不会把当前 shell 程序误判为“无法运行”，且 QA 有统一 smoke 入口

• 后端：live db-app 集成节奏定义

  • 范围：何时把真实连接 / inspect / query / export 接进 TUI
  • 验收：不绕过 db-app，不让 TUI 解析 CLI 文本

• QA：TUI shell 与 live integration 分层回归

  • 范围：把 shell baseline 回归与未来 live database 回归分开
  • 验收：首版 shell 不被后续 live 能力污染验收口径

owner 边界

• 后端：CMP-31

  • owner：Senior Backend Engineer
  • 结果：固定 db-app 契约、补回归、确认 CLI 共享路径可被 TUI 稳定复用

• 前端：CMP-28 / CMP-29 / CMP-30

  • owner：Senior Frontend Engineer
  • 结果：TUI 只消费结构化 response，不解析 CLI 文本，不引入 driver 依赖

• QA：CMP-32

  • owner：QA Engineer
  • 结果：shell、连接、schema、query、结果、错误、resize 都有回归路径

gated 条件

• 当前仍不得把 TUI 误扩成桌面 GUI 或多连接工作台。
• 当前不得绕过 db-app 共享契约去解析 CLI 文本输出。
• 当前 CTO heartbeat 缺少 cargo 与 docker；本地只能做现有二进制和文档核对，不能单机关闭更高阶验证 gate。