#文档级邀请

#设计意图

传统文档协作需要先注册账户、加入团队、然后才能编辑——门槛太高。mdocs 的邀请机制只针对「文档」这个最小粒度，且被邀请者不需要预先注册。

#工作流程

文档所有者 → 添加受邀者（填写对方的访客 ID）→ 选择权限 → 受邀者刷新后即可访问

邀请记录存储在数据库中，关联了文档 ID、访客 ID 和权限等级。

#权限等级

#设计要点

1. 基于访客 ID，而非邮箱：mdocs 没有用户账户系统，所以邀请的载体是访客 ID——每个浏览器注册后获得的唯一标识
2. 文档级粒度：不是整个工作空间或整个项目，而是单篇文档。适合「这篇文档需要给某人看一下」的场景
3. 与档位解耦：邀请不是权限档位——它独立于文档的五级权限（0～4）之上。任何档位的文档都可以叠加 invite，不受限制
4. 所有者和受邀者的关系在数据库中存储：

document_invites 表
├── document_id    → 文档 ID
├── visitor_id     → 被邀请的访客 ID
└── permission     → "read" 或 "edit"

邀请仅由文档所有者管理。所有者可以随时撤销邀请。

#与工作空间成员互斥

一条重要约束：已是某工作空间成员的人，不能再被该工作空间内文档邀请。工作空间成员已经拥有工作空间内文档的读/写权限（取决于档位），invite 是给工作空间外人员的通道。

• restricted（受限）：工作空间成员直接走 domain_read(1) / domain_write(2) 档位语义，不需要也不应该被 invite
• private（个人）：工作空间内仅有创建者一人，实际效果相同——无法 invite 创建者
• public（公开）：公开工作空间没有成员名单，invite 不会因此被拦截

#invite 在各工作空间类型中的角色