Thuật ngữ & thực thể

Tên gọi chung cho mọi trang. Muốn đổi tên hay thêm thực thể: sửa ở đây trước, rồi mới dùng ở trang khác.

Thực thể chính

Tên dùng trong tài liệu	Mã (dev)	Định nghĩa	Trang chính
Game mẫu	`game`	Một loại game trong thư viện (vd. Bứt tốc 10 giây, Cáo gom lộc — xem 10 game mẫu). Có luật mặc định và tham số cấu hình được	Quản lý game
Phiên bản game	`game_version`	Bản build của game mẫu. Campaign gắn vào một phiên bản cố định	Quản lý game
Campaign	`campaign`	Một đợt chạy game có thời gian, kênh, cơ cấu giải, thể lệ. Loại: offline hoặc online	Campaign
Điểm activation	`venue`	Địa điểm tổ chức campaign offline (booth, sự kiện, cửa hàng)	Campaign
Thiết bị	`device`	Kiosk, màn TV, iPad đăng ký với một điểm activation	Activation offline
Quà	`prize`	Một mặt hàng quà trong danh mục (vd. Áo thun size M, Voucher 50.000đ). Loại: vật lý hoặc digital	Kho quà
Kho	`warehouse`	Nơi giữ tồn quà vật lý: kho tổng hoặc kho tại điểm activation	Kho quà
Lô mã	`code_batch`	Một lần nhập mã cho quà digital (file mã, hoặc nguồn API nhà cung cấp)	Kho quà
Cơ cấu giải	`prize_pool`	Danh sách quà gán cho một campaign: số lượng, tỉ lệ trúng, giới hạn theo ngày/điểm	Campaign
Người chơi	`player`	Người đã định danh bằng SĐT (hoặc Zalo ID / FPT ID). Một người = một SĐT	Khách hàng
Lượt chơi	`turn`	Quyền chơi 1 lần. Có từ: lượt mặc định, chia sẻ, nhiệm vụ, nhân viên cấp	Khung game
Phiên chơi	`play_session`	Một lần chơi thực tế: bắt đầu → kết thúc, có điểm và kết quả	Khung game
Phòng chơi	`room`	Nhóm phiên chơi đồng thời cho chế độ 2 người / nhiều người	Chế độ chơi
Lượt trúng	`win`	Kết quả một phiên chơi trúng một quà. Sinh ra đúng 1 bản ghi cấp phát	Kho quà
Cấp phát	`redemption`	Việc trao quà của một lượt trúng: giữ quà, cấp mã, giao nhận	Kho quà
Lead	`lead`	Người chơi đã đồng ý nhận tư vấn — dữ liệu chuyển cho bán hàng	Khách hàng
Tài khoản quản trị	`admin_user`	Người dùng trang quản trị (không phải người chơi)	Tài khoản

Vai trò

Vai trò	Mã	Là ai
Người chơi	`player`	Khách hàng, khách vãng lai tại sự kiện
Quản trị hệ thống	`super_admin`	IT/PM — cấu hình toàn hệ thống, tài khoản
Quản lý campaign	`campaign_manager`	Marketing FCM / vùng — tạo, chạy campaign
Người duyệt	`approver`	Trưởng nhóm marketing — duyệt campaign và cơ cấu giải trước khi chạy
Quản lý kho quà	`prize_keeper`	Nhập, điều chuyển, đối soát quà
Nhân viên booth	`booth_staff`	Vận hành thiết bị, trao quà vật lý tại điểm activation
Người xem báo cáo	`viewer`	Lãnh đạo, đối tác — chỉ xem số liệu

Chi tiết quyền: Vai trò người dùng · Tài khoản & phân quyền.

Trạng thái chuẩn

Campaign

Nháp→Chờ duyệt→Đã duyệt→Đang chạy⇄Tạm dừng→Kết thúc

Cấp phát quà

Đang giữ→Đã cấp→Đã nhận·Hết hạn·Huỷ

Phiên chơi

Đang chơi→Hoàn thành·Bỏ dở·Không hợp lệ

Người chơi

Hoạt động⇄Bị chặn·Đã gộp·Đã xoá

Lead

Mới→Đã gửi→CRM đã nhận·Lỗi gửi·Bị loại

Phòng chơi

Đang chờ→Đang chơi→Kết thúc·Huỷ

Phiên bản game

Nháp→Đang kiểm thử→Chờ duyệt→Đã phát hành→Ngừng dùng·Tắt khẩn

Từ ngữ khác

Từ	Nghĩa
Activation offline	Hoạt động kích hoạt thương hiệu tại chỗ: booth, sự kiện, cửa hàng
Kênh	Nơi người chơi chơi: `kiosk`, `tv`, `web`, `app` (webview), `zalo` — trùng giá trị `data-platform` của design system
Attract loop	Màn chờ động trên kiosk khi không ai chơi
Thể lệ	Quy định chính thức của campaign công bố cho người chơi
Tỉ lệ trúng	Xác suất một phiên chơi trúng một quà, cấu hình trong cơ cấu giải
Đối soát	So khớp số quà xuất kho với số lượt trúng đã cấp
OTP	Mã một lần gửi qua SMS / Zalo ZNS để xác thực SĐT
ZNS	Zalo Notification Service — tin nhắn thông báo qua Zalo
MVP	Bản phát hành đầu tiên — xem Lộ trình

Quy ước mã trong tài liệu

Tiền tố	Dùng cho	Ví dụ
`US-<MOD>-nn`	User story	`US-QUA-01`
`BR-<MOD>-nn`	Quy tắc nghiệp vụ	`BR-QUA-03`
`AC-<MOD>-nn`	Tiêu chí nghiệm thu	`AC-QUA-05`
`Q-<MOD>-nn`	Câu hỏi mở	`Q-QUA-02`
`D-nn`	Quyết định (sổ chung)	`D-04`

Mã module	Trang
`TQ`	Tổng quan
`OFF` · `ZMA` · `WEB`	Activation offline · Zalo Mini App · Website & mobile
`GAME` · `MODE`	Khung game · Chế độ chơi
`QLG` · `QUA` · `CMP` · `KH` · `TK` · `BC`	Quản lý game · Kho quà · Campaign · Khách hàng · Tài khoản · Báo cáo
`DL` · `GL` · `VH`	Dữ liệu cá nhân · Chống gian lận · Hiệu năng & vận hành
`TH`	Tích hợp

Lịch sử thay đổi

Bản	Ngày	Người sửa	Nội dung
0.1	2026-11-11	PM	Khởi tạo; thêm trạng thái người chơi, lead, phòng chơi, phiên bản game