20260802220544

code/fms/.codebuddy/plans/file-api-implementation_11cb90d6.md

@@ -0,0 +1,27 @@
+---
+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
+---
+