# Hướng dẫn cài đặt Nhân sự 360 PRO

Cài Apps Script cho Nhân sự 360 PRO trong khoảng 25 phút. Chỉ áp dụng cho bản Google Trang tính.

## Thông tin nhanh

- **Menu sau khi cài:** Nhân sự 360 (hiện cạnh menu Trợ giúp)
- **Mục bấm đầu tiên:** Cài đặt lần đầu — đây là lúc Google hỏi quyền
- **Số file phải dán:** 3 (Code.gs, App, appsscript.json.txt)
- **Thời gian:** khoảng 25 phút, làm một lần
- **Web App:** có — Triển khai web app toàn màn hình
- **Trang sản phẩm:** https://www.hitava.cloud/san-pham/nhan-su-360-pro
- **Video hướng dẫn:** https://youtu.be/Eyk6jemdROw

## 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: menu, đăng nhập, chấm công, xếp ca, đơn từ, bảng công, lương, phiếu PDF, email, Telegram / Google Chat, sao lưu
- `App` (HTML): web app toàn màn hình: một trang dùng chung cho máy tính, điện thoại và máy tính bảng làm kiosk
- `appsscript.json.txt` (HTML): tệp kê khai: múi giờ GMT+7, quyền, cấu hình web app và dịch vụ đọc nhanh Google Sheets — thiếu tệp này mỗi trang web app tải mất 15–20 giây

## 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), appsscript.json.txt (HTML).
5. Lưu, quay lại bảng tính, nhấn F5. Menu Nhân sự 360 hiện cạnh Trợ giúp.
6. Bấm Nhân sự 360 › Cài đặt lần đầu. 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 nhân viên, lịch ca, chấm công, đơn từ, lương trong file này
- **Xem, sửa, tạo, xoá tệp trong Google Drive:** ảnh selfie, giấy tờ, hợp đồng PDF, phiếu lương PDF và bản sao lưu trong các thư mục "Nhân sự 360 – …" của bạn
- **Gửi email thay bạn:** phiếu lương, nhắc chấm công, đơn chờ duyệt. Script không đọc hộp thư Gmail
- **Chạy khi bạn không có mặt:** gom lượt chấm công mỗi phút, nhắc chưa chấm công, việc hằng ngày lúc 06:00, sao lưu, tự mở ứng dụng khi chủ file mở bảng tính
- **Hiện và chạy nội dung bên thứ ba:** menu Nhân sự 360 và hộp nhỏ "Mở ứng dụng" trong bảng tính
- **Kết nối với dịch vụ bên ngoài:** chỉ gửi tin Telegram và Google Chat khi bạn bật. Không gửi dữ liệu về HiTaVa
- **Xem địa chỉ email của bạn:** biết ai đang bấm menu: chủ file hay người có vai trò Chủ / HR

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

- Menu Nhân sự 360 › Cài đặt lần đầu (chỉ chủ file chạy được): đặt múi giờ GMT+7, tạo khoá phiên đăng nhập, cài lịch tự chạy (gom lượt chấm công mỗi 1 phút, nhắc chưa chấm công mỗi 10 phút, việc hằng ngày lúc 06:00) và tạo link riêng cho nhân viên đang làm. Chạy lại lúc nào cũng an toàn — chỉ thêm phần thiếu, không xoá dữ liệu.
- Hiện hộp "Ứng dụng web CHƯA được triển khai": bấm Huỷ, làm Bước 5 bên dưới rồi mở link /exec một lần. Xong thì menu › Kiểm tra cài đặt phải thấy link ứng dụng kết thúc bằng /exec, khoá phiên và 3 lịch tự chạy.
- Menu › Mở ứng dụng: ứng dụng mở toàn màn hình ở tab mới, tự đăng nhập với vai trò Chủ. Trình duyệt chặn cửa sổ bật lên thì bấm nút "Mở Nhân sự 360" trong hộp nhỏ, hoặc cho phép bật lên từ docs.google.com. Mặc định mỗi lần chủ file mở bảng tính, ứng dụng tự mở; tắt hoặc bật lại ở menu › Bật/tắt tự mở ứng dụng khi mở file.
- Trong ứng dụng › Cài đặt › Công ty & luật: tên công ty, vùng lương, ngày trả lương, công chuẩn, nghỉ thứ Bảy / Chủ nhật. Tham số luật và Ngày lễ 2026–2028 đã điền sẵn.
- Cài đặt › Chi nhánh (tối đa 5): vĩ độ / kinh độ — đứng tại cửa hàng bấm "Lấy vị trí hiện tại", hoặc bấm giữ đúng chỗ trên Google Maps rồi chép hai số — bán kính chấm công (mặc định 100 m), Kiosk QR, Bắt buộc selfie. Sai toạ độ thì mọi lượt chấm bị báo ngoài bán kính.
- Cài đặt › Ca làm việc (ca đêm qua ngày, ca gãy đều được) và Phòng ban, chức vụ (người duyệt cấp 1, cấp 2). Rồi Nhân viên › Thêm nhân viên hoặc Nhập CSV: Mã NV không trùng, chi nhánh, phòng ban, vai trò (Chủ / HR / Kế toán / Quản lý / Nhân viên), lương, email — tối đa 100 người đang làm.
- Xếp ca: kéo ca vào lưới tuần hoặc bấm Gợi ý xếp tuần › Lưu và báo nhân viên. Ca chưa lưu ở dạng Nháp, nhân viên chưa thấy.
- Phân quyền: vai trò đặt ở hồ sơ từng người, quyền chi tiết ở Cài đặt › Vai trò & quyền. Google Sheets không khoá được từng tab: chỉ chia sẻ bảng tính cho chủ và kế toán, mọi người khác dùng web app bằng mã NV + PIN.

