@allbluecn/web-app 0.19.5 → 0.21.0

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

@@ -15,11 +15,11 @@
 // 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";
 import type { OrderKey, OrderDirection } from "./types";
-import { PRIORITY_RANK } from "../constants";
+import { PRIORITY_RANK } from "@/shared/story/constants";
 
-export function applyOrder(items: StoryListItem[], order: OrderKey, dir: OrderDirection = "asc"): StoryListItem[] {
+export function applyOrder<T extends StoryListItem = StoryListItem>(items: T[], order: OrderKey, dir: OrderDirection = "asc"): T[] {
   const sorted = [...items];
   const mult = dir === "desc" ? -1 : 1;
   switch (order) {

package/src/components/story/display/types.ts

@@ -20,7 +20,7 @@
 // 与运行时常量为 story 规范口径落共享层 values.ts，此处仅透传保持消费方
 // import 不变）。story 专属的 GroupNode/GroupContext 留本文件。
 
-import type { StoryListItem, UserBrief } from "../types";
+import type { StoryListItem, UserBrief } from "@/shared/story/types";
 
 export {
   GROUP_KEYS,
@@ -42,13 +42,14 @@ export type {
   PageSize,
 } from "@/shared/list-kit/display-types";
 
-export interface GroupNode {
+// T=行类型（S14）：DependencyRow 等公共行扩展可复用同一分组栈，消费方免 as 强转。
+export interface GroupNode<T = StoryListItem> {
   key: string;
   label: string;
   icon?: React.ComponentType<{ className?: string }>;
   color?: string;
-  items: StoryListItem[];
-  subGroups?: GroupNode[];
+  items: T[];
+  subGroups?: GroupNode<T>[];
   /** 服务端分页：该组总数 */
   total?: number;
   /** 服务端分页：是否还有下一页 */

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

@@ -17,23 +17,23 @@
 
 import { useMemo } from "react";
 import type { DisplayOptions, GroupContext, GroupNode } from "./types";
-import type { StoryListItem } from "../types";
+import type { StoryListItem } from "@/shared/story/types";
 import { applyOrder } from "./order-resolver";
 import { groupBy } from "./group-resolver";
 
-interface UseGroupedArgs extends GroupContext {
-  stories: StoryListItem[];
+interface UseGroupedArgs<T extends StoryListItem> extends GroupContext {
+  stories: T[];
   filters: DisplayOptions;
 }
 
-export function useGroupedStories({ stories, filters, users, labels, projects }: UseGroupedArgs): GroupNode[] {
+export function useGroupedStories<T extends StoryListItem = StoryListItem>({ stories, filters, users, labels, projects }: UseGroupedArgs<T>): GroupNode<T>[] {
   return useMemo(() => {
     const ctx: GroupContext = { users, labels, projects };
     const ordered = applyOrder(stories, filters.orderBy, filters.orderDir);
     const groups = groupBy(ordered, filters.groupBy, ctx, filters.showEmptyGroups);
     if (filters.subGroupBy !== "none") {
       groups.forEach(g => {
-        g.subGroups = groupBy(g.items, filters.subGroupBy, ctx, false);
+        g.subGroups = groupBy<T>(g.items, filters.subGroupBy, ctx, false);
       });
     }
     return groups;

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

@@ -17,7 +17,7 @@
 
 import { useCallback, useMemo } from "react";
 import { usePagedGroupsCore } from "@/hooks/use-paged-groups";
-import type { StoryListItem, UserBrief } from "../types";
+import type { StoryListItem, UserBrief } from "@/shared/story/types";
 import type { StoryFilters } from "../story-toolbar";
 import type { FilterCondition } from "../filters";
 import { serializeFilters } from "../filters";
@@ -25,7 +25,7 @@ import { listStoriesInGroupFn, listStoryGroupsFn, listAllGroupsItemsFn } from "@
 import { resolveGroupLabel, resolveGroupIcon, resolveGroupColor } from "./group-resolver";
 import type { DisplayOptions, GroupContext, GroupKey, GroupNode } from "./types";
 import { applyStoryPatchToItem, type StoryPatch } from "./group-fields";
-import { PRIORITY_RANK, STORY_PRIORITIES, STORY_STATES } from "../constants";
+import { PRIORITY_RANK, STORY_PRIORITIES, STORY_STATES } from "@/shared/story/constants";
 import { m } from "@/paraglide/messages.js";
 
 /** 服务端按组分页的组节点：在 GroupNode 上标记 total/hasMore/loading */
@@ -35,6 +35,8 @@ export interface PagedGroupNode extends GroupNode {
   total?: number;
   hasMore?: boolean;
   loading?: boolean;
+  /** S11：组首屏拉取失败显式标记（此前静默降级为空组，用户无从重试） */
+  error?: boolean;
 }
 
 export interface PagedStoriesArgs {
@@ -494,6 +496,8 @@ export function usePagedStoryGroups(args: PagedStoriesArgs): {
   refresh: () => void;
   /** 行内编辑乐观更新：未触发分组/排序规则时保持位置原地替换，仅触发排序时组内重插，触发分组时回退全量 refresh */
   patchStory: (storyId: string, patch: StoryPatch) => void;
+  /** S11：组首屏失败后的重试入口（当前实现为全量刷新；组级精确重试需 core 支持） */
+  retry: () => void;
 } {
   const { filters, conditions, display, users, labels, projects, enabled = true } = args;
   // iteration 为甘特专属维度：分页分组仅 list/board 消费（groupBy 运行时已被
@@ -616,13 +620,14 @@ export function usePagedStoryGroups(args: PagedStoriesArgs): {
                     skip: 0,
                     take: pageSize,
                   },
-                }).catch(() => ({ items: [] as StoryListItem[], total: sg.total ?? 0, hasMore: false })),
+                }).catch(() => ({ items: [] as StoryListItem[], total: sg.total ?? 0, hasMore: false, failed: true as const })),
               ),
             );
             subLoaded.forEach((res, i: number) => {
               subScaffolds[i].items = res.items;
               subScaffolds[i].total = res.total;
               subScaffolds[i].hasMore = res.hasMore;
+              subScaffolds[i].error = (res as { failed?: boolean }).failed === true;
             });
             g.subGroups = subScaffolds;
             g.totalCount = subScaffolds.reduce((sum, sg) => sum + (sg.total ?? sg.items.length), 0);
@@ -634,13 +639,14 @@ export function usePagedStoryGroups(args: PagedStoriesArgs): {
           scaffolds.map((g) =>
             listStoriesInGroupFn({
               data: { ...base, groupBy, groupKey: g.key, orderBy: display.orderBy, orderDir: display.orderDir, skip: 0, take: pageSize },
-            }).catch(() => ({ items: [] as StoryListItem[], total: g.total ?? 0, hasMore: false })),
+            }).catch(() => ({ items: [] as StoryListItem[], total: g.total ?? 0, hasMore: false, failed: true as const })),
           ),
         );
         loaded.forEach((res, i: number) => {
           scaffolds[i].items = res.items;
           scaffolds[i].total = res.total;
           scaffolds[i].hasMore = res.hasMore;
+          scaffolds[i].error = (res as { failed?: boolean }).failed === true;
         });
       }
 
@@ -734,5 +740,6 @@ export function usePagedStoryGroups(args: PagedStoriesArgs): {
     loadMore,
     refresh: core.refresh,
     patchStory,
+    retry: core.refresh,
   };
 }

package/src/components/story/entity-overlay.ts

@@ -0,0 +1,24 @@
+// 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/>.
+
+// Peek 面板内实体叠加层（用例/BUG 行的面板内打开）。纯 UI 状态形状，留在
+// components 层：case 分支引用 server serverFns 类型与 folder-tree 组件类型
+// （均 type-only，编译期擦除），不放 src/shared 以免 shared 反向依赖 server。
+// bug 由实体 peek 面板按 id 自取详情。
+export type StoryEntityOverlay =
+  | { kind: "case"; item: import("@/server/serverFns/testcase/types").TestCaseSummary; folders: import("@/components/testcase/folder-tree").FolderNodeDto[] }
+  | { kind: "bug"; id: string };

package/src/components/story/filters/field-configs.tsx

@@ -41,13 +41,13 @@ import type {
 } from "@/components/shared-kit/list-kit/filters/types";
 import { cn } from "@/lib/utils";
 import { PriorityIcon } from "../priority-icon";
-import { STORY_STATES, STATE_ICON, PRIORITY_LABEL, type StoryPriority, type StoryState } from "../constants";
+import { STORY_STATES, STATE_ICON, PRIORITY_LABEL, type StoryPriority, type StoryState } from "@/shared/story/constants";
 import { StateEditor } from "../inline-editors/state-editor";
 import { PriorityEditor } from "../inline-editors/priority-editor";
 import { AssigneeEditor } from "../inline-editors/assignee-editor";
 import { LabelsEditor } from "../inline-editors/labels-editor";
 import { TitleEditor } from "../inline-editors/title-editor";
-import type { UserBrief } from "../types";
+import type { UserBrief } from "@/shared/story/types";
 
 export { serializeFilters, deserializeFilters, OPERATOR_LABELS, generateConditionId } from "@/components/shared-kit/list-kit/filters";
 export type { FilterOperator, FilterFieldType };

package/src/components/story/inline-editors/assignee-editor.tsx

@@ -20,7 +20,7 @@ import { CircleUser, Search, Check, ArrowDownUp } from "lucide-react";
 import { Input } from "@/components/ui/input";
 import { Popover, PopoverContent, PopoverTrigger } from "@/components/ui/popover";
 import { UserAvatar } from "@/components/shared-kit";
-import type { UserBrief } from "../types";
+import type { UserBrief } from "@/shared/story/types";
 import { cn } from "@/lib/utils";
 import { InlineTrigger } from "./inline-trigger";
 import { m } from "@/paraglide/messages.js";

package/src/components/story/inline-editors/dependency-type-select.tsx

@@ -20,7 +20,7 @@ import { Check, Waypoints } from "lucide-react";
 import { Popover, PopoverContent, PopoverTrigger } from "@/components/ui/popover";
 import { Button, buttonVariants } from "@/components/ui/button";
 import { Tooltip, TooltipContent, TooltipTrigger } from "@/components/ui/tooltip";
-import { DEPENDENCY_TYPE_OPTIONS, type DependencyTypeOption } from "../constants";
+import { DEPENDENCY_TYPE_OPTIONS, type DependencyTypeOption } from "@/shared/story/constants";
 import { cn } from "@/lib/utils";
 import { m } from "@/paraglide/messages.js";
 

package/src/components/story/inline-editors/parent-story-editor.tsx

@@ -20,8 +20,8 @@ import { GitPullRequestCreateArrow, ExternalLink, X, GitPullRequestArrow } from
 import { Button } from "@/components/ui/button";
 import { cn } from "@/lib/utils";
 import { StorySelectDialog } from "./story-select-dialog";
-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 { m } from "@/paraglide/messages.js";
 
 interface ParentStoryEditorProps {

package/src/components/story/inline-editors/priority-editor.tsx

@@ -18,8 +18,8 @@
 import { useState } from "react";
 import { Check } from "lucide-react";
 import { Popover, PopoverContent, PopoverTrigger } from "@/components/ui/popover";
-import { PRIORITY_LABEL } from "../constants";
-import type { StoryPriority } from "../constants";
+import { PRIORITY_LABEL } from "@/shared/story/constants";
+import type { StoryPriority } from "@/shared/story/constants";
 import { PriorityIcon } from "../priority-icon";
 import { cn } from "@/lib/utils";
 import { InlineTrigger } from "./inline-trigger";

package/src/components/story/inline-editors/state-editor.tsx

@@ -18,8 +18,8 @@
 import { useState } from "react";
 import { Check } from "lucide-react";
 import { Popover, PopoverContent, PopoverTrigger } from "@/components/ui/popover";
-import { STORY_STATES, STATE_LABEL, STATE_COLOR, STATE_ICON } from "../constants";
-import type { StoryState } from "../constants";
+import { STORY_STATES, STATE_LABEL, STATE_COLOR, STATE_ICON } from "@/shared/story/constants";
+import type { StoryState } from "@/shared/story/constants";
 import { cn } from "@/lib/utils";
 import { InlineTrigger } from "./inline-trigger";
 import { m } from "@/paraglide/messages.js";

package/src/components/story/inline-editors/story-select-dialog.tsx

@@ -37,7 +37,7 @@ import {
   DialogTitle,
 } from "@/components/ui/dialog";
 import { toast } from "@/components/ui/toast";
-import type { ActivityItem } from "../types";
+import type { ActivityItem } from "@/shared/story/types";
 import {
   listProjectStoriesFn,
   transferStoryAsChildFn,
@@ -51,7 +51,7 @@ import {
   STORY_PRIORITIES,
   type StoryState,
   type DependencyTypeOption,
-} from "../constants";
+} from "@/shared/story/constants";
 import { FilterCheckPopover } from "../filters/filter-check-popover";
 import { PriorityIcon } from "../priority-icon";
 import { DependencyTypeSelect } from "./dependency-type-select";

package/src/components/story/peek-panel.tsx

@@ -35,13 +35,13 @@ import {
   getLinkedDocsFn,
 } from "@/server/serverFns/story";
 import { listIterationsFn } from "@/server/serverFns/iteration";
-import type { StoryDetail, UserBrief, CommentWithReplies, ActivityItem, RelationsData } from "./types";
+import type { StoryDetail, UserBrief, CommentWithReplies, ActivityItem, RelationsData } from "@/shared/story/types";
 import { applyStoryPatchToItem, type StoryPatch } from "./display/group-fields";
-import type { StoryState } from "./constants";
+import type { StoryState } from "@/shared/story/constants";
 import { StoryDetailBody } from "./detail/story-detail-body";
 import { TestCasePeekPanel } from "@/components/testcase/peek-panel";
 import { BugPeekPanel } from "@/components/bug/peek-panel";
-import type { StoryEntityOverlay } from "./types";
+import type { StoryEntityOverlay } from "./entity-overlay";
 import { StoryPanelHeader } from "./story-panel-header";
 import type { PeekRelationKind, PeekBreadcrumbItem } from "./story-panel-header";
 import type { PeekMode } from "@/components/shared-kit/peek/peek-mode";
@@ -252,13 +252,14 @@ export function StoryPeekPanel({
           await Promise.all([detailP, restP]);
         if (historyRef.current.length === 0) {
           setRootIdentifier(story.identifier);
-          setRootProjectId(story.projectId);
+          // StoryDetail.projectId 为 string|null，PeekLocation 以 undefined 表无项目
+          setRootProjectId(story.projectId ?? undefined);
         } else {
           // 回填当前层 projectId：跨项目父子/依赖跳转时，面包屑各级需显示各自项目图标
           setHistory((prev) => {
             const last = prev[prev.length - 1];
             if (!last || last.projectId === story.projectId) return prev;
-            return prev.map((h, i) => (i === prev.length - 1 ? { ...h, projectId: story.projectId } : h));
+            return prev.map((h, i) => (i === prev.length - 1 ? { ...h, projectId: story.projectId ?? undefined } : h));
           });
         }
         const relationsData: RelationsData = {

package/src/components/story/priority-icon.tsx

@@ -16,8 +16,8 @@
 // along with this program. If not, see <https://www.gnu.org/licenses/>.
 
 import { cn } from "@/lib/utils";
-import { PRIORITY_ICON } from "./constants";
-import type { StoryPriority } from "./constants";
+import { PRIORITY_ICON } from "@/shared/story/constants";
+import type { StoryPriority } from "@/shared/story/constants";
 
 export const PRIORITY_COLOR: Record<StoryPriority, string> = {
   urgent: "text-red-600 dark:text-red-400",

package/src/components/story/relations/__tests__/attachment-manage-dialog.test.tsx

@@ -46,7 +46,7 @@ function uploadResponse(body: Record<string, unknown>) {
 }
 
 import { AttachmentManageDialog } from "../attachment-manage-dialog";
-import type { StoryAttachmentItem } from "../../types";
+import type { StoryAttachmentItem } from "@/shared/story/types";
 
 const ATTS: StoryAttachmentItem[] = [
   { id: "a1", fileName: "设计稿.png", fileSize: 2048, mimeType: "image/png", storageUrl: "/mock-storage/1" },

package/src/components/story/relations/__tests__/design-select-dialog.test.tsx

@@ -41,7 +41,7 @@ vi.mock("@/components/ui/toast", () => ({
 ;
 
 import { DesignSelectDialog } from "../design-select-dialog";
-import type { DesignBrief } from "../../types";
+import type { DesignBrief } from "@/shared/story/types";
 
 const design = (id: string, title: string, icon = "file"): DesignBrief => ({ id, title, icon });
 

package/src/components/story/relations/__tests__/knowledge-select-dialog.test.tsx

@@ -43,7 +43,7 @@ vi.mock("@/components/ui/toast", () => ({
 ;
 
 import { KnowledgeSelectDialog } from "../knowledge-select-dialog";
-import type { DocBrief } from "../../types";
+import type { DocBrief } from "@/shared/story/types";
 
 const doc = (id: string, title: string, parentId: string | null = null): DocBrief => ({
   id,

package/src/components/story/relations/__tests__/link-manage-dialog.test.tsx

@@ -41,7 +41,7 @@ vi.mock("@/components/ui/toast", () => ({
 ;
 
 import { LinkManageDialog } from "../link-manage-dialog";
-import type { StoryLinkItem } from "../../types";
+import type { StoryLinkItem } from "@/shared/story/types";
 
 const LINKS: StoryLinkItem[] = [
   { id: "l1", url: "https://a.com", title: "站点A", description: null },

package/src/components/story/relations/attachment-manage-dialog.tsx

@@ -28,7 +28,7 @@ import {
 import { Textarea } from "@/components/ui/textarea";
 import { getFileTypeIcon } from "./format";
 import { FilePreview } from "./file-preview";
-import type { StoryAttachmentItem } from "../types";
+import type { StoryAttachmentItem } from "@/shared/story/types";
 import { m } from "@/paraglide/messages.js";
 import { toastError } from "@/lib/toast-error";
 
@@ -49,7 +49,7 @@ export interface AttachmentManageDialogProps {
   data: StoryAttachmentItem[];
   onUpdate: (attachments: StoryAttachmentItem[]) => void;
   /** 上传附件产生的活动，供时间线即时追加 */
-  onActivity?: (activity: import("../types").ActivityItem) => void;
+  onActivity?: (activity: import("@/shared/story/types").ActivityItem) => void;
   /** 编辑模式：预填充现有附件，隐藏继续上传按钮和上传区 */
   editItem?: StoryAttachmentItem | null;
 }
@@ -242,7 +242,7 @@ export function AttachmentManageDialog({
     if (staged.length === 0 || uploading) return;
     setUploading(true);
     const desc = description.trim();
-    const added: Array<StoryAttachmentItem & { activity?: import("../types").ActivityItem }> = [];
+    const added: Array<StoryAttachmentItem & { activity?: import("@/shared/story/types").ActivityItem }> = [];
     for (const item of staged) {
       // 跳过重复文件
       if (duplicateIndexes.has(staged.indexOf(item))) continue;
@@ -263,7 +263,7 @@ export function AttachmentManageDialog({
         }
         const json = await res.json() as Record<string, unknown>;
         if ((json.duplicated as boolean | undefined) === true) continue;
-        added.push(json as unknown as StoryAttachmentItem & { activity?: import("../types").ActivityItem });
+        added.push(json as unknown as StoryAttachmentItem & { activity?: import("@/shared/story/types").ActivityItem });
       } catch (err) {
         toastError(err, m.story_attachmentDialog_removeFailed());
       }

package/src/components/story/relations/design-select-dialog.tsx

@@ -41,7 +41,7 @@ import {
 } from "@/server/serverFns/story";
 import { LucideIconByName } from "@/components/shared-kit/icons/lucide-icon-picker/lucide-icon-by-name";
 import { useLinkedSelection } from "./use-linked-selection";
-import type { DesignBrief } from "../types";
+import type { DesignBrief } from "@/shared/story/types";
 import { m } from "@/paraglide/messages.js";
 import { toastError } from "@/lib/toast-error";
 
@@ -56,7 +56,7 @@ export interface DesignSelectDialogProps {
   linkedDesigns: DesignBrief[];
   onUpdate: (designs: DesignBrief[]) => void;
   /** 关联/解联产生的活动，供时间线即时追加 */
-  onActivity?: (activity: import("../types").ActivityItem) => void;
+  onActivity?: (activity: import("@/shared/story/types").ActivityItem) => void;
 }
 
 function dialogTitle(mode: DesignSelectMode): string {

package/src/components/story/relations/knowledge-select-dialog.tsx

@@ -41,7 +41,7 @@ import { GENERAL_GROUPS, type GeneralGroup } from "@/server/serverFns/story/kb-g
 import { generalGroupLabel } from "./general-groups";
 import { useLinkedSelection } from "./use-linked-selection";
 import { KbFilterPopover, type KbFilter } from "@/components/knowledge/kb-filter-popover";
-import type { DocBrief } from "../types";
+import type { DocBrief } from "@/shared/story/types";
 import { m } from "@/paraglide/messages.js";
 import { toastError } from "@/lib/toast-error";
 
@@ -65,7 +65,7 @@ export interface KnowledgeSelectDialogProps {
   linkedDocs: DocBrief[];
   onUpdate: (docs: DocBrief[]) => void;
   /** 关联知识库文档产生的活动，供时间线即时追加 */
-  onActivity?: (activity: import("../types").ActivityItem) => void;
+  onActivity?: (activity: import("@/shared/story/types").ActivityItem) => void;
 }
 
 export function KnowledgeSelectDialog({

package/src/components/story/relations/link-manage-dialog.tsx

@@ -28,7 +28,7 @@ import {
   DialogTitle,
 } from "@/components/ui/dialog";
 import { addLinkFn, updateLinkFn } from "@/server/serverFns/story";
-import type { StoryLinkItem } from "../types";
+import type { StoryLinkItem } from "@/shared/story/types";
 import { m } from "@/paraglide/messages.js";
 import { toastError } from "@/lib/toast-error";
 
@@ -39,7 +39,7 @@ export interface LinkManageDialogProps {
   data: StoryLinkItem[];
   onUpdate: (links: StoryLinkItem[]) => void;
   /** 添加链接产生的活动，供时间线即时追加 */
-  onActivity?: (activity: import("../types").ActivityItem) => void;
+  onActivity?: (activity: import("@/shared/story/types").ActivityItem) => void;
   /** 非空时进入编辑态（由合并面板「编辑」触发） */
   initialEdit?: StoryLinkItem | null;
 }

package/src/components/story/relations/story-ref-row.tsx

@@ -39,7 +39,7 @@ import { PriorityEditor, StateEditor, AssigneeEditor, DateEditor, LabelsEditor,
 import { NameConfirmDialog } from "@/components/shared-kit/dialogs/name-confirm-dialog";
 import { cn } from "@/lib/utils";
 import { LucideIconByName } from "@/components/shared-kit/icons/lucide-icon-picker/lucide-icon-by-name";
-import { dependencyTypeOption } from "../constants";
+import { dependencyTypeOption } from "@/shared/story/constants";
 import type { DisplayProperty } from "../display/types";
 import type { StoryPatch } from "../display/group-fields";
 import type {
@@ -47,8 +47,8 @@ import type {
   UserBrief,
   DependencyEdgeType,
   DependencyGroup,
-} from "../types";
-import type { DependencyTypeOption } from "../constants";
+} from "@/shared/story/types";
+import type { DependencyTypeOption } from "@/shared/story/constants";
 import { m } from "@/paraglide/messages.js";
 import { toastError } from "@/lib/toast-error";
 

package/src/components/story/story-list-table.tsx

@@ -20,7 +20,7 @@ import { flexRender, useTable, type SortingState } from "@tanstack/react-table";
 import { useVirtualizer } from "@tanstack/react-virtual";
 import { ArrowDown, ArrowUp, ChevronDown } from "lucide-react";
 import { createStoryColumns, storyTableFeatures } from "./columns";
-import type { StoryListItem } from "./types";
+import type { StoryListItem } from "@/shared/story/types";
 import { ALL_DISPLAY_PROPERTIES } from "./display/types";
 import type { DisplayProperty, OrderKey } from "./display/types";
 import { InfiniteScrollSentinel } from "@/components/infinite-scroll-sentinel";

package/src/components/story/story-list-view.tsx

@@ -36,7 +36,7 @@ import {
   buildDefaultView, DEFAULT_VIEW_ID, type SavedView,
 } from "./views/view-types";
 import { isStoryView, type StoryView } from "./views/view-switcher";
-import type { UserBrief, StoryListItem } from "./types";
+import type { UserBrief, StoryListItem } from "@/shared/story/types";
 import type { DisplayOptions } from "./display/types";
 import { applyStoryPatchToItem, type StoryPatch } from "./display/group-fields";
 import { useDisplayOptions } from "./display/use-display-options";

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

@@ -39,7 +39,7 @@ import type { DisplayOptions } from "./display/types";
 import { StoryFilterToggle, StoryFilterRow, AppliedFilters, type FilterCondition } from "./filters";
 import { LucideIconByName } from "@/components/shared-kit/icons/lucide-icon-picker/lucide-icon-by-name";
 import { CreateProjectDialog } from "@/components/project/create-project-dialog";
-import type { UserBrief } from "./types";
+import type { UserBrief } from "@/shared/story/types";
 import { m } from "@/paraglide/messages.js";
 import { useToolbarSearch } from "@/hooks/use-toolbar-search";
 import { cn } from "@/lib/utils";

package/src/components/story/transfer-story-popover.tsx

@@ -41,11 +41,12 @@ interface TransferStoryPopoverProps {
   storyIds?: string[];
   currentProjectId?: string | null;
   projects: { id: string; name: string; displayId?: string | null; icon: string }[];
-  onTransferred: (updatedStories?: Array<{ id: string; identifier: string; projectId: string; parentId: string | null }>) => void;
+  onTransferred: (updatedStories?: Array<{ id: string; identifier: string; projectId: string | null; parentId: string | null }>) => void;
   trigger?: React.ReactNode;
 }
 
-type TransferredStory = { id: string; identifier: string; projectId: string; parentId: string | null };
+// projectId 诚实可空（公共行口径）；当前消费方仅清选择+刷新，不读载荷
+type TransferredStory = { id: string; identifier: string; projectId: string | null; parentId: string | null };
 
 export function TransferStoryPopover({
   storyId,

package/src/components/story/views/__tests__/calendar-view.test.tsx

@@ -22,7 +22,7 @@ import { CalendarView } from "../calendar-view";
 import { resolveDragBlockedToast } from "../calendar/drag-blocked";
 import { formatDateLocal } from "@/lib/datetime";
 import { m } from "@/paraglide/messages.js";
-import type { StoryListItem } from "../../types";
+import type { StoryListItem } from "@/shared/story/types";
 
 function story(
   id: string,

package/src/components/story/views/__tests__/kanban-drop-subgroup.test.ts

@@ -20,7 +20,7 @@
 // 原分区」而不发 patch，表现为拖到「已取消-高」却落进「已取消-低」。
 import { describe, expect, it } from "vitest";
 import { resolveDropSubKey, resolveSubKeyForDrop } from "../kanban-view";
-import type { StoryListItem } from "../../types";
+import type { StoryListItem } from "@/shared/story/types";
 
 const card = (id: string) => ({ id }) as StoryListItem;
 

package/src/components/story/views/__tests__/kanban-peek-sync.test.tsx

@@ -35,9 +35,9 @@ import { render, screen, waitFor } from "@testing-library/react";
 import userEvent from "@testing-library/user-event";
 import { TooltipProvider } from "@/components/ui/tooltip";
 import { KanbanView } from "../kanban-view";
-import { PRIORITY_LABEL } from "../../constants";
+import { PRIORITY_LABEL } from "@/shared/story/constants";
 import type { DisplayOptions, GroupNode } from "../../display/types";
-import type { StoryListItem } from "../../types";
+import type { StoryListItem } from "@/shared/story/types";
 
 vi.mock("@tanstack/react-start", () => ({
   useServerFn: (fn: unknown) => fn,

package/src/components/story/views/__tests__/kanban-view-membership-sync.test.tsx

@@ -33,7 +33,7 @@ import { act, render } from "@testing-library/react";
 import { TooltipProvider } from "@/components/ui/tooltip";
 import { KanbanView } from "../kanban-view";
 import type { DisplayOptions, GroupNode } from "../../display/types";
-import type { StoryListItem } from "../../types";
+import type { StoryListItem } from "@/shared/story/types";
 
 vi.mock("@tanstack/react-start", () => ({
   useServerFn: (fn: unknown) => fn,

package/src/components/story/views/__tests__/timeline-view.test.tsx

@@ -60,7 +60,7 @@ vi.mock("@/server/serverFns/iteration", () => ({
 import { TimelineView } from "../timeline-view";
 import { formatDateLocal } from "@/lib/datetime";
 import type { GroupKey } from "../../display/types";
-import type { StoryListItem } from "../../types";
+import type { StoryListItem } from "@/shared/story/types";
 
 function story(
   id: string,

package/src/components/story/views/calendar/__tests__/mappers.test.ts

@@ -22,7 +22,7 @@ import {
   fromGanttRangeToStoryDates,
 } from "../mappers";
 import { parseDate } from "@/lib/datetime";
-import type { StoryListItem } from "../../../types";
+import type { StoryListItem } from "@/shared/story/types";
 
 /** 需求样本工厂：固定 id/identifier/name/state，其余按需覆盖 */
 const mkStory = (over: Partial<StoryListItem> = {}): StoryListItem => ({

package/src/components/story/views/calendar/mappers.ts

@@ -37,7 +37,7 @@
 import { addDays, startOfDay } from "date-fns";
 import { parseDate } from "@/lib/datetime";
 import type { CalendarEvent } from "@/components/reui/event-calendar/event-calendar-types";
-import type { StoryListItem } from "../../types";
+import type { StoryListItem } from "@/shared/story/types";
 // 甘特导出单一事实源（禁止复制定义——复制即两份漂移）
 import { STORY_STATE_GANTT_COLOR } from "../timeline/mappers";
 

package/src/components/story/views/calendar-view.tsx

@@ -78,7 +78,7 @@ import type {
   EventCalendarViewSettings,
 } from "@/components/reui/event-calendar/event-calendar-types";
 import type { WeekStartsOn } from "@/components/reui/event-calendar/event-calendar-lib";
-import type { StoryListItem } from "../types";
+import type { StoryListItem } from "@/shared/story/types";
 import { applyOrder } from "../display/order-resolver";
 import type { OrderKey } from "../display/types";
 import {

package/src/components/story/views/create-view-dialog.tsx

@@ -38,7 +38,7 @@ import { StoryFilterRow } from "../filters";
 import { createDefaultCondition, type FilterCondition } from "../filters/field-configs";
 import { VIEW_ICONS, type SavedView, type ViewProjectInfo } from "./view-types";
 import { ViewIcon } from "@/components/shared-kit/views/view-icon";
-import type { UserBrief } from "../types";
+import type { UserBrief } from "@/shared/story/types";
 import { m } from "@/paraglide/messages.js";
 
 export interface CreateViewDialogPayload {