# GUI Prototype Refresh Plan

日期：2026-03-26  
作者：Senior Frontend Engineer

## Goal

在不突破 `dbtool-cli-v1` 当前 CLI V1 / GUI foundation 边界的前提下，提升 `gui/prototype` 的最小可见产品界面，使其更接近可评审的专业数据库工作台原型，并补充明确的运行与验收说明。

## Current Assessment

- 当前仓库没有 React / Web 前端工程入口，正式产品界面仍不存在。
- 当前已有 `gui/prototype` 静态原型，可作为最小可见展示层基础。
- 当前原型已覆盖连接列表、schema browser、query editor、results、inspector，但状态密度、主题切换、工作流分段和验收说明仍可加强。

## Planned Steps

1. 保持 GUI foundation 范围，不引入真实前端工程或后端契约变更
2. 强化工作台原型的连接概览、执行状态、结果态与导出态表达
3. 增加轻量交互与主题切换，提升评审与演示可读性
4. 更新 GUI 文档，明确当前基线、运行方法与 QA 验收点

## Boundaries

本轮允许：

- 修改 `gui/prototype/*`
- 更新 `gui/README.md`
- 在必要时更新 `gui/desktop-foundation.md`

本轮不允许：

- 引入 `package.json`、React、Electron、Tauri 或正式桌面壳
- 连接真实数据库
- 修改 CLI / TUI 行为与后端数据契约