Hệ thống quản lý trung tâm đào tạo bằng laravel

Hướng dẫn cài đặt source code EduCenter

EduCenter là hệ thống quản lý trung tâm đào tạo gồm 3 portal: Quản trị (Admin), Giáo viên và Học viên. Source code viết bằng PHP thuần (Custom MVC) + MySQL, chạy trên Laragon / XAMPP / WAMP.

1. Yêu cầu hệ thống

Thành phần Phiên bản tối thiểu PHP 8.0 trở lên (khuyến nghị 8.2) MySQL / MariaDB 5.7+ / 8.0+ Web server Apache (bật mod_rewrite) Extension PHP pdo, pdo_mysql, mbstring, fileinfo, curl (tùy chọn – dùng cho smoke test) Công cụ khuyến nghị Laragon (Windows) hoặc XAMPP

2. Cấu trúc thư mục dự án

Sau khi giải nén source, cấu trúc chính như sau:

educationcenterapi/ ├── migrate.php ← Tạo bảng + dữ liệu mẫu cơ bản ├── seed_fake.php ← Nạp thêm dữ liệu demo đầy đủ (tùy chọn) ├── finaldemo_web.sql ← File backup database (import nhanh) ├── scripts/ │ └── smoke_test.php ← Kiểm tra hệ thống sau cài đặt └── project_root/ ├── app/ ← Controllers, Models, Views, Routes ├── core/ ← Router, WebController ├── config/ │ └── database.php ← Cấu hình kết nối MySQL ├── public/ │ ├── web.php ← Entry point Web Portal (đăng nhập UI) │ ├── index.php ← Entry point REST API │ ├── uploads/ ← Thư mục lưu file PDF nộp bài │ └── assets/ ← CSS, JS └── index.php ← Redirect sang portal login

Lưu ý: Đặt toàn bộ thư mục educationcenterapi vào www (Laragon) hoặc htdocs (XAMPP).

3. Tạo database MySQL

Mở phpMyAdmin hoặc HeidiSQL, tạo database mới:

• Tên database: finaldemo_web
• Collation: utf8mb4_unicode_ci hoặc utf8mb4_general_ci

Hoặc chạy lệnh SQL:

CREATE DATABASE finaldemo_web CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

4. Cấu hình kết nối database

Mở file project_root/config/database.php và chỉnh theo môi trường của bạn:

<?php return [ 'host' => 'localhost', 'port' => '3306', 'dbname' => 'finaldemo_web', 'username' => 'root', 'password' => '', 'charset' => 'utf8mb4' ]; Thông số Laragon mặc định XAMPP mặc định host localhost localhost username root root password (để trống) (để trống)

5. Cài đặt database — chọn 1 trong 2 cách

Cách 1: Chạy migrate.php (khuyến nghị cho cài mới)

Mở Terminal / CMD tại thư mục gốc educationcenterapi và chạy:

php migrate.php

Laragon (Windows):

E:\laragon\bin\php\php-8.2.4-nts-Win32-vs16-x64\php.exe migrate.php

Script sẽ tự động:

• Tạo toàn bộ bảng dữ liệu
• Nạp vai trò (Admin, Giáo viên, Học viên)
• Tạo tài khoản demo, khóa học, lớp học mẫu
• Đồng bộ các cột mới nếu database đã tồn tại từ phiên bản cũ

Khi thấy dòng 「Migration hoàn thành!」 là thành công.

Cách 2: Import file SQL (nhanh, có sẵn data demo)

1. Mở phpMyAdmin → chọn database finaldemo_web
2. Tab Import → chọn file finaldemo_web.sql
3. Nhấn Go / Thực hiện

Sau khi import xong, vẫn cần kiểm tra file database.php đúng thông tin kết nối.

Tùy chọn: Muốn thêm nhiều dữ liệu test (điểm danh, thanh toán, bài nộp, khảo sát...) chạy thêm:

php seed_fake.php

6. Phân quyền thư mục upload

Hệ thống lưu file PDF nộp bài tại project_root/public/uploads/submissions/.

