Tạo contest ngay trong bài học Contest

Giảng viên giờ có thể thêm bài học Contest và tạo luôn contest riêng tư (private) của bài đó, gồm lịch và danh sách đề, trong cùng một form. Bấm Save (Lưu) một lần là có cả hai, đã liên kết sẵn với nhau.

SP-908 · 19/11/2026

Trạng thái ngày 19/11/2026

Giai đoạn
Code nằm trong PR #734, đang mở, chờ review và CI. Nhánh đã merge main vào ngày 19/11/2026. Chưa lên beta và chưa có trong tag production nào.
Ticket
SP-908, đang In Progress, thuộc epic Drip content and per-student course contests (SP-837).
Ảnh chụp
Mọi ảnh chụp đều lấy từ môi trường local với dữ liệu giả. Khóa học, đề bài và số liệu không có thật. Báo cáo này không có video.

Vì sao cần thay đổi này

Mỗi bài học Contest phải liên kết với một contest riêng tư. Trước đây, giảng viên phải rời khóa học, mở trang Contests, tạo contest riêng tư kèm lịch và đề bài, lưu lại, quay về khóa học, thêm bài học Contest rồi chọn contest đó trong danh sách. Tức là hai form ở hai nơi và hai lần lưu. Giảng viên dễ quên đặt contest thành riêng tư, hoặc không còn nhớ contest nào thuộc bài học nào.

Giờ form bài học Contest tự tạo contest. Cách cũ vẫn dùng được: giảng viên vẫn có thể chọn một contest đã tạo từ trước.

Thay đổi, tóm tắt trong một hình

Bước 1

Thêm bài học Contest

Từ chương, như trước.

Bước 2

Điền một form

Tiêu đề, slug, lịch và đề bài nằm trên cùng một trang.

Bước 3

Bấm Save một lần

Contest riêng tư, đề bài và bài học được tạo cùng lúc.

Bước 4

Xong

Bài học đã nằm trong chương và đã liên kết với contest.

Trước: mở trang Contests, tạo contest, đặt riêng tư, thêm đề, lưu, quay lại khóa học, thêm bài học, chọn contest, lưu. Giờ: thêm bài học, điền form, lưu.

Hướng dẫn từng bước: tạo bài học Contest

Khung màu cam và nhãn đánh số được thêm vào ảnh chụp để chỉ những chỗ cần chú ý. Chúng không có trong ứng dụng.

  1. Thêm bài học Contest vào chương

    Mở khóa học, vào tab Content, bấm Add Lesson (Thêm bài học) dưới chương rồi chọn Contest.

    Menu Add Lesson mở dưới Chapter 1, mục Contest được đánh dấu.
    1 Loại bài học Contest trong menu Add Lesson.
  2. Xem toàn bộ form

    Form bài học Contest mới mở ra với New contest (Contest mới) được chọn sẵn. Mọi thứ contest cần đều nằm trên một trang này, từ trên xuống dưới.

    Form bài học Contest mới còn trống, có năm vùng đánh số: thông tin cơ bản, lựa chọn contest, slug, lịch và danh sách đề.
    1 Tiêu đề và mô tả bài học. 2 New contest hoặc Existing contest (Contest có sẵn). 3 Slug của contest. 4 Lịch. 5 Danh sách đề. Bấm vào ảnh để xem cỡ đầy đủ.
  3. Nhập tiêu đề và mô tả

    Contest dùng luôn tiêu đề và mô tả của bài học, nên bạn chỉ nhập một lần. Slug, phần sẽ nằm trong địa chỉ của contest, được điền tự động theo tiêu đề. Bạn vẫn sửa được slug. Sau khi bạn sửa, slug không đổi theo tiêu đề nữa.

    Đã nhập tiêu đề Week 4 Mini Contest, ô slug hiện week-4-mini-contest.
    Tiêu đề "Week 4 Mini Contest" cho ra slug "week-4-mini-contest". Dòng ghi chú dưới slug cho biết contest là riêng tư, và học viên mở được bài học thì vào thi mà không cần nhập mật khẩu.
  4. Đặt lịch

    Chọn thời điểm contest mở cho học viên. Với On the contest's schedule (Theo lịch của contest), chọn giờ mở đăng ký, giờ bắt đầu, rồi thời lượng. Mỗi ô ngày mở ra một bảng lịch: chọn ngày, nhập giờ, bấm OK. Mọi giờ đều là giờ Việt Nam (UTC+7).

    Bảng chọn ngày, đang chọn 24/11/2026 và giờ 09:00.
    1 Chọn ngày (24/11). 2 Nhập giờ (09:00).
    Lịch với giờ mở đăng ký 24/11/2026 09:00, giờ bắt đầu 28/11/2026 19:00, thời lượng 90 phút và dòng thời gian.
    Đăng ký mở lúc 09:00 ngày 24/11, contest bắt đầu lúc 19:00 ngày 28/11 và kéo dài 90 phút, nên dòng thời gian cho thấy contest kết thúc lúc 20:30 ngày 28/11.

    Với khóa học mà mỗi học viên học theo tiến độ riêng, hãy chọn When the student reaches this lesson (Khi học viên học tới bài này). Khi đó các ô ngày của contest được ẩn đi, chỉ cần nhập thời lượng. Bạn cũng có thể cho đóng sau một số ngày.

    Lịch ở chế độ per-student, chỉ hiện ô số ngày tự đóng và thời lượng 90 phút.
    1 Mỗi học viên có khoảng thời gian làm bài riêng. 2 Tùy chọn: đóng sau N ngày (để trống là không bao giờ đóng). 3 Thời lượng, 90 phút cho mỗi lượt làm bài.
  5. Thêm đề bài

    Tìm trong ngân hàng đề, bấm Add (Thêm) ở kết quả, rồi điền cho từng đề: Baseline (mức điểm số được 0 điểm), Target (mức điểm số được trọn điểm) và Max points (Điểm tối đa). Dùng các mũi tên để đổi thứ tự.

    Tìm đề với từ khóa House, kết quả là House Price Prediction kèm nút Add.
    1 Tìm "House" ra đề House Price Prediction.
    Danh sách đề có ba đề, kèm Baseline, Target và Max points của từng đề.
    Ba đề: House Price Prediction từ 60000 đến 25000, 100 điểm. Customer Churn Forecast từ 0.5 đến 0.9, 100 điểm. Movie Rating Regression từ 1.2 đến 0.8, 150 điểm. Tổng cộng 350 điểm.

    Nếu bạn bấm Save khi chưa thêm đề nào, form dừng lại và báo lỗi. Không có gì được tạo.

    Thông báo lỗi: Add at least one problem before saving (Thêm ít nhất một đề trước khi lưu).
    Thông báo hiện ra khi danh sách đề còn trống.
  6. Bấm Save một lần

    Một lần bấm Save tạo contest riêng tư, gắn đề bài và tạo bài học đã liên kết với contest. Sau đó trang hiện bài học vừa lưu.

    Bài học Week 4 Mini Contest đã lưu trong chương, liên kết với contest Week 4 Mini Contest.
    1 Bài học mới trong Chapter 1. 2 Link tới trang contest và bảng xếp hạng. Chúng bị mờ cho tới khi mở đăng ký vào ngày 24/11, giống mọi contest khác. 3 Bài học đã liên kết với contest mới.

