System Roles and Permissions
Different users have different permissions, which depend on their roles and permissions within the organization or project. In public projects and organizations, all logged-in users will enjoy the following permissions:
- Create new issues
- Create pull requests (PRs) in the project
- Post comments (including commenting on issues, PRs, commits, and discussions)
- Clone or download the project code
- View the project wiki pages
- View organization or project discussions
- View the organization's public boards
In addition to the permissions for public projects, there are some features that are not restricted by the permission system:
- The creation of lightweight PRs does not rely on code push permissions. When the project enables lightweight PRs, any platform login user can submit a lightweight PR.
- Protected branches and protected tags follow the enforced protection rules.
System Roles
In GitCode, system roles are divided into the following types:
- Administrator (Owner): An administrator of the organization with full permissions and final decision-making authority.
- Maintainer: A maintainer of the project or organization responsible for daily maintenance tasks such as handling issues and PRs.
- Developer: Writes and submits code, participates in development and discussions.
- Reporter: Reports issues, provides feedback, and participates in project discussions.
- Guest: Browses project permissions, participates in public discussion area discussions.
Organization Administrators
| Resource | Permission | | | | | | | |
|---|
| Organization | Delete | Settings | Update | | | | | |
| Project | Create | Fork | Update | Delete | Settings | Archive | Transfer | |
| Code | Push | Download | | | | | | |
| Members | Invite | Update | Remove | | | | | |
| Issues | Create | Update | Close/Open | Pin | Lock | | | |
| Labels | Create | Update | Delete | | | | | |
| Milestones | Create | Update | Delete | | | | | |
| Branches | Create | Delete | | | | | | |
| Tags | Create | Delete | | | | | | |
| Pull Requests | Create | Update | Review | Approve | Merge | Close | Reopen | Test |
| Comments | Create | Resolve | | | | | | |
| Discussions | Create | Update | Lock | Pin | Close/Open | | | |
| Boards | Create | Update | Delete | Close/Open | | | | |
The highest role for project members is the administrator, and administrator permissions can only be inherited through the organization; they do not support adding "administrator" permissions directly in the project.
- Creators can update the title and description of Issues and PRs and also close or reopen them.
- The author of a comment can edit and update the comment.
- The list of organization and project members can only be viewed by organization and project members.
- Label permissions include both organization labels and project labels.
- Security issues submitted by users can only be viewed by the issue author and project members.
- The permissions for the project wiki are the same as those for pushing code to the project.
- The permissions for project releases are the same as those for project tags.
- Resolving in a comment refers to resolving marked issues in PR code reviews.
Organization/Project Maintainers
| Resource | Permission | | | | | | | |
|---|
| Organization | Settings | | | | | | | |
| Project | Create | Fork | Settings | | | | | |
| Code | Push | Download | | | | | | |
| Members | Invite | Update | Remove | | | | | |
| Issues | Create | Update | Close/Open | Pin | Lock | | | |
| Labels | Create | Update | Delete | | | | | |
| Milestones | Create | Update | Delete | | | | | |
| Branches | Create | Delete | | | | | | |
| Tags | Create | Delete | | | | | | |
| Pull Requests | Create | Update | Review | Approve | Merge | Close | Reopen | Test |
| Comments | Create | Resolve | | | | | | |
| Discussions | Create | Update | Lock | Pin | Close/Open | | | |
| Boards | Create | Update | Delete | Close/Open | | | | |
- The creator of an Issue or PR is allowed to update the title and description of the Issue or PR, and the creator can close or reopen the Issue or PR.
- The author of a comment is allowed to edit and update the comment information.
- The list of organization and project members can only be viewed by organization and project members.
- Label permissions include both organization labels and project labels.
- Security issues submitted by users can only be viewed by the issue author and project members.
- The permissions for the project wiki are consistent with the project code push permissions.
- The permissions for project releases are consistent with the project tag permissions.
- Resolving in a comment refers to resolving marked issues in PR code reviews.
Organization/Project Developers
| Resource | Permission | | | | | | |
|---|
| Project | Create | Fork | | | | | |
| Code | Push | Download | | | | | |
| Issues | Create | Close/Open | | | | | |
| Branches | Create | Delete | | | | | |
| Tags | Create | | | | | | |
| Pull Requests | Create | Review | Merge | Test | Close | | |
| Comments | Create | Resolve | | | | | |
| Discussions | Create | Update | Close/Open | | | | |
| Boards | Create | Update | Close/Open | | | | |
- The creator of an Issue or PR is allowed to update the title and description of the Issue or PR, and the creator can close or reopen the Issue or PR.
- The author of a comment is allowed to edit and update the comment information.
- The list of organization and project members can only be viewed by organization and project members.
- If "Prevent developers from creating tags" is selected, they will not be able to create tags.
- If "Prevent developers from creating branches" is selected, they will not be able to create branches.
- Security issues submitted by users can only be viewed by the issue author and project members.
- The permissions for the project wiki are consistent with the project code push permissions.
- The permissions for project releases are consistent with the project tag permissions.
- Resolving in a comment refers to resolving marked issues in PR code reviews.
Organization/Project Reporters
| Resource | Permission | | | | | | |
|---|
| Project | Fork | | | | | | |
| Code | Download | | | | | | |
| Issues | Create | Close/Open | | | | | |
| Pull Requests | Test | | | | | | |
| Comments | Create | Resolve | | | | | |
| Discussions | Create | Close/Open | | | | | |
- The author of a comment is allowed to edit and update the comment information.
- The list of organization and project members can only be viewed by organization and project members.
- Security issues submitted by users can only be viewed by the issue author and project members.
- Resolving in a comment refers to resolving marked issues in PR code reviews.
Organization/Project Guests
| Resource | Permission | | | | | | |
|---|
| Issues | Create | | | | | | |
| Comments | Create | | | | | | |
| Discussions | Create | | | | | | |
- The author of a comment is allowed to edit and update the comment information.
- The list of organization and project members can only be viewed by organization and project members.
- Security issues submitted by users can only be viewed by the issue author and project members.