文件管理

功能概述

文件管理模块用于管理系统中的文件资源，支持文件上传、分组管理、图片预览、WebP 格式转换和压缩。上传的图片会自动检测有效性、压缩尺寸并转换为 WebP 格式以节省存储空间。多租户模式下，文件按租户编码分目录存储，实现租户间的文件隔离。

使用方法

进入文件管理页面

在系统导航栏中找到 "系统管理" → "文件管理" 进入。

上传文件

1. 点击 "上传" 按钮或拖拽文件到 CardUpload 区域。
2. 可选择文件分组（默认为按日期自动归档）。
3. 系统自动验证文件类型（在配置中设置允许/禁止的扩展名）和大小（默认 10MB）。
4. 上传成功后，文件信息自动添加到列表中。

查看和管理文件

• 列表展示：文件列表显示文件名、大小、类型、上传时间等信息。
• 图片预览：鼠标悬停或点击可预览图片。
• 分组筛选：左侧分组树点击后过滤对应分组的文件。
• 删除：勾选文件后点击 "删除" 按钮。

文件分组

• 系统按日期自动分组（配置 FileSettings:DateTimeDirectory，默认 yyyy/MM/dd）。
• 也可在上传时手动选择分组。
• 左侧树形分组导航可快速切换文件视图。

图片处理

上传的图片会自动经过以下处理：

1. 格式验证（通过 ImageSharp 检测是否为有效图片）
2. 尺寸压缩（超过配置的最大宽度时自动缩放）
3. 格式转换（自动转为 WebP 格式，保留原始文件可选）

多租户文件隔离

多租户启用时，文件存储路径自动加上租户 code 前缀：wwwroot/uploads/{tenantCode}/yyyy/MM/dd/，确保不同租户的文件物理隔离。

界面说明

左侧分组树

• 显示所有文件分组目录
• 点击切换文件列表过滤

上传区域

• CardUpload 卡片上传组件
• 支持拖拽上传和点击选择
• 自动显示上传进度

文件列表

• 文件名：原始文件名称（含图标标识文件类型）
• 大小：格式化后的文件大小
• 目录：存储路径
• 操作列：预览、删除

相关实体/服务

• SysFile — 文件实体
• FileService — 文件上传、删除、图片处理服务
• IConfiguration — 读取文件配置（允许扩展名、大小限制、WebP 质量等）