feat: 添加媒体资产上传初始化和完成相关API接口及数据结构

2025-12-22 17:02:53 +08:00
parent 6ab65817d8
commit 76f639b3f3
12 changed files with 959 additions and 19 deletions
--- a/backend/app/http/tenant/media_asset_admin.go
+++ b/backend/app/http/tenant/media_asset_admin.go
@@ -0,0 +1,90 @@
+package tenant
+
+import (
+	"time"
+
+	"quyun/v2/app/errorx"
+	"quyun/v2/app/http/tenant/dto"
+	"quyun/v2/app/services"
+	"quyun/v2/database/models"
+
+	"github.com/gofiber/fiber/v3"
+	log "github.com/sirupsen/logrus"
+)
+
+// mediaAssetAdmin provides tenant-admin media asset endpoints.
+//
+//	@provider
+type mediaAssetAdmin struct{}
+
+// uploadInit
+//
+//	@Summary	初始化媒体资源上传（租户管理）
+//	@Tags		Tenant
+//	@Accept		json
+//	@Produce	json
+//	@Param		tenantCode	path		string						true	"Tenant Code"
+//	@Param		form		body		dto.AdminMediaAssetUploadInitForm	true	"Form"
+//	@Success	200			{object}	dto.AdminMediaAssetUploadInitResponse
+//
+//	@Router		/t/:tenantCode/v1/admin/media_assets/upload_init [post]
+//	@Bind		tenant local key(tenant)
+//	@Bind		tenantUser local key(tenant_user)
+//	@Bind		form body
+func (*mediaAssetAdmin) uploadInit(
+	ctx fiber.Ctx,
+	tenant *models.Tenant,
+	tenantUser *models.TenantUser,
+	form *dto.AdminMediaAssetUploadInitForm,
+) (*dto.AdminMediaAssetUploadInitResponse, error) {
+	if err := requireTenantAdmin(tenantUser); err != nil {
+		return nil, err
+	}
+	if form == nil {
+		return nil, errorx.ErrInvalidParameter
+	}
+
+	log.WithFields(log.Fields{
+		"tenant_id": tenant.ID,
+		"user_id":   tenantUser.UserID,
+		"type":      form.Type,
+	}).Info("tenant.admin.media_assets.upload_init")
+
+	return services.MediaAsset.AdminUploadInit(ctx.Context(), tenant.ID, tenantUser.UserID, form, time.Now())
+}
+
+// uploadComplete
+//
+//	@Summary	确认上传完成并进入处理（租户管理）
+//	@Tags		Tenant
+//	@Accept		json
+//	@Produce	json
+//	@Param		tenantCode	path		string							true	"Tenant Code"
+//	@Param		assetID		path		int64							true	"AssetID"
+//	@Param		form		body		dto.AdminMediaAssetUploadCompleteForm	false	"Form"
+//	@Success	200			{object}	models.MediaAsset
+//
+//	@Router		/t/:tenantCode/v1/admin/media_assets/:assetID/upload_complete [post]
+//	@Bind		tenant local key(tenant)
+//	@Bind		tenantUser local key(tenant_user)
+//	@Bind		assetID path
+//	@Bind		form body
+func (*mediaAssetAdmin) uploadComplete(
+	ctx fiber.Ctx,
+	tenant *models.Tenant,
+	tenantUser *models.TenantUser,
+	assetID int64,
+	form *dto.AdminMediaAssetUploadCompleteForm,
+) (*models.MediaAsset, error) {
+	if err := requireTenantAdmin(tenantUser); err != nil {
+		return nil, err
+	}
+
+	log.WithFields(log.Fields{
+		"tenant_id": tenant.ID,
+		"user_id":   tenantUser.UserID,
+		"asset_id":  assetID,
+	}).Info("tenant.admin.media_assets.upload_complete")
+
+	return services.MediaAsset.AdminUploadComplete(ctx.Context(), tenant.ID, tenantUser.UserID, assetID, form, time.Now())
+}