Case study · Document AI / Automation

สรุปใบเสนอราคา PDF เป็น Excel อัตโนมัติ ทุกวันจันทร์ 08:00

ทุกสัปดาห์มีใบเสนอราคาที่ปิดการขายได้เป็น PDF ภาษาไทยเพิ่มเข้ามาในโฟลเดอร์ และต้องมีคนนั่งคัดยอดลง Excel แยก 3 บริษัทในเครือ งานนี้ทำให้ Mac ทำแทน: ให้ Claude อ่าน PDF เฉพาะไฟล์ใหม่ ตรวจตัวเลขก่อนบันทึก แล้วสร้าง Excel ใหม่ทุกเช้าวันจันทร์ ผู้ใช้ปลายทางไม่ใช่สายเทคนิค จึงมีแอปหน้าต่างเดียวสำหรับลากไฟล์มาวางและดูสถานะ และติดตั้งได้ด้วยการดับเบิลคลิกไฟล์เดียว

บทบาท
เจ้าของงาน: เก็บ requirement กับผู้ใช้, กำหนดขอบเขตและข้อจำกัดด้านความปลอดภัย, ตัดสินใจระหว่างทาง และตรวจผลกับ PDF ตัวอย่างจริง
ช่วงเวลา
9–10 พ.ย. 2026 · 2 วัน · 5 commits
เครื่องมือ
Claude Code, Claude API, Python, openpyxl, pdftotext, launchd, Keychain, Swift, SwiftUI, bash

ภาพหน้าจอเป็นแอปจริงที่ build แล้ว แต่ป้อนข้อมูลเดโม ชื่อไฟล์ ลูกค้า และบริษัทเป็นชื่อสมมติทั้งหมด ไม่มีข้อมูลลูกค้าจริง · โค้ดเขียนโดย AI agents (Claude) ภายใต้ requirement และการตรวจของผม · ซอร์สโค้ดเป็น repo ส่วนตัว

หน้าต่างแอป สรุปใบเสนอราคา: บอกรอบล่าสุดวันจันทร์ 9 พ.ย. 08:04 เรียบร้อย และรอบถัดไปจันทร์ 16 พ.ย. 08:00, ช่องลากไฟล์ PDF มาวาง, ปุ่มเริ่มสรุปตอนนี้ เปิด Excel เปิดโฟลเดอร์ PDF และตารางสถานะ 9 ไฟล์: ทำแล้ว 6 ควรตรวจ 2 รอรอบถัดไป 1
แอปหน้าต่างเดียวสำหรับผู้ใช้: ลาก PDF มาวาง กดสรุปเองได้ และเห็นทันทีว่าไฟล์ไหนอ่านแล้ว ไฟล์ไหนควรเทียบกับ PDF พร้อมเหตุผล

ปัญหา

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

ทางเลือกที่พิจารณา

ทางเลือกข้อดีเหตุผลที่ไม่เลือก
Excel Power Query (From PDF)อยู่ใน Excel ไม่ต้องติดตั้งอะไรอ่านตารางตามตำแหน่ง รูปแบบเปลี่ยนนิดเดียวก็พัง และข้อความไทยในตัวอย่างเพี้ยน
Power Automate + AI Builderตั้งเวลาและอ่านเอกสารในระบบเดียวต้องมีใบอนุญาตเพิ่ม และต้องมีคนดูแล flow
ลาก PDF ใส่แชต AI ทุกสัปดาห์ไม่ต้องเขียนโค้ดทำมือทุกครั้ง รูปแบบ Excel ไม่คงที่ และไม่มีตัวกันนับซ้ำ

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

ทำงานอย่างไร

