@allbluecn/web-app 0.18.2 → 0.19.0

package/src/components/testcase/__tests__/list-view.test.tsx

@@ -20,7 +20,8 @@
 // 经 cursorRef 读最新游标；追加路径按 id 去重（story-list-view 同款）+ in-flight 守卫。
 // 本测试复现「游标重放同一页」场景：多次触发哨兵，断言每行恰渲染一次、请求带最新游标。
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
-import { cleanup, render, screen, waitFor } from "@testing-library/react";
+import { act, cleanup, render, screen, waitFor } from "@testing-library/react";
+import userEvent from "@testing-library/user-event";
 
 vi.mock("@tanstack/react-start", () => ({
   useServerFn: (fn: unknown) => fn,
@@ -45,9 +46,14 @@ vi.mock("@/server/serverFns/story", () => ({
 
 
 // 任务 21 起 AI 生成按钮改接 ai/generate-dialog（内部 useFeature 拉进 billing
-// serverFn 链），同款裁剪：直通渲染裁掉整棵子树
+// serverFn 链），同款裁剪：直通渲染裁掉整棵子树；任务 19 A 案补丁起工具栏菜单
+// 直接挂 GenerateTestCasesDialog + 调 useFeature，工厂补齐两导出并裁门控钩子
 vi.mock("@/components/testcase/ai/generate-dialog", () => ({
   GenerateTestCasesButton: () => null,
+  GenerateTestCasesDialog: () => null,
+}));
+vi.mock("@/components/billing/use-feature", () => ({
+  useFeature: () => ({ enabled: true, loading: false, unavailable: false }),
 }));
 
 const virtualState = vi.hoisted(() => ({ stub: true }));
@@ -80,6 +86,21 @@ vi.mock("@/server/serverFns/testcase/testcase-crud", () => ({
   archiveTestCaseFn: vi.fn(),
   deleteTestCaseFn: vi.fn(),
 }));
+// CSV 导出 serverFn（任务 45 起工具栏 import 该模块）：列表壳测试裁掉重依赖链
+vi.mock("@/server/serverFns/testcase/testcase-export", () => ({
+  exportTestCasesFn: vi.fn(),
+}));
+// 任务 26 起列表页壳接看板 serverFn（view=board 数据面）：本文件不测看板链路，
+// 空实现保模块求值（createServerFn 需 tanstackStart 插件编译， vitest 无该插件）
+vi.mock("@/server/serverFns/testcase/testcase-board", () => ({
+  listTestCaseBoardColumnsFn: vi.fn(() => Promise.resolve({ columns: [] })),
+}));
+const { reorderTestCasesFn } = vi.hoisted(() => ({
+  reorderTestCasesFn: vi.fn(() => Promise.resolve({ success: true })),
+}));
+vi.mock("@/server/serverFns/testcase/testcase-reorder", () => ({
+  reorderTestCasesFn,
+}));
 vi.mock("@/server/serverFns/testcase/testcase-groups", () => ({
   listGroupsFn,
 }));
@@ -93,15 +114,51 @@ vi.mock("@/server/serverFns/testcase/testcase-folders", () => ({
   deleteFolderFn: vi.fn(),
   reorderFolderFn: vi.fn(),
 }));
-// 任务 9 起列表页壳引入筛选视图 serverFn：本文件不测视图链路，给空实现保模块求值
+// 任务 9 起列表页壳引入筛选视图 serverFn：任务 29 起保存视图集成用例需要操控
+// 视图行/断言保存 payload，全部提升为可操控 mock
+const { listFilterViewsFn, createFilterViewFn, updateFilterViewFn, deleteFilterViewFn } = vi.hoisted(() => ({
+  listFilterViewsFn: vi.fn<() => Promise<TestCaseFilterViewDTO[]>>(() => Promise.resolve([])),
+  createFilterViewFn: vi.fn<(input: { data: unknown }) => Promise<TestCaseFilterViewDTO>>(
+    () => Promise.resolve({} as TestCaseFilterViewDTO),
+  ),
+  updateFilterViewFn: vi.fn<(input: { data: unknown }) => Promise<TestCaseFilterViewDTO>>(
+    () => Promise.resolve({} as TestCaseFilterViewDTO),
+  ),
+  deleteFilterViewFn: vi.fn<(input: { data: unknown }) => Promise<TestCaseFilterViewDTO>>(
+    () => Promise.resolve({} as TestCaseFilterViewDTO),
+  ),
+}));
 vi.mock("@/server/serverFns/testcase/testcase-filter-views", () => ({
-  listFilterViewsFn: vi.fn(() => Promise.resolve([])),
-  createFilterViewFn: vi.fn(),
-  updateFilterViewFn: vi.fn(),
-  deleteFilterViewFn: vi.fn(),
+  listFilterViewsFn,
+  createFilterViewFn,
+  updateFilterViewFn,
+  deleteFilterViewFn,
+}));
+// 任务 20 起列表页壳挂显示选项域（per-user 持久化 hook）：get 回 null = 用默认值
+// （不分组）；任务 29 起用例需注入 orderBy=manual 模拟 manual 档
+const { getTestCaseDisplayOptionsFn, updateTestCaseDisplayOptionsFn } = vi.hoisted(() => ({
+  getTestCaseDisplayOptionsFn: vi.fn<() => Promise<TestCaseDisplayOptions | null>>(() => Promise.resolve(null)),
+  updateTestCaseDisplayOptionsFn: vi.fn<() => Promise<TestCaseDisplayOptions | null>>(() => Promise.resolve(null)),
+}));
+vi.mock("@/server/serverFns/testcase/testcase-display-options", () => ({
+  getTestCaseDisplayOptionsFn,
+  updateTestCaseDisplayOptionsFn,
+}));
+
+// 任务 17 起工具栏挂项目选择 Popover（内嵌 CreateProjectDialog，其 import 链拉进
+// project/workspace serverFn，createServerFn 需 tanstackStart 插件编译）：裁掉对话框；
+// 列表页壳自身的 listProjectsBriefFn（新建项目后刷新花名册）另行空实现
+vi.mock("@/components/project/create-project-dialog", () => ({
+  CreateProjectDialog: () => null,
+}));
+vi.mock("@/server/serverFns/project", () => ({
+  listProjectsBriefFn: vi.fn(() => Promise.resolve([])),
 }));
 
 // 任务 13 起列表页壳引入测试计划 serverFn（圈选入口）：本文件不测计划链路，空实现保模块求值
+vi.mock("@/server/serverFns/testcase/bulk", () => ({
+  bulkUpdateTestCasesFn: vi.fn(() => Promise.resolve({ updated: 0 })),
+}));
 vi.mock("@/server/serverFns/testcase/plans", () => ({
   listPlansFn: vi.fn(() => Promise.resolve({ items: [] })),
   addCasesToPlanFn: vi.fn(),
@@ -122,6 +179,10 @@ class MockIntersectionObserver {
 
 import { TestCaseListView } from "../list-view";
 import type { TestCaseSummary } from "@/server/serverFns/testcase/types";
+import type { TestCaseFilterViewDTO } from "@/server/serverFns/testcase/testcase-filter-views";
+import { DEFAULT_TESTCASE_DISPLAY_OPTIONS, type TestCaseDisplayOptions } from "../display/field-configs";
+import { listTestCaseBoardColumnsFn } from "@/server/serverFns/testcase/testcase-board";
+import { serializeFilters } from "../filters";
 
 const makeCase = (over: Partial<TestCaseSummary> & { id: string }): TestCaseSummary => ({
   sequenceId: 1,
@@ -229,3 +290,487 @@ describe("TestCaseListView 无限滚动（审查 Critical #1 回归）", () => {
     });
   });
 });
+
+// ── 看板列级翻页竞态（审查修复回归）：loadMoreColumn 在途响应遇签名过期丢弃 ──
+// 竞态面：列加载在途 → 切项目（签名变化 → 新 fetchBoard 先完成重置整板）→
+// 旧响应落地。无守卫时旧行追加进新板 + 旧 nextCursor 覆写新 cursor。
+describe("TestCaseListView 看板列加载签名守卫（审查修复回归）", () => {
+  const scopeProjects = [
+    { id: "p1", name: "独立需求", displayId: "STORY", icon: "box" },
+    { id: "p2", name: "Web 平台", displayId: "WEB", icon: "globe" },
+  ];
+
+  it("列加载在途切项目：旧响应丢弃（不追加旧行、后续翻页带新 cursor）", async () => {
+    const user = userEvent.setup();
+    const boardCase = makeCase({ id: "b1", identifier: "BOARD-1", state: "draft" });
+    const staleCase = makeCase({ id: "b2", identifier: "BOARD-2", state: "draft" });
+    const emptyColumns = ["in_review", "approved", "deprecated"].map((key) => ({
+      key,
+      items: [],
+      nextCursor: null,
+    }));
+
+    let resolveStale: (v: {
+      columns: { key: string; items: TestCaseSummary[]; nextCursor: string | null }[];
+    }) => void = () => {};
+    let staleDeferredAssigned = false;
+    let fullFetchCount = 0;
+    // 运行时为 vi.mock 替身，静态类型是真实 fetcher → mock 操作经 vi.fn 视图
+    const boardColumnsMock = listTestCaseBoardColumnsFn as unknown as ReturnType<typeof vi.fn>;
+    boardColumnsMock.mockImplementation(
+      ({ data }: { data: { columns: { key: string; cursor?: string }[]; projectId?: string } }) => {
+        // 列级翻页：挂起直到测试手动放行（模拟在途窗口）
+        if (data.columns[0]?.cursor) {
+          return new Promise((resolve) => {
+            staleDeferredAssigned = true;
+            resolveStale = () =>
+              resolve({
+                columns: [
+                  { key: "draft", items: [staleCase], nextCursor: "cursor-stale" },
+                  ...emptyColumns,
+                ],
+              });
+          });
+        }
+        fullFetchCount += 1;
+        // 整板拉取：首次 cursor-1，签名变化后的重拉 cursor-2
+        const nextCursor = fullFetchCount === 1 ? "cursor-1" : "cursor-2";
+        return Promise.resolve({
+          columns: [
+            { key: "draft", items: [boardCase], nextCursor },
+            ...emptyColumns,
+          ],
+        });
+      },
+    );
+    listTestCasesFn.mockResolvedValue({ items: [], nextCursor: null });
+
+    // 项目 Popover 菜单项：按可见文本找按钮（Popover 渲染有延迟，waitFor 重试）
+    const projectMenuItem = async (label: string) => {
+      const el = await waitFor(() => {
+        const btn = [...document.querySelectorAll("button")].find((b) =>
+          b.textContent?.includes(label),
+        );
+        if (!btn) throw new Error(`项目菜单项「${label}」未渲染（Popover 未打开？）`);
+        return btn;
+      });
+      return el;
+    };
+
+    render(<TestCaseListView projects={scopeProjects} initialFolders={[]} initialUsers={[]} />);
+
+    // 切到看板：首次整板拉取（p1 / cursor-1）
+    await user.click(await screen.findByRole("button", { name: "看板" }));
+    await waitFor(() => {
+      expect(screen.getByText("BOARD-1")).toBeInTheDocument();
+    });
+
+    // 触发 draft 列加载更多（在途挂起）
+    const loadMoreButtons = screen.getAllByText("加载更多");
+    await user.click(loadMoreButtons[0]!);
+    await waitFor(() => {
+      expect(staleDeferredAssigned).toBe(true);
+    });
+
+    // 在途期间切项目（签名变化 → fetchBoard 重拉重置整板）
+    await user.click(screen.getByText("独立需求"));
+    await user.click(await projectMenuItem("Web 平台"));
+    await waitFor(() => {
+      // 新签名整板重拉完成（p2 / cursor-2）
+      expect(listTestCaseBoardColumnsFn).toHaveBeenLastCalledWith({
+        data: expect.objectContaining({ projectId: "p2" }),
+      });
+    });
+
+    // 旧响应落地：签名过期守卫丢弃——旧行不得追加进新板、cursor 不得覆写。
+    // 放行后清空微任务/定时器队列（无守卫时 setBoardData 在微任务内即追加渲染）
+    resolveStale({
+      columns: [{ key: "draft", items: [staleCase], nextCursor: "cursor-stale" }, ...emptyColumns],
+    });
+    await new Promise((r) => setTimeout(r, 50));
+    expect(screen.getByText("BOARD-1")).toBeInTheDocument();
+    expect(screen.queryByText("BOARD-2")).not.toBeInTheDocument();
+
+    // cursor 未被覆写：再次翻页请求带新签名 cursor-2（而非 cursor-stale）
+    await user.click(screen.getAllByText("加载更多")[0]!);
+    const cursorCalls = boardColumnsMock.mock.calls.filter(
+      (c: unknown[]) =>
+        !!(c[0] as { data: { columns: { cursor?: string }[] } }).data.columns[0]?.cursor,
+    );
+    expect(
+      (cursorCalls[cursorCalls.length - 1]![0] as { data: { columns: { cursor?: string }[] } })
+        .data.columns[0]!.cursor,
+    ).toBe("cursor-2");
+  });
+
+  it("看板搜索：searchText 随看板请求下发（任务 27 补 boardSchema 漏收）", async () => {
+    const user = userEvent.setup();
+    listTestCasesFn.mockResolvedValue({ items: [], nextCursor: null });
+    render(<TestCaseListView projects={projects} initialFolders={[]} initialUsers={[]} />);
+
+    await user.click(await screen.findByRole("button", { name: "看板" }));
+    await waitFor(() => {
+      expect(listTestCaseBoardColumnsFn).toHaveBeenCalled();
+    });
+
+    // 工具栏搜索（300ms 防抖）→ boardRequestBase 补传 searchText → 整板重拉携带
+    await user.type(await screen.findByPlaceholderText("搜索用例"), "支付");
+    await waitFor(
+      () => {
+        expect(listTestCaseBoardColumnsFn).toHaveBeenLastCalledWith({
+          data: expect.objectContaining({ searchText: "支付" }),
+        });
+      },
+      { timeout: 2000 },
+    );
+  });
+});
+
+// ── 看板整板拉取 in-flight 治理（任务 33 必带③，二期 finding C 归宿）──
+// 竞态面：整板拉取在途 → 签名变化（切项目）。此前的 inflight.has("") 早退会把
+// 新签名的重拉请求整个吞掉——看板滞留旧筛选数据直到下次外部触发。修复后整板
+// 拉取不设早退（fetchCases 同口径），过期响应由签名守卫丢弃。
+describe("TestCaseListView 看板整板拉取 in-flight 治理（任务 33 必带③回归）", () => {
+  it("整板在途切项目：新签名重拉不被早退吞掉，旧响应落地被签名守卫丢弃", async () => {
+    const user = userEvent.setup();
+    const scopeProjects = [
+      { id: "p1", name: "独立需求", displayId: "STORY", icon: "box" },
+      { id: "p2", name: "Web 平台", displayId: "WEB", icon: "globe" },
+    ];
+    const p1Case = makeCase({ id: "p1b", identifier: "BOARD-P1", state: "draft" });
+    const p2Case = makeCase({ id: "p2b", identifier: "BOARD-P2", state: "draft" });
+    const emptyColumns = ["in_review", "approved", "deprecated"].map((key) => ({
+      key,
+      items: [],
+      nextCursor: null,
+    }));
+
+    let resolveP1: (v: {
+      columns: { key: string; items: TestCaseSummary[]; nextCursor: string | null }[];
+    }) => void = () => {};
+    // 运行时为 vi.mock 替身，静态类型是真实 fetcher → mock 操作经 vi.fn 视图
+    const boardColumnsMock = listTestCaseBoardColumnsFn as unknown as ReturnType<typeof vi.fn>;
+    boardColumnsMock.mockImplementation(
+      ({ data }: { data: { columns: { key: string }[]; projectId?: string } }) => {
+        if (data.projectId === "p1") {
+          // p1 整板拉取：挂起直到测试手动放行（模拟在途窗口）
+          return new Promise((resolve) => {
+            resolveP1 = () =>
+              resolve({
+                columns: [
+                  { key: "draft", items: [p1Case], nextCursor: null },
+                  ...emptyColumns,
+                ],
+              });
+          });
+        }
+        return Promise.resolve({
+          columns: [{ key: "draft", items: [p2Case], nextCursor: null }, ...emptyColumns],
+        });
+      },
+    );
+    listTestCasesFn.mockResolvedValue({ items: [], nextCursor: null });
+
+    const projectMenuItem = async (label: string) => {
+      const el = await waitFor(() => {
+        const btn = [...document.querySelectorAll("button")].find((b) =>
+          b.textContent?.includes(label),
+        );
+        if (!btn) throw new Error(`项目菜单项「${label}」未渲染（Popover 未打开？）`);
+        return btn;
+      });
+      return el;
+    };
+
+    render(<TestCaseListView projects={scopeProjects} initialFolders={[]} initialUsers={[]} />);
+
+    // 切到看板：首次整板拉取（p1）在途挂起
+    await user.click(await screen.findByRole("button", { name: "看板" }));
+    await waitFor(() => {
+      expect(boardColumnsMock).toHaveBeenCalledWith({
+        data: expect.objectContaining({ projectId: "p1" }),
+      });
+    });
+
+    // 在途期间切项目：签名变化 → 新 fetchBoard 必须发出
+    //（修复前被 inflight.has("") 早退吞掉，看板滞留旧数据）
+    await user.click(screen.getByText("独立需求"));
+    await user.click(await projectMenuItem("Web 平台"));
+    await waitFor(() => {
+      expect(boardColumnsMock).toHaveBeenLastCalledWith({
+        data: expect.objectContaining({ projectId: "p2" }),
+      });
+    });
+    // 新项目数据渲染
+    await waitFor(() => {
+      expect(screen.getByText("BOARD-P2")).toBeInTheDocument();
+    });
+
+    // 旧响应放行落地：签名过期守卫丢弃——旧行不得渲染进新板
+    resolveP1({
+      columns: [{ key: "draft", items: [p1Case], nextCursor: null }, ...emptyColumns],
+    });
+    await new Promise((r) => setTimeout(r, 50));
+    expect(screen.queryByText("BOARD-P1")).not.toBeInTheDocument();
+    expect(screen.getByText("BOARD-P2")).toBeInTheDocument();
+  });
+});
+
+// ── manual 档批量移动（任务 29）：照 story-list moveStories 组内一次交换语义。
+// 三断言：①orderBy=manual 批量条显示移动按钮 ②组内首条 canMoveUp=false（上移
+// 禁用）③move 后调 reorderTestCasesFn（整组 boardOrder 重写）。纯函数面见
+// manual-move.test.ts，按钮簇渲染面见 batch-toolbar.test.tsx ──
+describe("TestCaseListView manual 批量移动（任务 29）", () => {
+  const manualPrefs: TestCaseDisplayOptions = {
+    groupBy: "none",
+    orderBy: "manual",
+    orderDir: "asc",
+    properties: ["type", "priority", "state", "assignee"],
+    pageSize: 100,
+  };
+
+  beforeEach(() => {
+    listTestCasesFn.mockResolvedValue({
+      items: [...page1, makeCase({ id: "c3", identifier: "PERF-TC3" })],
+      nextCursor: null,
+    });
+    getTestCaseDisplayOptionsFn.mockResolvedValue(manualPrefs);
+  });
+
+  it("orderBy=manual：勾选第 2 条点上移 → reorderTestCasesFn 按组内新序整组重写 boardOrder", async () => {
+    const user = userEvent.setup();
+    render(<TestCaseListView projects={projects} initialFolders={[]} initialUsers={[]} />);
+    await waitFor(() => {
+      expect(screen.getByText("PERF-TC1")).toBeInTheDocument();
+    });
+    // 批量条 selectedCount=0 不渲染：先勾选行，manual 档批量条浮现移动按钮（断言①）
+    await user.click(await screen.findByRole("checkbox", { name: "PERF-TC2" }));
+    await waitFor(() => {
+      expect(screen.getByRole("button", { name: "组内上移" })).toBeInTheDocument();
+    });
+    await user.click(screen.getByRole("button", { name: "组内上移" }));
+    // 断言③：move 后调 reorderTestCasesFn，targets = 组内全部已加载行的新序
+    await waitFor(() => {
+      expect(reorderTestCasesFn).toHaveBeenCalledWith({
+        data: {
+          items: [
+            { id: "c2", boardOrder: 0 },
+            { id: "c1", boardOrder: 1 },
+            { id: "c3", boardOrder: 2 },
+          ],
+        },
+      });
+    });
+  });
+
+  it("组内首条选中：上移禁用（canMoveUp=false）且不发起 reorder", async () => {
+    const user = userEvent.setup();
+    render(<TestCaseListView projects={projects} initialFolders={[]} initialUsers={[]} />);
+    await waitFor(() => {
+      expect(screen.getByText("PERF-TC1")).toBeInTheDocument();
+    });
+    await user.click(await screen.findByRole("checkbox", { name: "PERF-TC1" }));
+    // 断言②：组内首条 canMoveUp=false
+    await waitFor(() => {
+      expect(screen.getByRole("button", { name: "组内上移" })).toBeInTheDocument();
+      expect(screen.getByRole("button", { name: "组内上移" })).toHaveAttribute("disabled");
+    });
+    expect(screen.getByRole("button", { name: "组内下移" })).not.toHaveAttribute("disabled");
+    expect(reorderTestCasesFn).not.toHaveBeenCalled();
+  });
+
+  it("非 manual 档（默认 sequenceId）不显示移动按钮", async () => {
+    getTestCaseDisplayOptionsFn.mockResolvedValue(null);
+    render(<TestCaseListView projects={projects} initialFolders={[]} initialUsers={[]} />);
+    await waitFor(() => {
+      expect(screen.getByText("PERF-TC1")).toBeInTheDocument();
+    });
+    expect(screen.queryByRole("button", { name: "组内上移" })).toBeNull();
+    expect(screen.queryByRole("button", { name: "组内下移" })).toBeNull();
+  });
+});
+
+// ── 保存筛选视图集成（任务 27 审查 Important 补齐）：table-view.test.tsx 删除
+// 随之丢失的整页流程用例四组面——①应用视图序列化条件达 list/listGroups ②保存
+// 提交 payload 键集收敛 ③切回默认复位 ④legacy 扁平键回落映射 ──
+describe("TestCaseListView 保存筛选视图集成（任务 29 补任务 27 审查项）", () => {
+  const cond = (id: string, property: string, value: string) =>
+    ({ id, property, operator: "is" as const, value });
+  const savedViewRow = (over: Partial<TestCaseFilterViewDTO>): TestCaseFilterViewDTO => ({
+    id: "v1",
+    name: "评审中",
+    description: null,
+    icon: "list",
+    projectId: null,
+    filters: {},
+    displayOptions: {},
+    sortOrder: 0,
+    createdAt: "2026-01-01T00:00:00.000Z",
+    updatedAt: "2026-01-01T00:00:00.000Z",
+    ...over,
+  });
+
+  beforeEach(() => {
+    listTestCasesFn.mockResolvedValue({ items: [], nextCursor: null });
+    listFilterViewsFn.mockResolvedValue([]);
+  });
+
+  it("应用保存视图：conditions 序列化串达 listTestCasesFn/listGroupsFn，groupBy 随视图切换", async () => {
+    const user = userEvent.setup();
+    const serialized = serializeFilters([cond("cond-1", "state", "in_review")]);
+    listFilterViewsFn.mockResolvedValue([
+      savedViewRow({
+        filters: { folderId: null, searchText: "支付", conditions: serialized },
+        displayOptions: { groupBy: "state", view: "list" },
+      }),
+    ]);
+    render(<TestCaseListView projects={projects} initialFolders={[]} initialUsers={[]} />);
+
+    await user.click(await screen.findByRole("button", { name: /默认视图/ }));
+    await user.click(await screen.findByRole("button", { name: "评审中" }));
+    await waitFor(() => {
+      expect(listTestCasesFn).toHaveBeenLastCalledWith({
+        data: expect.objectContaining({ folderId: null, searchText: "支付", filters: serialized }),
+      });
+    });
+    await waitFor(() => {
+      expect(listGroupsFn).toHaveBeenLastCalledWith({
+        data: expect.objectContaining({ groupBy: "state", filters: serialized }),
+      });
+    });
+  });
+
+  it("保存为视图：createFilterViewFn 收敛 conditions + displayOptions 键集（不泄漏 orderBy/properties/pageSize）", async () => {
+    const user = userEvent.setup();
+    render(<TestCaseListView projects={projects} initialFolders={[]} initialUsers={[]} />);
+    await waitFor(() => {
+      expect(screen.getByRole("button", { name: /默认视图/ })).toBeInTheDocument();
+    });
+
+    // 筛选条：条件筛选开关 → 添加条件（FilterRow 双入口取首个，共享件测试同款）→ 状态（默认值草稿即成条件）
+    await user.click(screen.getByRole("button", { name: "条件筛选" }));
+    const addButtons = await screen.findAllByRole("button", { name: /添加条件/ });
+    await user.click(addButtons[0]!);
+    await user.click(await screen.findByRole("button", { name: "状态" }));
+    // FilterRow「保存为视图」→ 对话框提交
+    await user.click(await screen.findByRole("button", { name: "保存为视图" }));
+    await user.type(await screen.findByPlaceholderText("视图名称"), "我的视图");
+    await user.click(screen.getByRole("button", { name: "保存" }));
+
+    await waitFor(() => {
+      expect(createFilterViewFn).toHaveBeenCalledTimes(1);
+    });
+    const data = (
+      createFilterViewFn.mock.calls[0]![0] as {
+        data: { name: string; filters: { conditions?: string }; displayOptions: Record<string, unknown> };
+      }
+    ).data;
+    expect(data.name).toBe("我的视图");
+    expect(data.filters.conditions).toContain('"property":"state"');
+    expect(data.filters.conditions).toContain('"value":"draft"');
+    expect(data.displayOptions).toEqual({ groupBy: "none", view: "list" });
+  });
+
+  it("切回默认视图：filters/groupBy/view 全部复位（列表请求无筛选键，看板与分组不再拉取）", async () => {
+    const user = userEvent.setup();
+    const serialized = serializeFilters([cond("cond-1", "state", "in_review")]);
+    listFilterViewsFn.mockResolvedValue([
+      savedViewRow({
+        filters: { searchText: "支付", conditions: serialized },
+        displayOptions: { groupBy: "state", view: "board" },
+      }),
+    ]);
+    render(<TestCaseListView projects={projects} initialFolders={[]} initialUsers={[]} />);
+
+    // 应用视图：view=board → 看板列拉取一次；groupBy=state → 分组计数拉取一次
+    await user.click(await screen.findByRole("button", { name: /默认视图/ }));
+    await user.click(await screen.findByRole("button", { name: "评审中" }));
+    await waitFor(() => {
+      expect(listTestCaseBoardColumnsFn).toHaveBeenCalledTimes(1);
+      expect(listGroupsFn).toHaveBeenCalledTimes(1);
+    });
+
+    // 切回默认视图
+    await user.click(await screen.findByRole("button", { name: /评审中/ }));
+    await user.click(await screen.findByRole("button", { name: /默认视图/ }));
+    await waitFor(() => {
+      expect(listTestCasesFn).toHaveBeenLastCalledWith({
+        data: expect.objectContaining({ searchText: undefined, filters: undefined, folderId: undefined }),
+      });
+    });
+    // view/groupBy 复位：看板列与分组计数不随复位再拉
+    expect(listTestCaseBoardColumnsFn).toHaveBeenCalledTimes(1);
+    expect(listGroupsFn).toHaveBeenCalledTimes(1);
+  });
+
+  it("legacy 扁平键视图（任务 9-20 存量）：state/priority 键回落映射为 is 条件下发", async () => {
+    const user = userEvent.setup();
+    listFilterViewsFn.mockResolvedValue([
+      savedViewRow({ name: "存量视图", filters: { state: "approved", priority: "p0" } }),
+    ]);
+    render(<TestCaseListView projects={projects} initialFolders={[]} initialUsers={[]} />);
+
+    await user.click(await screen.findByRole("button", { name: /默认视图/ }));
+    await user.click(await screen.findByRole("button", { name: "存量视图" }));
+    await waitFor(() => {
+      expect(listTestCasesFn).toHaveBeenLastCalledWith({
+        data: expect.objectContaining({ filters: expect.stringContaining('"property":"state"') }),
+      });
+    });
+    const lastFilters = (listTestCasesFn.mock.calls.at(-1)![0] as { data: { filters?: string } }).data.filters;
+    expect(lastFilters).toContain('"value":"approved"');
+    expect(lastFilters).toContain('"property":"priority"');
+    expect(lastFilters).toContain('"value":"p0"');
+  });
+});
+
+describe("TestCaseListView 列表分页接线（PR-8 审查 B）", () => {
+  it("requestParams 下发 take = min(pageSize, 200)：默认显示选项 pageSize=100", async () => {
+    listTestCasesFn.mockResolvedValue({ items: [], nextCursor: null });
+    render(<TestCaseListView projects={projects} initialFolders={[]} initialUsers={[]} />);
+
+    await waitFor(() => {
+      expect(listTestCasesFn).toHaveBeenLastCalledWith({
+        data: expect.objectContaining({ take: 100 }),
+      });
+    });
+  });
+
+  it("存储偏好 pageSize 收敛进 take；超服务端上限（max 200）封顶不放宽", async () => {
+    listTestCasesFn.mockResolvedValue({ items: [], nextCursor: null });
+    // 类型上 pageSize 属 TESTCASE_PAGE_SIZE_OPTIONS 联合，500 走客户端 Math.min
+    // 封顶断言（hook mock 直resolve，绕过 parseStoredOptions 白名单）
+    getTestCaseDisplayOptionsFn.mockResolvedValue({
+      ...DEFAULT_TESTCASE_DISPLAY_OPTIONS,
+      pageSize: 500,
+    } as unknown as TestCaseDisplayOptions);
+    render(<TestCaseListView projects={projects} initialFolders={[]} initialUsers={[]} />);
+
+    await waitFor(() => {
+      expect(listTestCasesFn).toHaveBeenLastCalledWith({
+        data: expect.objectContaining({ take: 200 }),
+      });
+    });
+  });
+});
+
+// ── 首载动画延迟门控（follow-up A）：listTestCasesFn 永不 resolve 模拟真实等待 ──
+// 快请求（<400ms 完成）不得闪「数据加载中」；真实慢请求超时后动画照常出现。
+describe("TestCaseListView 首载动画延迟（follow-up A）", () => {
+  it("首载在途 400ms 内不渲染「数据加载中」，超时后出现", async () => {
+    listTestCasesFn.mockImplementation(() => new Promise(() => {}));
+    vi.useFakeTimers();
+    try {
+      render(<TestCaseListView projects={projects} initialFolders={[]} initialUsers={[]} />);
+      await act(async () => {}); // flush effects（deferred 初始 false）
+      expect(screen.queryByText("数据加载中")).not.toBeInTheDocument();
+
+      act(() => {
+        vi.advanceTimersByTime(400);
+      });
+      expect(screen.getByText("数据加载中")).toBeInTheDocument();
+    } finally {
+      vi.useRealTimers();
+    }
+  });
+});

package/src/components/testcase/__tests__/manual-move.test.ts

@@ -0,0 +1,69 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+// 用例列表 manual 档批量移动纯函数用例（UI 对齐二期 PR-8 任务 29）：
+// computeMove/canMove 照 story views/story-list/move.ts 模式（组内一次交换语义），
+// 用例自 story move.test.ts 同款移植。批量条按钮簇渲染与 reorderTestCasesFn
+// 调用链见 batch-toolbar.test.tsx / list-view.test.tsx 的任务 29 用例。
+import { describe, it, expect } from "vitest";
+import { computeMove, canMove } from "../views/move";
+
+describe("computeMove / canMove（manual 档组内移动）", () => {
+  const sel = (ids: string[]) => new Set(ids);
+
+  it("连续选中块整体上移一条", () => {
+    expect(computeMove(["a", "x", "y", "b"], sel(["x", "y"]), "up")).toEqual(["x", "y", "a", "b"]);
+  });
+
+  it("连续选中块整体下移一条", () => {
+    expect(computeMove(["a", "x", "y", "b"], sel(["x", "y"]), "down")).toEqual(["a", "b", "x", "y"]);
+  });
+
+  it("分散选中块各自上移", () => {
+    expect(computeMove(["a", "x", "b", "y", "c"], sel(["x", "y"]), "up")).toEqual(["x", "a", "y", "b", "c"]);
+  });
+
+  it("单条上移/下移", () => {
+    expect(computeMove(["a", "x", "b"], sel(["x"]), "up")).toEqual(["x", "a", "b"]);
+    expect(computeMove(["a", "x", "b"], sel(["x"]), "down")).toEqual(["a", "b", "x"]);
+  });
+
+  it("组内首条不可上移：原样返回且 canMoveUp=false", () => {
+    expect(computeMove(["x", "y", "a", "b"], sel(["x", "y"]), "up")).toEqual(["x", "y", "a", "b"]);
+    expect(canMove(["x", "y", "a"], sel(["x", "y"]), "up")).toBe(false);
+  });
+
+  it("组内末条不可下移：原样返回且 canMoveDown=false", () => {
+    expect(computeMove(["a", "b", "x", "y"], sel(["x", "y"]), "down")).toEqual(["a", "b", "x", "y"]);
+    expect(canMove(["a", "x", "y"], sel(["x", "y"]), "down")).toBe(false);
+  });
+
+  it("全选时原样返回", () => {
+    expect(computeMove(["a", "b", "c"], sel(["a", "b", "c"]), "up")).toEqual(["a", "b", "c"]);
+    expect(canMove(["a", "b", "c"], sel(["a", "b", "c"]), "up")).toBe(false);
+  });
+
+  it("canMove 方向判定：存在选中项邻侧未选中邻居才可移动", () => {
+    expect(canMove(["a", "x", "y"], sel(["x", "y"]), "up")).toBe(true);
+    expect(canMove(["x", "y", "a"], sel(["x", "y"]), "down")).toBe(true);
+  });
+
+  it("空选中返回 false", () => {
+    expect(canMove(["a", "b"], sel([]), "up")).toBe(false);
+    expect(canMove(["a", "b"], sel([]), "down")).toBe(false);
+  });
+});