dbtool-cli-v1/plans/2026-03-26-dbtool-tui-shell-ui-scope.md

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