@allbluecn/web-app 0.5.1 → 0.6.1

package/src/server/serverFns/iteration/__tests__/auto-schedule-core.test.ts

@@ -0,0 +1,62 @@
+// 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/>.
+
+import { describe, it, expect } from "vitest";
+import { planMissingIterations } from "../auto-schedule-core";
+
+const cfg = { title: "Sprint", durationDays: 14, cooldownDays: 0, startsOn: "2026-09-01", futureCount: 2, lastSeq: 0 };
+
+describe("planMissingIterations（规格 §3.6）", () => {
+  it("无现有迭代 → 从 max(startsOn, today) 起补 2 个，命名带递增序号", () => {
+    const { planned, nextSeq } = planMissingIterations(cfg, [], "2026-09-01");
+    expect(planned).toHaveLength(2);
+    expect(planned[0]).toMatchObject({ name: "Sprint 1", startDate: "2026-09-01", endDate: "2026-09-14" });
+    expect(planned[1]).toMatchObject({ name: "Sprint 2", startDate: "2026-09-15", endDate: "2026-09-28" });
+    expect(nextSeq).toBe(2);
+  });
+  it("upcoming 已够数 → 不补", () => {
+    const { planned } = planMissingIterations(cfg, [
+      { startDate: "2026-09-15", endDate: "2026-09-28", archived: false },
+      { startDate: "2026-09-29", endDate: "2026-10-12", archived: false },
+    ], "2026-09-01");
+    expect(planned).toHaveLength(0);
+  });
+  it("anchor 接最晚迭代结束日，cooldown 生效", () => {
+    const { planned } = planMissingIterations(
+      { ...cfg, cooldownDays: 2, lastSeq: 3 },
+      [{ startDate: "2026-09-01", endDate: "2026-09-14", archived: false }],
+      "2026-09-01",
+    );
+    expect(planned[0]).toMatchObject({ name: "Sprint 4", startDate: "2026-09-16" });
+  });
+  it("与现有迭代重叠时顺延至其后", () => {
+    const { planned } = planMissingIterations(cfg, [
+      { startDate: "2026-08-19", endDate: "2026-09-05", archived: false },
+    ], "2026-09-01");
+    expect(planned[0].startDate).toBe("2026-09-06");
+  });
+  it("归档迭代不占用 anchor/不阻断", () => {
+    const { planned } = planMissingIterations(cfg, [
+      { startDate: "2026-09-10", endDate: "2026-09-23", archived: true },
+    ], "2026-09-01");
+    expect(planned[0].startDate).toBe("2026-09-01");
+  });
+  it("startsOn 在过去时从今天起", () => {
+    const { planned } = planMissingIterations({ ...cfg, startsOn: "2026-08-01" }, [], "2026-09-01");
+    expect(planned[0].startDate).toBe("2026-09-01");
+  });
+});

package/src/server/serverFns/iteration/__tests__/burndown-core.test.ts

