1
0

refactor: 移除 success 字段,简化为 matched 单层判定模型

This commit is contained in:
2026-05-11 13:12:55 +08:00
parent 548b44d28e
commit 35ba56888b
93 changed files with 3893 additions and 103 deletions

View File

@@ -0,0 +1,33 @@
## 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 路径约定、构建产物和运行参数。