refactor: 后端架构加固 — 泛型化、批量查询、bootstrap 统一、路径修复与 pageSize 上限

- CheckerDefinition 泛型化，HTTP/Command checker 移除 resolved target 断言
- 新增 ProbeStore.getAllRecentSamples 消除 targets 路由 N+1 查询
- 统一 getAllTargetStats 与 getTargetStats 的 availability 精度
- Engine rejected 结果写入 internal error 记录，提升可观测性
- 新增 bootstrap.ts 统一 dev/production 启动序列
- dataDir 相对路径改为基于配置文件目录解析
- validatePagination 增加 pageSize 上限 200 校验
- 修复 ErrorBoundary override 标记
- 更新 README/DEVELOPMENT 文档，新增完整测试覆盖

src/server/bootstrap.ts

@@ -0,0 +1,83 @@
+import { join } from "node:path";
+
+import type { RuntimeMode } from "../shared/api";
+import type { StaticAssets } from "./app";
+import type { StartServerOptions } from "./server";
+
+import { loadConfig, type ResolvedConfig } from "./checker/config-loader";
+import { ProbeEngine } from "./checker/engine";
+import { ProbeStore } from "./checker/store";
+import { startServer } from "./server";
+
+export interface BootstrapDependencies {
+  createEngine?: (
+    store: ProbeStore,
+    targets: ResolvedConfig["targets"],
+    maxConcurrentChecks: number,
+    retentionMs: number,
+  ) => BootstrapEngine;
+  createStore?: (dbPath: string) => ProbeStore;
+  exit?: (code: number) => never;
+  loadConfig?: (configPath: string) => Promise<ResolvedConfig>;
+  logError?: (...data: unknown[]) => void;
+  onSignal?: (signal: ShutdownSignal, handler: () => void) => void;
+  startServer?: (options: StartServerOptions) => unknown;
+}
+
+export interface BootstrapOptions {
+  configPath: string;
+  mode: RuntimeMode;
+  staticAssets?: StaticAssets;
+}
+
+type BootstrapEngine = Pick<ProbeEngine, "start" | "stop">;
+type ShutdownSignal = "SIGINT" | "SIGTERM";
+
+export async function bootstrap(options: BootstrapOptions, dependencies: BootstrapDependencies = {}): Promise<void> {
+  const load = dependencies.loadConfig ?? loadConfig;
+  const createStore = dependencies.createStore ?? ((dbPath: string) => new ProbeStore(dbPath));
+  const createEngine =
+    dependencies.createEngine ??
+    ((store: ProbeStore, targets: ResolvedConfig["targets"], maxConcurrentChecks: number, retentionMs: number) =>
+      new ProbeEngine(store, targets, maxConcurrentChecks, retentionMs));
+  const serve = dependencies.startServer ?? startServer;
+  const onSignal =
+    dependencies.onSignal ??
+    ((signal: ShutdownSignal, handler: () => void) => {
+      process.on(signal, handler);
+    });
+  const exit = dependencies.exit ?? ((code: number) => process.exit(code));
+  const logError = dependencies.logError ?? console.error;
+
+  let store: ProbeStore | undefined;
+  let engine: BootstrapEngine | undefined;
+
+  try {
+    const config = await load(options.configPath);
+    store = createStore(join(config.dataDir, "probe.db"));
+    store.syncTargets(config.targets);
+
+    engine = createEngine(store, config.targets, config.maxConcurrentChecks, config.retentionMs);
+    engine.start();
+
+    const shutdown = () => {
+      engine?.stop();
+      store?.close();
+      exit(0);
+    };
+    onSignal("SIGINT", shutdown);
+    onSignal("SIGTERM", shutdown);
+
+    serve({
+      config: { host: config.host, port: config.port },
+      mode: options.mode,
+      staticAssets: options.staticAssets,
+      store,
+    });
+  } catch (error) {
+    engine?.stop();
+    store?.close();
+    logError("启动失败:", error instanceof Error ? error.message : error);
+    exit(1);
+  }
+}