Question Bank

Ví dụ minh họa theo template chuẩn GitBook SAPP Academy (xem Template.md). Mỗi hành động = {% details summary="[Tên hành động]" %} bọc TRỌN (Kết quả + hint nếu có + {% stepper %} + hint success), đóng {% enddetails %} sau success — KHÔNG dùng heading ### N.. Ảnh ![Caption](screenshots/...) đứng một mình (dòng trống trên/dưới), caption viết vào alt text — KHÔNG dán *italic* dưới ảnh (→ ảnh bé), KHÔNG dùng <figure>; bước chưa có ảnh → <!-- TODO: screenshot -->.

Record of changes

A – Add / M – Modify / D – Delete

Effective Date	Update Person	A,M,D	Change Description	Version
18/05/2026	Lê Xuân Mai	M	Chuẩn hóa nội dung lên GitBook	4.7.0

---

I. Thông tin chung

Thông tin

Dành cho: Admin, SX Đường dẫn: https://ops.sapp.edu.vn/question-bank/item-set?page_index=1&page_size=10

Thông tin

Phạm vi & Module liên quan

• Module chính: Question Bank
• Module liên quan: [Module A], [Module B]
• Hệ thống tích hợp: [Tên hệ thống – nếu có]

Lưu ý

Điều kiện tiên quyết

Đã đăng nhập và được cấp quyền truy cập module Question Bank.

---

II. Hướng dẫn chi tiết

Xem danh sách & chi tiết Item Set

Kết quả: Xem được danh sách Item Set và nội dung chi tiết từng bộ câu hỏi.

Mở tab Item Set

Vào Question Bank → chọn tab Item Set. Danh sách hiển thị với các cột:

Cột	Mô tả
Item Set Name	Tên bộ câu hỏi
Số câu hỏi	Số lượng câu hỏi trong bộ
Created Date	Ngày tạo bộ câu hỏi
Action	Menu thao tác (View / Edit / Delete)

Ảnh chưa có: Màn hình danh sách Item Set screenshots/01-admin-item-set-list.png

(Tùy chọn) Tìm kiếm câu hỏi

Tìm kiếm bằng bộ lọc: Item Set Name, Sort By, From/To Date; bấm Reset để xóa bộ lọc.

Ảnh chưa có: Bộ lọc tìm kiếm Item Set screenshots/02-admin-item-set-filter.png

Mở chi tiết Item Set

Click vào tên Item Set để xem chi tiết nội dung.

Ảnh chưa có: Chi tiết Item Set screenshots/03-admin-item-set-detail.png

Thao tác trong Question List

Tại mục Question List: chọn Create Question để thêm câu hỏi, hoặc chọn Action → Preview để xem trước cách câu hỏi hiển thị với học viên.

Ảnh chưa có: Preview câu hỏi screenshots/04-admin-question-preview.png

Thành công

Thông tin Item Set hiển thị đầy đủ → Xem hoàn tất.

---

Tạo mới Item Set

Kết quả: [Mô tả kết quả tạo thành công]

[Mở form tạo mới]

[Bước 1 — ảnh và kết quả của bước thực hiện nếu có]

[Điền thông tin và xác nhận]

[Bước 2 — ảnh và kết quả của bước thực hiện nếu có]

Thành công

Hệ thống hiển thị "[Thông báo thành công]" → Tạo mới hoàn tất.

---

Chỉnh sửa Item Set

Kết quả: [Mô tả kết quả chỉnh sửa thành công]

[Tìm và mở Item Set cần sửa]

[Bước 1 — ảnh và kết quả của bước thực hiện nếu có]

[Chỉnh sửa và lưu]

[Bước 2 — ảnh và kết quả của bước thực hiện nếu có]

Thành công

Hệ thống hiển thị "[Thông báo thành công]" → Chỉnh sửa hoàn tất.

---

Xóa Item Set

Kết quả: [Mô tả kết quả xóa thành công]

Cảnh báo

[Cảnh báo về tính không thể hoàn tác hoặc điều kiện cần kiểm tra trước khi xóa]

[Tìm Item Set cần xóa]

[Bước 1 — ảnh và kết quả của bước thực hiện nếu có]

[Xóa và xác nhận]

[Bước 2 — ảnh và kết quả của bước thực hiện nếu có]

Thành công

Hệ thống hiển thị "[Thông báo thành công]" → Xóa hoàn tất.

---

III. Lưu Ý & Quy Tắc Nghiệp Vụ

Lưu ý

Lưu ý quan trọng:

1. [Lưu ý 1]
2. [Lưu ý 2]
3. [Lưu ý 3]

Thông tin

Mẹo sử dụng:

1. [Mẹo 1]
2. [Mẹo 2]
3. [Mẹo 3]

---

IV. Các Lỗi Thường Gặp & Cách Xử Lý

Lỗi / Tình huống	Nguyên nhân	Cách xử lý
[Thông báo lỗi A]	[Nguyên nhân]	[Hướng dẫn khắc phục]
Không tìm thấy dữ liệu	Sai bộ lọc	Kiểm tra lại điều kiện tìm kiếm, bấm Reset
[Thông báo lỗi B]	[Nguyên nhân]	[Cách xử lý]