mpay_v2_webman/doc/backend/files.md

文件资产

文件资产由后端记录元数据，实际文件交给本地、远程 URL、OSS 或 COS 驱动处理。

当前入口

• API 前缀：/adminapi/file-asset
• 控制器：FileRecordController
• 模型：FileRecord
• 数据表：ma_file_asset

接口

方法	路径	作用
GET	/file-asset/options	文件选项
GET	/file-asset	文件列表
POST	/file-asset/upload	上传文件
POST	/file-asset/import-remote	导入远程文件
GET	/file-asset/{id}/preview	文件预览
GET	/file-asset/{id}/download	文件下载
GET	/file-asset/{id}	文件详情
DELETE	/file-asset/{id}	删除文件

服务与驱动

• FileRecordService
• FileRecordQueryService
• FileRecordCommandService
• StorageConfigService
• StorageManager
• LocalStorageDriver
• RemoteUrlStorageDriver
• OssStorageDriver
• CosStorageDriver

字段口径

• object_key：站点相对路径或对象存储 key。
• url：公开文件的完整访问地址，私有文件可以为空。
• preview_url：后台预览使用，不作为长期业务访问地址。
• previewable：列表返回给前端判断是否允许在线预览。

表单上传

系统配置和插件配置中的上传字段仍使用 type: "upload"。需要走项目定制选择器时，在 props.fileUpload 中声明 selectorType、scene、isLocal、isPublic、getKey 等配置。前端说明见 管理后台前端。