@allbluecn/web-app 0.5.0 → 0.6.0

package/src/routes/api/attachments/upload.ts

@@ -0,0 +1,148 @@
+// 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 { createFileRoute } from "@tanstack/react-router";
+import { prisma } from "@allbluecn/database";
+import { requireAuth, requireUserInDb } from "@/server/auth-helpers";
+import { ACTIVITY_SELECT, toActivityItem } from "@/server/serverFns/story/types";
+import { inferMimeType } from "@/components/story/relations/format";
+
+const MAX_FILE_SIZE = 10 * 1024 * 1024;
+
+export const Route = createFileRoute("/api/attachments/upload")({
+  server: {
+    handlers: {
+      POST: async ({ request }) => {
+        try {
+          const session = await requireAuth(request);
+          const userId = session.user!.id!;
+          await requireUserInDb(userId);
+
+          const formData = await request.formData();
+          const storyId = formData.get("storyId");
+          const file = formData.get("file");
+          const rawDescription = formData.get("description");
+          const description =
+            typeof rawDescription === "string" && rawDescription.trim()
+              ? rawDescription.trim().slice(0, 500)
+              : null;
+          const attachmentId = formData.get("attachmentId") as string | null;
+          const fileHash = formData.get("fileHash") as string | null;
+          if (typeof storyId !== "string" || !storyId) {
+            return Response.json({ error: "缺少 storyId" }, { status: 400 });
+          }
+          if (!(file instanceof File)) {
+            return Response.json({ error: "缺少文件" }, { status: 400 });
+          }
+          if (file.size <= 0 || file.size > MAX_FILE_SIZE) {
+            return Response.json({ error: "文件大小需在 10MB 以内" }, { status: 400 });
+          }
+
+          const story = await prisma.story.findUnique({
+            where: { id: storyId },
+            select: { id: true },
+          });
+          if (!story) {
+            return Response.json({ error: "需求不存在" }, { status: 404 });
+          }
+
+          const bytes = new Uint8Array(await file.arrayBuffer());
+          let attachment;
+          let activity;
+
+          if (attachmentId) {
+            // 编辑模式：替换现有附件
+            attachment = await prisma.storyAttachment.update({
+              where: { id: attachmentId },
+              data: {
+                fileName: file.name.slice(0, 255),
+                fileSize: BigInt(file.size),
+                mimeType: inferMimeType(file.name, file.type),
+                description,
+                bytes,
+                fileHash: fileHash ?? null,
+              },
+            });
+            activity = await prisma.storyActivity.create({
+              data: {
+                storyId,
+                userId,
+                action: "attachment_updated",
+                newValue: file.name.slice(0, 255),
+              },
+              select: ACTIVITY_SELECT,
+            });
+          } else {
+            // 新增模式：先检查同 story 是否已有相同 hash 的附件
+            const existing = fileHash
+              ? await prisma.storyAttachment.findFirst({
+                  where: { storyId, fileHash },
+                  select: { id: true },
+                })
+              : null;
+            if (existing) {
+              return Response.json({ duplicated: true, existingId: existing.id }, { status: 200 });
+            }
+            attachment = await prisma.storyAttachment.create({
+              data: {
+                storyId,
+                fileName: file.name.slice(0, 255),
+                fileSize: BigInt(file.size),
+                mimeType: inferMimeType(file.name, file.type),
+                description,
+                storageUrl: "pending",
+                bytes,
+                fileHash: fileHash ?? null,
+              },
+            });
+            const storageUrl = `/api/attachments/${attachment.id}/content`;
+            await prisma.storyAttachment.update({
+              where: { id: attachment.id },
+              data: { storageUrl },
+            });
+            activity = await prisma.storyActivity.create({
+              data: {
+                storyId,
+                userId,
+                action: "attachment_added",
+                newValue: file.name.slice(0, 255),
+              },
+              select: ACTIVITY_SELECT,
+            });
+          }
+
+          const storageUrl = `/api/attachments/${attachment.id}/content`;
+
+          return Response.json({
+            id: attachment.id,
+            fileName: attachment.fileName,
+            fileSize: Number(attachment.fileSize),
+            mimeType: attachment.mimeType,
+            description: attachment.description,
+            storageUrl,
+            fileHash: attachment.fileHash,
+            activity: toActivityItem(activity),
+          });
+        } catch (e) {
+          const message = e instanceof Error ? e.message : "上传失败";
+          const status = message === "UNAUTHORIZED" ? 401 : 500;
+          return Response.json({ error: message }, { status });
+        }
+      },
+    },
+  },
+});

package/src/routes/share/prd/$prdId/route.tsx

@@ -0,0 +1,10 @@
+// AUTO-GENERATED by @allbluecn/kernel — DO NOT EDIT
+import { createFileRoute } from '@tanstack/react-router'
+import type { PluginRouteContext } from '@allbluecn/kernel'
+import { prd_route_3 } from '@allbluecn/plugins-core/prd/routes'
+
+export const Route = createFileRoute('/share/prd/$prdId')({
+  beforeLoad: ((ctx: PluginRouteContext) => prd_route_3.beforeLoad(ctx)) as any,
+  validateSearch: prd_route_3.validateSearch as any,
+  component: prd_route_3.Component as any,
+})