ทุกเช้าวันจันทร์ launchd ของ macOS เรียกโปรแกรมหนึ่งรอบ (ถ้าเครื่องหลับอยู่ จะรันตอนเครื่องตื่น) แต่ละรอบทำตามลำดับนี้

  1. สแกนโฟลเดอร์ แล้วคำนวณ SHA-256 ของแต่ละไฟล์ ไฟล์ที่เคยอ่านแล้วดึงผลจาก cache ทันที เปลี่ยนชื่อไฟล์ก็ไม่ต้องอ่านใหม่
  2. ให้ Claude อ่านเฉพาะไฟล์ใหม่ ได้ผลเป็นข้อมูลแบบมีโครงสร้าง (เลขที่ วันที่ ผู้ขาย ลูกค้า รายการ ยอดก่อน VAT, VAT, ยอดรวม) แล้วตรวจชนิดข้อมูลก่อนบันทึก
  3. ตรวจตัวเลข ก่อน VAT + VAT ต้องเท่ายอดรวม และ VAT ต้องราว 7% ถ้าไม่ลงตัว แถวนั้นถูกติดป้าย "ควรตรวจ" และจะให้ Claude อ่านซ้ำอีกหนึ่งครั้งในรอบหน้า
  4. จับคู่บริษัทและกันนับซ้ำ ด้วยเลขผู้เสียภาษีหรือชื่อย่อ ถ้ามีหลายฉบับของเลขที่เดียวกัน นับเฉพาะ Rev สูงสุด
  5. เขียน Excel ใหม่ทั้งไฟล์ แบบ atomic: ชีตละบริษัท ชีต "ไม่ระบุบริษัท" ถ้ามี และชีต "สรุป" ยอดรายบริษัท รายเดือน รายสัปดาห์ และรายการที่ต้องตรวจ

ถ้า Claude ใช้ไม่ได้ เช่น โควตาเต็มหรือ token หมดอายุ โปรแกรมไม่ล้ม แต่ใช้ pdftotext อ่านแทน ติดป้ายว่าควรเช็ก แล้วรอบหน้าจะอ่านไฟล์เหล่านั้นใหม่ด้วย Claude เอง สาเหตุที่ใช้ไม่ได้ถูกเขียนเป็นภาษาไทยไว้ในชีต "สรุป"

ให้ AI อ่านเอกสารลูกค้าอย่างปลอดภัย

PDF ที่มาจากภายนอกอาจมีข้อความแอบแฝงที่สั่ง AI ให้ทำอย่างอื่น และ PDF มีชื่อลูกค้า ราคา และเลขผู้เสียภาษี จึงออกแบบให้ Claude ทำได้แค่อ่านไฟล์เดียวที่ให้

เรื่องการจัดการ
สิ่งที่ Claude เข้าถึงได้หนึ่งไฟล์ต่อหนึ่งกระบวนการ ในโฟลเดอร์ชั่วคราวที่มีแค่สำเนา PDF มีเครื่องมือ Read อย่างเดียว ไม่มีเครื่องมือรันคำสั่ง แก้ไฟล์ หรือเข้าเน็ต และตั้งให้ปฏิเสธการอ่านนอกโฟลเดอร์นั้น
แยกจากการใช้งานส่วนตัวใช้โฟลเดอร์ค่า Claude Code แยก (สิทธิ์ 0700) จึงไม่เห็นโปรเจกต์ ความจำ หรือการตั้งค่าของผู้ใช้ และไม่เก็บประวัติการสนทนา
Token และ API keyเก็บใน Keychain ของ macOS ส่งให้โปรแกรมทางตัวแปรสภาพแวดล้อมเท่านั้น ไม่อยู่ในบรรทัดคำสั่ง ไฟล์ หรือ log และข้อความ error ถูกลบรูปแบบ key ออกก่อนแสดง
ผลที่ผิดรูปตรวจกับ schema ชุดเดียวกันทั้งทาง Claude Code และ API ถ้าไม่ผ่านจะไม่บันทึก และตัวตรวจยอดช่วยจับค่าที่ถูกบิดได้บางส่วน
ข้อมูลบริษัทจริงอยู่ใน config.json ที่ไม่เข้า git ตัวแพ็ก zip ปฏิเสธการวาง zip ไว้ใน repo และ tests ใช้ข้อมูลสมมติ