@@ -0,0 +1,90 @@
+import { describe, it, expect } from "vitest";
+import { computeBurndown } from "../burndown-core";
+
+// 输入构造器：迭代 09-01~09-05（5 天），时区 Asia/Shanghai
+const base = {
+  startDate: "2026-09-01",
+  endDate: "2026-09-05",
+  timezone: "Asia/Shanghai",
+};
+
+describe("computeBurndown（规格 §3.4）", () => {
+  it("无需求无事件 → 各日 scope=0 pending=0", () => {
+    const r = computeBurndown({
+      ...base,
+      stories: [],
+      stateEvents: [],
+      now: new Date("2026-09-03T04:00:00Z"),
+    });
+    expect(r.points).toHaveLength(3); // 只画到今天
+    expect(r.points[0]).toMatchObject({ date: "2026-09-01", scope: 0, pending: 0 });
+  });
+
+  it("三个需求，第二天完成一个 → day1 pending=3, day2 pending=2", () => {
+    const r = computeBurndown({
+      ...base,
+      stories: [
+        { id: "s1", addedAt: "2026-09-01T02:00:00Z" },
+        { id: "s2", addedAt: "2026-09-01T02:00:00Z" },
+        { id: "s3", addedAt: "2026-09-01T02:00:00Z" },
+      ],
+      stateEvents: [{ storyId: "s1", at: "2026-09-02T06:00:00Z", to: "done" }],
+      now: new Date("2026-09-05T20:00:00Z"),
+    });
+    expect(r.points[0]).toMatchObject({ scope: 3, pending: 3 });
+    expect(r.points[1]).toMatchObject({ scope: 3, pending: 2 });
+  });
+
+  it("中途加入（day3）抬高 scope", () => {
+    const r = computeBurndown({
+      ...base,
+      stories: [
+        { id: "s1", addedAt: "2026-09-01T02:00:00Z" },
+        { id: "s2", addedAt: "2026-09-03T02:00:00Z" },
+      ],
+      stateEvents: [],
+      now: new Date("2026-09-05T20:00:00Z"),
+    });
+    expect(r.points[1]).toMatchObject({ scope: 1 });
+    expect(r.points[2]).toMatchObject({ scope: 2 });
+  });
+
+  it("状态反复变更取最后态（done→in_progress→done）", () => {
+    const r = computeBurndown({
+      ...base,
+      stories: [{ id: "s1", addedAt: "2026-09-01T02:00:00Z" }],
+      stateEvents: [
+        { storyId: "s1", at: "2026-09-02T02:00:00Z", to: "done" },
+        { storyId: "s1", at: "2026-09-03T02:00:00Z", to: "in_progress" },
+        { storyId: "s1", at: "2026-09-04T02:00:00Z", to: "done" },
+      ],
+      now: new Date("2026-09-05T20:00:00Z"),
+    });
+    expect(r.points[1].pending).toBe(0); // day2 done
+    expect(r.points[2].pending).toBe(1); // day3 打回
+    expect(r.points[3].pending).toBe(0); // day4 再 done
+  });
+
+  it("cancelled 计入退出（done 口径）", () => {
+    const r = computeBurndown({
+      ...base,
+      stories: [
+        { id: "s1", addedAt: "2026-09-01T02:00:00Z" },
+        { id: "s2", addedAt: "2026-09-01T02:00:00Z" },
+      ],
+      stateEvents: [{ storyId: "s2", at: "2026-09-02T02:00:00Z", to: "cancelled" }],
+      now: new Date("2026-09-05T20:00:00Z"),
+    });
+    expect(r.points[1].pending).toBe(1);
+  });
+
+  it("领先/滞后判定：today pending < ideal → leading", () => {
+    const r = computeBurndown({
+      ...base,
+      stories: Array.from({ length: 4 }, (_, i) => ({ id: `s${i}`, addedAt: "2026-09-01T02:00:00Z" })),
+      stateEvents: Array.from({ length: 3 }, (_, i) => ({ storyId: `s${i}`, at: "2026-09-01T06:00:00Z", to: "done" })),
+      now: new Date("2026-09-03T02:00:00Z"), // 上海时区 09-03 10:00（20:00Z 会被分桶到 09-04）
+    });
+    expect(r.status).toBe("leading"); // day3: pending=1 < ideal=round(4*3/5)=2
+  });
+});

package/src/server/serverFns/iteration/__tests__/iteration-crud.test.ts

