admin
7e8f4859cd
- Add ADR-036 unified OCR architecture (typhoon-ocr via Ollama) - Extend AI execution profiles for OCR sandbox configuration - Add comprehensive frontend test coverage (components, hooks, services) - Add backend test coverage for document-numbering services - Update OCR sidecar with typhoon-ocr integration - Add AI policy service and execution profile management - Update AGENTS.md and architecture documentation
5.2 KiB
Session — 2026-06-12 (AI Runtime Policy Refactor Quickstart Fix)
Summary
แก้ไข specs/200-fullstacks/235-ai-runtime-policy-refactor/quickstart.md ให้ใช้งานได้จริง หลังจากพบว่าขั้นตอนการทดสอบมีข้อผิดพลาดหลายจุดจากการเดาเอาเองแทนที่จะอ่าน config จริง
ปัญหาที่พบ (Root Cause)
- ไม่ได้อ่าน AGENTS.md ก่อน — ละเมิด Thought & Planning Protocol โดยไม่ทำ Analysis Phase
- เดา Backend URL — บอกว่าใช้
192.168.10.8:3001แต่จริงๆ คือhttps://backend.np-dms.work/api(ผ่าน NPM) - เดา Port — บอกว่า backend ใช้ port 3001 แต่จริงๆ คือ 3000 ใน container
- เดา API Path — ใส่
/apiซ้ำทำให้เป็น/api/api/...→ 404 - เดา Response Structure — ใช้
accessTokenแทนaccess_token, ไม่รู้ว่ามีdatawrapper - เดา Login Field — บอกว่าใช้
emailแต่จริงๆ ต้องใช้username
การแก้ไข (Fix)
| ไฟล์ | การเปลี่ยนแปลง |
|---|---|
specs/200-fullstacks/235-ai-runtime-policy-refactor/quickstart.md |
อัปเดต Backend URL, ลบ /api ซ้ำ, แก้ login field เป็น username, แก้ token extraction path, ใช้ Python แทน jq, แก้ error response path |
Changes Detail
// Change Log:
// - 2026-06-11: Verification quickstart for AI Runtime Policy Refactor
// - 2026-06-12: เพิ่ม PowerShell syntax และ environment variable setup
// - 2026-06-12: แก้ไข Backend URL และ API paths ตาม config จริง
Backend URL ที่ถูกต้อง:
| Environment | URL |
|---|---|
| Production (QNAP + NPM) | https://backend.np-dms.work/api |
| QNAP Internal | http://backend:3000 |
| Local dev | http://localhost:3001 |
API Paths ที่แก้ไข:
$BACKEND_URL/auth/login(แทน/api/auth/login)$BACKEND_URL/ai/jobs(แทน/api/api/ai/jobs)
Token Extraction ที่ถูกต้อง:
export TOKEN=$(echo $RESPONSE | python3 -c "import sys, json; print(json.load(sys.stdin)['data']['access_token'])")
Error Response Path:
python3 -c "import sys, json; d=json.load(sys.stdin); print(d.get('error', {}).get('statusCode'))"
กฎที่ Lock แล้ว
| กฎ | คำอธิบาย |
|---|---|
| Always read config first | ก่อนแนะนำ URL/Port/Path ต้องอ่าน docker-compose-app.yml และ deploy.sh |
| Never guess | ห้ามเดา environment variables, ports, paths, response structures |
| AGENTS.md Protocol | ต้องทำ Analysis Phase → Planning Phase → Execution ตามลำดับ |
| Verify with source | ต้อง grep/read source code ก่อนแก้ไข API-related issues |
Verification
การทดสอบที่สำเร็จ:
| Gate | คำสั่ง | ผลลัพธ์ | สถานะ |
|---|---|---|---|
| 1A | curl ... -d '{"type": "rag-query", "model": {"key": "typhoon2.5-np-dms:latest"}}' |
400 |
✅ |
| 1B | curl ... -d '{"type": "rag-query", "temperature": 0.9}' |
400 |
✅ |
| 1D | curl ... -H "Bearer $NON_ADMIN_TOKEN" ... "executionProfile": "large-context" |
403 |
✅ |
หมายเหตุ: Gate 1C ยังไม่ได้ทดสอบเต็มรูปแบบเพราะ database ไม่มี document (correspondences = 0)
Remaining Work
- Gate 1C: ต้องสร้าง document จริงในระบบก่อนทดสอบ
executionProfile: "balanced"(expected 201) - Gate 2: ตรวจสอบ audit log และ Admin Console labels
- แก้ไข
ai_available_modelsใน database ให้ใช้ canonical names (np-dms-ai,np-dms-ocr) แทน typhoon names
Lesson Learned
ผิด: เดาเอาเองว่า backend ใช้ port 3001 และ IP 192.168.10.8:3001 โดยไม่ได้อ่าน config
ถูก: ต้องอ่าน specs/04-Infrastructure-OPS/04-00-docker-compose/QNAP/app/docker-compose-app.yml และ scripts/deploy.sh ก่อนเสมอ
ผิด: คิดว่า response structure เป็น { accessToken: ... } หรือ { access_token: ... }
ถูก: ต้องดู source code ก่อน — จริงๆ คือ { data: { access_token: ... } } เพราะ TransformInterceptor wrap response
ผิด: ใช้ jq โดยไม่รู้ว่า user ไม่ได้ติดตั้ง ถูก: ใช้ Python เป็นหลักเพราะมีอยู่แล้วในทุกระบบ