287 lines
13 KiB
Go
287 lines
13 KiB
Go
package models
|
||
|
||
import (
|
||
"strings"
|
||
"sync"
|
||
"time"
|
||
|
||
"github.com/beego/beego/v2/client/orm"
|
||
)
|
||
|
||
// 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
|
||
//
|
||
// 双空间模型：文档库按「共享文档 / 私密文档」两个空间组织，每个空间各自有一棵分类树。
|
||
// - 共享文档空间（Scope="shared"、UserID=0）：租户级，租户内所有成员共用同一套文件夹结构；
|
||
// - 私密文档空间（Scope="personal"、UserID=登录用户的 yz_system_tenant_user.uid）：
|
||
// 绑定到租户的用户级别，每位用户拥有自己独立的一套文件夹，互不干扰；
|
||
// - 文档的可见性（OaDoc.Visibility）与所在空间一一对应：共享空间→租户公开(0)，私密空间→私密(1)；
|
||
// - 系统内置的「项目文档」属于共享空间（Scope="shared"、UserID=0）；
|
||
// - 「未分类」是虚拟分类（文档 category_id=0），不落库、不可删除，两个空间各自独立计算。
|
||
type OaDocCategory struct {
|
||
ID uint64 `orm:"column(id);pk;auto" json:"id"`
|
||
Tid int `orm:"column(tid)" json:"tid"`
|
||
// UserID 分类归属用户：共享空间恒为 0（租户级）；私密空间为创建者的 yz_system_tenant_user.uid。
|
||
UserID uint64 `orm:"column(user_id);default(0)" json:"user_id"`
|
||
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"`
|
||
IsSystem int8 `orm:"column(is_system);default(0)" json:"is_system"`
|
||
// Scope 所属空间：shared=共享文档空间，personal=私密文档空间（绑定到用户级别）。
|
||
Scope string `orm:"column(scope);size(16);default(shared)" json:"scope"`
|
||
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"`
|
||
// Content 在线制作文档的编辑源（富文本 HTML），仅用于再次编辑；上传文件或普通文档为空。
|
||
// 注意：文档对外的写入/下载格式为 docx（由该源导出），此字段只是编辑器的中间态。
|
||
Content string `orm:"column(content);type(longtext);null" json:"content,omitempty"`
|
||
// IsOnline 是否在线制作（非持久化字段，列表接口按 Content 是否为空计算）
|
||
IsOnline int8 `orm:"-" json:"is_online"`
|
||
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"
|
||
}
|
||
|
||
// 文档分类内置标记常量（is_system）
|
||
const (
|
||
DocCategoryNormal int8 = 0 // 普通分类，租户可自行删除
|
||
DocCategorySystem int8 = 1 // 系统内置分类，任何租户都不可删除
|
||
)
|
||
|
||
// 文档范围（scope）：文档库按「共享文档 / 私密文档」两个空间组织，分类同样按此隔离。
|
||
// 共享空间（shared）：租户级，所有人共用；私密空间（personal）：绑定到用户级别，每人独立一套。
|
||
// 文档侧复用 visibility 字段：personal 对应私密(1)，shared 对应租户公开(0)。
|
||
const (
|
||
DocScopeAll = "all"
|
||
DocScopePersonal = "personal"
|
||
DocScopeShared = "shared"
|
||
)
|
||
|
||
// DocCategoryNameProject 系统内置分类名称：项目文档，只属于共享文档范围。
|
||
// 每个租户首次访问文档接口时自动补建自己那一份（按 tid 隔离），租户之间互不可见。
|
||
const DocCategoryNameProject = "项目文档"
|
||
|
||
// docCategorySystemRemark 内置分类的默认备注
|
||
const docCategorySystemRemark = "系统内置分类，不可删除"
|
||
|
||
// 文档类型常量（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
|
||
}
|
||
|
||
// oaDocDefaultCategoryOnce 记录已完成内置分类补建的租户，避免每次请求重复查库。
|
||
// key 为 tid(int)，value 为 struct{}{}；补建失败时不写缓存，下次请求继续重试。
|
||
var oaDocDefaultCategoryOnce sync.Map
|
||
|
||
// EnsureOaDocDefaultCategories 保证指定租户的系统内置分类齐全（当前为「项目文档」）。
|
||
// 【租户级初始化】新租户首次使用时补建默认业务数据（非表结构/全局预置数据；结构变更须走 docs/sql/ SQL 文件）。
|
||
//
|
||
// 租户隔离：内置分类是真实数据行，每个租户各自持有一份（tid 不同），
|
||
// 首次访问文档接口时自动补建，租户之间互不可见、互不影响。
|
||
//
|
||
// 范围隔离：「项目文档」属于共享文档空间（scope=shared、user_id=0），租户内所有人共用。
|
||
// 私密文档空间不预置内置分类，由用户自行建立自己的文件夹。
|
||
//
|
||
// 「未分类」不落库：它是虚拟分类，文档 category_id = 0 即表示未分类，因此天然不可删除；
|
||
// 同时在 services 层把「未分类」「项目文档」列为保留名，禁止新建同名分类与之混淆。
|
||
//
|
||
// 任何失败均静默忽略，不阻断主流程（与其它租户级初始化保持一致）。
|
||
func EnsureOaDocDefaultCategories(tid int) {
|
||
if Orm == nil || tid <= 0 {
|
||
return
|
||
}
|
||
if _, done := oaDocDefaultCategoryOnce.Load(tid); done {
|
||
return
|
||
}
|
||
if err := ensureOaDocProjectCategory(tid); err == nil {
|
||
oaDocDefaultCategoryOnce.Store(tid, struct{}{})
|
||
}
|
||
}
|
||
|
||
// ensureOaDocProjectCategory 补建租户的「项目文档」内置分类：
|
||
// 1. 已有任意内置分类（is_system=1）：说明租户已初始化过（可能被改名），直接返回；
|
||
// 2. 已有同名普通分类：升级为内置分类，避免出现两个「项目文档」；
|
||
// 3. 都没有：插入一条一级内置分类。
|
||
func ensureOaDocProjectCategory(tid int) error {
|
||
// 「项目文档」为统一租户分类树下的内置分类（scope=shared）
|
||
qs := Orm.QueryTable(new(OaDocCategory)).
|
||
Filter("tid", tid).
|
||
Filter("scope", DocScopeShared)
|
||
|
||
sysCount, err := qs.Filter("is_system", DocCategorySystem).Count()
|
||
if err != nil {
|
||
return err
|
||
}
|
||
if sysCount > 0 {
|
||
return nil
|
||
}
|
||
|
||
var existed []OaDocCategory
|
||
if _, err := qs.Filter("name", DocCategoryNameProject).
|
||
Filter("is_deleted", 0).
|
||
OrderBy("id").Limit(1).All(&existed); err != nil && err != orm.ErrNoRows {
|
||
return err
|
||
}
|
||
if len(existed) > 0 {
|
||
item := existed[0]
|
||
item.IsSystem = DocCategorySystem
|
||
if item.Remark == "" {
|
||
item.Remark = docCategorySystemRemark
|
||
}
|
||
_, err := Orm.Update(&item, "IsSystem", "Remark")
|
||
return err
|
||
}
|
||
|
||
_, err = Orm.Insert(&OaDocCategory{
|
||
Tid: tid,
|
||
ParentID: 0,
|
||
Name: DocCategoryNameProject,
|
||
Sort: 0,
|
||
Remark: docCategorySystemRemark,
|
||
IsSystem: DocCategorySystem,
|
||
Scope: DocScopeShared,
|
||
IsDeleted: 0,
|
||
})
|
||
return err
|
||
}
|