gongxiangp2/docs/material-access-scope.md

1.9 KiB

素材使用范围

素材在原有素材库中按 accessScope 区分使用范围,适用于全部素材类型。

值 界面名称 使用规则
general 通用素材 沿用原有素材类型、私密与操作权限
operations_g 运营中心 G 专属 整个运营中心 G 及其下属部门共享,组织外账号不可访问

历史记录默认 general。专属素材不设置自动开放期限,也不能叠加个人私密。

组织资格复用正式账号与人员绑定、当前组织任职路径;运营中心 G 绑定 HR 部门编号 911666246。部门改名读取当前节点路径,账号调出或人员离职后不再获得专属资格。上传者、需求运营及管理员身份均不提供组织外访问例外。

上传与编辑提供“使用范围”字段。专属素材的预览、图片、视频派生产物使用本地鉴权存储;列表、搜索、统计、详情、分享、下载、导出、日志和回收站按同一组织范围处理。下载开关、源文件下载和编辑权限继续沿用原有规则。外部 API 与对外通知仅提供通用素材。

性能监控中的素材任务遵循相同范围。上传会话尚未关联素材时,仅上传者和 G 内管理员可查看文件名。

通用素材改为专属时,当前公开存储中的文件先复制到鉴权存储,再一起保存素材、资产及 SKU 地址,最后清理不再引用的公开对象。视频仍在生成预览时,须等待处理结束再更改使用范围。

数据库变更位于 prisma/migrations/20261106110000_material_access_scope/migration.sql。发布时先执行迁移,再整体切换应用版本;旧版本不识别组织范围,回滚前须处理已创建的专属素材。

生产迁移复用 scripts/safe-production-migrate.mjs:备份与隔离恢复验证通过后执行,审计同时核对字段默认值、索引、范围枚举约束及中心内共享约束。