upload+accessKey

internal/model/access_token.go

@@ -0,0 +1,60 @@
+/*
+Copyright 2025 linux.do
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+package model
+
+import (
+	"crypto/rand"
+	"crypto/sha256"
+	"encoding/hex"
+	"fmt"
+	"time"
+)
+
+type AccessToken struct {
+	ID          uint64     `json:"id" gorm:"primaryKey;autoIncrement"`
+	UserID      uint64     `json:"user_id" gorm:"index;not null"`
+	Name        string     `json:"name" gorm:"size:128;not null"`
+	TokenHash   string     `json:"-" gorm:"size:64;uniqueIndex;not null"`
+	MaskedToken string     `json:"masked_token" gorm:"size:64;not null"`
+	LastUsedAt  *time.Time `json:"last_used_at"`
+	CreatedAt   time.Time  `json:"created_at" gorm:"autoCreateTime"`
+	UpdatedAt   time.Time  `json:"updated_at" gorm:"autoUpdateTime"`
+}
+
+// GenerateTokenString 生成加密安全的随机 Token 值
+func GenerateTokenString() (string, error) {
+	bytes := make([]byte, 24)
+	if _, err := rand.Read(bytes); err != nil {
+		return "", err
+	}
+	return fmt.Sprintf("at_%s", hex.EncodeToString(bytes)), nil
+}
+
+// HashToken 计算 Token 的 SHA-256 哈希值用于数据库存储与查询
+func HashToken(token string) string {
+	h := sha256.New()
+	h.Write([]byte(token))
+	return hex.EncodeToString(h.Sum(nil))
+}
+
+// MaskTokenString 生成脱敏显示的 Token，仅保留前缀和最后四位
+func MaskTokenString(token string) string {
+	if len(token) <= 8 {
+		return "at_****"
+	}
+	return fmt.Sprintf("%s...%s", token[:7], token[len(token)-4:])
+}

internal/model/uploads.go

@@ -29,20 +29,32 @@ const (
 	UploadStatusDeleted UploadStatus = "deleted" // 已删除
 )
 
-// UploadType 上传类型常量
-const (
-	UploadTypeCover       = "cover"       // 红包背景封面
-	UploadTypeHeterotypic = "heterotypic" // 红包异形装饰
-)
+// UploadMetadata 自定义可扩展的 JSON 字段存储非核心或可选的文件元数据
+type UploadMetadata struct {
+	Width        int            `json:"width,omitempty"`         // 图像/视频宽度 (px)
+	Height       int            `json:"height,omitempty"`        // 图像/视频高度 (px)
+	Duration     float64        `json:"duration,omitempty"`      // 音视频时长 (s)
+	OriginalMime string         `json:"original_mime,omitempty"` // 原始 MIME 类型
+	UserAgent    string         `json:"user_agent,omitempty"`    // 上传者的 UA
+	ClientIP     string         `json:"client_ip,omitempty"`     // 上传者 IP
+	Bucket       string         `json:"bucket,omitempty"`        // 存储桶名称 (适用于 S3 等)
+	Extra        map[string]any `json:"extra,omitempty"`         // 其它任意业务自定义元数据
+}
 
 // Upload 上传文件记录
 type Upload struct {
-	ID        uint64       `json:"id,string" gorm:"primaryKey"`
-	UserID    uint64       `json:"user_id,string" gorm:"index;not null"`
-	FilePath  string       `json:"file_path" gorm:"size:500;not null;uniqueIndex"` // 文件路径
-	FileSize  int64        `json:"file_size" gorm:"not null"`                      // 文件大小（字节）
-	Type      string       `json:"type" gorm:"column:type;size:50;not null;index"` // 类型 (cover, heterotypic)
-	Status    UploadStatus `json:"status" gorm:"type:varchar(20);not null"`        // 状态
-	CreatedAt time.Time    `json:"created_at" gorm:"autoCreateTime"`
-	UpdatedAt time.Time    `json:"updated_at" gorm:"autoUpdateTime"`
+	ID            uint64         `json:"id,string" gorm:"primaryKey"`
+	UserID        uint64         `json:"user_id,string" gorm:"index;not null"`
+	FileName      string         `json:"file_name" gorm:"size:255;not null"`             // 原始文件名 (例如: image.png)
+	FilePath      string         `json:"file_path" gorm:"size:500;not null;index"`       // 文件相对路径 / S3 Key
+	FileSize      int64          `json:"file_size" gorm:"not null"`                      // 文件大小（字节）
+	MimeType      string         `json:"mime_type" gorm:"size:100;not null"`             // 媒体类型 (MIME, 如 image/png)
+	Extension     string         `json:"extension" gorm:"size:50;not null"`              // 文件后缀名 (不含点，如 png, pdf)
+	Hash          string         `json:"hash" gorm:"size:64;index"`                      // 文件哈希 (SHA-256/MD5，可用于排重)
+	StorageDriver string         `json:"storage_driver" gorm:"size:50;not null"`         // 存储引擎驱动 (如 local, s3, oss)
+	Type          string         `json:"type" gorm:"column:type;size:50;not null;index"` // 业务标识类型 (如 avatar, doc, attachment)
+	Status        UploadStatus   `json:"status" gorm:"type:varchar(20);not null"`        // 状态
+	Metadata      UploadMetadata `json:"metadata" gorm:"serializer:json;type:jsonb"`     // 业务扩展元数据
+	CreatedAt     time.Time      `json:"created_at" gorm:"autoCreateTime"`
+	UpdatedAt     time.Time      `json:"updated_at" gorm:"autoUpdateTime"`
 }