feat: add superadmin creator review and coupon governance

backend/app/http/super/v1/dto/super_coupon.go

@@ -79,3 +79,66 @@ type SuperCouponGrantResponse struct {
 	// Granted 实际发放数量。
 	Granted int `json:"granted"`
 }
+
+// SuperCouponStatusUpdateForm 超管优惠券状态更新表单。
+type SuperCouponStatusUpdateForm struct {
+	// Status 目标状态（frozen）。
+	Status string `json:"status" validate:"required,oneof=frozen"`
+}
+
+// SuperCouponGrantListFilter 超管优惠券发放记录过滤条件。
+type SuperCouponGrantListFilter struct {
+	requests.Pagination
+	// CouponID 优惠券ID过滤（精确匹配）。
+	CouponID *int64 `query:"coupon_id"`
+	// TenantID 租户ID过滤（精确匹配）。
+	TenantID *int64 `query:"tenant_id"`
+	// TenantCode 租户编码过滤（模糊匹配）。
+	TenantCode *string `query:"tenant_code"`
+	// TenantName 租户名称过滤（模糊匹配）。
+	TenantName *string `query:"tenant_name"`
+	// UserID 用户ID过滤（精确匹配）。
+	UserID *int64 `query:"user_id"`
+	// Username 用户名过滤（模糊匹配）。
+	Username *string `query:"username"`
+	// Status 用户券状态过滤（unused/used/expired）。
+	Status *consts.UserCouponStatus `query:"status"`
+	// CreatedAtFrom 领取时间起始（RFC3339）。
+	CreatedAtFrom *string `query:"created_at_from"`
+	// CreatedAtTo 领取时间结束（RFC3339）。
+	CreatedAtTo *string `query:"created_at_to"`
+	// UsedAtFrom 使用时间起始（RFC3339）。
+	UsedAtFrom *string `query:"used_at_from"`
+	// UsedAtTo 使用时间结束（RFC3339）。
+	UsedAtTo *string `query:"used_at_to"`
+}
+
+// SuperCouponGrantItem 超管优惠券发放记录项。
+type SuperCouponGrantItem struct {
+	// ID 用户券ID。
+	ID int64 `json:"id"`
+	// CouponID 优惠券ID。
+	CouponID int64 `json:"coupon_id"`
+	// CouponTitle 优惠券标题。
+	CouponTitle string `json:"coupon_title"`
+	// TenantID 租户ID。
+	TenantID int64 `json:"tenant_id"`
+	// TenantCode 租户编码。
+	TenantCode string `json:"tenant_code"`
+	// TenantName 租户名称。
+	TenantName string `json:"tenant_name"`
+	// UserID 用户ID。
+	UserID int64 `json:"user_id"`
+	// Username 用户名。
+	Username string `json:"username"`
+	// Status 用户券状态。
+	Status consts.UserCouponStatus `json:"status"`
+	// StatusDescription 状态描述（用于展示）。
+	StatusDescription string `json:"status_description"`
+	// OrderID 使用订单ID。
+	OrderID int64 `json:"order_id"`
+	// UsedAt 使用时间（RFC3339）。
+	UsedAt string `json:"used_at"`
+	// CreatedAt 领取时间（RFC3339）。
+	CreatedAt string `json:"created_at"`
+}