整体平台上传功能大改造

2026-09-09 10:49:57 +08:00
parent d2643a3697
commit de7225b61e
21 changed files with 3835 additions and 2622 deletions
@@ -1,25 +1,81 @@
-package models
-
-import "time"
-
-// SystemFile 附件表 yz_system_files
-type SystemFile struct {
-	ID          uint64     `orm:"column(id);pk;auto" json:"id"`
-	Tid         uint64     `orm:"column(tid)" json:"tid"`
-	Uid         *uint64    `orm:"column(uid);null" json:"uid"`
-	Tuid        *uint64    `orm:"column(tuid);null" json:"tuid"`
-	Name        string     `orm:"column(name);size(255)" json:"name"`
-	Type        uint8      `orm:"column(type);default(2)" json:"type"`
-	Cate        uint64     `orm:"column(cate);default(0)" json:"cate"`
-	Size        uint64     `orm:"column(size);default(0)" json:"size"`
-	Src         string     `orm:"column(src);size(512)" json:"src"`
-	Uploader    uint64     `orm:"column(uploader);default(0)" json:"uploader"`
-	Md5         string     `orm:"column(md5);size(32)" json:"md5"`
-	CreateTime  time.Time  `orm:"column(create_time);type(datetime);auto_now_add" json:"create_time"`
-	UpdateTime  *time.Time `orm:"column(update_time);type(datetime);null;auto_now" json:"update_time"`
-	DeleteTime  *time.Time `orm:"column(delete_time);type(datetime);null" json:"delete_time"`
-}
-
-func (m *SystemFile) TableName() string {
-	return "yz_system_files"
-}
+package models
+
+import (
+	"sync"
+	"time"
+)
+
+// SystemFile 附件表 yz_system_files
+//
+// 归属语义（2026-09-09 文件存储分层改造后明确）：
+//   - tid  : 租户 ID
+//   - uid  : 上传者 ID
+//   - tuid : 归属用户 ID（scope=user 时必填；scope=tenant 时为 NULL）
+//   - source: 来源端 backend / platform
+//   - scope : tenant-租户共享 / user-用户个人
+//   - object_key: 存储相对路径，不含域名，如 backend/234573/67091493/2026/09/09/xxx.png
+type SystemFile struct {
+	ID         uint64     `orm:"column(id);pk;auto" json:"id"`
+	Tid        uint64     `orm:"column(tid)" json:"tid"`
+	Uid        *uint64    `orm:"column(uid);null" json:"uid"`
+	Tuid       *uint64    `orm:"column(tuid);null" json:"tuid"`
+	Name       string     `orm:"column(name);size(255)" json:"name"`
+	Type       uint8      `orm:"column(type);default(2)" json:"type"`
+	Cate       uint64     `orm:"column(cate);default(0)" json:"cate"`
+	Size       uint64     `orm:"column(size);default(0)" json:"size"`
+	Src        string     `orm:"column(src);size(512)" json:"src"`
+	Uploader   uint64     `orm:"column(uploader);default(0)" json:"uploader"`
+	Md5        string     `orm:"column(md5);size(32)" json:"md5"`
+	Source     string     `orm:"column(source);size(16);default(backend)" json:"source"`
+	Scope      string     `orm:"column(scope);size(16);default(tenant)" json:"scope"`
+	Storage    string     `orm:"column(storage);size(16);default()" json:"storage"`
+	ObjectKey  string     `orm:"column(object_key);size(512);default()" json:"object_key"`
+	CreateTime time.Time  `orm:"column(create_time);type(datetime);auto_now_add" json:"create_time"`
+	UpdateTime *time.Time `orm:"column(update_time);type(datetime);null;auto_now" json:"update_time"`
+	DeleteTime *time.Time `orm:"column(delete_time);type(datetime);null" json:"delete_time"`
+}
+
+func (m *SystemFile) TableName() string {
+	return "yz_system_files"
+}
+
+// 归属与存储字段的取值常量
+const (
+	FileSourceBackend  = "backend"  // 租户后台端
+	FileSourcePlatform = "platform" // 平台端
+
+	FileScopeTenant = "tenant" // 租户共享文件
+	FileScopeUser   = "user"   // 用户个人文件
+)
+
+var systemFileStorageColumnsOnce sync.Once
+
+// EnsureSystemFileStorageColumns 为附件表补齐文件存储分层改造所需字段。
+// 历史库可能早于该特性建表，字段/索引已存在时 MySQL 报 duplicate，统一忽略，不阻断主流程。
+// 写入 yz_system_files 之前必须调用，否则 INSERT 会因 Unknown column 失败。
+func EnsureSystemFileStorageColumns() {
+	if Orm == nil {
+		return
+	}
+	systemFileStorageColumnsOnce.Do(func() {
+		alters := []string{
+			"ALTER TABLE yz_system_files ADD COLUMN source varchar(16) NOT NULL DEFAULT 'backend' COMMENT '来源端: backend-租户后台 platform-平台端'",
+			"ALTER TABLE yz_system_files ADD COLUMN scope varchar(16) NOT NULL DEFAULT 'tenant' COMMENT '归属: tenant-租户共享 user-用户个人'",
+			"ALTER TABLE yz_system_files ADD COLUMN storage varchar(16) NOT NULL DEFAULT '' COMMENT '存储类型: local/qiniu'",
+			"ALTER TABLE yz_system_files ADD COLUMN object_key varchar(512) NOT NULL DEFAULT '' COMMENT '存储相对路径(不含域名)'",
+		}
+		for _, sql := range alters {
+			_, _ = Orm.Raw(sql).Exec()
+		}
+		// 索引：MD5 精确去重 + 归属列表过滤
+		// md5 在部分历史库中是 TEXT 类型，MySQL 不允许对 TEXT/BLOB 建整列索引，
+		// 故使用前缀长度 md5(32)（MD5 十六进制串固定 32 字符）。
+		indexes := []string{
+			"ALTER TABLE yz_system_files ADD KEY idx_file_dedup (source, scope, tid, tuid, md5(32))",
+			"ALTER TABLE yz_system_files ADD KEY idx_file_owner (source, tid, scope, tuid, delete_time)",
+		}
+		for _, sql := range indexes {
+			_, _ = Orm.Raw(sql).Exec()
+		}
+	})
+}