@allbluecn/web-app 0.17.2 → 0.18.0

package/src/components/testcase/__tests__/convert-bug.test.tsx

@@ -0,0 +1,334 @@
+// 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/>.
+
+// 任务 17：失败手动转 Bug。断言面（简报步骤 1）：
+// ① buildConvertBugDefaults 纯函数：title 含 [TC{seq}]（从 identifier -TC 后数字提取）、
+//    reproduceSteps=快照 steps 同构直拷（失败步 order 之后保留）、actualResult=失败步 actual、
+//    storyId 继承 caseStoryId
+// ② ConvertBugButton 闸门：仅整单失败且未关联 BUG 的用例显示
+// ③ 转单闭环：点击加载 users/projects/labels → CreateBugDialog 预填 → 提交载荷带
+//    source=test_run / runCaseId / storyId / reproduceSteps → onSuccess 回写 onConverted
+// ④ CreateBugDialog defaultValues 预填注入（title/reproduceSteps 直接落到表单）+ 载荷透传
+// ⑤ pendingConfirm 不入客户端载荷（手动转单不过闸门——服务端列默认 false，客户端不传）
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { cleanup, fireEvent, render, screen, waitFor } from "@testing-library/react";
+import { TooltipProvider } from "@allbluecn/ui/tooltip";
+
+const mocks = vi.hoisted(() => ({
+  createBugFn: vi.fn(),
+  ensureBuiltinProjectFn: vi.fn(),
+  listUsersBriefFn: vi.fn(),
+  listLabelsFn: vi.fn(),
+  listProjectsBriefFn: vi.fn(),
+  toastSuccess: vi.fn(),
+  toastError: vi.fn(),
+}));
+
+vi.mock("@tanstack/react-start", () => ({
+  useServerFn: (fn: unknown) => fn,
+}));
+
+vi.mock("@/server/serverFns/bug", () => ({
+  createBugFn: mocks.createBugFn,
+}));
+
+vi.mock("@/server/serverFns/project", () => ({
+  ensureBuiltinProjectFn: mocks.ensureBuiltinProjectFn,
+  listProjectsBriefFn: mocks.listProjectsBriefFn,
+}));
+
+vi.mock("@/server/serverFns/story", () => ({
+  listUsersBriefFn: mocks.listUsersBriefFn,
+  listLabelsFn: mocks.listLabelsFn,
+}));
+
+vi.mock("@allbluecn/ui/toast", () => ({
+  toast: { success: mocks.toastSuccess, error: mocks.toastError },
+}));
+
+vi.mock("@/components/tiptap/notion-like", () => ({
+  NotionDocEditor: () => <div data-testid="notion-doc-editor" />,
+}));
+
+import { ConvertBugButton, buildConvertBugDefaults } from "../runs/convert-bug-button";
+import { CreateBugDialog } from "@/components/bug/create-bug-dialog";
+import type { RunCaseSummary, RunCaseExecutionDetail } from "@/server/serverFns/testcase/types";
+
+const USERS = [
+  { id: "u1", username: "alice", email: "a@test.dev", avatarConfig: null, bgShape: null, bgColor: null },
+];
+const PROJECTS = [{ id: "proj_run", name: "项目R", displayId: "PR", icon: "folder" }];
+const LABELS = [{ id: "l1", name: "前端", color: "blue" }];
+
+const runCase: RunCaseSummary = {
+  id: "rc1",
+  runId: "r1",
+  caseId: "c1",
+  caseIdentifier: "STORY-TC1",
+  caseStoryId: "s1",
+  caseVersion: 3,
+  caseSnapshot: {
+    title: "登录失败提示错误",
+    precondition: "已注册账号",
+    steps: {
+      steps: [
+        { order: 1, action: "打开登录页", expected: "页面正常" },
+        { order: 2, action: "输入错误密码提交", expected: "提示密码错误" },
+        { order: 3, action: "点击找回密码", expected: "跳转找回页" },
+      ],
+    },
+    priority: "p1",
+    type: "functional",
+  },
+  status: "failed",
+  bugId: null,
+  execRunId: null,
+  flaky: false,
+  durationMs: null,
+  startedAt: null,
+  finishedAt: null,
+  executedBy: null,
+  stepResults: null,
+};
+
+const execution: RunCaseExecutionDetail = {
+  id: "rc1",
+  runId: "r1",
+  caseId: "c1",
+  caseVersion: 3,
+  status: "failed",
+  stepResults: [
+    { order: 1, status: "pass" },
+    { order: 2, status: "fail", actual: "提交后无任何提示" },
+    { order: 3, status: "fail", actual: "按钮无响应" },
+  ],
+  actualResult: null,
+  durationMs: null,
+  startedAt: null,
+  finishedAt: null,
+  executedBy: null,
+};
+
+describe("buildConvertBugDefaults（纯函数）", () => {
+  it("title 含 [TC{seq}]（identifier -TC 后数字提取）+ 快照标题", () => {
+    const defaults = buildConvertBugDefaults(runCase, execution);
+    expect(defaults.title).toBe("[TC1] 登录失败提示错误");
+  });
+
+  it("identifier 非 -TC 结尾时兜底取末段，title 始终带方括号标记", () => {
+    const defaults = buildConvertBugDefaults(
+      { ...runCase, caseIdentifier: "STORY-77" },
+      execution,
+    );
+    expect(defaults.title).toBe("[77] 登录失败提示错误");
+  });
+
+  it("reproduceSteps 与快照 steps 同构直拷（同 order/action/expected，失败步之后保留）", () => {
+    const defaults = buildConvertBugDefaults(runCase, execution);
+    expect(defaults.reproduceSteps!.steps).toEqual([
+      { order: 1, action: "打开登录页", expected: "页面正常" },
+      { order: 2, action: "输入错误密码提交", expected: "提示密码错误" },
+      { order: 3, action: "点击找回密码", expected: "跳转找回页" },
+    ]);
+  });
+
+  it("actualResult 取失败步 actual（多个失败步按 order 换行拼接，pass 步不混入）", () => {
+    const defaults = buildConvertBugDefaults(runCase, execution);
+    expect(defaults.reproduceSteps!.actualResult).toBe("提交后无任何提示\n按钮无响应");
+  });
+
+  it("无失败步 actual 时不带 actualResult 字段", () => {
+    const defaults = buildConvertBugDefaults(runCase, {
+      ...execution,
+      stepResults: [{ order: 1, status: "fail" }],
+    });
+    expect(defaults.reproduceSteps!.actualResult).toBeUndefined();
+  });
+
+  it("storyId 继承 caseStoryId", () => {
+    expect(buildConvertBugDefaults(runCase, execution).storyId).toBe("s1");
+    expect(buildConvertBugDefaults({ ...runCase, caseStoryId: null }, execution).storyId).toBeNull();
+  });
+});
+
+describe("ConvertBugButton", () => {
+  function renderButton(
+    over: { runCase?: Partial<RunCaseSummary>; execution?: RunCaseExecutionDetail | null } = {},
+  ) {
+    const onConverted = vi.fn();
+    render(
+      <TooltipProvider>
+        <ConvertBugButton
+          runCase={{ ...runCase, ...over.runCase }}
+          execution={over.execution !== undefined ? over.execution : execution}
+          runProjectId="proj_run"
+          onConverted={onConverted}
+        />
+      </TooltipProvider>,
+    );
+    return { onConverted };
+  }
+
+  beforeEach(() => {
+    vi.clearAllMocks();
+    mocks.createBugFn.mockResolvedValue({ id: "bug_new", identifier: "PR-B1", title: "x" });
+    mocks.listUsersBriefFn.mockResolvedValue(USERS);
+    mocks.listProjectsBriefFn.mockResolvedValue(PROJECTS);
+    mocks.listLabelsFn.mockResolvedValue(LABELS);
+  });
+
+  afterEach(() => {
+    cleanup();
+  });
+
+  it("整单失败且未关联 BUG 时显示按钮", () => {
+    renderButton();
+    expect(screen.getByTestId("convert-bug-button")).toBeTruthy();
+  });
+
+  it("非失败用例不渲染按钮", () => {
+    renderButton({ runCase: { status: "passed" } });
+    expect(screen.queryByTestId("convert-bug-button")).toBeNull();
+  });
+
+  it("已关联 bugId 的失败用例不重复渲染按钮", () => {
+    renderButton({ runCase: { bugId: "bug_existing" } });
+    expect(screen.queryByTestId("convert-bug-button")).toBeNull();
+  });
+
+  it("点击后加载成员/项目/标签并打开对话框，title 预填 [TC{seq}] 快照标题", async () => {
+    renderButton();
+    fireEvent.click(screen.getByTestId("convert-bug-button"));
+    await waitFor(() => expect(mocks.listUsersBriefFn).toHaveBeenCalled());
+    const titleInput = await screen.findByPlaceholderText("简述遇到的问题");
+    await waitFor(() => expect((titleInput as HTMLInputElement).value).toBe("[TC1] 登录失败提示错误"));
+  });
+
+  it("提交载荷：source=test_run + runCaseId + storyId + 快照 reproduceSteps（含失败步 actual）", async () => {
+    renderButton();
+    fireEvent.click(screen.getByTestId("convert-bug-button"));
+    fireEvent.click(await screen.findByRole("button", { name: "创建" }));
+    await waitFor(() => expect(mocks.createBugFn).toHaveBeenCalledTimes(1));
+    const payload = mocks.createBugFn.mock.calls[0][0].data;
+    expect(payload).toEqual(
+      expect.objectContaining({
+        title: "[TC1] 登录失败提示错误",
+        projectId: "proj_run",
+        source: "test_run",
+        runCaseId: "rc1",
+        storyId: "s1",
+        reproduceSteps: expect.objectContaining({
+          steps: [
+            { order: 1, action: "打开登录页", expected: "页面正常" },
+            { order: 2, action: "输入错误密码提交", expected: "提示密码错误" },
+            { order: 3, action: "点击找回密码", expected: "跳转找回页" },
+          ],
+          actualResult: "提交后无任何提示\n按钮无响应",
+        }),
+      }),
+    );
+    // 手动转单不过闸门：客户端不传 pendingConfirm（列默认 false，服务端创建路径不接收该字段）
+    expect(payload.pendingConfirm).toBeUndefined();
+  });
+
+  it("创建成功后 onConverted 回写 bugId", async () => {
+    const { onConverted } = renderButton();
+    fireEvent.click(screen.getByTestId("convert-bug-button"));
+    fireEvent.click(await screen.findByRole("button", { name: "创建" }));
+    await waitFor(() => expect(onConverted).toHaveBeenCalledWith("bug_new"));
+  });
+
+  it("roster 加载失败 toast 报错且不开对话框", async () => {
+    mocks.listUsersBriefFn.mockRejectedValue(new Error("network"));
+    renderButton();
+    fireEvent.click(screen.getByTestId("convert-bug-button"));
+    await waitFor(() => expect(mocks.toastError).toHaveBeenCalled());
+    expect(screen.queryByRole("button", { name: "创建" })).toBeNull();
+  });
+});
+
+describe("CreateBugDialog defaultValues 预填注入", () => {
+  function renderDialog(defaultValues?: React.ComponentProps<typeof CreateBugDialog>["defaultValues"]) {
+    const onSuccess = vi.fn();
+    render(
+      <TooltipProvider>
+        <CreateBugDialog
+          open
+          onOpenChange={vi.fn()}
+          users={USERS}
+          projects={PROJECTS}
+          labels={LABELS}
+          initialProjectId="proj_run"
+          defaultValues={defaultValues}
+          onSuccess={onSuccess}
+        />
+      </TooltipProvider>,
+    );
+    return { onSuccess };
+  }
+
+  beforeEach(() => {
+    vi.clearAllMocks();
+    mocks.createBugFn.mockResolvedValue({ id: "bug_new", identifier: "PR-B1", title: "x" });
+  });
+
+  afterEach(() => {
+    cleanup();
+  });
+
+  it("打开即预填 title 与整体实际结果（reproduceSteps.actualResult）", () => {
+    renderDialog({
+      title: "[TC9] 预填标题",
+      reproduceSteps: {
+        steps: [{ order: 1, action: "预填步骤", expected: "预期" }],
+        actualResult: "预填实际",
+      },
+      storyId: "s9",
+    });
+    expect((screen.getByPlaceholderText("简述遇到的问题") as HTMLInputElement).value).toBe("[TC9] 预填标题");
+    expect(
+      (screen.getByPlaceholderText("整体实际结果（可选）") as HTMLTextAreaElement).value,
+    ).toBe("预填实际");
+    expect(screen.getByDisplayValue("预填步骤")).toBeTruthy();
+  });
+
+  it("提交载荷透传 storyId/source/runCaseId", async () => {
+    renderDialog({
+      title: "[TC9] 预填标题",
+      reproduceSteps: { steps: [{ order: 1, action: "预填步骤" }] },
+      storyId: "s9",
+      source: "test_run",
+      runCaseId: "rc9",
+    });
+    fireEvent.click(screen.getByRole("button", { name: "创建" }));
+    await waitFor(() => expect(mocks.createBugFn).toHaveBeenCalledTimes(1));
+    expect(mocks.createBugFn.mock.calls[0][0].data).toEqual(
+      expect.objectContaining({ title: "[TC9] 预填标题", storyId: "s9", source: "test_run", runCaseId: "rc9" }),
+    );
+  });
+
+  it("不传 defaultValues 时载荷不带 storyId/source/runCaseId（手动创建回归）", async () => {
+    renderDialog();
+    fireEvent.change(screen.getByPlaceholderText("简述遇到的问题"), { target: { value: "手动标题" } });
+    fireEvent.click(screen.getByRole("button", { name: "创建" }));
+    await waitFor(() => expect(mocks.createBugFn).toHaveBeenCalledTimes(1));
+    const payload = mocks.createBugFn.mock.calls[0][0].data;
+    expect(payload.storyId).toBeUndefined();
+    expect(payload.source).toBeUndefined();
+    expect(payload.runCaseId).toBeUndefined();
+  });
+});

