# 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。