APMATHS — Quy tắc chuyển tên miền và giữ khu vực legacy
Cập nhật: 2026-10-12. Đã chuẩn bị canonical/sitemap trên nhánh repo Private, nhưng chưa bật chuyển hướng hoặc thay DNS/repo Public.
1. Quyết định đã chốt
- Website chính mới:
https://apmaths.io.vn(APMatHS/apmaths.io.vn). - Website cũ:
https://apmaths.github.io(APMatHS/apmaths.github.io). - Về sau, chuyển khách truy cập phần nội dung APMATHS cũ sang tên miền mới; ưu tiên bảo toàn đường dẫn nếu có trang tương ứng.
- Ngoại lệ bắt buộc, giữ nguyên trên miền cũ:
https://apmaths.github.io/ai-clo/cùng tất cả trang/đường dẫn con, ví dụ/ai-clo/app.html,/ai-clo/practice/;https://apmaths.github.io/tools/cùng tất cả công cụ/trang/đường dẫn con.
Không coi việc người dùng có thể truy cập /ai-clo/ hoặc /tools/ ở tên miền mới là lý do xóa/chuyển hướng URL cũ. Tạm giữ hai khu vực cũ chạy độc lập đến khi chủ sở hữu quyết định khác.
2. Những thứ nhất thiết không được vô tình chuyển hướng/xóa
- Tất cả đường dẫn con của
/ai-clo/và/tools/, cả link sâu, query string/hash nếu có. - Các tài nguyên mà các trang legacy cần tải: CSS/JS/ảnh/font/thư viện từ thư mục dùng chung như
/assets/,/css/,/js/; API/config phụ thuộc; tệp tĩnh/manifest liên quan. - GitHub Pages/Jekyll hiện hữu ở repository Public; không xóa mã nguồn hoặc thay config backend chỉ để thực hiện redirect.
- URL đang được chia sẻ cho người học và giảng viên; phải thử cả tải trang trực tiếp, đăng nhập, upload, form và liên kết đi/đến.
Không cài redirect toàn site bằng một script chung chạy trên mọi trang nếu chưa loại trừ legacy và các tài nguyên phụ thuộc. Không đặt redirect ở _layouts/head chung làm /ai-clo/ và /tools/ bị ảnh hưởng.
3. Kế hoạch chuyển theo từng bước (chưa thực hiện)
- Kết nối Cloudflare Pages mới với repository Private và kiểm tra bản
*.pages.dev. - Hoàn thiện
apmaths.io.vn, SEO/canonical, cấu hình Auth allowed URLs, liên kết nội bộ,sitemap.xml,robots.txt. - Lập bảng URL cũ → URL mới. Những URL nội dung không có đích phù hợp sẽ xử lý riêng, không tự chuyển đến trang chủ một cách mù quáng.
- Kiểm tra
/ai-clo/,/tools/và mọi tài nguyên phụ thuộc ở domain GitHub Pages cũ. - Khi được đồng ý, chuyển hướng riêng phần nội dung công khai (ưu tiên trang chủ
/trước), giữ ngoại lệ legacy tuyệt đối. - Test đường dẫn sâu, query/hash, mobile, trình duyệt, login, API, download, SEO rồi mới mở rộng.
Lưu ý GitHub Pages
GitHub Pages không cung cấp bộ quy tắc HTTP 301 tùy biến linh hoạt giống một reverse proxy. Nếu vẫn phục vụ trực tiếp trên *.github.io, có thể phải dùng redirect tĩnh theo từng trang (ví dụ Jekyll/HTML) hoặc thay đổi chiến lược lưu lượng phù hợp. Không khẳng định đã cấu hình 301. Phải lựa chọn và kiểm tra cách thực hiện trước khi triển khai.
4. Ma trận kiểm tra dự kiến
| URL cũ | Hành vi mục tiêu |
|---|---|
https://apmaths.github.io/ |
Chuyển sang https://apmaths.io.vn/ sau khi site mới đạt yêu cầu |
https://apmaths.github.io/knowledge/... |
Chuyển sang URL nội dung mới tương ứng sau khi xác minh mapping |
https://apmaths.github.io/courses/... |
Xử lý theo bảng ánh xạ, giữ truy cập hợp lệ cho các lớp đang dùng |
https://apmaths.github.io/ai-clo/ |
Giữ nguyên |
https://apmaths.github.io/ai-clo/app.html |
Giữ nguyên |
https://apmaths.github.io/ai-clo/practice/ |
Giữ nguyên |
https://apmaths.github.io/tools/ |
Giữ nguyên |
https://apmaths.github.io/tools/z3/ |
Giữ nguyên |
| Các asset legacy còn dùng | Tiếp tục phục vụ từ miền cũ cho đến khi không còn phụ thuộc |
5. Trạng thái hiện tại
- Chốt định hướng tên miền chính và hai ngoại lệ
/ai-clo/,/tools/. - Sao chép repository APMATHS sang Private và giữ Public cũ.
- Cloudflare Pages mới đã kết nối và build Jekyll thành công theo xác nhận vận hành trước đó; chưa nghiệm thu E2E toàn site.
- Stage canonical website mới về
https://apmaths.io.vn, robots/sitemap sinh từ Jekyll; cần xác minh DNS và SEO thực tế sau deploy. - Chốt URL mapping chi tiết và giải pháp redirect.
- Thực hiện redirect trên repository Public sau khi được yêu cầu.
- Xác minh không ảnh hưởng hai khu vực legacy.