2.2 KiB
2.2 KiB
Why
当前项目只有 Bun + TypeScript 的最小入口，尚不能支撑完整的前后端服务开发。引入 Vite + React 开发体验，并保持 Bun 后端可打包为单个可执行程序，可以同时满足本地快速迭代、前后端同源集成和简单部署的目标。
What Changes
- 新增基于 Vite + React + TypeScript 的前端应用开发能力，开发期保留 Vite HMR。
- 新增 Bun 后端服务作为 API 与生产静态资源承载层，API 统一位于
/api/*。 - 新增开发期前端代理后端 API 的同源调用约定，避免前端写死后端地址。
- 新增生产期构建链路：先构建前端静态资源，再将后端与前端产物打包为单个 Bun standalone executable。
- 新增可验收 demo：前端页面调用后端 API 并展示响应，开发期和 executable 运行期都能验证前后端联通。
- 新增 SPA fallback 行为：生产环境非 API 前端路由返回前端入口页面。
- 更新 README，记录项目结构、开发命令、测试命令、构建命令与部署方式。
Capabilities
New Capabilities
frontend-development-workflow: 约定 Vite + React 前端开发、API proxy、共享类型和本地开发命令。fullstack-app-runtime: 约定 Bun 服务在运行期同时提供 API、健康检查、静态资源和 SPA fallback。single-executable-packaging: 约定生产构建将 Vite 前端产物和 Bun 后端服务打包为单个可执行程序。
Modified Capabilities
无。当前 openspec/specs/ 为空，没有既有 capability 需要修改。
Impact
- 代码结构将从单入口
index.ts扩展为前端、后端、共享类型和构建脚本的模块化结构。 - 依赖将新增 Vite、React、React DOM 及相关 TypeScript 类型；测试依赖按实现方案最小化引入。
- 开发脚本将覆盖前端 dev server、后端 dev server、并行开发、测试和生产构建。
- 生产产物将从直接运行 TypeScript 入口变为
dist/下的平台相关 executable。 - demo 验收将覆盖开发期联调和生产 executable 运行后的前端页面、API 与健康检查。
- README 需要同步说明模块结构、API 路径约定、构建产物和运行参数。