WS GROSIR POS PRINT AGENT — MULTI TERMINAL
==========================================

Arsitektur
----------
  [PC Server]  XAMPP + aplikasi POS (PHP)
       │
       │  http://IP-SERVER/wsgrosir/pos/
       │
  [PC Kasir 1] browser + agent lokal + printer USB
  [PC Kasir 2] browser + agent lokal + printer USB
  [PC Kasir N] ...

PENTING
-------
File .BAT / agent TIDAK cukup hanya di server.
Setiap PC kasir HARUS punya agent lokal karena:
  - Printer USB terpasang di PC kasir itu
  - Browser memanggil http://127.0.0.1:19500 (= PC kasir sendiri)
  - Server tidak bisa mencetak ke printer USB terminal lain

Setup sekali per PC kasir
-------------------------
1. Di PC kasir, buka folder tools di server (share / Explorer):
     \\IP-SERVER\... atau E:\xampp\htdocs\wsgrosir\pos\tools
   ATAU download INSTALL-KASIR.bat + file agent dari server.

2. Double-click: INSTALL-KASIR.bat
   - Menyalin agent ke C:\tool_printer
   - Mendaftarkan protokol wgposprint://
   - Menambah shortcut Startup (opsional auto-jalan)

3. Selesai. Ulangi di Terminal 2, 3, dst.

Pemakaian harian
----------------
1. Login Windows di PC kasir → agent idealnya sudah auto (Startup)
2. Buka POS: http://IP-SERVER/wsgrosir/pos/
   → sistem cek 127.0.0.1:19500; jika off, coba auto-aktifkan via wgposprint://
3. Badge hijau / cetak struk siap

Catatan browser: beberapa browser memblokir buka protokol tanpa klik user.
Solusi paling andal agar "otomatis tanpa klik":
  biarkan INSTALL-KASIR menaruh shortcut di Startup Windows
  (agent sudah hidup sebelum POS dibuka).

Folder wajib di PC kasir
------------------------
  C:\tool_printer\  (hasil INSTALL-KASIR.bat)

File di C:\tool_printer (setelah install)
----------------------------------------
  pos_local_print_agent.ps1
  START-PRINT-AGENT-BG.bat
  wgposprint-protocol-handler.bat
  ...

Port: 127.0.0.1:19500 (localhost PC kasir saja)
