APMATHS — Cấu trúc website, Luyện tập và AI-CLO

Ngày 11/10/2026 · Nhánh feature/learning-practice-ai-clo-hubs · Chưa merge vào main. Đây là phạm vi cấu trúc giao diện; không triển khai nghiệp vụ mới, thu phí, dữ liệu hay chuyển tên miền.

Quy ước URL

Đường dẫn	Vai trò	Trạng thái
`/`	Cổng APMATHS, dẫn người học tới Học / Luyện / AI-CLO	Chỉ chỉnh CTA
`/courses/`	Cổng Học Toán: phổ thông, đại học, chủ đề	Làm lại landing; giữ permalink
`/courses/#pho-thong`	Khung cấp/lớp 1–12	Chỉ hiện cấu trúc, chưa hứa có bài
`/courses/#dai-hoc`	Chuyên đề và lớp học theo năm học	Giữ link lịch sử
`/knowledge/`	Thư viện chủ đề kiến thức	Giữ nội dung
`/practice/`	Cổng chọn lối vào luyện tập	Mới, Jekyll
`/ai-clo/practice/`	Rút PDF theo mã môn, không cần tài khoản	Giữ runtime
`/ai-clo/`	Giới thiệu vai trò và luồng AI-CLO	Cải thiện landing
`/ai-clo/app.html`	Đăng nhập ứng dụng AI-CLO	Giữ runtime
`/tools/`, `/games/`, `/blog/`	Các mục nội dung khác	Giữ chức năng

Luồng cho người dùng

Đọc lý thuyết: Trang chủ → Học Toán → phổ thông/đại học/chủ đề.
Rút đề: Trang chủ → Luyện tập → rút PDF → nhập mã môn do giảng viên cung cấp.
Đã có tài khoản: Trang chủ → Luyện tập → đăng nhập AI-CLO.
Giảng viên/quản trị: Trang chủ → AI-CLO → xem vai trò → đăng nhập hệ thống.

Ranh giới kỹ thuật

Jekyll xây dựng trang nội dung. ai-clo/app.html và ai-clo/practice/ vẫn hoạt động bằng JavaScript riêng.
lesson_id ổn định, bài học VI/EN, liên kết tiên quyết thuộc đợt học liệu sau; chưa dựng bài học trống.
Không thay đổi Supabase, Auth/RLS, Edge Functions, giá gói, DNS, canonical hay công cụ con.
Giữ nguyên https://apmaths.github.io/ai-clo/ và https://apmaths.github.io/tools/ cùng mọi đường dẫn con; không đặt redirect.
Nội dung trang mới viết bằng tiếng Việt; các khóa NAV VI/EN không đồng nghĩa đã dịch toàn bộ nội dung.

Kiểm thử trước khi merge

bundle exec jekyll build --trace --destination _site.
Xác minh _site/index.html, _site/courses/index.html, _site/practice/index.html, _site/ai-clo/index.html, _site/ai-clo/practice/index.html.
NAV desktop/mobile; Phổ thông–Đại học–Chủ đề; Luyện tập và AI-CLO.
Sáng/tối, Tab/Escape, 320px không tràn ngang.
/courses/#pho-thong, /courses/#dai-hoc; ô lớp 1–12 không là liên kết giả.
Truy cập rút đề PDF và đăng nhập AI-CLO từ cổng mới. Không chỉnh runtime nghiệp vụ.
Xem Cloudflare Preview và duyệt trước khi merge.

Bước tiếp theo

Chuẩn hóa metadata học liệu, rồi thí điểm Đại số tuyến tính; tích hợp ngân hàng câu hỏi AI-CLO ở đợt riêng.