@allbluecn/web-app 0.5.0 → 0.6.0

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

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

@@ -0,0 +1,54 @@
+// 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/>.
+
+export interface AutoSchedulePlanConfig {
+  title: string; durationDays: number; cooldownDays: number;
+  startsOn: string; futureCount: number; lastSeq: number;
+}
+export interface ExistingIterationRange { startDate: string; endDate: string; archived: boolean }
+export interface PlannedIteration { name: string; startDate: string; endDate: string; seq: number }
+
+function addDays(d: string, n: number): string {
+  return new Date(Date.parse(d + "T00:00:00Z") + n * 86400000).toISOString().slice(0, 10);
+}
+
+/** 惰性补建计划（规格 §3.6）：返回需补建的迭代 + 用于持久化的 nextSeq */
+export function planMissingIterations(
+  config: AutoSchedulePlanConfig,
+  existing: ExistingIterationRange[],
+  today: string,
+): { planned: PlannedIteration[]; nextSeq: number } {
+  const live = existing.filter((e) => !e.archived);
+  const upcomingCount = live.filter((e) => e.startDate > today).length;
+  const need = config.futureCount - upcomingCount;
+  if (need <= 0) return { planned: [], nextSeq: config.lastSeq };
+  const latestEnd = live.reduce((m, e) => (e.endDate > m ? e.endDate : m), config.startsOn);
+  let cursor = [latestEnd, config.startsOn, today].sort().at(-1)!; // anchor = max(最晚结束, startsOn, today)
+  cursor = addDays(cursor, config.cooldownDays);
+  const planned: PlannedIteration[] = [];
+  let seq = config.lastSeq;
+  while (planned.length < need) {
+    const s = cursor;
+    const e = addDays(s, config.durationDays - 1);
+    const overlap = live.find((x) => s <= x.endDate && x.startDate <= e);
+    if (overlap) { cursor = addDays(overlap.endDate, 1); continue; } // 顺延，不消耗序号
+    seq += 1;
+    planned.push({ name: `${config.title} ${seq}`, startDate: s, endDate: e, seq });
+    cursor = addDays(e, config.cooldownDays + 1);
+  }
+  return { planned, nextSeq: seq };
+}

package/src/server/serverFns/iteration/auto-schedule-internal.ts

@@ -0,0 +1,88 @@
+// 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 { prisma } from "@allbluecn/database";
+import { toDatePart } from "@/lib/iteration/status";
+import { planMissingIterations } from "./auto-schedule-core";
+import { transferStoriesInternal } from "./transfer-internal";
+
+const CONFIG_SELECT = {
+  enabled: true, title: true, durationDays: true, cooldownDays: true,
+  startsOn: true, futureCount: true, autoRollover: true, lastSeq: true,
+} as const;
+
+async function loadConfig(projectId: string) {
+  const [cfg] = await prisma.iterationAutoSchedule.findMany({
+    where: { projectId }, select: CONFIG_SELECT, take: 1,
+  });
+  return cfg ?? null;
+}
+
+/** 惰性补建（listIterationsFn 调用；规格 §3.6）。幂等：先查 upcoming 数，够数即跳过 */
+export async function ensureUpcomingIterations(projectId: string): Promise<void> {
+  const cfg = await loadConfig(projectId);
+  if (!cfg?.enabled) return;
+  const today = new Date().toISOString().slice(0, 10);
+  const existing = await prisma.iteration.findMany({
+    where: { projectId },
+    select: { startDate: true, endDate: true, archived: true },
+  });
+  const { planned, nextSeq } = planMissingIterations(
+    {
+      title: cfg.title, durationDays: cfg.durationDays, cooldownDays: cfg.cooldownDays,
+      startsOn: toDatePart(cfg.startsOn), futureCount: cfg.futureCount, lastSeq: cfg.lastSeq,
+    },
+    existing.map((e) => ({ startDate: toDatePart(e.startDate), endDate: toDatePart(e.endDate), archived: e.archived })),
+    today,
+  );
+  if (planned.length === 0) return;
+  const owner = await prisma.project.findUnique({ where: { id: projectId }, select: { ownerId: true } });
+  await prisma.$transaction([
+    ...planned.map((p) =>
+      prisma.iteration.create({
+        data: {
+          projectId, name: p.name,
+          startDate: new Date(p.startDate + "T00:00:00.000Z"),
+          endDate: new Date(p.endDate + "T00:00:00.000Z"),
+          createdById: owner!.ownerId!,
+        },
+        select: { id: true },
+      }),
+    ),
+    prisma.iterationAutoSchedule.update({ where: { projectId }, data: { lastSeq: nextSeq } }),
+  ]);
+}
+
+/** autoRollover：最近结束迭代 → 未完成需求转移到下一个 active/upcoming（规格 §3.6；无目标跳过） */
+export async function ensureAutoRollover(projectId: string): Promise<void> {
+  const cfg = await loadConfig(projectId);
+  if (!cfg?.enabled || !cfg.autoRollover) return;
+  const today = new Date().toISOString().slice(0, 10);
+  const [lastEnded] = await prisma.iteration.findMany({
+    where: { projectId, archived: false, endDate: { lt: new Date(today + "T00:00:00.000Z") } },
+    orderBy: { endDate: "desc" }, take: 1,
+    select: { id: true },
+  });
+  if (!lastEnded) return;
+  const [target] = await prisma.iteration.findMany({
+    where: { projectId, archived: false, startDate: { gte: today } },
+    orderBy: { startDate: "asc" }, take: 1,
+    select: { id: true },
+  });
+  if (!target) return; // 无可用目标：跳过，下次自检重试
+  await transferStoriesInternal(lastEnded.id, target.id);
+}

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

