commit 534550dab7214654cc4f1d2f82079e1f405db83a Author: nuralan Date: Tue May 27 08:43:58 2025 +0700 Add INSTALLER.md diff --git a/INSTALLER.md b/INSTALLER.md new file mode 100644 index 0000000..b09903f --- /dev/null +++ b/INSTALLER.md @@ -0,0 +1,62 @@ +# ๐Ÿงพ Printer POS Service Installer + +Installer otomatis untuk mengatur lingkungan kerja aplikasi **Printer POS Service** di Windows. + +## ๐Ÿ”ง Fitur + +- Install driver USB printer thermal menggunakan **Zadig** +- Install **Node.js v20** +- Install **Git for Windows** +- Clone project dari **Gitea private repository** +- Install **npm dependencies** dan **PM2** +- Jalankan aplikasi sebagai **daemon** menggunakan PM2 + +## ๐Ÿ“ฆ Requirements + +- Windows 10 atau lebih baru +- Koneksi internet aktif +- Akses administrator + +## ๐Ÿš€ Cara Menggunakan + +1. **Download dan jalankan `installer.exe`** +2. Setelah Zadig terbuka: + - Pilih printer thermal USB kamu + - Pilih **WinUSB** sebagai driver + - Klik **Install Driver** + - Tutup Zadig, lalu kembali ke terminal dan tekan `ENTER` +3. Proses akan otomatis: + - Install Node.js (jika belum ada) + - Install Git (jika belum ada) + - Clone project dari Gitea + - Jalankan dengan PM2 + +## ๐Ÿ” Catatan Keamanan + +Installer ini akan mengakses: +- File `.msi` dari [nodejs.org](https://nodejs.org/) +- Git installer dari [GitHub](https://github.com/git-for-windows) +- Project dari private Gitea repository +- Zadig dari [https://zadig.akeo.ie](https://zadig.akeo.ie) + +Semua file disimpan sementara dan akan dihapus otomatis setelah proses selesai. + +## ๐Ÿ›  Troubleshooting + +- **PM2 gagal start?** + Aplikasi akan menghapus folder `C:\app-folder` dan membatalkan proses. + +- **Zadig tidak muncul?** + Cek apakah antivirus memblokirnya. Buka manual dari [https://zadig.akeo.ie](https://zadig.akeo.ie). + +- **Git clone gagal?** + Pastikan token dan user sudah benar dalam script. + +## ๐Ÿ“‚ Struktur Folder + +```plaintext +C:\ +โ””โ”€โ”€ app-folder\ + โ”œโ”€โ”€ index.js + โ”œโ”€โ”€ node_modules\ + โ””โ”€โ”€ ...