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

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

## Thông tin nhanh

- **Menu sau khi cài:** 🏠 Phòng trọ (hiện cạnh menu Trợ giúp)
- **Mục bấm đầu tiên:** Giới thiệu & cấp quyền — đây là lúc Google hỏi quyền
- **Số file phải dán:** 2 (Code.gs, App)
- **Thời gian:** khoảng 8 phút, làm một lần
- **Web App:** không
- **Trang sản phẩm:** https://www.hitava.cloud/san-pham/quan-ly-phong-tro-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: Tổng quan, Chốt số, Hoá đơn, Thu tiền, Sao kê, Phòng & hợp đồng

## 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).
5. Lưu, quay lại bảng tính, nhấn F5. Menu 🏠 Phòng trọ hiện cạnh Trợ giúp.
6. Bấm 🏠 Phòng trọ › Giới thiệu & cấp quyề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, tạo tệp trong Google Drive:** lưu hoá đơn PDF, ảnh, hợp đồng vào thư mục của bạn
- **Tạo, sửa Google Tài liệu:** điền hợp đồng, biên bả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

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: ngân hàng, số tài khoản, tên chủ tài khoản — dùng để in mã QR lên hoá đơn.
- Hộp thoại › Nhắc việc & cài đặt › Thử mã QR 1.000đ › quét bằng app ngân hàng: phải hiện đúng tên bạn. Không cần chuyển tiền.
- Menu › Làm gọn & khoá tab tự tính.
- Tuỳ chọn: tải 3 mẫu văn bản lên Drive, lưu dưới dạng Google Tài liệu, giữ nguyên các chữ {{…}}, dán link vào hộp thoại › Nhắc việc & cài đặt › Mẫu văn bản.

## Dùng hằng kỳ

1. Chốt số — mở kỳ, gõ số điện nước mới. Ô đỏ là số mới nhỏ hơn số cũ, ô cam là tăng bất thường.
2. Hoá đơn tự tính trong tab Hoá đơn.
3. Gửi khách — chép tin Zalo, tải ảnh hoá đơn có mã QR, hoặc gửi email.
4. Thu tiền — ghi từng lần nhận, hoặc dán sao kê ngân hàng.

## Trên Excel

Trên Excel vẫn đủ tab, công thức, hoá đơn, công nợ, báo cáo. Không có: hộp thoại, chốt số hàng loạt, mã QR VietQR, hoá đơn PDF, email, đối soát sao kê.

Trang HTML: https://www.hitava.cloud/huong-dan/quan-ly-phong-tro-pro