feat: 接口字段补 @Schema 中文说明 + 精简冗余字段 + 接入 Prometheus 监控

- 全部 VO 字段补 @Schema(description) 中文说明，在线文档字段可读
- AppEpisodeVO 精简 duration/isFree 冗余字段（保留 durationSec/locked）
- framework 引入 actuator + micrometer-registry-prometheus
- SecurityConfig 放行 /actuator/prometheus，双服务配置 management 暴露指标
- 新增 deploy/docker-compose.yml + prometheus.yml 监控部署配置

fruitshorts-module-commerce/src/main/java/com/fruitshorts/commerce/vo/CoinAdjustReqVO.java

@@ -2,6 +2,7 @@
 
 package com.fruitshorts.commerce.vo;
 
+import io.swagger.v3.oas.annotations.media.Schema;
 import jakarta.validation.constraints.NotNull;
 import lombok.Data;
 
@@ -9,15 +10,19 @@ import lombok.Data;
 @Data
 public class CoinAdjustReqVO {
 
+    @Schema(description = "用户ID")
     @NotNull(message = "缺少 userId")
     private Long userId;
 
     /** 正数补发、负数扣回 */
+    @Schema(description = "变动金额（正数补发、负数扣回）")
     @NotNull(message = "缺少变动金额")
     private Long amount;
 
+    @Schema(description = "备注")
     private String remark;
 
     /** 幂等键：同一个工单重复提交只生效一次 */
+    @Schema(description = "幂等键")
     private String idempotentKey;
 }

fruitshorts-module-commerce/src/main/java/com/fruitshorts/commerce/vo/EntitlementGrantReqVO.java

@@ -2,6 +2,7 @@
 
 package com.fruitshorts.commerce.vo;
 
+import io.swagger.v3.oas.annotations.media.Schema;
 import jakarta.validation.constraints.NotNull;
 import lombok.Data;
 
@@ -9,17 +10,22 @@ import lombok.Data;
 @Data
 public class EntitlementGrantReqVO {
 
+    @Schema(description = "用户ID")
     @NotNull(message = "缺少 userId")
     private Long userId;
 
+    @Schema(description = "短剧ID")
     @NotNull(message = "缺少 dramaId")
     private Long dramaId;
 
     /** 传 0 表示整剧权益 */
+    @Schema(description = "剧集ID（传 0 表示整剧权益）")
     private Long episodeId;
 
     /** EPISODE/DRAMA */
+    @Schema(description = "权益类型（EPISODE/DRAMA）")
     private String type = "EPISODE";
 
+    @Schema(description = "原因")
     private String reason;
 }

fruitshorts-module-commerce/src/main/java/com/fruitshorts/commerce/vo/OrderQueryReqVO.java

@@ -2,17 +2,29 @@
 
 package com.fruitshorts.commerce.vo;
 
+import io.swagger.v3.oas.annotations.media.Schema;
 import lombok.Data;
 
 /** 后台订单检索条件。 */
 @Data
 public class OrderQueryReqVO {
 
+    @Schema(description = "用户ID")
     private Long userId;
+
+    @Schema(description = "订单号")
     private String orderNo;
+
     /** CREATED/PAID/DELIVERED/REFUNDED/CLOSED */
+    @Schema(description = "状态（CREATED/PAID/DELIVERED/REFUNDED/CLOSED）")
     private String status;
+
+    @Schema(description = "平台")
     private String platform;
+
+    @Schema(description = "页码")
     private Integer pageIndex = 1;
+
+    @Schema(description = "每页数量")
     private Integer pageSize = 10;
 }