IQ Tutor

IQ Tutor คือระบบที่รันสถาบันกวดวิชาแห่งหนึ่งจริง ๆ — มีนักเรียนจริง ติวเตอร์จริง และเงินเดือนที่ต้องจ่ายถูกต้องทุกเดือน ผมเป็นคนเดียวที่ออกแบบ เขียน deploy และดูแลมันทั้งหมด

ระบบแบ่งเป็นสามส่วน: backend เป็น Express + Prisma + PostgreSQL บน Railway, แอดมินแพเนลเป็น React บน Vercel และแอปสำหรับติวเตอร์กับผู้ปกครองเป็น LINE LIFF เพราะคนไทยไม่อยากโหลดแอปใหม่ — ทุกคนมี LINE อยู่แล้ว

ส่วนที่ยากที่สุดไม่ใช่โค้ด แต่เป็น business logic: กฎการจ่ายเงินติวเตอร์ การเช็กชื่อ การเรียนชดเชย (makeup) การสลับติวเตอร์แทน และการตัดคาบเรียน กฎพวกนี้ไม่ได้อยู่ในเอกสารที่ไหน ต้องนั่งคุยกับเจ้าของสถาบันทีละเคสแล้วแปลงเป็นโค้ดที่ตรวจสอบได้

ทุกฟีเจอร์มีเอกสารกำกับ README ของ repo เป็น changelog ที่มีกว่า 95 หัวข้อ แต่ละหัวข้อไม่ได้บอกแค่ว่าฟีเจอร์ทำอะไร แต่บอกว่า ทำไมถึงออกแบบแบบนั้น รวมถึงบั๊กที่เป็นต้นเหตุ ทำให้ปัญหาที่แก้ไปแล้วไม่ย้อนกลับมาอีก