DiAL/openspec/specs/server-bootstrap/spec.md at 0d709c7681a23964f64e782df7c121cf50c9e722

Files

lanyuanxiaoyao d6a77b2c6e feat: 迁移前端构建从 Bun fullstack 到 Vite

前端性能问题根因在于 Bun bundler 无法有效 code split、CSS
tree-shake 和产出优化的前端资源。经多轮 Bun 原生优化尝试
均无明显效果后，决定将前端构建迁回 Vite。

主要变更：

- 前端构建：从 Bun HTML import bundling 切换为 Vite build
  （Rolldown code splitting、vendor chunk、CSS 优化）
- 开发模式：从 Bun fullstack 单进程 HMR 切换为 Vite dev
  server + Bun API server 双进程（:5173 + :3000）
- 生产构建：三步流水线（Vite build → code generation →
  Bun compile），通过 `import with { type: "file" }` 嵌入前端资源
- 静态资源服务：从 Bun HTML import manifest 切换为自定义
  serveStaticAsset 函数，支持 SPA fallback 和正确的 Cache-Control
- Server 接口：BootstrapOptions 和 StartServerOptions 增加
  staticAssets? 可选参数
- 文档更新：DEVELOPMENT.md 和 README.md 反映新的开发模式，
  主 specs 同步 delta 变更

新增能力：
- static-asset-embedding: 构建时资源扫描与 code generation、
  运行时静态资源服务
- vite-frontend-bundling: Vite 构建配置、code splitting 策略、
  CSS 处理

2026-05-15 11:26:46 +08:00

2.1 KiB

Raw Blame History

Purpose

TBD - 统一服务启动引导函数，封装开发和生产模式的完整启动序列。

Requirements

Requirement: 统一启动引导函数

系统 SHALL 提供 src/server/bootstrap.ts 导出 bootstrap(options: BootstrapOptions) 函数，封装完整的服务启动序列：加载配置、创建 store、同步 targets、创建并启动 engine、启动 HTTP server、注册 shutdown handler。

Scenario: 开发模式启动

WHEN dev.ts 调用 bootstrap({ configPath, mode: "development" })
THEN 系统 SHALL 完成完整启动序列，不传入 staticAssets

Scenario: 生产模式启动（带静态资源）

WHEN code-generated entry 调用 bootstrap({ configPath, mode: "production", staticAssets })
THEN 系统 SHALL 完成完整启动序列，并将 staticAssets 传递给 startServer

Scenario: 启动失败处理

WHEN 启动过程中任何步骤抛出异常
THEN 系统 SHALL 输出错误信息并以非零退出码退出进程

Scenario: 优雅关机

WHEN 进程收到 SIGINT 或 SIGTERM 信号
THEN bootstrap 注册的 shutdown handler SHALL 调用 engine.stop() 和 store.close() 后退出

Requirement: BootstrapOptions 接口

bootstrap 函数 SHALL 接受 BootstrapOptions 参数，包含 configPath: string、mode: RuntimeMode 和可选的 staticAssets?: StaticAssets。

Scenario: 最小配置（开发模式）

WHEN 仅传入 configPath 和 mode
THEN 系统 SHALL 正常启动，startServer 不接收 staticAssets 参数

Scenario: 生产模式配置

WHEN 传入 configPath、mode 和 staticAssets
THEN 系统 SHALL 将 staticAssets 传递给 startServer

Requirement: dev.ts 和生产入口使用 bootstrap

dev.ts 和 src/server/main.ts SHALL 调用 bootstrap() 而非各自维护启动序列。

Scenario: dev.ts 调用 bootstrap

WHEN 开发者运行 bun run dev
THEN dev.ts SHALL 调用 bootstrap 完成启动

Scenario: main.ts 调用 bootstrap

WHEN 生产可执行文件启动
THEN main.ts SHALL 调用 bootstrap 完成启动

2.1 KiB Raw Blame History Unescape Escape