Lewati ke konten utama

Menyiapkan Pemetaan Akses Kamar Massal

Penyiapan Cepat

Sebagian besar hotel dapat menguji beberapa kamar dalam 5 hingga 10 menit. Jalankan dry run terlebih dahulu.

Gunakan skrip ini untuk memetakan banyak kamar sekaligus ke encoder keycard atau smart lock.

Referensi cepat​

SkripFungsiCocok untuk
scripts/bulk-keycard-room-mapping.mjsMembuat atau memperbarui pemetaan kamar encoder keycardNama kamar encoder mengikuti pola yang jelas
scripts/bulk-smart-lock-room-mapping.mjsMembuat atau memperbarui pemetaan kamar smart lockLock diberi nama atau ditetapkan secara massal

Sebelum memulai​

Konfirmasi hal berikut:

  • Anda dapat masuk menggunakan kredensial merchant
  • Anda mengetahui merchant ID tujuan
  • File env memuat TEST_MERCHANT_ID, TEST_USERNAME, dan TEST_PASSWORD
  • Anda menjalankan perintah dari root repositori
Memuat environment

Atur file env sebelum menjalankan skrip:

set -a
source packages/e2e-tests/.env.production-cloudbeds
set +a

Ubah jalur jika nama file env Anda berbeda.

Langkah 1: Uji rentang kecil​

  1. Jalankan dry run untuk rentang kamar kecil.
  2. Tinjau output dengan cermat.
  3. Pastikan nama kamar sesuai dengan kamar yang diharapkan.

Contoh encoder keycard​

node scripts/bulk-keycard-room-mapping.mjs \
  --merchant-id "$TEST_MERCHANT_ID" \
  --username "$TEST_USERNAME" \
  --password "$TEST_PASSWORD" \
  --room-name-pattern 'TES({n})' \
  --start 10 \
  --end 20 \
  --dry-run

Contoh smart lock​

node scripts/bulk-smart-lock-room-mapping.mjs \
  --merchant-id "$TEST_MERCHANT_ID" \
  --username "$TEST_USERNAME" \
  --password "$TEST_PASSWORD" \
  --vendor igloohome \
  --room-name-pattern 'TES({n})' \
  --lock-id 'IGB40903c5f5' \
  --start 1 \
  --end 5 \
  --allow-assigned-elsewhere \
  --dry-run

Langkah 2: Jalankan pemetaan sebenarnya​

  1. Hapus --dry-run.
  2. Pertahankan rentang kamar yang sama.
  3. Jalankan perintah lagi.

Gunakan --update-existing untuk memperbaiki pemetaan yang sudah ada.

Encoder keycard​

Gunakan scripts/bulk-keycard-room-mapping.mjs jika nama kamar encoder mengikuti pola yang dapat diprediksi.

Fungsi​

  • Menentukan kamar PMS dari /api/rooms
  • Membuat atau memperbarui /api/keycard-encoder-room-mapping
  • Menghasilkan encoderRoomName dari nomor kamar

Contoh​

node scripts/bulk-keycard-room-mapping.mjs \
  --merchant-id "$TEST_MERCHANT_ID" \
  --username "$TEST_USERNAME" \
  --password "$TEST_PASSWORD" \
  --room-name-pattern 'TES({n})' \
  --start 10 \
  --end 300

Smart lock​

Gunakan scripts/bulk-smart-lock-room-mapping.mjs untuk memetakan banyak kamar ke smart lock.

Fungsi​

  • Menentukan kamar PMS dari /api/rooms
  • Memuat perangkat dari /api/integrations/devices?vendor=...
  • Memeriksa pemetaan dari /api/mappings/room-lock
  • Mengirim metadata bridge jika disediakan oleh lock terpilih

Mode umum​

  1. Menggunakan satu lock tetap untuk banyak kamar.
  2. Mencocokkan lock berdasarkan nama perangkat.
  3. Mencocokkan lock berdasarkan pola lock ID.

Contoh​

node scripts/bulk-smart-lock-room-mapping.mjs \
  --merchant-id "$TEST_MERCHANT_ID" \
  --username "$TEST_USERNAME" \
  --password "$TEST_PASSWORD" \
  --vendor igloohome \
  --room-name-pattern 'TES({n})' \
  --device-name-pattern 'TES({n})' \
  --start 1 \
  --end 20 \
  --dry-run

Pemecahan masalah​

Yang terlihat: Dry run menampilkan kamar yang salah​

Perbaikan:

  1. Periksa --room-name-pattern.
  2. Konfirmasi nilai --start dan --end.
  3. Jalankan dry run lagi.

Yang terlihat: Kamar sudah memiliki pemetaan lain​

Perbaikan:

  1. Pastikan pemetaan baru sudah benar.
  2. Jalankan kembali dengan --update-existing.
  3. Verifikasi kamar di UI.

Yang terlihat: Lock sudah ditetapkan di tempat lain​

Perbaikan:

  1. Pastikan penggunaan ulang memang disengaja.
  2. Tambahkan --allow-assigned-elsewhere hanya untuk lock bersama.
  3. Jalankan skrip lagi.

Yang terlihat: Tidak ada kamar​

Perbaikan:

  1. Pastikan kamar PMS dimuat di AVA.
  2. Muat ulang halaman.
  3. Periksa merchant ID dan kredensial.

Masih Mengalami Masalah?​

Hubungi success@vouch-technologies.com jika:

  • ❌ Skrip terus gagal setelah dry run
  • ❌ Pemetaan tersimpan tetapi tidak muncul di AVA
  • ❌ Anda tidak yakin mode pemetaan yang sesuai

Sertakan informasi berikut:

  • Tangkapan layar output perintah
  • Merchant ID
  • Nama vendor dan model lock
  • Waktu masalah dimulai

Panduan Terkait​