Thư mục sẽ được tạo tự động khi học viên nộp bài lần đầu. Nếu gặp lỗi upload, hãy tạo thủ công và cấp quyền ghi:

project_root/public/uploads/ project_root/public/uploads/submissions/

Trên Windows (Laragon/XAMPP) thường không cần chmod. Trên Linux:

chmod -R 755 project_root/public/uploads

7. Truy cập website

Giả sử source đặt tại www/educationcenterapi/, truy cập các URL sau:

Mục đích URL Trang đăng nhập (khuyến nghị) http://localhost/educationcenterapi/project_root/public/web.php/login Shortcut (tự redirect login) http://localhost/educationcenterapi/project_root/ REST API http://localhost/educationcenterapi/project_root/public/index.php

Nếu bạn đặt source trong virtual host riêng (vd: http://educenter.test), thay localhost/educationcenterapi bằng domain tương ứng.

8. Tài khoản đăng nhập mặc định

Sau khi chạy migrate.php:

Vai trò Email Mật khẩu Quản trị viên admin@edu.vn admin123 Giáo viên tuan.gv@edu.vn teacher123 Giáo viên hoa.gv@edu.vn teacher123 Học viên an.hv@edu.vn student123 Học viên binh.hv@edu.vn student123 Học viên cuong.hv@edu.vn student123

Sau khi chạy seed_fake.php sẽ có thêm nhiều tài khoản (GV003, HV004–HV008...), mật khẩu vẫn là teacher123 / student123.

9. Kiểm tra cài đặt (Smoke Test)

Chạy script kiểm tra nhanh sau khi cài xong:

php scripts/smoke_test.php

Hoặc chỉ định URL nếu khác mặc định:

php scripts/smoke_test.php http://localhost/educationcenterapi/project_root/public

Script kiểm tra: kết nối API, đăng nhập session portal, các route cơ bản. Kết quả hiển thị [OK] / [FAIL] từng mục.

10. Luồng sử dụng sau khi cài đặt

1. Admin đăng nhập → tạo khóa học, lớp học, học kỳ
2. Admin ghi danh học viên vào lớp
3. Admin duyệt thanh toán → hệ thống tự tạo lịch học 2 buổi/tuần + phân công GV
4. Giáo viên điểm danh, chấm bài PDF, đánh giá học viên
5. Học viên xem lịch, nộp bài, xem điểm, khảo sát GV

11. Xử lý lỗi thường gặp

Lỗi Nguyên nhân / Cách xử lý SQLSTATE[HY000] [1049] Unknown database Chưa tạo database finaldemo_web. Tạo database trước khi chạy migrate. SQLSTATE[HY000] [1045] Access denied Sai username/password trong database.php. Trang trắng / 500 Error Bật hiển thị lỗi PHP; kiểm tra phiên bản PHP ≥ 8.0; xem log Apache/PHP. 404 khi click menu Apache chưa bật mod_rewrite; kiểm tra file .htaccess trong public/. Không nộp được file PDF Kiểm tra thư mục public/uploads/submissions/ có quyền ghi; file ≤ 5MB, định dạng PDF. Đăng nhập báo sai mật khẩu Chạy lại php migrate.php hoặc import lại SQL; dùng đúng email/mật khẩu mặc định ở mục 8. Báo trùng lịch khi thanh toán Đúng logic hệ thống — học viên đã có lớp trùng thứ/giờ. Chọn lớp khác hoặc đổi lịch khóa học.

12. Ghi chú khi deploy lên server thật

• Tắt display_errors trong production (web.php, index.php).
• Đổi mật khẩu tài khoản Admin mặc định ngay sau khi cài.
• Dùng HTTPS cho môi trường thật.
• Backup database định kỳ (export qua phpMyAdmin hoặc mysqldump).
• Không commit file database.php chứa mật khẩu production lên Git công khai.

Hoàn tất! Nếu cần hỗ trợ thêm, hãy kèm ảnh chụp lỗi + phiên bản PHP/MySQL khi liên hệ.