Boss Battle: Books API ที่ทำ CRUD ครบวงจร

เป้าหมายของ Boss นี้: ประกอบ CRUD ทั้ง 4 เข้าด้วยกันเป็น API เดียวที่สมบูรณ์ และทดสอบ ครบทุกเส้นทางด้วยตัวเอง

1. Learning Objective

จบ Boss นี้คุณจะ

• มี REST API ที่ทำ CRUD ครบ 5 endpoint พร้อม Status Code ถูกต้องทุกกรณี
• ทดสอบ API เป็นระบบด้วย Test Checklist
• ประเมินได้ว่าโค้ดตัวเองยังขาดอะไร

2. ภาพรวมสิ่งที่ต้องมี

                     Books API (Chapter 3 ฉบับสมบูรณ์)

+--------+---------------+----------------------+--------------------------+
| Method | Path          | สำเร็จ                 | ล้มเหลว                    |
+--------+---------------+----------------------+--------------------------+
| GET    | /books        | 200 + Array          | -                        |
| GET    | /books/:id    | 200 + Object         | 404 ถ้าไม่เจอ               |
| POST   | /books        | 201 + Object ที่สร้าง  | 400 ถ้าข้อมูลไม่ครบ          |
| PUT    | /books/:id    | 200 + Object ที่แก้    | 404 ไม่เจอ / 400 ไม่ครบ     |
| DELETE | /books/:id    | 200 + Object ที่ลบ     | 404 ถ้าไม่เจอ               |
+--------+---------------+----------------------+--------------------------+

flowchart LR
    C["Thunder Client<br/>/ Postman"] -->|"HTTP"| E["Express :3000"]
    E --> M["express.json()"]
    M --> R["Routes"]
    R -->|"readBooks()"| A[("data/books.json")]
    R -->|"writeBooks()"| A
    A -.->|"ข้อมูลอยู่ถาวร"| X["💾"]
    style E fill:#3f2d5c,stroke:#a855f7,color:#fff
    style A fill:#14532d,stroke:#22c55e,color:#fff

3. Test Checklist — ทดสอบให้ครบ 13 เคส

ยิงตามลำดับนี้แล้วติ๊กทีละข้อ จดผลจริงที่ได้เทียบกับที่ควรได้

[ ]  1. GET    /books                       -> 200, ได้ Array
[ ]  2. GET    /books/1                     -> 200, ได้ Object เล่มเดียว
[ ]  3. GET    /books/999                   -> 404
[ ]  4. GET    /books/abc                   -> 404  (ไม่ใช่ 500!)
[ ]  5. POST   /books  {ครบทุกฟิลด์}          -> 201, มี id ใหม่ไม่ซ้ำใคร
[ ]  6. POST   /books  {}                    -> 400
[ ]  7. POST   /books  {"title":""}          -> 400
[ ]  8. PUT    /books/1  {ครบทุกฟิลด์}        -> 200, id ยังเป็น 1
[ ]  9. PUT    /books/999                    -> 404
[ ] 10. DELETE /books/1                      -> 200
[ ] 11. DELETE /books/1  (ซ้ำ)               -> 404
[ ] 12. GET    /books                        -> จำนวนตรงกับที่คาด
[ ] 13. ปิด Server (Ctrl+C) แล้วเปิดใหม่
        GET /books                           -> ข้อมูลยังอยู่ครบเหมือนเดิม

เคสที่ 13 คือหัวใจของ Chapter นี้ — เปิดไฟล์ data/books.json ดูควบคู่ไปด้วย ทุกอย่างที่คุณเพิ่ม/แก้/ลบผ่าน API อยู่ในไฟล์นั้นจริงๆ ไม่ได้หายไปไหน

เคสที่ 4 สำคัญ — ยิง /books/abc แล้ว Number("abc") จะได้ NaN ซึ่ง NaN === NaN เป็น false เสมอ → .find() ไม่เจอ → ตอบ 404 พอดี ✅ ถ้าได้ 500 แปลว่ามีบางอย่างในโค้ดพังก่อนถึงจุดนั้น ต้องไปหา

4. Refactor — ลดโค้ดซ้ำ (ทำถ้าเวลาเหลือ)

สังเกตว่า 3 route มีโค้ดเหมือนกันเป๊ะๆ

const books = readBooks();
const id = Number(req.params.id);
const index = books.findIndex((b) => b.id === id);
if (index === -1) return res.status(404).json({ error: "ไม่พบหนังสือเล่มนี้" });

ดึงออกมาเป็นฟังก์ชันได้

function findBookIndex(req, res, books) {
  const id = Number(req.params.id);
  const index = books.findIndex((b) => b.id === id);
  if (index === -1) {
    res.status(404).json({ error: "ไม่พบหนังสือเล่มนี้" });
    return null;
  }
  return index;
}

// ใช้งาน
app.delete("/books/:id", (req, res) => {
  const books = readBooks();
  const index = findBookIndex(req, res, books);
  if (index === null) return;   // ตอบ 404 ไปแล้วข้างใน
  // ...
});

ทำไมต้องส่ง books เข้าไปด้วย? เพราะ route เจ้าของต้องใช้ Array ตัวเดียวกันนั้นต่อ เพื่อเอาไป writeBooks() — ถ้าให้ฟังก์ชันไป readBooks() เองข้างใน จะกลายเป็นคนละก้อน แล้วสิ่งที่เซฟลงไฟล์จะไม่ตรงกับที่ตรวจไว้

Chapter 5 จะสอนวิธีที่สวยกว่านี้ด้วย Middleware — ตอนนี้แค่รู้ว่าโค้ดซ้ำเป็นสัญญาณว่ามี วิธีที่ดีกว่ารออยู่

5. Common Mistakes รวมของทั้ง Chapter

6. Summary — จบครึ่งแรกของคอร์ส

คุณทำได้แล้ว:

• ✅ REST API ที่ทำ CRUD ครบ
• ✅ เก็บข้อมูลลงไฟล์จริง — ปิดเปิด Server ข้อมูลยังอยู่
• ✅ Status Code ถูกต้องทุกกรณี (200 / 201 / 400 / 404)
• ✅ Validate ข้อมูลก่อนบันทึก
• ✅ ทดสอบ API อย่างเป็นระบบ

สิ่งที่ยังขาดและจะได้เรียนต่อ:

• ❌ ถ้ามีคนยิงพร้อมกัน 2 คน ข้อมูลจะหายหนึ่งรายการ (อ่านไฟล์ทับกัน) และค้นช้าลงเรื่อยๆ เมื่อข้อมูลเยอะ → Backend Explorer 2 (PostgreSQL)
• ❌ ยังรับข้อมูลจาก URL ได้ทางเดียว → Chapter 4 (params/query/body)
• ❌ โค้ดซ้ำเยอะ ไม่มี log ไม่มี error handler กลาง → Chapter 5 (Middleware)
• ❌ ทุกอย่างกองอยู่ในไฟล์เดียว → Chapter 6 (แยกไฟล์)