Quy Trình Đồng Bộ & Tác Vụ Admin

Hiểu rõ cách dữ liệu được xác thực và đồng bộ hóa từ cả Google Sheets và AppSheet, cũng như các công cụ quản trị dành cho Power User.

📝

Quy Trình 1: Đồng Bộ Hàng Loạt (Từ Google Sheet)

Quy trình này chỉ áp dụng khi Admin/Power User sử dụng menu 📝 SCM Tool -> 🚀 Push Data to BigQuery.

Bước 1: Bắt Đầu Đồng Bộ

Người dùng nhấn nút `🚀 Push Data to BigQuery`. Hệ thống sẽ đọc toàn bộ dữ liệu trong vùng "Clean Data" của sheet đang mở.

Bước 2: Hệ Thống Tự Động Xác Thực

Hệ thống hoạt động như một "người gác cổng" thông minh, tự động quét toàn bộ dữ liệu để tìm các lỗi nghiêm trọng[cite: 147, 149].

Trường hợp A: Lỗi Dữ Liệu Nghiêm Trọng

Nếu một trường quan trọng bị thiếu, hệ thống sẽ dừng lại và hiển thị một sidebar báo cáo lỗi [cite: 162-163].

⚠️ Báo Cáo Lỗi:

Row 5: Primary key column 'SUPPLIER_ID' is empty.

Trường hợp B: Lỗi Dữ Liệu Trùng Lặp

Nếu hệ thống phát hiện hai dòng dữ liệu có key giống hệt nhau, nó sẽ đưa ra lựa chọn "cách ly" (Quarantine) các dòng trùng lặp [cite: 164-165].

🤔 Hộp Thoại Lựa Chọn:

Duplicate rows were found... Proceed with quarantining?

💡 Công Cụ Sửa Lỗi (Error Tools)

Khi phát hiện lỗi, bạn có thể dùng menu ⚠️ Error Tools [cite: 160] để sửa:

  • 💡 Highlight Last Errors: Tô màu các dòng bị lỗi trên sheet[cite: 160].
  • 📄 Generate Error Report: Tạo một sheet mới chỉ chứa các dòng bị lỗi[cite: 160].

Bước 3: Xác Nhận và Hoàn Tất

Nếu tất cả dữ liệu đều hợp lệ, hệ thống sẽ hiển thị một bản tóm tắt cuối cùng về số lượng dòng mới và dòng được cập nhật. Bạn chỉ cần xác nhận để hoàn tất .

🔄

Quy Trình 2: Đồng Bộ Dữ Liệu AppSheet (Tự Động & Thủ Công)

Quy trình này đồng bộ dữ liệu từ AppSheet (Workflows 2 & 3) vào BigQuery. Nó có hai chế độ: tự động và thủ công.

Chế Độ Tự Động (Hàng Giờ)

Hệ thống được thiết lập để tự động chạy các trigger **mỗi giờ**:

  • `admin_SyncApprovedPRs_Trigger` chạy để đồng bộ các đơn mua hàng (PRs) đã duyệt.
  • `admin_SyncMasterDataFixes_Trigger` chạy để đồng bộ các sửa lỗi master data (Fixes).

Người dùng thông thường không cần làm gì cả, chỉ cần chờ hệ thống tự cập nhật.

Chế Độ Thủ Công (Ngay Lập Tức)

Nếu bạn là Power User và muốn đồng bộ dữ liệu *ngay lập tức* (không muốn chờ 1 giờ), bạn có thể sử dụng menu trong Google Sheet:

🔄 Sync Tools ►
➡️ Sync Approved PRs
🔧 Sync Master Data Fixes
⚙️

Quy Trình 3: Tác Vụ Admin (Chỉ Dành Cho Developer)

Menu này được **ẩn** khỏi tất cả người dùng SCM thông thường và chỉ hiển thị cho developer của dự án.

Menu: ⚙️ Admin

⚙️ Admin ►
🏗️ Deploy BQ Schema Changes

Nút này dùng để chạy các kịch bản "Infrastructure as Code" (IaC), tự động tạo hoặc cập nhật các bảng và view trong BigQuery (ví dụ: `Bom_Data_DRAFT_STAGING`, `...DRAFT_VIEWING`).

⚠️ CẢNH BÁO: Không bao giờ chạy nút này trừ khi bạn đang chủ động nâng cấp cấu trúc của cơ sở dữ liệu.