@allbluecn/web-app 0.19.5 → 0.21.0

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

@@ -59,13 +59,13 @@ import { toast } from "@/components/ui/toast";
 import { toastError } from "@/lib/toast-error";
 import { m } from "@/paraglide/messages.js";
 import { updateStoryFn, reorderStoriesFn } from "@/server/serverFns/story";
-import type { StoryListItem, UserBrief } from "../types";
+import type { StoryListItem, UserBrief } from "@/shared/story/types";
 import { GROUP_FIELD, toGroupFieldPatch, type StoryPatch } from "../display/group-fields";
 import { buildGroupMeta, groupUniverse, resolveColumnTint } from "../display/group-resolver";
 import { COLLAPSED_SUBGROUPS_KEY } from "../display/use-collapsed-subgroups";
 import { useFitCount } from "../display/use-fit-count";
 import { DateEditor, PriorityEditor, StateEditor } from "../inline-editors";
-import { PRIORITY_LABEL, STATE_LABEL, STATE_ICON, STATE_COLOR } from "../constants";
+import { PRIORITY_LABEL, STATE_LABEL, STATE_ICON, STATE_COLOR } from "@/shared/story/constants";
 import { PriorityIcon } from "../priority-icon";
 import type {
   DisplayOptions,

package/src/components/story/views/story-list/batch-preview-dialog.tsx

@@ -40,10 +40,10 @@ import {
   STORY_STATES,
   STORY_PRIORITIES,
   type StoryState,
-} from "../../constants";
+} from "@/shared/story/constants";
 import { FilterCheckPopover } from "../../filters/filter-check-popover";
 import { PriorityIcon } from "../../priority-icon";
-import type { StoryListItem } from "../../types";
+import type { StoryListItem } from "@/shared/story/types";
 import { m } from "@/paraglide/messages.js";
 
 type BatchPreviewMode = "archive" | "delete";

package/src/components/story/views/story-list/batch-toolbar.tsx

@@ -28,9 +28,9 @@ import {
   DateEditor,
   LabelsEditor,
 } from "../../inline-editors";
-import type { UserBrief } from "../../types";
+import type { UserBrief } from "@/shared/story/types";
 import type { StoryPatch } from "../../display/group-fields";
-import type { StoryListItem } from "../../types";
+import type { StoryListItem } from "@/shared/story/types";
 import { BatchPreviewDialog } from "./batch-preview-dialog";
 import { TransferStoryPopover } from "../../transfer-story-popover";
 import { m } from "@/paraglide/messages.js";
