@allbluecn/web-app 0.3.0

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

@@ -0,0 +1,123 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+import { createServerFn } from "@tanstack/react-start";
+import { getRequest } from "@tanstack/react-start/server";
+import { z } from "zod";
+import { prisma } from "@allbluecn/database";
+import { requireAuth } from "@/server/auth-helpers";
+import { buildStoryTree, checkDescendant } from "./types";
+
+export const getStoryTreeFn = createServerFn({ method: "GET" })
+  .validator(z.object({ rootId: z.string().optional() }))
+  .handler(async ({ data }) => {
+    const request = getRequest();
+    await requireAuth(request);
+
+    const rootStories = await prisma.story.findMany({
+      where: data.rootId ? { id: data.rootId } : { parentId: null },
+      include: {
+        children: {
+          include: {
+            children: {
+              include: {
+                children: true,
+              },
+            },
+          },
+        },
+      },
+    });
+
+    const tree = await Promise.all(
+      rootStories.map(async (story) => buildStoryTree(story)),
+    );
+
+    return tree;
+  });
+
+export const addChildFn = createServerFn({ method: "POST" })
+  .validator(z.object({ parentId: z.string(), childId: z.string() }))
+  .handler(async ({ data }) => {
+    const request = getRequest();
+    await requireAuth(request);
+
+    const existingChild = await prisma.story.findUnique({
+      where: { id: data.childId },
+    });
+    if (existingChild?.parentId) {
+      throw new Error("此需求已经是某个需求的子需求");
+    }
+
+    const isDescendant = await checkDescendant(data.childId, data.parentId);
+    if (isDescendant) {
+      throw new Error("不能将子需求设为其父需求的子需求（循环依赖）");
+    }
+
+    const child = await prisma.story.update({
+      where: { id: data.childId },
+      data: { parentId: data.parentId },
+    });
+
+    return child;
+  });
+
+export const removeChildFn = createServerFn({ method: "POST" })
+  .validator(z.object({ childId: z.string() }))
+  .handler(async ({ data }) => {
+    const request = getRequest();
+    await requireAuth(request);
+
+    const child = await prisma.story.update({
+      where: { id: data.childId },
+      data: { parentId: null },
+    });
+
+    return child;
+  });
+
+export const moveChildFn = createServerFn({ method: "POST" })
+  .validator(z.object({ childId: z.string(), newParentId: z.string() }))
+  .handler(async ({ data }) => {
+    const request = getRequest();
+    await requireAuth(request);
+
+    const isDescendant = await checkDescendant(data.childId, data.newParentId);
+    if (isDescendant) {
+      throw new Error("不能将子需求移动到其后代节点（循环依赖）");
+    }
+
+    const child = await prisma.story.update({
+      where: { id: data.childId },
+      data: { parentId: data.newParentId },
+    });
+
+    return child;
+  });
+
+export const getChildrenCountFn = createServerFn({ method: "GET" })
+  .validator(z.object({ parentId: z.string() }))
+  .handler(async ({ data }) => {
+    const request = getRequest();
+    await requireAuth(request);
+
+    const count = await prisma.story.count({
+      where: { parentId: data.parentId },
+    });
+
+    return { count };
+  });

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

