រំកិលទៅមាតិកា

រៀបចំការផ្គូផ្គងការចូលបន្ទប់ជាច្រើន

រៀបចំរហ័ស

សណ្ឋាគារភាគច្រើនអាចសាកល្បងបន្ទប់តូចមួយក្នុង 5 ទៅ 10 នាទី។ ដំណើរការ dry run ជាមុន។

ប្រើស្គ្រីបទាំងនេះ ដើម្បីផ្គូផ្គងបន្ទប់ជាច្រើនក្នុងពេលតែមួយទៅ Keycard Encoder ឬ Smart Lock។

ឯកសារយោងរហ័ស​

ស្គ្រីបមុខងារសមស្របសម្រាប់
scripts/bulk-keycard-room-mapping.mjsបង្កើត ឬកែការផ្គូផ្គងបន្ទប់ Keycard Encoderឈ្មោះបន្ទប់ Encoder មានលំនាំច្បាស់
scripts/bulk-smart-lock-room-mapping.mjsបង្កើត ឬកែការផ្គូផ្គងបន្ទប់ Smart LockLock មានឈ្មោះ ឬត្រូវបានកំណត់ជាច្រើន

មុនពេលចាប់ផ្ដើម​

បញ្ជាក់ចំណុចទាំងនេះ៖

  • អ្នកអាចចូលដោយព័ត៌មាន Merchant
  • អ្នកស្គាល់ Merchant ID គោលដៅ
  • ឯកសារ env មាន TEST_MERCHANT_ID, TEST_USERNAME និង TEST_PASSWORD
  • អ្នកដំណើរការពាក្យបញ្ជាពីថតគោលរបស់ Repository
ផ្ទុក Environment

កំណត់ឯកសារ env មុនពេលដំណើរការស្គ្រីប៖

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

ប្ដូរផ្លូវ ប្រសិនបើឯកសារ env របស់អ្នកមានឈ្មោះផ្សេង។

ជំហានទី 1៖ សាកល្បងជួរតូច​

  1. ដំណើរការ dry run សម្រាប់ជួរបន្ទប់តូច។
  2. ពិនិត្យលទ្ធផលដោយប្រុងប្រយ័ត្ន។
  3. បញ្ជាក់ថាឈ្មោះបន្ទប់ត្រូវនឹងបន្ទប់ដែលរំពឹង។

ឧទាហរណ៍ Keycard Encoder​

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

ឧទាហរណ៍ 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

ជំហានទី 2៖ ដំណើរការការផ្គូផ្គងពិត​

  1. លុប --dry-run។
  2. រក្សាជួរបន្ទប់ដដែល។
  3. ដំណើរការពាក្យបញ្ជាម្ដងទៀត។

ប្រើ --update-existing ប្រសិនបើត្រូវកែការផ្គូផ្គងដែលមានស្រាប់។

Keycard Encoder​

ប្រើ scripts/bulk-keycard-room-mapping.mjs ពេលឈ្មោះបន្ទប់ Encoder មានលំនាំដែលអាចទាយបាន។

មុខងារ​

  • ស្វែងរកបន្ទប់ PMS ពី /api/rooms
  • បង្កើត ឬកែ /api/keycard-encoder-room-mapping
  • បង្កើត encoderRoomName ពីលេខបន្ទប់

ឧទាហរណ៍​

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​

ប្រើ scripts/bulk-smart-lock-room-mapping.mjs ដើម្បីផ្គូផ្គងបន្ទប់ជាច្រើនទៅ Smart Lock។

មុខងារ​

  • ស្វែងរកបន្ទប់ PMS ពី /api/rooms
  • ផ្ទុកឧបករណ៍ពី /api/integrations/devices?vendor=...
  • ពិនិត្យការផ្គូផ្គងពី /api/mappings/room-lock
  • ផ្ញើ Bridge Metadata នៅពេល Lock ផ្ដល់វា

របៀបប្រើធម្មតា​

  1. ប្រើ Lock ថេរមួយសម្រាប់បន្ទប់ជាច្រើន។
  2. ផ្គូផ្គង Lock តាមឈ្មោះឧបករណ៍។
  3. ផ្គូផ្គង Lock តាមលំនាំ Lock ID។

ឧទាហរណ៍​

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

ដោះស្រាយបញ្ហា​

អ្វីដែលអ្នកឃើញ៖ Dry run បង្ហាញបន្ទប់ខុស​

ដំណោះស្រាយ៖

  1. ពិនិត្យ --room-name-pattern។
  2. បញ្ជាក់តម្លៃ --start និង --end។
  3. ដំណើរការ dry run ម្ដងទៀត។

អ្វីដែលអ្នកឃើញ៖ បន្ទប់មានការផ្គូផ្គងផ្សេងរួច​

ដំណោះស្រាយ៖

  1. បញ្ជាក់ថាការផ្គូផ្គងថ្មីត្រឹមត្រូវ។
  2. ដំណើរការម្ដងទៀតជាមួយ --update-existing។
  3. ផ្ទៀងផ្ទាត់បន្ទប់ក្នុង UI។

អ្វីដែលអ្នកឃើញ៖ Lock ត្រូវបានកំណត់នៅកន្លែងផ្សេង​

ដំណោះស្រាយ៖

  1. បញ្ជាក់ថាការប្រើរួមគ្នាជាចេតនា។
  2. បន្ថែម --allow-assigned-elsewhere សម្រាប់ Lock រួមប៉ុណ្ណោះ។
  3. ដំណើរការស្គ្រីបម្ដងទៀត។

អ្វីដែលអ្នកឃើញ៖ មិនមានបន្ទប់​

ដំណោះស្រាយ៖

  1. បញ្ជាក់ថាបន្ទប់ PMS ផ្ទុកក្នុង AVA។
  2. ផ្ទុកទំព័រឡើងវិញ។
  3. ពិនិត្យ Merchant ID និងព័ត៌មានចូល។

នៅតែមានបញ្ហា?​

ទាក់ទង success@vouch-technologies.com ប្រសិនបើ៖

  • ❌ ស្គ្រីបនៅតែបរាជ័យបន្ទាប់ពី dry run
  • ❌ ការផ្គូផ្គងរក្សាទុក ប៉ុន្តែមិនបង្ហាញក្នុង AVA
  • ❌ អ្នកមិនប្រាកដថារបៀបផ្គូផ្គងណាសមស្រប

ព័ត៌មានមានប្រយោជន៍៖

  • រូបថតអេក្រង់លទ្ធផលពាក្យបញ្ជា
  • Merchant ID
  • ឈ្មោះ Vendor និងម៉ូដែល Lock
  • ពេលបញ្ហាចាប់ផ្ដើម

មគ្គុទ្ទេសក៍ពាក់ព័ន្ធ​