Fotokio — Sổ tay KTV vận hành

Kiosk in ảnh tự phục vụ: khách chọn khung, quét QR, chỉnh ảnh trên điện thoại, in tại kiosk bằng mã in. Tài liệu này chỉ cho KTV tại sự kiện: setup, vận hành, theo dõi để xử lý sớm, sự cố.

Ảnh minh họa chụp trước M8, có thể khác chi tiết nhỏ; lời văn bên cạnh là đúng.

1. Việc của KTV và thứ cần có

Kiosk — PC Windows màn cảm ứng, Chrome kiosk mode. Khách chạm khung, quét QR, in ảnh.

Điện thoại khách — trang s.fotokio.com, không cài app. Mở bằng QR hoặc gõ mã 3 ký tự.

Print-agent — chạy ngầm trên PC kiosk, nhận lệnh in, in ra máy in, báo máy in và giấy mỗi 60 giây.

Console — app.fotokio.com (mở được trên điện thoại). Sự kiện, khung ảnh, màn hình kiosk, kiosk, báo cáo, sức khỏe.

Môi trường thử (demo) có tiền tố demo-; dùng để tập, không tính vào báo cáo sự kiện thật.

Thứ cần có	Lấy ở đâu
Tài khoản Console	Đăng nhập bằng nút "Đăng nhập Google" với đúng email được cấp. Báo "Email này chưa được cấp quyền": liên hệ Owner để cấp email.
PIN cá nhân (4–8 số)	Tự đặt ở Console → Tài khoản của tôi (mục 2.1). Chưa đặt PIN thì không được gán kiosk.
Điện thoại đăng nhập sẵn Console	Để quét QR mở khóa nhân viên tại kiosk (mục 4.1).
Mã kiosk (ví dụ K001)	Tự tạo ở Console → Kiosk. Khóa kiosk không bao giờ hiện cho người; chỉ có mã cài đặt một lần.
Gói print-agent	GitHub Actions → lần chạy CI gần nhất trên `main` → artifact `print-agent-<sha>`. Chưa có thì liên hệ Owner.
Việc KTV tự làm được	Tạo sự kiện, chọn Client, khung ảnh, 4 màn hình kiosk, tạo kiosk, mã cài đặt, máy in, PIN cá nhân.
Việc phải liên hệ Owner	Cấp email, "Xoay khóa" kiosk, hạn mức dịch vụ, gán sự kiện cho người khác.

2. Setup

2.1 Tài khoản và PIN cá nhân

Mở app.fotokio.com → Đăng nhập Google bằng email được cấp.
Menu Tài khoản → nhập PIN 4–8 chữ số → Lưu PIN. PIN chỉ của bạn, không chia sẻ.
Quên PIN: đặt PIN mới ở cùng chỗ.
Nhập sai PIN 5 lần liên tiếp tại một kiosk thì riêng bạn bị khóa ở kiosk đó 2 phút (lần sau gấp đôi, tối đa 15 phút). KTV khác vẫn dùng bình thường.

2.2 Tạo sự kiện và chọn Client

Console → Sự kiện → tạo sự kiện: tên, giờ bắt đầu / kết thúc, trạng thái live.
Chọn Client đặt dịch vụ trong ô Client của sự kiện, rồi Lưu. Không thấy Client cần chọn: liên hệ Owner.
Tab Kiosk của sự kiện: gán đúng mã kiosk sẽ dùng.

**Tổng quan sự kiện.** KPI và thẻ "Kiểm tra trước sự kiện".

2.3 Khung ảnh

Mỗi khung có nền PNG và các ô ảnh. Mở từng khung trong trình sửa.
Không còn cảnh báo, rồi bấm Lưu.
Thử khung với ảnh thật trước khi chốt.

2.4 Bốn màn hình kiosk

Chào, chọn khung, hàng chờ, hoàn thành. Xem trước bên phải đúng như kiosk hiện. Nhớ bấm Lưu: kiosk chỉ nhận thay đổi sau khi lưu (cập nhật trong 30 giây).

Hiện "Tương phản thấp" ở ô màu nhấn: đổi màu khác, nếu không nút trên kiosk khó thấy.

2.5 Tạo kiosk và mã cài đặt