## Triển khai web app toàn màn hình

Đây chính là ứng dụng, không phải phần thêm: chủ và quản lý dùng trên máy tính (Hôm nay, Xếp ca, Chấm công, Đơn từ, Bảng công, Lương, Nhân viên, Báo cáo, Cài đặt), nhân viên dùng trên điện thoại (Hôm nay với nút Vào ca / Ra ca, Lịch ca, Đơn, Lương; quản lý có thêm Duyệt và Đội). Mỗi nhân viên một link riêng, lần đầu mở tự đặt PIN 6 số, từ đó đăng nhập bằng mã NV + PIN — không cần tài khoản Google, không thấy bảng tính. Sai PIN 5 lần khoá 15 phút. Chấm công GPS cần nhân viên cho phép trình duyệt dùng vị trí; Google không cho trang mở camera trực tiếp nên selfie mở ứng dụng camera của điện thoại. Lượt chấm hiện trong web app ngay, trong tab Chấm công của bảng tính sau khoảng 1 phút (menu › Gom lượt chấm công ngay nếu cần ngay). Máy tính bảng ở cửa làm kiosk QR bằng link /exec?p=kiosk của chi nhánh, lấy ở Cài đặt › Kiosk & thiết bị.

Bật: Bắt buộc, làm ngay sau Cài đặt lần đầu. Triển khai xong, mở link /exec một lần trong trình duyệt bằng tài khoản chủ file — ứng dụng tự lưu link của chính nó (hoặc chạy lại Cài đặt lần đầu và dán link; link /dev không được nhận). Rồi menu › Link riêng của nhân viên: gửi từng người link của họ qua Zalo hoặc email; quên PIN hay đổi điện thoại thì dùng menu › Đặt lại PIN nhân viê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. Tuần đầu — thử bằng file DEMO trước (PIN trong DEMO là PIN giả: dùng Đặt lại PIN nhân viên để lấy link và tự đặt PIN), rồi chạy song song với cách chấm công đang dùng và kiểm bán kính GPS từng chi nhánh.
2. Hằng ngày — trang Hôm nay: ai đang trong ca, đi muộn, chưa chấm; duyệt lượt chấm điểm tin cậy thấp và đơn chờ duyệt. Nhắc chưa chấm công tự gửi sau 10 phút trễ.
3. Hằng tuần — Xếp ca cho tuần sau › Lưu và báo nhân viên; nhân viên nhường, nhận, đổi ca ở chợ ca.
4. Mỗi tháng — Lương 5 bước: Bảng công (khoá kỳ), Phụ cấp & thưởng, Kiểm tra, Chốt kỳ, Gửi phiếu PDF qua email và xuất file chuyển khoản — luôn kiểm ở màn hình xem trước của ngân hàng trước khi duyệt.
5. Kỳ lương đầu tiên — lương tính theo luật 2026 nhưng là công cụ tính: nhờ kế toán đối chiếu vài người trước khi trả.

## Trên Excel

Trên Excel 2010 trở lên vẫn mở được cả 26 tab và các cột công thức: Lịch ca (giờ làm, đi muộn, về sớm, giờ đêm, công), Bảng công, Phép năm, Bảng lương, Bảo hiểm & thuế, Chuyển khoản, Tổng quan — giờ vào / ra thực tế bạn tự gõ vào tab Lịch ca. Không có: web app, đăng nhập PIN, chấm công GPS / QR / kiosk / selfie, xếp ca kéo thả, đơn từ và duyệt, chợ ca, chốt kỳ tự động, phiếu PDF qua email, file chuyển khoản, thông báo, sao lưu tự động.

Trang HTML: https://www.hitava.cloud/huong-dan/nhan-su-360-pro