@@ -0,0 +1,211 @@
+// 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/>.
+
+import { describe, it, expect, vi, beforeEach } from "vitest";
+
+vi.mock("@tanstack/react-start", () => ({
+  createServerFn: (config: any) => {
+    const api: any = {
+      _validator: undefined,
+      validator(schema: any) {
+        this._validator = schema;
+        return this;
+      },
+      handler(fn: Function) {
+        const wrapped = async (args: any) => {
+          let data = args?.data;
+          if (this._validator && data !== undefined) {
+            data = this._validator.parse ? this._validator.parse(data) : data;
+          }
+          return fn({ data });
+        };
+        return wrapped;
+      },
+    };
+    return api;
+  },
+}));
+
+vi.mock("@tanstack/react-start/server", () => ({
+  getRequest: () => ({}),
+}));
+
+const mocks = vi.hoisted(() => ({
+  findMany: vi.fn(),
+  findUnique: vi.fn(),
+  create: vi.fn(),
+  update: vi.fn(),
+  delete: vi.fn(),
+  count: vi.fn(),
+  groupBy: vi.fn(),
+  currentSession: vi.fn(),
+}));
+
+vi.mock("@allbluecn/database", () => ({
+  prisma: {
+    iteration: {
+      findMany: mocks.findMany,
+      findUnique: mocks.findUnique,
+      create: mocks.create,
+      update: mocks.update,
+      delete: mocks.delete,
+    },
+    story: { groupBy: mocks.groupBy },
+    iterationAutoSchedule: { findMany: mocks.findMany },
+  },
+  Prisma: {},
+}));
+
+vi.mock("@/server/auth-helpers", () => ({
+  requireAuth: mocks.currentSession,
+}));
+
+import {
+  listIterationsFn,
+  getIterationFn,
+  createIterationsFn,
+  updateIterationsFn,
+  archiveIterationsFn,
+  deleteIterationsFn,
+} from "../iteration-crud";
+
+describe("createIterationsFn", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+    mocks.currentSession.mockResolvedValue({ user: { id: "u1" } });
+  });
+
+  it("日期与现有迭代重叠时拒绝", async () => {
+    mocks.findMany.mockResolvedValue([
+      { startDate: new Date("2026-09-01"), endDate: new Date("2026-09-14"), archived: false },
+    ]);
+    await expect(
+      createIterationsFn({ data: { projectId: "p1", name: "S2", startDate: "2026-09-10", endDate: "2026-09-23" } }),
+    ).rejects.toMatchObject({ message: expect.stringContaining("重叠") });
+  });
+
+  it("合法日期调用 create 且日期按 UTC 0 点入库", async () => {
+    mocks.findMany.mockResolvedValue([]);
+    mocks.create.mockResolvedValue({ id: "i1" });
+    const result = await createIterationsFn({
+      data: { projectId: "p1", name: "S1", startDate: "2026-09-01", endDate: "2026-09-14" },
+    });
+    expect(result).toEqual({ id: "i1" });
+    expect(mocks.create).toHaveBeenCalledWith(
+      expect.objectContaining({
+        data: expect.objectContaining({
+          startDate: new Date("2026-09-01T00:00:00.000Z"),
+          endDate: new Date("2026-09-14T00:00:00.000Z"),
+        }),
+      }),
+    );
+  });
+});
+
+describe("updateIterationsFn", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+    mocks.currentSession.mockResolvedValue({ user: { id: "u1" } });
+  });
+
+  it("completed 迭代锁定编辑（startDate 已过）", async () => {
+    mocks.findUnique.mockResolvedValue({
+      id: "i1",
+      startDate: new Date("2026-08-01"),
+      endDate: new Date("2026-08-14"),
+      archived: false,
+      projectId: "p1",
+    });
+    await expect(updateIterationsFn({ data: { id: "i1", name: "改名" } })).rejects.toMatchObject({
+      message: expect.stringContaining("不可编辑"),
+    });
+  });
+
+  it("改期时校验与其他迭代不重叠", async () => {
+    mocks.findUnique.mockResolvedValue({
+      id: "i1",
+      startDate: new Date("2026-09-01"),
+      endDate: new Date("2026-09-14"),
+      archived: false,
+      projectId: "p1",
+    });
+    mocks.findMany.mockResolvedValue([
+      { startDate: new Date("2026-09-10"), endDate: new Date("2026-09-20") },
+    ]);
+    await expect(
+      updateIterationsFn({ data: { id: "i1", startDate: "2026-09-18", endDate: "2026-09-25" } }),
+    ).rejects.toMatchObject({ message: expect.stringContaining("重叠") });
+  });
+});
+
+describe("listIterationsFn", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+    mocks.currentSession.mockResolvedValue({ user: { id: "u1" } });
+  });
+
+  it("返回带统计与 status 字段", async () => {
+    mocks.findMany.mockResolvedValue([
+      { id: "i1", name: "Sprint 1", description: null, startDate: new Date("2026-09-01"), endDate: new Date("2026-09-14"), archived: false },
+      { id: "i2", name: "Sprint 0", description: null, startDate: new Date("2026-08-19"), endDate: new Date("2026-09-01"), archived: false },
+    ]);
+    mocks.groupBy.mockResolvedValue([
+      { iterationId: "i1", state: "done", _count: { _all: 3 } },
+      { iterationId: "i1", state: "in_progress", _count: { _all: 1 } },
+      { iterationId: "i2", state: "done", _count: { _all: 5 } },
+    ]);
+    const result = await listIterationsFn({ data: { projectId: "p1", includeArchived: false } });
+    expect(result.items).toHaveLength(2);
+    expect(result.items[0].id).toBe("i1");
+    expect(result.items[0].stateCounts).toEqual({ done: 3, in_progress: 1 });
+    expect(result.items[0].storyCount).toBe(4);
+    expect(result.items[0].startDate).toBe("2026-09-01");
+    expect(result.items[0].endDate).toBe("2026-09-14");
+    expect(result.items[1].storyCount).toBe(5);
+  });
+});
+
+describe("archiveIterationsFn", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+    mocks.currentSession.mockResolvedValue({ user: { id: "u1" } });
+  });
+
+  it("归档/取消归档", async () => {
+    mocks.update.mockResolvedValue({ id: "i1" });
+    const r1 = await archiveIterationsFn({ data: { id: "i1", archived: true } });
+    expect(r1.ok).toBe(true);
+    expect(mocks.update).toHaveBeenCalledWith(expect.objectContaining({ data: expect.objectContaining({ archived: true }) }));
+    const r2 = await archiveIterationsFn({ data: { id: "i1", archived: false } });
+    expect(r2.ok).toBe(true);
+    expect(mocks.update).toHaveBeenCalledWith(expect.objectContaining({ data: expect.objectContaining({ archived: false }) }));
+  });
+});
+
+describe("deleteIterationsFn", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+    mocks.currentSession.mockResolvedValue({ user: { id: "u1" } });
+  });
+
+  it("删除迭代", async () => {
+    mocks.delete.mockResolvedValue({ id: "i1" });
+    const r = await deleteIterationsFn({ data: { id: "i1" } });
+    expect(r.ok).toBe(true);
+    expect(mocks.delete).toHaveBeenCalledWith({ where: { id: "i1" } });
+  });
+});

