你的应用系统如何设计文件权限模型？

场景一：审批流协作

示例链路：
-> 用户 A 创建并发起协作文档
-> 用户 B 参与编辑
-> 用户 C 仅浏览并有评论 / 批注权限
-> 审批完成后，文件外发给用户 D，自助下载 / 在线预览

一、实现方案

在这个场景中，权限判断由业务系统决定，石墨根据业务系统在文件元信息回调中返回的权限字段执行页面能力控制。

核心原则：

业务系统是权限源。

石墨只根据回调结果控制读、写、评论、复制、导出等能力。

二、最小对象模型

该场景只需要保留 4 类核心对象。

对象	含义
`user`	租户内用户身份，对接石墨时使用 `user.id`
`approval_document`	业务系统中的审批文档记录
`approval_participant`	审批文档参与人及其角色

2.1 审批文档表

status 建议最小化为：

状态	含义
`DRAFT`	草稿，创建人可编辑
`IN_REVIEW`	审批中，编辑者可协作，审阅者可评论
`APPROVED`	审批完成，内部用户通常只读，允许外发
`REJECTED`	审批驳回，可回到编辑状态
`CANCELLED`	已取消，不允许继续访问或编辑

2.2 审批参与人表

role 建议最小化为：

角色	对应用户	含义
`OWNER`	用户 A	创建人 / 发起人
`EDITOR`	用户 B	协作编辑人
`COMMENTER`	用户 C	审阅人，可浏览和评论
`VIEWER`	可选	只读用户

三、各角色权限设计

用户	角色	打开	编辑	评论 / 批注	复制	导出 / 下载	管理
用户 A	`OWNER`	允许	允许	允许	可配置	可配置	允许
用户 B	`EDITOR`	允许	允许	允许	可配置	不建议	不允许
用户 C	`COMMENTER`	允许	不允许	允许	不建议	不建议	不允许
用户 D	外部用户	不允许	不允许	不允许	不允许	不允许	不允许

审批中建议不要允许外部下载，除非业务明确需要。

四、石墨回调权限字段映射

业务系统内部可以使用 role + status 计算权限，最终在文件元信息回调中返回石墨需要的能力字段。

常用字段：

字段	含义
`readable`	是否允许打开文档或预览文件
`editable`	是否允许编辑协同文档
`commentable`	是否允许评论 / 批注
`copyable`	是否允许复制内容
`exportable`	是否允许导出 / 下载
`manageable`	是否允许管理类操作

4.1 审批中示例

用户 B 作为协作编辑人访问审批中文档：

{
  "readable": true,
  "editable": true,
  "commentable": true,
  "copyable": false,
  "exportable": false,
  "manageable": false
}

用户 C 作为审阅人访问审批中文档：

{
  "readable": true,
  "editable": false,
  "commentable": true,
  "copyable": false,
  "exportable": false,
  "manageable": false
}

4.2 审批完成后示例

审批完成后，用户 B 再次访问同一份文档：

{
  "readable": true,
  "editable": false,
  "commentable": false,
  "copyable": false,
  "exportable": true,
  "manageable": false
}

外发用户 D 在线预览：

{
  "readable": true,
  "editable": false,
  "commentable": false,
  "copyable": false,
  "exportable": true,
  "manageable": false
}

如果外发链接只允许在线预览，不允许下载，则返回：

{
  "readable": true,
  "editable": false,
  "commentable": false,
  "copyable": false,
  "exportable": false,
  "manageable": false
}

五、关键边界规则

审批完成如何实现任何人不能编辑文档的效果？

创建审批、审批进行过程中，文档点击入口可以通过石墨文档中台前端 JSSDK connect() 访问，这样可以根据使用用户的权限来实现可编辑、可评论、可预览的功能。

审批完成后，文档需要保持静止不能做任何更新（即使有编辑权限也不行）。此时你的系统的文档点击入口可以调整为石墨文档中台预览入口，即 /page/iframe 路由即可。

你的应用系统如何设计文件权限模型？

场景一：审批流协作#

一、实现方案#

二、最小对象模型#

2.1 审批文档表#

2.2 审批参与人表#

三、各角色权限设计#

四、石墨回调权限字段映射#

4.1 审批中示例#

4.2 审批完成后示例#

五、关键边界规则#

审批完成如何实现任何人不能编辑文档的效果？#