feat(folders): 完善公开文件夹功能 - 添加 /explore 和 /favorites 页面

- 新增 /explore 页面：浏览和搜索公开文件夹
- 新增 /explore/[id] 页面：以只读模式查看公开文件夹
- 新增 /favorites 页面：管理收藏的文件夹
- 重构 /folders 页面：仅显示当前用户的文件夹
- 更新导航栏：添加 Explore 和 Favorites 链接
- 添加 i18n 翻译：explore 和 favorites 相关文本
- 更新 AGENTS.md：添加数据库迁移规范（必须使用 migrate dev）

src/modules/folder/folder-aciton.ts

@@ -3,8 +3,39 @@
 import { auth } from "@/auth";
 import { headers } from "next/headers";
 import { ValidateError } from "@/lib/errors";
-import { ActionInputCreatePair, ActionInputUpdatePairById, ActionOutputGetFoldersWithTotalPairsByUserId, ActionOutputGetPublicFolders, ActionOutputSetFolderVisibility, ActionOutputToggleFavorite, ActionOutputCheckFavorite, validateActionInputCreatePair, validateActionInputUpdatePairById } from "./folder-action-dto";
-import { repoCreateFolder, repoCreatePair, repoDeleteFolderById, repoDeletePairById, repoGetFolderIdByPairId, repoGetFolderVisibility, repoGetFoldersByUserId, repoGetFoldersWithTotalPairsByUserId, repoGetPairsByFolderId, repoGetPublicFolders, repoGetUserIdByFolderId, repoRenameFolderById, repoSearchPublicFolders, repoUpdateFolderVisibility, repoUpdatePairById, repoToggleFavorite, repoCheckFavorite } from "./folder-repository";
+import {
+  ActionInputCreatePair,
+  ActionInputUpdatePairById,
+  ActionOutputGetFoldersWithTotalPairsByUserId,
+  ActionOutputGetPublicFolders,
+  ActionOutputSetFolderVisibility,
+  ActionOutputToggleFavorite,
+  ActionOutputCheckFavorite,
+  ActionOutputGetUserFavorites,
+  ActionOutputUserFavorite,
+  validateActionInputCreatePair,
+  validateActionInputUpdatePairById,
+} from "./folder-action-dto";
+import {
+  repoCreateFolder,
+  repoCreatePair,
+  repoDeleteFolderById,
+  repoDeletePairById,
+  repoGetFolderIdByPairId,
+  repoGetFolderVisibility,
+  repoGetFoldersByUserId,
+  repoGetFoldersWithTotalPairsByUserId,
+  repoGetPairsByFolderId,
+  repoGetPublicFolders,
+  repoGetUserIdByFolderId,
+  repoRenameFolderById,
+  repoSearchPublicFolders,
+  repoUpdateFolderVisibility,
+  repoUpdatePairById,
+  repoToggleFavorite,
+  repoCheckFavorite,
+  repoGetUserFavorites,
+} from "./folder-repository";
 import { validate } from "@/utils/validate";
 import z from "zod";
 import { LENGTH_MAX_FOLDER_NAME, LENGTH_MIN_FOLDER_NAME } from "@/shared/constant";
@@ -425,3 +456,41 @@ export async function actionCheckFavorite(
         };
     }
 }
+
+export async function actionGetUserFavorites(): Promise<ActionOutputGetUserFavorites> {
+    try {
+        const session = await auth.api.getSession({ headers: await headers() });
+        if (!session?.user?.id) {
+            return {
+                success: false,
+                message: 'Unauthorized',
+            };
+        }
+
+        const favorites = await repoGetUserFavorites({
+            userId: session.user.id,
+        });
+
+        return {
+            success: true,
+            message: 'success',
+            data: favorites.map((fav) => ({
+                id: fav.id,
+                folderId: fav.folderId,
+                folderName: fav.folderName,
+                folderCreatedAt: fav.folderCreatedAt,
+                folderTotalPairs: fav.folderTotalPairs,
+                folderOwnerId: fav.folderOwnerId,
+                folderOwnerName: fav.folderOwnerName,
+                folderOwnerUsername: fav.folderOwnerUsername,
+                favoritedAt: fav.favoritedAt,
+            })),
+        };
+    } catch (e) {
+        console.log(e);
+        return {
+            success: false,
+            message: 'Unknown error occured.',
+        };
+    }
+}

src/modules/folder/folder-action-dto.ts

@@ -84,3 +84,21 @@ export type ActionOutputCheckFavorite = {
         favoriteCount: number;
     };
 };
+
+export type ActionOutputUserFavorite = {
+    id: number;
+    folderId: number;
+    folderName: string;
+    folderCreatedAt: Date;
+    folderTotalPairs: number;
+    folderOwnerId: string;
+    folderOwnerName: string | null;
+    folderOwnerUsername: string | null;
+    favoritedAt: Date;
+};
+
+export type ActionOutputGetUserFavorites = {
+    message: string;
+    success: boolean;
+    data?: ActionOutputUserFavorite[];
+};

src/modules/folder/folder-repository-dto.ts

@@ -71,3 +71,21 @@ export type RepoOutputFavoriteStatus = {
   isFavorited: boolean;
   favoriteCount: number;
 };
+
+export interface RepoInputGetUserFavorites {
+  userId: string;
+  limit?: number;
+  offset?: number;
+}
+
+export type RepoOutputUserFavorite = {
+  id: number;
+  folderId: number;
+  folderName: string;
+  folderCreatedAt: Date;
+  folderTotalPairs: number;
+  folderOwnerId: string;
+  folderOwnerName: string | null;
+  folderOwnerUsername: string | null;
+  favoritedAt: Date;
+};

src/modules/folder/folder-repository.ts

@@ -11,6 +11,8 @@ import {
   RepoInputToggleFavorite,
   RepoInputCheckFavorite,
   RepoOutputFavoriteStatus,
+  RepoInputGetUserFavorites,
+  RepoOutputUserFavorite,
 } from "./folder-repository-dto";
 import { Visibility } from "../../../generated/prisma/enums";
 
@@ -272,3 +274,34 @@ export async function repoCheckFavorite(
     favoriteCount: count,
   };
 }
+
+export async function repoGetUserFavorites(input: RepoInputGetUserFavorites) {
+  const { userId, limit = 50, offset = 0 } = input;
+
+  const favorites = await prisma.folderFavorite.findMany({
+    where: { userId },
+    include: {
+      folder: {
+        include: {
+          _count: { select: { pairs: true } },
+          user: { select: { name: true, username: true } },
+        },
+      },
+    },
+    orderBy: { createdAt: "desc" },
+    take: limit,
+    skip: offset,
+  });
+
+  return favorites.map((fav) => ({
+    id: fav.id,
+    folderId: fav.folderId,
+    folderName: fav.folder.name,
+    folderCreatedAt: fav.folder.createdAt,
+    folderTotalPairs: fav.folder._count.pairs,
+    folderOwnerId: fav.folder.userId,
+    folderOwnerName: fav.folder.user.name,
+    folderOwnerUsername: fav.folder.user.username,
+    favoritedAt: fav.createdAt,
+  }));
+}