feat(usable): integrate current dbtool implementation snapshot

Co-Authored-By: Paperclip <noreply@paperclip.ing>

backlog/2026-03-27-dbtool-tui-v1-phase-2-issues.md

@@ -0,0 +1,142 @@
+# 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”继续保留到第二阶段已经开工之后