# Tham Khảo Nhanh Jira

*Issues, JQL, workflows, boards, sprints, filters*

> Source: Jira Documentation (support.atlassian.com) · MIT

## Issues

### Loại Issue

| Command | Description |
|---------|-------------|
| `Epic` | Khối công việc lớn; chứa các story |
| `Story` | Tính năng hoặc yêu cầu từ phía người dùng |
| `Task` | Đơn vị công việc (kỹ thuật hoặc phi kỹ thuật) |
| `Bug` | Lỗi hoặc hành vi không mong muốn |
| `Sub-task` | Con của story/task; không thể tồn tại độc lập |

### Trường Issue

| Command | Description |
|---------|-------------|
| `Summary` | Tiêu đề ngắn (bắt buộc) |
| `Description` | Chi tiết, tiêu chí chấp nhận |
| `Assignee` | Người chịu trách nhiệm |
| `Priority` | Highest / High / Medium / Low / Lowest |
| `Labels` | Tag tự do để nhóm |
| `Components` | Phần con của dự án (vd: Backend, UI) |
| `Fix Version` | Bản phát hành issue này nhắm đến |
| `Story Points` | Ước tính công sức (Scrum) |

### Liên Kết Issue

| Command | Description |
|---------|-------------|
| `blocks / is blocked by` | Quan hệ phụ thuộc |
| `clones / is cloned by` | Theo dõi trùng lặp |
| `relates to` | Liên hệ chung |
| `is caused by / causes` | Liên kết nguyên nhân gốc |

## Tìm Kiếm JQL

### Cú Pháp Cơ Bản

```
project = MYPROJ AND status = "In Progress"
assignee = currentUser() AND resolution = Unresolved
priority in (High, Highest) ORDER BY created DESC
```

### Toán Tử

| Command | Description |
|---------|-------------|
| `=` | Khớp chính xác |
| `!=` | Không bằng |
| `in (a, b)` | Khớp bất kỳ trong danh sách |
| `not in (a, b)` | Loại trừ danh sách |
| `~ "text"` | Chứa (tìm kiếm văn bản) |
| `!~ "text"` | Không chứa |
| `is EMPTY` | Trường không có giá trị |
| `is not EMPTY` | Trường có giá trị |
| `> < >= <=` | So sánh (ngày, số) |

### Hàm Ngày

```
created >= -7d                       # last 7 days
due <= endOfWeek()                   # due this week
updated >= startOfMonth()            # updated this month
created >= "2025-01-01"              # since specific date
```

### Mẫu JQL Hữu Ích

```
# Stale issues
status != Done AND updated <= -30d
# My open bugs
assignee = currentUser() AND type = Bug AND resolution = Unresolved
# Sprint scope
sprint in openSprints() AND project = MYPROJ
```

## Workflows

### Workflow Mặc Định

| Command | Description |
|---------|-------------|
| `To Do` | Chưa bắt đầu |
| `In Progress` | Đang thực hiện |
| `Done` | Đã hoàn thành |

### Workflow Mở Rộng

| Command | Description |
|---------|-------------|
| `Open` | Đã tạo, chờ phân loại |
| `In Progress` | Đang tích cực thực hiện |
| `In Review` | Code review hoặc QA |
| `Done` | Đã chấp nhận và đóng |
| `Reopened` | Trả lại từ Done |

### Khái Niệm Workflow

