---
name: file-api-implementation
overview: 实现文件组件的前后端接口层（不含页面组件）。后端新增 FileStorageProperties 配置类、FileService 业务逻辑、FileController 控制器（5 个端点）。前端新增 fileService.js 服务层。支持 local/aliyun-oss 双模式，通过 fms.file.storage-type 切换，使用 moduleId 作为模块标识。
todos:
  - id: modify-configs
    content: 修改 application.yaml 新增 fms.file.* 配置段，修改 fms-api/.gitignore 追加 data/files/
    status: completed
  - id: create-properties
    content: 新建 FileStorageProperties.java 配置属性类（纯 getter/setter，无逻辑）
    status: completed
    dependencies:
      - modify-configs
  - id: create-file-service
    content: 新建 FileService.java，实现 localUpload / ossCredential / delete 三个核心方法
    status: completed
    dependencies:
      - create-properties
  - id: create-file-controller
    content: 新建 FileController.java，5 个端点（config/upload/upload-credential/delete/static）
    status: completed
    dependencies:
      - create-file-service
  - id: create-frontend-service
    content: 新建 fileService.js，封装上传/凭证/删除/预览逻辑，根据 storageType 自动切换链路
    status: completed
---