package/src/components/testcase/__tests__/detail-properties.test.tsx

@@ -0,0 +1,342 @@
+// 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/>.
+
+// 任务 12：用例详情页。断言面（简报步骤 1）：
+// ① 属性栏全行内编辑：state/priority/type/folder/assignee/story 链接 + automation 只读徽标 + version/identifier 只读
+// ② 主区只读：前置条件与步骤（无输入框）
+// ③ 活动时间线渲染 ProjectActivity（targetType=testcase mock：created/deleted）
+// ④ exec-history / related-bugs 空态（P1 无数据）
+// ⑤ 标题行内编辑失焦保存（expectedVersion 乐观锁）+ 属性行内编辑（state/story）
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { act, cleanup, render, screen, waitFor, within } from "@testing-library/react";
+import userEvent from "@testing-library/user-event";
+import * as React from "react";
+
+vi.mock("@tanstack/react-start", () => ({
+  useServerFn: (fn: unknown) => fn,
+}));
+
+// 任务 30 后 case-detail-body 引入 automation 面板，import 链拉进 automation
+// serverFn（createServerFn 需 tanstackStart 插件编译）——Proxy 全量 mock
+// （peek-panel/list-view 同款先例；本测试只测详情属性区，不触达面板）
+vi.mock("@/server/serverFns/testcase/automation", () => ({
+  get(target: Record<string, unknown>, prop: string | symbol) {
+    if (typeof prop === "symbol") return undefined;
+    if (!(prop in target)) target[prop] = vi.fn();
+    return target[prop];
+  },
+}));
+
+const { updateTestCaseFn, listStoriesFn } = vi.hoisted(() => ({
+  updateTestCaseFn: vi.fn(),
+  listStoriesFn: vi.fn(),
+}));
+
+vi.mock("@tanstack/react-router", () => ({
+  // 桌面 Link：把 to + params 展开为 href，供断言关联需求链接指向
+  Link: ({
+    to,
+    params,
+    ...rest
+  }: { to?: string; params?: Record<string, string> } & React.ComponentProps<"a">) => (
+    <a
+      {...rest}
+      href={
+        typeof to === "string"
+          ? to.replace(/\$(\w+)/g, (_, k: string) => params?.[k] ?? "")
+          : undefined
+      }
+    />
+  ),
+  useNavigate: () => vi.fn(),
+}));
+
+vi.mock("@/server/serverFns/testcase/testcase-crud", () => ({
+  getTestCaseFn: vi.fn(),
+  listTestCasesFn: vi.fn(),
+  createTestCaseFn: vi.fn(),
+  updateTestCaseFn,
+  archiveTestCaseFn: vi.fn(),
+  deleteTestCaseFn: vi.fn(),
+}));
+
+vi.mock("@/server/serverFns/story", () => ({
+  listStoriesFn,
+}));
+
+import { CaseDetailBody } from "../detail/case-detail-body";
+import type { TestCaseDetail, TestCaseActivityItem } from "@/server/serverFns/testcase/types";
+import type { FolderNodeDto } from "../folder-tree";
+
+const folders: FolderNodeDto[] = [
+  { id: "f1", parentId: null, name: "登录模块", position: 0 },
+];
+
+const baseCase: TestCaseDetail = {
+  id: "c1",
+  sequenceId: 1,
+  identifier: "PERF-TC1",
+  projectId: "p1",
+  folderId: "f1",
+  storyId: "s1",
+  title: "登录成功跳转仪表盘",
+  precondition: "已注册账号",
+  steps: {
+    steps: [
+      { order: 1, action: "输入正确密码", expected: "跳转仪表盘" },
+      { order: 2, action: "点击登录" },
+    ],
+  },
+  type: "functional",
+  priority: "p1",
+  state: "approved",
+  version: 3,
+  automation: "none",
+  aiGenerated: false,
+  assignee: { id: "u1", username: "alice", email: "a@x.com", avatarConfig: null, bgShape: null, bgColor: null },
+  createdBy: { id: "u1", username: "alice", email: "a@x.com", avatarConfig: null, bgShape: null, bgColor: null },
+  archived: false,
+  createdAt: "2026-01-01T00:00:00.000Z",
+  updatedAt: "2026-01-01T00:00:00.000Z",
+  story: { id: "s1", identifier: "PERF-1", name: "登录链路优化" },
+};
+
+const activities: TestCaseActivityItem[] = [
+  {
+    id: "a1",
+    action: "created",
+    createdAt: "2026-01-01T00:00:00.000Z",
+    user: { id: "u1", username: "alice", email: "a@x.com", avatarConfig: null, bgShape: null, bgColor: null },
+  },
+  {
+    id: "a2",
+    action: "deleted",
+    createdAt: "2026-01-02T00:00:00.000Z",
+    user: { id: "u2", username: "bob", email: "b@x.com", avatarConfig: null, bgShape: null, bgColor: null },
+  },
+  {
+    id: "a3",
+    action: "updated",
+    createdAt: "2026-01-03T00:00:00.000Z",
+    user: { id: "u1", username: "alice", email: "a@x.com", avatarConfig: null, bgShape: null, bgColor: null },
+  },
+];
+
+const users = [
+  { id: "u1", username: "alice", email: "a@x.com", avatarConfig: null, bgShape: null, bgColor: null },
+  { id: "u2", username: "bob", email: "b@x.com", avatarConfig: null, bgShape: null, bgColor: null },
+];
+
+function renderDetail(over: Partial<TestCaseDetail> = {}) {
+  return render(
+    <CaseDetailBody testCase={{ ...baseCase, ...over }} users={users} folders={folders} activities={activities} />,
+  );
+}
+
+beforeEach(() => {
+  vi.clearAllMocks();
+  updateTestCaseFn.mockImplementation(({ data }: { data: { id: string; expectedVersion?: number } }) =>
+    Promise.resolve({
+      ...baseCase,
+      ...data,
+      story: undefined,
+    }),
+  );
+  listStoriesFn.mockResolvedValue({
+    items: [
+      { id: "s2", identifier: "PERF-2", name: "新需求", state: "todo", priority: "high", projectId: "p1" },
+      { id: "s3", identifier: "PERF-3", name: "第三需求", state: "todo", priority: "medium", projectId: "p1" },
+    ],
+    total: 2,
+    hasMore: false,
+  });
+});
+
+afterEach(() => {
+  cleanup();
+});
+
+describe("CaseDetailBody 属性栏", () => {
+  it("渲染行内编辑器（state/priority/type/folder/assignee/story 链接）与只读字段（identifier/version/automation）", () => {
+    renderDetail();
+
+    // 只读三件套：identifier / version / automation 徽标
+    expect(screen.getByTestId("case-detail-identifier")).toHaveTextContent("PERF-TC1");
+    expect(screen.getByTestId("case-detail-version")).toHaveTextContent("3");
+    expect(screen.getByTestId("case-detail-automation")).toHaveTextContent("未自动化");
+
+    // 行内编辑行全部渲染
+    expect(screen.getByTestId("property-state")).toHaveTextContent("已批准");
+    expect(screen.getByTestId("property-priority")).toHaveTextContent("P1");
+    expect(screen.getByTestId("property-type")).toHaveTextContent("功能");
+    expect(screen.getByTestId("property-folder")).toHaveTextContent("登录模块");
+    expect(screen.getByTestId("property-assignee")).toHaveTextContent("alice");
+    // story 链接：显示关联需求标识 + 指向需求详情的链接
+    expect(screen.getByTestId("property-story")).toHaveTextContent("PERF-1");
+    expect(screen.getByTestId("property-story-link")).toHaveAttribute(
+      "href",
+      expect.stringContaining("/stories/s1"),
+    );
+  });
+
+  it("主区只读：前置条件与步骤渲染文本，无输入框", () => {
+    renderDetail();
+
+    expect(screen.getByTestId("detail-precondition")).toHaveTextContent("已注册账号");
+    const steps = screen.getByTestId("detail-steps");
+    expect(steps).toHaveTextContent("输入正确密码");
+    expect(steps).toHaveTextContent("跳转仪表盘");
+    expect(steps).toHaveTextContent("点击登录");
+    expect(steps.querySelectorAll("input, textarea")).toHaveLength(0);
+  });
+
+  it("无前置条件时渲染占位符", () => {
+    renderDetail({ precondition: null });
+    expect(screen.getByTestId("detail-precondition")).toBeInTheDocument();
+  });
+});
+
+describe("CaseDetailBody 活动时间线", () => {
+  it("渲染 ProjectActivity（targetType=testcase）：user + action 文案", () => {
+    renderDetail();
+
+    expect(screen.getByTestId("case-activity-a1")).toHaveTextContent("alice");
+    expect(screen.getByTestId("case-activity-a1")).toHaveTextContent("创建了用例");
+    expect(screen.getByTestId("case-activity-a2")).toHaveTextContent("bob");
+    expect(screen.getByTestId("case-activity-a2")).toHaveTextContent("删除了用例");
+    expect(screen.getByTestId("case-activity-a3")).toHaveTextContent("更新了用例");
+  });
+});
+
+describe("CaseDetailBody 空态 tabs", () => {
+  it("执行历史 / 关联 Bug 渲染空态（P1 无数据）", async () => {
+    const user = userEvent.setup();
+    renderDetail();
+
+    await user.click(screen.getByRole("button", { name: "执行历史" }));
+    expect(screen.getByTestId("detail-exec-empty")).toHaveTextContent("暂无执行记录");
+
+    await user.click(screen.getByRole("button", { name: "关联 Bug" }));
+    expect(screen.getByTestId("detail-bugs-empty")).toHaveTextContent("暂无关联 Bug");
+  });
+});
+
+describe("CaseDetailBody 行内编辑", () => {
+  it("标题失焦保存：updateTestCaseFn 带 expectedVersion 乐观锁，成功后版本 +1", async () => {
+    const user = userEvent.setup();
+    updateTestCaseFn.mockResolvedValue({ ...baseCase, title: "登录成功跳转工作台", version: 4, story: undefined });
+    renderDetail();
+
+    const title = screen.getByRole("textbox", { name: "用例标题" });
+    await user.clear(title);
+    await user.type(title, "登录成功跳转工作台");
+    await user.tab();
+
+    await waitFor(() => {
+      expect(updateTestCaseFn).toHaveBeenCalledWith({
+        data: { id: "c1", expectedVersion: 3, title: "登录成功跳转工作台" },
+      });
+    });
+    await waitFor(() => {
+      expect(screen.getByTestId("case-detail-version")).toHaveTextContent("4");
+    });
+  });
+
+  it("切换状态：updateTestCaseFn 收 state patch（元数据变更不 bump version）", async () => {
+    const user = userEvent.setup();
+    renderDetail();
+
+    // StateEditor 触发器（行内 span）点击 → 弹层选项
+    await user.click(within(screen.getByTestId("property-state")).getByText("已批准"));
+    await waitFor(() => {
+      expect(screen.getByRole("button", { name: "评审中" })).toBeInTheDocument();
+    });
+    await user.click(screen.getByRole("button", { name: "评审中" }));
+
+    await waitFor(() => {
+      expect(updateTestCaseFn).toHaveBeenCalledWith({
+        data: { id: "c1", expectedVersion: 3, state: "in_review" },
+      });
+    });
+  });
+
+  it("切换关联需求：弹出选择器（listStoriesFn 搜索），选择后 updateTestCaseFn 收 storyId", async () => {
+    const user = userEvent.setup();
+    renderDetail();
+
+    // StoryLinkEditor 触发器（值 span）点击 → 弹层（listStoriesFn 拉候选列表）
+    await user.click(screen.getByTestId("property-story-value"));
+    await waitFor(
+      () => {
+        expect(listStoriesFn).toHaveBeenCalled();
+      },
+      { timeout: 3000 },
+    );
+    const option = await screen.findByTestId("story-option-s2", {}, { timeout: 3000 });
+    await user.click(option);
+
+    await waitFor(() => {
+      expect(updateTestCaseFn).toHaveBeenCalledWith({
+        data: { id: "c1", expectedVersion: 3, storyId: "s2" },
+      });
+    });
+    await waitFor(() => {
+      expect(screen.getByTestId("property-story")).toHaveTextContent("PERF-2");
+    });
+  });
+
+  it("竞态回归：story 编辑 A 成功收敛后，最新编辑 B 失败回滚到 A 的服务端真值（非 B 意图）", async () => {
+    const user = userEvent.setup();
+    // A（story→s2）服务端成功但响应挂起；B（story→s3）后发出、后失败
+    let resolveA!: (v: unknown) => void;
+    let rejectB!: (e: Error) => void;
+    updateTestCaseFn
+      .mockImplementationOnce(() => new Promise((res) => { resolveA = res; }))
+      .mockImplementationOnce(() => new Promise((_, rej) => { rejectB = rej; }));
+    renderDetail();
+
+    // 编辑 A：story → s2（乐观显示 PERF-2，响应挂起）
+    await user.click(screen.getByTestId("property-story-value"));
+    await user.click(await screen.findByTestId("story-option-s2", {}, { timeout: 3000 }));
+    await waitFor(() => {
+      expect(screen.getByTestId("property-story")).toHaveTextContent("PERF-2");
+    });
+
+    // 编辑 B：story → s3（最新编辑，乐观显示 PERF-3）
+    await user.click(screen.getByTestId("property-story-value"));
+    await user.click(await screen.findByTestId("story-option-s3", {}, { timeout: 3000 }));
+    await waitFor(() => {
+      expect(screen.getByTestId("property-story")).toHaveTextContent("PERF-3");
+    });
+
+    // A 后到收敛：story 收敛值用 A 捕获的实参（s2），不得被镜像（B 意图 s3）污染；
+    // UI 仍显示 B 的乐观意图
+    await act(async () => {
+      resolveA({ ...baseCase, story: undefined });
+    });
+    expect(screen.getByTestId("property-story")).toHaveTextContent("PERF-3");
+
+    // B 失败回滚 → 恢复 serverCaseRef = A 的服务端真值 s2
+    await act(async () => {
+      rejectB(new Error("版本冲突"));
+    });
+    await waitFor(() => {
+      expect(screen.getByTestId("property-story")).toHaveTextContent("PERF-2");
+    });
+    expect(screen.getByTestId("property-story")).not.toHaveTextContent("PERF-3");
+  });
+});