package/src/server/serverFns/__tests__/project-kb.test.ts

@@ -0,0 +1,147 @@
+// 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(() => ({
+  pkbFindMany: vi.fn(),
+  pkbDeleteMany: vi.fn(),
+  pkbCreateMany: vi.fn(),
+  kbFindMany: vi.fn(),
+  projectFindMany: vi.fn(),
+  kbFindFirst: vi.fn(),
+  transaction: vi.fn(),
+  currentSession: vi.fn(),
+}));
+
+vi.mock("@allbluecn/database", () => {
+  const prisma = {
+    projectKnowledgeBase: {
+      findMany: mocks.pkbFindMany,
+      deleteMany: mocks.pkbDeleteMany,
+      createMany: mocks.pkbCreateMany,
+    },
+    knowledgeBase: { findMany: mocks.kbFindMany, findFirst: mocks.kbFindFirst },
+    project: { findMany: mocks.projectFindMany },
+    $transaction: mocks.transaction,
+  };
+  return { prisma, Prisma: {} };
+});
+
+vi.mock("@/server/auth-helpers", () => ({ requireAuth: mocks.currentSession }));
+vi.mock("@/server/permissions", () => ({ requirePermission: vi.fn().mockResolvedValue(undefined) }));
+vi.mock("@/server/audit", () => ({ auditLog: vi.fn() }));
+
+import { setProjectKbsFn, listProjectKbsFn } from "../project";
+import { setKbProjectsFn, listKbProjectsFn } from "../knowledge";
+
+beforeEach(() => {
+  vi.clearAllMocks();
+  mocks.currentSession.mockResolvedValue({ user: { id: "u1" } });
+});
+
+describe("setProjectKbsFn 校验", () => {
+  it("仅接受 team 可见性 KB，非 team 抛错且不写库", async () => {
+    mocks.kbFindMany.mockResolvedValue([{ id: "kb1" }]); // 请求 [kb1(team), kb2(general)] 但只查回 kb1
+    await expect(
+      setProjectKbsFn({ data: { projectId: "p1", kbIds: ["kb1", "kb2"] } }),
+    ).rejects.toMatchObject({ message: expect.stringContaining("仅允许团队可见") });
+    expect(mocks.transaction).not.toHaveBeenCalled();
+  });
+
+  it("全量替换：删差集 + 增新增（事务）", async () => {
+    mocks.kbFindMany.mockResolvedValue([{ id: "kb1" }, { id: "kb2" }]);
+    mocks.transaction.mockImplementation(async (fn: (tx: any) => any) =>
+      fn({
+        projectKnowledgeBase: {
+          deleteMany: mocks.pkbDeleteMany,
+          createMany: mocks.pkbCreateMany,
+        },
+      }),
+    );
+    await setProjectKbsFn({ data: { projectId: "p1", kbIds: ["kb1", "kb2"] } });
+    expect(mocks.pkbDeleteMany).toHaveBeenCalledWith({
+      where: { projectId: "p1", kbId: { notIn: ["kb1", "kb2"] } },
+    });
+    expect(mocks.pkbCreateMany).toHaveBeenCalledWith({
+      data: [
+        { projectId: "p1", kbId: "kb1" },
+        { projectId: "p1", kbId: "kb2" },
+      ],
+      skipDuplicates: true,
+    });
+  });
+});
+
+describe("setKbProjectsFn 校验", () => {
+  it("general KB 拒绝关联", async () => {
+    mocks.kbFindFirst.mockResolvedValue({ id: "kbG", visibility: "general" });
+    await expect(
+      setKbProjectsFn({ data: { kbId: "kbG", projectIds: ["p1"] } }),
+    ).rejects.toMatchObject({ message: expect.stringContaining("通用知识库") });
+  });
+
+  it("private KB 拒绝关联", async () => {
+    mocks.kbFindFirst.mockResolvedValue({ id: "kbP", visibility: "private" });
+    await expect(
+      setKbProjectsFn({ data: { kbId: "kbP", projectIds: ["p1"] } }),
+    ).rejects.toMatchObject({ message: expect.stringContaining("私有知识库") });
+  });
+});
+
+describe("listProjectKbsFn / listKbProjectsFn", () => {
+  it("项目侧返回 KB 概要", async () => {
+    mocks.pkbFindMany.mockResolvedValue([
+      { kb: { id: "kb1", name: "团队库", icon: "notebook", visibility: "team" } },
+    ]);
+    const result = await listProjectKbsFn({ data: { projectId: "p1" } });
+    expect(result[0]).toMatchObject({ id: "kb1", name: "团队库" });
+  });
+
+  it("KB 侧返回项目概要", async () => {
+    mocks.pkbFindMany.mockResolvedValue([
+      { project: { id: "p1", name: "项目A", icon: "folder" } },
+    ]);
+    const result = await listKbProjectsFn({ data: { kbId: "kb1" } });
+    expect(result[0]).toMatchObject({ id: "p1", name: "项目A" });
+  });
+});

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" } });
+  });
+});