# Cập nhật Status trong Function List

> Áp dụng cho: `create-spec` (BA), `[DEV] 5-Gate Development Workflow`, `create-testcase` (QA), `[TESTER] 4-Gate Testing Workflow`, `[EXECUTE] Executing Flow`, skill `function-breakdown`.
> File: `AK-Docs/00.Project-Overview/Function-List.md` — bảng `F-ID | Feature Name | BA | Dev | Tester | Status | Tickets | Link Spec`.

PM / TechLead đọc `Function-List.md` để biết mỗi chức năng đang ở đâu. File chỉ đúng khi mỗi workflow tự cập nhật dòng của mình ở đúng mốc dưới đây — không workflow nào được bỏ qua bước này.

## 1. Định dạng cột Status

Cột `Status` ghi tiến độ của **cả 3 vai trò** trong một ô, theo đúng thứ tự BA → Dev → QA:

```
BA ✅ · Dev 🔵 · QA ⬜
```

| Ký hiệu | Nghĩa |
|---|---|
| ⬜ | Vai trò này chưa bắt đầu |
| 🔵 | Đang làm |
| ✅ | Đã xong |

Chức năng hoàn thành khi cả 3 vai trò là ✅. Không thêm chữ nào khác vào ô (`In Progress`, `Done`...).

## 2. Mốc cập nhật

| Workflow | Mốc | Cập nhật |
|---|---|---|
| `function-breakdown` | Human duyệt Function List | Thêm dòng mới: `BA 🔵 · Dev ⬜ · QA ⬜` |
| `create-spec` | Gate 1 APPROVED | `BA 🔵`. Điền cột `BA` nếu đang trống |
| `create-spec` | Gate 4 APPROVED | `BA ✅`. Cột `Link Spec` trỏ tới UC Spec bản mới nhất: `[UC-Spec_v{N}](../02.BA-Specs/04.UC-Specs/[functionId]/UC-Spec_v{N}.md)` |
| DEV 5-Gate (`feature`, `bug-fix`, `refactor`) | Gate 1 APPROVED | `Dev 🔵` (kể cả khi đang ✅ — ticket mới mở lại phần Dev). Thêm `[ticketId]` vào cột `Tickets` nếu chưa có. Điền cột `Dev` nếu đang trống |
| DEV 5-Gate | Gate 5 xong | Hỏi DEV **một câu**: "Còn ticket Dev nào của `[functionId]` chưa xong không?" → Không còn: `Dev ✅`. Còn: giữ `Dev 🔵` |
| `create-testcase`, TESTER 4-Gate, EXECUTE | Gate 1 APPROVED | `QA 🔵`. Điền cột `Tester` nếu đang trống |
| TESTER 4-Gate, EXECUTE | Gate 4 APPROVED với quyết định **GO** (hoặc Conditional go) | `QA ✅` |
| TESTER 4-Gate, EXECUTE | Gate 4 `NO-GO` | Giữ `QA 🔵` |

`create-testcase` Gate 4 APPROVED **không** đổi sang `QA ✅`: bộ test case xong nhưng chưa chạy. `QA ✅` chỉ có sau khi chạy test và sign-off.

`DEV` với `taskType` `investigation` / `documentation`, `gen-doc`, `ingest-data` không cập nhật Function List.

## 3. Cách sửa dòng

1. Tìm dòng theo `functionId`: cột `F-ID` bằng phần trước dấu `_` đầu tiên của `functionId` (`F-001_Leave-Request` → `F-001`), hoặc cột `Feature Name` có chứa `functionId`. `functionId` không theo dạng `F-xxx` (ví dụ `AD06`) → so cả chuỗi.
2. **Chỉ sửa ký hiệu của vai trò mình** trong ô `Status`; ký hiệu của 2 vai trò kia giữ nguyên. Chỉ sửa thêm cột `Tickets`, `Link Spec` và cột người phụ trách của vai trò mình theo bảng ở mục 2 — không đụng cột khác, không đụng dòng khác.
3. Ô `Status` còn giá trị cũ (`Not Started`, `In Progress`, `Done`, `🔵 BA: đang phân tích`...) → đổi sang định dạng mục 1. Suy từng vai trò từ tài liệu đã có trong `AK-Docs/`: có UC Spec trong `02.BA-Specs/04.UC-Specs/[functionId]/` → `BA ✅`; có dòng của functionId trong `04.Coding/00.Overview/_Index.md` → `Dev 🔵` (mọi ticket đã Gate 5 thì hỏi DEV như mục 2); có test report sign-off GO trong `03.Testing/02.Reports/` → `QA ✅`, chỉ có test case → `QA 🔵`; không có gì → ⬜. Không suy ra được → hỏi người dùng, không đoán.
4. Không tìm thấy dòng → thêm dòng mới (`F-ID`, `Feature Name` kèm `functionId` trong backtick, vai trò mình theo mục 2, 2 vai trò kia ⬜) và báo người dùng: "Function List chưa có `[functionId]`, đã thêm dòng mới — PM kiểm tra lại tên chức năng."
5. File `Function-List.md` chưa tồn tại → **không tự tạo**, chỉ cảnh báo người dùng và đi tiếp.
6. Thay đổi đi chung commit / Merge Request AK-Docs của gate đang chạy, không mở MR riêng.

## 4. Xử lý conflict

Các vai trò làm song song trên các branch AK-Docs khác nhau nên dòng của cùng một chức năng dễ conflict khi merge. Cách gộp: lấy ký hiệu BA từ phía có thay đổi BA, ký hiệu Dev từ phía có thay đổi Dev, ký hiệu QA từ phía có thay đổi QA; cột `Tickets` lấy hợp của 2 phía; các cột còn lại lấy phía mới hơn.