@@ -0,0 +1,60 @@
+// 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 { formatInTimeZone } from "date-fns-tz";
+
+export interface BurndownStory { id: string; addedAt: string }
+export interface StateEvent { storyId: string; at: string; to: string }
+export interface BurndownPoint { date: string; scope: number; pending: number; ideal: number }
+export interface BurndownResult {
+  points: BurndownPoint[];
+  status: "leading" | "trailing" | "even";
+}
+
+function dayIn(tz: string, at: string | Date): string {
+  return formatInTimeZone(new Date(at), tz, "yyyy-MM-dd");
+}
+
+function addDay(d: string): string {
+  return new Date(Date.parse(d + "T00:00:00Z") + 86400000).toISOString().slice(0, 10);
+}
+
+/** 燃尽回放（规格 §3.4）：按日全量重算，O(天×需求)，迭代规模内可接受 */
+export function computeBurndown(input: {
+  startDate: string; endDate: string; timezone: string;
+  stories: BurndownStory[]; stateEvents: StateEvent[]; now: Date;
+}): BurndownResult {
+  const { startDate, endDate, timezone, stories, stateEvents } = input;
+  const today = dayIn(timezone, input.now);
+  const sortedEvents = [...stateEvents].sort((a, b) => a.at.localeCompare(b.at));
+
+  const points: BurndownPoint[] = [];
+  const totalDays = Math.round((Date.parse(endDate) - Date.parse(startDate)) / 86400000);
+  for (let cursor = startDate, i = 0; cursor <= endDate && cursor <= today; cursor = addDay(cursor), i++) {
+    const inScope = stories.filter((s) => dayIn(timezone, s.addedAt) <= cursor);
+    const scope = inScope.length;
+    const pending = inScope.filter((s) => {
+      const last = sortedEvents.filter((e) => e.storyId === s.id && dayIn(timezone, e.at) <= cursor).at(-1);
+      return !last || (last.to !== "done" && last.to !== "cancelled");
+    }).length;
+    const ideal = Math.max(0, Math.round((scope * (totalDays - i)) / Math.max(1, totalDays)));
+    points.push({ date: cursor, scope, pending, ideal });
+  }
+  const last = points.at(-1);
+  const status = !last ? "even" : last.pending < last.ideal ? "leading" : last.pending > last.ideal ? "trailing" : "even";
+  return { points, status };
+}

package/src/server/serverFns/iteration/index.ts

@@ -0,0 +1,22 @@
+// 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/>.
+
+export * from "./iteration-crud";
+export * from "./iteration-stories";
+export * from "./iteration-transfer";
+export * from "./iteration-auto-schedule";
+export * from "./iteration-burndown";

package/src/server/serverFns/iteration/iteration-auto-schedule.ts

