Hướng dẫn cài đặt hệ thống ChineseQuiz

1. Tải mã nguồn

• Truy cập đường dẫn chứa mã nguồn (Google Drive).

• Gửi yêu cầu và chờ quản trị viên phê duyệt.

• Sau khi được cấp quyền, tải mã nguồn về máy và giải nén.

• Mở Solution bằng Visual Studio 2022.

2. Chuẩn bị môi trường

Cài đặt các phần mềm cần thiết:

• Visual Studio 2022 

• >= .NET8

• PostgreSQL 18

• pgAdmin hoặc DBeaver để quản lý cơ sở dữ liệu

3. Cấu hình kết nối cơ sở dữ liệu

Mở file:

appsettings.json

Chỉnh sửa chuỗi kết nối theo PostgreSQL trên máy:

"ConnectionStrings": {  "DefaultConnection": "Host=localhost;Port=5432;Database=ChineseQuiz;Username=postgres;Password=yourpassword"}

Trong đó:

• Host: địa chỉ máy chủ PostgreSQL (thường làlocalhost).

• Port: cổng kết nối (mặc định5432).

• Database: tên cơ sở dữ liệu sẽ được tạo (ví dụ:ChineseQuiz).

• Username: tài khoản PostgreSQL.

• Password: mật khẩu PostgreSQL.

Lưu ý:Không cần tạo Database trước. Entity Framework Core sẽ tự tạo khi thực hiện Migration nếu tài khoản PostgreSQL có quyền tạo cơ sở dữ liệu.

4. Tạo cơ sở dữ liệu

MởPackage Manager Consoletrong Visual Studio và thực hiện:

Update-Database

Sau khi thực hiện thành công:

• DatabaseChineseQuizsẽ được tạo (nếu chưa tồn tại).

• Toàn bộ bảng, khóa chính, khóa ngoại và các Migration sẽ được tạo tự động.

5. Build dự án

Trong Visual Studio:

Build→ Build Solution

Hoặc nhấn:

Ctrl + Shift + B

Đảm bảo dự án được Build thành công và không có lỗi.

6. Chạy chương trình

Nhấn:

F5

hoặc

Ctrl + F5

Website sẽ khởi động trên địa chỉ:

https://localhost:xxxx

7. Kiểm tra hệ thống

Sau khi chương trình chạy thành công:

• Đăng nhập bằng tài khoản mặc định:
  • Tên đăng nhập:admin
  • Mật khẩu:Admin@123
• Sau khi đăng nhập lần đầu,nên đổi mật khẩu quản trịđể đảm bảo an toàn cho hệ thống trước khi đưa vào sử dụng.

Sau khi đăng nhập thành công, người quản trị có thể sử dụng các chức năng như:

• Import từ vựng.
• Quản lý từ vựng.
• Tạo bài kiểm tra.
• Quản lý bài kiểm tra.
• Theo dõi kết quả làm bài của học sinh.