ข้ามไปยังเนื้อหา
chaninl
en

Build Log

ลูกค้าขอแค่เว็บแสดงสินค้า — แต่ข้อมูลจริงอยู่ใน POS อายุ 30 ปี

โดย chaninl ·

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

แล้วจุดหักมุมก็มา ข้อมูลสินค้าทั้งหมดอยู่บนคอมที่ออฟฟิศลูกค้า มี script คอยดึงออกมาจากระบบ Visual FoxPro (ใช่ครับ FoxPro) ทุกๆ 1 ชั่วโมง ส่วนตัว source system ผมไม่มีทางได้แตะเลย อ่านได้แค่ไฟล์ที่ script ปล่อยออกมาเท่านั้น

งานนี้เลยไม่เคยเป็นงานเว็บตั้งแต่แรก มันคืองาน integration ที่แต่งตัวเป็นงานเว็บมาหลอกเราต่างหาก

ข้อจำกัดที่เราไม่ได้เป็นเจ้าของ

ยังไม่ทันเขียนโค้ดสักบรรทัด สิ่งที่ผมคุมไม่ได้ก็กำหนดหน้าตาของโปรเจกต์ไว้หมดแล้ว

  • ข้อมูลอยู่ on-prem บนเครื่องที่ออฟฟิศลูกค้า ระบบของผมเลยต้องไปรันที่นั่นด้วย ไม่ได้อยู่บน cloud สวยๆ ที่ผมจัดการเองได้
  • source ไม่มี API Visual FoxPro ไม่มี endpoint ให้เรียก สัญญาเดียวที่ผมมีคือไฟล์ที่ script ตัวนั้นปล่อยออกมา
  • ข้อมูลจากลูกค้าไม่เคยครบ ลูกค้าบอกว่ารีเฟรชทุก 1 ชั่วโมง ของจริงคือทุก 2 ชั่วโมง เรื่องเล็กแต่บทเรียนใหญ่ เดี๋ยวจะวนกลับมาเล่า

ในเมื่อแก้ที่ source ไม่ได้ ข้อจำกัดพวกนี้ก็ คือ ตัว design เลยครับ งานของผมคือออกแบบรอบข้อจำกัด ไม่ใช่นั่งหวังให้มันหายไป

Architecture v1

สุดท้ายออกมาหน้าตาแบบนี้ ทุกอย่างในกรอบรันด้วย Docker บนคอมที่ออฟฟิศลูกค้า แล้วออกสู่ภายนอกผ่าน tunnel เส้นเดียว

flowchart TB
  subgraph pc["คอมที่ออฟฟิศลูกค้า (Windows + Docker)"]
    direction TB
    foxpro["Visual FoxPro"] -->|script| csv["ไฟล์ CSV"]
    csv --> watcher["file watcher"]
    watcher --> etl["ETL"]
    etl --> db[("database")]
    db --> api["API server"]
  end
  api -->|Cloudflare Tunnel| next["Next.js (server-side)"]
  next --> visitors["ผู้เข้าชมเว็บ"]

ทุกชิ้นมีที่มาจากข้อจำกัด ไม่ได้ใส่เพราะอยากลองของ

  • file watcher → ETL → database อ่านได้แค่ไฟล์ ผมเลยคอย watch ไฟล์ใหม่ที่ปล่อยออกมา แปลงข้อมูล แล้วเก็บเป็นสำเนาของตัวเองที่ query ได้
  • API server บนเครื่องลูกค้า เพราะข้อมูลอยู่ตรงนั้น แล้วก็ใส่ด่านป้องกันมาตรฐานไว้ด้วย ทั้ง API key, CORS และ rate limit
  • Cloudflare Tunnel พา API ที่อยู่ on-prem ออกอินเทอร์เน็ตให้เว็บเรียกได้ ชิ้นนี้ตั้งค่าง่ายจนน่าตกใจ ราบรื่นที่สุดในทั้ง stack เลย
  • Next.js ใช้ทำหน้าบ้าน เพราะอยากให้ข้อมูล sensitive อยู่ฝั่ง server-side ไม่หลุดออกไปทาง API call ฝั่ง client

ระหว่างคิดเรื่องพวกนี้ ผมใช้ AI เป็นคู่คิดเรื่องออกแบบไปด้วย ไม่ได้ให้แค่เขียนโค้ด แต่ให้ช่วยถกเรื่อง trade-off กันตรงๆ และยังเก็บ Architecture Decision Record (ADR) ไว้ใน repo เดียวกับโค้ด ด้วย เหตุผล เบื้องหลังการตัดสินใจแต่ละเรื่องจะได้อยู่ติดกับโค้ด ของแถมที่ไม่ได้คาดไว้คือ ADR กลายเป็น context ที่ AI agent กลับมาอ่านได้ เรื่องนี้เดี๋ยวจะเล่าละเอียดในโพสต์ถัดไปครับ

ตอนที่โลกจริงสวนกลับ

มีอยู่สองเรื่องที่อยากเล่า

“ทุก 1 ชั่วโมง” ที่จริงคือทุก 2 ชั่วโมง ผมทำ refresh interval เป็นค่า config ไว้ตั้งแต่วันแรก ไม่ได้ฝังตัวเลขไว้ลึกๆ ในโค้ด พอเจอเรื่องนี้ก็แก้บรรทัดเดียวจบ ไม่ต้องไล่หา บทเรียนมีแค่นี้เลย สมมติฐานของลูกค้าผิดได้เสมอ เพราะฉะนั้นทำทุกสมมติฐานให้เป็นตัวแปรไว้ก่อน

จะเปิด Docker บน Windows ต้องไปแก้ BIOS ผมพยายามสุดตัวให้งานนี้จบแบบ remote ไม่ต้องเข้า onsite แต่ virtualization ดันถูกปิดไว้ที่ firmware แผนนั้นเลยพัง ต้องหาทางใหม่

บทเรียนเดียวที่อยากให้จำ

ก่อนเขียนโค้ดบรรทัดแรก ลองลิสต์ทุกอย่างที่เรา ไม่ได้ เป็นเจ้าของออกมาก่อน ทั้ง source system, ที่อยู่ของข้อมูล และสิ่งที่ลูกค้ายังไม่ได้บอก ลิสต์นี้แหละที่กำหนด architecture ตัวจริง ที่เหลือเป็นแค่ความชอบส่วนตัว

ตอนหน้า

ไฟล์ที่ออกมาจาก FoxPro กลายเป็น “สัญญา” ที่ไม่มีเอกสารสักหน้า ไฟล์ครอบข้อความด้วย " แต่ไม่ escape inch-mark ที่อยู่ข้างใน CSV parser ทั่วไปเลยพังแบบเงียบๆ ตอนหน้าจะเล่าว่าผม reverse-engineer ฟอร์แมตนี้ยังไงครับ

← กลับไปที่บล็อก