@@ -0,0 +1,223 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+import { prisma, Prisma } from "@allbluecn/database";
+import type { AvatarConfig } from "@allbluecn/shared";
+import type { StoryState, StoryPriority } from "@/components/story/constants";
+import type {
+  UserBrief,
+  ReactionGroup,
+} from "@/components/story/types";
+
+export const USER_BRIEF_SELECT = {
+  id: true,
+  username: true,
+  email: true,
+  avatarConfig: true,
+  bgShape: true,
+  bgColor: true,
+} satisfies Prisma.UserDefaultArgs["select"];
+
+export const STORY_LIST_SELECT = {
+  id: true,
+  identifier: true,
+  sequenceId: true,
+  name: true,
+  description: true,
+  state: true,
+  priority: true,
+  archived: true,
+  startDate: true,
+  targetDate: true,
+  boardOrder: true,
+  projectId: true,
+  parentId: true,
+  parent: { select: { id: true, name: true, state: true, identifier: true } },
+  assignee: { select: USER_BRIEF_SELECT },
+  createdBy: { select: USER_BRIEF_SELECT },
+  updatedBy: { select: USER_BRIEF_SELECT },
+  labels: { select: { label: { select: { id: true, name: true, color: true } } } },
+  createdAt: true,
+  updatedAt: true,
+} satisfies Prisma.StoryDefaultArgs["select"];
+
+export const STORY_LIST_SELECT_LIGHT = {
+  id: true,
+  identifier: true,
+  sequenceId: true,
+  name: true,
+  state: true,
+  priority: true,
+  archived: true,
+  startDate: true,
+  targetDate: true,
+  boardOrder: true,
+  projectId: true,
+  parentId: true,
+  parent: { select: { id: true, name: true, state: true, identifier: true } },
+  assignee: { select: USER_BRIEF_SELECT },
+  createdBy: { select: USER_BRIEF_SELECT },
+  labels: { select: { label: { select: { id: true, name: true, color: true } } } },
+  createdAt: true,
+  updatedAt: true,
+} satisfies Prisma.StoryDefaultArgs["select"];
+
+export type StoryListRow = Prisma.StoryGetPayload<{ select: typeof STORY_LIST_SELECT }>;
+
+export type StoryListRowLight = Prisma.StoryGetPayload<{ select: typeof STORY_LIST_SELECT_LIGHT }>;
+
+export function castStoryUsers<S extends StoryListRow>(s: S) {
+  return {
+    ...s,
+    state: s.state as StoryState,
+    priority: s.priority as StoryPriority,
+    startDate: s.startDate ? s.startDate.toISOString() : null,
+    targetDate: s.targetDate ? s.targetDate.toISOString() : null,
+    createdAt: s.createdAt.toISOString(),
+    updatedAt: s.updatedAt.toISOString(),
+    assignee: s.assignee
+      ? { ...s.assignee, avatarConfig: (s.assignee.avatarConfig as AvatarConfig | null) ?? null }
+      : null,
+    createdBy: {
+      ...s.createdBy,
+      avatarConfig: (s.createdBy.avatarConfig as AvatarConfig | null) ?? null,
+    },
+    updatedBy: s.updatedBy
+      ? { ...s.updatedBy, avatarConfig: (s.updatedBy.avatarConfig as AvatarConfig | null) ?? null }
+      : null,
+    parent: s.parent ? { id: s.parent.id, title: s.parent.name, status: s.parent.state as StoryState, identifier: s.parent.identifier } : null,
+    labels: s.labels.map((sl) => sl.label),
+  };
+}
+
+export function castStoryUsersLight<S extends StoryListRowLight>(s: S) {
+  return {
+    ...s,
+    description: null,
+    state: s.state as StoryState,
+    priority: s.priority as StoryPriority,
+    startDate: s.startDate ? s.startDate.toISOString() : null,
+    targetDate: s.targetDate ? s.targetDate.toISOString() : null,
+    createdAt: s.createdAt.toISOString(),
+    updatedAt: s.updatedAt.toISOString(),
+    assignee: s.assignee
+      ? { ...s.assignee, avatarConfig: (s.assignee.avatarConfig as AvatarConfig | null) ?? null }
+      : null,
+    createdBy: {
+      ...s.createdBy,
+      avatarConfig: (s.createdBy.avatarConfig as AvatarConfig | null) ?? null,
+    },
+    parent: s.parent ? { id: s.parent.id, title: s.parent.name, status: s.parent.state as StoryState, identifier: s.parent.identifier } : null,
+    labels: s.labels.map((sl) => sl.label),
+  };
+}
+
+export function castUserBrief(u: {
+  id: string;
+  username: string;
+  email: string;
+  avatarConfig: unknown;
+  bgShape: string | null;
+  bgColor: string | null;
+}): UserBrief {
+  return {
+    ...u,
+    avatarConfig: (u.avatarConfig as AvatarConfig | null) ?? null,
+  };
+}
+
+export function aggregateReactions(
+  reactions: { emoji: string; userId: string }[],
+  currentUserId: string,
+): ReactionGroup[] {
+  const map = new Map<string, string[]>();
+  for (const r of reactions) {
+    const arr = map.get(r.emoji) ?? [];
+    arr.push(r.userId);
+    map.set(r.emoji, arr);
+  }
+  return Array.from(map.entries()).map(([emoji, userIds]) => ({
+    emoji,
+    count: userIds.length,
+    userIds,
+    reacted: userIds.includes(currentUserId),
+  }));
+}
+
+export function toValidDate(value: string): Date | null {
+  const d = new Date(value);
+  return isNaN(d.getTime()) ? null : d;
+}
+
+export function toDateOnly(d: Date): string {
+  const y = d.getFullYear();
+  const m = String(d.getMonth() + 1).padStart(2, "0");
+  const day = String(d.getDate()).padStart(2, "0");
+  return `${y}-${m}-${day}`;
+}
+
+export interface StoryTreeNode {
+  id: string;
+  title: string;
+  status: string;
+  parentId: string | null;
+  depth: number;
+  hasChildren: boolean;
+  childrenCount: number;
+  children?: StoryTreeNode[];
+}
+
+export async function buildStoryTree(story: any, depth = 0): Promise<StoryTreeNode> {
+  const childrenCount = await prisma.story.count({
+    where: { parentId: story.id },
+  });
+
+  return {
+    id: story.id,
+    title: story.name,
+    status: story.state,
+    parentId: story.parentId,
+    depth,
+    hasChildren: childrenCount > 0,
+    childrenCount,
+    children: story.children
+      ? await Promise.all(
+          story.children.map((child: any) => buildStoryTree(child, depth + 1)),
+        )
+      : undefined,
+  };
+}
+
+export async function checkDescendant(
+  ancestorId: string,
+  descendantId: string,
+): Promise<boolean> {
+  let current = await prisma.story.findUnique({
+    where: { id: descendantId },
+    select: { parentId: true },
+  });
+
+  while (current?.parentId) {
+    if (current.parentId === ancestorId) return true;
+    current = await prisma.story.findUnique({
+      where: { id: current.parentId },
+      select: { parentId: true },
+    });
+  }
+
+  return false;
+}

