feat: 全局设置系统 — settings 表、CRUD 路由、主题偏好持久化

tests/web/App.test.tsx

@@ -4,23 +4,30 @@ import { createElement } from "react";
 
 import { APP } from "../../src/shared/app";
 import { App } from "../../src/web/app";
-import { installFetchMock, mockMetaResponse, renderWithProviders } from "./test-utils";
+import { installFetchMock, jsonResponse, mockMetaResponse, renderWithProviders } from "./test-utils";
+
+function mockSettingsResponse(): Response {
+  return jsonResponse({ theme: "system" });
+}
 
 describe("App", () => {
-  test("渲染管理台入口、品牌和主题切换项", () => {
-    installFetchMock(() => mockMetaResponse());
+  test("渲染管理台入口和品牌", () => {
+    installFetchMock((call) => {
+      if (call.url.includes("/api/settings")) return mockSettingsResponse();
+      return mockMetaResponse();
+    });
 
     renderWithProviders(createElement(App));
 
     expect(screen.getByText(APP.title)).not.toBeNull();
     expect(screen.getByText("管理台")).not.toBeNull();
-    expect(screen.getByText("系统")).not.toBeNull();
-    expect(screen.getByText("明亮")).not.toBeNull();
-    expect(screen.getByText("黑暗")).not.toBeNull();
   });
 
-  test("渲染 Admin 导航菜单项", () => {
-    installFetchMock(() => mockMetaResponse());
+  test("渲染管理台侧边栏菜单项", () => {
+    installFetchMock((call) => {
+      if (call.url.includes("/api/settings")) return mockSettingsResponse();
+      return mockMetaResponse();
+    });
 
     renderWithProviders(createElement(App));
 

tests/web/components/ConsoleShell.test.tsx

@@ -0,0 +1,36 @@
+import { screen } from "@testing-library/react";
+import { describe, expect, test } from "bun:test";
+import { createElement } from "react";
+
+import { ConsoleShell } from "../../../src/web/shared/components/ConsoleShell/ConsoleShell";
+import { installFetchMock, jsonResponse, mockMetaResponse, renderWithProviders } from "../test-utils";
+
+function mockSettingsResponse(): Response {
+  return jsonResponse({ theme: "system" });
+}
+
+describe("ConsoleShell", () => {
+  test("Header 不再渲染主题 Segmented", () => {
+    installFetchMock((call) => {
+      if (call.url.includes("/api/settings")) return mockSettingsResponse();
+      if (call.url.includes("/api/meta")) return mockMetaResponse();
+      return jsonResponse({});
+    });
+
+    renderWithProviders(createElement(ConsoleShell, { menuItems: [], title: "测试" }));
+
+    expect(screen.queryByText("系统")).toBeNull();
+  });
+
+  test("渲染品牌标题", () => {
+    installFetchMock((call) => {
+      if (call.url.includes("/api/settings")) return mockSettingsResponse();
+      if (call.url.includes("/api/meta")) return mockMetaResponse();
+      return jsonResponse({});
+    });
+
+    renderWithProviders(createElement(ConsoleShell, { menuItems: [], title: "控制台" }));
+
+    expect(screen.getByText("控制台")).not.toBeNull();
+  });
+});

tests/web/features/settings/SettingsPage.test.tsx

@@ -0,0 +1,61 @@
+import { screen, waitFor } from "@testing-library/react";
+import { describe, expect, test } from "bun:test";
+import { createElement } from "react";
+
+import { SettingsPage } from "../../../../src/web/features/settings/index";
+import { installFetchMock, jsonResponse, renderWithProviders } from "../../test-utils";
+
+function mockSettingsResponse(theme = "system"): Response {
+  return jsonResponse({ theme });
+}
+
+describe("SettingsPage", () => {
+  test("渲染主题卡片", () => {
+    installFetchMock((call) => {
+      if (call.url.includes("/api/settings")) return mockSettingsResponse();
+      return jsonResponse({});
+    });
+
+    renderWithProviders(createElement(SettingsPage));
+
+    expect(screen.getByText("主题")).not.toBeNull();
+  });
+
+  test("渲染主题 Segmented 选项", () => {
+    installFetchMock((call) => {
+      if (call.url.includes("/api/settings")) return mockSettingsResponse();
+      return jsonResponse({});
+    });
+
+    renderWithProviders(createElement(SettingsPage));
+
+    expect(screen.getByText("系统")).not.toBeNull();
+    expect(screen.getByText("明亮")).not.toBeNull();
+    expect(screen.getByText("黑暗")).not.toBeNull();
+  });
+
+  test("API 加载中时不显示保存状态", () => {
+    installFetchMock((call) => {
+      if (call.url.includes("/api/settings")) return mockSettingsResponse();
+      return jsonResponse({});
+    });
+
+    renderWithProviders(createElement(SettingsPage));
+
+    expect(screen.queryByText("保存中...")).toBeNull();
+  });
+
+  test("GET /api/settings 获取已保存主题", async () => {
+    installFetchMock((call) => {
+      if (call.url.includes("/api/settings")) return mockSettingsResponse("dark");
+      return jsonResponse({});
+    });
+
+    renderWithProviders(createElement(SettingsPage));
+
+    await waitFor(() => {
+      const segmented = document.querySelector(".ant-segmented");
+      expect(segmented).not.toBeNull();
+    });
+  });
+});

tests/web/routes/workbench.test.tsx

@@ -18,6 +18,12 @@ function createMockHandler(overrides?: { status?: "active" | "archived" }) {
   const project = { ...MOCK_PROJECT, ...overrides };
   const handler = (input: RequestInfo | URL) => {
     const url = input instanceof Request ? input.url : typeof input === "string" ? input : input.toString();
+    if (url.includes("/api/settings")) {
+      return new Response(JSON.stringify({ theme: "system" }), {
+        headers: { "Content-Type": "application/json" },
+        status: 200,
+      });
+    }
     if (url.includes("/api/meta")) {
       return new Response(
         JSON.stringify({ ok: true, service: "test-app", timestamp: new Date().toISOString(), version: "0.1.0" }),
@@ -38,7 +44,8 @@ function createMockHandler(overrides?: { status?: "active" | "archived" }) {
     }
     return new Response(JSON.stringify({ error: "Not Found" }), { status: 404 });
   };
-  const mocked = handler as unknown as typeof fetch;
+  const mocked = ((input: RequestInfo | URL, _init?: RequestInit) =>
+    Promise.resolve(handler(input))) as unknown as typeof fetch;
   globalThis.fetch = mocked;
   window.fetch = mocked;
 }