@allbluecn/web-app 0.5.1 → 0.6.1

package/src/server/serverFns/story/__tests__/story-dependencies.test.ts

@@ -47,9 +47,12 @@ vi.mock("@tanstack/react-start/server", () => ({
 const mocks = vi.hoisted(() => ({
   depFindMany: vi.fn(),
   depFindFirst: vi.fn(),
+  depFindUnique: vi.fn(),
   depCreate: vi.fn(),
+  depUpdate: vi.fn(),
   depDelete: vi.fn(),
   storyFindMany: vi.fn(),
+  storyFindUnique: vi.fn(),
   activityCreate: vi.fn(),
   currentSession: vi.fn(),
 }));
@@ -59,10 +62,12 @@ vi.mock("@allbluecn/database", () => {
     storyDependency: {
       findMany: mocks.depFindMany,
       findFirst: mocks.depFindFirst,
+      findUnique: mocks.depFindUnique,
       create: mocks.depCreate,
+      update: mocks.depUpdate,
       delete: mocks.depDelete,
     },
-    story: { findMany: mocks.storyFindMany },
+    story: { findMany: mocks.storyFindMany, findUnique: mocks.storyFindUnique },
     storyActivity: { create: mocks.activityCreate },
   };
   return { prisma, Prisma: {} };
@@ -74,6 +79,7 @@ vi.mock("@/server/auth-helpers", () => ({
 
 import {
   addDependenciesFn,
+  updateDependencyFn,
   removeDependencyFn,
   getDependenciesFn,
 } from "../story-dependencies";
@@ -225,12 +231,110 @@ describe("addDependenciesFn", () => {
   });
 });
 
+describe("updateDependencyFn", () => {
+  const EXISTING = { id: "d1", sourceId: "a", targetId: "b", type: "BLOCKS" };
+  const UPDATE_ACTIVITY = {
+    id: "act1",
+    action: "dependency_updated",
+    field: null,
+    oldValue: null,
+    newValue: "B-1 story b",
+    isAI: false,
+    createdAt: new Date("2026-08-31T00:00:00Z"),
+    storyId: "a",
+    user: { id: "u1", username: "u1", email: "e", avatarConfig: null, bgShape: null, bgColor: null },
+  };
+
+  it("同向改类型：仅更新 type，两端各记一条活动", async () => {
+    mocks.depFindUnique.mockResolvedValue(EXISTING);
+    mocks.depFindMany.mockResolvedValue([]); // 排除自身后无其他边
+    mocks.depUpdate.mockResolvedValue({ ...EXISTING, type: "STARTS_BEFORE" });
+    mocks.activityCreate.mockResolvedValue(UPDATE_ACTIVITY);
+    const res = await updateDependencyFn({
+      data: { depId: "d1", sourceId: "a", targetId: "b", type: "STARTS_BEFORE" },
+    });
+    expect(res.ok).toBe(true);
+    expect(mocks.depUpdate).toHaveBeenCalledWith({
+      where: { id: "d1" },
+      data: { sourceId: "a", targetId: "b", type: "STARTS_BEFORE" },
+    });
+    expect(res.activities).toHaveLength(2);
+  });
+
+  it("方向反转合法时更新为新的 source/target", async () => {
+    mocks.depFindUnique.mockResolvedValue(EXISTING);
+    mocks.depFindMany.mockResolvedValue([]);
+    mocks.depUpdate.mockResolvedValue({ ...EXISTING, sourceId: "b", targetId: "a" });
+    mocks.activityCreate.mockResolvedValue(UPDATE_ACTIVITY);
+    const res = await updateDependencyFn({
+      data: { depId: "d1", sourceId: "b", targetId: "a", type: "BLOCKS" },
+    });
+    expect(res.ok).toBe(true);
+    expect(mocks.depUpdate).toHaveBeenCalledWith({
+      where: { id: "d1" },
+      data: { sourceId: "b", targetId: "a", type: "BLOCKS" },
+    });
+  });
+
+  it("方向反转成环时拒绝写入", async () => {
+    mocks.depFindUnique.mockResolvedValue(EXISTING);
+    // 现边 a -> b；另已存在路径 a -> c -> b。请求反转成 b -> a 后，
+    // 从新 target(a) 出发可直达新 source(b) ⇒ 成环，必须拒绝
+    mocks.depFindMany.mockResolvedValue([
+      { sourceId: "a", targetId: "c" },
+      { sourceId: "c", targetId: "b" },
+    ]);
+    const res = await updateDependencyFn({
+      data: { depId: "d1", sourceId: "b", targetId: "a", type: "BLOCKS" },
+    });
+    expect(res).toEqual({ ok: false, reason: "CYCLE" });
+    expect(mocks.depUpdate).not.toHaveBeenCalled();
+  });
+
+  it("三元组与现状一致时短路返回且不写库", async () => {
+    mocks.depFindUnique.mockResolvedValue(EXISTING);
+    const res = await updateDependencyFn({
+      data: { depId: "d1", sourceId: "a", targetId: "b", type: "BLOCKS" },
+    });
+    expect(res).toEqual({ ok: true, activities: [] });
+    expect(mocks.depUpdate).not.toHaveBeenCalled();
+    expect(mocks.depFindMany).not.toHaveBeenCalled();
+  });
+
+  it("两端不属于原边时抛错", async () => {
+    mocks.depFindUnique.mockResolvedValue(EXISTING);
+    await expect(
+      updateDependencyFn({
+        data: { depId: "d1", sourceId: "a", targetId: "c", type: "BLOCKS" },
+      }),
+    ).rejects.toMatchObject({ message: expect.stringContaining("依赖关系两端不匹配") });
+    expect(mocks.depUpdate).not.toHaveBeenCalled();
+  });
+
+  it("depId 不存在时抛错", async () => {
+    mocks.depFindUnique.mockResolvedValue(null);
+    await expect(
+      updateDependencyFn({
+        data: { depId: "missing", sourceId: "a", targetId: "b", type: "BLOCKS" },
+      }),
+    ).rejects.toMatchObject({ message: expect.stringContaining("依赖关系不存在") });
+  });
+});
+
 describe("removeDependencyFn", () => {
   it("按 depId 删除", async () => {
+    mocks.depFindUnique.mockResolvedValue({ id: "d1", sourceId: "s1", targetId: "t1" });
+    mocks.storyFindUnique.mockImplementation(({ where }: any) => {
+      if (where.id === "s1") return Promise.resolve({ identifier: "A-1", name: "story a" });
+      if (where.id === "t1") return Promise.resolve({ identifier: "B-1", name: "story b" });
+      return Promise.resolve(null);
+    });
     mocks.depDelete.mockResolvedValue({ id: "d1" });
+    mocks.activityCreate.mockResolvedValue({ id: "act1", action: "dependency_removed", field: null, oldValue: null, newValue: "B-1", isAI: false, createdAt: new Date(), user: { id: "u1", username: "u1", email: "e", avatarConfig: null, bgShape: null, bgColor: null } });
     const res = await removeDependencyFn({ data: { depId: "d1" } });
-    expect(res.id).toBe("d1");
+    expect(res?.dep.id).toBe("d1");
     expect(mocks.depDelete).toHaveBeenCalledWith({ where: { id: "d1" } });
+    expect(mocks.activityCreate).toHaveBeenCalledTimes(2);
   });
 });
 

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

@@ -21,6 +21,8 @@ export {
   createLabelFn,
 } from "./story-crud/labels";
 
+export { suggestStoryLabelsFn } from "./story-crud/label-suggest";
+
 export {
   listActivitiesFn,
 } from "./story-crud/activities";
@@ -82,6 +84,7 @@ export {
 
 export {
   addDependenciesFn,
+  updateDependencyFn,
   removeDependencyFn,
   getDependenciesFn,
 } from "./story-dependencies";

package/src/server/serverFns/story/story-assoc.ts

@@ -113,12 +113,29 @@ export const unlinkPrdFn = createServerFn({ method: "POST" })
   .handler(async ({ data }) => {
     const request = getRequest();
     const session = await requireAuth(request);
+    const userId = session.user!.id!;
+
+    const prd = await prisma.pRD.findUnique({ where: { id: data.prdId }, select: { name: true } });
 
-    const link = await prisma.storyPrdLink.delete({
+    await prisma.storyPrdLink.delete({
       where: { storyId_prdId: { storyId: data.storyId, prdId: data.prdId } },
     });
 
-    return link;
+    let activity = null;
+    if (prd) {
+      const created = await prisma.storyActivity.create({
+        data: {
+          storyId: data.storyId,
+          userId,
+          action: "prd_unlinked",
+          newValue: prd.name,
+        },
+        select: ACTIVITY_SELECT,
+      });
+      activity = toActivityItem(created);
+    }
+
+    return { storyId: data.storyId, prdId: data.prdId, activity };
   });
 
 export const getLinkedPrdsFn = createServerFn({ method: "GET" })
@@ -415,17 +432,32 @@ export const unlinkDocFn = createServerFn({ method: "POST" })
   .handler(async ({ data }) => {
     const request = getRequest();
     const session = await requireAuth(request);
+    const userId = session.user!.id!;
+
     const parsed = parseExternalDocId(data.docId);
     if (parsed) {
       await prisma.storyExternalLink.deleteMany({
         where: { storyId: data.storyId, group: parsed.group, externalId: parsed.externalId },
       });
-      return { ok: true };
+      const created = await prisma.storyActivity.create({
+        data: { storyId: data.storyId, userId, action: "kb_unlinked", newValue: `${parsed.group}:${parsed.externalId}` },
+        select: ACTIVITY_SELECT,
+      });
+      return { ok: true, activity: toActivityItem(created) };
     }
+    const doc = await prisma.knowledgeDocument.findUnique({ where: { id: data.docId }, select: { title: true } });
     await prisma.storyDocLink.delete({
       where: { storyId_docId: { storyId: data.storyId, docId: data.docId } },
     });
-    return { ok: true };
+    let activity: ReturnType<typeof toActivityItem> | null = null;
+    if (doc) {
+      const created = await prisma.storyActivity.create({
+        data: { storyId: data.storyId, userId, action: "kb_unlinked", newValue: doc.title },
+        select: ACTIVITY_SELECT,
+      });
+      activity = toActivityItem(created);
+    }
+    return { ok: true, activity };
   });
 
 export const getLinkedDocsFn = createServerFn({ method: "GET" })

package/src/server/serverFns/story/story-attachments.ts

@@ -20,18 +20,36 @@ import { getRequest } from "@tanstack/react-start/server";
 import { z } from "zod";
 import { prisma } from "@allbluecn/database";
 import { requireAuth } from "@/server/auth-helpers";
+import { ACTIVITY_SELECT, toActivityItem } from "./types";
 
 export const removeAttachmentFn = createServerFn({ method: "POST" })
   .validator(z.object({ attachmentId: z.string() }))
   .handler(async ({ data }) => {
     const request = getRequest();
     const session = await requireAuth(request);
+    const userId = session.user!.id!;
 
-    const attachment = await prisma.storyAttachment.delete({
+    const attachment = await prisma.storyAttachment.findUnique({ where: { id: data.attachmentId } });
+    await prisma.storyAttachment.delete({
       where: { id: data.attachmentId },
     });
 
-    return attachment;
+    // 结果含 BigInt fileSize 不可序列化，只返回活动记录（Seroval 安全的纯对象）
+    let activity = null;
+    if (attachment) {
+      const created = await prisma.storyActivity.create({
+        data: {
+          storyId: attachment.storyId,
+          userId,
+          action: "attachment_removed",
+          newValue: attachment.fileName,
+        },
+        select: ACTIVITY_SELECT,
+      });
+      activity = toActivityItem(created);
+    }
+
+    return { ok: true, activity };
   });
 
 export const getAttachmentsFn = createServerFn({ method: "GET" })

package/src/{components/project/project-icon.tsx → server/serverFns/story/story-crud/label-palette.ts}

@@ -15,24 +15,21 @@
 // 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 { PROJECT_ICONS } from "@/components/shared/icon-packs/project";
-import { cn } from "@/lib/utils";
+export const LABEL_PALETTE = [
+  "#ef4444",
+  "#f97316",
+  "#f59e0b",
+  "#10b981",
+  "#06b6d4",
+  "#3b82f6",
+  "#8b5cf6",
+  "#ec4899",
+] as const;
 
-const ICON_MAP = new Map(
-  PROJECT_ICONS.map((i) => [i.value, i.icon]),
-);
-
-interface ProjectIconDisplayProps {
-  name?: string;
-  size?: number;
-  className?: string;
-}
-
-export function ProjectIconDisplay({
-  name,
-  size = 24,
-  className,
-}: ProjectIconDisplayProps) {
-  const Icon = ICON_MAP.get(name ?? "") ?? PROJECT_ICONS[0].icon;
-  return <Icon size={size} className={cn("text-current", className)} />;
+export function pickLabelColor(name: string): string {
+  let hash = 0;
+  for (const ch of name) {
+    hash = (hash * 31 + (ch.codePointAt(0) ?? 0)) | 0;
+  }
+  return LABEL_PALETTE[Math.abs(hash) % LABEL_PALETTE.length];
 }

package/src/server/serverFns/story/story-crud/label-suggest-core.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 {
+  hasAiKey,
+  runChat,
+  buildLabelSuggestSystemPrompt,
+  buildLabelSuggestUserMessage,
+  parseLabelSuggestions,
+} from "@allbluecn/ai-gateway"
+
+const MAX_LABELS_IN_PROMPT = 100
+
+export interface SuggestLabelsInput {
+  name: string
+  description?: string
+  currentLabelNames?: string[]
+}
+
+export interface SuggestLabelsResult {
+  existingLabels: { id: string; name: string; color: string }[]
+  newNames: string[]
+}
+
+export async function suggestLabelsCore(
+  input: SuggestLabelsInput,
+  userId: string,
+): Promise<SuggestLabelsResult> {
+  if (!(await hasAiKey(userId))) {
+    throw new Error("AI 未配置，请先前往 AI 设置页配置 API Key")
+  }
+
+  const allLabels = await prisma.label.findMany({
+    select: { id: true, name: true, color: true },
+    orderBy: { name: "asc" },
+  })
+
+  let candidates = allLabels
+  if (allLabels.length > MAX_LABELS_IN_PROMPT) {
+    const usage = await prisma.storyLabel.groupBy({
+      by: ["labelId"],
+      _count: { _all: true },
+      orderBy: { _count: { labelId: "desc" } },
+      take: MAX_LABELS_IN_PROMPT,
+    })
+    const topIds = new Set(usage.map((u) => u.labelId))
+    candidates = allLabels.filter((l) => topIds.has(l.id))
+  }
+
+  const names = candidates.map((l) => l.name)
+  const raw = await runChat(
+    [{ role: "user", content: buildLabelSuggestUserMessage(input) }],
+    {
+      systemPrompts: [buildLabelSuggestSystemPrompt(names)],
+      modelOptions: { temperature: 0.2 },
+      userId,
+    },
+  )
+
+  const parsed = parseLabelSuggestions(raw, names)
+  const byName = new Map(candidates.map((l) => [l.name, l]))
+  const existingLabels: { id: string; name: string; color: string }[] = []
+  const unmatchedNames: string[] = []
+  for (const n of parsed.existing) {
+    const l = byName.get(n)
+    if (l) existingLabels.push(l)
+    else unmatchedNames.push(n)
+  }
+  return {
+    existingLabels,
+    newNames: [...parsed.newNames, ...unmatchedNames],
+  }
+}

package/src/server/serverFns/story/story-crud/label-suggest.ts

@@ -0,0 +1,38 @@
+// 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 { suggestLabelsCore } from "./label-suggest-core"
+
+const suggestSchema = z.object({
+  name: z.string().min(1).max(200),
+  description: z.string().max(4000).optional(),
+  currentLabelNames: z.array(z.string().min(1).max(10)).max(20).optional(),
+})
+
+export const suggestStoryLabelsFn = createServerFn({ method: "POST" })
+  .validator(suggestSchema)
+  .handler(async ({ data }) => {
+    const request = getRequest()
+    const session = await requireAuth(request)
+    const userId = session.user?.id
+    if (!userId) throw new Error("用户未登录")
+    return suggestLabelsCore(data, userId)
+  })

package/src/{components/knowledge/knowledge-icon.tsx → server/serverFns/story/story-crud/label-upsert.ts}

@@ -15,24 +15,18 @@
 // 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 { KNOWLEDGE_ICONS } from "@/components/shared/icon-packs/knowledge";
-import { cn } from "@/lib/utils";
+import { prisma } from "@allbluecn/database";
+import { pickLabelColor } from "./label-palette";
 
-const ICON_MAP = new Map(
-  KNOWLEDGE_ICONS.map((i) => [i.value, i.icon]),
-);
-
-interface KnowledgeIconDisplayProps {
-  name?: string;
-  size?: number;
-  className?: string;
-}
-
-export function KnowledgeIconDisplay({
-  name,
-  size = 24,
-  className,
-}: KnowledgeIconDisplayProps) {
-  const Icon = ICON_MAP.get(name ?? "") ?? KNOWLEDGE_ICONS[0].icon;
-  return <Icon size={size} className={cn("text-primary", className)} />;
+export async function upsertLabel(name: string, createdById: string, color?: string) {
+  return prisma.label.upsert({
+    where: { name },
+    update: {},
+    create: {
+      name,
+      color: color ?? pickLabelColor(name),
+      createdById,
+    },
+    select: { id: true, name: true, color: true },
+  });
 }

package/src/server/serverFns/story/story-crud/labels.ts

@@ -21,10 +21,11 @@ import { z } from "zod";
 import { prisma } from "@allbluecn/database";
 import { requireAuth } from "@/server/auth-helpers";
 import { USER_BRIEF_SELECT } from "../types";
+import { upsertLabel } from "./label-upsert";
 
 const labelCreateSchema = z.object({
   name: z.string().min(1).max(30),
-  color: z.string().regex(/^#[0-9a-fA-F]{6}$/).default("#6b7280"),
+  color: z.string().regex(/^#[0-9a-fA-F]{6}$/).optional(),
 });
 
 export const listUsersBriefFn = createServerFn({ method: "GET" })
@@ -98,8 +99,5 @@ export const createLabelFn = createServerFn({ method: "POST" })
   .handler(async ({ data }) => {
     const request = getRequest();
     const session = await requireAuth(request);
-    return prisma.label.create({
-      data: { name: data.name, color: data.color, createdById: session.user!.id! },
-      select: { id: true, name: true, color: true },
-    });
+    return upsertLabel(data.name, session.user!.id!, data.color);
   });

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

@@ -133,8 +133,8 @@ export const createStoryFn = createServerFn({ method: "POST" })
           const isIndependent = project.displayId === BUILTIN_INDEPENDENT_DISPLAY_ID;
           if (isIndependent) {
             const counter = await tx.sequenceCounter.upsert({
-              where: { scope: "global" },
-              create: { scope: "global", seq: 1 },
+              where: { scope: projectId },
+              create: { scope: projectId, seq: 1 },
               update: { seq: { increment: 1 } },
             });
             sequenceId = counter.seq;
@@ -222,6 +222,7 @@ const updateSchema = z.object({
   targetDate: z.string().nullable().optional(),
   labelIds: z.array(z.string()).optional(),
   parentId: z.string().nullable().optional(),
+  iterationId: z.string().nullable().optional(),
   isAI: z.boolean().default(false),
 });
 
@@ -352,6 +353,35 @@ export const updateStoryFn = createServerFn({ method: "POST" })
         }
       }
 
+      if (data.iterationId !== undefined) {
+        const newIterationId = data.iterationId;
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const oldIterationId = (existing as any).iteration?.id ?? null;
+        if (newIterationId !== oldIterationId) {
+          let oldName = "";
+          let newName = "";
+          if (oldIterationId) {
+            const oldIt = await tx.iteration.findUnique({ where: { id: oldIterationId }, select: { name: true } });
+            oldName = oldIt?.name ?? "";
+          }
+          if (newIterationId) {
+            const newIt = await tx.iteration.findUnique({ where: { id: newIterationId }, select: { name: true } });
+            newName = newIt?.name ?? "";
+          }
+          if (newIterationId) {
+            updates.iteration = { connect: { id: newIterationId } };
+          } else {
+            updates.iteration = { disconnect: true };
+          }
+          activities.push({
+            action: "iteration_changed",
+            field: "iterationId",
+            oldValue: oldName,
+            newValue: newName,
+          });
+        }
+      }
+
       updates.updatedBy = { connect: { id: userId } };
 
       const updated = await tx.story.update({