📖 Hướng dẫn: Quản trị Master Data Toàn Hệ thống (System Master Data)

Tính năng Master Data Hệ thống (System Master Data) dành riêng cho quản trị viên cấp cao (Super Admin) nhằm thiết lập và quản lý các danh mục dữ liệu chuẩn hóa áp dụng chung cho mọi Workspace và luồng nghiệp vụ trong toàn bộ nền tảng GIGEE.

Mỗi bản ghi được định danh bởi một UUID duy nhất, cho phép các tính năng khác (như Hồ sơ Worker trên Zalo Mini App, Tuyển dụng Job, Khởi tạo Workspace) liên kết trực tiếp mà không bị trùng lặp dữ liệu.

1. Truy cập Trang Quản trị

Đăng nhập vào GIGEE Web Dashboard bằng tài khoản có quyền Super Admin.
Tại thanh menu bên trái, tìm nhóm menu SUPER ADMIN và chọn Cấu hình Hệ thống (/system-configurations).
Giao diện được thiết kế dạng 2 cột Sub-sidebar phong cách Studio:
- Cột trái: Danh sách các nhóm danh mục Type master data kèm số lượng bản ghi.
- Cột phải: Bảng chi tiết các bản ghi, hỗ trợ thao tác Thêm / Sửa / Xóa và sao chép UUID.

2. Các Danh mục Master Data Mặc định

Kỹ năng Worker Chuẩn hóa (worker_skill): Danh mục các kỹ năng nghề nghiệp (Pha chế, Thu ngân, Giao hàng, Bán hàng,…) hiển thị cho Worker lựa chọn trên Zalo Mini App khi hoàn thiện hồ sơ.
Danh mục Workspace Mặc định (workspace_category): Danh mục phân loại công việc mẫu (Sự kiện, Bán lẻ, F&B, Hậu cần,…) tự động gắn nhãn khi tạo mới Workspace.
Thẻ Tag Mặc định (workspace_tag): Các thẻ tag phân loại mức độ ưu tiên hoặc tính chất công việc.
Task Validator (task): Quản lý tên, mô tả và trạng thái kích hoạt của các bước xác minh Worker như Chụp ảnh (photo_proof) và Geofence (geofence).
Tùy chỉnh Khác (custom): Các nhóm master data do Super Admin tạo thêm.

3. Các Thao tác Quản trị

A. Thêm một Danh mục Master Data Mới (Type)

Ở đầu cột Sub-sidebar bên trái, bấm nút + Tạo Type.
Nhập mã định danh nhóm (ví dụ: cert_types, bank_codes).
Bấm Tạo danh mục. Hệ thống sẽ tự động chuyển sang danh mục mới để bạn thêm các bản ghi.

B. Thêm mới một Bản ghi Master Data (Item)

Chọn danh mục tương ứng ở cột Sub-sidebar bên trái.
Bấm nút + Thêm Bản ghi ở góc phải màn hình.
Điền các thông tin:
- Mã định danh (Code / Slug): vd barista, driver.
- Tên hiển thị: vd Pha chế chuyên nghiệp.
- Thuộc tính mở rộng (Metadata): Tùy theo loại danh mục (vd: mã màu hiển thị #3B82F6, nhóm ngành F&B).
- Mô tả chi tiết.
- Kích hoạt sử dụng: Bật để các feature khác có thể tìm kiếm và gán liên kết.
Bấm Tạo mới.

C. Cập nhật Task Validator

Chọn danh mục Task (task) trong cột trái.
Chọn validator cần cập nhật, ví dụ photo_proof hoặc geofence.
Sửa Tên hiển thị, Mô tả hoặc công tắc Kích hoạt sử dụng, rồi lưu.
Khi tắt, validator đó không được đưa vào luồng hiển thị, kiểm tra bắt buộc hoặc gửi bằng chứng trên ứng dụng Worker.

Không đổi Code tùy ý: code phải khớp với module kỹ thuật đã đăng ký. Trang legacy /validators không còn được sử dụng; mọi metadata và trạng thái Task Validator được quản lý tại /system-configurations.

D. Sao chép UUID Tham chiếu (Click-to-copy UUID)

Mỗi bản ghi có một huy hiệu UUID dạng 00000000-0000-....
Bấm trực tiếp vào huy hiệu UUID để sao chép vào bộ nhớ đệm (clipboard), phục vụ việc tích hợp hoặc đối soát dữ liệu.

E. Xem & Xuất Dữ liệu JSON Đối chiếu

Ở cuối trang chi tiết, mở rộng mục JSON Master Data Export để xem toàn bộ danh sách bản ghi dưới dạng mã JSON và bấm Sao chép JSON khi cần đối chiếu.