@allbluecn/web-app 0.19.5 → 0.21.0

package/src/components/story/detail/activity-timeline.tsx

@@ -15,7 +15,7 @@
 // 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 { useState, useRef, useLayoutEffect, useEffect } from "react";
+import { useState, useRef, useLayoutEffect, useEffect, useMemo } from "react";
 import type { ReactNode } from "react";
 import { UserAvatar } from "@/components/shared-kit";
 import {
@@ -28,10 +28,10 @@ import {
   PRIORITY_ICON,
   type StoryState,
   type StoryPriority,
-} from "@/components/story/constants";
+} from "@/shared/story/constants";
 import { LucideIconByName } from "@/components/shared-kit/icons/lucide-icon-picker/lucide-icon-by-name";
 import { listProjectsBriefFn } from "@/server/serverFns/project";
-import type { ActivityItem, UserBrief } from "@/components/story/types";
+import type { ActivityItem, UserBrief } from "@/shared/story/types";
 import { groupActivities, type ActivityGroup } from "@/lib/story/activity-grouper";
 import { ArrowUpFromDot, ArrowRight, ChevronDown, Dot, Sparkles, Layers, UserRound } from "lucide-react";
 import { sanitize } from "@/lib/sanitize";
@@ -422,18 +422,37 @@ interface DiffState {
 
 export function ActivityTimeline({ activities, users }: ActivityTimelineProps) {
   const [diffStates, setDiffStates] = useState<Record<string, DiffState>>({});
-  const [projectIconByName, setProjectIconByName] = useState<Record<string, string>>({});
+  const [projectBriefs, setProjectBriefs] = useState<Array<{ id: string; name: string; icon: string }>>([]);
 
   useEffect(() => {
     listProjectsBriefFn()
-      .then((rows) => {
-        const map: Record<string, string> = {};
-        for (const r of rows) map[r.name] = r.icon;
-        setProjectIconByName(map);
-      })
+      .then(setProjectBriefs)
       .catch(() => { });
   }, []);
 
+  // S13：project_transferred 的 value 已改为存项目 id；id map 供新值解析名称/图标，
+  // name map 兼容存量行（value=项目名）回退命中——重名错配仅残留于存量数据
+  const { projectById, projectIconByName } = useMemo(() => {
+    const byId = new Map<string, { name: string; icon: string }>();
+    const byName = new Map<string, string>();
+    for (const p of projectBriefs) {
+      byId.set(p.id, { name: p.name, icon: p.icon });
+      if (!byName.has(p.name)) byName.set(p.name, p.icon);
+    }
+    return { projectById: byId, projectIconByName: byName };
+  }, [projectBriefs]);
+
+  // 仅 project_transferred 走 id→名 解析（其余动作值不进 id map，防误命中）
+  const displayValue = (action: string, value: string | null): string | null => {
+    if (action !== "project_transferred" || !value) return value;
+    return projectById.get(value)?.name ?? value;
+  };
+  const resolveProjectIcon = (action: string, value: string | null | undefined): string | undefined => {
+    if (!value) return undefined;
+    if (action === "project_transferred") return projectById.get(value)?.icon ?? projectIconByName.get(value);
+    return projectIconByName.get(value);
+  };
+
   if (activities.length === 0) {
     return (
       <p className="py-8 text-center text-sm text-muted-foreground">
@@ -548,16 +567,16 @@ export function ActivityTimeline({ activities, users }: ActivityTimelineProps) {
               </div>
               {hasDiff ? (
                  <DiffCompare
-                   oldValue={formatDiffValue(a.action, g.displayOldValue!)}
-                   newValue={formatDiffValue(a.action, g.displayNewValue!)}
-                  oldDecorator={getDiffDecorator(a.action, g.displayOldValue, projectIconByName[g.displayOldValue ?? ""], users?.find((u) => u.username === g.displayOldValue))}
-                  newDecorator={getDiffDecorator(a.action, g.displayNewValue, projectIconByName[g.displayNewValue ?? ""], users?.find((u) => u.username === g.displayNewValue))}
+                   oldValue={formatDiffValue(a.action, displayValue(a.action, g.displayOldValue)!)}
+                   newValue={formatDiffValue(a.action, displayValue(a.action, g.displayNewValue)!)}
+                  oldDecorator={getDiffDecorator(a.action, displayValue(a.action, g.displayOldValue), resolveProjectIcon(a.action, g.displayOldValue), users?.find((u) => u.username === g.displayOldValue))}
+                  newDecorator={getDiffDecorator(a.action, displayValue(a.action, g.displayNewValue), resolveProjectIcon(a.action, g.displayNewValue), users?.find((u) => u.username === g.displayNewValue))}
                   plain={a.action !== "description_changed"}
                   blocks={isBlocks ? g.items.map((it) => ({
-                    oldValue: formatDiffValue(a.action, it.oldValue),
-                    newValue: formatDiffValue(a.action, it.newValue),
-                    oldDecorator: getDiffDecorator(a.action, it.oldValue, projectIconByName[it.oldValue ?? ""], users?.find((u) => u.username === it.oldValue)),
-                    newDecorator: getDiffDecorator(a.action, it.newValue, projectIconByName[it.newValue ?? ""], users?.find((u) => u.username === it.newValue)),
+                    oldValue: formatDiffValue(a.action, displayValue(a.action, it.oldValue)),
+                    newValue: formatDiffValue(a.action, displayValue(a.action, it.newValue)),
+                    oldDecorator: getDiffDecorator(a.action, displayValue(a.action, it.oldValue), resolveProjectIcon(a.action, it.oldValue), users?.find((u) => u.username === it.oldValue)),
+                    newDecorator: getDiffDecorator(a.action, displayValue(a.action, it.newValue), resolveProjectIcon(a.action, it.newValue), users?.find((u) => u.username === it.newValue)),
                   })) : undefined}
                    collapsed={state.collapsed}
                    isTall={state.isTall}

package/src/components/story/detail/comment-input.tsx

@@ -21,7 +21,7 @@ import { Button } from "@/components/ui/button";
 import { Textarea } from "@/components/ui/textarea";
 import { createCommentFn } from "@/server/serverFns/story";
 import { toast } from "@/components/ui/toast";
-import type { CommentWithReplies } from "../types";
+import type { CommentWithReplies } from "@/shared/story/types";
 import { m } from "@/paraglide/messages.js";
 
 interface CommentInputProps {

package/src/components/story/detail/comment-item.tsx

@@ -29,7 +29,7 @@ import {
 } from "@/components/ui/dropdown-menu";
 import { deleteCommentFn, updateCommentFn } from "@/server/serverFns/story";
 import { toast } from "@/components/ui/toast";
-import type { CommentWithReplies } from "../types";
+import type { CommentWithReplies } from "@/shared/story/types";
 import { m } from "@/paraglide/messages.js";
 
 interface CommentItemProps {

package/src/components/story/detail/comment-thread.tsx

@@ -17,7 +17,7 @@
 
 import { CommentItem } from "./comment-item";
 import { CommentInput } from "./comment-input";
-import type { CommentWithReplies } from "../types";
+import type { CommentWithReplies } from "@/shared/story/types";
 import { m } from '@/paraglide/messages.js'
 import { formatTimestamp } from "@/lib/datetime";
 

package/src/components/story/detail/reaction-bar.tsx

@@ -19,7 +19,7 @@ import { Plus } from "lucide-react";
 import { Button } from "@/components/ui/button";
 import { cn } from "@/lib/utils";
 import { EmojiPicker } from "@/components/shared-kit/comments/emoji-picker";
-import type { ReactionGroup } from "@/components/story/types";
+import type { ReactionGroup } from "@/shared/story/types";
 import { m } from "@/paraglide/messages.js";
 
 interface ReactionBarProps {

package/src/components/story/detail/story-detail-body.tsx

@@ -35,9 +35,9 @@ import { Tooltip, TooltipContent, TooltipTrigger } from "@/components/ui/tooltip
 import { updateStoryFn, listStoryReactionsFn, toggleStoryReactionFn } from "@/server/serverFns/story";
 import { formatTimestamp } from "@/lib/datetime";
 import { toast } from "@/components/ui/toast";
-import type { StoryDetail, UserBrief, CommentWithReplies, ActivityItem, ReactionGroup, RelationsData } from "../types";
-import { parseStoryDescription, serializeStoryDescription } from "../types";
-import type { StoryState } from "../constants";
+import type { StoryDetail, UserBrief, CommentWithReplies, ActivityItem, ReactionGroup, RelationsData } from "@/shared/story/types";
+import { parseStoryDescription, serializeStoryDescription } from "@/shared/story/types";
+import type { StoryState } from "@/shared/story/constants";
 import type { StoryPatch } from "../display/group-fields";
 import { ActivityTabs } from "./activity-tabs";
 import { EmojiPicker } from "@/components/shared-kit/comments/emoji-picker";
@@ -233,7 +233,7 @@ export interface StoryDetailBodyProps {
   /** 字段落库成功后的补丁回调（PeekPanel 回写列表/看板做乐观更新） */
   onStoryPatch?: (storyId: string, patch: StoryPatch) => void;
   onNavigateInPanel?: (targetId: string, targetIdentifier?: string, relationKind?: "child" | "dependency") => void;
-  onOpenEntity?: (entity: import("../types").StoryEntityOverlay) => void;
+  onOpenEntity?: (entity: import("@/components/story/entity-overlay").StoryEntityOverlay) => void;
   /** 用例/BUG 行的面板内叠加打开（peek 传入；缺省整页跳转） */
   /** 内嵌面板导航面包屑（在面板内跳转时替代单层 identifier 显示） */
   breadcrumbItems?: Array<{ identifier?: string; projectId?: string; label: string; onClick?: () => void }>;

package/src/components/story/detail/story-detail-toolbar/__tests__/attachment-cache.test.ts

@@ -0,0 +1,83 @@
+// 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/>.
+
+// S12（审计 A7x-14 ⚪）附件面板级缓存回归：
+// - 同 storageUrl 并发/跨实例只 fetch 一次（网格 + 全屏弹窗复用）；
+// - LRU 上限淘汰最旧条目；
+// - 超大附件不驻留内存；
+// - 失败不缓存，下次重试。
+// 注：jsdom 的 Response 会把 Blob 体当字符串化，测试统一用文本体控制字节数。
+
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import { loadAttachmentFile } from "../associated-attachments-panel";
+import type { StoryAttachmentItem } from "@/shared/story/types";
+
+const attachment = (over: Partial<StoryAttachmentItem> = {}): StoryAttachmentItem => ({
+  id: "att-1",
+  fileName: "a.png",
+  fileSize: 10,
+  mimeType: "image/png",
+  storageUrl: "https://cdn.test/att-1",
+  ...over,
+});
+
+const fetchMock = vi.fn(async () => new Response("{}", { status: 200 }));
+
+beforeEach(() => {
+  vi.stubGlobal("fetch", fetchMock);
+});
+
+afterEach(() => {
+  vi.unstubAllGlobals();
+  vi.restoreAllMocks();
+});
+
+describe("loadAttachmentFile（S12 面板级缓存）", () => {
+  it("同 storageUrl 两次调用只发一次 fetch，File 名/类型正确", async () => {
+    const [f1, f2] = await Promise.all([
+      loadAttachmentFile(attachment()),
+      loadAttachmentFile(attachment()),
+    ]);
+
+    expect(fetchMock).toHaveBeenCalledTimes(1);
+    expect(f1.name).toBe("a.png");
+    expect(f1.type).toBe("image/png");
+    expect(f2).toBe(f1);
+  });
+
+  it("超过 20MB 的大附件不驻留缓存（下次重拉）", async () => {
+    const big = attachment({ id: "att-big", storageUrl: "https://cdn.test/big" });
+    const BIG = "x".repeat(20 * 1024 * 1024 + 1);
+    fetchMock.mockImplementation(async () => new Response(BIG, { status: 200 }));
+
+    await loadAttachmentFile(big);
+    await loadAttachmentFile(big);
+
+    expect(fetchMock).toHaveBeenCalledTimes(2);
+  });
+
+  it("失败不缓存： rejected 后再次调用重新 fetch", async () => {
+    const bad = attachment({ id: "att-bad", storageUrl: "https://cdn.test/bad" });
+    fetchMock.mockImplementationOnce(async () => new Response("no", { status: 404 }));
+    fetchMock.mockImplementationOnce(async () => new Response("abcd", { status: 200 }));
+
+    await expect(loadAttachmentFile(bad)).rejects.toThrow("加载失败");
+    const ok = await loadAttachmentFile(bad);
+    expect(ok.size).toBe(4);
+    expect(fetchMock).toHaveBeenCalledTimes(2);
+  });
+});

package/src/components/story/detail/story-detail-toolbar/associated-attachments-panel.tsx

@@ -49,7 +49,7 @@ import { sanitize } from "@/lib/sanitize";
 import { formatFileSize, getFaviconUrl, getFileTypeIcon, extractLinkTitle, getMimeTypeLabel, getMimeTypeLabelKey, getMimeTypeLabelByKey, MIME_TYPE_LABEL_ORDER, type MimeTypeLabelKey } from "../../relations/format";
 import { generalGroupLabel } from "../../relations/general-groups";
 import { LucideIconByName } from "@/components/shared-kit/icons/lucide-icon-picker/lucide-icon-by-name";
-import type { AssociatedItem, RelationsData, StoryLinkItem, StoryAttachmentItem } from "../../types";
+import type { AssociatedItem, RelationsData, StoryLinkItem, StoryAttachmentItem } from "@/shared/story/types";
 import { m } from "@/paraglide/messages.js";
 import { toastError } from "@/lib/toast-error";
 import { useStoryPanelOpen } from "@/lib/hooks/use-story-panel-open";
@@ -61,7 +61,7 @@ export interface AssociatedAttachmentsPanelProps {
   data: RelationsData;
   onRefresh: (next: (prev: RelationsData) => RelationsData) => void;
   onOpenDialog: (kind: AssociatedDialogKind, editLink?: StoryLinkItem, editAttachment?: StoryAttachmentItem) => void;
-  onAppendActivities?: (items: import("../../types").ActivityItem[]) => void;
+  onAppendActivities?: (items: import("@/shared/story/types").ActivityItem[]) => void;
 }
 
 // 记住列表/预览显示方式
@@ -70,20 +70,61 @@ const VIEW_MODE_STORAGE_KEY = "associated-attachments-view-mode";
 // 全屏浮窗尺寸与 peek-panel 面板的 full-screen 模式一致（四边 inset-4）
 const FULLSCREEN_CONTENT_CLASS = "inset-4 w-auto h-auto sm:max-w-none";
 
+// ===== 附件面板级缓存（S12，审计 A7x-14 ⚪）=====
+// 网格视图与全屏弹窗各自挂 AttachmentFileView，此前对同一附件重复 fetch。
+// 以 storageUrl 为键缓存 in-flight/已完成 的 File Promise：并发去重 + 跨实例复用。
+// 内存策略：LRU 上限 12 条；超过 20MB 的大附件不驻留（走浏览器 HTTP 缓存），
+// 失败的 Promise 不缓存（下次挂载可重试）。File 由 GC 回收，无需手动 revoke。
+const MAX_CACHED_ATTACHMENTS = 12;
+const MAX_CACHEABLE_BYTES = 20 * 1024 * 1024;
+
+const attachmentFileCache = new Map<string, Promise<File>>();
+
+async function fetchAttachmentFile(attachment: StoryAttachmentItem): Promise<File> {
+  const res = await fetch(attachment.storageUrl);
+  if (!res.ok) throw new Error("加载失败");
+  const blob = await res.blob();
+  return new File([blob], attachment.fileName, { type: attachment.mimeType });
+}
+
+export function loadAttachmentFile(attachment: StoryAttachmentItem): Promise<File> {
+  const hit = attachmentFileCache.get(attachment.storageUrl);
+  if (hit) {
+    // LRU touch：删除重插维护插入序
+    attachmentFileCache.delete(attachment.storageUrl);
+    attachmentFileCache.set(attachment.storageUrl, hit);
+    return hit;
+  }
+  // 先以 in-flight Promise 占位（并发去重），完成后按大小决定去留
+  const promise = fetchAttachmentFile(attachment).then((file) => {
+    if (file.size > MAX_CACHEABLE_BYTES) {
+      // 大附件不驻留：本次直返，后续重拉走浏览器 HTTP 缓存
+      attachmentFileCache.delete(attachment.storageUrl);
+    } else {
+      attachmentFileCache.set(attachment.storageUrl, promise);
+      while (attachmentFileCache.size > MAX_CACHED_ATTACHMENTS) {
+        const oldest = attachmentFileCache.keys().next().value;
+        if (oldest === undefined) break;
+        attachmentFileCache.delete(oldest);
+      }
+    }
+    return file;
+  });
+  attachmentFileCache.set(attachment.storageUrl, promise);
+  promise.catch(() => attachmentFileCache.delete(attachment.storageUrl));
+  return promise;
+}
+
 function useAttachmentFile(attachment: StoryAttachmentItem) {
   const [file, setFile] = React.useState<File | null>(null);
   const [error, setError] = React.useState<string | null>(null);
 
   React.useEffect(() => {
     let cancelled = false;
-    fetch(attachment.storageUrl)
-      .then((res) => {
-        if (!res.ok) throw new Error("加载失败");
-        return res.blob();
-      })
-      .then((blob) => {
+    loadAttachmentFile(attachment)
+      .then((f) => {
         if (cancelled) return;
-        setFile(new File([blob], attachment.fileName, { type: attachment.mimeType }));
+        setFile(f);
       })
       .catch((e) => {
         if (cancelled) return;

package/src/components/story/detail/story-detail-toolbar/children.tsx

@@ -47,7 +47,7 @@ import { VirtualGroupHeader } from "../../views/story-list/group";
 import { DisplayOptionsBody } from "../../display/display-dropdown";
 import { StoryRefRow } from "../../relations/story-ref-row";
 import type { DisplayOptions } from "../../display/types";
-import type { RelationsData, StoryListItem, UserBrief } from "../../types";
+import type { RelationsData, StoryListItem, UserBrief } from "@/shared/story/types";
 import type { StoryPatch } from "../../display/group-fields";
 import { m } from "@/paraglide/messages.js";
 import { toastError } from "@/lib/toast-error";
@@ -284,9 +284,9 @@ export function StoryDetailChildrenPanel({
     }
   };
 
-  const handleTransfer = (updatedStories?: Array<{ id: string; identifier: string; projectId: string; parentId: string | null }>) => {
+  const handleTransfer = (updatedStories?: Array<{ id: string; identifier: string; projectId: string | null; parentId: string | null }>) => {
     if (!updatedStories?.length) return;
-    const updatedMap = new Map<string, { identifier: string; projectId: string }>();
+    const updatedMap = new Map<string, { identifier: string; projectId: string | null }>();
     for (const s of updatedStories) {
       updatedMap.set(s.id, { identifier: s.identifier, projectId: s.projectId });
     }

package/src/components/story/detail/story-detail-toolbar/dependency-panel.tsx

@@ -29,7 +29,7 @@ import {
   bulkDeleteStoriesFn,
   bulkUpdateStoriesFn,
 } from "@/server/serverFns/story";
-import { DEPENDENCY_TYPE_OPTIONS, toDependencyEdge, type DependencyTypeOption } from "../../constants";
+import { DEPENDENCY_TYPE_OPTIONS, toDependencyEdge, type DependencyTypeOption } from "@/shared/story/constants";
 import { BatchToolbar } from "../../views/story-list/batch-toolbar";
 import { useGroupedStories } from "../../display/use-grouped-stories";
 import { VirtualGroupHeader } from "../../views/story-list/group";
@@ -37,7 +37,8 @@ import { DisplayOptionsBody } from "../../display/display-dropdown";
 import { StoryRefRow } from "../../relations/story-ref-row";
 import type { DisplayOptions, GroupNode } from "../../display/types";
 import type { StoryPatch } from "../../display/group-fields";
-import type { RelationsData, UserBrief, DependencyRow } from "../../types";
+import type { StoryRelationPatch } from "../../relations/story-ref-row";
+import type { RelationsData, UserBrief, DependencyRow } from "@/shared/story/types";
 import { m } from "@/paraglide/messages.js";
 import { toastError } from "@/lib/toast-error";
 import {
@@ -77,7 +78,7 @@ export interface StoryDetailDependencyPanelProps {
   projects?: { id: string; name: string; icon: string; displayId: string | null }[];
   labels?: { id: string; name: string; color: string }[];
   onOpenAdd: () => void;
-  onAppendActivities?: (items: import("../../types").ActivityItem[]) => void;
+  onAppendActivities?: (items: import("@/shared/story/types").ActivityItem[]) => void;
   onNavigateInPanel?: (targetId: string, targetIdentifier?: string, relationKind?: "child" | "dependency") => void;
 }
 
@@ -377,13 +378,13 @@ export function StoryDetailDependencyPanel({
     return count > 0 ? "indeterminate" : false;
   };
 
-  const handleStoryRefresh = (rowId: string, patch: Record<string, unknown>) => {
+  const handleStoryRefresh = (rowId: string, patch: StoryRelationPatch) => {
     for (const group of ["dependsOn", "dependents"] as const) {
       if (patch.deleted) {
         applyRowsUpdate((rows) => rows.filter((r) => r.id !== rowId), group);
       } else {
         applyRowsUpdate(
-          (rows) => rows.map((r) => (r.id === rowId ? ({ ...r, ...patch } as DependencyRow) : r)),
+          (rows) => rows.map((r) => (r.id === rowId ? { ...r, ...patch } : r)),
           group,
         );
       }
@@ -420,7 +421,7 @@ export function StoryDetailDependencyPanel({
     />
   );
 
-  const renderGroupItems = (node: GroupNode, group: DependencySection, depth: number, collapseKey: string) => {
+  const renderGroupItems = (node: GroupNode<DependencyRow>, group: DependencySection, depth: number, collapseKey: string) => {
     const isCollapsed = collapsed[collapseKey] ?? false;
     const ids = node.items.map((s) => s.id);
     return (
@@ -461,7 +462,7 @@ export function StoryDetailDependencyPanel({
                 ),
               )
             ) : (
-              node.items.map((s) => renderRow(s as DependencyRow, group))
+              node.items.map((s) => renderRow(s, group))
             )}
           </React.Fragment>
         )}
@@ -473,7 +474,7 @@ export function StoryDetailDependencyPanel({
     titleKey: string,
     sectionKey: DependencySection,
     rows: DependencyRow[],
-    groups: GroupNode[],
+    groups: GroupNode<DependencyRow>[],
   ) => {
     const isCollapsed = collapsed[`${sectionKey}:root`] ?? false;
     return (

package/src/components/story/detail/story-detail-toolbar/index.tsx

@@ -50,9 +50,9 @@ import { getLinksFn, getAttachmentsFn, getLinkedDocsFn, getLinkedDesignsFn } fro
 import { StorySelectDialog } from "../../inline-editors/story-select-dialog";
 import { CreateStoryDialog } from "../../create-story-dialog";
 import { addDependenciesFn, getDependenciesFn, listChildStoriesFn } from "@/server/serverFns/story";
-import { DEPENDENCY_TYPE_OPTIONS, toDependencyEdge, type DependencyTypeOption } from "../../constants";
+import { DEPENDENCY_TYPE_OPTIONS, toDependencyEdge, type DependencyTypeOption } from "@/shared/story/constants";
 import { useToolbarOverflow } from "../../ai/use-toolbar-overflow";
-import type { RelationsData, UserBrief } from "../../types";
+import type { RelationsData, UserBrief } from "@/shared/story/types";
 import { m } from "@/paraglide/messages.js";
 import { toastError } from "@/lib/toast-error";
 
@@ -72,13 +72,13 @@ interface StoryDetailToolbarProps {
   data: RelationsData;
   onRefresh: (next: (prev: RelationsData) => RelationsData) => void;
   /** 关联类操作产生的活动即时追加到时间线 */
-  onAppendActivities?: (items: import("../../types").ActivityItem[]) => void;
+  onAppendActivities?: (items: import("@/shared/story/types").ActivityItem[]) => void;
   users?: UserBrief[];
   projects?: { id: string; name: string; icon: string; displayId: string | null }[];
   labels?: { id: string; name: string; color: string }[];
   onNavigateInPanel?: (targetId: string, targetIdentifier?: string, relationKind?: "child" | "dependency") => void;
   /** 用例/BUG 行的面板内叠加打开（peek 传入；缺省整页跳转） */
-  onOpenEntity?: (entity: import("../../types").StoryEntityOverlay) => void;
+  onOpenEntity?: (entity: import("@/components/story/entity-overlay").StoryEntityOverlay) => void;
 }
 
 export function StoryDetailToolbar({ storyId, storyIdentifier, projectId, storyUpdatedAt, data, onRefresh, onAppendActivities, users, projects, labels, onNavigateInPanel, onOpenEntity }: StoryDetailToolbarProps) {
@@ -86,8 +86,8 @@ export function StoryDetailToolbar({ storyId, storyIdentifier, projectId, storyU
   const [dependencyDialogOpen, setDependencyDialogOpen] = React.useState(false);
   const [assocDialogOpen, setAssocDialogOpen] = React.useState<AssociatedDialogKind | null>(null);
   const [designDialog, setDesignDialog] = React.useState<{ open: boolean; mode: DesignSelectMode }>({ open: false, mode: "design" });
-  const [linkInitialEdit, setLinkInitialEdit] = React.useState<import("../../types").StoryLinkItem | null>(null);
-  const [editAttachment, setEditAttachment] = React.useState<import("../../types").StoryAttachmentItem | null>(null);
+  const [linkInitialEdit, setLinkInitialEdit] = React.useState<import("@/shared/story/types").StoryLinkItem | null>(null);
+  const [editAttachment, setEditAttachment] = React.useState<import("@/shared/story/types").StoryAttachmentItem | null>(null);
   const [dependencyType, setDependencyType] = React.useState<DependencyTypeOption["key"] | undefined>(undefined);
   // 关联测试用例提交成功 → bump 刷新测试用例面板（面板数据自持，refreshKey 变化重拉）
   const [casesRefreshKey, setCasesRefreshKey] = React.useState(0);
@@ -226,7 +226,7 @@ export function StoryDetailToolbar({ storyId, storyIdentifier, projectId, storyU
 
   const handleCreateSuccess = (
     _story: { id: string; name: string; identifier?: string },
-    activities?: import("../../types").ActivityItem[],
+    activities?: import("@/shared/story/types").ActivityItem[],
   ) => {
     setActionOpen(null);
     refreshChildren();
@@ -273,7 +273,7 @@ export function StoryDetailToolbar({ storyId, storyIdentifier, projectId, storyU
     setDesignDialog({ open: true, mode });
   };
 
-  const handleOpenAssocDialog = (kind: AssociatedDialogKind, editLink?: import("../../types").StoryLinkItem, editAttachmentItem?: import("../../types").StoryAttachmentItem) => {
+  const handleOpenAssocDialog = (kind: AssociatedDialogKind, editLink?: import("@/shared/story/types").StoryLinkItem, editAttachmentItem?: import("@/shared/story/types").StoryAttachmentItem) => {
     if (kind === "design") {
       handleOpenDesignDialog("design");
       return;

package/src/components/story/detail/story-detail-toolbar/related-test-cases.tsx

@@ -75,7 +75,7 @@ import { TEST_CASE_PRIORITY_META } from "@/components/testcase/constants";
 import { extractTextColors } from "@/components/shared-kit/list-kit/level-badge";
 import { GenerateTestCasesDialog } from "@/components/testcase/ai/generate-dialog";
 import { SelectCasesDialog } from "@/components/testcase/detail/select-cases-dialog";
-import type { UserBrief } from "../../types";
+import type { UserBrief } from "@/shared/story/types";
 import { m } from "@/paraglide/messages.js";
 import { toast } from "@/components/ui/toast";
 import { toastError } from "@/lib/toast-error";
@@ -256,7 +256,7 @@ export function StoryDetailTestCases({
   /** 需求最近更新时间：变化即重判 stale（编辑保存后即时刷新提示） */
   storyUpdatedAt?: string | null;
   /** peek 内叠加打开（传入时点击行在 peek 内打开，缺省整页跳转） */
-  onOpenEntity?: (entity: import("../../types").StoryEntityOverlay) => void;
+  onOpenEntity?: (entity: import("@/components/story/entity-overlay").StoryEntityOverlay) => void;
 }) {
   const [panelOpen, setPanelOpen] = useStoryPanelOpen(storyId, "testcases");
   const navigate = useNavigate();

package/src/components/story/detail/story-properties.tsx

@@ -18,8 +18,8 @@
 import { GitPullRequestArrow, Tag, CalendarRange } from "lucide-react";
 import { Collapsible, CollapsibleContent, CollapsibleTrigger } from "@/components/ui/collapsible";
 import { ChevronDown } from "lucide-react";
-import type { StoryState } from "../constants";
-import type { ActivityItem } from "../types";
+import type { StoryState } from "@/shared/story/constants";
+import type { ActivityItem } from "@/shared/story/types";
 import { ParentStoryEditor } from "../inline-editors/parent-story-editor";
 import { LabelsEditor } from "../inline-editors/labels-editor";
 import { IterationEditor } from "@/components/iteration/iteration-editor";

package/src/components/story/display/__tests__/flatten-story-groups.test.ts

@@ -18,7 +18,7 @@
 // 回归：peek prev/next 须按当前视图展示顺序（分组 → 子组）导航，而非平坦 stories.items。
 import { describe, expect, it } from "vitest";
 import { flattenStoryGroups } from "../flatten-story-groups";
-import type { StoryListItem } from "../../types";
+import type { StoryListItem } from "@/shared/story/types";
 
 const s = (id: string) => ({ id } as StoryListItem);
 

package/src/components/story/display/__tests__/group-fields.test.ts

@@ -17,7 +17,7 @@
 
 import { describe, it, expect } from "vitest";
 import { GROUP_FIELD, toGroupFieldPatch, applyStoryPatchToItem } from "../group-fields";
-import type { StoryListItem, UserBrief } from "../../types";
+import type { StoryListItem, UserBrief } from "@/shared/story/types";
 
 describe("GROUP_FIELD", () => {
   it("state 映射到 state", () => {

package/src/components/story/display/__tests__/group-resolver.test.ts

@@ -24,9 +24,9 @@ import {
   PRIORITY_COLUMN_TINT,
   STATE_COLUMN_TINT,
 } from "../group-resolver";
-import { STATE_COLOR } from "../../constants";
+import { STATE_COLOR } from "@/shared/story/constants";
 import { PRIORITY_COLOR } from "../../priority-icon";
-import type { StoryListItem } from "../../types";
+import type { StoryListItem } from "@/shared/story/types";
 
 const makeStory = (over: Partial<StoryListItem> & { id: string }): StoryListItem => ({
   identifier: "STR-1", name: "t", description: null, state: "todo", priority: "medium", archived: false,

package/src/components/story/display/__tests__/order-resolver.test.ts

@@ -17,7 +17,7 @@
 
 import { describe, it, expect } from "vitest";
 import { applyOrder } from "../order-resolver";
-import type { StoryListItem } from "../../types";
+import type { StoryListItem } from "@/shared/story/types";
 
 const makeStory = (over: Partial<StoryListItem>): StoryListItem => ({
   id: "id1", identifier: "STR-1", name: "test", description: null,

package/src/components/story/display/__tests__/use-grouped-stories.test.ts

@@ -18,7 +18,7 @@
 import { describe, it, expect } from "vitest";
 import { renderHook } from "@testing-library/react";
 import { useGroupedStories } from "../use-grouped-stories";
-import type { StoryListItem } from "../../types";
+import type { StoryListItem } from "@/shared/story/types";
 import { DEFAULT_DISPLAY_OPTIONS } from "../types";
 
 const makeStory = (over: Partial<StoryListItem> & { id: string }): StoryListItem => ({

package/src/components/story/display/__tests__/use-paged-story-groups.test.ts

@@ -17,7 +17,7 @@
 
 import { describe, it, expect, vi, beforeEach } from "vitest";
 import { renderHook, waitFor, act } from "@testing-library/react";
-import type { StoryListItem } from "../../types";
+import type { StoryListItem } from "@/shared/story/types";
 import { DEFAULT_DISPLAY_OPTIONS } from "../types";
 import type { PagedStoriesArgs } from "../use-paged-story-groups";
 

package/src/components/story/display/flatten-story-groups.ts

@@ -15,7 +15,7 @@
 // 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 type { StoryListItem } from "../types";
+import type { StoryListItem } from "@/shared/story/types";
 
 /** 顶层/子层分组都只需 items 与 subGroups（GroupNode / PagedGroupNode 结构兼容） */
 type GroupLike = { items: StoryListItem[]; subGroups?: { items: StoryListItem[] }[] };

package/src/components/story/display/group-fields.ts

@@ -15,9 +15,9 @@
 // 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 type { StoryState, StoryPriority } from "../constants";
+import type { StoryState, StoryPriority } from "@/shared/story/constants";
 import type { GroupKey } from "./types";
-import type { StoryListItem, UserBrief } from "../types";
+import type { StoryListItem, UserBrief } from "@/shared/story/types";
 
 /** 列表行可更新的字段（与 updateStoryFn 入参保持一致），消除动态字段拼接的 as never。
  *  name 由详情面板（PeekPanel / 详情页）改动后回写视图，供列表/看板实时乐观更新。 */

package/src/components/story/display/group-resolver.tsx

@@ -19,9 +19,9 @@ import { Sprout, CircleUser } from "lucide-react";
 import { UserAvatar } from "@/components/shared-kit";
 import { LucideIconByName } from "@/components/shared-kit/icons/lucide-icon-picker/lucide-icon-by-name";
 import { cn } from "@/lib/utils";
-import { STORY_STATES, STATE_LABEL, STATE_COLOR, STATE_ICON, STORY_PRIORITIES, PRIORITY_LABEL, PRIORITY_ICON } from "../constants";
+import { STORY_STATES, STATE_LABEL, STATE_COLOR, STATE_ICON, STORY_PRIORITIES, PRIORITY_LABEL, PRIORITY_ICON } from "@/shared/story/constants";
 import { PRIORITY_COLOR } from "../priority-icon";
-import type { StoryListItem } from "../types";
+import type { StoryListItem } from "@/shared/story/types";
 import type { GroupContext, GroupKey, GroupNode } from "./types";
 import { GROUP_FIELD } from "./group-fields";
 import { m } from "@/paraglide/messages.js";
@@ -43,7 +43,7 @@ const RESOLVERS: Record<Exclude<GroupKey, "none" | "iteration">, KeyResolver> =
   project: (item) => [item.projectId ?? "no-project"],
 };
 
-export function groupBy(items: StoryListItem[], key: GroupKey, ctx: GroupContext, includeEmpty = false): GroupNode[] {
+export function groupBy<T extends StoryListItem = StoryListItem>(items: T[], key: GroupKey, ctx: GroupContext, includeEmpty = false): GroupNode<T>[] {
   if (key === "none") {
     return [{ key: "all", label: m.story_group_all(), items: [...items] }];
   }
@@ -53,7 +53,7 @@ export function groupBy(items: StoryListItem[], key: GroupKey, ctx: GroupContext
     return [{ key: "iteration", label: m.iterations_title(), items: [...items] }];
   }
   const resolver = RESOLVERS[key];
-  const buckets = new Map<string, StoryListItem[]>();
+  const buckets = new Map<string, T[]>();
   const order: string[] = [];
   for (const item of items) {
     const keys = resolver(item);