主题
文件上传与管理
INF-FILE-01 | 模块
infra| 统一收口文件上传、下载、预览与删除,业务方只存 URL 不关心存储实现。
1. 使用角色与场景
角色:终端用户、管理员
- 头像上传走本地存储
- 合同附件走 S3 并生成带时效的预签名地址
2. 接口与权限点
| 方法 | 路径 | 权限点 | 摘要 | 代码行 |
|---|---|---|---|---|
| POST | /infra/file/upload | — | 上传文件 | FileController#L46 |
| GET | /infra/file/presigned-url | — | 获取文件预签名地址(上传) | FileController#L57 |
| POST | /infra/file/create | — | 创建文件 | FileController#L69 |
| GET | /infra/file/get | infra:file:query | 获得文件 | FileController#L75 |
| DELETE | /infra/file/delete | infra:file:delete | 删除文件 | FileController#L83 |
| DELETE | /infra/file/delete-list | infra:file:delete | 批量删除文件 | FileController#L92 |
| GET | /infra/file/{configId}/get/** | — | 下载文件 | FileController#L101 |
| GET | /infra/file/page | infra:file:query | 获得文件分页 | FileController#L129 |
| POST | /infra/file/upload | — | 上传文件 | AppFileController#L35 |
| GET | /infra/file/presigned-url | — | 获取文件预签名地址(上传) | AppFileController#L47 |
| POST | /infra/file/create | — | 创建文件 | AppFileController#L59 |
3. 代码定位
| 层 | 位置 |
|---|---|
| Controller | modules/infra/src/main/java/com/pmforge/module/infra/controller/admin/file/FileController.java#L46 |
| Controller | modules/infra/src/main/java/com/pmforge/module/infra/controller/app/file/AppFileController.java#L35 |
| DO | modules/infra/src/main/java/com/pmforge/module/infra/dal/dataobject/file/FileDO.java |
4. 数据表
| 表 | DO |
|---|---|
infra_file | FileDO |
5. 机制与配置
- FileClient 抽象 + local/ftp/sftp/s3/db 五种实现 + 工厂按配置选择
- 文件元信息落库,内容按配置存储
6. 常见问题与排查
- 预签名地址过期会导致前端 403
- 大文件上传要确认 Nginx/网关的 body 限制
7. 关联
- 需求原件:02-02-文件存储
- 相关卡片:INF-FILE-02