# SysFileInfoController 接口文档

## 概述

SysFileInfoController 提供文件信息管理接口，包括文件列表查询、导出、新增、修改、删除等功能。用于管理系统中所有文件的元数据信息。

## 接口列表

### 查询接口

| 接口名称 | 接口路径 | 请求方法 | 说明 |
|----------|----------|----------|------|
| 查询文件列表 | /file/info/list | GET | 查询文件列表，支持分页和条件过滤 |
| 获取文件详细信息 | /file/info/{fileId} | GET | 根据文件 ID 获取文件详细信息 |

### 管理接口

| 接口名称 | 接口路径 | 请求方法 | 说明 |
|----------|----------|----------|------|
| 新增文件 | /file/info | POST | 新增文件记录 |
| 修改文件 | /file/info | PUT | 修改文件信息 |
| 删除文件 | /file/info/{fileIds} | DELETE | 删除文件记录，支持批量删除 |

### 导出接口

| 接口名称 | 接口路径 | 请求方法 | 说明 |
|----------|----------|----------|------|
| 导出文件列表 | /file/info/export | POST | 导出文件列表到 Excel |

## 数据模型

### SysFileInfo

| 字段名 | 类型 | 描述 | 必填 |
|--------|------|------|------|
| fileId | Long | 文件主键 | 否（新增时自动生成） |
| fileName | String | 原始文件名 | 是 |
| filePath | String | 统一逻辑路径（/开头） | 是 |
| storageType | String | 存储类型（local/minio/oss） | 是 |
| fileType | String | 文件类型/后缀 | 否 |
| fileSize | Long | 文件大小（字节） | 否 |
| md5 | String | 文件MD5 | 否 |
| createBy | String | 创建人 | 否（自动设置） |
| createTime | String | 创建时间 | 否（自动设置） |
| updateBy | String | 更新人 | 否（自动设置） |
| updateTime | String | 更新时间 | 否（自动设置） |
| delFlag | String | 删除标志（0代表存在 2代表删除） | 否（默认为0） |

## 权限说明

所有接口都需要认证，具体权限如下：

| 接口 | 权限 |
|------|------|
| 查询文件列表 | system:file:list |
| 导出文件列表 | system:file:export |
| 获取文件详细信息 | system:file:query |
| 新增文件 | system:file:add |
| 修改文件 | system:file:edit |
| 删除文件 | system:file:remove |

## 使用流程

### 文件信息查询流程

1. 调用 [查询文件列表](./0001-list.md) 查询文件列表
2. 使用 fileId 调用 [获取文件详细信息](./0003-get-info.md) 获取详细信息

### 文件信息管理流程

1. 调用 [新增文件](./0004-add.md) 创建文件记录
2. 调用 [修改文件](./0005-edit.md) 更新文件信息
3. 调用 [删除文件](./0006-remove.md) 删除文件记录

### 文件导出流程

1. 调用 [导出文件列表](./0002-export.md) 导出文件列表到 Excel
2. 浏览器会自动下载 Excel 文件

## 注意事项

1. 所有接口都需要认证（需要携带 Authorization 头）
2. 文件路径必须以 / 开头
3. 存储类型必须是有效的值：local、minio、oss
4. 删除操作是逻辑删除，将 delFlag 设置为 2
5. 只能查询和操作删除标志为 0 的文件（未删除的文件）
6. 支持批量删除，多个 fileId 用逗号分隔

## 相关文档

- [FileController 接口文档](../FileController/index.md) - 文件存储服务接口