package/src/server/serverFns/iteration/__tests__/iteration-stories.test.ts

@@ -0,0 +1,155 @@
+// 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/>.
+
+import { describe, it, expect, vi, beforeEach } from "vitest";
+
+vi.mock("@tanstack/react-start", () => ({
+  createServerFn: (config: any) => {
+    const api: any = {
+      _validator: undefined,
+      validator(schema: any) {
+        this._validator = schema;
+        return this;
+      },
+      handler(fn: Function) {
+        const wrapped = async (args: any) => {
+          let data = args?.data;
+          if (this._validator && data !== undefined) {
+            data = this._validator.parse ? this._validator.parse(data) : data;
+          }
+          return fn({ data });
+        };
+        return wrapped;
+      },
+    };
+    return api;
+  },
+}));
+
+vi.mock("@tanstack/react-start/server", () => ({
+  getRequest: () => ({}),
+}));
+
+const mocks = vi.hoisted(() => ({
+  findUnique: vi.fn(),
+  update: vi.fn(),
+  updateMany: vi.fn(),
+  create: vi.fn(),
+  createMany: vi.fn(),
+  currentSession: vi.fn(),
+}));
+
+vi.mock("@allbluecn/database", () => ({
+  prisma: {
+    iteration: { findUnique: mocks.findUnique },
+    story: { findUnique: mocks.findUnique, update: mocks.update, updateMany: mocks.updateMany },
+    storyActivity: { create: mocks.create, createMany: mocks.createMany },
+  },
+  Prisma: {},
+}));
+
+vi.mock("@/server/auth-helpers", () => ({
+  requireAuth: mocks.currentSession,
+}));
+
+import { setStoryIterationFn, addStoriesToIterationFn, removeStoryFromIterationFn } from "../iteration-stories";
+
+describe("setStoryIterationFn", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+    mocks.currentSession.mockResolvedValue({ user: { id: "u1" } });
+  });
+
+  it("目标是 completed 迭代时拒绝", async () => {
+    mocks.findUnique.mockResolvedValue({
+      startDate: new Date("2026-08-01"),
+      endDate: new Date("2026-08-14"),
+      archived: false,
+      name: "已完成",
+    });
+    await expect(
+      setStoryIterationFn({ data: { storyId: "s1", iterationId: "i1" } }),
+    ).rejects.toMatchObject({ message: expect.stringContaining("已完成") });
+  });
+
+  it("合法目标更新 story 并记录活动", async () => {
+    mocks.findUnique.mockImplementation(async (args: any) => {
+      if (args.where?.id === "i1") {
+        return { startDate: new Date("2026-09-01"), endDate: new Date("2026-09-14"), archived: false, name: "Sprint 1" };
+      }
+      if (args.where?.id === "s1") {
+        return { iterationId: null, iteration: null };
+      }
+      return null;
+    });
+    mocks.update.mockResolvedValue({ id: "s1" });
+    mocks.create.mockResolvedValue({ id: "a1" });
+    const r = await setStoryIterationFn({ data: { storyId: "s1", iterationId: "i1" } });
+    expect(r.ok).toBe(true);
+    expect(mocks.update).toHaveBeenCalledWith(expect.objectContaining({ data: { iterationId: "i1" } }));
+    const activity = mocks.create.mock.calls[0][0].data;
+    expect(activity.action).toBe("iteration_changed");
+    expect(activity.field).toBe("iterationId");
+    expect(activity.newValue).toBe("Sprint 1");
+  });
+});
+
+describe("addStoriesToIterationFn", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+    mocks.currentSession.mockResolvedValue({ user: { id: "u1" } });
+  });
+
+  it("批量更新并记录活动", async () => {
+    mocks.findUnique.mockResolvedValue({
+      startDate: new Date("2026-09-01"), endDate: new Date("2026-09-14"), archived: false, name: "Sprint 1",
+    });
+    mocks.updateMany.mockResolvedValue({ count: 2 });
+    mocks.createMany.mockResolvedValue(undefined);
+    const r = await addStoriesToIterationFn({ data: { iterationId: "i1", storyIds: ["s1", "s2"] } });
+    expect(r.count).toBe(2);
+    expect(mocks.createMany).toHaveBeenCalledWith(expect.objectContaining({
+      data: expect.arrayContaining([
+        expect.objectContaining({ storyId: "s1", action: "iteration_changed" }),
+        expect.objectContaining({ storyId: "s2", action: "iteration_changed" }),
+      ]),
+    }));
+  });
+});
+
+describe("removeStoryFromIterationFn", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+    mocks.currentSession.mockResolvedValue({ user: { id: "u1" } });
+  });
+
+  it("移出迭代并记录活动", async () => {
+    mocks.findUnique.mockResolvedValue({
+      iterationId: "i1",
+      iteration: { name: "Sprint 1" },
+    });
+    mocks.updateMany.mockResolvedValue({ count: 1 });
+    mocks.create.mockResolvedValue({ id: "a1" });
+    const r = await removeStoryFromIterationFn({ data: { storyId: "s1" } });
+    expect(r.ok).toBe(true);
+    const activity = mocks.create.mock.calls[0][0].data;
+    expect(activity.action).toBe("iteration_changed");
+    expect(activity.field).toBe("iterationId");
+    expect(activity.oldValue).toBe("Sprint 1");
+    expect(activity.newValue).toBeNull();
+  });
+});

