feat: 添加环境变量管理工具和部署配置改版

主要改动：
- 新增交互式环境配置脚本 (scripts/setup-env.sh)
- 新增本地启动快捷脚本 (scripts/run-local.sh)
- 新增环境变量模板文件 (.env.example)
- 部署模式改版：使用嵌入式配置 + 环境变量覆盖
- 添加对象存储功能支持
- 改进 IoT 卡片导入任务
- 优化 OpenAPI 文档生成
- 删除旧的配置文件，改用嵌入式默认配置

internal/routes/registry.go

@@ -8,13 +8,22 @@ import (
 	"github.com/break/junhong_cmp_fiber/pkg/openapi"
 )
 
+// FileUploadField 定义文件上传字段
+type FileUploadField struct {
+	Name        string // 字段名
+	Description string // 字段描述
+	Required    bool   // 是否必填
+}
+
 // RouteSpec 定义接口文档元数据
 type RouteSpec struct {
-	Summary string
-	Input   interface{} // 请求参数结构体 (Query/Path/Body)
-	Output  interface{} // 响应参数结构体
-	Tags    []string
-	Auth    bool // 是否需要认证图标 (预留)
+	Summary     string            // 简短摘要（中文，一行）
+	Description string            // 详细说明，支持 Markdown 语法（可选）
+	Input       interface{}       // 请求参数结构体 (Query/Path/Body)
+	Output      interface{}       // 响应参数结构体
+	Tags        []string          // 分类标签
+	Auth        bool              // 是否需要认证图标 (预留)
+	FileUploads []FileUploadField // 文件上传字段列表（设置此字段时请求类型为 multipart/form-data）
 }
 
 // pathParamRegex 用于匹配 Fiber 的路径参数格式 /:param
@@ -33,6 +42,19 @@ func Register(router fiber.Router, doc *openapi.Generator, basePath, method, pat
 	if doc != nil {
 		fullPath := basePath + path
 		openapiPath := pathParamRegex.ReplaceAllString(fullPath, "/{$1}")
-		doc.AddOperation(method, openapiPath, spec.Summary, spec.Input, spec.Output, spec.Auth, spec.Tags...)
+
+		if len(spec.FileUploads) > 0 {
+			fileFields := make([]openapi.FileUploadField, len(spec.FileUploads))
+			for i, f := range spec.FileUploads {
+				fileFields[i] = openapi.FileUploadField{
+					Name:        f.Name,
+					Description: f.Description,
+					Required:    f.Required,
+				}
+			}
+			doc.AddMultipartOperation(method, openapiPath, spec.Summary, spec.Description, spec.Input, spec.Output, spec.Auth, fileFields, spec.Tags...)
+		} else {
+			doc.AddOperation(method, openapiPath, spec.Summary, spec.Description, spec.Input, spec.Output, spec.Auth, spec.Tags...)
+		}
 	}
 }