Files
lcbp3/frontend/__tests__

// File: frontend/tests/README.md // Change Log // - 2026-06-13: Document frontend unit test naming and header conventions.

Frontend Test Conventions

ใช้ไฟล์ *.test.ts หรือ *.test.tsx เท่านั้น เพราะ frontend/vitest.config.ts include pattern รองรับชื่อนี้

ทุก test file ต้องขึ้นต้นด้วย:

// File: frontend/path/to/file.test.ts
// Change Log
// - YYYY-MM-DD: คำอธิบายการเปลี่ยนแปลง

แนวทางหลัก:

  • ใช้ createTestQueryClient() จาก @/lib/test-utils สำหรับ hook/component ที่ใช้ TanStack Query
  • Mock HTTP ผ่าน apiClient ที่ตั้งค่าไว้ใน vitest.setup.ts
  • Mock data ฝั่ง Public API ต้องใช้ publicId เป็น UUIDv7 ตาม ADR-019
  • ห้ามใช้ console.log ใน test
  • หลีกเลี่ยง any; ถ้าจำเป็นต้อง mock shape บางส่วน ให้ใช้ Partial<T> หรือ type เฉพาะของ test