﻿🌉 สะพานพิมพ์สติ๊กเกอร์ยานาธร — วิธีติดตั้งบนเครื่อง Windows ที่ร้าน (5 นาทีจบ)

=== ด่วน (v3.2) - ห้ามใช้ไฟล์ v3.1 เดิม ===
v3.1 มีบรรทัดปิดสะพานตัวเก่าที่ผิดพลาด ทำให้เครื่องจอฟ้าตอนติดตั้ง (แก้แล้วใน v3.2
เปลี่ยนเป็นวิธีปิดที่ปลอดภัย เจาะจงเฉพาะโปรเซสของสะพานเท่านั้น) - เครื่องที่โดนจอฟ้า
เปิดใหม่ใช้ได้ปกติ ไม่มีอะไรเสียหาย และสะพานตัวใหม่จะทำงานเองหลังรีสตาร์ต

=== อัปเดต 28 ส.ค. 2569 รอบดึก (v3.1) ===
- ตัวติดตั้งเคลียร์ "สะพานตัวเก่าที่ยังรันค้างยึดพอร์ต 9410" ให้ก่อนเสมอ
  (ตัวเก่าค้าง = ตัวใหม่สตาร์ทไม่ได้เงียบๆ แล้วเว็บคุยกับตัวเก่าตลอด - เจอจริงที่ร้าน)
- สะพานรายงานเวอร์ชันตัวเองใน /ping -> หน้าเว็บเตือนได้ว่ากำลังคุยกับรุ่นเก่า
- เครื่องที่ลง v3 ไปแล้ววันนี้: รีสตาร์ตคอม 1 รอบ ก็พอ (ไม่ต้องลงซ้ำ)

=== อัปเดต 28 ส.ค. 2569 รอบค่ำ (v3) ===
- [v3.6 / 30 ส.ค. 2569] ✨ ไดรเวอร์มาในซิปแล้ว (ชุดเต็ม)
    * ตรวจ SHA-256 ของไฟล์ไดรเวอร์ก่อนรันทุกครั้ง ถ้าถูกสับเปลี่ยนระหว่างทาง = ไม่ยอมลง
    * หลังลงไดรเวอร์เสร็จ จะรอ Windows สร้างคิวเครื่องพิมพ์ (สูงสุด 40 วิ) ก่อนสร้าง printer.txt
      (v3.5 ทำสองขั้นนี้ติดกันทันที คิวยังไม่ทัน printer.txt เลยไม่ถูกสร้าง)

- [v3.5 / 30 ส.ค. 2569] ✨ กดไฟล์เดียวจบ
  install.bat จะทำให้เองทั้งหมด:
    1) ถ้ามีโฟลเดอร์ driver\ แนบมาด้วย และเครื่องยังไม่มีคิวเครื่องพิมพ์ฉลาก -> ลงไดรเวอร์ให้ก่อน
       (ตรวจลายเซ็นดิจิทัลก่อนรันเสมอ ถ้าลายเซ็นไม่ผ่านจะข้าม ไม่รันให้)
    2) หาเครื่องพิมพ์ฉลากในเครื่อง แล้วสร้าง C:\YanathonPOS\printer.txt ให้อัตโนมัติ
       (ถ้ามีไฟล์อยู่แล้วจะไม่ทับของเดิม / ถ้าเจอหลายเครื่องจะให้เลือกเอง)
    3) เปิดพอร์ต + ตั้งสิทธิ์ Chrome + ตั้งให้สะพานทำงานเองทุกครั้งที่เปิดคอม
    4) ตรวจให้ว่าสะพานตอบจริงไหม

- [v3.4 / 30 ส.ค. 2569] ⛔ ห้ามเลือกเครื่องใบเสร็จเด็ดขาด
  "80mm Series Printer" = เครื่องพิมพ์ใบเสร็จ/สลิป ไม่ใช่เครื่องฉลากยา
  (เคยตั้งผิดจริง งานฉลากวิ่งเข้าคิวเครื่องใบเสร็จหลายงาน)
  -> สะพานจะข้ามเครื่องพวกนี้เสมอ: 80mm, 58mm, Receipt, Slip, PDF, XPS, OneNote, Fax
  -> เครื่องฉลากยาที่ใช้จริง: 4BARCODE 4B-2054A / Windows เห็นชื่อ "Arkscan 2054A"
- อ่าน printer.txt.txt ได้ด้วย (Notepad ชอบเติม .txt ซ้อนตอนเซฟ โดยที่มองไม่เห็น)
- check.bat เขียนผลที่ C:\YanathonPOS\yanathon-check.txt (เครื่องที่ Desktop ถูก OneDrive ย้าย เดิมพัง)

