How to use the website-dang-ky-tin-chi extension

setup_instructions.md

Repo "Website Đăng kí tín chỉ"

Hướng dẫn cài đặt Backend và Cơ sở dữ liệu

Phần 1: Cài đặt Backend (Phần xử lý logic của ứng dụng)

1. Tìm đến thư mục backend: Trong mã nguồn của dự án bạn đã tải về, hãy mở thư mục có tên là backend.

2. Tạo file .env:

   • Trong thư mục backend, bạn hãy tạo một file mới và đặt tên cho nó là .env.
   • File .env là gì? Đây là file rất quan trọng dùng để lưu những thông tin bí mật như mật khẩu để kết nối với cơ sở dữ liệu (database).
   • Tại sao không được đưa lên GitHub? Bạn không nên đưa file này lên GitHub vì nếu người khác thấy được mật khẩu, họ có thể truy cập và thay đổi dữ liệu trong database của bạn.
   • Nội dung file .env: Bạn cần mở file .env và thêm vào đó thông tin kết nối đến database. Thường thì nó sẽ có dạng như sau (bạn cần thay thế your_password và your_database_name bằng thông tin thực tế của bạn):

   DB_HOST=localhost
   DB_USER=root
   DB_PASSWORD=your_password
   DB_NAME=your_database_name
   

Phần 2: Cài đặt Cơ sở dữ liệu (Database - Nơi lưu trữ dữ liệu)

1. Tìm đến thư mục database (hoặc sql): Trong mã nguồn dự án, bạn hãy tìm thư mục có tên là database hoặc sql.
2. Tải các file SQL: Trong thư mục này, bạn sẽ thấy các file có đuôi là .sql. Hãy tải tất cả các file này về máy tính của bạn.
3. Sử dụng MySQL Workbench (hoặc phần mềm tương tự):
   • MySQL Workbench là một công cụ giúp bạn quản lý cơ sở dữ liệu MySQL. Nếu bạn chưa có, bạn có thể tải và cài đặt nó.
   • Mở MySQL Workbench và kết nối đến cơ sở dữ liệu của bạn (thường là localhost).
4. Chạy các file SQL:
   • Trong MySQL Workbench, bạn hãy mở và chạy lần lượt các file .sql mà bạn đã tải về.
   • Việc này để làm gì? Việc chạy các file này sẽ giúp tạo ra các "bảng" (tables) trong cơ sở dữ liệu và điền vào đó những dữ liệu ban đầu cần thiết cho ứng dụng hoạt động.
5. Lưu ý quan trọng:
   • Nếu bạn sử dụng một cơ sở dữ liệu đã được đưa lên mạng (online), và đã có sẵn các bảng và dữ liệu, thì bạn không cần phải thực hiện bước này. Bước này chỉ cần thiết khi bạn đang cài đặt cơ sở dữ liệu trên máy tính cá nhân của mình (localhost).

Tóm tắt:

• Backend: Tạo file .env trong thư mục backend để điền thông tin database.
• Database: Dùng MySQL Workbench để chạy các file .sql trong thư mục database (hoặc sql) để tạo bảng và dữ liệu.