docs: add comments to the src/components directory

web/src/components/Layout/AuthLayout.tsx

@@ -1,6 +1,25 @@
+/*
+ * @Author: ZhaoYing 
+ * @Date: 2026-02-02 15:11:02 
+ * @Last Modified by:   ZhaoYing 
+ * @Last Modified time: 2026-02-02 15:11:02 
+ */
+/**
+ * AuthLayout Component
+ * 
+ * The main authenticated layout wrapper that provides:
+ * - Route authentication and permission checks
+ * - Automatic breadcrumb navigation updates
+ * - Sidebar navigation and header
+ * - Token-based authentication validation
+ * 
+ * @component
+ */
+
 import { Outlet } from 'react-router-dom';
 import { useEffect, type FC } from 'react';
 import { Layout } from 'antd';
+
 import useRouteGuard from '@/hooks/useRouteGuard';
 import { useNavigationBreadcrumbs } from '@/hooks/useNavigationBreadcrumbs';
 import AppHeader from '@/components/Header';
@@ -11,13 +30,20 @@ import { cookieUtils } from '@/utils/request';
 
 const { Content } = Layout;
 
-// 认证布局组件，使用useRouteGuard hook进行路由鉴权
+/**
+ * Authentication layout component that wraps all authenticated pages.
+ * Handles route guards, breadcrumb navigation, and user authentication.
+ */
 const AuthLayout: FC = () => {
   const { getUserInfo } = useUser();
-  // 使用路由守卫hook处理认证和权限检查
+  
+  // Use route guard hook to handle authentication and permission checks
   useRouteGuard('manage');
-  // 自动更新面包屑导航
+  
+  // Automatically update breadcrumb navigation based on current route
   useNavigationBreadcrumbs('manage');
+  
+  // Check authentication token and fetch user info on mount
   useEffect(() => {
     const authToken = cookieUtils.get('authToken')
     if (!authToken && !window.location.hash.includes('#/login')) {
@@ -29,9 +55,12 @@ const AuthLayout: FC = () => {
 
   return (
     <Layout style={{ minHeight: '100vh' }}>
+      {/* Sidebar navigation */}
       <Sider />
       <Layout style={{maxHeight: '100vh', width: '100vh', overflowY: 'auto' }}>
+        {/* Header with breadcrumbs and user menu */}
         <AppHeader />
+        {/* Main content area - renders child routes */}
         <Content style={{ padding: '16px 17px 24px 16px', zIndex: 0 }}>
           <Outlet />
         </Content>