# Hướng dẫn cài đặt Quản lý đám cưới PRO

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

## Thông tin nhanh

- **Menu sau khi cài:** 💍 Đám cưới (hiện cạnh menu Trợ giúp)
- **Mục bấm đầu tiên:** 🛠 Cài đặt file (chạy lần đầu) — đây là lúc Google hỏi quyền
- **Số file phải dán:** 4 (Code.gs, App, WebApp, appsscript.json.txt)
- **Thời gian:** khoảng 20 phút, làm một lần
- **Web App:** có — Web App cho khách và người nhà
- **Trang sản phẩm:** https://www.hitava.cloud/san-pham/quan-ly-dam-cuoi-pro
- **Video hướng dẫn:** https://youtu.be/W2E1yIxdE74

## 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, tính toán, email, PDF, web app
- `App` (HTML): thanh bên và hộp thoại: khách mời, gửi thiệp, xếp bàn, ngân sách, việc, kịch bản, sổ mừng
- `WebApp` (HTML): các trang trên điện thoại: khách trả lời tham dự, thông tin lễ, check-in, ghi phong bì, xếp bàn, Bây giờ / Tiếp theo
- `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ụ Google Sheets giúp thanh bên mở nhanh

## 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), appsscript.json.txt (HTML).
5. Lưu, quay lại bảng tính, nhấn F5. Menu 💍 Đám cưới hiện cạnh Trợ giúp.
6. Bấm 💍 Đám cưới › 🛠 Cài đặt file (chạy 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 khách, bàn, ngân sách, việc trong file này; tạo và ghi file sổ mừng riêng; ghi câu trả lời khách gửi từ điện thoại
- **Xem, sửa, tạo, xoá tệp trong Google Drive:** lưu PDF thiệp, sơ đồ bàn, kịch bản, sổ mừng vào thư mục của bạn; sao lưu hằng tuần
- **Xem, sửa, tạo, xoá Google Tài liệu:** điền tên hộ, ngày cưới, link trả lời tham dự, mã QR vào mẫu thiệp của bạn
- **Gửi email thay bạn:** gửi thiệp mời khi bạn bấm Gửi, nhắc hộ chưa trả lời, tóm tắt mỗi sáng. Script không đọc hộp thư Gmail
- **Xem, sửa, chia sẻ, xoá lịch:** chỉ khi bạn bấm 📅 Google Calendar: tạo một lịch riêng “Đám cưới …” cho các lễ và hạn thanh toán, không đụng lịch khác
- **Chạy khi bạn không có mặt:** lịch tự chạy 7:00 mỗi sáng, sao lưu Chủ nhật, gửi email chia lô
- **Hiện và chạy nội dung bên thứ ba:** mở thanh bên và hộp thoại bên trong bảng tính
- **Xem địa chỉ email của bạn:** biết ai đang dùng menu để áp vai trò ở tab ROLES và ghi 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

- Menu 💍 Đám cưới › 🛠 Cài đặt file (chạy lần đầu): đặt múi giờ, cài 3 lịch tự chạy (khi sửa ô, 7:00 mỗi sáng, sao lưu Chủ nhật) và tạo file “Sổ mừng cưới — riêng tư” trong Drive của bạn. Chạy lại lúc nào cũng an toàn, không xoá dữ liệu.
- Thanh bên “Cài đặt ban đầu” 4 bước: Hai bạn (tên, ngày cưới, hạn trả lời) › Tiệc & ngân sách › Các lễ (dạm ngõ, ăn hỏi, rước dâu, tiệc nhà gái, tiệc nhà trai, lại mặt — sửa được sau) › Dựng file (checklist từ 61 việc mẫu, chia ngân sách theo tỷ lệ gợi ý) › ✨ Hoàn tất cài đặt.
- Tab ROLES: mỗi người nhà một dòng — email, vai trò (admin, family, coordinator, viewer), phía, tick Đang dùng — rồi Chia sẻ file chính cho người dùng menu. Google Sheets không khoá được từng tab: ai được chia sẻ file chính vẫn mở được mọi tab, nên người điều phối và người thu phong bì dùng link riêng + PIN trên điện thoại, không cần chia sẻ file.
- Sổ mừng là file riêng, chỉ hai bạn mở — đừng chia sẻ cho ai. Mở bằng menu › 💌 Sổ mừng (file riêng).
- Tuỳ chọn: tự gửi email xác nhận cho nhà cung cấp trước mỗi lễ — mặc định tắt, bật ở CONFIG “Tự gửi email xác nhận cho nhà cung cấp”.

## Web App cho khách và người nhà

Khách mở link riêng của hộ mình trên điện thoại để trả lời tham dự từng lễ, không cần đăng nhập. Ngày cưới, người đón khách check-in, người thu phong bì ghi phong bì (chỉ ghi, không xem tổng), người điều phối xếp bàn, MC xem trang “Bây giờ / Tiếp theo” — mỗi người một link riêng + mã PIN, không cần mở file.

Bật: Làm sau bước cài đặt file. Triển khai xong, dán link /exec vào tab CONFIG › dòng “Link web app (script ghi)” — hoặc menu › ⚙ Cài đặt & phân quyền › Công cụ › 🪄 Chạy lại cài đặt ban đầu để script tự ghi. 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. Khách mời — thêm theo hộ (mỗi hộ một thiệp) hoặc nhập từ Excel/CSV, gộp khách trùng.
2. Gửi thiệp — chép tin Zalo soạn sẵn kèm link riêng từng hộ, hoặc gửi email (Gmail cá nhân khoảng 100 người nhận mỗi ngày).
3. Theo dõi trả lời — script tự nhắc qua email hộ đã nhận thiệp mà chưa trả lời.
4. Chốt bàn — 3 kịch bản tối thiểu / dự kiến / tối đa, cắt danh sách theo ưu tiên A/B/C, xếp bàn kéo-thả, in PDF cho nhà hàng.
5. Ngân sách & thanh toán — dự toán › báo giá › thực tế theo nhà trai / nhà gái / chung, các đợt cọc và tất toán.
6. Việc cần làm — checklist theo mốc, đổi ngày cưới là hạn tự dời; mỗi sáng email tóm tắt.
7. Ngày cưới — check-in, ghi phong bì, “Bây giờ / Tiếp theo” trên điện thoại; in sẵn bảng tra khách theo bàn để dự phòng mất mạng.

## Trên Excel

Trên Excel 2016 trở lên vẫn đủ 24 tab và mọi công thức: DASHBOARD, 3 kịch bản số bàn, cắt danh sách, ngân sách, thanh toán, hạn việc, cảnh báo màu; file sổ mừng .xlsx có công thức tổng hợp. Không có: menu và thanh bên, link trả lời tham dự và các trang điện thoại, email, tin Zalo soạn sẵn, mã QR, PDF, xếp bàn kéo-thả, đồng bộ Google Calendar, sao lưu, nhật ký sửa đổi.

Trang HTML: https://www.hitava.cloud/huong-dan/quan-ly-dam-cuoi-pro