# Hướng dẫn cài đặt Quản lý lớp học PRO

Cài Apps Script cho Quản lý lớp học PRO trong khoảng 10 phút. Chỉ áp dụng cho bản Google Trang tính.

## Thông tin nhanh

- **Menu sau khi cài:** 🎓 Lớp học (hiện cạnh menu Trợ giúp)
- **Mục bấm đầu tiên:** 🏠 Bảng điều khiển — đây là lúc Google hỏi quyền
- **Số file phải dán:** 3 (Code.gs, App, WebApp)
- **Thời gian:** khoảng 10 phút, làm một lần
- **Web App:** có — Web App cho giáo viên và phụ huynh
- **Trang sản phẩm:** https://www.hitava.cloud/san-pham/quan-ly-lop-hoc-pro

## Các file trong thư mục 2-Apps-Script

- `Code.gs` (Tập lệnh): phần chạy trên máy chủ Google
- `App` (HTML): hộp thoại quản lý: mở kỳ, điểm danh, học phí, thu tiền, lương, báo cáo
- `WebApp` (HTML, tuỳ chọn): trang điện thoại cho giáo viên và phụ huynh — chỉ cần khi dùng Web App

## Các bước

1. Mở file bằng Google Trang tính (bản sao từ "Tài liệu của tôi" đã có sẵn script, bỏ qua bước 1–2).
2. Tệp › Cài đặt: Ngôn ngữ Việt Nam, Múi giờ (GMT+07:00) Bangkok, Hà Nội, Tính lại "Khi thay đổi và mỗi giờ".
3. Tiện ích mở rộng › Apps Script › dán Code.gs vào Mã.gs.
4. Thêm các file còn lại đúng tên: App (HTML), WebApp (HTML).
5. Lưu, quay lại bảng tính, nhấn F5. Menu 🎓 Lớp học hiện cạnh Trợ giúp.
6. Bấm 🎓 Lớp học › 🏠 Bảng điều khiển. Google hỏi quyền: Tiếp tục › chọn tài khoản › "Google chưa xác minh ứng dụng này" › Nâng cao › Chuyển đến … (không an toàn) › Cho phép.

Cảnh báo "chưa được xác minh" là bình thường với mọi Apps Script tự dán vào file của mình; Google chỉ xác minh ứng dụng nộp hồ sơ phát hành công khai.

## Quyền Google hỏi ở mẫu này

- **Xem, sửa, tạo, xoá bảng tính:** đọc và ghi vào chính file của bạn
- **Xem, sửa, tạo, xoá tệp trong Google Drive:** lưu PDF phiếu học phí, phiếu lương, báo cáo học tập, ảnh QR; sao lưu và lưu trữ kỳ cũ
- **Xem, sửa, tạo, xoá Google Tài liệu:** điền phiếu đăng ký, phiếu thu, biên bản, giấy chứng nhận từ mẫu của bạn
- **Gửi email thay bạn:** gửi tới địa chỉ bạn nhập trong file. Script không đọc hộp thư Gmail
- **Chạy khi bạn không có mặt:** gửi email nhắc theo giờ — chỉ khi bạn tự bật
- **Hiện và chạy nội dung bên thứ ba:** mở hộp thoại quản lý bên trong bảng tính
- **Xem địa chỉ email của bạn:** ghi “ai đã làm” vào tab Nhật ký

Dữ liệu nằm trong Google Drive của khách. Script chạy bằng tài khoản Google của khách, không gửi dữ liệu ra ngoài; HiTaVa không xem được file.

## Việc làm một lần

- Tab Thiết lập: tên trung tâm, địa chỉ, hotline; ngân hàng nhận tiền, số tài khoản, chủ tài khoản (VIẾT HOA KHÔNG DẤU, đúng như app ngân hàng hiện).
- Kiểm tra mã QR trước khi gửi phụ huynh: hộp thoại › Học phí › bấm một phiếu › mở app ngân hàng › Quét QR. Phải đúng tên chủ tài khoản và đúng số tiền. Chỉ xem, đừng bấm chuyển.
- Menu › Làm gọn & khoá tab tự tính — các cột công thức chuyển sang chế độ chỉ cảnh báo.
- Tuỳ chọn: email nhắc việc buổi sáng (Thiết lập › Email nhận nhắc việc › hộp thoại › Cài đặt › Gửi thử › Bật).
- Tuỳ chọn: tải 5 mẫu văn bản trong thư mục 3-Mau-van-ban lên Drive, lưu dưới dạng Google Tài liệu, giữ nguyên các chữ {{…}}, rồi dán link vào hộp thoại › Tài liệu.

## Web App cho giáo viên và phụ huynh

Giáo viên điểm danh bằng điện thoại; phụ huynh tra cứu chuyên cần, điểm và học phí. Cả hai không cần tài khoản Google và không thấy bảng tính.

Bật: Tab Thiết lập › Web App điểm danh cho giáo viên: Bật (và Web App tra cứu cho phụ huynh nếu cần). Sau đó Apps Script › Triển khai › Tuỳ chọn triển khai mới › Ứng dụng web; Thực thi dưới dạng: Tôi; Người có quyền truy cập: Bất kỳ ai; Triển khai; chép URL kết thúc bằng /exec.

Web App KHÔNG đi theo bản sao — kể cả bản sao đã có sẵn script vẫn phải tự triển khai một lần. Dán mã bản mới thì dùng Quản lý triển khai › Chỉnh sửa › Phiên bản mới để giữ nguyên link /exec.

## Dùng hằng kỳ

1. Mở kỳ — sinh buổi học và dòng điểm danh cho cả tháng.
2. Điểm danh — hộp thoại trên máy tính, Web App trên điện thoại, hoặc gõ thẳng vào tab Điểm danh.
3. Phát sinh — huỷ buổi, dạy thay, buổi bù, giảm giá, học bổng.
4. Chốt học phí — phát hành phiếu, chép tin Zalo, tải ảnh có QR, gửi email.
5. Thu tiền — ghi từng lần nhận, hoặc dán sao kê ngân hàng để đối soát.
6. Lương giáo viên — chốt lương, xuất phiếu lương PDF.
7. Báo cáo — Tổng quan, Báo cáo tháng, báo cáo học tập từng học sinh.

## Trên Excel

Trên Excel vẫn đủ 29 tab và mọi công thức (điểm danh, học phí, công nợ, lương, mẫu in phiếu). Không có: mở kỳ tự động, điểm danh nhanh, mã QR, PDF, email, tin Zalo soạn sẵn, đối soát sao kê, Web App.

Trang HTML: https://www.hitava.cloud/huong-dan/quan-ly-lop-hoc-pro