47 lines
1.4 KiB
Markdown
47 lines
1.4 KiB
Markdown
# 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 可以在不推翻壳层的前提下接入业务能力
|