ỨNG DỤNG & HƯỚNG DẪN · HỌC ĐƯỜNG VIỆT

Cài đặt Nhật ký Nhà trường từ Google Sheet mẫu

Thay vì tạo từng sheet và chép mã thủ công, nhà trường có thể bắt đầu từ một bản sao Google Sheet mẫu. Bộ cài đặt sẽ tự tạo cấu trúc dữ liệu, cấu hình tên trường và tài khoản quản trị đầu tiên.

Xem bản demo Mở mã nguồn GitHub

1. Chuẩn bị tài khoản

• Dùng tài khoản Google của nhà trường hoặc tài khoản Hiệu trưởng.
• Tài khoản này sẽ là chủ sở hữu Google Sheet và quản trị viên đầu tiên.
• Không dùng tài khoản cá nhân của giáo viên nếu nhà trường muốn bàn giao hệ thống lâu dài.

2. Tạo bản sao Google Sheet mẫu

1. Mở bộ mã nguồn công khai và tải các tệp trong repository.
2. Tạo một Google Spreadsheet mới, hoặc mở Google Sheet mẫu do Học Đường Việt cung cấp.
3. Chọn File → Make a copy.
4. Đặt tên, ví dụ: Nhật ký trường THPT Phan Đăng Lưu.
5. Chọn thư mục Drive của nhà trường để lưu bản sao.

Lưu ý: bản sao phải thuộc tài khoản của nhà trường. Không nên triển khai ứng dụng trên một file mà giáo viên thông thường đang sở hữu.

3. Chạy bộ cài đặt tự động

1. Mở Google Sheet vừa tạo.
2. Chọn Extensions → Apps Script để mở dự án Apps Script gắn với Sheet.
3. Đảm bảo dự án có hai tệp NhatKyNhaTruong.gs và index.html.
4. Lưu dự án, quay lại Google Sheet và tải lại trang.
5. Chọn menu Nhat ky nha truong → Cai dat truong moi tu mau.
6. Cấp quyền cho Apps Script khi Google yêu cầu.

Bộ cài đặt sẽ hỏi ba thông tin:

• Tên trường/đơn vị, ví dụ: Trường THPT Phan Đăng Lưu.
• Tên hiển thị của ứng dụng, ví dụ: Nhật ký trường THPT Phan Đăng Lưu.
• Năm học, ví dụ: 2026-2027.

Sau khi hoàn tất, hệ thống tự động:

• tạo các sheet dữ liệu;
• tạo sheet CauHinh;
• lưu tên trường, tên ứng dụng và năm học;
• tạo tài khoản BGH đầu tiên từ email chủ sở hữu Sheet;
• gán quyền quản trị và quyền trích xuất;
• không tạo dữ liệu hoạt động mẫu vào hệ thống thật.

4. Triển khai Web App

1. Trong Apps Script chọn Deploy → New deployment.
2. Chọn loại triển khai Web app.
3. Ở mục thực thi, chọn tài khoản chủ sở hữu dự án.
4. Chọn quyền truy cập phù hợp với mô hình của trường.
5. Bấm Deploy và cấp quyền nếu được hỏi.
6. Sao chép URL kết thúc bằng /exec.

Chỉ chia sẻ URL /exec cho người dùng. URL /dev chỉ dùng để kiểm thử.

5. Tạo người dùng và phân quyền

Người dùng Google có thể gửi yêu cầu đăng ký bằng email Google. Quản trị viên duyệt và gán vai trò. Người không dùng Google có thể được cấp tài khoản nội bộ dạng NV-xxxx và phải đổi mật khẩu tạm ở lần đăng nhập đầu tiên.

Các vai trò có thể gồm BGH, TTCM, GVCN, GV, NV, Đoàn, Công đoàn, Đảng bộ/Chi bộ và tài khoản lớp.

6. Tạo lớp và sử dụng tài khoản lớp

BGH tạo lớp và cấp mật khẩu gửi báo cáo. Lớp dùng mã dạng LOP-10A1-2026 để đăng nhập. Tài khoản lớp chỉ xem thông báo lớp và gửi báo cáo sĩ số; không có quyền sửa dữ liệu hệ thống.

7. Sau khi cài đặt

• Kiểm tra tài khoản BGH đầu tiên.
• Tạo thử một người dùng giáo viên.
• Tạo một lớp thử nghiệm.
• Gửi thử thông báo và báo cáo sĩ số.
• Kiểm tra quyền xem, quyền duyệt và quyền xuất dữ liệu.
• Sao lưu Google Sheet trước khi đưa vào sử dụng chính thức.

8. Cập nhật phiên bản

Trước khi cập nhật, hãy tạo một bản sao lưu Google Sheet. Sau đó thay mã nguồn bằng phiên bản mới, chạy lại khoiTaoHeThong() nếu được yêu cầu và tạo phiên bản triển khai mới trong Deploy → Manage deployments. Không chạy taoDuLieuMau() trên dữ liệu thật nếu không muốn thêm dữ liệu minh họa.

← Quay lại cổng Ứng dụng & Hướng dẫn
Về landing site Học Đường Việt →