@allbluecn/web-app 0.5.1 → 0.6.1

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

@@ -0,0 +1,111 @@
+// 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 { deriveIterationStatus, toDatePart } from "@/lib/iteration/status";
+
+/** 目标迭代必须可加入：存在、未归档、非 completed（规格 §3.2） */
+async function assertTargetJoinable(iterationId: string) {
+  const it = await prisma.iteration.findUnique({
+    where: { id: iterationId },
+    select: { startDate: true, endDate: true, archived: true, name: true },
+  });
+  if (!it || it.archived) throw new Error("迭代不存在");
+  if (deriveIterationStatus(toDatePart(it.startDate), toDatePart(it.endDate)) === "completed") {
+    throw new Error("不能将需求加入已完成的迭代");
+  }
+  return it.name;
+}
+
+export const setStoryIterationFn = createServerFn({ method: "POST" })
+  .validator(z.object({ storyId: z.string(), iterationId: z.string().nullable() }))
+  .handler(async ({ data }) => {
+    const request = getRequest();
+    const session = await requireAuth(request);
+    const story = await prisma.story.findUnique({
+      where: { id: data.storyId },
+      select: { iterationId: true, iteration: { select: { name: true } } },
+    });
+    if (!story) throw new Error("需求不存在");
+    let newName: string | null = null;
+    if (data.iterationId) newName = await assertTargetJoinable(data.iterationId);
+    await prisma.story.update({ where: { id: data.storyId }, data: { iterationId: data.iterationId } });
+    await prisma.storyActivity.create({
+      data: {
+        storyId: data.storyId,
+        userId: session.user!.id!,
+        action: "iteration_changed",
+        field: "iterationId",
+        oldValue: story.iteration?.name ?? null,
+        newValue: newName,
+      },
+    });
+    return { ok: true };
+  });
+
+export const addStoriesToIterationFn = createServerFn({ method: "POST" })
+  .validator(z.object({ iterationId: z.string(), storyIds: z.array(z.string()).min(1).max(200) }))
+  .handler(async ({ data }) => {
+    const request = getRequest();
+    const session = await requireAuth(request);
+    const newName = await assertTargetJoinable(data.iterationId);
+    const { count } = await prisma.story.updateMany({
+      where: { id: { in: data.storyIds } },
+      data: { iterationId: data.iterationId },
+    });
+    await prisma.storyActivity.createMany({
+      data: data.storyIds.map((storyId) => ({
+        storyId,
+        userId: session.user!.id!,
+        action: "iteration_changed",
+        field: "iterationId",
+        newValue: newName,
+      })),
+    });
+    return { count };
+  });
+
+export const removeStoryFromIterationFn = createServerFn({ method: "POST" })
+  .validator(z.object({ storyId: z.string() }))
+  .handler(async ({ data }) => {
+    const request = getRequest();
+    const session = await requireAuth(request);
+    const story = await prisma.story.findUnique({
+      where: { id: data.storyId },
+      select: { iterationId: true, iteration: { select: { name: true } } },
+    });
+    if (!story?.iterationId) return { ok: true };
+    await prisma.story.updateMany({
+      where: { id: data.storyId, iterationId: story.iterationId },
+      data: { iterationId: null },
+    });
+    await prisma.storyActivity.create({
+      data: {
+        storyId: data.storyId,
+        userId: session.user!.id!,
+        action: "iteration_changed",
+        field: "iterationId",
+        oldValue: story.iteration?.name ?? null,
+        newValue: null,
+      },
+    });
+    return { ok: true };
+  });

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

@@ -0,0 +1,42 @@
+// 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 { requireAuth } from "@/server/auth-helpers";
+import { transferStoriesInternal } from "./transfer-internal";
+
+export const transferUnfinishedSchema = z.object({
+  iterationId: z.string(),
+  targetIterationId: z.string(),
+  storyIds: z.array(z.string()).optional(),
+});
+
+export const transferUnfinishedFn = createServerFn({ method: "POST" })
+  .validator(transferUnfinishedSchema)
+  .handler(async ({ data }) => {
+    const request = getRequest();
+    const session = await requireAuth(request);
+    const count = await transferStoriesInternal(
+      data.iterationId,
+      data.targetIterationId,
+      data.storyIds,
+      session.user!.id!,
+    );
+    return { count };
+  });

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

