chore: scaffold monorepo and migrate uhd_web design system (W0-A)

- pnpm workspace: apps/{web,server}, packages/{contracts,db,domain,adapters,tasks,agent,testkit}
- server: Hono + zod-openapi, API Key auth with scopes, redacting pino logger, SSE event bus with replay, worker heartbeat
- db: Kysely + pg, file migrator, 0001_init (settings/api_key/audit_event/outbox_event)
- web: React Router 7 SPA console shell with 12 workspace placeholders, uhd_web tokens/ui/guard scripts
- docs: ADR-001 (Node over Deno), dev runbook, design system rules

Co-Authored-By: Claude Fable 5.1 <[email protected]>

apps/server/src/main.ts

@@ -0,0 +1,66 @@
+import { parseArgs } from "node:util";
+import { serve } from "@hono/node-server";
+import { createDb } from "@umt/db";
+import pkg from "../package.json" with { type: "json" };
+import { loadConfig } from "./config";
+import { createApp } from "./http/app";
+import { EventBus } from "./http/sse";
+import { createLogger } from "./logger";
+import { startWorker } from "./worker";
+
+const Roles = ["api", "worker", "all"] as const;
+type Role = (typeof Roles)[number];
+
+const { values } = parseArgs({ options: { role: { type: "string", default: "all" } }, strict: true });
+const role = values.role as Role;
+if (!Roles.includes(role)) {
+  console.error(`--role 必须是 ${Roles.join("|")}`);
+  process.exit(2);
+}
+
+let config: ReturnType<typeof loadConfig>;
+try {
+  config = loadConfig();
+} catch (err) {
+  console.error((err as Error).message);
+  process.exit(2);
+}
+
+const logger = createLogger({
+  level: config.LOG_LEVEL,
+  pretty: config.NODE_ENV === "development" && process.stdout.isTTY,
+});
+const db = createDb({ connectionString: config.DATABASE_URL });
+const bus = new EventBus();
+const stops: Array<() => Promise<void>> = [];
+
+if (role === "api" || role === "all") {
+  const app = createApp({ config, logger, bus, db, role, version: pkg.version });
+  const server = serve({ fetch: app.fetch, port: config.PORT }, (info) => {
+    logger.info({ port: info.port, role }, `API 已启动 http://localhost:${info.port}/api/v1/health`);
+  });
+  stops.push(
+    () =>
+      new Promise((resolve) => {
+        // SSE 长连接不会自行结束,强制关闭
+        (server as unknown as { closeAllConnections?: () => void }).closeAllConnections?.();
+        server.close(() => resolve());
+      }),
+  );
+}
+if (role === "worker" || role === "all") {
+  const worker = startWorker({ logger, heartbeatMs: config.WORKER_HEARTBEAT_MS, bus });
+  stops.push(worker.stop);
+}
+
+let stopping = false;
+async function shutdown(signal: string) {
+  if (stopping) return;
+  stopping = true;
+  logger.info({ signal }, "正在退出");
+  await Promise.allSettled(stops.map((s) => s()));
+  await db.destroy();
+  process.exit(0);
+}
+process.on("SIGINT", () => void shutdown("SIGINT"));
+process.on("SIGTERM", () => void shutdown("SIGTERM"));