260518:1640 204 and 302 refactor #11

2026-05-18 16:40:16 +07:00
parent 0ed27f477f
commit 7e6ad0d346
9 changed files with 1125 additions and 142 deletions
@@ -0,0 +1,83 @@
+---
+auto_execution_mode: 0
+description: Manual real-app verification — ตรวจแอปจริงหลัง build pass เพื่อยืนยันว่าทำงานถูกต้องใน environment จริง (ไม่ใช่แค่ unit test)
+---
+
+# Workflow: check-real-app
+
+ใช้เมื่อ build/lint/test ผ่านแล้ว แต่ต้องการยืนยันว่าแอปจริงทำงานถูกต้อง
+เน้นการตรวจที่ unit test ตรวจไม่ได้: UI flow, API response จริง, console errors, network requests
+
+## ขั้นตอน
+
+### 1. เริ่ม Dev Server (ถ้ายังไม่รัน)
+
+ตรวจก่อนว่ามี dev server รันอยู่แล้วหรือไม่ เพื่อป้องกันรันซ้ำ:
+
+```bash
+# Backend
+pnpm --filter backend run start:dev
+
+# Frontend
+pnpm --filter frontend run dev
+```
+
+### 2. ตรวจ Endpoint / หน้าที่เปลี่ยน
+
+- เปิด URL ที่เกี่ยวข้องกับงานที่เพิ่ง implement
+- ตรวจ API endpoint ด้วย curl หรือ browser dev tools
+- ดู network tab ว่า request/response ถูกต้อง
+
+```bash
+# ตัวอย่างตรวจ API จริง
+curl -X GET http://localhost:3001/api/[endpoint] \
+  -H "Authorization: Bearer <token>" | jq .
+```
+
+### 3. ตรวจ Console / Log
+
+- **Frontend**: เปิด browser DevTools → Console tab — ต้องไม่มี error หรือ warning ที่ไม่คาดเดา
+- **Backend**: ดู terminal log — ตรวจว่าไม่มี unhandled exception หรือ SQL error
+
+### 4. ตรวจ Happy Path + Edge Case หลัก
+
+ตรวจ flow ที่เกี่ยวข้องอย่างน้อย:
+- [ ] Happy path ทำงานถูกต้อง
+- [ ] Input ผิดรูปแบบ → แสดง error message ที่เหมาะสม
+- [ ] Unauthorized access → redirect/403 ถูกต้อง
+- [ ] หน้าที่ไม่ได้แก้ยังทำงานปกติ (regression check)
+
+### 5. ตรวจ NAP-DMS Specific
+
+- [ ] UUID ใน URL และ response เป็น string format ถูกต้อง (ไม่ใช่ integer)
+- [ ] ไม่มี `NaN` หรือ `undefined` ใน form values หรือ API payload
+- [ ] Thai/English text แสดงผลถูกต้อง (i18n)
+- [ ] RBAC: role ที่ไม่มีสิทธิ์ไม่เห็น/เข้าถึงไม่ได้
+
+## 🚫 No Fake Evidence Rule
+
+> **ห้ามรายงานว่าตรวจแอปจริงแล้ว ถ้าไม่ได้เปิดแอปและตรวจจริง**
+> ถ้าตรวจไม่ได้ (เช่น ไม่มี DB, ไม่มี token) ให้ระบุเหตุผลชัดเจน
+
+## ✅ Mandatory Output
+
+รายงานท้ายงานต้องมีครบ:
+
+### Commands run
+```
+✅ curl GET /api/correspondences   → 200 OK, returned 3 records
+✅ curl POST /api/correspondences  → 201 Created, uuid: "019..."
+❌ ไม่ได้ตรวจ: file upload flow   → เหตุผล: ต้องการ ClamAV service ที่ไม่มีใน local
+```
+
+### Evidence
+- URL ที่ตรวจ + HTTP status code
+- Screenshot หรือ response body (ถ้า sensitive ให้ mask)
+- Console log ที่พบ (ถ้ามี error ต้องระบุ)
+
+### Limitations / Risks
+- flow หรือ endpoint ที่ยังไม่ได้ตรวจ + เหตุผล
+- ความเสี่ยงที่ควรตรวจใน staging ก่อน deploy
+
+### Next steps
+- งานที่ต้องทำต่อ หรือ flag สำหรับ QA