@@ -0,0 +1,58 @@
+// 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";
+
+/** yyyy-MM-dd 校验 */
+export const dateOnly = z.string().regex(/^\d{4}-\d{2}-\d{2}$/, "日期格式应为 yyyy-MM-dd");
+
+export const dateRange = z
+  .object({ startDate: dateOnly, endDate: dateOnly })
+  .refine((v) => v.startDate <= v.endDate, { message: "结束日期不能早于开始日期" });
+
+export const listIterationsSchema = z.object({
+  projectId: z.string(),
+  includeArchived: z.boolean().default(false),
+});
+
+export const createIterationSchema = dateRange.extend({
+  projectId: z.string(),
+  name: z.string().min(1).max(100),
+  description: z.string().max(20000).optional(),
+});
+
+export const updateIterationSchema = z.object({
+  id: z.string(),
+  name: z.string().min(1).max(100).optional(),
+  description: z.string().max(20000).optional(),
+  startDate: dateOnly.optional(),
+  endDate: dateOnly.optional(),
+});
+
+export const iterationIdSchema = z.object({ id: z.string() });
+
+export type IterationSummary = {
+  id: string;
+  name: string;
+  description: string | null;
+  startDate: string;
+  endDate: string;
+  archived: boolean;
+  status: "upcoming" | "active" | "completed";
+  storyCount: number;
+  stateCounts: Record<string, number>;
+};

package/src/server/serverFns/iteration/transfer-internal.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 { prisma } from "@allbluecn/database";
+import { deriveIterationStatus, toDatePart } from "@/lib/iteration/status";
+
+/** 内部复用（用户勾选路径 + autoRollover）：目标校验 + 幂等 where 批量转移（规格 §3.5） */
+export async function transferStoriesInternal(
+  sourceIterationId: string,
+  targetIterationId: string,
+  storyIds?: string[],
+  userId?: string,
+): Promise<number> {
+  const target = await prisma.iteration.findUnique({
+    where: { id: targetIterationId },
+    select: { startDate: true, endDate: true, archived: true, name: true, projectId: true },
+  });
+  if (!target || target.archived) throw new Error("迭代不存在");
+  if (deriveIterationStatus(toDatePart(target.startDate), toDatePart(target.endDate)) === "completed") {
+    throw new Error("不能将需求加入已完成的迭代");
+  }
+  const unfinished = await prisma.story.findMany({
+    where: {
+      iterationId: sourceIterationId,
+      state: { notIn: ["done", "cancelled"] },
+      ...(storyIds ? { id: { in: storyIds } } : {}),
+    },
+    select: { id: true },
+  });
+  if (unfinished.length === 0) return 0;
+  const ids = unfinished.map((s) => s.id);
+  let actorId = userId;
+  if (!actorId) {
+    const owner = await prisma.project.findUnique({ where: { id: target.projectId }, select: { ownerId: true } });
+    actorId = owner!.ownerId!;
+  }
+  await prisma.story.updateMany({ where: { id: { in: ids } }, data: { iterationId: targetIterationId } });
+  await prisma.storyActivity.createMany({
+    data: ids.map((storyId) => ({
+      storyId,
+      userId: actorId,
+      action: "iteration_changed",
+      field: "iterationId",
+      newValue: target.name,
+    })),
+  });
+  return ids.length;
+}

package/src/server/serverFns/project/module-overview.ts

