🏗️ Architecture Decisions (การตัดสินใจทางสถาปัตยกรรมระบบ)

🇹🇭 ภาษาไทย (For User)

เครื่องมือ: Flutter
เหตุผลหลัก:
- Cross Platform: สามารถสร้างทั้งแอปพลิเคชัน Android และ iOS ได้จากโค้ดชุดเดียวกัน ลดค่าใช้จ่ายและเวลาในการพัมนา
- Single Codebase: การบำรุงรักษาง่ายขึ้น ไม่ต้องแยกทีมพัฒนา Android/iOS
- Modern UI: เครื่องมือวาดกราฟิกประสิทธิภาพสูงช่วยให้หน้าจอและการเปลี่ยนหน้าทำงานลื่นไหล สวยงามตามโมเดิร์นดีไซน์

เครื่องมือ: FastAPI (Python Framework)
เหตุผลหลัก:
- Fast & Async: ทำงานได้รวดเร็วระดับสูงด้วยการรองรับ asynchronous I/O เหมาะสำหรับรองรับผู้ใช้อัปโหลดสลิปและการประมวลผลพร้อมกัน
- Swagger UI Auto-generation: สร้างเอกสารสเปก API ให้อัตโนมัติ ทำให้ทีมและ AI ตัวอื่นๆ สามารถใช้ทดสอบเชื่อมต่อระบบได้ทันที
- AI Python Ecosystem: เนื่องจากความสามารถของ AI ส่วนใหญ่มี SDK และเครื่องมือพัฒนาดีที่สุดในภาษา Python เช่น การใช้โมเดล OCR และการวิเคราะห์ภาพสลิป

เครื่องมือ: PostgreSQL
เหตุผลหลัก:
- Reliable & ACID Compliant: เรื่องเงินเป็นเรื่องสำคัญ ฐานข้อมูลต้องรับประกันความถูกต้องสมบูรณ์ของยอดบัญชี มีระบบ transaction ที่ดีเยี่ยมยอดเงินไม่มีหาย
- Scalable: พร้อมขยายตัวรองรับโครงสร้างตารางและดัชนีการสืบค้นที่ซับซ้อนในอนาคต

เครื่องมือ: Clean Architecture (สถาปัตยกรรมแบบสะอาด)
เหตุผลหลัก:
- Easy to Maintain & Test: แยกส่วนการคำนวณหลัก (Domain Rules) ออกจากไลบรารีภายนอกหรือระบบติดต่อผู้ใช้ ทำให้เขียนโค้ดสำหรับ Unit Test ได้ง่ายและไม่ติดขัดเมื่อต้องปรับปรุงไลบรารี

Decision: Flutter
Reason:
- Cross Platform (iOS & Android)
- Single Codebase for easy maintenance
- High performance modern UI drawing

Decision: FastAPI
Reason:
- Extremely fast asynchronous I/O
- Auto-generated Swagger/OpenAPI documentation
- Native integration with Python AI & data science ecosystem

Decision: PostgreSQL
Reason:
- Strict ACID compliance (crucial for financial data accuracy)
- Scalability and robustness for complex relational structures

Decision: Clean Architecture
Reason:
- Clear separation of concerns (Domain, Use Cases, Infrastructure)
- Framework independence, making it easy to test and maintain