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 ส่วนตัว
ปัญหา
ใบเสนอราคาที่ขายงานได้ถูกเก็บเป็น PDF ในโฟลเดอร์เดียว คนที่ต้องการตัวเลขอยากรู้แค่ว่าแต่ละบริษัทขายได้เท่าไรต่อเดือนและต่อสัปดาห์ แต่การคัดลอกยอดทีละใบมีจุดผิดพลาดเยอะ
- PDF ภาษาไทยจากโปรแกรมออกเอกสาร เมื่อคัดลอกข้อความออกมามักเพี้ยน เช่น สระซ้อน หรือตัวเลขแยกคอลัมน์ผิด
- ใบเดียวกันมีหลายฉบับ (ฉบับแรกกับ Rev.1) ถ้านับทั้งคู่ ยอดจะเกินจริง
- ผู้ขายมี 3 บริษัท ต้องแยกให้ถูกชีต และใบที่ไม่ตรงบริษัทไหนต้องไม่หายเงียบ
- ผู้ใช้ไม่ได้ใช้ Terminal ทุกอย่างต้องทำได้จาก Finder และหน้าต่างแอป
ทางเลือกที่พิจารณา
| ทางเลือก | ข้อดี | เหตุผลที่ไม่เลือก |
|---|---|---|
| Excel Power Query (From PDF) | อยู่ใน Excel ไม่ต้องติดตั้งอะไร | อ่านตารางตามตำแหน่ง รูปแบบเปลี่ยนนิดเดียวก็พัง และข้อความไทยในตัวอย่างเพี้ยน |
| Power Automate + AI Builder | ตั้งเวลาและอ่านเอกสารในระบบเดียว | ต้องมีใบอนุญาตเพิ่ม และต้องมีคนดูแล flow |
| ลาก PDF ใส่แชต AI ทุกสัปดาห์ | ไม่ต้องเขียนโค้ด | ทำมือทุกครั้ง รูปแบบ Excel ไม่คงที่ และไม่มีตัวกันนับซ้ำ |
จึงเลือกทำโปรแกรมเล็ก ๆ บนเครื่องผู้ใช้ ที่ได้ผลแบบเดียวกันทุกสัปดาห์ และเตือนเมื่อตัวเลขไม่ลงตัว
ทำงานอย่างไร
ทุกเช้าวันจันทร์ launchd ของ macOS เรียกโปรแกรมหนึ่งรอบ (ถ้าเครื่องหลับอยู่ จะรันตอนเครื่องตื่น) แต่ละรอบทำตามลำดับนี้
- สแกนโฟลเดอร์ แล้วคำนวณ SHA-256 ของแต่ละไฟล์ ไฟล์ที่เคยอ่านแล้วดึงผลจาก cache ทันที เปลี่ยนชื่อไฟล์ก็ไม่ต้องอ่านใหม่
- ให้ Claude อ่านเฉพาะไฟล์ใหม่ ได้ผลเป็นข้อมูลแบบมีโครงสร้าง (เลขที่ วันที่ ผู้ขาย ลูกค้า รายการ ยอดก่อน VAT, VAT, ยอดรวม) แล้วตรวจชนิดข้อมูลก่อนบันทึก
- ตรวจตัวเลข ก่อน VAT + VAT ต้องเท่ายอดรวม และ VAT ต้องราว 7% ถ้าไม่ลงตัว แถวนั้นถูกติดป้าย "ควรตรวจ" และจะให้ Claude อ่านซ้ำอีกหนึ่งครั้งในรอบหน้า
- จับคู่บริษัทและกันนับซ้ำ ด้วยเลขผู้เสียภาษีหรือชื่อย่อ ถ้ามีหลายฉบับของเลขที่เดียวกัน นับเฉพาะ Rev สูงสุด
- เขียน 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 อย่างเดียวได้
ออกแบบสำหรับผู้ใช้ที่ไม่ใช่สายเทคนิค
- ติดตั้งด้วยการดับเบิลคลิก: ไฟล์
ติดตั้ง.commandทำ 11 ขั้นให้เอง บอกก่อนทุกขั้นว่าจะทำอะไร ถามก่อนทุกอย่างที่ต้องล็อกอิน รันซ้ำได้โดยไม่ทำลายอะไร และจบด้วยรายการผ่าน/ไม่ผ่านเป็นภาษาไทย - ย้ายโปรแกรมออกจาก Desktop/Downloads ให้เอง: macOS กันงานตั้งเวลาไม่ให้อ่านโฟลเดอร์เหล่านี้โดยไม่มีหน้าต่างเตือน ถ้าปล่อยไว้ Excel จะไม่ถูกสร้างแบบเงียบ ๆ
- ตัวตรวจระบบ:
ตรวจระบบ.commandเช็ก 10 เรื่อง ทุกบรรทัดที่ไม่ผ่านบอกวิธีแก้ต่อท้าย - ตัวถอนการติดตั้งที่ระวังข้อมูล: แสดงรายการก่อน ต้องพิมพ์คำว่า
ลบจึงจะลบ ไฟล์ PDF และ Excel ของผู้ใช้ถามแยกทีละข้อ (ค่าเริ่มต้นคือไม่ลบ) ไม่แตะโฟลเดอร์ git และ symlink - แอปหน้าต่างเดียว: คัดลอก PDF เข้าโฟลเดอร์โดยเทียบ SHA-256 ไม่ทับไฟล์เดิม กดสรุปได้ทันทีแต่ไม่ซ้อนกับรอบตั้งเวลา และบอกสถานะรายไฟล์ 4 แบบพร้อมเหตุผล
แยกตรรกะกับหน้าจอด้วยสัญญาที่ทดสอบได้
ตรรกะทั้งหมดอยู่ในโปรแกรม 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: success | Claude 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 แอปไม่ผ่านเมื่อใช้ @State | macOS 27 SDK ต้องใช้ Xcode เต็มตัวสำหรับ macro นี้ | ใช้ ObservableObject + @StateObject เหมือนแอป menu bar และ build ด้วย Command Line Tools ได้ |
ผลลัพธ์
- เสร็จใน 2 วัน ราว 2,300 บรรทัด Python, 1,500 บรรทัด Swift และ 2,300 บรรทัด shell สำหรับติดตั้ง ตรวจ ถอน และแพ็ก
- Tests 438 ข้อ ผ่านทั้งหมด Python 355 ข้อ และ Swift 83 ข้อ (รันซ้ำ 12 พ.ย. 2026) ตัวติดตั้งและตัวถอนทดสอบใน "เครื่องจำลอง" ที่ใช้ HOME ปลอมและคำสั่งปลอม จึงไม่แตะ Keychain, launchd หรือ Claude จริง
- ตัวอ่านสำรองอ่าน PDF ตัวอย่างจริงได้ตรงทั้ง 3 ไฟล์ และรอบที่สองใช้ cache ครบ ไม่อ่านซ้ำ
- ส่งมอบเป็น zip เดียว ตัวแพ็กตรวจรายชื่อไฟล์กับรายการที่อนุญาต ชื่อไฟล์ภาษาไทยและสิทธิ์รันครบ และแอปข้างในยังผ่าน
codesign --verify --strict
ข้อจำกัด
- ทาง Claude ทั้งแพ็กเกจรายเดือนและ API ยังไม่เคยรันกับ token หรือ key จริง ทดสอบด้วยตัวจำลองและ token ปลอม ต้องรันจริงหนึ่งรอบแล้วเทียบ Excel กับ PDF ก่อนใช้งาน
- การติดตั้งบนเครื่องผู้ใช้จริง (macOS 15) และการตั้งเวลา launchd จริงยังไม่ได้ลอง
- งวดเดือนและสัปดาห์ใช้วันที่บนใบเสนอราคา เพราะ PDF ไม่มีวันที่ปิดการขาย
- แอปเซ็นแบบ ad-hoc และ build เฉพาะ Mac ชิป Apple
สิ่งที่ได้เรียนรู้
- งานที่ AI อ่านเอกสาร ต้องมีตัวตรวจที่ไม่ใช่ AI ปิดท้าย สมการง่าย ๆ อย่าง ก่อน VAT + VAT = ยอดรวม จับได้ทั้งการอ่านผิดและผลที่ถูกบิด
- เขียนแยกในเอกสารว่าอะไร "ทดสอบแล้ว" และอะไร "ยังไม่เคยเห็นของจริง" ทำให้ผู้ใช้รู้ว่าต้องเช็กอะไรในรอบแรก แทนที่จะเชื่อว่าทุกอย่างพร้อม
- สำหรับผู้ใช้ที่ไม่ใช่สายเทคนิค งานส่วนใหญ่ไม่ใช่ตัวอ่าน PDF แต่เป็นการติดตั้ง ข้อความ error ภาษาไทย และการถอนที่ไม่ลบไฟล์ของเขาผิดชิ้น