✨ feat(home-icon): 新增首页图标管理功能

- 创建首页图标实体类，支持轮播图和分类图标管理
- 实现图标上传、编辑、删除、启用状态切换功能
- 集成现有Minio文件上传组件
- 添加管理员菜单"图标发布"入口
- 支持拖拽排序和状态管理
- 包含完整的前后端CRUD API实现

home-icon-management-implementation-plan.md

@@ -0,0 +1,245 @@
+# 首页图标发布功能实现方案
+
+## 项目概述
+在后端管理页面首页增加"图标发布"菜单，用于管理首页轮播图和分类图标的上传。使用现有的文件上传组件，上传后保存文件ID并关联文件实体。
+
+## 技术架构
+
+### 1. 实体设计 (src/server/modules/home/home-icon.entity.ts)
+```typescript
+// 首页图标实体 - 支持轮播图和分类图标
+@Entity('home_icons')
+export class HomeIcon {
+  @PrimaryGeneratedColumn({ unsigned: true })
+  id!: number;
+
+  @Column({ name: 'title', type: 'varchar', length: 255, comment: '图标标题' })
+  title!: string;
+
+  @Column({ name: 'type', type: 'varchar', length: 20, comment: '图标类型: banner, category' })
+  type!: string;
+
+  @Column({ name: 'file_id', type: 'int', unsigned: true, comment: '关联文件ID' })
+  fileId!: number;
+
+  @ManyToOne(() => File)
+  @JoinColumn({ name: 'file_id', referencedColumnName: 'id' })
+  file!: File;
+
+  @Column({ name: 'sort_order', type: 'int', default: 0, comment: '排序顺序' })
+  sortOrder!: number;
+
+  @Column({ name: 'is_enabled', type: 'tinyint', default: 1, comment: '是否启用: 0-禁用, 1-启用' })
+  isEnabled!: number;
+
+  @Column({ name: 'link_url', type: 'varchar', length: 512, nullable: true, comment: '链接地址' })
+  linkUrl!: string | null;
+
+  @Column({ name: 'description', type: 'text', nullable: true, comment: '描述信息' })
+  description!: string | null;
+
+  @CreateDateColumn({ name: 'created_at' })
+  createdAt!: Date;
+
+  @UpdateDateColumn({ name: 'updated_at' })
+  updatedAt!: Date;
+}
+```
+
+### 2. 服务实现 (src/server/modules/home/home-icon.service.ts)
+```typescript
+import { GenericCrudService } from '@/server/utils/generic-crud.service';
+import { HomeIcon } from './home-icon.entity';
+
+export class HomeIconService extends GenericCrudService<HomeIcon> {
+  constructor(dataSource: DataSource) {
+    super(dataSource, HomeIcon);
+  }
+
+  async getBanners(): Promise<HomeIcon[]> {
+    return this.getList(1, 100, undefined, undefined, {
+      type: 'banner',
+      isEnabled: 1
+    });
+  }
+
+  async getCategoryIcons(): Promise<HomeIcon[]> {
+    return this.getList(1, 100, undefined, undefined, {
+      type: 'category',
+      isEnabled: 1
+    });
+  }
+}
+```
+
+### 3. API路由设计 (src/server/api/home-icons/index.ts)
+使用通用CRUD路由创建标准RESTful API：
+- GET /api/v1/home-icons - 获取图标列表
+- POST /api/v1/home-icons - 创建新图标
+- GET /api/v1/home-icons/{id} - 获取单个图标
+- PUT /api/v1/home-icons/{id} - 更新图标
+- DELETE /api/v1/home-icons/{id} - 删除图标
+
+### 4. 前端页面实现 (src/client/admin/pages/HomeIcons.tsx)
+
+#### 页面功能
+- 轮播图管理表格
+- 分类图标管理表格
+- 文件上传组件集成
+- 拖拽排序功能
+- 启用/禁用状态切换
+
+#### 主要组件结构
+```typescript
+const HomeIconsPage: React.FC = () => {
+  const [activeTab, setActiveTab] = useState<'banner' | 'category'>('banner');
+  
+  return (
+    <PageContainer>
+      <Tabs activeKey={activeTab} onChange={setActiveTab}>
+        <TabPane tab="轮播图管理" key="banner">
+          <BannerTable />
+        </TabPane>
+        <TabPane tab="分类图标管理" key="category">
+          <CategoryIconTable />
+        </TabPane>
+      </Tabs>
+    </PageContainer>
+  );
+};
+```
+
+### 5. 菜单和路由配置
+
+#### 菜单添加 (src/client/admin/menu.tsx)
+```typescript
+{
+  key: 'home-icons',
+  label: '图标发布',
+  icon: <PictureOutlined />,
+  path: '/admin/home-icons'
+}
+```
+
+#### 路由添加 (src/client/admin/routes.tsx)
+```typescript
+{
+  path: 'home-icons',
+  element: <HomeIconsPage />,
+  errorElement: <ErrorPage />
+}
+```
+
+## 文件上传集成方案
+
+### 使用现有MinioUploader组件
+```typescript
+const UploadSection: React.FC<{ type: 'banner' | 'category' }> = ({ type }) => {
+  const handleUploadSuccess = (fileKey: string, fileUrl: string, file: File) => {
+    // 创建新的图标记录
+    createHomeIcon({
+      title: file.name,
+      type,
+      fileId: extractFileIdFromKey(fileKey),
+      sortOrder: 0,
+      isEnabled: 1
+    });
+  };
+
+  return (
+    <MinioUploader
+      uploadPath={`/home-icons/${type}`}
+      accept="image/*"
+      maxSize={5}
+      onUploadSuccess={handleUploadSuccess}
+      buttonText={`上传${type === 'banner' ? '轮播图' : '分类图标'}`}
+    />
+  );
+};
+```
+
+## 数据库迁移脚本
+
+```sql
+CREATE TABLE `home_icons` (
+  `id` int(11) unsigned NOT NULL AUTO_INCREMENT,
+  `title` varchar(255) NOT NULL DEFAULT '' COMMENT '图标标题',
+  `type` varchar(20) NOT NULL DEFAULT '' COMMENT '图标类型: banner, category',
+  `file_id` int(11) unsigned NOT NULL COMMENT '关联文件ID',
+  `sort_order` int(11) NOT NULL DEFAULT '0' COMMENT '排序顺序',
+  `is_enabled` tinyint(1) NOT NULL DEFAULT '1' COMMENT '是否启用: 0-禁用, 1-启用',
+  `link_url` varchar(512) DEFAULT NULL COMMENT '链接地址',
+  `description` text COMMENT '描述信息',
+  `created_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  `updated_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+  PRIMARY KEY (`id`),
+  KEY `idx_type_enabled` (`type`, `is_enabled`),
+  KEY `idx_sort_order` (`sort_order`),
+  KEY `idx_file_id` (`file_id`),
+  CONSTRAINT `fk_home_icon_file` FOREIGN KEY (`file_id`) REFERENCES `file` (`id`) ON DELETE RESTRICT ON UPDATE CASCADE
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='首页图标管理表';
+```
+
+## 实施步骤
+
+### 第一阶段：后端实现
+1. 创建实体类 `HomeIcon`
+2. 注册实体到数据源
+3. 创建服务类 `HomeIconService`
+4. 创建API路由
+
+### 第二阶段：前端实现
+1. 创建管理页面 `HomeIconsPage`
+2. 集成文件上传组件
+3. 添加表格展示和操作功能
+4. 添加菜单项和路由
+
+### 第三阶段：测试验证
+1. 测试文件上传功能
+2. 测试CRUD操作
+3. 测试文件关联
+4. 测试排序和状态切换
+
+## API接口文档
+
+### 获取轮播图
+```
+GET /api/v1/home-icons?type=banner&isEnabled=1
+```
+
+### 获取分类图标
+```
+GET /api/v1/home-icons?type=category&isEnabled=1
+
+### 创建图标
+```
+POST /api/v1/home-icons
+{
+  "title": "首页轮播图1",
+  "type": "banner",
+  "fileId": 123,
+  "sortOrder": 1,
+  "isEnabled": 1,
+  "linkUrl": "https://example.com",
+  "description": "首页主banner"
+}
+```
+
+## 安全考虑
+- 使用认证中间件保护API
+- 验证文件ID存在性
+- 限制文件类型为图片
+- 设置合理的文件大小限制
+- 添加操作日志记录
+
+## 性能优化
+- 为常用查询字段添加索引
+- 实现分页查询
+- 使用CDN加速图片访问
+- 添加缓存机制
+
+## 错误处理
+- 文件不存在错误
+- 上传失败处理
+- 数据库操作异常
+- 权限验证失败

src/client/admin/menu.tsx

@@ -11,6 +11,7 @@ import {
   UsergroupAddOutlined,
   CarryOutOutlined,
   AuditOutlined,
+  PictureOutlined,
 } from '@ant-design/icons';
 
 export interface MenuItem {
@@ -117,6 +118,13 @@ export const useMenu = () => {
       path: '/admin/company-certification',
       permission: 'company:certify'
     },
+    {
+      key: 'home-icons',
+      label: '图标发布',
+      icon: <PictureOutlined />,
+      path: '/admin/home-icons',
+      permission: 'home-icon:manage'
+    },
   ];
 
   // 用户菜单项

src/client/admin/pages/HomeIcons.tsx

@@ -0,0 +1,378 @@
+import React, { useState, useEffect } from 'react';
+import { Table, Card, Tabs, Button, Space, Tag, Switch, Popconfirm, message, Modal, Form, Input, Select, Upload } from 'antd';
+import { PlusOutlined, EditOutlined, DeleteOutlined, EyeOutlined, LinkOutlined } from '@ant-design/icons';
+import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query';
+import { homeIconClient } from '@/client/api';
+import type { HomeIcon } from '@/server/modules/home/home-icon.entity';
+import type { File } from '@/server/modules/files/file.entity';
+import type { InferResponseType, InferRequestType } from 'hono/client';
+import MinioUploader from '@/client/admin/components/MinioUploader';
+
+const { TabPane } = Tabs;
+const { TextArea } = Input;
+
+type HomeIconResponse = InferResponseType<typeof homeIconClient.$get, 200>;
+type CreateHomeIconRequest = InferRequestType<typeof homeIconClient.$post>['json'];
+type UpdateHomeIconRequest = InferRequestType<typeof homeIconClient[":id"]["$put"]>['json'];
+
+const HomeIconsPage: React.FC = () => {
+  const [activeTab, setActiveTab] = useState<'banner' | 'category'>('banner');
+  const [modalOpen, setModalOpen] = useState(false);
+  const [editingRecord, setEditingRecord] = useState<HomeIcon | null>(null);
+  const [form] = Form.useForm();
+  const queryClient = useQueryClient();
+  const client = useClient();
+
+  // 获取图标列表
+  const { data: iconsData, isLoading } = useQuery({
+    queryKey: ['home-icons', activeTab],
+    queryFn: async () => {
+      const response = await client.homeIcons.$get({
+        query: {
+          type: activeTab,
+          page: 1,
+          pageSize: 100
+        }
+      });
+      if (response.status !== 200) throw new Error('获取图标失败');
+      return response.json();
+    }
+  });
+
+  // 创建图标
+  const createMutation = useMutation({
+    mutationFn: async (data: CreateHomeIconRequest) => {
+      const response = await client.homeIcons.$post({ json: data });
+      if (response.status !== 200) throw new Error('创建图标失败');
+      return response.json();
+    },
+    onSuccess: () => {
+      message.success('创建成功');
+      queryClient.invalidateQueries({ queryKey: ['home-icons'] });
+      setModalOpen(false);
+      form.resetFields();
+    },
+    onError: (error) => {
+      message.error(error.message || '创建失败');
+    }
+  });
+
+  // 更新图标
+  const updateMutation = useMutation({
+    mutationFn: async ({ id, data }: { id: number; data: UpdateHomeIconRequest }) => {
+      const response = await client.homeIcons[":id"].$put({
+        param: { id: id.toString() },
+        json: data
+      });
+      if (response.status !== 200) throw new Error('更新图标失败');
+      return response.json();
+    },
+    onSuccess: () => {
+      message.success('更新成功');
+      queryClient.invalidateQueries({ queryKey: ['home-icons'] });
+      setModalOpen(false);
+      form.resetFields();
+    },
+    onError: (error) => {
+      message.error(error.message || '更新失败');
+    }
+  });
+
+  // 删除图标
+  const deleteMutation = useMutation({
+    mutationFn: async (id: number) => {
+      const response = await client.homeIcons[":id"].$delete({
+        param: { id: id.toString() }
+      });
+      if (response.status !== 200) throw new Error('删除图标失败');
+      return response.json();
+    },
+    onSuccess: () => {
+      message.success('删除成功');
+      queryClient.invalidateQueries({ queryKey: ['home-icons'] });
+    },
+    onError: (error) => {
+      message.error(error.message || '删除失败');
+    }
+  });
+
+  // 切换启用状态
+  const toggleEnabledMutation = useMutation({
+    mutationFn: async ({ id, isEnabled }: { id: number; isEnabled: number }) => {
+      const response = await client.homeIcons[":id"].$put({
+        param: { id: id.toString() },
+        json: { isEnabled }
+      });
+      if (response.status !== 200) throw new Error('更新状态失败');
+      return response.json();
+    },
+    onSuccess: () => {
+      message.success('状态更新成功');
+      queryClient.invalidateQueries({ queryKey: ['home-icons'] });
+    },
+    onError: (error) => {
+      message.error(error.message || '状态更新失败');
+    }
+  });
+
+  const handleAdd = () => {
+    setEditingRecord(null);
+    form.setFieldsValue({
+      type: activeTab,
+      sortOrder: 0,
+      isEnabled: 1
+    });
+    setModalOpen(true);
+  };
+
+  const handleEdit = (record: HomeIcon) => {
+    setEditingRecord(record);
+    form.setFieldsValue({
+      ...record,
+      fileId: record.fileId
+    });
+    setModalOpen(true);
+  };
+
+  const handleDelete = (id: number) => {
+    deleteMutation.mutate(id);
+  };
+
+  const handleToggleEnabled = (record: HomeIcon) => {
+    toggleEnabledMutation.mutate({
+      id: record.id,
+      isEnabled: record.isEnabled === 1 ? 0 : 1
+    });
+  };
+
+  const handleSubmit = async (values: any) => {
+    const data = {
+      ...values,
+      fileId: values.fileId
+    };
+
+    if (editingRecord) {
+      updateMutation.mutate({ id: editingRecord.id, data });
+    } else {
+      createMutation.mutate(data);
+    }
+  };
+
+  const handleUploadSuccess = (fileKey: string, fileUrl: string, file: File) => {
+    // 这里需要获取刚上传的文件ID
+    // 实际项目中，上传成功后应该返回文件ID
+    message.success('文件上传成功，请填写其他信息后提交');
+  };
+
+  const columns = [
+    {
+      title: '预览',
+      dataIndex: 'file',
+      key: 'file',
+      width: 80,
+      render: (file: File) => (
+        <img 
+          src={file.path} 
+          alt={file.name} 
+          style={{ width: 60, height: 60, objectFit: 'cover', borderRadius: 4 }}
+        />
+      )
+    },
+    {
+      title: '标题',
+      dataIndex: 'title',
+      key: 'title',
+      width: 200,
+      ellipsis: true
+    },
+    {
+      title: '描述',
+      dataIndex: 'description',
+      key: 'description',
+      width: 200,
+      ellipsis: true,
+      render: (text: string) => text || '-'
+    },
+    {
+      title: '链接地址',
+      dataIndex: 'linkUrl',
+      key: 'linkUrl',
+      width: 150,
+      ellipsis: true,
+      render: (text: string) => text ? <a href={text} target="_blank" rel="noopener noreferrer"><LinkOutlined /></a> : '-'
+    },
+    {
+      title: '排序',
+      dataIndex: 'sortOrder',
+      key: 'sortOrder',
+      width: 80,
+      align: 'center' as const
+    },
+    {
+      title: '状态',
+      dataIndex: 'isEnabled',
+      key: 'isEnabled',
+      width: 100,
+      render: (isEnabled: number) => (
+        <Tag color={isEnabled === 1 ? 'green' : 'red'}>
+          {isEnabled === 1 ? '启用' : '禁用'}
+        </Tag>
+      )
+    },
+    {
+      title: '创建时间',
+      dataIndex: 'createdAt',
+      key: 'createdAt',
+      width: 180,
+      render: (date: string) => new Date(date).toLocaleString()
+    },
+    {
+      title: '操作',
+      key: 'actions',
+      width: 150,
+      fixed: 'right' as const,
+      render: (_, record: HomeIcon) => (
+        <Space>
+          <Button 
+            type="text" 
+            icon={<EditOutlined />} 
+            onClick={() => handleEdit(record)}
+          />
+          <Popconfirm
+            title="确定要删除吗？"
+            onConfirm={() => handleDelete(record.id)}
+            okText="确定"
+            cancelText="取消"
+          >
+            <Button type="text" danger icon={<DeleteOutlined />} />
+          </Popconfirm>
+          <Switch
+            checked={record.isEnabled === 1}
+            onChange={() => handleToggleEnabled(record)}
+            size="small"
+          />
+        </Space>
+      )
+    }
+  ];
+
+  const dataSource = iconsData?.data || [];
+
+  return (
+    <div style={{ padding: 24 }}>
+      <div style={{ marginBottom: 16, display: 'flex', justifyContent: 'space-between', alignItems: 'center' }}>
+        <h2>图标发布管理</h2>
+        <Button type="primary" icon={<PlusOutlined />} onClick={handleAdd}>
+          添加{activeTab === 'banner' ? '轮播图' : '分类图标'}
+        </Button>
+      </div>
+      <Card>
+        <Tabs activeKey={activeTab} onChange={(key) => setActiveTab(key as 'banner' | 'category')}>
+          <Tabs.TabPane tab="轮播图管理" key="banner">
+            <Table
+              columns={columns}
+              dataSource={dataSource}
+              rowKey="id"
+              loading={isLoading}
+              pagination={false}
+              scroll={{ x: 1000 }}
+            />
+          </Tabs.TabPane>
+          <Tabs.TabPane tab="分类图标管理" key="category">
+            <Table
+              columns={columns}
+              dataSource={dataSource}
+              rowKey="id"
+              loading={isLoading}
+              pagination={false}
+              scroll={{ x: 1000 }}
+            />
+          </Tabs.TabPane>
+        </Tabs>
+      </Card>
+
+      <Modal
+        title={editingRecord ? '编辑图标' : '添加图标'}
+        open={modalOpen}
+        onCancel={() => {
+          setModalOpen(false);
+          form.resetFields();
+        }}
+        onOk={() => form.submit()}
+        width={600}
+      >
+        <Form
+          form={form}
+          layout="vertical"
+          onFinish={handleSubmit}
+        >
+          <Form.Item
+            name="title"
+            label="标题"
+            rules={[{ required: true, message: '请输入标题' }]}
+          >
+            <Input placeholder="请输入图标标题" />
+          </Form.Item>
+
+          <Form.Item
+            name="type"
+            label="类型"
+            hidden
+          >
+            <Input />
+          </Form.Item>
+
+          <Form.Item
+            name="fileId"
+            label="图标文件"
+            rules={[{ required: true, message: '请上传图标文件' }]}
+          >
+            <Input type="number" placeholder="请输入文件ID" />
+          </Form.Item>
+
+          <Form.Item
+            name="linkUrl"
+            label="链接地址"
+          >
+            <Input placeholder="请输入点击跳转链接（可选）" />
+          </Form.Item>
+
+          <Form.Item
+            name="description"
+            label="描述"
+          >
+            <TextArea rows={3} placeholder="请输入描述信息（可选）" />
+          </Form.Item>
+
+          <Form.Item
+            name="sortOrder"
+            label="排序顺序"
+            rules={[{ required: true, message: '请输入排序顺序' }]}
+          >
+            <Input type="number" placeholder="数字越小越靠前" />
+          </Form.Item>
+
+          <Form.Item
+            name="isEnabled"
+            label="启用状态"
+            valuePropName="checked"
+          >
+            <Switch checkedChildren="启用" unCheckedChildren="禁用" />
+          </Form.Item>
+
+          <Form.Item label="文件上传">
+            <MinioUploader
+              uploadPath={`/home-icons/${activeTab}`}
+              accept="image/*"
+              maxSize={5}
+              onUploadSuccess={handleUploadSuccess}
+              buttonText={`上传${activeTab === 'banner' ? '轮播图' : '分类图标'}`}
+            />
+          </Form.Item>
+        </Form>
+      </Modal>
+    </div>
+  );
+};
+
+export default HomeIconsPage;

src/client/admin/routes.tsx

@@ -11,6 +11,7 @@ import { FilesPage } from './pages/Files';
 import { SilverTalentsPage } from './pages/SilverTalents';
 import { SilverJobsPage } from './pages/SilverJobs';
 import CompanyCertificationPage from './pages/CompanyCertification';
+import HomeIconsPage from './pages/HomeIcons';
 
 export const router = createBrowserRouter([
   {
@@ -63,6 +64,11 @@ export const router = createBrowserRouter([
         element: <CompanyCertificationPage />,
         errorElement: <ErrorPage />
       },
+      {
+        path: 'home-icons',
+        element: <HomeIconsPage />,
+        errorElement: <ErrorPage />
+      },
       {
         path: '*',
         element: <NotFoundPage />,

src/client/api.ts

@@ -25,7 +25,8 @@ import type {
   MyCompanyRoutes,
   SilverJobRoutes,
   CompanyCertificationRoutes,
-  SilverCompaniesRoutes
+  SilverCompaniesRoutes,
+  HomeIconRoutes
 } from '@/server/api';
 import { axiosFetch } from './utils/axios'
 
@@ -148,4 +149,9 @@ export const silverCompaniesClient = hc<SilverCompaniesRoutes>('/', {
 // 银龄岗管理客户端
 export const silverJobClient = hc<SilverJobRoutes>('/', {
   fetch: axiosFetch,
-}).api.v1['silver-jobs']
+}).api.v1['silver-jobs']
+
+// 首页图标管理客户端
+export const homeIconClient = hc<HomeIconRoutes>('/', {
+  fetch: axiosFetch,
+}).api.v1['home-icons']

src/server/api.ts

@@ -24,6 +24,7 @@ import { AuthContext } from './types/context'
 import { AppDataSource } from './data-source'
 import silverJobRoutes from './api/silver-jobs/index'
 import companyCertificationRoutes from './api/company-certification/index'
+import homeIconRoutes from './api/home-icons/index'
 
 const api = new OpenAPIHono<AuthContext>()
 
@@ -107,6 +108,9 @@ const silverCompaniesApiRoutes = api.route('/api/v1/silver-companies', silverCom
 // 注册银龄岗管理后台路由
 const silverJobApiRoutes = api.route('/api/v1/silver-jobs', silverJobRoutes)
 
+// 注册首页图标管理路由
+const homeIconApiRoutes = api.route('/api/v1/home-icons', homeIconRoutes)
+
 export type AuthRoutes = typeof authRoutes
 export type CompanyCertificationRoutes = typeof companyCertificationApiRoutes
 export type UserRoutes = typeof userRoutes
@@ -134,5 +138,6 @@ export type SilverUserProfileRoutes = typeof silverUserProfileApiRoutes
 export type SilverTalentsAdminRoutes = typeof silverTalentsAdminApiRoutes
 export type SilverJobRoutes = typeof silverJobApiRoutes
 export type SilverCompaniesRoutes = typeof silverCompaniesApiRoutes
+export type HomeIconRoutes = typeof homeIconApiRoutes
 
 export default api

src/server/api/home-icons/index.ts

@@ -0,0 +1,21 @@
+import { createCrudRoutes } from '@/server/utils/generic-crud.routes';
+import { HomeIcon } from '@/server/modules/home/home-icon.entity';
+import { HomeIconSchema, CreateHomeIconDto, UpdateHomeIconDto } from '@/server/modules/home/home-icon.entity';
+import { authMiddleware } from '@/server/middleware/auth.middleware';
+
+const homeIconRoutes = createCrudRoutes({
+  entity: HomeIcon,
+  createSchema: CreateHomeIconDto,
+  updateSchema: UpdateHomeIconDto,
+  getSchema: HomeIconSchema,
+  listSchema: HomeIconSchema,
+  searchFields: ['title', 'description'],
+  relations: ['file', 'file.uploadUser'],
+  middleware: [authMiddleware],
+  userTracking: {
+    createdByField: 'createdBy',
+    updatedByField: 'updatedBy'
+  }
+});
+
+export default homeIconRoutes;

src/server/data-source.ts

@@ -29,6 +29,7 @@ import { ElderlyUniversity } from "./modules/silver-users/elderly-university.ent
 import { PolicyNews } from "./modules/silver-users/policy-news.entity"
 import { UserPreference } from "./modules/silver-users/user-preference.entity"
 import { SilverJob } from "./modules/silver-jobs/silver-job.entity"
+import { HomeIcon } from "./modules/home/home-icon.entity"
 
 export const AppDataSource = new DataSource({
   type: "mysql",
@@ -43,7 +44,7 @@ export const AppDataSource = new DataSource({
     TimeBankIntro, TimeBankCase, TimeBankStats,
     SilverKnowledge, SilverKnowledgeCategory, SilverKnowledgeTag,
     SilverKnowledgeTagRelation, SilverKnowledgeStats, SilverKnowledgeInteraction,
-    ElderlyUniversity, PolicyNews, UserPreference, SilverJob,
+    ElderlyUniversity, PolicyNews, UserPreference, SilverJob, HomeIcon,
   ],
   migrations: [],
   synchronize: process.env.DB_SYNCHRONIZE !== "false",

src/server/migrations/CreateHomeIconsTable.sql

@@ -0,0 +1,28 @@
+-- 创建首页图标管理表
+CREATE TABLE IF NOT EXISTS `home_icons` (
+  `id` int(11) unsigned NOT NULL AUTO_INCREMENT,
+  `title` varchar(255) NOT NULL DEFAULT '' COMMENT '图标标题',
+  `type` varchar(20) NOT NULL DEFAULT '' COMMENT '图标类型: banner-轮播图, category-分类图标',
+  `file_id` int(11) unsigned NOT NULL COMMENT '关联文件ID',
+  `sort_order` int(11) NOT NULL DEFAULT '0' COMMENT '排序顺序',
+  `is_enabled` tinyint(1) NOT NULL DEFAULT '1' COMMENT '是否启用: 0-禁用, 1-启用',
+  `link_url` varchar(512) DEFAULT NULL COMMENT '链接地址',
+  `description` text COMMENT '描述信息',
+  `created_by` int(11) unsigned DEFAULT NULL COMMENT '创建人ID',
+  `updated_by` int(11) unsigned DEFAULT NULL COMMENT '更新人ID',
+  `created_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  `updated_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+  PRIMARY KEY (`id`),
+  KEY `idx_type_enabled` (`type`, `is_enabled`),
+  KEY `idx_sort_order` (`sort_order`),
+  KEY `idx_file_id` (`file_id`),
+  KEY `idx_created_by` (`created_by`),
+  KEY `idx_updated_by` (`updated_by`),
+  CONSTRAINT `fk_home_icon_file` FOREIGN KEY (`file_id`) REFERENCES `file` (`id`) ON DELETE RESTRICT ON UPDATE CASCADE,
+  CONSTRAINT `fk_home_icon_created_by` FOREIGN KEY (`created_by`) REFERENCES `user` (`id`) ON DELETE SET NULL ON UPDATE CASCADE,
+  CONSTRAINT `fk_home_icon_updated_by` FOREIGN KEY (`updated_by`) REFERENCES `user` (`id`) ON DELETE SET NULL ON UPDATE CASCADE
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='首页图标管理表';
+
+-- 添加权限配置
+INSERT INTO `role_permissions` (`role_id`, `permission`, `created_at`, `updated_at`) VALUES
+(1, 'home-icon:manage', NOW(), NOW());  -- 管理员权限

src/server/modules/home/home-icon.entity.ts

@@ -0,0 +1,146 @@
+import { Entity, PrimaryGeneratedColumn, Column, ManyToOne, JoinColumn, CreateDateColumn, UpdateDateColumn } from 'typeorm';
+import { z } from '@hono/zod-openapi';
+import { File, FileSchema } from '@/server/modules/files/file.entity';
+
+@Entity('home_icons')
+export class HomeIcon {
+  @PrimaryGeneratedColumn({ name: 'id', type: 'int', unsigned: true })
+  id!: number;
+
+  @Column({ name: 'title', type: 'varchar', length: 255, comment: '图标标题' })
+  title!: string;
+
+  @Column({ name: 'type', type: 'varchar', length: 20, comment: '图标类型: banner, category' })
+  type!: string;
+
+  @Column({ name: 'file_id', type: 'int', unsigned: true, comment: '关联文件ID' })
+  fileId!: number;
+
+  @ManyToOne(() => File)
+  @JoinColumn({ name: 'file_id', referencedColumnName: 'id' })
+  file!: File;
+
+  @Column({ name: 'sort_order', type: 'int', default: 0, comment: '排序顺序' })
+  sortOrder!: number;
+
+  @Column({ name: 'is_enabled', type: 'tinyint', default: 1, comment: '是否启用: 0-禁用, 1-启用' })
+  isEnabled!: number;
+
+  @Column({ name: 'link_url', type: 'varchar', length: 512, nullable: true, comment: '链接地址' })
+  linkUrl!: string | null;
+
+  @Column({ name: 'description', type: 'text', nullable: true, comment: '描述信息' })
+  description!: string | null;
+
+  @CreateDateColumn({ name: 'created_at', type: 'timestamp', default: () => 'CURRENT_TIMESTAMP' })
+  createdAt!: Date;
+
+  @UpdateDateColumn({ name: 'updated_at', type: 'timestamp', default: () => 'CURRENT_TIMESTAMP', onUpdate: 'CURRENT_TIMESTAMP' })
+  updatedAt!: Date;
+}
+
+export const HomeIconSchema = z.object({
+  id: z.number().int().positive().openapi({
+    description: '图标ID',
+    example: 1
+  }),
+  title: z.string().max(255).openapi({
+    description: '图标标题',
+    example: '首页轮播图1'
+  }),
+  type: z.string().max(20).openapi({
+    description: '图标类型: banner-轮播图, category-分类图标',
+    example: 'banner'
+  }),
+  fileId: z.number().int().positive().openapi({
+    description: '关联文件ID',
+    example: 123
+  }),
+  file: FileSchema,
+  sortOrder: z.number().int().default(0).openapi({
+    description: '排序顺序',
+    example: 1
+  }),
+  isEnabled: z.coerce.number().int().min(0).max(1).default(1).openapi({
+    description: '是否启用: 0-禁用, 1-启用',
+    example: 1
+  }),
+  linkUrl: z.string().max(512).nullable().optional().openapi({
+    description: '链接地址',
+    example: 'https://example.com/page'
+  }),
+  description: z.string().nullable().optional().openapi({
+    description: '描述信息',
+    example: '首页主banner图'
+  }),
+  createdAt: z.date().openapi({
+    description: '创建时间',
+    example: '2023-01-15T10:30:00Z'
+  }),
+  updatedAt: z.date().openapi({
+    description: '更新时间',
+    example: '2023-01-15T10:30:00Z'
+  })
+});
+
+export const CreateHomeIconDto = z.object({
+  title: z.string().max(255).openapi({
+    description: '图标标题',
+    example: '首页轮播图1'
+  }),
+  type: z.string().max(20).openapi({
+    description: '图标类型: banner-轮播图, category-分类图标',
+    example: 'banner'
+  }),
+  fileId: z.coerce.number().int().positive().openapi({
+    description: '关联文件ID',
+    example: 123
+  }),
+  sortOrder: z.coerce.number().int().default(0).openapi({
+    description: '排序顺序',
+    example: 1
+  }),
+  isEnabled: z.coerce.number().int().min(0).max(1).default(1).openapi({
+    description: '是否启用: 0-禁用, 1-启用',
+    example: 1
+  }),
+  linkUrl: z.string().max(512).nullable().optional().openapi({
+    description: '链接地址',
+    example: 'https://example.com/page'
+  }),
+  description: z.string().nullable().optional().openapi({
+    description: '描述信息',
+    example: '首页主banner图'
+  })
+});
+
+export const UpdateHomeIconDto = z.object({
+  title: z.string().max(255).optional().openapi({
+    description: '图标标题',
+    example: '首页轮播图1'
+  }),
+  type: z.string().max(20).optional().openapi({
+    description: '图标类型: banner-轮播图, category-分类图标',
+    example: 'banner'
+  }),
+  fileId: z.coerce.number().int().positive().optional().openapi({
+    description: '关联文件ID',
+    example: 123
+  }),
+  sortOrder: z.coerce.number().int().optional().openapi({
+    description: '排序顺序',
+    example: 1
+  }),
+  isEnabled: z.coerce.number().int().min(0).max(1).optional().openapi({
+    description: '是否启用: 0-禁用, 1-启用',
+    example: 1
+  }),
+  linkUrl: z.string().max(512).nullable().optional().openapi({
+    description: '链接地址',
+    example: 'https://example.com/page'
+  }),
+  description: z.string().nullable().optional().openapi({
+    description: '描述信息',
+    example: '首页主banner图'
+  })
+});

src/server/modules/home/home-icon.service.ts

@@ -0,0 +1,84 @@
+import { DataSource } from 'typeorm';
+import { GenericCrudService } from '@/server/utils/generic-crud.service';
+import { HomeIcon } from './home-icon.entity';
+
+export class HomeIconService extends GenericCrudService<HomeIcon> {
+  constructor(dataSource: DataSource) {
+    super(dataSource, HomeIcon);
+  }
+
+  /**
+   * 获取启用的轮播图列表
+   */
+  async getBanners(): Promise<HomeIcon[]> {
+    const [banners] = await this.getList(
+      1,
+      100,
+      undefined,
+      undefined,
+      { type: 'banner', isEnabled: 1 },
+      ['file'],
+      { sortOrder: 'ASC', createdAt: 'DESC' }
+    );
+    return banners;
+  }
+
+  /**
+   * 获取启用的分类图标列表
+   */
+  async getCategoryIcons(): Promise<HomeIcon[]> {
+    const [icons] = await this.getList(
+      1,
+      100,
+      undefined,
+      undefined,
+      { type: 'category', isEnabled: 1 },
+      ['file'],
+      { sortOrder: 'ASC', createdAt: 'DESC' }
+    );
+    return icons;
+  }
+
+  /**
+   * 获取所有图标（管理员用）
+   */
+  async getAllIcons(type?: string, enabledOnly: boolean = false): Promise<HomeIcon[]> {
+    const where: any = {};
+    
+    if (type) {
+      where.type = type;
+    }
+    
+    if (enabledOnly) {
+      where.isEnabled = 1;
+    }
+
+    const [icons] = await this.getList(
+      1,
+      1000,
+      undefined,
+      undefined,
+      where,
+      ['file'],
+      { sortOrder: 'ASC', createdAt: 'DESC' }
+    );
+    return icons;
+  }
+
+  /**
+   * 更新排序顺序
+   */
+  async updateSortOrder(id: number, sortOrder: number): Promise<HomeIcon | null> {
+    return await this.update(id, { sortOrder });
+  }
+
+  /**
+   * 切换启用状态
+   */
+  async toggleEnabled(id: number): Promise<HomeIcon | null> {
+    const icon = await this.getById(id);
+    if (!icon) return null;
+    
+    return await this.update(id, { isEnabled: icon.isEnabled === 1 ? 0 : 1 });
+  }
+}