feat: 添加媒体资源管理相关API接口及数据结构，包括列表和详情查询

backend/app/http/tenant/dto/media_asset_admin_list.go

@@ -0,0 +1,29 @@
+package dto
+
+import (
+	"time"
+
+	"quyun/v2/app/requests"
+	"quyun/v2/pkg/consts"
+)
+
+// AdminMediaAssetListFilter defines tenant-admin list query filters for media assets.
+type AdminMediaAssetListFilter struct {
+	// Pagination defines page/limit; page is 1-based, limit uses the global whitelist.
+	requests.Pagination `json:",inline" query:",inline"`
+
+	// SortQueryFilter defines asc/desc ordering; service layer applies a whitelist.
+	requests.SortQueryFilter `json:",inline" query:",inline"`
+
+	// Type filters by media type (video/audio/image); optional.
+	Type *consts.MediaAssetType `json:"type,omitempty" query:"type"`
+
+	// Status filters by processing status (uploaded/processing/ready/failed/deleted); optional.
+	Status *consts.MediaAssetStatus `json:"status,omitempty" query:"status"`
+
+	// CreatedAtFrom filters assets by created_at >= this time; optional.
+	CreatedAtFrom *time.Time `json:"created_at_from,omitempty" query:"created_at_from"`
+
+	// CreatedAtTo filters assets by created_at <= this time; optional.
+	CreatedAtTo *time.Time `json:"created_at_to,omitempty" query:"created_at_to"`
+}

backend/app/http/tenant/media_asset_admin.go

@@ -5,6 +5,7 @@ import (
 
 	"quyun/v2/app/errorx"
 	"quyun/v2/app/http/tenant/dto"
+	"quyun/v2/app/requests"
 	"quyun/v2/app/services"
 	"quyun/v2/database/models"
 
@@ -17,6 +18,76 @@ import (
 //	@provider
 type mediaAssetAdmin struct{}
 
+// adminList
+//
+//	@Summary	媒体资源列表（租户管理）
+//	@Tags		Tenant
+//	@Accept		json
+//	@Produce	json
+//	@Param		tenantCode	path		string						true	"Tenant Code"
+//	@Param		filter		query		dto.AdminMediaAssetListFilter	true	"Filter"
+//	@Success	200			{object}	requests.Pager{items=models.MediaAsset}
+//
+//	@Router		/t/:tenantCode/v1/admin/media_assets [get]
+//	@Bind		tenant local key(tenant)
+//	@Bind		tenantUser local key(tenant_user)
+//	@Bind		filter query
+func (*mediaAssetAdmin) adminList(
+	ctx fiber.Ctx,
+	tenant *models.Tenant,
+	tenantUser *models.TenantUser,
+	filter *dto.AdminMediaAssetListFilter,
+) (*requests.Pager, error) {
+	if err := requireTenantAdmin(tenantUser); err != nil {
+		return nil, err
+	}
+	if filter == nil {
+		filter = &dto.AdminMediaAssetListFilter{}
+	}
+
+	log.WithFields(log.Fields{
+		"tenant_id": tenant.ID,
+		"user_id":   tenantUser.UserID,
+		"type":      filter.Type,
+		"status":    filter.Status,
+	}).Info("tenant.admin.media_assets.list")
+
+	return services.MediaAsset.AdminPage(ctx.Context(), tenant.ID, filter)
+}
+
+// adminDetail
+//
+//	@Summary	媒体资源详情（租户管理）
+//	@Tags		Tenant
+//	@Accept		json
+//	@Produce	json
+//	@Param		tenantCode	path		string	true	"Tenant Code"
+//	@Param		assetID		path		int64	true	"AssetID"
+//	@Success	200			{object}	models.MediaAsset
+//
+//	@Router		/t/:tenantCode/v1/admin/media_assets/:assetID [get]
+//	@Bind		tenant local key(tenant)
+//	@Bind		tenantUser local key(tenant_user)
+//	@Bind		assetID path
+func (*mediaAssetAdmin) adminDetail(
+	ctx fiber.Ctx,
+	tenant *models.Tenant,
+	tenantUser *models.TenantUser,
+	assetID int64,
+) (*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.detail")
+
+	return services.MediaAsset.AdminDetail(ctx.Context(), tenant.ID, assetID)
+}
+
 // uploadInit
 //
 //	@Summary	初始化媒体资源上传（租户管理）

backend/app/http/tenant/routes.gen.go

@@ -134,6 +134,20 @@ func (r *Routes) Register(router fiber.Router) {
 		Query[dto.MyLedgerListFilter]("filter"),
 	))
 	// Register routes for controller: mediaAssetAdmin
+	r.log.Debugf("Registering route: Get /t/:tenantCode/v1/admin/media_assets -> mediaAssetAdmin.adminList")
+	router.Get("/t/:tenantCode/v1/admin/media_assets"[len(r.Path()):], DataFunc3(
+		r.mediaAssetAdmin.adminList,
+		Local[*models.Tenant]("tenant"),
+		Local[*models.TenantUser]("tenant_user"),
+		Query[dto.AdminMediaAssetListFilter]("filter"),
+	))
+	r.log.Debugf("Registering route: Get /t/:tenantCode/v1/admin/media_assets/:assetID -> mediaAssetAdmin.adminDetail")
+	router.Get("/t/:tenantCode/v1/admin/media_assets/:assetID"[len(r.Path()):], DataFunc3(
+		r.mediaAssetAdmin.adminDetail,
+		Local[*models.Tenant]("tenant"),
+		Local[*models.TenantUser]("tenant_user"),
+		PathParam[int64]("assetID"),
+	))
 	r.log.Debugf("Registering route: Post /t/:tenantCode/v1/admin/media_assets/:assetID/upload_complete -> mediaAssetAdmin.uploadComplete")
 	router.Post("/t/:tenantCode/v1/admin/media_assets/:assetID/upload_complete"[len(r.Path()):], DataFunc4(
 		r.mediaAssetAdmin.uploadComplete,