3. JIRA项目配置

缺陷闭环管理的第一步，是在JIRA中建立一个结构清晰、权限分明的缺陷管理项目。本章将手把手带你完成从项目创建、问题类型配置到字段与界面布局的全过程，确保团队在统一的框架下高效协作。

3.1 创建缺陷管理项目

JIRA支持多种项目类型，缺陷管理通常选择“团队管理项目”或“公司管理项目”。对于企业级缺陷闭环，推荐使用公司管理项目以获得更灵活的工作流和权限控制。

创建步骤

1. 登录JIRA → 点击顶部导航栏的“项目” → 选择“创建项目”。
2. 选择项目类型：在“软件项目”分类下选择“缺陷管理”模板（或从空白项目开始）。
3. 填写项目信息：
   • 项目名称：如“产品缺陷管理”
   • 项目键（Key）：如 BUG（用于标识问题编号，如 BUG-101）
   • 项目负责人：选择项目经理或测试负责人
4. 选择访问权限：建议先设为“私有”，后续按团队角色配置。
5. 点击“创建”，系统自动生成项目主页。

3.2 配置问题类型（Issue Types）

缺陷管理项目通常需要三种核心问题类型：Bug（缺陷）、Story（用户故事）和Task（任务）。JIRA默认提供这些类型，但需要根据团队流程进行微调。

问题类型对比

配置步骤

1. 进入项目 → 项目设置 → “问题类型”。
2. 点击“添加问题类型”，从系统方案中选择或创建新的问题类型。
3. 为每个问题类型关联工作流方案（后续章节详述）。
4. 设置问题类型方案：将问题类型与项目绑定。

3.3 设置字段与界面

字段是缺陷信息的载体，界面决定了团队填写和查看缺陷的体验。合理的字段配置能显著提升数据质量和处理效率。

3.3.1 核心字段配置

对于Bug类型，建议配置以下字段（按重要性排序）：

3.3.2 界面布局配置

JIRA的界面方案控制字段在创建、编辑、查看页面上的显示顺序和分组。推荐按以下逻辑分组：

• 基本信息组：摘要、描述、优先级、严重程度
• 分类信息组：模块、标签、版本
• 环境信息组：环境、附件
• 处理信息组：指派给、解决结果、修复版本

3.3.3 字段配置示例代码

如果需要通过JIRA REST API批量创建自定义字段，可以使用以下示例（Python + requests）：

import requests
import json

# JIRA API配置
JIRA_URL = "https://your-domain.atlassian.net"
API_ = "your_api_"
EMAIL = "your_email@example.com"

# 创建自定义字段（严重程度）
def create_custom_field():
    url = f"{JIRA_URL}/rest/api/3/field"
    headers = {
        "Accept": "application/json",
        "Content-Type": "application/json"
    }
    auth = (EMAIL, API_)
    
    payload = {
        "name": "严重程度",
        "description": "缺陷的严重等级",
        "type": "com.atlassian.jira.plugin.system.customfieldtypes:select",
        "searcherKey": "com.atlassian.jira.plugin.system.customfieldtypes:searcher"
    }
    
    response = requests.post(url, json=payload, headers=headers, auth=auth)
    if response.status_code == 201:
        field_id = response.json()["id"]
        print(f"自定义字段创建成功，ID: {field_id}")
        return field_id
    else:
        print(f"创建失败: {response.status_code} - {response.text}")
        return None

# 为字段添加选项（如：致命、严重、一般、轻微）
def add_field_options(field_id):
    url = f"{JIRA_URL}/rest/api/3/field/{field_id}/option"
    headers = {
        "Accept": "application/json",
        "Content-Type": "application/json"
    }
    auth = (EMAIL, API_)
    
    options = ["致命", "严重", "一般", "轻微"]
    for option in options:
        payload = {
            "value": option,
            "disabled": False
        }
        response = requests.post(url, json=payload, headers=headers, auth=auth)
        if response.status_code == 201:
            print(f"选项 '{option}' 添加成功")
        else:
            print(f"选项 '{option}' 添加失败: {response.text}")

if __name__ == "__main__":
    field_id = create_custom_field()
    if field_id:
        add_field_options(field_id)

3.4 最佳实践与避坑指南

字段配置检查清单