Console → Kiosk → tạo kiosk (mã K001, K002...). Chọn máy in, khổ giấy 4x6, in tự động, số bản khách tự in (mặc định 1), thời gian chờ (mặc định 3 phút).
Bấm Tạo mã cài đặt: mã 8 ký tự, dùng một lần, hết hạn sau 15 phút. Tạo ngay trước khi cài, đừng tạo từ hôm trước.
Gán kiosk vào sự kiện ở tab Kiosk của sự kiện.

Quản trị kiosk — **Console → Kiosk.** Khóa kiosk không hiện ở đây.

**Tab Kiosk của sự kiện.** Cột trạng thái: kiosk, print-agent, máy in, giấy.

2.6 Cài PC kiosk bằng install.ps1

Cài Node.js 22 trở lên và driver máy in (DNP / Canon). In thử một trang từ Windows.
Giải nén gói print-agent (có dist\, scripts\, node_modules\).
Tạo mã cài đặt mới (mục 2.5).
Mở PowerShell quyền Administrator trong thư mục gói và chạy:

powershell -ExecutionPolicy Bypass -File install.ps1 -KioskCode K001 -Env prod -AgentDir .\print-agent -PrinterName "DS-RX1"

Script hỏi mã cài đặt (hoặc thêm -InstallCode <mã>), tự ghi khóa vào print-agent.env, cài print-agent vào C:\Fotokio\print-agent, tạo tác vụ "Fotokio Print Agent", đặt Chrome kiosk tự mở, tắt ngủ / tắt màn hình. Bạn không bao giờ thấy hay dán khóa kiosk.

Báo lỗi	Làm
"Ma da dung hoac het han"	Mã đã dùng hoặc quá 15 phút. Tạo mã mới.
"Sai ma kiosk"	Sai `-KioskCode`, sai `-Env` (`demo` / `prod`) hoặc gõ sai mã cài đặt.

Thứ tự: chạy script trước, mở trang kiosk sau. Chrome kiosk tự lấy mã và khóa từ print-agent trên cùng máy trong cửa sổ ghép khóa 10 phút đầu sau khi agent chạy, chỉ một lần. Quá 10 phút: khởi động lại tác vụ "Fotokio Print Agent" rồi mở lại trang. Không nhập mã cài đặt khác ở màn "Cài đặt kiosk" sau khi script đã đổi mã: mỗi lần đổi mã cấp khóa mới và print-agent mất khóa.

Khởi động lại PC (hoặc đăng xuất / đăng nhập). Chrome tự vào màn chào.
Nếu hiện màn Cài đặt kiosk: nhập mã kiosk và một mã cài đặt mới, bấm Cài đặt.

**Cài đặt kiosk** (chỉ khi không tự lấy được khóa).

Màn chào — **Vào được màn chào** là kiosk đã kết nối đúng.

2.7 Máy in

Tên máy in trong -PrinterName đúng như Windows → Printers. Không thấy máy in thì script cảnh báo và bật máy in ảo (ảnh ra file ở C:\Fotokio\prints): chỉ để thử, không in thật.
Đủ giấy và ribbon, khổ 4x6, không kẹt, cáp USB chắc.
PRINT_DRY_RUN=0 trong print-agent.env khi in thật.
In thử một vòng đầy đủ (mục 5.1) trước giờ mở.

3. Vận hành

3.1 Luồng khách 8 bước (dưới 3 phút, không cần KTV)

Chọn khung — **1. Kiosk: chọn khung.** Chạm màn chào, chạm một khung.

**2. Kiosk: QR + mã 3 ký tự** trong 20 giây. Mỗi lần chạm là một phiên mới.

Khung trống — **3. Điện thoại: khung ô trống.** Chạm ô, chọn ảnh.

Chỉnh ảnh — **4. Chỉnh trong ô:** xoay, phóng, kéo căn.

Mã in — **5. Lưu → mã in 4 số.** Khách giữ màn này.

Hàng chờ — **6. Kiosk: hàng chờ in.** Ảnh hiện trong 1 giây, mới nhất trước.

Hộp thoại in — **7. Chạm ảnh → nhập mã in → In.** Hoặc "In bằng QR".