@@ -0,0 +1,109 @@
+// 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";
+
+const projectIdSchema = z.object({ projectId: z.string().min(1) });
+
+const moduleStorySchema = z.object({
+  id: z.string(),
+  title: z.string(),
+  state: z.string(),
+  priority: z.string(),
+  assignee: z.string().nullable().optional(),
+  updatedAt: z.string(),
+});
+
+export type ModuleStoryItem = z.infer<typeof moduleStorySchema>;
+
+export const getModuleOverviewFn = createServerFn({ method: "GET" })
+  .validator(projectIdSchema)
+  .handler(async ({ data }) => {
+    const request = getRequest();
+    await requireAuth(request);
+
+    const [storyAgg, prdLinks] = await Promise.all([
+      prisma.story.aggregate({
+        where: { projectId: data.projectId, archived: false },
+        _count: { _all: true },
+        _max: { updatedAt: true },
+      }),
+      prisma.storyPrdLink.findMany({
+        where: { story: { projectId: data.projectId } },
+        select: { prdId: true, createdAt: true },
+      }),
+    ]);
+
+    const prdCount = new Set(prdLinks.map((l) => l.prdId)).size;
+    const prdLastUpdated =
+      prdLinks.length > 0
+        ? prdLinks.reduce<Date>(
+            (max, l) => (l.createdAt > max ? l.createdAt : max),
+            prdLinks[0]!.createdAt,
+          )
+        : null;
+
+    // testcase / bug / acceptance 暂无独立数据模型，真实空值
+    return {
+      requirement: {
+        count: storyAgg._count._all,
+        lastUpdatedAt: storyAgg._max.updatedAt?.toISOString() ?? null,
+      },
+      prd: {
+        count: prdCount,
+        lastUpdatedAt: prdLastUpdated?.toISOString() ?? null,
+      },
+      design: { count: 0, lastUpdatedAt: null },
+      testcase: { count: 0, lastUpdatedAt: null },
+      bug: { count: 0, lastUpdatedAt: null },
+      acceptance: { count: 0, lastUpdatedAt: null },
+    };
+  });
+
+export const listModuleStoriesFn = createServerFn({ method: "GET" })
+  .validator(projectIdSchema)
+  .handler(async ({ data }) => {
+    const request = getRequest();
+    await requireAuth(request);
+    const stories = await prisma.story.findMany({
+      where: { projectId: data.projectId, archived: false },
+      orderBy: { updatedAt: "desc" },
+      take: 100,
+      select: {
+        id: true,
+        name: true,
+        state: true,
+        priority: true,
+        updatedAt: true,
+        assignee: { select: { username: true } },
+      },
+    });
+    return {
+      items: stories.map((s) => ({
+        id: s.id,
+        title: s.name,
+        state: s.state,
+        priority: s.priority,
+        assignee: s.assignee?.username ?? null,
+        updatedAt: s.updatedAt.toISOString(),
+      })),
+    };
+  });

package/src/server/serverFns/project.ts

