feat: 初始提交

docs/user/deploy.md

@@ -0,0 +1,54 @@
+# 生产部署
+
+本文档说明如何构建和运行生产环境的应用。
+
+## 生产构建和运行
+
+```bash
+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 执行三步流水线：
+
+```text
+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） |
+
+## 清理
+
+```bash
+bun run clean
+```
+
+清理 dist/ 构建产物和 .build/ 临时文件。