| Command | Description |
|---------|-------------|
| `Status` | Trạng thái hiện tại của issue |
| `Transition` | Chuyển đổi được phép giữa các trạng thái |
| `Condition` | Ai có thể thực hiện chuyển đổi |
| `Validator` | Kiểm tra trước khi chuyển đổi thực thi |
| `Post Function` | Hành động sau chuyển đổi (vd: giao việc) |
| `Resolution` | Lý do đóng issue (Fixed, Won't Do) |

## Boards

### Loại Board

| Command | Description |
|---------|-------------|
| `Scrum Board` | Dựa trên sprint; backlog, lập kế hoạch sprint, velocity |
| `Kanban Board` | Luồng liên tục; giới hạn WIP, không có sprint |

### Cột Board

| Command | Description |
|---------|-------------|
| `Column` | Ánh xạ đến một hoặc nhiều trạng thái |
| `WIP Limit` | Số issue tối đa trong cột (Kanban) |
| `Swimlane` | Nhóm ngang (theo epic, người giao, v.v.) |
| `Quick Filter` | Bộ lọc toggle trên board dựa trên JQL |

### Cấu Hình Board

| Command | Description |
|---------|-------------|
| `Filter` | Query JQL định nghĩa phạm vi board |
| `Estimation` | Story Points hoặc Original Estimate |
| `Card Layout` | Trường hiển thị trên thẻ issue |
| `Card Colors` | Màu theo priority, người giao, query |

## Sprints

### Vòng Đời Sprint

| Command | Description |
|---------|-------------|
| `Create` | Tên + mục tiêu và ngày tùy chọn |
| `Plan` | Kéo issue từ backlog vào sprint |
| `Start` | Thiết lập thời gian (thường 1-4 tuần) |
| `Active` | Nhóm làm việc trên các issue sprint |
| `Complete` | Chuyển mục chưa làm vào backlog hoặc sprint tiếp theo |

### Báo Cáo Sprint

| Command | Description |
|---------|-------------|
| `Burndown Chart` | Công việc còn lại theo thời gian |
| `Sprint Report` | Đã hoàn thành vs chưa hoàn thành |
| `Velocity Chart` | Story points mỗi sprint theo thời gian |
| `Cumulative Flow` | Phân bố trạng thái theo thời gian |

### Sprint JQL

```
sprint in openSprints()              # current sprint
sprint in futureSprints()            # upcoming sprints
sprint = "Sprint 12"                 # specific sprint
sprint in closedSprints() AND resolution = Unresolved
```

## Filters

### Tạo Filters

| Command | Description |
|---------|-------------|
| `Search` | Viết JQL trong tìm kiếm issue |
| `Save As` | Lưu JQL thành filter có tên |
| `Star` | Đánh dấu sao filter để truy cập nhanh |
| `Subscription` | Nhận kết quả filter qua email theo lịch |

### Chia Sẻ & Quyền

| Command | Description |
|---------|-------------|
| `Private` | Chỉ bạn mới thấy filter |
| `Group` | Chia sẻ với nhóm cụ thể |
| `Project` | Chia sẻ với thành viên dự án |
| `Public` | Bất kỳ người dùng đã đăng nhập |
| `Edit Permissions` | Kiểm soát ai có thể sửa filter |

### Dashboards

| Command | Description |
|---------|-------------|
| `Filter Results` | Gadget hiển thị issue từ filter |
| `Pie Chart` | Phân tích theo trường (priority, người giao) |
| `Two Dimensional` | Ma trận X/Y (vd: priority vs trạng thái) |
| `Activity Stream` | Hoạt động dự án gần đây |

## Phím Tắt

### Điều Hướng Toàn Cục

| Command | Description |
|---------|-------------|
| `g then d` | Đến dashboard |
| `g then b` | Đến board |
| `g then i` | Đến tìm kiếm issue |
| `/` | Tìm kiếm nhanh |
| `c` | Tạo issue |
| `?` | Hiển thị phím tắt |

### Xem Issue

| Command | Description |
|---------|-------------|
| `a` | Giao cho tôi |
| `m` | Bình luận |
| `l` | Chỉnh sửa nhãn |
| `e` | Chỉnh sửa issue |
| `j / k` | Issue tiếp theo / trước trong danh sách |
| `o` | Mở issue đã chọn |

### Phím Tắt Board

| Command | Description |
|---------|-------------|
| `1-9` | Chuyển issue đến cột 1-9 |
| `t` | Chuyển đổi chế độ xem chi tiết |
| `n` | Thẻ tiếp theo |
| `p` | Thẻ trước |

## Mẫu Phổ Biến

### Mẫu Báo Cáo Lỗi

| Command | Description |
|---------|-------------|
| `Summary` | [Component] Mô tả ngắn về lỗi |
| `Steps to Reproduce` | Các bước đánh số để tái tạo sự cố |
| `Expected` | Điều gì nên xảy ra |
| `Actual` | Điều gì thực sự xảy ra |
| `Environment` | OS, trình duyệt, phiên bản, v.v. |
| `Severity` | Blocker / Critical / Major / Minor / Trivial |

### Định Dạng Story

```
As a [role],
I want [action],
so that [benefit].
---
Acceptance Criteria:
- [ ] Criterion 1
- [ ] Criterion 2
```

### Thao Tác Hàng Loạt

| Command | Description |
|---------|-------------|
| `Search → Select All` | Chọn issue từ kết quả tìm kiếm |
| `Bulk Change` | Chỉnh sửa, chuyển đổi, hoặc xóa hàng loạt |
| `CSV Export` | Xuất kết quả tìm kiếm để báo cáo |
| `Board drag` | Kéo issue giữa các cột/sprint |