feat: 添加媒体资产上传初始化和完成相关API接口及数据结构
This commit is contained in:
228
backend/app/services/media_asset.go
Normal file
228
backend/app/services/media_asset.go
Normal file
@@ -0,0 +1,228 @@
|
||||
package services
|
||||
|
||||
import (
|
||||
"context"
|
||||
"crypto/rand"
|
||||
"encoding/base32"
|
||||
"encoding/json"
|
||||
"errors"
|
||||
"strconv"
|
||||
"strings"
|
||||
"time"
|
||||
|
||||
"quyun/v2/app/errorx"
|
||||
"quyun/v2/app/http/tenant/dto"
|
||||
"quyun/v2/database/models"
|
||||
"quyun/v2/pkg/consts"
|
||||
|
||||
pkgerrors "github.com/pkg/errors"
|
||||
"github.com/sirupsen/logrus"
|
||||
"go.ipao.vip/gen/types"
|
||||
"gorm.io/gorm"
|
||||
"gorm.io/gorm/clause"
|
||||
)
|
||||
|
||||
// mediaAsset 提供媒体资源上传初始化等能力（上传/处理链路会在后续里程碑补齐）。
|
||||
//
|
||||
// @provider
|
||||
type mediaAsset struct{}
|
||||
|
||||
func newObjectKey(tenantID, userID int64, assetType consts.MediaAssetType, now time.Time) (string, error) {
|
||||
// object_key 作为存储定位的关键字段：必须由服务端生成，避免客户端路径注入与越权覆盖。
|
||||
buf := make([]byte, 16) // 128-bit
|
||||
if _, err := rand.Read(buf); err != nil {
|
||||
return "", err
|
||||
}
|
||||
token := strings.ToLower(base32.StdEncoding.WithPadding(base32.NoPadding).EncodeToString(buf))
|
||||
date := now.UTC().Format("20060102")
|
||||
return "tenants/" + strconv.FormatInt(tenantID, 10) +
|
||||
"/users/" + strconv.FormatInt(userID, 10) +
|
||||
"/" + string(assetType) +
|
||||
"/" + date +
|
||||
"/" + token, nil
|
||||
}
|
||||
|
||||
// AdminUploadInit creates a MediaAsset record and returns upload parameters.
|
||||
// 当前版本为“stub 上传初始化”：只负责生成 asset 与 object_key，不对接外部存储签名。
|
||||
func (s *mediaAsset) AdminUploadInit(ctx context.Context, tenantID, operatorUserID int64, form *dto.AdminMediaAssetUploadInitForm, now time.Time) (*dto.AdminMediaAssetUploadInitResponse, error) {
|
||||
if tenantID <= 0 || operatorUserID <= 0 {
|
||||
return nil, errorx.ErrInvalidParameter.WithMsg("tenant_id/operator_user_id must be > 0")
|
||||
}
|
||||
if form == nil {
|
||||
return nil, errorx.ErrInvalidParameter.WithMsg("form is nil")
|
||||
}
|
||||
if now.IsZero() {
|
||||
now = time.Now()
|
||||
}
|
||||
|
||||
typ := consts.MediaAssetType(strings.TrimSpace(form.Type))
|
||||
if typ == "" || !typ.IsValid() {
|
||||
return nil, errorx.ErrInvalidParameter.WithMsg("invalid type")
|
||||
}
|
||||
|
||||
objectKey, err := newObjectKey(tenantID, operatorUserID, typ, now)
|
||||
if err != nil {
|
||||
return nil, pkgerrors.Wrap(err, "generate object_key failed")
|
||||
}
|
||||
|
||||
metaMap := map[string]any{}
|
||||
if form.ContentType != "" {
|
||||
metaMap["content_type"] = strings.TrimSpace(form.ContentType)
|
||||
}
|
||||
if form.FileSize > 0 {
|
||||
metaMap["file_size"] = form.FileSize
|
||||
}
|
||||
if form.SHA256 != "" {
|
||||
metaMap["sha256"] = strings.ToLower(strings.TrimSpace(form.SHA256))
|
||||
}
|
||||
metaBytes, _ := json.Marshal(metaMap)
|
||||
if len(metaBytes) == 0 {
|
||||
metaBytes = []byte("{}")
|
||||
}
|
||||
|
||||
m := &models.MediaAsset{
|
||||
TenantID: tenantID,
|
||||
UserID: operatorUserID,
|
||||
Type: typ,
|
||||
Status: consts.MediaAssetStatusUploaded,
|
||||
Provider: "stub",
|
||||
Bucket: "",
|
||||
ObjectKey: objectKey,
|
||||
Meta: types.JSON(metaBytes),
|
||||
CreatedAt: now,
|
||||
UpdatedAt: now,
|
||||
}
|
||||
if err := m.Create(ctx); err != nil {
|
||||
return nil, pkgerrors.Wrap(err, "create media asset failed")
|
||||
}
|
||||
|
||||
logrus.WithFields(logrus.Fields{
|
||||
"tenant_id": tenantID,
|
||||
"user_id": operatorUserID,
|
||||
"asset_id": m.ID,
|
||||
"type": typ,
|
||||
"object_key": objectKey,
|
||||
}).Info("services.media_asset.admin.upload_init")
|
||||
|
||||
// 约定：upload_url 先返回空或内部占位；后续接入真实存储签名后再补齐。
|
||||
return &dto.AdminMediaAssetUploadInitResponse{
|
||||
AssetID: m.ID,
|
||||
Provider: m.Provider,
|
||||
Bucket: m.Bucket,
|
||||
ObjectKey: m.ObjectKey,
|
||||
UploadURL: "",
|
||||
Headers: map[string]string{},
|
||||
FormFields: map[string]string{},
|
||||
ExpiresAt: nil,
|
||||
}, nil
|
||||
}
|
||||
|
||||
// AdminUploadComplete marks the asset upload as completed and transitions status uploaded -> processing.
|
||||
// 幂等语义：
|
||||
// - 若当前已是 processing/ready/failed，则直接返回当前资源，不重复触发处理。
|
||||
// - 仅允许 uploaded 状态进入 processing；其他状态返回状态冲突/前置条件失败。
|
||||
func (s *mediaAsset) AdminUploadComplete(
|
||||
ctx context.Context,
|
||||
tenantID, operatorUserID, assetID int64,
|
||||
form *dto.AdminMediaAssetUploadCompleteForm,
|
||||
now time.Time,
|
||||
) (*models.MediaAsset, error) {
|
||||
if tenantID <= 0 || operatorUserID <= 0 || assetID <= 0 {
|
||||
return nil, errorx.ErrInvalidParameter.WithMsg("tenant_id/operator_user_id/asset_id must be > 0")
|
||||
}
|
||||
if now.IsZero() {
|
||||
now = time.Now()
|
||||
}
|
||||
|
||||
logrus.WithFields(logrus.Fields{
|
||||
"tenant_id": tenantID,
|
||||
"user_id": operatorUserID,
|
||||
"asset_id": assetID,
|
||||
}).Info("services.media_asset.admin.upload_complete")
|
||||
|
||||
var out models.MediaAsset
|
||||
|
||||
err := _db.WithContext(ctx).Transaction(func(tx *gorm.DB) error {
|
||||
var m models.MediaAsset
|
||||
if err := tx.
|
||||
Clauses(clause.Locking{Strength: "UPDATE"}).
|
||||
Where("tenant_id = ? AND id = ?", tenantID, assetID).
|
||||
First(&m).Error; err != nil {
|
||||
if errors.Is(err, gorm.ErrRecordNotFound) {
|
||||
return errorx.ErrRecordNotFound.WithMsg("media asset not found")
|
||||
}
|
||||
return err
|
||||
}
|
||||
|
||||
// 软删除资源不允许进入处理流程。
|
||||
if m.DeletedAt.Valid {
|
||||
return errorx.ErrPreconditionFailed.WithMsg("media asset deleted")
|
||||
}
|
||||
|
||||
// 幂等：重复 upload_complete 时返回现态。
|
||||
switch m.Status {
|
||||
case consts.MediaAssetStatusProcessing, consts.MediaAssetStatusReady, consts.MediaAssetStatusFailed:
|
||||
out = m
|
||||
return nil
|
||||
case consts.MediaAssetStatusUploaded:
|
||||
// allowed
|
||||
default:
|
||||
return errorx.ErrStatusConflict.WithMsg("invalid media asset status")
|
||||
}
|
||||
|
||||
// 合并 meta（尽量不覆盖已有字段）。
|
||||
meta := map[string]any{}
|
||||
if len(m.Meta) > 0 {
|
||||
_ = json.Unmarshal(m.Meta, &meta)
|
||||
}
|
||||
meta["upload_complete_at"] = now.UTC().Format(time.RFC3339Nano)
|
||||
if form != nil {
|
||||
if strings.TrimSpace(form.ETag) != "" {
|
||||
meta["etag"] = strings.TrimSpace(form.ETag)
|
||||
}
|
||||
if strings.TrimSpace(form.ContentType) != "" {
|
||||
meta["content_type"] = strings.TrimSpace(form.ContentType)
|
||||
}
|
||||
if form.FileSize > 0 {
|
||||
meta["file_size"] = form.FileSize
|
||||
}
|
||||
if strings.TrimSpace(form.SHA256) != "" {
|
||||
meta["sha256"] = strings.ToLower(strings.TrimSpace(form.SHA256))
|
||||
}
|
||||
}
|
||||
metaBytes, _ := json.Marshal(meta)
|
||||
if len(metaBytes) == 0 {
|
||||
metaBytes = []byte("{}")
|
||||
}
|
||||
|
||||
// 状态迁移：uploaded -> processing
|
||||
if err := tx.Model(&models.MediaAsset{}).
|
||||
Where("id = ?", m.ID).
|
||||
Updates(map[string]any{
|
||||
"status": consts.MediaAssetStatusProcessing,
|
||||
"meta": types.JSON(metaBytes),
|
||||
"updated_at": now,
|
||||
}).Error; err != nil {
|
||||
return err
|
||||
}
|
||||
|
||||
m.Status = consts.MediaAssetStatusProcessing
|
||||
m.Meta = types.JSON(metaBytes)
|
||||
m.UpdatedAt = now
|
||||
out = m
|
||||
|
||||
// 触发异步处理（当前为 stub）：后续接入队列/任务系统时在此处落任务并保持幂等。
|
||||
logrus.WithFields(logrus.Fields{
|
||||
"tenant_id": tenantID,
|
||||
"user_id": operatorUserID,
|
||||
"asset_id": assetID,
|
||||
"status": m.Status,
|
||||
}).Info("services.media_asset.process.triggered")
|
||||
|
||||
return nil
|
||||
})
|
||||
if err != nil {
|
||||
return nil, err
|
||||
}
|
||||
return &out, nil
|
||||
}
|
||||
Reference in New Issue
Block a user