refactor: 迁移 Bun fullstack 架构

openspec/specs/frontend-development-workflow/spec.md

@@ -1,45 +1,41 @@
 ## Purpose
 
-定义 Vite + React + TypeScript 前端开发工作流、开发期 API 代理和共享契约的行为要求。
+定义 Bun.serve fullstack + React + TypeScript 前端开发工作流、开发期 API 访问和共享契约的行为要求。
 
 ## Requirements
 
 ### Requirement: Vite React 开发服务器
-系统 SHALL 提供基于 Vite + React + TypeScript 的前端开发工作流，并支持热模块替换。
+系统 SHALL 提供基于 Bun.serve fullstack 模式的前端开发工作流，并支持热模块替换和 React Fast Refresh。
 
 #### Scenario: 启动前端开发服务器
-- **WHEN** 开发者启动前端开发命令
-- **THEN** 前端 SHALL 由 Vite 提供服务，并启用 React 热模块替换
+- **WHEN** 开发者启动开发命令
+- **THEN** 前端 SHALL 由 Bun.serve 的 HTML import 机制提供服务，并通过 `development: { hmr: true, console: true }` 启用 HMR、React Fast Refresh 和浏览器 console 回显
 
 #### Scenario: 构建前端静态资源
 - **WHEN** 开发者运行前端生产构建命令
-- **THEN** 系统 SHALL 产出可由 Bun 后端服务的前端静态资源
+- **THEN** 系统 SHALL 通过 Bun.build 的 HTML import ahead-of-time bundling 产出可由 Bun 后端服务的前端静态资源
 
 ### Requirement: 前端开发期 API 代理
-前端开发服务器 SHALL 在本地开发期间将 `/api/*` 请求代理到 Bun 后端服务。
+前端开发服务器 SHALL 在本地开发期间无需代理配置即可访问后端 API，因为前后端运行在同一进程同一端口。
 
 #### Scenario: 前端开发期调用拨测 API
-- **WHEN** 浏览器从 Vite 开发源请求 `/api/summary`、`/api/targets` 等拨测 API
-- **THEN** Vite SHALL 将请求转发到 Bun 后端服务，且不需要浏览器 CORS 配置
+- **WHEN** 浏览器从开发服务器请求 `/api/summary`、`/api/targets` 等拨测 API
+- **THEN** Bun.serve SHALL 直接由 routes 中注册的 API handler 处理请求，无需 proxy 转发
 
 #### Scenario: 开发期访问非 API 前端路由
-- **WHEN** 浏览器从 Vite 开发源请求非 API 前端路由
-- **THEN** Vite SHALL 将该请求作为前端应用流量处理，而不是转发到后端
+- **WHEN** 浏览器从开发服务器请求非 API 前端路由
+- **THEN** Bun.serve SHALL 将该请求作为前端应用流量处理（SPA fallback 返回 HTML）
 
-### Requirement: 开发期后端端口一致性
-项目 SHALL 保证文档化的全栈开发命令中，Vite proxy 目标端口与 Bun 后端监听端口来自同一配置来源。
+### Requirement: 开发期单端口运行
+项目 SHALL 保证开发命令中前端页面、HMR 和后端 API 由同一个 Bun.serve 进程在同一端口提供服务。
 
 #### Scenario: 使用默认开发端口
-- **WHEN** 开发者未提供端口覆盖并运行文档化的全栈开发命令
-- **THEN** Bun 后端 SHALL 监听默认端口，且 Vite SHALL 将 `/api/*` 代理到同一端口
+- **WHEN** 开发者未提供端口覆盖并运行开发命令
+- **THEN** Bun.serve SHALL 在默认端口同时提供前端页面、HMR 和后端 API
 
-#### Scenario: 使用 PORT 覆盖开发端口
-- **WHEN** 开发者通过 `PORT` 覆盖后端端口并运行文档化的全栈开发命令
-- **THEN** Bun 后端 SHALL 监听该端口，且 Vite SHALL 将 `/api/*` 代理到同一端口
-
-#### Scenario: 避免代理端口与后端端口分叉
-- **WHEN** 开发期脚本需要向 Vite 传递后端端口
-- **THEN** 该代理端口 MUST 从文档化的后端端口配置派生，而不是作为独立对外配置导致分叉
+#### Scenario: 使用配置覆盖开发端口
+- **WHEN** 开发者通过配置文件覆盖端口并运行开发命令
+- **THEN** Bun.serve SHALL 在配置端口同时提供前端页面、HMR 和后端 API
 
 ### Requirement: 前端使用相对 API 路径
 除非有文档化的部署配置覆盖该行为，前端代码 MUST 通过相对 `/api/*` URL 调用后端 API。
@@ -57,7 +53,7 @@
 
 #### Scenario: 启动全栈开发
 - **WHEN** 开发者运行文档化的全栈开发命令
-- **THEN** 系统 SHALL 启动 Vite 前端开发服务器和 Bun 后端服务器
+- **THEN** 系统 SHALL 启动单个 Bun.serve 进程，同时提供前端 HMR 和后端 API 服务
 
 ### Requirement: 开发质量命令文档化
 项目 SHALL 在前端开发工作流文档中说明日常检查和完整验证命令。