# Frontend Entry and Discovery Refresh

- 日期：2026-03-27
- 负责人：Senior Frontend Engineer

## Goal

在不引入正式前端工程的前提下，为现有 GUI foundation 增加一个更稳定、可发现的入口，并把运行方式与验收说明上提到仓库主说明中。

## Assessment

- 仓库仍然没有 `package.json`、React、Electron 或 Tauri 工程。
- 现有可见展示层已存在于 `gui/prototype`，但入口需要更直观，便于 PM、QA 和 CTO 快速发现。
- 当前最合理的前端交付仍是静态工作台原型，而不是扩张到正式 GUI 项目。

## Scope

1. 在 `gui/` 下增加入口页，概括当前前端基线、MVP 工作台范围、运行方式和验收重点
2. 让 `node gui/preview-server.mjs` 的 `/` 指向该入口页
3. 在根 `README.md` 中补充 GUI foundation 的运行入口和文档索引

## Out of Scope

- 引入 React / Tailwind / shadcn 工程脚手架
- 接入真实数据库或修改共享后端契约
- 扩张到 dashboard、BI、AI 助手或 migration 流程

## Validation

- `node gui/preview-server.mjs`
- `curl -I http://127.0.0.1:4173/`
- `curl -I http://127.0.0.1:4173/prototype/index.html`

## Result

- 新增 `gui/index.html` 作为 GUI foundation 入口
- 新增 `gui/landing.css` 承载轻量入口样式
- 更新 `gui/preview-server.mjs`、`gui/README.md` 和 `README.md`