# 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_BACKEND_CONTRACT.md`
  - `crates/db-app`
  - `plans/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/tui`
  - `apps/tui/README.md`
  - `TUI_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/tui`
  - `TUI_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.md`
  - `TUI_REGRESSION_CHECKLIST.md`
  - `TUI_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

1. 后端冻结 TUI live integration 契约
2. 前端接入真实连接与 schema browser
3. 前端接入真实 query / results / export
4. QA 固化第二阶段验收矩阵与回归
5. PM 跟踪第二阶段节奏与依赖

## Gating

- Issue 1 未完成前，Issue 2 / 3 不得绕过 shared app 直接写业务旁路
- Issue 2 未完成前，Issue 3 不应假定活动连接上下文已经稳定
- Issue 4 不能替代实现 issue，只负责把结果转成可审计验收路径
- Issue 5 不应把“项目 planned”继续保留到第二阶段已经开工之后