@@ -57,7 +57,7 @@ export interface BatchToolbarProps {
   onRemoveRelations?: (storyIds: string[]) => void;
   onBulkUpdate: (patch: StoryPatch) => void;
   onClearSelection: () => void;
-  onTransfer: (updatedStories?: Array<{ id: string; identifier: string; projectId: string; parentId: string | null }>) => void;
+  onTransfer: (updatedStories?: Array<{ id: string; identifier: string; projectId: string | null; parentId: string | null }>) => void;
 }
 
 export function BatchToolbar({

package/src/components/story/views/story-list/group.tsx

@@ -16,11 +16,11 @@
 // along with this program. If not, see <https://www.gnu.org/licenses/>.
 
 import { memo, useEffect, useState } from "react";
-import { ChevronDown, ChevronRight, Plus, Loader2, ChevronsDown } from "lucide-react";
+import { ChevronDown, ChevronRight, Plus, Loader2, ChevronsDown, AlertCircle } from "lucide-react";
 import { Button } from "@/components/ui/button";
 import { Checkbox } from "@/components/ui/checkbox";
-import type { UserBrief } from "../../types";
-import { STORY_STATES, STORY_PRIORITIES, type StoryState, type StoryPriority } from "../../constants";
+import type { UserBrief } from "@/shared/story/types";
+import { STORY_STATES, STORY_PRIORITIES, type StoryState, type StoryPriority } from "@/shared/story/constants";
 import type { GroupNode, GroupKey } from "../../display/types";
 import { cn } from "@/lib/utils";
 import { InlineStoryCreator } from "./inline-story-creator";
@@ -35,7 +35,9 @@ const GROUP_DIMENSION_LABEL: Record<Extract<GroupKey, "assignee" | "createdBy">,
 };
 
 interface VirtualGroupHeaderProps {
-  node: GroupNode;
+  node: GroupNode & { error?: boolean };
+  /** S11：node.error 时的重试回调（不传则只显示失败态） */
+  onRetry?: () => void;
   depth: number;
   collapsed: boolean;
   collapseKey: string;
@@ -51,7 +53,7 @@ interface VirtualGroupHeaderProps {
   showRoleLabel: boolean;
 }
 
-export const VirtualGroupHeader = memo(function VirtualGroupHeader({ node, depth, collapsed, collapseKey, onToggle, onCreate, sticky, hideCreate, selectState, onToggleSelect, showSelect, groupDimension, showRoleLabel }: VirtualGroupHeaderProps) {
+export const VirtualGroupHeader = memo(function VirtualGroupHeader({ node, depth, collapsed, collapseKey, onToggle, onCreate, onRetry, sticky, hideCreate, selectState, onToggleSelect, showSelect, groupDimension, showRoleLabel }: VirtualGroupHeaderProps) {
   const textColor =
     node.color?.split(" ").find((c) => c.startsWith("text")) ?? "text-muted-foreground";
   const Icon = node.icon;
@@ -87,6 +89,17 @@ export const VirtualGroupHeader = memo(function VirtualGroupHeader({ node, depth
           </span>
         )}
         <span className="text-xs text-muted-foreground">{node.totalCount ?? node.items.length}</span>
+        {node.error && (
+          <button
+            type="button"
+            onClick={(e) => { e.stopPropagation(); onRetry?.(); }}
+            className="inline-flex h-4 shrink-0 items-center gap-0.5 rounded border border-destructive/30 px-1 text-[10px] font-normal text-destructive hover:bg-destructive/10"
+            title={m.story_group_loadFailed()}
+          >
+            <AlertCircle className="size-2.5" />
+            {m.story_group_retry()}
+          </button>
+        )}
       </button>
       {depth === 0 && onCreate && !hideCreate && (
         <button

package/src/components/story/views/story-list/index.tsx

@@ -26,8 +26,8 @@ import {
   reorderStoriesFn,
 } from "@/server/serverFns/story";
 import { toast } from "@/components/ui/toast";
-import type { UserBrief } from "../../types";
-import type { StoryState, StoryPriority } from "../../constants";
+import type { UserBrief } from "@/shared/story/types";
+import type { StoryState, StoryPriority } from "@/shared/story/constants";
 import type { DisplayOptions } from "../../display/types";
 import type { PagedGroupNode } from "../../display/use-paged-story-groups";
 import { BUTTON_ROW_HEIGHT, useFlatRows } from "./use-flat-rows";
@@ -484,6 +484,7 @@ export function StoryList({ groups, isLoading = false, displayFilters, users, la
               showSelect={selectedIds.size > 0}
               groupDimension={row.depth === 0 ? groupBy : subGroupBy}
               showRoleLabel={showRoleLabel}
+              onRetry={onRefresh}
             />
           </div>
           {create && (
@@ -556,6 +557,7 @@ export function StoryList({ groups, isLoading = false, displayFilters, users, la
       >
         <VirtualGroupHeader
           node={row.node}
+          onRetry={onRefresh}
           depth={row.depth}
           collapsed={row.isCollapsed}
           collapseKey={row.key}

package/src/components/story/views/story-list/inline-story-creator.tsx

@@ -18,8 +18,8 @@
 import { memo, useEffect, useRef, useMemo } from "react";
 import { Loader2, CalendarCheck, CalendarPlus2, Check, X, Trees } from "lucide-react";
 import { LucideIconByName } from "@/components/shared-kit/icons/lucide-icon-picker/lucide-icon-by-name";
-import type { UserBrief } from "../../types";
-import type { StoryState, StoryPriority } from "../../constants";
+import type { UserBrief } from "@/shared/story/types";
+import type { StoryState, StoryPriority } from "@/shared/story/constants";
 import { PriorityEditor, StateEditor, AssigneeEditor, DateEditor, LabelsEditor } from "../../inline-editors";
 import { m } from "@/paraglide/messages.js";
 

package/src/components/story/views/story-list/row.tsx

@@ -20,8 +20,8 @@ import { useServerFn } from "@tanstack/react-start";
 import { CalendarCheck, CalendarPlus2 } from "lucide-react";
 import { Checkbox } from "@/components/ui/checkbox";
 import { updateStoryFn } from "@/server/serverFns/story";
-import type { StoryListItem, UserBrief } from "../../types";
-import type { StoryState, StoryPriority } from "../../constants";
+import type { StoryListItem, UserBrief } from "@/shared/story/types";
+import type { StoryState, StoryPriority } from "@/shared/story/constants";
 import type { DisplayProperty } from "../../display/types";
 import { PriorityEditor, StateEditor, AssigneeEditor, DateEditor, LabelsEditor } from "../../inline-editors";
 import { cn } from "@/lib/utils";

package/src/components/story/views/story-list/use-flat-rows.ts

@@ -16,7 +16,7 @@
 // along with this program. If not, see <https://www.gnu.org/licenses/>.
 
 import { useMemo } from "react";
-import type { StoryListItem } from "../../types";
+import type { StoryListItem } from "@/shared/story/types";
 import type { GroupNode } from "../../display/types";
 
 /** 组尾「显示更多」/「添加需求」组合行高 */

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

@@ -30,9 +30,9 @@ import {
   type IterationBaseline,
 } from "../mappers";
 import { STATE_COLUMN_TINT, PRIORITY_COLUMN_TINT, resolveGroupColor } from "../../../display/group-resolver";
-import { STORY_STATES, STATE_LABEL, PRIORITY_LABEL, type StoryState } from "../../../constants";
+import { STORY_STATES, STATE_LABEL, PRIORITY_LABEL, type StoryState } from "@/shared/story/constants";
 import { parseDate } from "@/lib/datetime";
-import type { StoryListItem } from "../../../types";
+import type { StoryListItem } from "@/shared/story/types";
 import type { GroupContext } from "../../../display/types";
 import type { GanttEvent, GanttResource } from "@/components/reui/gantt/gantt-types";
 import { m } from "@/paraglide/messages.js";

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

@@ -35,8 +35,8 @@ import type {
   GanttEvent,
   GanttResource,
 } from "@/components/reui/gantt/gantt-types";
-import { STORY_STATES, type StoryState, type StoryPriority } from "../../constants";
-import type { StoryListItem } from "../../types";
+import { STORY_STATES, type StoryState, type StoryPriority } from "@/shared/story/constants";
+import type { StoryListItem } from "@/shared/story/types";
 import type { GroupContext, GroupKey, GroupNode } from "../../display/types";
 // 分组语义单一来源：priority/assignee/labels/createdBy/project 的桶划分与
 // 标签/颜色解析全部复用 display/group-resolver（禁止重写分组语义）。

package/src/components/story/views/timeline/use-date-commit.ts

@@ -36,7 +36,7 @@ import { toast } from "@/components/ui/toast";
 import { toastError } from "@/lib/toast-error";
 import { m } from "@/paraglide/messages.js";
 import { fromGanttRangeToStoryDates } from "./mappers";
-import type { StoryState } from "../../constants";
+import type { StoryState } from "@/shared/story/constants";
 
 /** 乐观覆盖：storyId → 覆盖后的两个日期（targetDate null = 保持无截止） */
 export interface StoryDateOverride {

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

@@ -70,12 +70,12 @@ import type {
   GanttResource,
   GanttScale,
 } from "@/components/reui/gantt/gantt-types";
-import { STATE_COLOR, STATE_LABEL } from "../constants";
+import { STATE_COLOR, STATE_LABEL } from "@/shared/story/constants";
 import {
   TIMELINE_GROUP_KEYS,
   type TimelineGroupKey,
 } from "../display/constants";
-import type { StoryListItem, UserBrief } from "../types";
+import type { StoryListItem, UserBrief } from "@/shared/story/types";
 import { applyOrder } from "../display/order-resolver";
 import type { GroupContext, GroupKey, OrderKey } from "../display/types";
 import {

package/src/components/testcase/__tests__/case-row.test.tsx

@@ -84,7 +84,7 @@ class MockIntersectionObserver {
 import { CaseRow } from "../list/case-row";
 import { GroupedList, type TestCaseGroupBy, type TestCaseGroupInfo } from "../list/grouped-list";
 import type { TestCaseSummary } from "@/server/serverFns/testcase/types";
-import type { UserBrief } from "@/components/story/types";
+import type { UserBrief } from "@/shared/story/types";
 import type { FolderNodeDto } from "../folder-tree";
 
 const makeUser = (id: string, username: string): UserBrief => ({

package/src/components/testcase/__tests__/create-dialog-scope.test.tsx

@@ -50,7 +50,7 @@ vi.mock("@/components/story/inline-editors/story-select-dialog", () => ({
 
 import { CreateTestCaseDialog } from "../create-testcase-dialog";
 import type { TestCaseSummary } from "@/server/serverFns/testcase/types";
-import type { UserBrief } from "@/components/story/types";
+import type { UserBrief } from "@/shared/story/types";
 import type { FolderNodeDto } from "../folder-tree";
 
 const makeUser = (id: string, username: string): UserBrief => ({

package/src/components/testcase/__tests__/display-options.test.tsx

@@ -36,7 +36,7 @@ import {
   DEFAULT_TESTCASE_DISPLAY_OPTIONS,
   TESTCASE_DISPLAY_PROPERTIES,
   type TestCaseDisplayOptions,
-} from "../display/field-configs";
+} from "@/shared/testcase/field-configs";
 
 const OPTIONS: TestCaseDisplayOptions = {
   ...DEFAULT_TESTCASE_DISPLAY_OPTIONS,

package/src/components/testcase/__tests__/export-entry.test.tsx

@@ -64,7 +64,7 @@ vi.mock("@/components/ui/toast", () => ({
 vi.mock("@/lib/toast-error", () => ({ toastError: H.toastErrorFn }));
 
 import { TestCaseToolbar } from "../testcase-toolbar";
-import type { TestCaseDisplayOptions } from "../display/field-configs";
+import type { TestCaseDisplayOptions } from "@/shared/testcase/field-configs";
 import type { TestcaseFilterCondition } from "../filters";
 
 const CSV = "\uFEFF编号,标题,类型,优先级,状态,负责人\r\nWEB-TC1,登录成功,functional,p1,approved,";

package/src/components/testcase/__tests__/list-view.test.tsx

@@ -180,7 +180,7 @@ class MockIntersectionObserver {
 import { TestCaseListView } from "../list-view";
 import type { TestCaseSummary } from "@/server/serverFns/testcase/types";
 import type { TestCaseFilterViewDTO } from "@/server/serverFns/testcase/testcase-filter-views";
-import { DEFAULT_TESTCASE_DISPLAY_OPTIONS, type TestCaseDisplayOptions } from "../display/field-configs";
+import { DEFAULT_TESTCASE_DISPLAY_OPTIONS, type TestCaseDisplayOptions } from "@/shared/testcase/field-configs";
 import { listTestCaseBoardColumnsFn } from "@/server/serverFns/testcase/testcase-board";
 import { serializeFilters } from "../filters";
 

package/src/components/testcase/__tests__/step-editor.test.tsx

@@ -71,7 +71,7 @@ import { useState } from "react";
 import { StepEditor, type StepDraft } from "../step-editor";
 import { CreateTestCaseDialog } from "../create-testcase-dialog";
 import type { TestCaseSummary } from "@/server/serverFns/testcase/types";
-import type { UserBrief } from "@/components/story/types";
+import type { UserBrief } from "@/shared/story/types";
 import type { FolderNodeDto } from "../folder-tree";
 import { toast } from "@/components/ui/toast";
 
@@ -157,7 +157,9 @@ describe("StepEditor", () => {
     fireEvent.click(screen.getByTestId("step-add"));
     const last = onChange.mock.calls.at(-1)![0] as StepDraft[];
     expect(last).toHaveLength(3);
-    expect(last[2]).toEqual({ action: "", expected: "" });
+    // S15：新增行携带稳定 id（仅本地草稿键控用）
+    expect(last[2]).toMatchObject({ action: "", expected: "" });
+    expect(typeof last[2]!.id).toBe("string");
   });
 
   it("边界序号：首行上移/末行下移为 no-op（按钮禁用）", () => {

package/src/components/testcase/__tests__/toolbar.test.tsx

@@ -60,7 +60,7 @@ vi.mock("@/server/serverFns/testcase/testcase-export", () => ({
 }));
 
 import { TestCaseToolbar } from "../testcase-toolbar";
-import type { TestCaseDisplayOptions } from "../display/field-configs";
+import type { TestCaseDisplayOptions } from "@/shared/testcase/field-configs";
 
 afterEach(() => {
   cleanup();

package/src/components/testcase/create-testcase-dialog.tsx

@@ -47,13 +47,13 @@ import { toast } from "@/components/ui/toast";
 import { createTestCaseFn } from "@/server/serverFns/testcase/testcase-crud";
 import type { TestCasePriority, TestCaseType } from "@/server/serverFns/testcase/constants";
 import type { TestCaseSummary } from "@/server/serverFns/testcase/types";
-import type { UserBrief } from "@/components/story/types";
+import type { UserBrief } from "@/shared/story/types";
 import { StorySelectDialog } from "@/components/story/inline-editors/story-select-dialog";
 import { TypeEditor } from "./inline-editors/type-editor";
 import { PriorityEditor } from "./inline-editors/priority-editor";
 import { FolderEditor } from "./inline-editors/folder-editor";
 import { AssigneeEditor } from "./inline-editors/assignee-editor";
-import { StepEditor, isStepDraftsValid, type StepDraft } from "./step-editor";
+import { StepEditor, isStepDraftsValid, newStepDraftId, type StepDraft } from "./step-editor";
 import type { FolderNodeDto } from "./folder-tree";
 import { m } from "@/paraglide/messages.js";
 
@@ -77,7 +77,8 @@ interface CreateTestCaseDialogProps {
   onSuccess?: (testCase: TestCaseSummary) => void;
 }
 
-const INITIAL_STEPS: StepDraft[] = [{ action: "", expected: "" }];
+// S15：工厂替代模块级常量（每次打开 dialog 生成带稳定 id 的行）
+const makeInitialSteps = (): StepDraft[] => [{ id: newStepDraftId(), action: "", expected: "" }];
 
 export function CreateTestCaseDialog({
   open,
@@ -91,7 +92,7 @@ export function CreateTestCaseDialog({
 }: CreateTestCaseDialogProps) {
   const [title, setTitle] = useState("");
   const [precondition, setPrecondition] = useState("");
-  const [steps, setSteps] = useState<StepDraft[]>(INITIAL_STEPS);
+  const [steps, setSteps] = useState<StepDraft[]>(makeInitialSteps);
   const [type, setType] = useState<TestCaseType>("functional");
   const [priority, setPriority] = useState<TestCasePriority>("p1");
   const [folderId, setFolderId] = useState<string | null>(null);
@@ -109,7 +110,7 @@ export function CreateTestCaseDialog({
     if (!open) return;
     setTitle("");
     setPrecondition("");
-    setSteps(INITIAL_STEPS.map((s) => ({ ...s })));
+    setSteps(makeInitialSteps());
     setType("functional");
     setPriority("p1");
     setFolderId(initialFolderId ?? null);

package/src/components/testcase/detail/case-detail-body.tsx

@@ -39,7 +39,7 @@ import type {
   TestCaseDetail,
   TestCaseStoryRef,
 } from "@/server/serverFns/testcase/types";
-import type { UserBrief } from "@/components/story/types";
+import type { UserBrief } from "@/shared/story/types";
 import type { FolderNodeDto } from "../folder-tree";
 import type { TestCaseUpdatePatch } from "../list/case-row";
 import { buildRoomName } from "@allbluecn/collab-core/rooms";

package/src/components/testcase/detail/properties.tsx

@@ -24,7 +24,7 @@ import { ExternalLink } from "lucide-react";
 import { Badge } from "@/components/ui/badge";
 import type { TestCaseDetail, TestCaseStoryRef } from "@/server/serverFns/testcase/types";
 import type { TestCaseAutomation } from "@/server/serverFns/testcase/constants";
-import type { UserBrief } from "@/components/story/types";
+import type { UserBrief } from "@/shared/story/types";
 import type { FolderNodeDto } from "../folder-tree";
 import type { TestCaseUpdatePatch } from "../list/case-row";
 import { AssigneeEditor } from "../inline-editors/assignee-editor";

package/src/components/testcase/display/display-dropdown.tsx

@@ -42,14 +42,14 @@ import type {
   TestCaseDisplayProperty,
   TestCaseGroupKey,
   TestCaseOrderKey,
-} from "./field-configs";
+} from "@/shared/testcase/field-configs";
 import {
   DEFAULT_TESTCASE_DISPLAY_OPTIONS,
   TESTCASE_DISPLAY_PROPERTIES,
   TESTCASE_GROUP_KEYS,
   TESTCASE_ORDER_KEYS,
   TESTCASE_PAGE_SIZE_OPTIONS,
-} from "./field-configs";
+} from "@/shared/testcase/field-configs";
 
 /** 分组维度标签（testcase_display_ 域文案，照 bug display/constants 裁剪） */
 const GROUP_LABELS: Record<TestCaseGroupKey, () => string> = {

package/src/components/testcase/display/use-testcase-display-options.ts

@@ -26,7 +26,7 @@ import {
 import {
   DEFAULT_TESTCASE_DISPLAY_OPTIONS,
   type TestCaseDisplayOptions,
-} from "./field-configs";
+} from "@/shared/testcase/field-configs";
 
 export interface TestCaseDisplayOptionsState {
   filters: TestCaseDisplayOptions;

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

@@ -69,7 +69,7 @@ import type {
   FilterUserLike,
 } from "@/components/shared-kit/list-kit/filters";
 import { cn } from "@/lib/utils";
-import type { UserBrief } from "@/components/story/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/testcase/generation/draft-card.tsx

@@ -33,7 +33,7 @@ import {
 } from "@/components/ui/dialog";
 import { Input } from "@/components/ui/input";
 import { Textarea } from "@/components/ui/textarea";
-import { StepEditor, isStepDraftsValid, type StepDraft } from "@/components/testcase/step-editor";
+import { StepEditor, isStepDraftsValid, newStepDraftId, type StepDraft } from "@/components/testcase/step-editor";
 import { stateLabel, typeLabel, priorityLabel } from "@/components/testcase/filters";
 import type {
   TestCasePriority,
@@ -121,7 +121,7 @@ export function DraftCard({
   const [title, setTitle] = useState(draft.title);
   const [precondition, setPrecondition] = useState(draft.precondition ?? "");
   const [steps, setSteps] = useState<StepDraft[]>(() =>
-    draft.steps.steps.map((s) => ({ action: s.action, expected: s.expected ?? "" })),
+    draft.steps.steps.map((s) => ({ id: newStepDraftId(), action: s.action, expected: s.expected ?? "" })),
   );
 
   const openEditDialog = () => {

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

@@ -22,7 +22,7 @@ import { Check, CircleUser, Search } 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 "@/components/story/types";
+import type { UserBrief } from "@/shared/story/types";
 import { cn } from "@/lib/utils";
 import { m } from "@/paraglide/messages.js";
 

package/src/components/testcase/list/case-row.tsx

@@ -40,7 +40,7 @@ import {
 import { updateTestCaseFn } from "@/server/serverFns/testcase/testcase-crud";
 import type { TestCaseAutomation, TestCasePriority, TestCaseState, TestCaseType } from "@/server/serverFns/testcase/constants";
 import type { TestCaseSteps, TestCaseSummary } from "@/server/serverFns/testcase/types";
-import type { UserBrief } from "@/components/story/types";
+import type { UserBrief } from "@/shared/story/types";
 import type { FolderNodeDto } from "../folder-tree";
 import { PriorityEditor } from "../inline-editors/priority-editor";
 import { StateEditor } from "../inline-editors/state-editor";

package/src/components/testcase/list/grouped-list.tsx

@@ -27,7 +27,7 @@ import { ChevronDown, ChevronRight } from "lucide-react";
 import { InfiniteScrollSentinel } from "@/components/infinite-scroll-sentinel";
 import type { TestCaseState, TestCasePriority } from "@/server/serverFns/testcase/constants";
 import type { TestCaseSummary } from "@/server/serverFns/testcase/types";
-import type { UserBrief } from "@/components/story/types";
+import type { UserBrief } from "@/shared/story/types";
 import type { FolderNodeDto } from "../folder-tree";
 import { priorityLabel, stateLabel } from "../filters";
 import { CaseRow } from "./case-row";

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

@@ -53,7 +53,7 @@ import {
   updateFilterViewFn,
 } from "@/server/serverFns/testcase/testcase-filter-views";
 import type { TestCaseSummary } from "@/server/serverFns/testcase/types";
-import type { UserBrief } from "@/components/story/types";
+import type { UserBrief } from "@/shared/story/types";
 import { GroupedList, groupKeyOf, type TestCaseGroupInfo } from "./list/grouped-list";
 import { computeMove, canMove } from "@/components/shared-kit/list-kit/move";
 import { TestCaseBoardView } from "./views/board-view";
@@ -62,7 +62,7 @@ import { manualOrderSwitchPatch } from "@/components/shared-kit/list-kit/kanban/
 import { toast } from "@/components/ui/toast";
 import { TestCasePeekPanel, type PeekMode } from "./peek-panel";
 import { useTestcaseDisplayOptions } from "./display/use-testcase-display-options";
-import type { TestCaseGroupKey } from "./display/field-configs";
+import type { TestCaseGroupKey } from "@/shared/testcase/field-configs";
 import { CreateViewDialog, type CreateViewDialogPayload } from "./views/create-view-dialog";
 import { CreateTestCaseDialog } from "./create-testcase-dialog";
 import { TestCaseBatchToolbar } from "./views/batch-toolbar";

package/src/components/testcase/runs/convert-bug-button.tsx

@@ -26,10 +26,10 @@ import { useCallback, useState } from "react";
 import { Bug as BugIcon } from "lucide-react";
 import { Button } from "@/components/ui/button";
 import { CreateBugDialog, type CreateBugDialogDefaults } from "@/components/bug/create-bug-dialog";
-import type { ReproduceSteps } from "@/components/bug/types";
+import type { ReproduceSteps } from "@/shared/bug/types";
 import { listUsersBriefFn, listLabelsFn } from "@/server/serverFns/story";
 import { listProjectsBriefFn } from "@/server/serverFns/project";
-import type { UserBrief } from "@/components/story/types";
+import type { UserBrief } from "@/shared/story/types";
 import type {
   RunCaseExecutionDetail,
   RunCaseSummary,

package/src/components/testcase/step-editor.tsx

@@ -31,6 +31,17 @@ import { m } from "@/paraglide/messages.js";
 export interface StepDraft {
   action: string;
   expected: string;
+  /**
+   * 行稳定 id（S15）：仅本地草稿模式（create dialog / AI draft）用于 React key，
+   * 消除中段插入/删除时的跨行状态串位；granular 协同模式不消费（Y 增量仍按
+   * 索引映射，id 不落库——提交侧 order 由索引推导，id 自然剥离）。
+   */
+  readonly id?: string;
+}
+
+/** 行稳定 id 生成（本地草稿专用，S15） */
+export function newStepDraftId(): string {
+  return crypto.randomUUID();
 }
 
 interface StepEditorProps {
@@ -79,7 +90,7 @@ export function StepEditor({ value, onChange, disabled, className, granular }: S
       granular.onInsertStep(value.length, { action: "", expected: "" });
       return;
     }
-    onChange([...value, { action: "", expected: "" }]);
+    onChange([...value, { id: newStepDraftId(), action: "", expected: "" }]);
   };
 
   const removeStep = (i: number) => {
@@ -128,7 +139,7 @@ export function StepEditor({ value, onChange, disabled, className, granular }: S
           const showActionError = dirty.has(i) && actionEmpty;
           return (
             <li
-              key={i}
+              key={step.id ?? `idx-${i}`}
               className="flex items-start gap-2"
               data-testid={`step-row-${i}`}
             >

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

@@ -72,11 +72,11 @@ import {
 import { toast } from "@/components/ui/toast";
 import { toastError } from "@/lib/toast-error";
 import type { FolderNodeDto } from "./folder-tree";
-import type { UserBrief } from "@/components/story/types";
+import type { UserBrief } from "@/shared/story/types";
 import { ViewSelectorButton } from "./views/view-selector-button";
 import { ViewSwitcher } from "./views/view-switcher";
 import { TestCaseDisplayDropdown } from "./display/display-dropdown";
-import type { TestCaseDisplayOptions } from "./display/field-configs";
+import type { TestCaseDisplayOptions } from "@/shared/testcase/field-configs";
 import type { TestCaseSavedView, TestCaseViewType } from "./views/view-types";
 import { m } from "@/paraglide/messages.js";
 import { getLocale } from "@/paraglide/runtime.js";

package/src/components/testcase/views/batch-toolbar.tsx

@@ -37,7 +37,7 @@ import { PriorityEditor } from "../inline-editors/priority-editor";
 import { AssigneeEditor } from "../inline-editors/assignee-editor";
 import { FolderEditor } from "../inline-editors/folder-editor";
 import type { FolderNodeDto } from "../folder-tree";
-import type { UserBrief } from "@/components/story/types";
+import type { UserBrief } from "@/shared/story/types";
 import { toastError } from "@/lib/toast-error";
 import { cn } from "@/lib/utils";
 import { m } from "@/paraglide/messages.js";

package/src/components/testcase/views/board-view.tsx

@@ -44,7 +44,7 @@ import type {
   TestCaseType,
 } from "@/server/serverFns/testcase/constants";
 import type { TestCaseSummary } from "@/server/serverFns/testcase/types";
-import type { UserBrief } from "@/components/story/types";
+import type { UserBrief } from "@/shared/story/types";
 import type { FolderNodeDto } from "../folder-tree";
 import type { TestCaseUpdatePatch } from "../list/case-row";
 import { PriorityEditor } from "../inline-editors/priority-editor";
@@ -56,7 +56,7 @@ import {
   TEST_CASE_TYPE_META,
 } from "../constants";
 import { priorityLabel, stateLabel, typeLabel } from "../filters";
-import type { TestCaseDisplayProperty } from "../display/field-configs";
+import type { TestCaseDisplayProperty } from "@/shared/testcase/field-configs";
 import {
   KanbanBoardView,
   type ColumnTint,

package/src/lib/changelog/sdk-versions.ts

@@ -96,14 +96,14 @@ export const SDK_GROUPS: SdkGroup[] = [
     "items": [
       {
         "name": "@allbluecn/web-app",
-        "version": "v0.19.5",
+        "version": "v0.21.0",
         "lastUpdate": "Oct 28, 2026",
         "source": "apps/web/package.json",
         "docsUrl": "https://github.com/allbluecn/allblue"
       },
       {
         "name": "@allbluecn/kernel",
-        "version": "v0.10.1",
+        "version": "v0.11.0",
         "lastUpdate": "Oct 28, 2026",
         "source": "packages/kernel/package.json",
         "docsUrl": "https://github.com/allbluecn/allblue"

package/src/lib/collections/knowledge/knowledge-bases-collection.ts

@@ -20,7 +20,8 @@ import { queryCollectionOptions } from '@tanstack/query-db-collection'
 import { listKnowledgeFn } from '@/server/serverFns/knowledge'
 import { getQueryClient } from '@/lib/query-client-seam'
 
-export const KNOWLEDGE_BASES_QUERY_KEY = ['knowledge-bases'] as const
+import { KNOWLEDGE_BASES_QUERY_KEY } from "@/lib/collections/query-keys"
+export { KNOWLEDGE_BASES_QUERY_KEY }
 
 export const knowledgeBasesCollection = createCollection(
   queryCollectionOptions({

package/src/lib/collections/query-keys.ts

@@ -0,0 +1,18 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+
+// React Query key 常量（零依赖纯模块）。
+//
+// 为什么单独成文件：collection 模块在**模块作用域**执行
+// `createCollection({ ... queryClient: getQueryClient() })`，而 getQueryClient()
+// 在 SSR 未注入时 fail-fast（防跨请求缓存串染）。路由文件（如 _nav/route.tsx）
+// 只需要 key 常量做 prefetch，却值引入 collection 模块 → SSR 模块初始化阶段
+// 就触发 getQueryClient()，早于 router.tsx 的 setQueryClient，全站 500。
+// 消费方一律从本模块取 key；collection 模块转 re-export 保持兼容。
+export const WORKSPACES_QUERY_KEY = ['workspaces'] as const
+export const KNOWLEDGE_BASES_QUERY_KEY = ['knowledge-bases'] as const
+export const PROJECTS_QUERY_KEY = ['projects'] as const
+export const LABELS_QUERY_KEY = ['labels'] as const
+export const USERS_BRIEF_QUERY_KEY = ['users-brief'] as const
+export const BOOKMARK_CATEGORIES_QUERY_KEY = ['bookmark-categories'] as const