Thiết bị check-in khuôn mặt (Hikvision) trên DANAVA Studio

Thiết bị check-in khuôn mặt (Hikvision) trên DANAVA Studio — dành cho chủ CLB / quản lý vận hành trên DANAVA Studio. Bài thuộc cụm công nghệ & tích hợp: nắm đúng khả năng sản phẩm, gắn SOP quầy, tránh hứa tính năng chưa có.

Liên kết: DANAVA Studio · QR check-in quầy · giải pháp check-in · tài liệu phần cứng docs/integrations/yeu-cau-phan-cung-checkin-khoa-cua.html.

Hai chiều tích hợp: webhook vào luôn chạy, push mặt là best-effort

Chiều máy → Studio (webhook `POST /api/v1/webhooks/in/hikvision`): máy tự kết nối ra cloud, không cần IP public tại CLB — phù hợp NAT thông thường. Đây là chiều bắt buộc để check-in ghi nhận trên Studio.

Chiều Studio → máy (enroll khuôn mặt): đẩy ảnh qua ISAPI — chỉ chạy nếu cloud with được IP LAN máy hoặc có agent trung gian (`tools/checkin-agent`) trên PC cùng mạng. Không có agent: lễ tân có thể nhập `member.code` tay trên máy; webhook vẫn map `employeeNoString == member.code`.

Chủ CLB không nên hứa hội viên 'quét mặt tự động 100%' ngay ngày đầu nếu chưa test enroll trên site thật.

Checklist đăng ký thiết bị trên Studio

Vào Studio > Hệ thống > Thiết bị checkin — tạo thiết bị, lưu API key (chỉ hiện một lần).

Dán Webhook URL (đã nhúng key) vào màn 'Trung tâm giám sát' / HTTP listening trên máy Hikvision theo hướng dẫn lắp đặt.

Test một lượt quét: dashboard realtime nhận `checkin.created`, lịch sử check-in có method 'Máy chấm công'.

Webhook: chống trùng, context CLB, CLB bị suspend

Máy hay bắn nhiều sự kiện một lần quét — Studio nếu đã có check_in cùng thiết bị trong 5 phút thì trả bản ghi cũ, không trừ buổi/gói lần hai.

Route webhook tự set ClubContext từ thiết bị (API key) — không tin club_id client gửi.

CLB bị khoá do nợ phí SaaS: webhook vẫn trả 200 nhưng bỏ qua sự kiện — chủ cần thanh toán phí nền tảng trước khi vận hành lại.

Đăng ký khuôn mặt và agent LAN

Enroll từ Studio (avatar HV hoặc ảnh upload lúc gọi API): 3 bước ISAPI UserInfo + FDID + upload multipart.

Nếu máy sau router không reachable từ cloud: cài checkin-agent trên máy tính LAN, agent poll job và đẩy ảnh nội bộ.

Fallback: hiển thị member.code cho lễ tân nhập trên máy — vẫn đảm bảo webhook đối soát đúng HV.

Gói truy cập khu vực (access_package_ids)

Cấu hình `checkin_devices.access_package_ids`: rỗng = mọi HV hợp lệ; có danh sách = chỉ HV đang có gói thuộc list mới qua cửa/khu (vd tách khu PT).

CheckInService kiểm tra khi có device context — HV sai gói nhận mã CHECKIN_DENIED kèm tên HV trên UI quầy/TV.

Train lễ tân: không 'mở cửa tay' bypass khi máy từ chối — xử lý gói hoặc chuyển khu check-in QR.

Health, offline, reconcile (opt-in)

Job CheckDeviceHealth 15 phút: im lặng >30 phút → offline, báo owner/manager tối đa 1 lần/ngày.

Opt-in `remote_features_enabled`: mở cửa từ xa + job PullCheckinDeviceEvents 5 phút kéo log máy bù check-in lỡ webhook (đánh dấu reconciled).

Mặc định remote TẮT vì mở cửa là hành động vật lý — chỉ bật khi có SOP và phân quyền lễ tân.

SOP vận hành hàng ngày cho quầy

Sáng ca: xem card thiết bị online; offline → kiểm tra mạng/nguồn máy trước khi mở cửa đông.

HV mới: tạo member.code → enroll hoặc nhập tay trên máy → test quét một lần.

Cuối ngày: đối chiếu số check-in method device với cảm nhận ca — nếu lệch lớn, xem reconciled events.

Tình huống	Dấu hiệu	Việc làm	Không làm
Máy offline	Card đỏ trên Studio	Kiểm tra LAN/điện	Tắt check-in QR
Enroll fail	Mặt không nhận	Thử agent / nhập code	Hứa 'mai fix cloud'
Double quét	2 log cách vài giây	Hệ thống chống 5p	Trừ buổi tay
Sai khu PT	CHECKIN_DENIED	Kiểm tra gói access	Mở cửa remote tùy tiện