**8. Đang in → Hoàn thành.** Về hàng chờ sau 10 giây; 3 phút không chạm thì về màn chào.

3.2 Việc của KTV trong giờ chạy

Đứng gần kiosk 15 phút đầu, chỉ khách quét QR và nhập mã in.
Theo dõi giấy / ribbon; đổi khi máy in báo.
Mở Console trên điện thoại: tab Kiosk, Tổng quan, Sức khỏe (mục 5).
Không tắt Chrome, không tắt PC. Cần thao tác Windows thì thoát kiosk bằng PIN (mục 6.10).
Khách cần giúp: mục 4.

4. Hỗ trợ khách

Khách nói	KTV làm
"Không quét được QR"	Bảo khách mở `s.fotokio.com` và gõ mã 3 ký tự dưới QR (không phân biệt hoa thường). Mã chỉ dùng `3479ACDEFHJKMNPQRTWXY`; sống 2 phút. Gõ sai nhiều lần liên tục trên cả sự kiện thì tạm chỉ nhận QR (khách chạm khung mới).
"QR tắt mất rồi"	QR hiện 20 giây. Chạm lại khung lấy QR mới. QR và mã chỉ dùng một lần, ảnh chụp QR không vào được.
"Nút Lưu bị mờ"	Còn ô bắt buộc chưa có ảnh. Dòng "Còn N ô chưa có ảnh" ngay trên nút. Chạm ô trống thêm ảnh.
"Lưu rồi mà kiosk không thấy"	Gõ 4 số mã in vào ô Tìm theo mã in. Không thấy: mục 6.6.
"Quên mã in" / "hết pin"	Chạm ảnh → Nhân viên → Mở khóa bằng QR Google hoặc Dùng PIN cá nhân → In (mục 4.1).
"Muốn in thêm" / "in lại"	Khách tự in đúng số bản cho phép (mặc định 1). KTV: Nhân viên → chọn số bản → In.
"Muốn sửa sau khi Lưu"	Chưa in: bấm Chỉnh lại trên màn mã in rồi Lưu lại. Đã in: làm phiên mới.
"Mở link báo mã đã dùng / phiên hết hạn"	Phiên chỉ sống trong trình duyệt đã quét QR. Đổi trình duyệt / điện thoại thì chạm khung mới trên kiosk.
"Nhập mã bị khóa"	Sai mã in 3 lần thì ảnh khóa 1 phút. Chờ, hoặc KTV in qua Nhân viên.

Ô thiếu — **Lưu mờ** vì còn ô thiếu ảnh.

Nhân viên chọn số bản — **Nhân viên → số bản → In.**

4.1 Nhân viên mở khóa: QR Google hoặc PIN cá nhân

Chạm ảnh trong hàng chờ → Nhân viên → chọn một cách:

Cách	Làm	Ghi chú
Mở khóa bằng QR	Quét QR trên kiosk (sống 2 phút) bằng điện thoại đã đăng nhập Console → xác nhận trên điện thoại.	Cần mạng. Kiosk vào chế độ nhân viên 10 phút và hiện email của bạn; trong 10 phút in, in lại, in nhiều bản, xóa ảnh khỏi hàng chờ không phải nhập thêm.
Dùng PIN	Chọn tên mình trong danh sách → nhập PIN cá nhân → Xác nhận.	Làm được cả khi mất mạng. Danh sách chỉ có người được gán kiosk này.

Mọi lần in của nhân viên ghi email người làm và số bản vào nhật ký, lịch sử in, báo cáo Excel. Không thấy tên mình trong danh sách PIN: kiosk chưa tải cấu hình, thử "Tải lại cấu hình" (mục 6.10) hoặc liên hệ Owner.

5. Theo dõi tình trạng để xử lý sớm

Mục tiêu: thấy dấu hiệu trước khi khách thấy. Làm theo thứ tự: kiểm tra trước sự kiện, biết các dấu hiệu sớm, kiểm tra định kỳ.

5.1 Checklist trước sự kiện

Console → sự kiện → Tổng quan → Kiểm tra ngay. Hệ thống tự chạy 24 giờ và 2 giờ trước giờ mở; mục đỏ báo qua Telegram. Kết quả hiện "Đạt hết" hoặc "N mục chưa đạt" kèm ✓ / ✗ từng mục. Chạy tay lại sau khi sửa.

