เจาะลึก SwitchPath: เครื่องมือตรวจสอบโปรเจกต์ด้วย FalkorDB

การค้นหาโค้ดในโปรเจกต์ขนาดใหญ่ด้วยคำสำคัญทั่วไปอาจส่งผลลัพธ์เป็นรายชื่อไฟล์ที่ตรงกัน แต่กลับไม่ได้อธิบายเหตุผลที่แท้จริงว่าไฟล์ใดคือจุดที่ประกาศแพ็กเกจ หรือไฟล์ต้นทางใดที่สนับสนุนข้อสรุปนั้น ปัญหานี้จึงกลายเป็นจุดเริ่มต้นของการพัฒนา SwitchPath ซึ่งเป็นโปรเจกต์ต้นแบบสำหรับการตรวจสอบโค้ดที่ช่วยให้เห็นความเชื่อมโยงของข้อมูลได้ชัดเจนยิ่งขึ้น

ผู้พัฒนาเริ่มต้นโปรเจกต์นี้ด้วยความตั้งใจที่จะเรียนรู้และสร้างแอปพลิเคชันที่ใช้งานได้จริงผ่านโครงการ FalkorDB สำหรับ Graph Hacks โดยมีเป้าหมายหลักคือการสร้างเครื่องมือที่สามารถตรวจสอบโปรเจกต์ในเครื่อง ระบุไฟล์และ dependencies ที่เกี่ยวข้อง เชื่อมโยงข้อมูลเหล่านั้นเข้าด้วยกันในรูปแบบกราฟ และช่วยให้นักพัฒนาสามารถสืบค้นผลลัพธ์กลับไปยังแหล่งที่มาได้โดยตรง

ในด้านสถาปัตยกรรมระบบ SwitchPath แบ่งออกเป็นส่วนหน้าบ้าน (Frontend) ที่ใช้ React และ TypeScript ส่วนหลังบ้าน (Backend) ใช้ Python ร่วมกับ FastAPI และใช้งาน FalkorDB เป็นฐานข้อมูลกราฟโดยรันผ่าน Docker Compose ในเครื่องของผู้พัฒนาเอง

ภาพประกอบจากคลังภาพสต็อก ไม่ใช่ภาพจากเหตุการณ์จริง

อย่างไรก็ตาม การเชื่อมต่อบริการเหล่านี้ในตอนแรกไม่ได้ราบรื่นอย่างที่คิด ปัญหาการทำงานของ Docker, คำสั่ง PowerShell ที่แตกต่างจากที่คาดไว้ และการสื่อสารระหว่าง API กับฐานข้อมูล ทำให้ผู้พัฒนาต้องเรียนรู้ที่จะแบ่งปัญหาออกเป็นส่วนย่อยๆ และตรวจสอบทีละเลเยอร์ เช่น ตรวจสอบว่าฐานข้อมูลทำงานอยู่หรือไม่ หรือ API สามารถเข้าถึงฐานข้อมูลได้หรือเปล่า ซึ่งช่วยให้เข้าใจวิธีการแก้ไขปัญหาทางเทคนิคที่มีประสิทธิภาพมากขึ้น

ในส่วนกระบวนการตรวจสอบ SwitchPath จะทำการสแกนไฟล์แบบอ่านอย่างเดียว (Read-only) โดยไม่มีการรันโค้ดจริงหรือแก้ไขไฟล์ในไดเรกทอรี ระบบจะบันทึกเมตาดาต้า เช่น เส้นทางไฟล์ นามสกุล ขนาด จำนวนบรรทัด และค่า SHA-256 fingerprints พร้อมทั้งสกัดการประกาศ dependencies จากไฟล์อย่าง package.json หรือ requirements.txt