รองรับสองทางในการเรียก Claude: ใช้แพ็กเกจรายเดือนผ่าน claude -p (ค่าเริ่มต้น ไม่มีค่าใช้จ่ายต่อไฟล์ แต่จำกัด 50 ไฟล์ต่อรอบเพื่อไม่ให้กินโควตาแชต) หรือ API key แบบจ่ายตามใช้ ซึ่งอยู่ใต้เงื่อนไขธุรกิจที่ไม่นำข้อมูลไปฝึกโมเดล และถ้านโยบายไม่ให้ส่งข้อมูลออกนอกเครื่องเลย ก็ตั้งให้อ่านในเครื่องด้วย pdftotext อย่างเดียวได้

ออกแบบสำหรับผู้ใช้ที่ไม่ใช่สายเทคนิค

แยกตรรกะกับหน้าจอด้วยสัญญาที่ทดสอบได้

ตรรกะทั้งหมดอยู่ในโปรแกรม Python ตัวเดียว แอป SwiftUI แค่เรียกสคริปต์และอ่าน JSON จึงได้ผลเหมือนรอบตั้งเวลาทุกอย่าง ข้อตกลงระหว่างสองฝั่งเขียนเป็นสัญญา 6 ข้อ เช่น ความหมายของรหัสออก โครงสร้าง state.json และ JSON ของ status.sh

กลไกกันปัญหาอะไร
ล็อกไฟล์ (flock) และรหัสออก 3กดจากแอประหว่างรอบตั้งเวลา จะไม่เริ่มรอบซ้อน
เขียน state.json แบบ atomicแอปไม่อ่านเจอไฟล์ครึ่งเดียว และรู้ว่ารอบก่อนล่มกลางทาง
Fixture JSON ที่สร้างจากโปรแกรมจริงTest ฝั่ง Python เช็กว่าผลจริงยังตรงกับ fixture ส่วนฝั่ง Swift ใช้ fixture เดียวกันถอดรหัส ถ้าฝั่งไหนเปลี่ยนโดยไม่บอก test แดงทันที
ถอดรหัส JSON แบบทนฟิลด์ขาดหรือฟิลด์ใหม่อัปเดตโปรแกรมหลักโดยไม่ต้องแก้แอปทุกครั้ง

ปัญหาที่เจอและการแก้

อาการสาเหตุการแก้
ลองกับ token ปลอม แต่ผลบอก subtype: successClaude Code ตอบ success ทั้งที่ล้มเหลวแยกประเภท error จากรหัส HTTP (429 โควตา, 401/403 token, 404 รุ่น) ก่อน แล้วค่อยดูข้อความเต็มตามเอกสาร ไม่เชื่อช่อง subtype
Sonnet 5.5 ไม่รับคำสั่งบังคับให้ตอบผ่าน toolรุ่นที่คิดก่อนตอบปฏิเสธ forced tool use ตามเอกสารใช้ tool_choice แบบ auto สั่งรูปแบบใน prompt ถ้าไม่ได้โครงสร้างลองใหม่ 1 ครั้ง และไม่บันทึกผลที่ถูกตัดกลางทาง
PDF ใหญ่เกิน context ถูกเข้าใจว่าโควตาเต็มเดาประเภท error จากคำสั้น ๆจับวลีเต็มเท่านั้น ไฟล์ใหญ่เกินข้ามแค่ไฟล์นั้น ไม่หยุดทั้งรอบ
Claude ค้างแล้วทิ้งกระบวนการลูกไว้หยุดแค่ตัวหลักเมื่อหมดเวลาหยุดทั้ง process group ด้วย SIGTERM แล้ว SIGKILL และถ้าหมดเวลา 2 ไฟล์ติดกันหยุดใช้ Claude ในรอบนั้น
Build แอปไม่ผ่านเมื่อใช้ @StatemacOS 27 SDK ต้องใช้ Xcode เต็มตัวสำหรับ macro นี้ใช้ ObservableObject + @StateObject เหมือนแอป menu bar และ build ด้วย Command Line Tools ได้

ผลลัพธ์

ข้อจำกัด

สิ่งที่ได้เรียนรู้