Mục	Nghĩa là	Khi ✗ làm gì
Kiosk <mã> trực tuyến	Kiosk gửi nhịp tim trong 2 phút gần nhất	Kiểm tra PC bật, Chrome kiosk mở, mạng. Mục 6.2.
Print-agent <mã> trực tuyến	Print-agent trên PC báo nhịp tim (60 giây một lần)	Khởi động tác vụ "Fotokio Print Agent". Mục 6.4.
Máy in <mã> có giấy	Máy in báo còn giấy / ribbon	Nạp giấy, gỡ kẹt, bật máy in; đợi 60 giây rồi chạy lại.
Render thử "<tên khung>"	Hệ thống dựng thử một ảnh thành phẩm từ từng khung của sự kiện	Mở khung trong trình sửa, sửa cảnh báo, Lưu. Còn ✗: liên hệ Owner.
Hạn mức đủ cho sự kiện	Dịch vụ miễn phí còn đủ cho sự kiện	Liên hệ Owner ngay.
Cơ sở dữ liệu (Supabase thức)	Truy cập được cơ sở dữ liệu	Chạy lại sau 1 phút; vẫn ✗ thì liên hệ Owner.
Lưu trữ ảnh R2 đã cấu hình	Truy cập được kho ảnh	Chạy lại sau 1 phút; vẫn ✗ thì liên hệ Owner.
Có kiosk được gán	Sự kiện có ít nhất một kiosk	Tab Kiosk → gán kiosk theo mã (mục 2.5).
Có template	Sự kiện có ít nhất một khung ảnh	Tab Khung ảnh → tạo hoặc sao chép khung (mục 2.3).

Ngoài Kiểm tra ngay, chạy thử trọn một vòng bằng điện thoại của bạn: chạm khung, quét QR, đủ ảnh các ô, Lưu, nhập mã in tại kiosk, cầm ảnh in. Rồi thử PIN cá nhân một lần ở Nhân viên.

Kiểm tra ngay: mọi mục ✓
Giấy và ribbon đủ cho cả sự kiện, có cuộn dự phòng
Một vòng thử khách chạy được, ảnh in đúng khổ, không viền trắng lạ
PIN cá nhân thử được tại kiosk
Kiosk về màn chào, lau màn hình, cất bàn phím / chuột

5.2 Dấu hiệu sớm → ý nghĩa → việc làm ngay

Nơi xem	Dấu hiệu sớm	Ý nghĩa	Làm ngay
Console → sự kiện → tab Kiosk	Kiosk offline	Mất 2 nhịp tim (hơn 2 phút không báo). PC tắt, Chrome đóng hoặc mất mạng.	Nhờ người tại site nhìn màn kiosk. Mục 6.2.
Tab Kiosk	Print-agent offline	Khách bấm In sẽ lỗi.	Mục 6.4, làm ngay khi chưa có khách xếp hàng.
Tab Kiosk	Giấy báo không OK (hoặc hiện trạng thái máy in)	Sắp hoặc đã hết giấy / ribbon / kẹt.	Nạp giấy, gỡ kẹt trước khi khách bấm In. Mục 6.3.
Tab Kiosk / trang Sức khỏe	"Lần cuối" (heartbeat) cũ hơn 60 giây	Nhịp tim gửi 60 giây một lần; quá 2 nhịp là mất kết nối.	Làm mới trang; nếu vẫn cũ thì xử lý như offline.
Console → Sức khỏe, thanh hạn mức	Vàng (60–85%) / đỏ (trên 85%, kèm ngày dự báo hết)	Dịch vụ miễn phí sắp hết.	Báo Owner. Vẫn vận hành bình thường.
Trang Sức khỏe	Dải "giảm tải" (mức 1 hoặc 2)	Hệ thống tạm tắt thumbnail thư viện (mức 1), thêm xuất báo cáo và in lại từ xa (mức 2). Upload, render, in vẫn chạy.	Báo Owner; hoãn việc xuất báo cáo / in lại từ xa.
Trang Sức khỏe	Cảnh báo đang mở (vàng / đỏ, kèm dòng hành động "→")	Hệ thống phát hiện sự cố.	Đọc dòng hành động và làm theo; báo Owner đóng cảnh báo.
Trên kiosk	Dải đỏ "Mất kết nối mạng"	PC mất mạng hoặc API không tới.	Mục 6.2.
Trên kiosk	Cảnh báo "Máy in lỗi N lần liên tiếp" (từ lần thứ 2)	Máy in hoặc print-agent đang hỏng.	Mục 6.3.
Điện thoại / Telegram	Tin cảnh báo (nhãn `demo` / `prod`, mức vàng / đỏ, một dòng hành động)	Hệ thống tự báo: kiểm tra trước sự kiện, in thất bại 2 lần, render quá 10 giây, lỗi upload, trễ kết nối.	Làm theo dòng hành động. Chưa nhận được Telegram thì hỏi Owner.
PC kiosk: `http://127.0.0.1:17877/status`	Không mở được, hoặc `paperOk` là `false`	Không mở được: print-agent không chạy. `paperOk:false`: máy in báo hết giấy / lỗi.	Mục 6.4 hoặc 6.3.
PC kiosk: `C:\Fotokio\print-log.jsonl`	Nhiều dòng `ok:false`, hoặc có `offline:true`	Mỗi dòng một lệnh in. `ok:false` là in lỗi; `offline:true` là in lúc mất mạng.	Đối chiếu giờ, tìm nguyên nhân (giấy, mạng). Dùng đối chiếu số bản với báo cáo.

