2.8 KiB
2.8 KiB
ADDED Requirements
Requirement: Vite React 开发服务器
系统 SHALL 提供基于 Vite + React + TypeScript 的前端开发工作流，并支持热模块替换。
Scenario: 启动前端开发服务器
- WHEN 开发者启动前端开发命令
- THEN 前端 SHALL 由 Vite 提供服务，并启用 React 热模块替换
Scenario: 构建前端静态资源
- WHEN 开发者运行前端生产构建命令
- THEN 系统 SHALL 产出可由 Bun 后端服务的前端静态资源
Requirement: 前端开发期 API 代理
前端开发服务器 SHALL 在本地开发期间将 /api/* 请求代理到 Bun 后端服务。
Scenario: 前端开发期调用 API
- WHEN 浏览器从 Vite 开发源请求
/api/demo - THEN Vite SHALL 将请求转发到 Bun 后端服务，且不需要浏览器 CORS 配置
Scenario: 开发期访问非 API 前端路由
- WHEN 浏览器从 Vite 开发源请求非 API 前端路由
- THEN Vite SHALL 将该请求作为前端应用流量处理，而不是转发到后端
Requirement: 前端使用相对 API 路径
除非有文档化的部署配置覆盖该行为，前端代码 MUST 通过相对 /api/* URL 调用后端 API。
Scenario: 前端获取后端数据
- WHEN 前端代码调用后端 API
- THEN 请求 URL 默认 MUST 使用相对
/api/*路径
Scenario: 运行环境变化
- WHEN host 或 port 在开发环境和生产环境之间变化
- THEN 前端 API 调用 SHALL 无需修改源码即可继续工作
Requirement: 端到端开发 demo
项目 SHALL 提供一个可见的开发 demo，用于证明 React 前端可以通过 Vite 代理调用 Bun 后端。
Scenario: Demo 页面展示后端响应
- WHEN 开发者启动文档化的开发命令并打开前端 URL
- THEN 页面 SHALL 调用
/api/demo并展示 Bun 后端返回的数据
Scenario: 开发期后端不可用
- WHEN 前端 demo 无法访问
/api/demo - THEN 页面 SHALL 展示清晰的错误状态，而不是静默显示为成功
Requirement: 集成开发命令
项目 SHALL 提供一个文档化命令，用于在 demo 开发期间同时运行前端和后端。
Scenario: 启动全栈开发
- WHEN 开发者运行文档化的全栈开发命令
- THEN 系统 SHALL 启动 Vite 前端开发服务器和
/api/demo所需的 Bun 后端服务器
Requirement: 共享 TypeScript 契约
项目 SHALL 为前端和后端共同使用的请求与响应类型提供共享 TypeScript 边界。
Scenario: 定义 API 响应结构
- WHEN 前端和后端都需要某个 API 响应类型
- THEN 该类型 SHALL 定义在 shared 模块中，而不是在两端重复定义
Scenario: 前端导入共享类型
- WHEN 前端代码导入共享 API 类型
- THEN 该导入 SHALL 不要求将后端运行时实现打包进前端