690519:1631 224 to 226 AI #01

2026-05-19 16:31:50 +07:00
parent 3e25097470
commit ea5499123e
127 changed files with 12387 additions and 42 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
@@ -0,0 +1,100 @@
+---
+auto_execution_mode: 0
+description: Resume pending multi-session work — อ่าน context เดิม, หา last checkpoint, สรุปสถานะปัจจุบัน และวางแผนต่อ โดยไม่ทำงานซ้ำ
+---
+
+# Workflow: resume-pending-work
+
+ใช้เมื่อกลับมาทำงานที่ค้างไว้ข้าม session — เช่น งานใหญ่ที่แบ่งเป็น phase, งาน migration, หรืองานที่หยุดกลางคัน
+
+## ขั้นตอน
+
+### 1. อ่าน Context เดิม
+
+ตรวจแหล่งข้อมูลเหล่านี้ตามลำดับ:
+
+```
+1. Memory system — ดู system-retrieved memories ที่เกี่ยวข้อง
+2. specs/200-fullstacks/<feature>/tasks.md — ดู task status ล่าสุด
+3. git log --oneline -20 — ดู commits ล่าสุด
+4. progress.txt หรือ PROGRESS.md (ถ้ามี) — ดู notes ที่ทิ้งไว้
+```
+
+### 2. หา Last Checkpoint
+
+ระบุให้ชัดว่า:
+- **ทำไปถึงไหนแล้ว** — phase/task/file ที่ complete แล้ว
+- **ค้างอยู่ที่ไหน** — step ที่กำลังทำอยู่ตอนหยุด
+- **ยังไม่ได้ทำอะไร** — tasks ที่เหลือ
+
+### 3. ตรวจสถานะ Build ปัจจุบัน
+
+ก่อนทำงานต่อ ต้องรู้ว่า codebase ปัจจุบัน clean หรือไม่:
+
+```bash
+# ตรวจ TypeScript errors
+pnpm --filter backend run build 2>&1 | tail -20
+pnpm --filter frontend run build 2>&1 | tail -20
+
+# ดู uncommitted changes
+git status --short
+git diff --stat HEAD
+```
+
+### 4. สรุปสถานะและวางแผนต่อ
+
+ก่อนลงมือ ให้สรุปให้ผู้ใช้เห็นก่อน:
+
+```
+✅ เสร็จแล้ว:
+  - Phase 1: Entity + Migration (commit abc1234)
+  - Phase 2: Service layer (commit def5678)
+
+🔄 ค้างอยู่:
+  - Phase 3: Controller — เขียนครึ่งนึง, ยังไม่มี tests
+
+⏳ ยังไม่ได้ทำ:
+  - Phase 4: Frontend integration
+  - Phase 5: E2E tests
+
+🚩 Issues ที่พบ:
+  - build error ที่ correspondence.service.ts:142
+```
+
+จากนั้นถามผู้ใช้ว่าต้องการ:
+- ทำงานต่อจาก checkpoint เดิม
+- Skip ขั้นตอนที่ค้าง (พร้อมระบุ risk)
+- Re-verify งานที่ทำไปแล้วก่อน
+
+### 5. ตรวจ NAP-DMS Specific
+
+ก่อน resume ให้ตรวจ:
+- [ ] ADR ที่เกี่ยวข้องยังไม่เปลี่ยนแปลง (ดู git log ที่ `specs/06-Decision-Records/`)
+- [ ] Schema ที่ใช้อยู่ตรงกับ `lcbp3-v1.9.0-schema-02-tables.sql`
+- [ ] ไม่มี merge conflict หรือ stash ค้าง
+
+## 🚫 No Fake Resume Rule
+
+> **ห้ามบอกว่า "ทำต่อจากตรงนี้" โดยไม่ได้อ่าน context เดิมจริง**
+> ต้องระบุหลักฐานที่ชัดเจนว่า checkpoint อยู่ที่ไหน
+
+## ✅ Mandatory Output
+
+### Last checkpoint summary
+```
+- เสร็จแล้ว: [phase/commit/task]
+- ค้างอยู่: [file:line หรือ task ที่หยุด]
+- ยังไม่ได้ทำ: [tasks ที่เหลือ]
+```
+
+### Build status
+```
+✅ backend build  → clean
+❌ frontend build → 2 errors (ระบุ errors)
+```
+
+### Plan ต่อ
+แผน 3-5 ข้อที่จะทำในส่วนที่เหลือ พร้อม verification method
+
+### Risks / Blockers
+สิ่งที่อาจ block งาน หรือต้องระวังก่อนทำต่อ
@@ -6,8 +6,45 @@ description: A comprehensive verification system for LCBP3-DMS development sessi
 This workflow invokes the verification-loop skill to perform comprehensive verification of LCBP3-DMS code changes.

 Invoke the verification-loop skill when:
+
 - After completing a feature or significant code change
 - Before creating a PR
 - When you want to ensure quality gates pass
 - After refactoring
 - Before deploying to staging/production
+
+## 🚫 No Fake Evidence Rule
+
+> **ห้ามรายงานว่า test ผ่าน / build สำเร็จ ถ้าไม่ได้รันจริง**
+> ถ้ารันไม่ได้ ให้ระบุเหตุผลอย่างชัดเจนแทน
+
+## ✅ Mandatory Output (ทุก verification ต้องมีครบ)
+
+รายงานท้ายงานต้องมี 5 หัวข้อนี้เสมอ:
+
+### 1. Pipeline trace
+
+ลำดับขั้นตอนที่ทำจริง: Understand → Plan → Execute → Verify → Handoff
+
+### 2. Commands run
+
+รายการคำสั่งที่รันจริงพร้อมผลสรุป:
+
+```
+✅ pnpm run build          → Pass (0 errors)
+✅ pnpm run lint           → Pass (0 warnings)
+✅ pnpm run test           → 42 passed, 0 failed
+❌ ไม่ได้รัน: e2e tests    → เหตุผล: ต้องการ DB จริง, ไม่มีใน CI environment
+```
+
+### 3. Verification / Evidence
+
+หลักฐานจริง เช่น build output, test result, diff, screenshot, link
+
+### 4. Limitations / Risks
+
+สิ่งที่ยังไม่ได้ตรวจ, ความเสี่ยง, ข้อจำกัดของ environment
+
+### 5. Next steps
+
+งานที่ต้องทำต่อหลัง verification