**Trang Sức khỏe.** Hạn mức, kiosk, cảnh báo.

Dải mất mạng — **Dải "Mất kết nối mạng"** trên kiosk.

5.3 Kiểm tra định kỳ trong sự kiện (mỗi 30–60 phút)

Giấy: nhìn máy in thật; ước lượng số tờ còn so với số khách đang xếp hàng.
Hàng chờ: kiosk có ảnh nằm lâu không ai in không (nhiều ảnh cũ thường là khách quên mã in hoặc bỏ đi, không phải lỗi).
Số bản in khớp: số bản trong Tổng quan (Console) ≈ số tờ đã ra khỏi máy in ≈ số dòng ok:true trong print-log.jsonl. Lệch nhiều thì kiểm tra giấy kẹt hoặc in lỗi.
Tab Kiosk: kiosk và print-agent đều online, "lần cuối" dưới 2 phút.
Sức khỏe: có cảnh báo mới đang mở không, thanh hạn mức có đổi màu không.
Kiosk không báo lỗi lạ, màn hình không tối.

6. Xử lý sự cố

Thứ tự ưu tiên: 1) khách vẫn in được (chuyển sang in qua Nhân viên nếu cần); 2) tìm đúng thông báo trên màn hình; 3) làm theo mục dưới; 4) quá 5 phút chưa hết thì giữ khách in qua Nhân viên và báo Owner kèm ảnh chụp màn hình, mã kiosk, giờ xảy ra.

Triệu chứng	Mục
Màn "Cài đặt kiosk" / "Khóa kiosk đã được thay"	6.1
Mất kết nối mạng	6.2
Máy in lỗi	6.3
Print-agent offline	6.4
Sai mã in / ảnh bị khóa	6.5
Khách Lưu mà kiosk không thấy ảnh	6.6
Đổi màn hình mà kiosk không đổi	6.7
Kiosk tự về màn chào	6.8
Khách thấy "Mã không đúng" / "Phiên hết hạn"	6.9
Thoát kiosk thao tác Windows	6.10
Sức khỏe vàng / đỏ	6.11
Gọi Owner	6.12

Kiosk 6.1 Hiện "Cài đặt kiosk", "Sai mã kiosk hoặc mã cài đặt" hoặc "Khóa kiosk đã được thay"

Dấu hiệu: thay vì màn chào, kiosk hỏi mã kiosk và mã cài đặt.

