ข้ามไปเนื้อหาหลัก

● กำลังพัฒนา

CSV Budget CLI

CLI tool สำหรับวิเคราะห์รายจ่ายจากไฟล์ CSV ของธนาคาร — จัดหมวดหมู่อัตโนมัติ สรุปรายเดือน และ export รายงาน

· อ่านประมาณ 1 นาที

สารบัญ

ภาพรวม

ธนาคารส่วนใหญ่ export transaction history เป็น CSV แต่ format ต่างกันทุกเจ้า โปรเจกต์นี้ parse CSV หลาย format อัตโนมัติ จัดหมวดหมู่รายจ่ายด้วย keyword matching และแสดงสรุปรายเดือนใน terminal

สิ่งที่ทำแล้ว

  • Parser รองรับ CSV format จาก 3 ธนาคาร (header mapping แบบ config-driven)
  • Category matching engine: keyword list ต่อ category, fallback เป็น “อื่นๆ”
  • Summary view: แสดงยอดรวมต่อหมวด + top 5 รายจ่าย ด้วย cli-table3
  • Export รายงานเป็น Markdown table
  • Config file (~/.budget.json) เก็บ keyword rules และ category aliases

กำลังทำ

  • Interactive mode: ถาม category สำหรับ transactions ที่ match ไม่ได้ แล้วเรียนรู้
  • Month-over-month comparison: แสดง diff เปอร์เซ็นต์เทียบเดือนก่อน
  • Chart แบบ ASCII bar chart สำหรับ trend รายเดือน

เทคโนโลยี

  • TypeScript + Node.js 22
  • csv-parse สำหรับ parsing
  • commander สำหรับ CLI interface
  • cli-table3 สำหรับ table output
  • chalk สำหรับ color