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