Xử lý: Console → Kiosk → Tạo mã cài đặt. Nếu print-agent cũng báo mất khóa (6.4): chạy lại install.ps1 -KioskCode ... -InstallCode <mã> rồi mở lại trang kiosk. Chỉ khi print-agent không chạy mới nhập mã ở màn "Cài đặt kiosk". Mỗi mã dùng một lần, đừng dùng hai mã cho một lần cài. "Mã đã dùng hoặc hết hạn": tạo mã mới. "Sai mã": kiểm tra mã kiosk trong URL. "Khóa kiosk đã được thay" (khóa bị đổi khi PC đang tắt): xử lý như trên.

Kiosk 6.2 Dải đỏ "Mất kết nối mạng"

Dấu hiệu: dải trên cùng; ảnh đang chờ vẫn hiện; QR mới không tạo được.

Xử lý: (1) Cắm lại dây / Wi-Fi của PC. (2) Khi mất mạng khách không tự in được: chạm ảnh → Nhân viên → Dùng PIN → chọn tên, nhập PIN cá nhân → In. Print-agent in từ ảnh đã tải sẵn và tự gửi số lần in lên hệ thống khi có mạng lại. (3) Ảnh báo "chưa được tải về máy kiosk" là ảnh Lưu sau khi mất mạng: phải có mạng mới in. (4) Có mạng lại, dải tự ẩn, không cần tải lại. Mở khóa bằng QR không dùng được khi mất mạng. Báo "Kiosk chưa có PIN dự phòng khi mất mạng": chỉ còn cách khôi phục mạng.

Kiosk 6.3 "Máy in chưa phản hồi" / "Máy in báo lỗi" / "Máy in lỗi N lần liên tiếp"

Dấu hiệu: bấm In hiện lỗi "nhờ nhân viên"; sau 2 lần lỗi liên tiếp kiosk hiện dải cảnh báo (chạm để ẩn).

Nguyên nhân theo thứ tự: hết giấy / ribbon, kẹt giấy, máy in tắt hoặc tuột USB, driver treo, print-agent không chạy (6.4), mạng.

Xử lý: (1) Nhìn đèn / màn máy in, nạp giấy, gỡ kẹt, bật lại. (2) Tab Kiosk xem cột máy in / giấy (cập nhật 60 giây). (3) Chạm ảnh → Nhân viên → In lại; lệnh lỗi không tính vào báo cáo. (4) Vẫn lỗi: Windows → Printers, xóa hàng đợi in, in thử một trang. (5) Driver treo: khởi động lại PC; kiosk và print-agent tự mở lại. Lệnh đang treo được gửi lại trong 15 phút, không in trùng.

Print-agent 6.4 Print-agent offline, hoặc kiosk in lỗi dù máy in bình thường

Dấu hiệu: tab Kiosk không thấy nhịp tim agent; Kiểm tra ngay ✗ print-agent.

Xử lý trên PC kiosk (thoát kiosk, mục 6.10):

Task Scheduler → tác vụ Fotokio Print Agent: không chạy thì chuột phải → Run.
Mở http://127.0.0.1:17877/status: phải ra JSON có tên máy in và paperOk.
Xem C:\Fotokio\print-agent\print-agent.env (quyền Administrator): API_BASE_URL đúng môi trường, KIOSK_CODE đúng, KIOSK_SECRET không trống (không sửa tay), PRINTER_NAME đúng, PRINT_DRY_RUN=0.
Chạy tay xem lỗi: trong C:\Fotokio\print-agent chạy node --env-file=print-agent.env dist\index.js. "Đã kết nối API" là tốt; "mất kết nối API, đang thử lại" là mạng; "khóa kiosk không còn hợp lệ ... chạy lại install.ps1 với mã cài đặt mới" là phải cài lại bằng mã mới (6.1).
Nhật ký in: C:\Fotokio\print-log.jsonl.
Chrome kiosk hiện "Cài đặt kiosk" dù agent chạy: quá cửa sổ ghép khóa 10 phút. Khởi động lại tác vụ agent rồi mở lại trang, hoặc nhập mã cài đặt mới.

Kiosk 6.5 "Sai mã in", "ảnh bị khóa 1 phút", "Vượt số bản cho phép"

Mã in là 4 số trên màn "Đã vào hàng chờ" của điện thoại khách, chỉ gồm 2 3 4 5 7 9. Sai 3 lần thì khóa 1 phút. Khách chỉ in được số bản đã cho phép.

