Hanzii LMS Laravel – Quản Lý Trung Tâm Tiếng Trung

## Giới thiệu chung

**Hanzii** (thương hiệu vận hành: *Trung tâm tiếng Trung Lý Thú*) là hệ thống website quản lý và học tập trực tuyến dành cho trung tâm đào tạo tiếng Trung. Dự án chuyển đổi bài tập HSK từ giáo trình giấy lên nền tảng số, giúp học viên làm bài, nộp bài và theo dõi kết quả ngay trên hệ thống.

**Đối tượng sử dụng:**

- Trung tâm / cơ sở đào tạo tiếng Trung cần số hóa vận hành

- Học viên luyện thi HSK hoặc học giao tiếp / thương mại

- Giáo viên và trợ giảng quản lý lớp, bài tập, phản hồi học viên

- Sinh viên làm đồ án / khóa luận tốt nghiệp ngành CNTT

**Danh mục khóa học hỗ trợ:** HSK sơ cấp (1–2), trung cấp (3–4), cao cấp (5–6), tiếng Trung giao tiếp, tiếng Trung thương mại — kèm hình thức học **online** (Meet/Zoom) hoặc **offline** tại trung tâm.

---

## Các tính năng nổi bật

### Phía Client – Học viên

- Đăng nhập tài khoản do trung tâm cấp, đổi mật khẩu và cập nhật hồ sơ

- Tham gia lớp bằng **mã lớp**, gửi yêu cầu join chờ duyệt

- Xem thông tin lớp: lịch học, giáo viên, trợ giảng, hình thức online/offline

- Học theo bài (nội dung / video), làm bài tập và nộp bài

- Tải tài liệu bổ trợ do giáo viên/admin đăng

- Xem điểm, lịch sử làm bài; bình luận hỏi đáp với GV/TG

- Nhận thông báo hệ thống (notifications)

### Phía Giáo viên

- Dashboard lớp được phân công, danh sách học viên

- Thêm/xóa học viên, xác nhận yêu cầu tham gia lớp

- Quản lý bài học, bài tập; upload tài liệu bổ trợ

- Chấm bài (đặc biệt bài tự luận), yêu cầu nộp lại

- Phản hồi bình luận của học viên

### Phía Trợ giảng

- Xem lớp, học viên, bài tập và bài nộp (hỗ trợ theo dõi)

- Trả lời bình luận / giải đáp thắc mắc học viên

- Quản lý thông tin cá nhân

### Phía Admin (Quản trị)

- Dashboard thống kê tổng quan

- CRUD **khóa học**, **lớp học** (mã lớp, GV, TG, sức chứa, lịch, online/offline)

- Quản lý người dùng: Admin / Giáo viên / Trợ giảng / Học viên

- Quản lý bài học & tài liệu bổ trợ theo khóa/lớp

- Quản lý **thanh toán học phí** (đóng 1 lần khi ghi danh)

- Quản lý **thanh toán lương** giáo viên (~40%) và trợ giảng (~15%) sau khi kết thúc khóa

- Xuất Excel danh sách lớp (Maatwebsite Excel)

- Quản lý liên hệ từ landing page, gửi email phản hồi

- Đăng thông báo / thông báo theo lớp

### Landing công khai

- Trang chủ giới thiệu trung tâm, lợi thế giảng dạy HSK

- Form liên hệ tư vấn khóa học

- Đăng ký / đăng nhập / quên mật khẩu

---

## Công nghệ & Cơ sở dữ liệu

| Thành phần | Công nghệ |

|---|---|

| Backend | PHP 8.1+, **Laravel 10** |

| Auth API | Laravel Sanctum |

| Frontend | Blade, **Vite 4**, **Tailwind CSS 3**, Axios |

| Thư viện | Guzzle, Maatwebsite Excel, CKEditor (upload ảnh) |

| Database | **MySQL 8** |

| Hạ tầng | Docker (PHP-FPM, Nginx, MySQL, phpMyAdmin), hỗ trợ Laragon |

| Vai trò | `admin`, `giao_vien`, `tro_giang`, `hoc_vien` |

**Các thực thể chính trong DB:** `nguoi_dungs`, `vai_tros`, `khoa_hocs`, `lop_hocs`, `bai_hocs`, `bai_taps`, `bai_tap_da_nops`, `tai_lieu_bo_tros`, `dang_ky_hocs`, `yeu_cau_tham_gia`, `tien_do_bai_hocs`, `thanh_toan_hoc_phis`, `thanh_toan_luongs`, `lien_hes`, `thong_baos`, `binh_luans`…

---

## Cấu trúc thư mục & Cài đặt

### Cấu trúc chính