test: 测试体系全面优化，修复 Windows SQLite EBUSY 和前端产品缺陷

测试基础设施
- 统一 SQLite 测试 DB/临时目录 helper（tests/helpers.ts），支持 Windows EBUSY 重试清理
- 测试库使用 PRAGMA journal_mode=DELETE 避免 WAL 句柄延迟
- 路由 handler 测试改用 createMigratedMemoryTestDatabase 避免 File DB 锁
- SQLite 聚焦 --rerun-each=20 全部通过（720 pass）

后端测试补强
- 新增 tests/server/app.test.ts 真实 startServer 集成测试
- 覆盖 /api/meta、项目 CRUD、错误路径、静态 fallback、安全 header
- bootstrap/logger 测试捕获预期输出，消除测试噪音

前端测试补强
- 移除 .ant-* 内部类名依赖，改为角色/文本/导航/请求契约断言
- 项目页补充搜索、Tab 切换、表单、表格操作、错误反馈行为测试
- 新增 hooks（use-theme-preference、use-sidebar-collapsed、use-projects）纯逻辑测试
- 新增 ErrorBoundary 错误展示和刷新按钮测试
- 新增搜索清空行为测试
- 测试 setup 过滤 antd/rc-trigger NaN height warning

产品修复（测试暴露）
- 修复 ProjectToolbar 搜索框无法输入（新增 draftKeyword 状态）
- 加固 ProjectFormModal 表单字段同步（useEffect 替代不可靠的 afterOpenChange）
- 清理 ProjectFormModal 冗余 afterOpenChange 同步逻辑

重构与合规
- ProjectContext 拆分为三文件满足 React Fast Refresh 规则
- use-projects.ts 导出内部 helper 函数供测试验证
- scripts/build.ts 提取纯生成函数供测试使用，修复构建步骤日志编号
- 修复 build 测试覆盖真实生成逻辑

文档同步
- 更新后端/前端/开发文档测试规范、质量门禁和 helper 使用说明

tests/web/App.test.tsx

@@ -4,77 +4,27 @@ import { createElement } from "react";
 
 import { APP } from "../../src/shared/app";
 import { App } from "../../src/web/app";
-import { renderWithProviders } from "./test-utils";
+import { installFetchMock, mockMetaResponse, renderWithProviders } from "./test-utils";
 
 describe("App", () => {
-  test("渲染 Layout 骨架和品牌名", () => {
-    window.fetch = (() => {
-      return new Response(
-        JSON.stringify({ ok: true, service: "test-app", timestamp: new Date().toISOString(), version: "0.1.0" }),
-        {
-          headers: { "Content-Type": "application/json" },
-          status: 200,
-        },
-      );
-    }) as unknown as typeof fetch;
+  test("渲染管理台入口、品牌和主题切换项", () => {
+    installFetchMock(() => 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 侧边栏菜单项", () => {
-    window.fetch = (() => {
-      return new Response(
-        JSON.stringify({ ok: true, service: "test-app", timestamp: new Date().toISOString(), version: "0.1.0" }),
-        {
-          headers: { "Content-Type": "application/json" },
-          status: 200,
-        },
-      );
-    }) as unknown as typeof fetch;
+  test("渲染 Admin 导航菜单项", () => {
+    installFetchMock(() => mockMetaResponse());
 
     renderWithProviders(createElement(App));
 
     expect(screen.getAllByText("总览").length).toBeGreaterThan(0);
     expect(screen.getAllByText("项目管理").length).toBeGreaterThan(0);
   });
-
-  test("Sider 渲染侧边栏菜单", () => {
-    window.fetch = (() => {
-      return new Response(
-        JSON.stringify({ ok: true, service: "test-app", timestamp: new Date().toISOString(), version: "0.1.0" }),
-        {
-          headers: { "Content-Type": "application/json" },
-          status: 200,
-        },
-      );
-    }) as unknown as typeof fetch;
-
-    renderWithProviders(createElement(App));
-
-    const sider = document.querySelector(".ant-layout-sider");
-    expect(sider).not.toBeNull();
-    const menu = document.querySelector(".ant-menu");
-    expect(menu).not.toBeNull();
-  });
-
-  test("Admin header 显示管理台标题", () => {
-    window.fetch = (() => {
-      return new Response(
-        JSON.stringify({ ok: true, service: "test-app", timestamp: new Date().toISOString(), version: "0.1.0" }),
-        {
-          headers: { "Content-Type": "application/json" },
-          status: 200,
-        },
-      );
-    }) as unknown as typeof fetch;
-
-    renderWithProviders(createElement(App));
-
-    expect(screen.getByText("管理台")).not.toBeNull();
-  });
 });