2.2 KiB
2.2 KiB
1. 项目结构与依赖
- 1.1 创建
src/server、src/web、src/shared、scripts和测试目录结构 - 1.2 调整
package.json脚本以覆盖前端开发、后端开发、并行开发、测试和生产构建 - 1.3 引入 Vite、React、React DOM 和必要 TypeScript 类型依赖
- 1.4 创建或更新 README 记录项目结构、开发规范和命令
2. 前端开发工作流
- 2.1 创建 Vite + React + TypeScript 前端入口和基础页面
- 2.2 配置 Vite 开发服务器将
/api/*代理到 Bun 后端 - 2.3 实现前端 demo 页面调用相对路径
/api/demo并展示成功和失败状态 - 2.4 建立
src/shared共享类型并确保前端不引入后端运行时实现 - 2.5 提供一个 documented fullstack dev command 同时启动 Vite 前端和 Bun 后端
3. Bun 后端运行时
- 3.1 创建 Bun server 入口并支持 host 和 port 运行期配置
- 3.2 实现
/health健康检查响应 - 3.3 实现
/api/demoJSON 路由并返回前端可展示的 message 和 runtime metadata - 3.4 实现未命中
/api/*路由返回 JSON 404 的行为 - 3.5 实现生产环境静态资源服务和 SPA fallback 行为
4. 单可执行程序构建
- 4.1 创建生产构建脚本，确保先执行 Vite build 再执行 Bun compile
- 4.2 将 Vite
dist/产物嵌入 Bun executable，运行时不依赖外部dist/目录 - 4.3 配置 executable 输出路径和当前平台默认构建目标
- 4.4 确保 executable 运行不依赖本机 Node.js、Bun、Vite 或
node_modules
5. 测试与验证
- 5.1 为
/api/demo、/health、API 404 和 SPA fallback 增加测试 - 5.2 为生产构建脚本增加失败中断或防止 stale executable 的验证
- 5.3 增加构建后 executable smoke test 覆盖
/api/demo、健康检查、静态资源、前端 fallback 和 demo 页面内容 - 5.4 运行完整测试和生产构建，确认所有任务满足 specs
6. 文档收尾
- 6.1 更新 README 中的运行参数、构建产物、部署方式和已知限制
- 6.2 在 README 中记录前端可拆离原则、
/api/*路径约定和 demo 验证步骤