G-Launcher/Doc/git-runtime-mingit.md

🧰 สัญญาทางเทคนิค: ระบบจัดการ Portable MinGit Runtime

เอกสารนี้อธิบายกลไกของ Portable MinGit ใน G-Launcher ซึ่งช่วยให้ระบบสามารถรันคำสั่ง Git (เช่น Git Clone, Git Fetch, Git Checkout) ได้บนคอมพิวเตอร์ของผู้ใช้ทั่วไป แม้ว่าในเครื่องจะไม่ได้ติดตั้งโปรแกรม Git หรือไม่มีสิทธิ์ Administrator ก็ตาม

---

1. ที่มาและปัญหาเดิม (Background & Problem Statement)

1. ผู้เล่นเกมทั่วไปส่วนใหญ่ไม่มีโปรแกรม Git สำหรับนักพัฒนาติดตั้งอยู่ในเครื่อง
2. ตัวติดตั้ง Git for Windows ปกติต้องการสิทธิ์ Administrator (UAC Prompt) ซึ่งสร้างความยุ่งยากให้แก่ผู้ใช้งาน
3. ตัวอัปเดต Launcher และระบบดาวน์โหลดเซิร์ฟเวอร์/พร็อกซี จำเป็นต้องใช้ Git ในการดึงข้อมูล

---

2. ลำดับการตรวจสอบและเตรียม Git Runtime (Discovery Order)

ใน internal/git-service/git_runtime.go ฟังก์ชัน ensureGit() ทำงานตามลำดับความสำคัญดังนี้:

[ร้องขอ Git Executable]
          │
          ▼
1. ตรวจสอบ System PATH (exec.LookPath("git"))
   ├── พบ -> คืนพาธของ Git ในเครื่องทันที (เช่น C:\Program Files\Git\cmd\git.exe)
   │
   └── ไม่พบ -> เข้าสู่ขั้นตอนที่ 2
          │
          ▼
2. ตรวจสอบโฟลเดอร์พกพาภายใน (tools/mingit/cmd/git.exe)
   ├── พบ -> นำพาธนี้ไปใช้งานทันที
   │
   └── ไม่พบ -> เข้าสู่ขั้นตอนที่ 3
          │
          ▼
3. ดาวน์โหลด Portable MinGit x64 อัตโนมัติ
   ├── ดึงข้อมูล Release ล่าสุดจาก GitHub API:
   │   https://api.github.com/repos/git-for-windows/git/releases/latest
   ├── กรองหาไฟล์แพ็กเกจ: MinGit-*-64-bit.zip
   ├── ดาวน์โหลดลงไฟล์ชั่วคราว os.CreateTemp
   ├── แตกไฟล์ Zip ลงโฟลเดอร์เป้าหมาย
   └── คืนค่าพาธ git.exe พร้อมใช้งาน

---

3. การป้องกัน Terminal Freeze (Non-Interactive Terminal Execution)

เมื่อโปรแกรม Launcher หรือสคริปต์อัตโนมัติเรียกใช้คำสั่ง Git หาก Git ตรวจพบว่าต้องการรหัสผ่านหรือการยืนยันตัวตน มันจะพยายามเปิด Interactive TTY Prompt ซึ่งส่งผลให้โปรเซสของ Launcher ค้างอย่างถาวร (Hang/Freeze):

แนวทางป้องกันที่นำมาใช้:

1. ตั้งค่าตัวแปรสภาพแวดล้อม:
   • ใน Go Backend: cmd.Env = append(os.Environ(), "GIT_TERMINAL_PROMPT=0")
   • ใน PowerShell: $env:GIT_TERMINAL_PROMPT = "0"
2. ผลลัพธ์: หาก Git ต้องการการยืนยันตัวตนแต่ไม่สามารถทำได้ Git จะ Return Error ออกมาทันทีแทนที่จะค้าง ทำให้ระบบสามารถดักจับและส่ง Error ไปแจ้งเตือนบน UI ได้อย่างถูกต้อง