package/src/server/serverFns/story-display-options.ts

@@ -0,0 +1,156 @@
+// 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/>.
+
+// apps/web/src/server/serverFns/story-display-options.ts
+import { createServerFn } from "@tanstack/react-start"
+import { getRequest } from "@tanstack/react-start/server"
+import { z } from "zod"
+import { prisma, type Prisma } from "@allbluecn/database"
+import { requireAuth } from "@/server/auth-helpers"
+import { requireFeature } from "@/server/entitlements"
+import {
+  DEFAULT_DISPLAY_OPTIONS,
+  GROUP_KEYS,
+  ORDER_KEYS,
+  ORDER_DIRECTIONS,
+  ALL_DISPLAY_PROPERTIES,
+  PAGE_SIZE_OPTIONS,
+  type DisplayOptions,
+  type DisplayProperty,
+  type GroupKey,
+  type OrderKey,
+  type OrderDirection,
+  type PageSize,
+} from "@/components/story/display/types"
+
+/** Prisma Json 字段不接受强类型对象（缺 index signature），统一 cast */
+function toJson<T>(value: T): Prisma.InputJsonValue {
+  return value as unknown as Prisma.InputJsonValue
+}
+
+/** 解析存储的 JSON 偏好，非法/缺失字段回退默认值 */
+function parseStoredOptions(raw: unknown): DisplayOptions {
+  if (typeof raw !== "object" || raw === null) return { ...DEFAULT_DISPLAY_OPTIONS }
+  const o = raw as Record<string, unknown>
+
+  const groupBy =
+    typeof o.groupBy === "string" && (GROUP_KEYS as readonly string[]).includes(o.groupBy)
+      ? (o.groupBy as GroupKey)
+      : DEFAULT_DISPLAY_OPTIONS.groupBy
+  const subGroupBy =
+    typeof o.subGroupBy === "string" && (GROUP_KEYS as readonly string[]).includes(o.subGroupBy)
+      ? (o.subGroupBy as GroupKey)
+      : DEFAULT_DISPLAY_OPTIONS.subGroupBy
+  const orderBy =
+    typeof o.orderBy === "string" && (ORDER_KEYS as readonly string[]).includes(o.orderBy)
+      ? (o.orderBy as OrderKey)
+      : DEFAULT_DISPLAY_OPTIONS.orderBy
+  const orderDir =
+    typeof o.orderDir === "string" && (ORDER_DIRECTIONS as readonly string[]).includes(o.orderDir)
+      ? (o.orderDir as OrderDirection)
+      : DEFAULT_DISPLAY_OPTIONS.orderDir
+  const props = Array.isArray(o.properties)
+    ? (o.properties as unknown[]).filter(
+        (p): p is DisplayProperty =>
+          typeof p === "string" && (ALL_DISPLAY_PROPERTIES as readonly string[]).includes(p),
+      )
+    : []
+
+  return {
+    groupBy,
+    subGroupBy,
+    orderBy,
+    orderDir,
+    properties:
+      props.length > 0 ? props : DEFAULT_DISPLAY_OPTIONS.properties,
+    showEmptyGroups:
+      typeof o.showEmptyGroups === "boolean"
+        ? o.showEmptyGroups
+        : DEFAULT_DISPLAY_OPTIONS.showEmptyGroups,
+    showSubItems:
+      typeof o.showSubItems === "boolean"
+        ? o.showSubItems
+        : DEFAULT_DISPLAY_OPTIONS.showSubItems,
+    pageSize:
+      typeof o.pageSize === "number" && (PAGE_SIZE_OPTIONS as readonly number[]).includes(o.pageSize)
+        ? (o.pageSize as PageSize)
+        : DEFAULT_DISPLAY_OPTIONS.pageSize,
+  }
+}
+
+const groupBySchema = z.enum(GROUP_KEYS)
+const orderBySchema = z.enum(ORDER_KEYS)
+const orderDirSchema = z.enum(ORDER_DIRECTIONS)
+const propertySchema = z.enum(ALL_DISPLAY_PROPERTIES)
+const pageSizeSchema = z.union([z.literal(100), z.literal(200), z.literal(500), z.literal(1000)])
+
+export const displayOptionsSchema = z.object({
+  groupBy: groupBySchema,
+  subGroupBy: groupBySchema,
+  orderBy: orderBySchema,
+  orderDir: orderDirSchema,
+  properties: z.array(propertySchema),
+  showEmptyGroups: z.boolean(),
+  showSubItems: z.boolean(),
+  pageSize: pageSizeSchema,
+})
+
+/** 获取当前用户持久化的 Display Options（非法/缺失字段已回退默认值） */
+export const getStoryDisplayOptionsFn = createServerFn({ method: "GET" }).handler(
+  async () => {
+    const request = getRequest()
+    const session = await requireAuth(request)
+    const userId = session.user!.id!
+
+    const user = await prisma.user.findUnique({
+      where: { id: userId },
+      select: { storyDisplayOptions: true },
+    })
+    const options = parseStoredOptions(user?.storyDisplayOptions)
+
+    // 订阅过期/降级：已持久化的 500/1000 无权限时降级为 200
+    if (options.pageSize > 200) {
+      try {
+        await requireFeature(request, "largePageSize")
+      } catch {
+        options.pageSize = 200
+      }
+    }
+    return options
+  },
+)
+
+/** 保存当前用户的 Display Options，返回更新后的完整对象 */
+export const updateStoryDisplayOptionsFn = createServerFn({ method: "POST" })
+  .validator(displayOptionsSchema)
+  .handler(async ({ data }) => {
+    const request = getRequest()
+    const session = await requireAuth(request)
+    const userId = session.user!.id!
+
+    // 服务端强制校验：pageSize > 200（500/1000）为 Pro 专属，前端锁定只是 UX
+    if (data.pageSize > 200) {
+      await requireFeature(request, "largePageSize")
+    }
+
+    const options: DisplayOptions = data
+    await prisma.user.update({
+      where: { id: userId },
+      data: { storyDisplayOptions: toJson(options) },
+    })
+    return options
+  })

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

