silver-knowledge-upload-usage.md 2.0 KB

银龄智库文件上传功能使用指南

已完成的功能

1. 后端实体扩展

  • ✅ 在 SilverKnowledge 实体中添加了三个新字段:
    • coverImage: 封面图片URL
    • attachment: 附件文件URL
    • attachmentName: 附件原始文件名

2. API支持

  • ✅ 创建和更新DTO已支持新字段
  • ✅ 通用CRUD路由自动处理文件关联
  • ✅ 数据库迁移文件已创建

3. 前端组件

  • ✅ 创建了专门的文件上传组件:
    • CoverImageUploader: 封面图片上传组件
    • AttachmentUploader: 附件文件上传组件

4. 表单集成

  • ✅ 在银龄知识管理表单中添加了:
    • 封面图片上传区域
    • 文件附件上传区域
    • 图片预览和附件下载功能

5. 列表显示

  • ✅ 在知识列表中添加了:
    • 封面图片预览列
    • 附件下载链接列
    • 支持点击查看大图

使用方式

创建新知识

  1. 进入"银龄智库管理"页面
  2. 点击"新增知识"按钮
  3. 填写基本信息(标题、内容、分类等)
  4. 上传封面图片(可选)
  5. 上传文件附件(可选)
  6. 提交保存

编辑知识

  1. 在列表中找到要编辑的知识
  2. 点击"编辑"按钮
  3. 可以替换或删除封面图片
  4. 可以替换或删除附件文件
  5. 保存修改

技术细节

文件上传配置

  • 封面图片

    • 路径:/silver-knowledges/covers/
    • 限制:图片格式,最大5MB
    • 支持格式:JPG、PNG、GIF
  • 附件文件

    • 路径:/silver-knowledges/attachments/
    • 限制:最大50MB
    • 支持格式:PDF、Word、Excel、PPT、TXT、ZIP、RAR

数据库迁移

运行以下命令应用数据库变更:

pnpm typeorm migration:run

文件存储

  • 使用MinIO对象存储
  • 文件URL存储在数据库中
  • 支持文件下载和预览

注意事项

  1. 确保MinIO服务已正确配置
  2. 文件上传需要网络连接
  3. 大文件上传可能需要较长时间
  4. 删除知识时不会自动删除关联文件(可后续优化)