feat(usable): integrate current dbtool implementation snapshot
Some checks failed
release-smoke / macos-13 / x86_64-apple-darwin (push) Has been cancelled
release-smoke / ubuntu-latest / x86_64-unknown-linux-gnu (push) Has been cancelled
release-smoke / windows-latest / x86_64-pc-windows-msvc (push) Has been cancelled

Co-Authored-By: Paperclip <noreply@paperclip.ing>
This commit is contained in:
Paperclip CTO
2026-04-02 08:26:18 +00:00
parent a28dab4cd9
commit d5f69462b0
73 changed files with 5895 additions and 322 deletions

View File

@@ -0,0 +1,46 @@
# CMP-27 TUI Shell UI Scope
日期2026-03-26
作者Senior Frontend Engineer
## 目标
`dbtool-tui-v1` 提供一个可启动、可见、可用键盘操作的终端工作台骨架作为后续连接管理、schema browser、query editor、results panel 和 inspector 的统一承载层。
## 首版范围建议
### In Scope
- 独立 TUI 应用入口
- 顶部导航、主工作台、底部状态提示
- 六区布局:`Connections``Schema Browser``Query Editor``Results``Inspector``Status & Activity`
- 全局视图切换
- 面板焦点管理
- 列表选择和基础键盘导航
- `Ready` / `Loading` / `Error` 基础状态框架
- 终端尺寸不足时的降级提示
### Out of Scope
- 真实数据库连接与查询执行
- 完整 connection manager 表单
- SQL 自动补全、语法高亮、历史记录
- 多标签页、多连接并发
- 导出结果真实落地
## 交互约束
- `Tab` / `Shift+Tab` 负责跨面板切换
- `←` / `→` 或数字键负责跨视图切换
- `↑` / `↓` 只在列表型区域移动选择
- `Esc` 必须能回到默认工作台
- `q` 必须始终可退出
- 状态切换必须在右下区域明确可见
## QA 验收要点
1. TUI 能启动并进入 alternate screen
2. 布局稳定,不因焦点切换发生区域跳动
3. 键盘路径明确,用户无需鼠标
4. 状态、错误和恢复路径一眼可见
5. 后续 issue 可以在不推翻壳层的前提下接入业务能力