@@ -0,0 +1,66 @@
+// 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 { createServerFn } from "@tanstack/react-start";
+import { getRequest } from "@tanstack/react-start/server";
+import { z } from "zod";
+import { prisma } from "@allbluecn/database";
+import { requireAuth } from "@/server/auth-helpers";
+import { toDatePart } from "@/lib/iteration/status";
+import { ensureUpcomingIterations } from "./auto-schedule-internal";
+
+const CONFIG_SELECT = {
+  enabled: true, title: true, durationDays: true, cooldownDays: true,
+  startsOn: true, futureCount: true, autoRollover: true, lastSeq: true,
+} as const;
+
+export const getAutoScheduleFn = createServerFn({ method: "GET" })
+  .validator(z.object({ projectId: z.string() }))
+  .handler(async ({ data }) => {
+    const request = getRequest();
+    await requireAuth(request);
+    const [cfg] = await prisma.iterationAutoSchedule.findMany({
+      where: { projectId: data.projectId }, select: CONFIG_SELECT, take: 1,
+    });
+    return { config: cfg ? { ...cfg, startsOn: toDatePart(cfg.startsOn) } : null };
+  });
+
+export const updateAutoScheduleFn = createServerFn({ method: "POST" })
+  .validator(
+    z.object({
+      projectId: z.string(),
+      enabled: z.boolean(),
+      title: z.string().min(1).max(50),
+      durationDays: z.number().int().min(1).max(90),
+      cooldownDays: z.number().int().min(0).max(30),
+      startsOn: z.string().regex(/^\d{4}-\d{2}-\d{2}$/),
+      futureCount: z.number().int().min(1).max(10),
+      autoRollover: z.boolean(),
+    }),
+  )
+  .handler(async ({ data }) => {
+    const request = getRequest();
+    await requireAuth(request);
+    await prisma.iterationAutoSchedule.upsert({
+      where: { projectId: data.projectId },
+      create: { ...data, startsOn: new Date(data.startsOn + "T00:00:00.000Z") },
+      update: { ...data, startsOn: new Date(data.startsOn + "T00:00:00.000Z") },
+      select: { projectId: true },
+    });
+    await ensureUpcomingIterations(data.projectId);
+    return { ok: true };
+  });

package/src/server/serverFns/iteration/iteration-burndown.ts

@@ -0,0 +1,70 @@
+// 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 { createServerFn } from "@tanstack/react-start";
+import { getRequest } from "@tanstack/react-start/server";
+import { z } from "zod";
+import { prisma } from "@allbluecn/database";
+import { requireAuth } from "@/server/auth-helpers";
+import { toDatePart } from "@/lib/iteration/status";
+import { computeBurndown } from "./burndown-core";
+
+const ACTIVITY_STORY_SELECT = {
+  storyId: true, field: true, oldValue: true, newValue: true, createdAt: true, action: true,
+} as const;
+
+export const getIterationBurndownFn = createServerFn({ method: "GET" })
+  .validator(z.object({ iterationId: z.string() }))
+  .handler(async ({ data }) => {
+    const request = getRequest();
+    await requireAuth(request);
+    const iteration = await prisma.iteration.findUnique({
+      where: { id: data.iterationId },
+      select: { startDate: true, endDate: true, project: { select: { timezone: true } } },
+    });
+    if (!iteration) throw new Error("迭代不存在");
+    const timezone = iteration.project.timezone ?? "Asia/Shanghai";
+    const stories = await prisma.story.findMany({
+      where: { iterationId: data.iterationId },
+      select: { id: true, createdAt: true },
+    });
+    const activities = await prisma.storyActivity.findMany({
+      where: {
+        storyId: { in: stories.length ? stories.map((s) => s.id) : ["__none__"] },
+        OR: [{ action: "state_changed", field: "state" }, { action: "iteration_changed", field: "iterationId" }],
+      },
+      orderBy: { createdAt: "asc" },
+      select: ACTIVITY_STORY_SELECT,
+    });
+    // 加入时间：iteration_changed 首次进入本迭代的活动时间，无记录 fallback story.createdAt（规格 §3.4 简化口径）
+    const addedAt = new Map<string, string>();
+    for (const a of activities) {
+      if (a.action !== "iteration_changed") continue;
+      addedAt.set(a.storyId, a.createdAt.toISOString());
+    }
+    const result = computeBurndown({
+      startDate: toDatePart(iteration.startDate),
+      endDate: toDatePart(iteration.endDate),
+      timezone,
+      stories: stories.map((s) => ({ id: s.id, addedAt: addedAt.get(s.id) ?? s.createdAt.toISOString() })),
+      stateEvents: activities
+        .filter((a) => a.action === "state_changed")
+        .map((a) => ({ storyId: a.storyId, at: a.createdAt.toISOString(), to: a.newValue ?? "" })),
+      now: new Date(),
+    });
+    return { ...result, timezone };
+  });