权限

QFieldCloud通过工程合作者、组织成员和组织团队的概念，提供了对工程的细粒度访问控制。

参与者

1. 未注册用户。
2. 初级注册用户，既不是有关工程的合作者，也不是有关组织的成员，更不是相关用户。
3. 相关工程的工程所有者，即相关用户，但不是合作者或组织成员。
4. 相关工程的工程合作者角色管理员。
5. 相关工程的工程合作者角色经理。
6. 相关工程的工程合作者角色编辑。
7. 相关工程的工程合作者角色报告人。
8. 相关工程的工程合作者角色读者。
9. 相关组织的组织所有者，拥有相关工程或属于用户的组织。
10. 相关组织的组织成员角色管理员，拥有相关工程或属于用户的组织。
11. 相关组织的组织成员角色成员，拥有相关工程或属于用户的组织。

动作

• ❌ 不允许
• ✅ 允许
• ‒ 无关

Action	1	2	3	4	5	6	7	8	9	10	11
List/query project's collaborator roles	❌	✅	‒	‒	‒	‒	‒	‒	‒	‒	‒
Create project's collaborator (i.e. define new collaborator)	❌	❌	✅	✅	✅	❌	❌	❌	✅	✅	❌
Update project's collaborator's info (i.e. role)	❌	❌	✅	✅	✅	❌	❌	❌	✅	✅	❌
Delete project's collaborator (i.e. remove user as collaborator)	❌	❌	✅	✅	✅	❌	❌	❌	✅	✅	❌
List organization's members	❌	✅	‒	‒	‒	‒	‒	‒	✅	✅	✅
Create organization's member (i.e. define a new member)	❌	❌	‒	‒	‒	‒	‒	‒	✅	✅	❌
Get organization's member info (i.e. role)	❌	✅	‒	‒	‒	‒	‒	‒	✅	✅	✅
Update organization's member info (i.e. role)	❌	❌	‒	‒	‒	‒	‒	‒	✅	✅	❌
Delete organization's member info (i.e. remove user as organization's member)	❌	❌	‒	‒	‒	‒	‒	‒	✅	✅	❌
List/query public projects	❌	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅
List/query private projects	❌	❌	✅	✅	✅	✅	✅	✅	✅	✅	❌
Update project's info	❌	❌	✅	✅	❌	❌	❌	❌	✅	✅	❌
Create a project	❌	✅	‒	‒	‒	‒	‒	‒	✅	✅	❌
Delete project	❌	❌	✅	❌	❌	❌	❌	❌	✅	✅	❌
Add deltafile	❌	❌	✅	✅	✅	✅	✅	❌	✅	✅	❌
List project's deltafiles	❌	❌	✅	✅	✅	✅	✅	❌	✅	✅	❌
Get deltafile's status	❌	❌	✅	✅	✅	✅	✅	❌	✅	✅	❌
List project's files (qfieldsync)	❌	❌	✅	✅	✅	✅	✅	✅	✅	✅	❌
Download project's files (qfieldsync)	❌	❌	✅	✅	✅	✅	✅	✅	✅	✅	❌
Upload project's files (qfieldsync)	❌	❌	✅	✅	✅	✅	✅	❌	✅	✅	❌
Delete project's files (qfieldsync)	❌	❌	✅	✅	✅	✅	✅	❌	✅	✅	❌
List project's files (qfield)	❌	❌	✅	✅	✅	✅	✅	✅	✅	✅	❌
Download project's files (qfield)	❌	❌	✅	✅	✅	✅	✅	✅	✅	✅	❌
List users and organizations	❌	✅	‒	‒	‒	‒	‒	‒	‒	‒	‒
Get user's public information	❌	✅	‒	‒	‒	‒	‒	‒	‒	‒	‒
Get user's detailed information	❌	❌	‒	‒	‒	‒	‒	‒	✅	✅	❌
Update user's information	❌	❌	✅	‒	‒	‒	‒	‒	❌	❌	❌
Delete user	❌	❌	✅	‒	‒	‒	‒	‒	❌	❌	❌
Get API status	✅	✅	‒	‒	‒	‒	‒	‒	‒	‒	‒
Add and remove secrets	‒	❌	❌	✅	❌	❌	❌	❌	‒	‒	‒

角色

工程合作者

普通用户工程的合作者只能是报告人或读者。编辑或经理只能设置为组织的工程。

角色

较高的角色总是包含较低角色的权限

名称	说明
管理员 - admin	重命名或删除工程。与工程所有者享有相同的权利，但所有权转让除外。
经理 - manager	可以添加或删除合作者。
编辑 - editor	可以编辑数据
报告人 - reporter	只能插入数据 (不能更新或删除)。
读者 - reader	可以读取数据。

组织成员

角色

较高的角色总是包含较低的角色

名称	说明
管理员 - admin	可以添加和移除成员并创建工程
成员 - member	(与其他用户相比仅是计费原因的差异)