# Hướng dẫn sử dụng: Đồng bộ S3 Tự động (Full Flow)
### 1. Giới thiệu chung
Chức năng Auto Sync Full là một quy trình tự động hóa khép kín, giúp đồng bộ hóa nội dung từ kho lưu trữ S3 lên khóa học Moodle. Thay vì phải thực hiện thủ công từng bước, chức năng này sẽ tự động quét cấu trúc S3, tạo Section trên Moodle và đẩy tài liệu vào đúng vị trí chỉ với một lần bấm máy.

### 2. Cách truy cập
1. Truy cập vào module Quản lý Learning Object .
2. Di chuyển vào thư mục (Folder) mà bạn muốn dùng làm nguồn để đồng bộ.
3. Tại thanh Breadcrumb (đường dẫn thư mục) ở phía trên cùng, nhấn vào nút Dropdown Thêm (biểu tượng dấu cộng).
4. Chọn dòng Auto Sync Full (có biểu tượng tia sét màu tím).
### 3. Các tham số đầu vào
Khi cửa sổ (Modal) hiện lên, bạn cần cung cấp 2 thông tin bắt buộc:

- Khóa học (Course) : Nhập ID của khóa học trên hệ thống (Ví dụ: 3195 ).
- Tên Folder trên S3 : Đường dẫn thư mục gốc trên AWS S3 chứa các bài học.
  - Ví dụ: classin/Easy IELTS 25/1. Introduction
  - Lưu ý: Hệ thống sẽ lấy các thư mục con nằm trực tiếp bên trong đường dẫn này để làm cơ sở tạo Section.
### 4. Quy trình hoạt động (3 Bước tự động)
Sau khi nhấn nút Bắt đầu Tự động , hệ thống sẽ thực hiện trình tự sau:
 Bước 1: Tạo Section từ S3
- Hệ thống quét toàn bộ thư mục con trong đường dẫn S3 bạn đã cung cấp.
- Tự động tạo các Section tương ứng trên khóa học Moodle với tên trùng với tên thư mục trên S3. Bước 2: Tạo Mapping (Khớp dữ liệu)
- Hệ thống thực hiện so khớp các thư mục con hiện có trong Folder "Learning Object" (nơi bạn đang đứng) với các Section vừa tạo trên Moodle.
- Nguyên tắc khớp: Dựa trên tên thư mục (không phân biệt chữ hoa, chữ thường).
- Nếu tìm thấy sự trùng khớp, hệ thống sẽ lập danh sách các cặp cần đồng bộ. Bước 3: Đồng bộ nội dung theo đợt (Bulk Sync)
- Hệ thống bắt đầu đẩy các tài liệu (Learning Objects) từ thư mục nội bộ vào Section Moodle tương ứng.
- Cơ chế chạy: Chia thành từng đợt (mỗi đợt 3 thư mục) để đảm bảo hiệu suất và tránh bị nghẽn mạng.
- Giữa mỗi đợt sẽ có khoảng nghỉ 2 giây .
### 5. Theo dõi và Điều khiển
- Thanh tiến trình (Progress Bar): Hiển thị phần trăm hoàn thành của toàn bộ quy trình.
- Log chi tiết: Khung màu đen phía dưới sẽ hiển thị chi tiết từng hoạt động (Thành công/Lỗi) theo thời gian thực.
- Dừng đồng bộ: Bạn có thể nhấn nút Dừng đồng bộ bất cứ lúc nào. Hệ thống sẽ hoàn thành đợt gửi hiện tại rồi dừng lại một cách an toàn.
### 6. Các lưu ý quan trọng
- Đồng nhất tên gọi: Để quá trình Mapping (Bước 2) thành công, tên các thư mục con trong hệ thống Learning Object phải khớp hoàn toàn với tên các thư mục trên S3.
- Kiểm tra trước khi chạy: Đảm bảo Course ID chính xác để tránh việc tạo nhầm Section vào các khóa học khác.
- Xử lý lỗi: Nếu một đợt đồng bộ gặp lỗi, hệ thống sẽ ghi nhận vào mục "Lỗi" nhưng vẫn tiếp tục thực hiện các đợt tiếp theo trừ khi bạn nhấn dừng.
Tài liệu này hỗ trợ người dùng vận hành chức năng đồng bộ hóa tự động một cách hiệu quả và an toàn.