1Khởi tạo / tải trường qua đối tác

Mã vnEdu chỉ có tác dụng khi super-admin mở “Mã vnEdu” cho đối tác ở /platform → Đối tác: bật cho phép và duyệt mã trường này. Mã admin phải là giáo viên của trường trên QLNT (khi Whiteboard bật đồng bộ vnEdu). Gửi lại để gắn mã cho trường / admin đã có.

Máy chủ POC ký JWT HS256 bằng master secret (kid = iss = mã đối tác, aud = vnedu-whiteboard, sống 2 phút, jti mới) và gọi POST /api/platform/partner/provision. Chưa có thì Whiteboard tạo trường + admin và trả mật khẩu một lần; đã có thì không làm gì. Secret không lưu trên máy chủ POC (chỉ nhớ trong tab này). Super-admin cấp secret ở /platform → Đối tác.

2Kết nối và đăng ký LMS với Whiteboard

Mỗi trường một client_id: . Gọi POST /api/admin/lti/platforms bằng token admin của trường; token chỉ nằm ở máy chủ POC.

3Khóa học của trường : người dùng và liên kết

Khóa học = một lớp của trường trên Whiteboard; thành viên = giáo viên phụ trách + học sinh của lớp, userid = vnedu_id (chưa có mã thì wb-<id>). Mã vnEdu của LMS (khối dưới) lấy theo Whiteboard. Liên kết = hoạt động Whiteboard đang giữ cho khóa học này (trống thì giáo viên thêm bằng Deep Linking). Cần đăng nhập quản trị ở mục 2.

Người dùng (userid)Vai tròvnEdu (LMS)Whiteboard ghi nhận

“Whiteboard ghi nhận” lấy từ phản hồi provision / partner launch gần nhất (launch LTI không trả về LMS).

Tiêu đềNguồn

Mở liên kết ở trang Giáo viên hoặc Học sinh với cùng id trường.

Mã vnEdu của LMS: gửi kèm trong launch LTI và partner launch

Mã trường trống = tắt. vnedu_id theo từng userid, dạng gv01=70001, hs01=8L6A01. Launch LTI: Whiteboard chỉ đọc khi super-admin bật “tin cậy claim vnEdu” cho LMS này, và mã trường phải trùng mã Whiteboard đã gắn. Partner launch gửi user.vnedu_id: cần đối tác được cho phép và trường đã có mã trên Whiteboard.

4Sổ điểm (AGS) cập nhật mỗi 3 giây

Cột điểmHọc sinhĐiểm

5Nhật ký trao đổi của trường phía LMS thấy được gì

GiờLoạiSự kiện