package models import ( "strings" "sync" "time" ) // OA 文档管理(文档库 / 文档图谱)数据模型。 // // 三张表按租户 tid 隔离: // - yz_backend_oa_doc_category 文档分类(树形,parent_id=0 为一级) // - yz_backend_oa_doc 文档主体(附件信息冗余存储,避免每次联查文件表) // - yz_backend_oa_doc_link 文档关联关系(引用/相关/版本/从属),文档图谱的连线来源 // OaDocCategory OA文档分类: yz_backend_oa_doc_category type OaDocCategory struct { ID uint64 `orm:"column(id);pk;auto" json:"id"` Tid int `orm:"column(tid)" json:"tid"` ParentID uint64 `orm:"column(parent_id);default(0)" json:"parent_id"` Name string `orm:"column(name);size(128)" json:"name"` Sort int `orm:"column(sort);default(0)" json:"sort"` Remark string `orm:"column(remark);size(255);default()" json:"remark"` IsDeleted int8 `orm:"column(is_deleted);default(0)" json:"is_deleted"` CreateTime time.Time `orm:"column(create_time);auto_now_add;type(datetime)" json:"create_time"` UpdateTime *time.Time `orm:"column(update_time);auto_now;type(datetime);null" json:"update_time"` DeleteTime *time.Time `orm:"column(delete_time);type(datetime);null" json:"delete_time"` } func (m *OaDocCategory) TableName() string { return "yz_backend_oa_doc_category" } // OaDoc OA文档: yz_backend_oa_doc // status: 0-草稿 1-已发布 2-已归档 // doc_type: 0-其他 1-文档 2-表格 3-演示 4-PDF 5-图片 6-压缩包 7-视频 8-音频 type OaDoc struct { ID uint64 `orm:"column(id);pk;auto" json:"id"` Tid int `orm:"column(tid)" json:"tid"` CategoryID uint64 `orm:"column(category_id);default(0)" json:"category_id"` Title string `orm:"column(title);size(255)" json:"title"` FileID uint64 `orm:"column(file_id);default(0)" json:"file_id"` FileURL string `orm:"column(file_url);size(512);default()" json:"file_url"` FileName string `orm:"column(file_name);size(255);default()" json:"file_name"` Ext string `orm:"column(ext);size(16);default()" json:"ext"` Size uint64 `orm:"column(size);default(0)" json:"size"` DocType int8 `orm:"column(doc_type);default(0)" json:"doc_type"` Tags string `orm:"column(tags);size(255);default()" json:"tags"` Summary string `orm:"column(summary);size(1000);default()" json:"summary"` Status int8 `orm:"column(status);default(0)" json:"status"` Version int `orm:"column(version);default(1)" json:"version"` IsStar int8 `orm:"column(is_star);default(0)" json:"is_star"` OwnerID uint64 `orm:"column(owner_id);default(0)" json:"owner_id"` OwnerName string `orm:"column(owner_name);size(100);default()" json:"owner_name"` ViewCount int `orm:"column(view_count);default(0)" json:"view_count"` DownCount int `orm:"column(download_count);default(0)" json:"download_count"` CreatorID uint64 `orm:"column(creator_id);default(0)" json:"creator_id"` CreatorName string `orm:"column(creator_name);size(100);default()" json:"creator_name"` // Visibility 可见性:0-租户公开(默认,租户内所有后台用户可见)1-私密(仅创建者与被共享者可见) Visibility int8 `orm:"column(visibility);default(0)" json:"visibility"` IsDeleted int8 `orm:"column(is_deleted);default(0)" json:"is_deleted"` CreateTime time.Time `orm:"column(create_time);auto_now_add;type(datetime)" json:"create_time"` UpdateTime *time.Time `orm:"column(update_time);auto_now;type(datetime);null" json:"update_time"` DeleteTime *time.Time `orm:"column(delete_time);type(datetime);null" json:"delete_time"` } func (m *OaDoc) TableName() string { return "yz_backend_oa_doc" } // OaDocLink OA文档关联: yz_backend_oa_doc_link // relation: reference-引用 related-相关 version-版本迭代 belong-从属 type OaDocLink struct { ID uint64 `orm:"column(id);pk;auto" json:"id"` Tid int `orm:"column(tid)" json:"tid"` SourceID uint64 `orm:"column(source_id);default(0)" json:"source_id"` TargetID uint64 `orm:"column(target_id);default(0)" json:"target_id"` Relation string `orm:"column(relation);size(32);default(related)" json:"relation"` Remark string `orm:"column(remark);size(255);default()" json:"remark"` CreatorID uint64 `orm:"column(creator_id);default(0)" json:"creator_id"` CreateTime time.Time `orm:"column(create_time);auto_now_add;type(datetime)" json:"create_time"` } func (m *OaDocLink) TableName() string { return "yz_backend_oa_doc_link" } // OaDocShare OA文档共享: yz_backend_oa_doc_share // 私密文档(visibility=1)在"创建者可见"之外,额外授权给指定用户或部门。 // share_type: 0-用户(target_id 为 yz_system_tenant_user.uid) // 1-部门(target_id 为 yz_backend_organization.id,含其全部子部门) type OaDocShare struct { ID uint64 `orm:"column(id);pk;auto" json:"id"` Tid int `orm:"column(tid)" json:"tid"` DocID uint64 `orm:"column(doc_id);default(0)" json:"doc_id"` ShareType int8 `orm:"column(share_type);default(0)" json:"share_type"` TargetID uint64 `orm:"column(target_id);default(0)" json:"target_id"` CreatorID uint64 `orm:"column(creator_id);default(0)" json:"creator_id"` CreateTime time.Time `orm:"column(create_time);auto_now_add;type(datetime)" json:"create_time"` } func (m *OaDocShare) TableName() string { return "yz_backend_oa_doc_share" } // 文档类型常量(doc_type) const ( DocTypeOther int8 = 0 DocTypeDoc int8 = 1 // doc / docx / txt / md / rtf DocTypeSheet int8 = 2 // xls / xlsx / csv DocTypeSlide int8 = 3 // ppt / pptx DocTypePDF int8 = 4 // pdf DocTypeImage int8 = 5 // jpg / png / gif / bmp / webp DocTypeZip int8 = 6 // zip / rar / 7z / tar / gz DocTypeVideo int8 = 7 DocTypeAudio int8 = 8 ) // 文档状态常量(status) const ( DocStatusDraft int8 = 0 DocStatusPublish int8 = 1 DocStatusArchive int8 = 2 ) // 文档关联关系常量(relation) const ( DocRelationReference = "reference" DocRelationRelated = "related" DocRelationVersion = "version" DocRelationBelong = "belong" ) // 文档可见性常量(visibility) const ( DocVisibilityPublic int8 = 0 // 租户公开 DocVisibilityPrivate int8 = 1 // 私密 ) // 文档共享目标类型常量(share_type) const ( DocShareTypeUser int8 = 0 // 共享给指定用户(target_id = yz_system_tenant_user.uid) DocShareTypeOrg int8 = 1 // 共享给部门(target_id = yz_backend_organization.id,含子部门) ) // extDocTypeMap 扩展名 -> 文档类型 var extDocTypeMap = map[string]int8{ "doc": DocTypeDoc, "docx": DocTypeDoc, "txt": DocTypeDoc, "md": DocTypeDoc, "rtf": DocTypeDoc, "wps": DocTypeDoc, "odt": DocTypeDoc, "xls": DocTypeSheet, "xlsx": DocTypeSheet, "csv": DocTypeSheet, "ods": DocTypeSheet, "ppt": DocTypeSlide, "pptx": DocTypeSlide, "odp": DocTypeSlide, "pdf": DocTypePDF, "jpg": DocTypeImage, "jpeg": DocTypeImage, "png": DocTypeImage, "gif": DocTypeImage, "bmp": DocTypeImage, "webp": DocTypeImage, "svg": DocTypeImage, "zip": DocTypeZip, "rar": DocTypeZip, "7z": DocTypeZip, "tar": DocTypeZip, "gz": DocTypeZip, "mp4": DocTypeVideo, "webm": DocTypeVideo, "mov": DocTypeVideo, "avi": DocTypeVideo, "mp3": DocTypeAudio, "wav": DocTypeAudio, "ogg": DocTypeAudio, } // DocTypeByExt 根据扩展名推断文档类型,未知返回"其他"。 func DocTypeByExt(ext string) int8 { if t, ok := extDocTypeMap[strings.ToLower(strings.TrimPrefix(strings.TrimSpace(ext), "."))]; ok { return t } return DocTypeOther } var oaDocumentTableOnce sync.Once // EnsureOaDocumentTables 首次访问文档接口时自动建表(若不存在)。 // 与通知公告/日程保持一致的运行期自愈策略,避免新功能上线还需手工执行建表脚本。 func EnsureOaDocumentTables() error { if Orm == nil { return nil } var err error oaDocumentTableOnce.Do(func() { _, err = Orm.Raw(` CREATE TABLE IF NOT EXISTS yz_backend_oa_doc_category ( id bigint unsigned NOT NULL AUTO_INCREMENT COMMENT '主键ID', tid int NOT NULL DEFAULT 0 COMMENT '租户ID', parent_id bigint unsigned NOT NULL DEFAULT 0 COMMENT '父级ID,0为一级分类', name varchar(128) NOT NULL DEFAULT '' COMMENT '分类名称', sort int NOT NULL DEFAULT 0 COMMENT '排序,越小越靠前', remark varchar(255) NOT NULL DEFAULT '' COMMENT '备注', is_deleted tinyint NOT NULL DEFAULT 0 COMMENT '是否删除 0-否 1-是', create_time datetime DEFAULT NULL COMMENT '创建时间', update_time datetime DEFAULT NULL COMMENT '更新时间', delete_time datetime DEFAULT NULL COMMENT '删除时间', PRIMARY KEY (id), KEY idx_tid_parent (tid, parent_id) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='OA文档分类表'`).Exec() if err != nil { return } _, err = Orm.Raw(` CREATE TABLE IF NOT EXISTS yz_backend_oa_doc ( id bigint unsigned NOT NULL AUTO_INCREMENT COMMENT '主键ID', tid int NOT NULL DEFAULT 0 COMMENT '租户ID', category_id bigint unsigned NOT NULL DEFAULT 0 COMMENT '所属分类ID,0为未分类', title varchar(255) NOT NULL DEFAULT '' COMMENT '文档标题', file_id bigint unsigned NOT NULL DEFAULT 0 COMMENT '关联附件ID(yz_system_files)', file_url varchar(512) NOT NULL DEFAULT '' COMMENT '附件访问地址', file_name varchar(255) NOT NULL DEFAULT '' COMMENT '原始文件名', ext varchar(16) NOT NULL DEFAULT '' COMMENT '扩展名', size bigint unsigned NOT NULL DEFAULT 0 COMMENT '文件大小(字节)', doc_type tinyint NOT NULL DEFAULT 0 COMMENT '类型 0-其他 1-文档 2-表格 3-演示 4-PDF 5-图片 6-压缩包 7-视频 8-音频', tags varchar(255) NOT NULL DEFAULT '' COMMENT '标签,逗号分隔', summary varchar(1000) NOT NULL DEFAULT '' COMMENT '摘要/描述', status tinyint NOT NULL DEFAULT 0 COMMENT '状态 0-草稿 1-已发布 2-已归档', version int NOT NULL DEFAULT 1 COMMENT '版本号', is_star tinyint NOT NULL DEFAULT 0 COMMENT '是否收藏 0-否 1-是', owner_id bigint unsigned NOT NULL DEFAULT 0 COMMENT '负责人ID', owner_name varchar(100) NOT NULL DEFAULT '' COMMENT '负责人姓名', view_count int NOT NULL DEFAULT 0 COMMENT '查看次数', download_count int NOT NULL DEFAULT 0 COMMENT '下载次数', creator_id bigint unsigned NOT NULL DEFAULT 0 COMMENT '创建人ID', creator_name varchar(100) NOT NULL DEFAULT '' COMMENT '创建人姓名', visibility tinyint NOT NULL DEFAULT 0 COMMENT '可见性 0-租户公开 1-私密(仅创建者与被共享者)', is_deleted tinyint NOT NULL DEFAULT 0 COMMENT '是否删除 0-否 1-是', create_time datetime DEFAULT NULL COMMENT '创建时间', update_time datetime DEFAULT NULL COMMENT '更新时间', delete_time datetime DEFAULT NULL COMMENT '删除时间', PRIMARY KEY (id), KEY idx_tid_cate (tid, category_id, is_deleted), KEY idx_tid_status (tid, status, is_deleted), KEY idx_tid_title (tid, title) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='OA文档表'`).Exec() if err != nil { return } _, err = Orm.Raw(` CREATE TABLE IF NOT EXISTS yz_backend_oa_doc_link ( id bigint unsigned NOT NULL AUTO_INCREMENT COMMENT '主键ID', tid int NOT NULL DEFAULT 0 COMMENT '租户ID', source_id bigint unsigned NOT NULL DEFAULT 0 COMMENT '源文档ID', target_id bigint unsigned NOT NULL DEFAULT 0 COMMENT '目标文档ID', relation varchar(32) NOT NULL DEFAULT 'related' COMMENT '关系 reference-引用 related-相关 version-版本 belong-从属', remark varchar(255) NOT NULL DEFAULT '' COMMENT '关系说明', creator_id bigint unsigned NOT NULL DEFAULT 0 COMMENT '创建人ID', create_time datetime DEFAULT NULL COMMENT '创建时间', PRIMARY KEY (id), UNIQUE KEY uk_doc_pair (tid, source_id, target_id, relation), KEY idx_tid_source (tid, source_id), KEY idx_tid_target (tid, target_id) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='OA文档关联表'`).Exec() if err != nil { return } // 历史库补齐 visibility 列(已存在时 MySQL 报 duplicate column,忽略) _, _ = Orm.Raw(` ALTER TABLE yz_backend_oa_doc ADD COLUMN visibility tinyint NOT NULL DEFAULT 0 COMMENT '可见性 0-租户公开 1-私密(仅创建者与被共享者)' `).Exec() _, err = Orm.Raw(` CREATE TABLE IF NOT EXISTS yz_backend_oa_doc_share ( id bigint unsigned NOT NULL AUTO_INCREMENT COMMENT '主键ID', tid int NOT NULL DEFAULT 0 COMMENT '租户ID', doc_id bigint unsigned NOT NULL DEFAULT 0 COMMENT '文档ID', share_type tinyint NOT NULL DEFAULT 0 COMMENT '共享类型 0-用户(target_id=uid) 1-部门(target_id=org_id,含子部门)', target_id bigint unsigned NOT NULL DEFAULT 0 COMMENT '共享目标ID', creator_id bigint unsigned NOT NULL DEFAULT 0 COMMENT '授权人ID', create_time datetime DEFAULT NULL COMMENT '创建时间', PRIMARY KEY (id), UNIQUE KEY uk_doc_target (tid, doc_id, share_type, target_id), KEY idx_tid_doc (tid, doc_id), KEY idx_target (tid, share_type, target_id) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='OA文档共享表'`).Exec() }) return err }