@allbluecn/web-app 0.5.1 → 0.6.1

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

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

@@ -0,0 +1,208 @@
+// 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 { z } from "zod";
+import { createServerFn } from "@tanstack/react-start";
+import { getRequest } from "@tanstack/react-start/server";
+import { prisma } from "@allbluecn/database";
+import { requireAuth } from "@/server/auth-helpers";
+import { deriveIterationStatus, isDateRangeOverlapping, toDatePart } from "@/lib/iteration/status";
+import {
+  listIterationsSchema,
+  createIterationSchema,
+  updateIterationSchema,
+  iterationIdSchema,
+  type IterationSummary,
+} from "./schemas";
+import type { StoryState } from "@/components/story/constants";
+import { ensureUpcomingIterations, ensureAutoRollover } from "./auto-schedule-internal";
+
+const ITERATION_SELECT = {
+  id: true,
+  projectId: true,
+  name: true,
+  description: true,
+  startDate: true,
+  endDate: true,
+  archived: true,
+} as const;
+
+/** 与项目内未归档迭代校验日期不重叠（规格 §2.1：约束在 serverFn 层） */
+async function assertNoOverlap(projectId: string, range: { startDate: string; endDate: string }, excludeId?: string) {
+  const siblings = await prisma.iteration.findMany({
+    where: { projectId, archived: false, ...(excludeId ? { id: { not: excludeId } } : {}) },
+    select: { startDate: true, endDate: true },
+  });
+  if (siblings.some((s) => isDateRangeOverlapping(range, { startDate: s.startDate, endDate: s.endDate }))) {
+    throw new Error("迭代日期与现有迭代重叠");
+  }
+}
+
+function toSummary(
+  it: { id: string; name: string; description: string | null; startDate: Date; endDate: Date; archived: boolean },
+  stateCounts: Record<string, number>,
+): IterationSummary {
+  const startDate = toDatePart(it.startDate);
+  const endDate = toDatePart(it.endDate);
+  return {
+    id: it.id,
+    name: it.name,
+    description: it.description,
+    startDate,
+    endDate,
+    archived: it.archived,
+    status: deriveIterationStatus(startDate, endDate),
+    storyCount: Object.values(stateCounts).reduce((a, b) => a + b, 0),
+    stateCounts,
+  };
+}
+
+export const listIterationsFn = createServerFn({ method: "GET" })
+  .validator(listIterationsSchema)
+  .handler(async ({ data }) => {
+    const request = getRequest();
+    await requireAuth(request);
+    // 惰性自愈：自动排期补建 + autoRollover（规格 §3.6）
+    await ensureUpcomingIterations(data.projectId);
+    await ensureAutoRollover(data.projectId);
+    const items = await prisma.iteration.findMany({
+      where: { projectId: data.projectId, ...(data.includeArchived ? {} : { archived: false }) },
+      orderBy: { startDate: "desc" },
+      select: ITERATION_SELECT,
+    });
+    const grouped = await prisma.story.groupBy({
+      by: ["iterationId", "state"],
+      where: { iterationId: { in: items.map((i) => i.id) } },
+      _count: { _all: true },
+    });
+    const counts = new Map<string, Record<string, number>>();
+    for (const g of grouped) {
+      if (!g.iterationId) continue;
+      const m = counts.get(g.iterationId) ?? {};
+      m[g.state] = g._count._all;
+      counts.set(g.iterationId, m);
+    }
+    return { items: items.map((i) => toSummary(i, counts.get(i.id) ?? {})) };
+  });
+
+export const getIterationFn = createServerFn({ method: "GET" })
+  .validator(iterationIdSchema)
+  .handler(async ({ data }) => {
+    const request = getRequest();
+    await requireAuth(request);
+    const it = await prisma.iteration.findUnique({ where: { id: data.id }, select: ITERATION_SELECT });
+    if (!it) throw new Error("迭代不存在");
+    const grouped = await prisma.story.groupBy({
+      by: ["state"],
+      where: { iterationId: data.id },
+      _count: { _all: true },
+    });
+    const stateCounts = Object.fromEntries(grouped.map((g) => [g.state, g._count._all]));
+    return toSummary(it, stateCounts);
+  });
+
+export const createIterationsFn = createServerFn({ method: "POST" })
+  .validator(createIterationSchema)
+  .handler(async ({ data }) => {
+    const request = getRequest();
+    const session = await requireAuth(request);
+    await assertNoOverlap(data.projectId, data);
+    const created = await prisma.iteration.create({
+      data: {
+        projectId: data.projectId,
+        name: data.name,
+        description: data.description,
+        startDate: new Date(data.startDate + "T00:00:00.000Z"),
+        endDate: new Date(data.endDate + "T00:00:00.000Z"),
+        createdById: session.user!.id!,
+      },
+      select: { id: true },
+    });
+    return { id: created.id };
+  });
+
+export const updateIterationsFn = createServerFn({ method: "POST" })
+  .validator(updateIterationSchema)
+  .handler(async ({ data }) => {
+    const request = getRequest();
+    await requireAuth(request);
+    const existing = await prisma.iteration.findUnique({ where: { id: data.id }, select: ITERATION_SELECT });
+    if (!existing) throw new Error("迭代不存在");
+    const next = {
+      startDate: data.startDate ?? toDatePart(existing.startDate),
+      endDate: data.endDate ?? toDatePart(existing.endDate),
+    };
+    if (next.startDate > next.endDate) throw new Error("结束日期不能早于开始日期");
+    // completed 锁定编辑（规格 §3.1）
+    if (deriveIterationStatus(next.startDate, next.endDate) === "completed") {
+      throw new Error("已完成的迭代不可编辑");
+    }
+    if (data.startDate || data.endDate) await assertNoOverlap(existing.projectId, next, data.id);
+    await prisma.iteration.update({
+      where: { id: data.id },
+      data: {
+        ...(data.name !== undefined ? { name: data.name } : {}),
+        ...(data.description !== undefined ? { description: data.description } : {}),
+        ...(data.startDate ? { startDate: new Date(next.startDate + "T00:00:00.000Z") } : {}),
+        ...(data.endDate ? { endDate: new Date(next.endDate + "T00:00:00.000Z") } : {}),
+      },
+    });
+    return { ok: true };
+  });
+
+export const archiveIterationsFn = createServerFn({ method: "POST" })
+  .validator(z.object({ id: z.string(), archived: z.boolean() }))
+  .handler(async ({ data }) => {
+    const request = getRequest();
+    await requireAuth(request);
+    await prisma.iteration.update({
+      where: { id: data.id },
+      data: { archived: data.archived, archivedAt: data.archived ? new Date() : null },
+    });
+    return { ok: true };
+  });
+
+export const deleteIterationsFn = createServerFn({ method: "POST" })
+  .validator(iterationIdSchema)
+  .handler(async ({ data }) => {
+    const request = getRequest();
+    await requireAuth(request);
+    await prisma.iteration.delete({ where: { id: data.id } }); // Story.iterationId SetNull 自动解绑
+    return { ok: true };
+  });
+
+const USER_BRIEF_SELECT = {
+  id: true, username: true, email: true, avatarConfig: true, bgShape: true, bgColor: true,
+} as const;
+
+const listIterationStoriesSchema = z.object({ iterationId: z.string() });
+
+export const listIterationStoriesFn = createServerFn({ method: "GET" })
+  .validator(listIterationStoriesSchema)
+  .handler(async ({ data }) => {
+    const request = getRequest();
+    await requireAuth(request);
+    const stories = await prisma.story.findMany({
+      where: { iterationId: data.iterationId, archived: false },
+      orderBy: [{ state: "asc" }, { updatedAt: "desc" }],
+      select: {
+        id: true, identifier: true, name: true, state: true, priority: true,
+        assignee: { select: USER_BRIEF_SELECT },
+      },
+    });
+    return { items: stories.map((s) => ({ ...s, state: s.state as StoryState })) };
+  });