Cara memasang agen cetak di dapur

Apa yang dilakukan program kecil ini di meja kerja

Agen cetak adalah program ringan yang berjalan di dalam restoran dan menjadi jembatan antara qmen.us, yang ada di cloud, dan printer termal, yang ada di jaringan lokal Anda. Cloud tidak bisa menjangkau printer di balik router, jadi agenlah yang menyambung keluar, bertanya sesekali apakah ada tiket baru, mencetak, dan mengonfirmasi. Tidak perlu membuka port apa pun di router.

Ada versi untuk tiga perangkat: Linux (satu berkas AppImage), Windows (satu berkas .exe), dan Android (aplikasi dari proyek ini, dengan printer lewat Bluetooth atau jaringan). Di ketiganya konfigurasinya sama, sepasang data: alamat Dapur dan token yang diberikan dasbor. qmen.us tetap berjalan di browser, tanpa aplikasi dari toko; yang dipasang hanya agen ini, dan hanya di perangkat dapur itu.

Mengapa tiket di atas kertas layak dimiliki

• Tiket keluar sendiri, tanpa ada yang mengklik. Pelayan mengirim dari Meja, qmen.us membuat pekerjaan cetak, dan program mengambilnya pada pengecekan berikutnya, tiap 3 detik secara bawaan.
• Tiket ganda lebih baik daripada pesanan hilang. Printer kehabisan kertas, mati, atau internet naik-turun: kegagalan dilaporkan dan pekerjaan kembali ke antrean. Server menawarkan lagi setelah semenit tanpa konfirmasi dan mencoba sampai sepuluh kali sebelum menyerah.
• Tiap stasiun hanya mencetak miliknya. Alamat dan token berlaku per Dapur, jadi panggangan tidak menerima hidangan penutup. Restoran dengan dua meja kerja dan dua printer termal menjalankan dua agen, masing-masing dengan konfigurasinya sendiri.
• Perangkat yang sama bisa mencetak dan menampilkan monitor. Dengan monitor diaktifkan di konfigurasi, layar dapur terbuka di browser saat mulai. Kalau Anda hanya ingin layarnya, tidak perlu itu: cukup buka tautan monitor.

Cara memasang agen cetak dalam 7 langkah

Ada tujuh langkah, dari tombol di dasbor sampai program menyala sendiri saat perangkat dihidupkan.

1. Aktifkan pencetakan stasiun di dasbor

   Di dasbor, buka Dapur. Setiap stasiun adalah kartu, dan di dalamnya ada blok Pencetakan dengan tombol Atur. Terbuka jendela Pencetakan di dapur: aktifkan saklar Cetak pesanan, pilih Lebar kertas (80 mm atau 58 mm), berapa Salinan yang Anda mau (1 sampai 5), lalu ketuk Simpan. Kartu mulai menampilkan Aktif, dengan lebar dan jumlah salinan di sampingnya.

2. Salin alamat dan token

   Di jendela yang sama, pada Data untuk aplikasi cetak, ada dua baris: alamat Dapur dan token, yang tersembunyi di balik titik-titik. Ikon mata menampilkannya dan tombol di sampingnya menyalin. Kalau muncul (dibuat saat disimpan), berarti Anda belum menyimpan. Simpan token baik-baik: ia berlaku sebagai kata sandi pencetakan. Tautan Buat token baru langsung mematikan yang sebelumnya.

3. Unduh versi untuk perangkat Anda

   Di perangkat dapur, unduh berkas sesuai sistem Anda: di Windows berkas .exe (Windows 7 ke atas), di Linux sebuah AppImage yang berjalan di distro apa pun. Hanya satu berkas, dalam satu folder. Di Raspberry Pi dan ARM lain, buat AppImage di perangkat itu sendiri atau jalankan langsung dari kode sumber, dengan Python 3.9 atau lebih baru.

4. Tempel alamat, token, dan printer

   Di samping program ada config.json dengan base (alamat), token, printer (printernya), dan poll (berapa detik sekali ia bertanya). Di Windows berkas ini ada di folder yang sama dengan .exe; di Linux, di ~/.config/pedis-agent/config.json. Nilai printer bergantung pada sambungan: network:192.168.0.50 untuk printer jaringan, windows: untuk antrean bawaan Windows, file:/dev/usb/lp0 untuk USB di Linux, serial:/dev/ttyUSB0 untuk serial.

   Tips: Di Windows, pasang printer termal sebagai antrean Generic / Text Only: driver yang menggambar halaman mengacak perintah dan kertas keluar kotor. Di Linux, kalau /dev/usb/lp0 menolak izin, jalankan sudo usermod -aG lp $USER lalu masuk lagi.

5. Uji sebelum layanan

   Sebelum mengandalkannya untuk makan siang, jalankan satu putaran dengan printer dummy: tiket muncul di layar, tanpa memakai kertas. Lalu kirim pesanan uji lewat Meja dan lihat kertas keluar — kepala dengan nama restoran, meja, nomor pesanan, pelayan, stasiun, dan jam, serta tiap item dengan huruf besar, dengan tambahan dan catatan di bawahnya.

6. Biarkan ia menyala sendiri

   Dapur tidak sempat ingat membuka program. Dengan pedis-agent --install, Windows membuat tugas yang mulai saat login dan Linux membuat layanan pengguna yang menyala ulang sendiri bila mati. Di perangkat tanpa orang yang login, seperti Raspberry Pi di belakang TV, jalankan juga sudo loginctl enable-linger. Untuk membatalkan, pedis-agent --uninstall.

7. Di tablet Android, jalurnya sama

   Kalau dapur memakai tablet, aplikasi Android (5.0 ke atas) melakukan pekerjaan yang sama dan juga menampilkan layar dapur. Di layar awal Anda mengisi Alamat, Token, dan Printer — bt: dan MAC printer termal Bluetooth yang sudah dipasangkan, atau net: dan IP printer jaringan — lalu mengetuk Simpan dan mulai. Beri izin Bluetooth dan keluarkan aplikasi dari penghemat baterai, kalau tidak pencetakan berhenti saat layar mati.

Pertanyaan yang sering diajukan

Glosarium

Agen cetak

Program kecil yang berjalan di perangkat dapur, mengambil tiket dari qmen.us, mencetak di printer termal, dan mengonfirmasi.

Token cetak

Kata sandi cetak sebuah Dapur. Diambil dari dasbor, dimasukkan ke konfigurasi agen, dan bisa diganti kapan pun Anda mau.

Dapur

Monitor tempat pesanan muncul dan bergerak dari Disiapkan sampai SIAP.

ESC/POS

Bahasa yang dipahami printer termal tiket. Inilah yang dihasilkan agen untuk tiap tiket.

Sumber daya terkait