diff --git a/app/admin/_components/CategoriesTab.tsx b/app/admin/_components/CategoriesTab.tsx index b8fbdd8..c4a6408 100644 --- a/app/admin/_components/CategoriesTab.tsx +++ b/app/admin/_components/CategoriesTab.tsx @@ -1,3 +1,15 @@ +/** + * CategoriesTab 组件 + * + * 分类管理Tab组件 + * 从主页面拆分出来,负责分类管理功能 + * 包括店铺分类、场景类别、平台分类的管理 + * 使用三层架构样式系统,支持深浅色主题 + * + * @created 2025-01-XX(拆分自 page.tsx) + * @component + */ + 'use client' import { useState, useEffect, useCallback } from 'react' diff --git a/app/admin/_components/DepartmentsTab.tsx b/app/admin/_components/DepartmentsTab.tsx index 7a8b7ba..8b49892 100644 --- a/app/admin/_components/DepartmentsTab.tsx +++ b/app/admin/_components/DepartmentsTab.tsx @@ -1,3 +1,15 @@ +/** + * DepartmentsTab 组件 + * + * 部门管理Tab组件 + * 从主页面拆分出来,负责部门管理功能 + * 包括部门树形结构、创建、删除、重命名等 + * 使用三层架构样式系统,支持深浅色主题 + * + * @created 2025-01-XX(拆分自 page.tsx) + * @component + */ + 'use client' import { useCallback, useMemo, useState } from 'react' diff --git a/app/admin/_components/InvitationsTab.tsx b/app/admin/_components/InvitationsTab.tsx index abe0fa9..4fdda36 100644 --- a/app/admin/_components/InvitationsTab.tsx +++ b/app/admin/_components/InvitationsTab.tsx @@ -1,3 +1,15 @@ +/** + * InvitationsTab 组件 + * + * 邀请管理Tab组件 + * 从主页面拆分出来,负责邀请管理功能 + * 包括邀请列表、创建、删除、验证等 + * 使用三层架构样式系统,支持深浅色主题 + * + * @created 2025-01-XX(拆分自 page.tsx) + * @component + */ + 'use client' import { useState, useEffect, useCallback } from 'react' diff --git a/app/admin/_components/MaterialsTab.tsx b/app/admin/_components/MaterialsTab.tsx index e844cbc..9369167 100644 --- a/app/admin/_components/MaterialsTab.tsx +++ b/app/admin/_components/MaterialsTab.tsx @@ -1,3 +1,15 @@ +/** + * MaterialsTab 组件 + * + * 素材管理Tab组件 + * 从主页面拆分出来,负责素材管理功能 + * 包括素材列表、搜索、预览等 + * 使用三层架构样式系统,支持深浅色主题 + * + * @created 2025-01-XX(拆分自 page.tsx) + * @component + */ + 'use client' import { useState, useEffect, useCallback, useMemo } from 'react' diff --git a/app/admin/_components/MonitorTab.tsx b/app/admin/_components/MonitorTab.tsx index d2dfb6a..42d6e26 100644 --- a/app/admin/_components/MonitorTab.tsx +++ b/app/admin/_components/MonitorTab.tsx @@ -1,3 +1,15 @@ +/** + * MonitorTab 组件 + * + * 系统监控仪表板Tab组件 + * 从主页面拆分出来,负责显示系统监控数据 + * 包括用户统计、素材统计、系统状态等信息 + * 使用三层架构样式系统,支持深浅色主题 + * + * @created 2025-01-XX(拆分自 page.tsx) + * @component + */ + 'use client' import { useEffect, useMemo } from 'react' diff --git a/app/admin/_components/UsersTab.tsx b/app/admin/_components/UsersTab.tsx index a88f5b2..bc2dc57 100644 --- a/app/admin/_components/UsersTab.tsx +++ b/app/admin/_components/UsersTab.tsx @@ -1,3 +1,15 @@ +/** + * UsersTab 组件 + * + * 用户管理Tab组件 + * 从主页面拆分出来,负责用户管理功能 + * 包括用户列表、搜索、编辑、删除、权限管理等 + * 使用三层架构样式系统,支持深浅色主题 + * + * @created 2025-01-XX(拆分自 page.tsx) + * @component + */ + 'use client' import { useCallback, useMemo, useState } from 'react' diff --git a/app/admin/_hooks/useDashboardData.ts b/app/admin/_hooks/useDashboardData.ts index dc43807..ce56d3b 100644 --- a/app/admin/_hooks/useDashboardData.ts +++ b/app/admin/_hooks/useDashboardData.ts @@ -1,3 +1,14 @@ +/** + * useDashboardData Hook + * + * 仪表板数据获取Hook + * 统一管理监控仪表板的数据获取逻辑 + * 包括数据加载、错误处理、刷新等功能 + * + * @created 2025-01-XX(从 page.tsx 提取) + * @hook + */ + 'use client' import { useCallback, useState } from 'react' diff --git a/app/admin/_hooks/useDataFetch.ts b/app/admin/_hooks/useDataFetch.ts index 5225df8..d6b0d11 100644 --- a/app/admin/_hooks/useDataFetch.ts +++ b/app/admin/_hooks/useDataFetch.ts @@ -1,3 +1,14 @@ +/** + * useDataFetch Hook + * + * 统一的数据获取Hook + * 提供用户数据、部门数据、Tab数据的获取功能 + * 从主页面提取,减少重复代码 + * + * @created 2025-01-XX(从 page.tsx 提取) + * @hook + */ + 'use client' import { useCallback } from 'react' diff --git a/app/admin/_hooks/useDepartmentOperations.ts b/app/admin/_hooks/useDepartmentOperations.ts index 7e1cc36..216cb79 100644 --- a/app/admin/_hooks/useDepartmentOperations.ts +++ b/app/admin/_hooks/useDepartmentOperations.ts @@ -1,6 +1,12 @@ /** - * 部门操作 Hook + * useDepartmentOperations Hook + * + * 部门操作Hook * 统一管理部门相关的操作(创建、删除、重命名等) + * 包括数据验证、错误处理、Toast通知 + * + * @created 2025-01-XX(从 page.tsx 提取) + * @hook */ 'use client' diff --git a/app/admin/_hooks/useModalState.ts b/app/admin/_hooks/useModalState.ts index 2e47582..1dfe799 100644 --- a/app/admin/_hooks/useModalState.ts +++ b/app/admin/_hooks/useModalState.ts @@ -1,3 +1,14 @@ +/** + * useModalState Hook + * + * 模态框状态管理Hook + * 统一管理模态框的打开/关闭状态 + * 支持泛型,可以存储模态框相关的数据 + * + * @created 2025-01-XX(从 page.tsx 提取) + * @hook + */ + 'use client' import { useCallback, useState } from 'react' diff --git a/app/admin/_hooks/usePermissions.ts b/app/admin/_hooks/usePermissions.ts index 744428e..dba668a 100644 --- a/app/admin/_hooks/usePermissions.ts +++ b/app/admin/_hooks/usePermissions.ts @@ -1,3 +1,14 @@ +/** + * usePermissions Hook + * + * 权限检查Hook + * 统一管理用户权限检查逻辑 + * 包括:是否可管理用户、是否超级管理员等 + * + * @created 2025-01-XX(从 page.tsx 提取) + * @hook + */ + 'use client' import { useCallback, useMemo } from 'react' diff --git a/app/admin/_hooks/useToast.ts b/app/admin/_hooks/useToast.ts index 6c60cbd..348051b 100644 --- a/app/admin/_hooks/useToast.ts +++ b/app/admin/_hooks/useToast.ts @@ -1,3 +1,15 @@ +/** + * useToast Hook + * + * 统一的Toast通知管理Hook + * 提供显示和关闭Toast的功能 + * 支持成功和错误两种类型 + * 自动管理Toast的显示和隐藏 + * + * @created 2025-01-XX(从 page.tsx 提取) + * @hook + */ + 'use client' import { useCallback, useEffect, useRef, useState } from 'react' diff --git a/app/admin/_hooks/useUserOperations.ts b/app/admin/_hooks/useUserOperations.ts index 5457101..26e5bcb 100644 --- a/app/admin/_hooks/useUserOperations.ts +++ b/app/admin/_hooks/useUserOperations.ts @@ -1,6 +1,12 @@ /** - * 用户操作 Hook + * useUserOperations Hook + * + * 用户操作Hook * 统一管理用户相关的操作(更新、删除、切换状态等) + * 包括:更新用户、删除用户、切换下载权限、切换激活状态、设置角色、转移最高权限 + * + * @created 2025-01-XX(从 page.tsx 提取) + * @hook */ 'use client' diff --git a/app/admin/_utils/api.ts b/app/admin/_utils/api.ts index 4faa488..45077b3 100644 --- a/app/admin/_utils/api.ts +++ b/app/admin/_utils/api.ts @@ -1,6 +1,12 @@ /** * API 工具函数 + * * 统一处理 API 请求和错误响应 + * 提供类型安全的API请求封装 + * 包括:错误响应解析、成功响应解析、统一请求函数、错误消息获取 + * + * @created 2025-01-XX(从各组件提取) + * @utils */ import type { ApiErrorResponse, ApiSuccessResponse } from '../_components/types' diff --git a/app/admin/_utils/departmentTree.ts b/app/admin/_utils/departmentTree.ts index 34ab89f..75e42bc 100644 --- a/app/admin/_utils/departmentTree.ts +++ b/app/admin/_utils/departmentTree.ts @@ -1,3 +1,13 @@ +/** + * 部门树工具函数 + * + * 部门树结构处理工具函数 + * 包括:构建部门树、克隆节点、排序等功能 + * + * @created 2025-01-XX(从 page.tsx 提取) + * @utils + */ + import { getDepartmentCollator } from '@/lib/departments' import type { Department, DepartmentNode } from '../_components/types' diff --git a/app/admin/_utils/formatters.ts b/app/admin/_utils/formatters.ts index 173ea21..b31786e 100644 --- a/app/admin/_utils/formatters.ts +++ b/app/admin/_utils/formatters.ts @@ -1,6 +1,12 @@ /** * 格式化工具函数 + * * 统一管理各种格式化逻辑(日期、时间、数字等) + * 包括:日期时间格式化、文件大小格式化、数字格式化、百分比格式化等 + * 确保整个应用的格式化一致性 + * + * @created 2025-01-XX(从各组件提取) + * @utils */ import { format } from 'date-fns' diff --git a/app/edit/[id]/page.tsx b/app/edit/[id]/page.tsx index efae395..f31bc5b 100644 --- a/app/edit/[id]/page.tsx +++ b/app/edit/[id]/page.tsx @@ -1,9 +1,21 @@ +/** + * EditMaterialPage 组件 + * + * 素材编辑页面 + * 允许用户编辑自己上传的素材信息 + * 使用三层架构样式系统,支持深浅色主题 + * + * @created 2025-01-XX + * @component + */ + 'use client' import { useEffect, useState, useCallback } from 'react' import { useSession } from 'next-auth/react' import { useRouter } from 'next/navigation' import Header from '@/components/Header' +import { useThemeStyles, cn } from '@/lib/ui-styles' interface Material { id: string @@ -24,6 +36,7 @@ interface Material { } export default function EditMaterialPage({ params }: { params: { id: string } }) { + const styles = useThemeStyles() const { data: session, status } = useSession() const router = useRouter() const [loading, setLoading] = useState(true) @@ -180,21 +193,21 @@ export default function EditMaterialPage({ params }: { params: { id: string } }) if (status === 'loading' || loading) { return ( -