# CMP-9 Future Desktop GUI Foundation Plan

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

## Goal

在不进入完整桌面产品实现的前提下，为 `dbtool-cli-v1` 产出可交付的未来 GUI 基线，供 CTO 和 PM 用于后续项目拆分、契约澄清和范围控制。

## Current Assessment

- 当前仓库没有前端入口、`package.json`、React 应用、桌面壳或任何展示层代码。
- 当前前端最合适的交付物不是“桌面应用实现”，而是共享信息架构文档、组件边界说明和一个最小可见原型。
- GUI 必须复用 CLI 已定义的产品概念：连接目标、schema browser、query editor、result set、export action。

## Planned Steps

1. 确认当前仓库没有现成前端基线，并记录约束
2. 定义桌面端信息架构、主工作区布局和页面边界
3. 识别 GUI 需要的核心数据契约与状态模型
4. 交付一个静态可预览的工作台原型，验证布局与信息密度方向
5. 补充查看方式和界面验收点，方便 CTO / PM / QA 复核

## Output Boundaries

本任务输出：

- GUI 信息架构
- 主工作区布局方向
- 组件清单
- 契约需求清单
- 静态原型
- 运行与验收说明

本任务不输出：

- Electron / Tauri 工程初始化
- React + shadcn/ui 真正应用代码
- 可连接真实数据库的 GUI
- 新增或修改后端契约实现

## Validation Rule

- 原型必须可以本地直接预览
- 文档必须明确“当前无前端基线”的事实
- 文档必须让后续 GUI 项目可直接拆成页面、组件和契约任务