=== อัปเดต 28 ส.ค. 2569 (v2) — เครื่องที่เคยลงแล้วต้องลงซ้ำ ===
แก้ 2 อาการที่ทำให้ปุ่ม "พิมพ์ตรง" ไม่โผล่ ทั้งที่ติดตั้งผ่านแล้ว:
  1) สะพานเคยผูกกับ "บัญชีแอดมินที่กด Yes ตอนติดตั้ง" -> ถ้าร้านล็อกอินคนละบัญชี
     พอรีสตาร์ตเครื่อง สะพานไม่ตื่นเอง (ตอนติดตั้งขึ้น SUCCESS หลอกเรา)
     ตัวใหม่รันแบบ SYSTEM = ตื่นทุกครั้งที่เปิดคอม ไม่สนว่าใครล็อกอิน
  2) Chrome รุ่นใหม่ถามสิทธิ์ "local network" -> ถ้าพนักงานเผลอกด Block ครั้งเดียว
     ปุ่มจะหายถาวร  ตัวใหม่ฝังค่าอนุญาตให้ทั้งเครื่องอัตโนมัติ ไม่ต้องถามอีก
วิธีอัปเดต: โหลด zip ใหม่ -> แตกไฟล์ -> คลิกขวา install.bat -> Run as administrator
(ทับของเดิมได้เลย ไม่ต้องถอนตัวเก่า · ค่าที่ตั้งไว้ในเครื่องพิมพ์ไม่หาย)
============================================================

สิ่งที่ต้องมี: เครื่องพิมพ์สติ๊กเกอร์ 4BARCODE 4B-2054A + สาย USB

ขั้นที่ 1) เสียบเครื่องพิมพ์เข้า USB แล้วเปิดเครื่อง (ไฟสีฟ้า = ปกติของรุ่นนี้)
   - ถ้าใช้ "ชุดเต็ม" (ในซิปมีโฟลเดอร์ driver อยู่ด้วย): ไม่ต้องลงไดรเวอร์เอง
     ตัวติดตั้งจะลงให้ก่อนโดยอัตโนมัติ ถ้าเครื่องยังไม่มีคิวเครื่องพิมพ์ฉลาก
     ** ระหว่างนั้นจะมีหน้าต่างติดตั้งของผู้ผลิตเด้งขึ้นมา ให้กด Next / Install ไปจนปิดเอง **
     จากนั้นตัวติดตั้งจะรอ Windows สร้างคิวเครื่องพิมพ์ให้ (สูงสุด 40 วินาที) แล้วทำต่อเอง
   - ถ้าใช้ "ชุดอัปเดต" (ซิปเล็ก ไม่มีโฟลเดอร์ driver): เครื่องนั้นต้องลงไดรเวอร์ไว้แล้ว
     ถ้ายังไม่ได้ลง ให้โหลดชุดเต็มจากหน้า "ตั้งค่าเครื่องขาย (Windows)" ใน POS แทน
   - ตรวจว่าลงสำเร็จ: Settings > Printers ต้องเห็นคิวชื่อ "Arkscan 2054A"
     (เห็นแค่อุปกรณ์ที่ USB แต่ไม่มีคิว = ยังไม่ครบ ยิงงานไม่ได้)

ขั้นที่ 2) *** แตกไฟล์ ZIP ก่อน *** (สำคัญมาก)
   คลิกขวาที่ไฟล์ ZIP > Extract All... > Extract
   -> จะได้โฟลเดอร์ใหม่ที่มีไฟล์ install.bat กับ sticker-bridge.ps1 อยู่ข้างใน
   ** ห้ามดับเบิลคลิก install.bat จากในหน้าต่าง ZIP โดยตรง — จะติดตั้งไม่สำเร็จ **
   (ไม่ต้องก๊อบไปไว้ C:\YanathonPOS เอง ตัวติดตั้งจะก๊อบให้เองอัตโนมัติ)

ขั้นที่ 3) ดับเบิลคลิก install.bat (ถ้ามีหน้าต่างถามสิทธิ์ Administrator ให้กด Yes)
   -> รอจนขึ้น "[SUCCESS] Bridge is running" แล้ว "DONE!"
   -> ถ้าขึ้น [FAILED] อ่านบรรทัดนั้น มันบอกวิธีแก้ให้เลย