Contest mới trông ra sao

Đây là một contest bình thường. Nó có trên Contests page (trang Contests), và bạn có thể sửa ở đó sau, ví dụ đổi ngày hoặc đổi đề.

Phần tổng quan trong trang sửa contest: Active, Private đã liên kết với bài học, Fixed 90 phút, bắt đầu 28/11/2026 07:00 PM, 3 đề, 0 người đăng ký.
1 Riêng tư, đã liên kết với bài học. 2 3 đề. Kiểu tính giờ là Fixed, 90 phút, bắt đầu 28/11/2026 07:00 PM UTC+7.
Danh sách đề trong trang sửa contest, vẫn ba đề đó với cùng các mức điểm.
Vẫn ba đề đó, cùng thứ tự. Màn hình này hiện số thập phân bằng dấu phẩy (0,5). Trang sửa contest vốn đã hiển thị số như vậy. Giá trị được lưu là 0.5, 0.9, 1.2 và 0.8.

Liên kết với contest đã tạo từ trước

Chọn Existing contest để lấy một contest riêng tư của bạn chưa liên kết với bài học nào khác. Đây là luồng cũ, không thay đổi. Trong bản demo, danh sách trống vì contest riêng tư duy nhất đã được liên kết, nên dòng gợi ý đưa ra link để tạo contest mới.

Đã chọn Existing contest, ô chọn Private contest trống và có dòng gợi ý tạo contest.
1 Chuyển sang Existing contest. 2 Chọn một contest riêng tư bạn đã tạo.

Ai thấy gì

Đối tượngKhi thêm bài học Contest
Tenant admin hoặc giảng viên nội bộThấy New contest (chọn sẵn) và Existing contest.
Các giảng viên khác của khóa họcChỉ thấy danh sách contest có sẵn, như trước. Họ không có quyền tạo contest, nên lựa chọn New contest bị ẩn và server cũng từ chối.
Khi sửa bài học Contest đã lưuChỉ hiện danh sách contest có sẵn. Lựa chọn New contest chỉ có khi tạo bài học.

Vì sao có thể tin cậy

Đã kiểm tra trong database. Sau lần Save ở bước 6, contest được lưu là riêng tư, do admin tạo, mở đăng ký lúc 09:00 và bắt đầu lúc 19:00 UTC+7 (02:00 và 12:00 UTC+0), 90 phút, kiểu tính giờ Fixed. Ba đề được lưu đúng thứ tự, với Baseline, Target và điểm giống trong form. Bài học trỏ tới đúng contest đó.

Đã sửa sau review

Trước khi mở PR, code đã qua hai lượt review (Claude và GPT Sol). Các điểm đã sửa:

Thay đổi kèm theo

PR này cũng gom việc tạo slug của toàn bộ frontend về một hàm dùng chung.

Giới hạn đã biết

Các quyết định đã chốt

Vấn đềLựa chọn
Tạo contest ở đâuNgay trong form bài học Contest. Một lần Save, server tạo tất cả cùng lúc.
Hiện những trường nào của contestMột bộ ngắn: slug, lịch và đề bài. Tiêu đề và mô tả lấy từ bài học, contest luôn riêng tư, phần luyện tập dùng mặc định.
Ai được tạo contest ở đâyKhông đổi: chỉ tenant admin và giảng viên nội bộ.
Lựa chọn mặc địnhNew contest cho người có quyền tạo contest. Những người khác vẫn dùng danh sách contest có sẵn.

Checklist triển khai

  1. Review và merge PR #734. Không cần migration database.
  2. Sau khi merge, trên beta với vai trò tenant admin: thêm một bài học Contest với contest mới và hai đề, lưu, rồi mở contest từ bài học và từ trang Contests.
  3. Làm lại một lần với "When the student reaches this lesson" và kiểm tra rằng học viên mở được.
  4. Chuyển SP-908 sang Testing sau khi lên beta, và sang Done khi đã có trong một tag production.