In checklist nghiệm thu 12 mục từ tài liệu phần cứng trước khi trả tiền thầu.

Không dán API key thiết bị vào group chat — rotate nếu lộ.

Soft open: một máy một cửa, không gắn khoá nhiều lối cùng lúc tuần đầu.

Backup plan ca cao điểm: QR quầy vẫn bật khi máy bảo trì.

HV PT khu riêng: cập nhật access_package_ids khi đổi catalog gói.

Ghi sổ: ngày bật remote_features và ai được phép mở cửa.

Sau mưa/mất điện: kiểm tra card online trước giờ vàng.

In checklist nghiệm thu 12 mục từ tài liệu phần cứng trước khi trả tiền thầu.

Không dán API key thiết bị vào group chat — rotate nếu lộ.

Soft open: một máy một cửa, không gắn khoá nhiều lối cùng lúc tuần đầu.

Backup plan ca cao điểm: QR quầy vẫn bật khi máy bảo trì.

HV PT khu riêng: cập nhật access_package_ids khi đổi catalog gói.

Ghi sổ: ngày bật remote_features và ai được phép mở cửa.

Sau mưa/mất điện: kiểm tra card online trước giờ vàng.

In checklist nghiệm thu 12 mục từ tài liệu phần cứng trước khi trả tiền thầu.

Không dán API key thiết bị vào group chat — rotate nếu lộ.

Soft open: một máy một cửa, không gắn khoá nhiều lối cùng lúc tuần đầu.

Backup plan ca cao điểm: QR quầy vẫn bật khi máy bảo trì.

HV PT khu riêng: cập nhật access_package_ids khi đổi catalog gói.

Ghi sổ: ngày bật remote_features và ai được phép mở cửa.

Sau mưa/mất điện: kiểm tra card online trước giờ vàng.

In checklist nghiệm thu 12 mục từ tài liệu phần cứng trước khi trả tiền thầu.

Không dán API key thiết bị vào group chat — rotate nếu lộ.

Soft open: một máy một cửa, không gắn khoá nhiều lối cùng lúc tuần đầu.

Backup plan ca cao điểm: QR quầy vẫn bật khi máy bảo trì.

HV PT khu riêng: cập nhật access_package_ids khi đổi catalog gói.

Ghi sổ: ngày bật remote_features và ai được phép mở cửa.

Sau mưa/mất điện: kiểm tra card online trước giờ vàng.

In checklist nghiệm thu 12 mục từ tài liệu phần cứng trước khi trả tiền thầu.

Không dán API key thiết bị vào group chat — rotate nếu lộ.

Soft open: một máy một cửa, không gắn khoá nhiều lối cùng lúc tuần đầu.

Backup plan ca cao điểm: QR quầy vẫn bật khi máy bảo trì.

HV PT khu riêng: cập nhật access_package_ids khi đổi catalog gói.

Ghi sổ: ngày bật remote_features và ai được phép mở cửa.

Sau mưa/mất điện: kiểm tra card online trước giờ vàng.

In checklist nghiệm thu 12 mục từ tài liệu phần cứng trước khi trả tiền thầu.

Không dán API key thiết bị vào group chat — rotate nếu lộ.

Soft open: một máy một cửa, không gắn khoá nhiều lối cùng lúc tuần đầu.

Backup plan ca cao điểm: QR quầy vẫn bật khi máy bảo trì.

HV PT khu riêng: cập nhật access_package_ids khi đổi catalog gói.

Ghi sổ: ngày bật remote_features và ai được phép mở cửa.

Sau mưa/mất điện: kiểm tra card online trước giờ vàng.

In checklist nghiệm thu 12 mục từ tài liệu phần cứng trước khi trả tiền thầu.

Không dán API key thiết bị vào group chat — rotate nếu lộ.

Soft open: một máy một cửa, không gắn khoá nhiều lối cùng lúc tuần đầu.

Backup plan ca cao điểm: QR quầy vẫn bật khi máy bảo trì.

HV PT khu riêng: cập nhật access_package_ids khi đổi catalog gói.

Ghi sổ: ngày bật remote_features và ai được phép mở cửa.

Sau mưa/mất điện: kiểm tra card online trước giờ vàng.

In checklist nghiệm thu 12 mục từ tài liệu phần cứng trước khi trả tiền thầu.

Ghi chú triển khai 14 ngày — Thiết bị check-in khuôn mặt (Hikvision) trên DANAVA Studio

