feat(usable): integrate current dbtool implementation snapshot
Co-Authored-By: Paperclip <noreply@paperclip.ing>
This commit is contained in:
46
plans/2026-03-26-dbtool-tui-shell-ui-scope.md
Normal file
46
plans/2026-03-26-dbtool-tui-shell-ui-scope.md
Normal 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 可以在不推翻壳层的前提下接入业务能力
|
||||
Reference in New Issue
Block a user