lanyuanxiaoyao
763d814543
建立 docs/user/ 和 docs/development/ 分层文档结构： - docs/README.md 文档总路由、归属矩阵、影响分析规则 - docs/user/ 模板使用、配置、部署、故障排查 - docs/development/ 架构、后端、前端、构建发布开发规范 - README.md 轻量化为项目入口和索引 - 删除 DEVELOPMENT.md，内容拆分至专题文档 - 更新 openspec/config.yaml 首读入口和文档影响分析规则 - 修正 docs/prompts/README.md 过时引用和边界说明
1.7 KiB
1.7 KiB
生产部署
本文档说明如何构建和运行生产环境的应用。
生产构建和运行
bun run build
./dist/my-app config.yaml
启动后：
| 地址 | 行为 |
|---|---|
| http://127.0.0.1:3000/ | 返回前端 SPA |
| http://127.0.0.1:3000/api/meta | 返回应用元信息 JSON |
| http://127.0.0.1:3000/health | 返回健康检查 |
构建流程
scripts/build.ts 执行三步流水线：
1. Vite build -> dist/web/（前端静态资源，含 code splitting）
2. Code generation -> .build/static-assets.ts + .build/server-entry.ts（含版本号字面量注入）
3. Bun compile -> dist/my-app（单可执行文件）
- Vite 构建前端资源到 dist/web/，自动 code splitting（vendor-react、vendor-tdesign、vendor-chart）
- Code generation 扫描 dist/web/ 生成 import with { type: "file" } 声明，将资源嵌入 binary
- Bun compile 以 .build/server-entry.ts 为入口编译最终可执行文件
- .build/ 临时目录在构建完成后自动清理
产物
| 产物 | 用途 |
|---|---|
| dist/my-app | 生产可执行文件（含前端资源，单文件部署） |
| dist/web/ | Vite 构建的前端资源（构建中间产物） |
构建参数
| 环境变量 | 说明 |
|---|---|
| BUN_TARGET / BUILD_TARGET | 交叉编译目标平台（如 bun-linux-x64） |
清理
bun run clean
清理 dist/ 构建产物和 .build/ 临时文件。