Xử lý: đối chiếu mã trên điện thoại khách; hoặc "In bằng QR" rồi khách quét bằng chính điện thoại đã chỉnh ảnh; hoặc KTV in qua Nhân viên. Muốn khách tự in nhiều bản: tăng "số bản khách tự in" trong cấu hình kiosk.

Kiosk 6.6 Khách đã Lưu nhưng ảnh không hiện trong hàng chờ

Kiểm tra: (1) Khách có thấy màn "Đã vào hàng chờ + mã in" chưa? Chưa thì Lưu chưa thành công, bảo khách bấm Lưu lại. (2) Gõ mã in vào ô tìm. (3) Có dải mất mạng không (6.2). (4) Hàng chờ là của cả sự kiện nên in được ở kiosk nào của sự kiện đó; khác sự kiện thì không. (5) Giữ góc trên trái 3 giây → PIN cá nhân → Tải lại cấu hình.

Kiosk 6.7 Đổi màn hình / khung trên Console nhưng kiosk không đổi

Bình thường cập nhật trong 30 giây. Không đổi: kiểm tra đã bấm Lưu, đúng sự kiện, kiosk không mất mạng (6.2); rồi Tải lại cấu hình (6.10).

Kiosk 6.8 Kiosk tự về màn chào giữa chừng

Đó là thời gian chờ không thao tác (mặc định 3 phút). Ảnh khách vẫn trong hàng chờ: chạm màn chào → Hàng chờ in.

Điện thoại 6.9 Khách thấy "Mã không đúng", "Phiên hết hạn", "Ảnh đã in", "không phải ảnh của máy này"

Mã 3 ký tự sai / đã dùng / hết hạn, phiên hết hạn hoặc mở bằng trình duyệt khác: chạm khung mới trên kiosk. Ảnh đã in: không chỉnh lại được; in thêm qua Nhân viên. "In bằng QR" phải quét bằng chính điện thoại đã chỉnh ảnh.

Không phải máy này — QR in quét nhầm điện thoại.

Kiosk 6.10 Thoát kiosk thao tác Windows, tải lại cấu hình

Giữ góc trên trái 3 giây → chọn tên, nhập PIN cá nhân → bảng quản trị: Tải lại cấu hình · Gỡ cài đặt kiosk này · Đóng. Ra Windows: cắm bàn phím, bấm Alt+F4. Xong thì đăng xuất / đăng nhập lại Windows: Chrome kiosk và print-agent tự mở. Không bấm "Gỡ cài đặt kiosk này" trừ khi Owner yêu cầu (phải cài lại bằng mã mới).

Console 6.11 Trang Sức khỏe báo vàng / đỏ, hoặc dải giảm tải

Xanh dưới 60%, vàng 60–85%, đỏ trên 85%. Hệ thống tự giảm tải và báo Telegram. KTV không xử lý tại chỗ: báo Owner, tiếp tục vận hành.

Khác 6.12 Gọi Owner ngay

Cần cấp email, "Xoay khóa" kiosk, đổi hạn mức, gán người khác vào sự kiện: chỉ Owner làm.
Kiểm tra ngay ✗ ở cơ sở dữ liệu, lưu trữ, hạn mức hoặc render thử mà chạy lại không hết.
Cả sự kiện không tạo được QR dù mạng tốt: kèm giờ và mã kiosk.
Quên PIN thì tự đặt lại (mục 2.1); bị khóa thì chờ hết thời gian khóa.

7. Cuối sự kiện

Console → sự kiện → Báo cáo in: tổng bản in theo kiosk / giờ; Xuất Excel.
Đối chiếu với C:\Fotokio\print-log.jsonl nếu số bản có tranh cãi; lần in lúc mất mạng có "offline": true và đã được cộng vào báo cáo khi có mạng lại.
Thư viện ảnh: tải thành phẩm, in lại từ xa nếu khách quay lại.
Đưa kiosk về màn chào, tắt máy in trước, rồi tắt PC bình thường (không gỡ cài đặt kiosk).
Thời hạn: ảnh gốc của khách tự xóa sau 24 giờ; ảnh thành phẩm giữ 30 ngày.
Ghi lại sự cố đã gặp (giờ, mã kiosk, cách xử lý) và báo Owner.