Ngày 1–3: đọc SOP liên quan và phân công owner. Ngày 4–7: cấu hình/thử trên Studio với dữ liệu thật hẹp. Ngày 8–10: train lễ tân 30–45 phút + viết FAQ quầy 5 câu. Ngày 11–14: đo một chỉ số (tỷ lệ redemption coupon, lệch tồn retail, thời gian check-in, % gia hạn app, số file Excel chuỗi đúng hạn…) và chỉnh SOP.

Không mở rộng sang chi nhánh 2 trước khi chi nhánh 1 tuân thủ ổn định hai tuần. Mọi thay đổi coupon, giá online hoặc modality check-in ghi ngày hiệu lực trên sổ vận hành.

Kỷ luật dữ liệu & không hứa ngoài sản phẩm

Bài thiet-bi-checkin-khuon-mat-hikvision-studio chỉ mô tả việc chủ CLB làm được với cấu hình và báo cáo hiện có. Không suy đoán số liệu khách hàng DANAVA. Không cam kết SLA nhà mạng/Zalo/PayOS/thiết bị. Khi nghi ngờ tính năng, xác minh trên môi trường thật của CLB hoặc hỏi hỗ trợ — không dạy lễ tân thao tác 'lách' làm vỡ đối soát.

Đọc tuần tự cụm F batch 15–16: kế toán MISA kỳ vọng → Hikvision → CRM lead → PT appointment → waitlist → coupon theo gói → tồn kho POS → so sánh check-in → tự mua app → báo cáo chuỗi. Mỗi mắt xích yếu đều có thể làm mất tiền hoặc mất uy tín boutique.

Ghi chú triển khai 14 ngày — Thiết bị check-in khuôn mặt (Hikvision) trên DANAVA Studio

Ngày 1–3: đọc SOP liên quan và phân công owner. Ngày 4–7: cấu hình/thử trên Studio với dữ liệu thật hẹp. Ngày 8–10: train lễ tân 30–45 phút + viết FAQ quầy 5 câu. Ngày 11–14: đo một chỉ số (tỷ lệ redemption coupon, lệch tồn retail, thời gian check-in, % gia hạn app, số file Excel chuỗi đúng hạn…) và chỉnh SOP.

Không mở rộng sang chi nhánh 2 trước khi chi nhánh 1 tuân thủ ổn định hai tuần. Mọi thay đổi coupon, giá online hoặc modality check-in ghi ngày hiệu lực trên sổ vận hành.

Kỷ luật dữ liệu & không hứa ngoài sản phẩm

Bài thiet-bi-checkin-khuon-mat-hikvision-studio chỉ mô tả việc chủ CLB làm được với cấu hình và báo cáo hiện có. Không suy đoán số liệu khách hàng DANAVA. Không cam kết SLA nhà mạng/Zalo/PayOS/thiết bị. Khi nghi ngờ tính năng, xác minh trên môi trường thật của CLB hoặc hỏi hỗ trợ — không dạy lễ tân thao tác 'lách' làm vỡ đối soát.

Đọc tuần tự cụm F batch 15–16: kế toán MISA kỳ vọng → Hikvision → CRM lead → PT appointment → waitlist → coupon theo gói → tồn kho POS → so sánh check-in → tự mua app → báo cáo chuỗi. Mỗi mắt xích yếu đều có thể làm mất tiền hoặc mất uy tín boutique.

Câu hỏi thường gặp

Model Hikvision nào đã test?

Spec ghi DS-K1T341CMW và SH-K1T9342MFWX — vẫn cần nghiệm thu 12 mục theo tài liệu phần cứng DANAVA trước go-live.

Không có agent thì check-in được không?

Có — webhook + nhập member.code trên máy; enroll mặt tự động có thể thiếu.

Khác QR check-in thế nào?

Cùng CheckInService và realtime; method hiển thị 'Máy chấm công' thay vì quét QR app/quầy.

Ai được bật mở cửa từ xa?

Opt-in trên thiết bị + quyền quầy; mặc định tắt.

Đa chi nhánh nhiều máy?

Mỗi máy một API key và thiết bị trên Studio; báo cáo theo CLB/chi nhánh.

CLB suspend SaaS thì sao?

Webhook bỏ qua sự kiện — thanh toán phí nền tảng để mở lại.

Tìm hiểu thêm: DANAVA Studio · Giải pháp Wellness · báo cáo doanh thu.

Lưu ý: Nội dung giáo dục cho chủ CLB / quản lý; mô tả quy trình vận hành quanh tính năng DANAVA Studio đã có. Không cấu thành tư vấn pháp lý, bảo mật chứng nhận hay cam kết SLA nhà cung cấp thanh toán/tin nhắn. Số liệu ví dụ là khung quản trị.