@@ -328,8 +328,8 @@ export const deleteProjectFn = createServerFn({ method: "POST" })
             await prisma.$transaction(async (tx) => {
               for (const id of storyIds) {
                 const counter = await tx.sequenceCounter.upsert({
-                  where: { scope: "global" },
-                  create: { scope: "global", seq: 1 },
+                  where: { scope: independentId },
+                  create: { scope: independentId, seq: 1 },
                   update: { seq: { increment: 1 } },
                 });
                 await tx.story.update({

package/src/server/serverFns/story/__tests__/label-suggest-fn.test.ts

@@ -0,0 +1,100 @@
+// 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"
+
+const mocks = vi.hoisted(() => ({
+  labelFindMany: vi.fn(),
+  storyLabelGroupBy: vi.fn(),
+  runChat: vi.fn(),
+  hasAiKey: vi.fn(),
+}))
+
+vi.mock("@allbluecn/database", () => ({
+  prisma: {
+    label: { findMany: mocks.labelFindMany },
+    storyLabel: { groupBy: mocks.storyLabelGroupBy },
+  },
+}))
+
+vi.mock("@allbluecn/ai-gateway", async (importOriginal) => {
+  const actual = await importOriginal<typeof import("@allbluecn/ai-gateway")>()
+  return {
+    ...actual,
+    runChat: mocks.runChat,
+    hasAiKey: mocks.hasAiKey,
+  }
+})
+
+import { suggestLabelsCore } from "../story-crud/label-suggest-core"
+
+const ALL_LABELS = [
+  { id: "l1", name: "性能", color: "#ef4444" },
+  { id: "l2", name: "安全", color: "#3b82f6" },
+]
+
+beforeEach(() => {
+  vi.clearAllMocks()
+  mocks.hasAiKey.mockResolvedValue(true)
+  mocks.labelFindMany.mockResolvedValue(ALL_LABELS)
+})
+
+describe("suggestLabelsCore", () => {
+  it("正常链路：查标签→runChat→解析→返回 existing 实体与 newNames", async () => {
+    mocks.runChat.mockResolvedValue('{"existing":["性能"],"new":["支付"]}')
+    const r = await suggestLabelsCore({ name: "优化登录" }, "u1")
+    expect(mocks.runChat).toHaveBeenCalledTimes(1)
+    const call = mocks.runChat.mock.calls[0] as any[]
+    expect(call[0][0].role).toBe("user")
+    expect(call[1].systemPrompts[0]).toContain("性能、安全")
+    expect(call[1].modelOptions).toEqual({ temperature: 0.2 })
+    expect(r.existingLabels).toEqual([{ id: "l1", name: "性能", color: "#ef4444" }])
+    expect(r.newNames).toEqual(["支付"])
+  })
+
+  it("AI 未配置抛错", async () => {
+    mocks.hasAiKey.mockResolvedValue(false)
+    await expect(suggestLabelsCore({ name: "x" }, "u1")).rejects.toMatchObject({
+      message: expect.stringContaining("AI"),
+    })
+  })
+
+  it("标签超 100 个时按使用频次截断", async () => {
+    const many = Array.from({ length: 120 }, (_, i) => ({
+      id: `l${i}`,
+      name: `标签${i}`,
+      color: "#6b7280",
+    }))
+    mocks.labelFindMany.mockResolvedValue(many)
+    mocks.storyLabelGroupBy.mockResolvedValue(
+      Array.from({ length: 100 }, (_, i) => ({ labelId: `l${i}`, _count: { _all: 100 - i } })),
+    )
+    mocks.runChat.mockResolvedValue('{"existing":[],"new":[]}')
+    await suggestLabelsCore({ name: "x" }, "u1")
+    expect(mocks.storyLabelGroupBy).toHaveBeenCalledTimes(1)
+    const prompt = (mocks.runChat.mock.calls[0] as any[])[1].systemPrompts[0] as string
+    const listed = prompt.split("已有标签：")[1]
+    expect(listed.split("、")).toHaveLength(100)
+  })
+
+  it("AI 输出解析失败抛错", async () => {
+    mocks.runChat.mockResolvedValue("垃圾输出")
+    await expect(suggestLabelsCore({ name: "x" }, "u1")).rejects.toMatchObject({
+      message: expect.stringContaining("解析失败"),
+    })
+  })
+})

package/src/server/serverFns/story/__tests__/labels.test.ts

@@ -0,0 +1,67 @@
+// 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";
+
+const mocks = vi.hoisted(() => ({
+  labelUpsert: vi.fn(),
+}));
+
+vi.mock("@allbluecn/database", () => ({
+  prisma: { label: { upsert: mocks.labelUpsert } },
+}));
+
+import { upsertLabel } from "../story-crud/label-upsert";
+import { pickLabelColor, LABEL_PALETTE } from "../story-crud/label-palette";
+
+beforeEach(() => {
+  vi.clearAllMocks();
+});
+
+describe("pickLabelColor", () => {
+  it("同名稳定同色且落在色板内", () => {
+    const a = pickLabelColor("性能");
+    expect(pickLabelColor("性能")).toBe(a);
+    expect(LABEL_PALETTE).toContain(a);
+  });
+
+  it("不同标签名颜色分布均匀（6 个标签至少 4 色）", () => {
+    const colors = new Set(["性能", "安全", "登录", "支付", "导入", "导出"].map(pickLabelColor));
+    expect(colors.size).toBeGreaterThanOrEqual(4);
+  });
+});
+
+describe("upsertLabel", () => {
+  it("走 upsert 且 create 分支使用色板颜色", async () => {
+    mocks.labelUpsert.mockResolvedValue({ id: "l1", name: "性能", color: "#ef4444" });
+    const r = await upsertLabel("性能", "u1");
+    expect(mocks.labelUpsert).toHaveBeenCalledTimes(1);
+    const arg = mocks.labelUpsert.mock.calls[0][0] as any;
+    expect(arg.where).toEqual({ name: "性能" });
+    expect(arg.update).toEqual({});
+    expect(LABEL_PALETTE).toContain(arg.create.color);
+    expect(arg.create.createdById).toBe("u1");
+    expect(r).toEqual({ id: "l1", name: "性能", color: "#ef4444" });
+  });
+
+  it("传自定义颜色时优先使用自定义颜色", async () => {
+    mocks.labelUpsert.mockResolvedValue({ id: "l1", name: "性能", color: "#ff0000" });
+    await upsertLabel("性能", "u1", "#ff0000");
+    const arg = mocks.labelUpsert.mock.calls[0][0] as any;
+    expect(arg.create.color).toBe("#ff0000");
+  });
+});