@@ -0,0 +1,138 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+import { createServerFn } from "@tanstack/react-start";
+import { getRequest } from "@tanstack/react-start/server";
+import { z } from "zod";
+import { prisma, Prisma } from "@allbluecn/database";
+import { requireAuth } from "@/server/auth-helpers";
+import { toSavedView, type SavedView } from "@/components/story/views/view-types";
+import type { FilterCondition } from "@/components/story/filters/filter-types";
+import type { DisplayOptions } from "@/components/story/display/types";
+
+function toJson<T>(value: T): Prisma.InputJsonValue {
+  return value as unknown as Prisma.InputJsonValue;
+}
+
+const SELECT = {
+  id: true,
+  userId: true,
+  name: true,
+  description: true,
+  icon: true,
+  projectId: true,
+  filters: true,
+  displayOptions: true,
+  sortOrder: true,
+  createdAt: true,
+  updatedAt: true,
+} satisfies Prisma.StoryFilterViewDefaultArgs["select"];
+
+export const listStoryViewsFn = createServerFn({ method: "GET" }).handler(async () => {
+  const request = getRequest();
+  const session = await requireAuth(request);
+  const userId = session.user!.id!;
+  const rows = await prisma.storyFilterView.findMany({
+    where: { userId },
+    orderBy: { sortOrder: "asc" },
+    select: SELECT,
+  });
+  return rows.map((r: any) => toSavedView(r));
+});
+
+const filterConditionSchema = z.object({
+  id: z.string(),
+  property: z.string(),
+  operator: z.string(),
+  value: z.string(),
+});
+
+const createSchema = z.object({
+  name: z.string().min(1).max(50),
+  description: z.string().max(200).optional(),
+  icon: z.string().default("list"),
+  projectId: z.string().optional(),
+  filters: z.array(filterConditionSchema),
+  displayOptions: z.unknown(),
+});
+
+export const createStoryViewFn = createServerFn({ method: "POST" })
+  .validator(createSchema)
+  .handler(async ({ data }) => {
+    const request = getRequest();
+    const session = await requireAuth(request);
+    const userId = session.user!.id!;
+    const row = await prisma.storyFilterView.create({
+      data: {
+        userId,
+        name: data.name,
+        description: data.description ?? null,
+        icon: data.icon,
+        projectId: data.projectId ?? null,
+        filters: toJson(data.filters as FilterCondition[]),
+        displayOptions: toJson(data.displayOptions as unknown as DisplayOptions),
+      },
+      select: SELECT,
+    });
+    return toSavedView(row);
+  });
+
+const updateSchema = z.object({
+  id: z.string(),
+  name: z.string().min(1).max(50).optional(),
+  description: z.string().max(200).nullable().optional(),
+  icon: z.string().optional(),
+  projectId: z.string().nullable().optional(),
+  filters: z.array(filterConditionSchema).optional(),
+  displayOptions: z.unknown().optional(),
+});
+
+export const updateStoryViewFn = createServerFn({ method: "POST" })
+  .validator(updateSchema)
+  .handler(async ({ data }) => {
+    const request = getRequest();
+    const session = await requireAuth(request);
+    const userId = session.user!.id!;
+    const { id, ...patch } = data;
+    const data2: Record<string, unknown> = {};
+    if (patch.name !== undefined) data2.name = patch.name;
+    if (patch.description !== undefined) data2.description = patch.description;
+    if (patch.icon !== undefined) data2.icon = patch.icon;
+    if (patch.projectId !== undefined) data2.projectId = patch.projectId;
+    if (patch.filters !== undefined) data2.filters = toJson(patch.filters as FilterCondition[]);
+    if (patch.displayOptions !== undefined) data2.displayOptions = toJson(patch.displayOptions as unknown as DisplayOptions);
+    const row = await prisma.storyFilterView.update({
+      where: { id, userId },
+      data: data2,
+      select: SELECT,
+    });
+    return toSavedView(row);
+  });
+
+const deleteSchema = z.object({ id: z.string() });
+
+export const deleteStoryViewFn = createServerFn({ method: "POST" })
+  .validator(deleteSchema)
+  .handler(async ({ data }) => {
+    const request = getRequest();
+    const session = await requireAuth(request);
+    const userId = session.user!.id!;
+    await prisma.storyFilterView.delete({ where: { id: data.id, userId } });
+    return { success: true };
+  });
+
+export type { SavedView };