package/src/server/serverFns/iteration/__tests__/iteration-transfer.test.ts

@@ -0,0 +1,136 @@
+// 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/>.
+
+import { describe, it, expect, vi, beforeEach } from "vitest";
+
+vi.mock("@tanstack/react-start", () => ({
+  createServerFn: (config: any) => {
+    const api: any = {
+      _validator: undefined,
+      validator(schema: any) {
+        this._validator = schema;
+        return this;
+      },
+      handler(fn: Function) {
+        const wrapped = async (args: any) => {
+          let data = args?.data;
+          if (this._validator && data !== undefined) {
+            data = this._validator.parse ? this._validator.parse(data) : data;
+          }
+          return fn({ data });
+        };
+        return wrapped;
+      },
+    };
+    return api;
+  },
+}));
+
+vi.mock("@tanstack/react-start/server", () => ({
+  getRequest: () => ({}),
+}));
+
+const mocks = vi.hoisted(() => ({
+  findMany: vi.fn(),
+  findUnique: vi.fn(),
+  updateMany: vi.fn(),
+  createMany: vi.fn(),
+  projectFindUnique: vi.fn(),
+  currentSession: vi.fn(),
+}));
+
+vi.mock("@allbluecn/database", () => ({
+  prisma: {
+    iteration: { findUnique: mocks.findUnique },
+    story: { findMany: mocks.findMany, updateMany: mocks.updateMany },
+    storyActivity: { createMany: mocks.createMany },
+    project: { findUnique: mocks.projectFindUnique },
+  },
+  Prisma: {},
+}));
+
+vi.mock("@/server/auth-helpers", () => ({
+  requireAuth: mocks.currentSession,
+}));
+
+import { transferUnfinishedFn } from "../iteration-transfer";
+
+describe("transferUnfinishedFn", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+    mocks.currentSession.mockResolvedValue({ user: { id: "u1" } });
+  });
+
+  it("目标是 completed 迭代时拒绝", async () => {
+    mocks.findUnique.mockResolvedValue({
+      startDate: new Date("2026-08-01"),
+      endDate: new Date("2026-08-14"),
+      archived: false,
+      name: "已完成迭代",
+      projectId: "p1",
+    });
+    await expect(
+      transferUnfinishedFn({ data: { iterationId: "src1", targetIterationId: "tgt1" } }),
+    ).rejects.toMatchObject({ message: expect.stringContaining("已完成") });
+  });
+
+  it("where 断言 state notIn 且 iterationId = 源迭代", async () => {
+    mocks.findUnique.mockResolvedValue({
+      startDate: new Date("2026-09-01"),
+      endDate: new Date("2026-09-14"),
+      archived: false,
+      name: "目标迭代",
+      projectId: "p1",
+    });
+    mocks.findMany.mockResolvedValue([{ id: "s1" }, { id: "s2" }]);
+    mocks.updateMany.mockResolvedValue({ count: 2 });
+    mocks.createMany.mockResolvedValue(undefined);
+    mocks.projectFindUnique.mockResolvedValue({ ownerId: "u1" });
+    const result = await transferUnfinishedFn({ data: { iterationId: "src1", targetIterationId: "tgt1" } });
+    expect(result).toEqual({ count: 2 });
+    const whereArg = mocks.findMany.mock.calls[0][0].where;
+    expect(whereArg.iterationId).toBe("src1");
+    expect(whereArg.state.notIn).toContain("done");
+    expect(whereArg.state.notIn).toContain("cancelled");
+  });
+
+  it("归档目标拒绝", async () => {
+    mocks.findUnique.mockResolvedValue({
+      startDate: new Date("2026-09-01"),
+      endDate: new Date("2026-09-14"),
+      archived: true,
+      name: "归档迭代",
+      projectId: "p1",
+    });
+    await expect(
+      transferUnfinishedFn({ data: { iterationId: "src1", targetIterationId: "tgt1" } }),
+    ).rejects.toMatchObject({ message: expect.stringContaining("迭代不存在") });
+  });
+
+  it("二次调用（无未完成）返回 { count: 0 }，不抛错", async () => {
+    mocks.findUnique.mockResolvedValue({
+      startDate: new Date("2026-09-01"),
+      endDate: new Date("2026-09-14"),
+      archived: false,
+      name: "目标迭代",
+      projectId: "p1",
+    });
+    mocks.findMany.mockResolvedValue([]);
+    const result = await transferUnfinishedFn({ data: { iterationId: "src1", targetIterationId: "tgt1" } });
+    expect(result).toEqual({ count: 0 });
+  });
+});