JIRA: commercial bug track system

official user guide: https://confluence.atlassian.com/display/JIRA/JIRA+101


* 安装： 下载exe后运行，一路next即可。装好后(by default) jira url is http://xxxxx:8080
   > 安装过程中，会创建一个admin account
   > 安装好后，admin第一次login，会popup a window 让你create a project


* create a project
之后如果想create new project，需要
1. use admin to login, Click the "Administration" link at the top-right of the browser
2. Select Projects > Projects
3. Click Add Project
4. in the popup window, input "Name", "Key" and "Project Lead" （即project leader username)


* add a user
1. use admin to login, Click the "Administration" link at the top-right of the browser
2. Select Users > Users from the top menu, then click Create User.
3. when user is created, you can enroll the user to group.


* Creating an issue
1. Click the 'Create Issue' link in the top navigation-bar.
2. Select the relevant Project and Issue Type, then click the 'Next' button.
3. Type a short description of the issue in the 'Summary' field, then click the 'Create' button.


* set user sign up mode (public - Any user can sign up and post issues.   private - Only administrators can create new users.)
1. use admin to login, Click the "Administration" link at the top-right of the browser
2. Select System > General Configuration
3. click "Edit Configuration" at the bottom of page

4. set "Mode" as private

JiRA terms: user, group, project role, permission, permission scheme
User: 不解释

Group: a set of User. 只有jira system admin (in jira-administrators group）才可以manage group，每个project的admin是不能manage group的。安装好jira之后，by default，
有3个groups: jira-administrators|jira-developers|jira-users
知识点：
* 当admin create a user时，该user就会被自动加入jira-users group里。
* 如果你把user从jira-users group里删除，而且该user又不是该user就无法login system了。这是因为在"JIRA administration > Users > Global Permissions"里，你会看到"JIRA Users" permission映射到jira-user group。User必须有JIRA System Administrators/JIRA Administrators/JIRA Users的任何一个permission才可以login。
* project permission既可以映射到project role，还可以映射到group or user上。但JIRA global permission，它只能映射到group上！
* 每个user可以加到多个group里
* by default, 添加的user是不在jira-developers group里，如果该user仅仅属于jira-users group，而你又把该user设置为某个project的project lead，那么"Default Assignee"就会出现红色的warning: User not assignable。 如果你把该user添加到jira-developers group里，warning就会消失。具体原因见下面的permission。

Role: 每个role可以映射到一个或多个group，也可以映射到一个或多个user，还可以映射到group and user混合！
知识点：
* 只有jira system admin (in jira-administrators group）才可以add/edit/del project role，每个project的projet admin只能够manage 该proejct的 role里的user/group.
* 创建的所有roles会使用在所有的project里。project admin不可以说我不想要某个role，or我要disable某个role。
* 当admin创建project后，该project的每个project role会包含default members(group/user)，那么project admin可以在此基础上添加/删除role映射的user/group
* 尽管permission可以和role/group/user进行映射，但default project permission scheme里采取了permission与role进行映射。
* 用group也可以和permission进行映射，为什么还要用role? 例子： 我们只希望user A只是project A的admin，而不是所有projects的admin，因此我们不能把user A添加到jira-administrators group里，因为这样会成为所有project的admin。我们又不希望专门为user A来创建一个group，还要专门为该group来设置permission，这会很麻烦！因为每个project都要为该project admin做一次这样动作。这个case使用role就最能体现它的好处！我们只需要在project A > people > ”Administrators" project role添加user A即可！这样project A的admin包含jira-administrators group and user A.
* by default, 所有user都在jira-users group里，而jira-users group又是"Users project role”的default member，因此任何一个user by default是可以看到所有的projects。那么如何
使得user只可以access某些project? 一个简单的方法就是在"JIRA administration > Users > roles > Manage Default Members of "users" role"里把jira-users group删除掉！然后
在创建了project之后，再往"users" project role里添加group/user。

JIRA group与role的其中一个不同之处是：group is made up of JIRA users and can only be changed by JIRA administrators. JIRA project roles are made up of JIRA users and JIRA groups and can be changed per project by project administrators.

Permission: 顾名思义，就是某个feature的permission。
知识点：
* 分2类permissions: 一类是global permissions，在"Administration > Users > global permissions“。这些permission是system level的，而不是针对project level的permission。另一类是project permissions: 通过project level permission的设置，同一个user在不同的project可以设置不同的permission。
* global permissions是映射到group，而project permission是映射到project role上
* permission items (不管是global permissions or permissions in scheme)是set死了的，即使是jira admin，也不可以添加/删除/修改 permission，只可以设置permission与role/group/user的映射！

Permission Scheme: a set of permission configurations.

知识点：

＊Permission Scheme是project level的。by default, jira system有一个"default ",当admin create a project时，该project会使用这个default permission scheme。该default permission scheme是不能够删除的。admin也可以添加新的permission scheme, 添加之后，就可以在project里选择不是default的permission scheme.

＊ 只有system admin才可以manage permission scheme，注意：permission items (不管是global permissions or permissions in scheme)是set死了的，即使是jira admin，也不可以添加/删除/修改 permission，只可以设置permission与role/group/user的映射！

＊ permission scheme包括几个category permission： project permissions, issue permission等

安装好JIRA后，by default的group/project role/permission/scheme
default group: jira-administrators, jira-developers, jira-users
default project role: Administrators, Developers, Users. by default, 你在"Administration > Users > Roles > 每个role的Manage Default Members"里，可以看到
Administrators project role映射到jira-administrators group上, Developers project role映射到jira-developers group上, Users project role映射到jira-users group上。 也就是说对每个project来说，by default就有这3个role，而这3个role by default会对应一个group.当然这只是缺省设置，每个project可以修改role与group/user的映射！
default global permissions: 在"Administration > Users > global permissions“可以看到具体设置。
default permission scheme: 这是project default permission scheme. 在"Administration > Issues > Roles > Permission Scheme"里可以看到。注意：你看到default permission scheme里的所有permissions都是映射到role上