优化文档相关

go/docs/sql/yz_oa_document.sql

@@ -18,18 +18,40 @@
 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',
+  user_id bigint unsigned NOT NULL DEFAULT 0 COMMENT '分类归属用户：共享空间共享=0（租户级）；私密空间=创建者的 yz_system_tenant_user.uid',
   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_system tinyint NOT NULL DEFAULT 0 COMMENT '是否系统内置分类 0-否(可删除) 1-是(不可删除)',
+  scope varchar(16) NOT NULL DEFAULT 'shared' COMMENT '所属空间 shared-共享文档空间 personal-私密文档空间(绑定用户级别)',
   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)
+  KEY idx_tid_parent (tid, parent_id),
+  KEY idx_tid_scope_user (tid, scope, user_id)
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='OA文档分类表';
 
+-- 1.1 历史库补齐列（特性上线前已建表时执行，已存在则报错可忽略）
+-- ALTER TABLE yz_backend_oa_doc_category
+--   ADD COLUMN is_system tinyint NOT NULL DEFAULT 0 COMMENT '是否系统内置分类 0-否(可删除) 1-是(不可删除)';
+-- ALTER TABLE yz_backend_oa_doc_category
+--   ADD COLUMN scope varchar(16) NOT NULL DEFAULT 'shared' COMMENT '所属空间 shared-共享 personal-私密';
+-- ALTER TABLE yz_backend_oa_doc_category
+--   ADD COLUMN user_id bigint unsigned NOT NULL DEFAULT 0 COMMENT '分类归属用户（私密空间=租户用户 uid）';
+
+-- 1.2 分类归属规则（双空间模型，2026-09 起）：
+--     文档库按「共享文档 / 私密文档」两个空间组织，每个空间各自一棵分类树：
+--       - 共享空间：scope=shared、user_id=0（租户级，全租户共用一套，任何人可建/删，内置分类除外）；
+--       - 私密空间：scope=personal、user_id=当前用户的 yz_system_tenant_user.uid（绑定到用户级别，各用户独立一套）。
+--     文档可见性(OaDoc.visibility)与所在空间一一对应：共享空间→0(租户公开)，私密空间→1(私密，仅创建者与被共享者可见)。
+--     系统内置分类「项目文档」(scope=shared, user_id=0, is_system=1) 属于共享空间，按租户自动补建
+--     （models.EnsureOaDocDefaultCategories），一般无需手工插入。
+--     历史脏数据（scope 不在 shared/personal）在 EnsureOaDocumentTables 中自动归为共享空间（user_id=0, scope=shared）。
+--     说明：「未分类」是虚拟分类，文档 category_id = 0 即表示未分类，两个空间各自独立计算，不落库、不可删除。
+
 -- 2. 文档表
 --    doc_type: 0-其他 1-文档 2-表格 3-演示 4-PDF 5-图片 6-压缩包 7-视频 8-音频
 --    status  : 0-草稿 1-已发布 2-已归档