ขั้นที่ 4) เปิด Chrome เข้าหน้า "ออกแบบสติ๊กเกอร์ยา" ใน POS
   - ปุ่ม "⚡ พิมพ์ตรง" กับ "⚙️ ตั้งค่าเครื่อง" จะโผล่เอง = ใช้งานได้เลย
   - ถ้า Chrome ถามสิทธิ์ "local network" ให้กด Allow
   - ถ้าปุ่มยังไม่โผล่ หน้าเว็บจะขึ้นแถบสีส้มบอกสาเหตุให้เอง (อ่านแล้วทำตามได้เลย)

   *** เคสที่เจอบ่อย: ปุ่มไม่โผล่ เพราะชื่อเครื่องพิมพ์ไม่ตรงที่ระบบรู้จัก ***
   (สะพานจะไม่เดาเครื่องให้ ถ้าหาไม่เจอจะไม่ยิงงานเลย ดีกว่ายิงผิดเครื่อง)
   วิธีแก้ 30 วินาที:
     1. ดูชื่อเครื่องพิมพ์ใน Settings > Printers (หรือดูจากแถบสีส้มในหน้าเว็บ มันลิสต์ให้)
     2. สร้างไฟล์ C:\YanathonPOS\printer.txt  พิมพ์ชื่อนั้นลงไปบรรทัดเดียว เซฟ
        (ปกติตัวติดตั้งสร้างให้เองอยู่แล้ว จะต้องทำเองเฉพาะตอนเครื่องนั้นมีเครื่องพิมพ์ฉลากหลายตัว)
     3. ดับเบิลคลิก install.bat อีกครั้ง แล้วรีเฟรชหน้าเว็บ -> ปุ่มจะโผล่

ขั้นที่ 5) ตั้งขนาดม้วนให้เครื่องจำ (ทำครั้งเดียวต่อเครื่องพิมพ์ 1 ตัว)
   - ใส่ม้วนสติ๊กเกอร์ > กดปุ่ม FEED ค้าง 3-5 วินาที จนกระดาษเลื่อนเองแล้วหยุด
   - กด "⚙️ ตั้งค่าเครื่อง" ในหน้าเว็บ > ตอบ 3 ข้อ:
       ความเข้ม 28  |  ความเร็ว 3  |  ขนาดม้วน 80x60
   - จะมีดวงเขียนว่า "SET ROLL 80x60 OK" ออกมา = เรียบร้อย

** ข้ามขั้นที่ 5 ไม่ได้ **
   ถ้าไม่ตั้ง เครื่องจะวัดตำแหน่งดวงผิด -> ข้อความเลื่อนออกนอกกรอบ + ไฟแดงทุกงาน

หมายเหตุ:
- ค่าขนาดดวง/ความเข้ม จำอยู่ในตัวเครื่องพิมพ์ -> ถ้า "ยกเครื่องเดิมจากบ้านมา" ไม่ต้องทำขั้นที่ 5 ซ้ำ
  แต่ถ้าเป็น "เครื่องพิมพ์คนละตัว" ต้องทำขั้นที่ 5 ที่เครื่องนั้นด้วย
- แบบสติ๊กเกอร์/เทมเพลตพื้นหลัง อยู่บนเว็บ ทุกเครื่องเห็นเหมือนกันอัตโนมัติ ไม่ต้องก๊อบไฟล์
- ไฟสัญญาณ "สีฟ้า" ของเครื่องรุ่นนี้ = ปกติ พร้อมใช้งาน (ไม่ใช่ error)
- ไฟแดง: ปิด-เปิดเครื่อง > กด FEED ค้าง 3-5 วิ > ถ้ายังแดง แจ้ง Claude ยิงคำสั่งคาลิเบรตให้

============================================================
ถ้าติดปัญหา — ให้ Claude ช่วยแก้ได้ยังไง (Claude อยู่บน MacBook)
============================================================
1) ที่เครื่อง Windows: ดับเบิลคลิก check.bat
   -> มันจะตรวจทุกอย่างแล้วเปิด Notepad ให้อัตโนมัติ (ไฟล์อยู่ที่ Desktop\yanathon-check.txt)
2) ก๊อบข้อความในไฟล์นั้นทั้งหมด ส่งให้ Claude ทางแชท (พิมพ์ในมือถือ/แมคก็ได้)
3) Claude อ่านแล้วบอกวิธีแก้ ถ้าต้องแก้ไฟล์สะพาน Claude จะอัปไฟล์ใหม่ขึ้นเว็บให้
   -> ที่ Windows โหลด bridge-win.zip ใหม่จากหน้า "ตั้งค่าเครื่องขาย" ทับของเดิม แล้วรัน install.bat อีกครั้ง

** Claude ไม่ต้องต่อเข้าเครื่อง Windows โดยตรง — ส่งงานผ่านเว็บได้ทั้งหมด **

