TOEIC MASTER – Frontend Admin

📌 Giới thiệu

Toeic Master Frontend Admin là giao diện quản trị dành cho quản trị viên hệ thống, hỗ trợ quản lý người dùng, nội dung học tập, đề thi TOEIC và theo dõi thống kê hệ thống.

Frontend Admin giao tiếp với Toeic Master Backend API để thực hiện các chức năng quản trị và xử lý dữ liệu.

---

👨‍🎓 Nhóm sinh viên thực hiện

• Dương Khánh Nguyên – 22110383
• Nguyễn Nhật Nguyên – 22110384

---

📝 Ghi chú

Dự án được xây dựng phục vụ mục đích học tập và báo cáo môn học.

---

🌐 Link deploy

🔗 https://admin-toeicmaster.onrender.com

---

🛠️ Công nghệ sử dụng

• React 18
• Vite
• React Router DOM
• Axios
• Tailwind CSS
• Chart.js
• Socket.IO Client
• Framer Motion
• Google OAuth

---

📦 Thư viện chính

• react, react-dom
• react-router-dom
• axios
• tailwindcss
• socket.io-client
• chart.js, react-chartjs-2
• framer-motion
• lucide-react, react-icons
• react-toastify
• react-markdown, katex
• xlsx (Export dữ liệu)

---

📈 Chức năng chính

👥 Quản lý người dùng

• Xem danh sách người dùng
• Kích hoạt / vô hiệu hóa tài khoản

📚 Quản lý nội dung học tập

• Quản lý bài học TOEIC
• Tạo, chỉnh sửa và xóa bài học
• Quản lý nội dung luyện nghe và điền từ

📝 Quản lý đề thi TOEIC

• Tạo đề thi TOEIC
• Chỉnh sửa và xóa đề thi
• Quản lý câu hỏi và đáp án

💳 Quản lý gói nâng cấp

• Quản lý các gói nâng cấp tài khoản

📊 Thống kê và báo cáo

• Thống kê số lượng người dùng
• Thống kê kết quả làm bài
• Thống kê và quản lý doanh thu
• Xuất dữ liệu báo cáo (Excel)

🔐 Xác thực & hệ thống

• Đăng nhập dành cho Admin
• Bảo mật và phân quyền truy cập
• Kết nối realtime với hệ thống thông qua Socket.IO

---

🔐 Biến môi trường (.env)

Tạo file .env trong thư mục gốc và cấu hình các biến môi trường sau:

VITE_GOOGLE_CLIENT_ID=

# Local Development
VITE_API_BASE_URL=http://localhost:8080
VITE_USER_PORTAL_URL=http://localhost:3000

---

🚀 Cách chạy Frontend Admin (Local)

1️⃣ Clone project

git clone https://github.com/DKNguyen13/Toeic-Master-FE-Admin.git
cd Toeic-Master-FE-Admin

2️⃣ Cài đặt dependencies

npm install

3️⃣ Tạo file .env

Tạo file .env trong thư mục gốc và cấu hình các biến môi trường theo mẫu bên dưới.

4️⃣ Chạy server

npm run dev

Sau khi chạy thành công, truy cập: 👉 http://localhost:4000