คู่มือและสถาปัตยกรรมระบบบันทึกข้อมูลคู่ขนาน VIP (VIP Research Dual-Capture Complete Guide)

1. บทนำและวัตถุประสงค์ (Executive Summary & Overview)

ระบบ VIP Research Dual-Capture Mode ออกแบบมาเป็นพิเศษสำหรับอาสาสมัครระดับ VIP / ผู้เชี่ยวชาญต้นแบบ (Master Pose Creators) เพื่อจัดเก็บข้อมูลหลักฐานการฝึก 2 รูปแบบคู่ขนานกันโดยอัตโนมัติแบบไร้รอยต่อ (Hands-Free Lifecycle):

1. ข้อมูลพิกัดสรีระ 3 มิติ (Task A: AI Kinematics JSON): สกัดจุดข้อต่อ 33 จุดแบบ Real-time ด้วย MediaPipe Pose เพื่อนำไปสร้างแบบจำลองมาตรฐานทางชีวกลศาสตร์ (Ground Truth)
2. ข้อมูลวิดีโอดิบอ้างอิง (Task B: Tutorial Video Stream): บันทึกวิดีโอกล้องสดความละเอียด HD 720p อัตราการบีบอัด 1.2 Mbps แยกรายท่าฝึก (ท่าละ 3 นาที ~ 27-30MB) เพื่อให้ผู้ทรงคุณวุฒิตรวจสอบด้วยสายตา (Manual & Consensus Audit)

---

2. ระบบ URL Mode Router รวมศูนย์ (Centralized Query Parameters)

ผู้ใช้งานและทีมวิจัยสามารถเปิดใช้งานฟีเจอร์และโหมดต่าง ๆ ได้ทันทีผ่าน URL Parameters ดังนี้:

Parameter	ค่าที่รองรับ	พฤติกรรมของระบบ
mode	vip, vip_record (หรือ code=VIP_RECORD)	เปิดใช้งาน VIP Dual-Capture Mode + ล็อกกล้อง 720p HD + เปิดธีม Rose Gold
	research, volunteer	เข้าสู่ Volunteer RCT Mode (12 ท่า) อัตโนมัติ (บันทึกเฉพาะ JSON)
	placebo, control	เข้าสู่ Control / Sham UI Mode (ซ่อนกระดูก/คะแนนสด เพื่อการวิจัย Double-Blind)
	auditor, review	เปิดหน้าต่าง Auditor Consensus Dashboard สำหรับกรรมการประเมิน
lang	th, en	กำหนดภาษาเริ่มต้นของระบบและเสียงสังเคราะห์พูด (Web Speech API)
camera	back, environment, rear	สลับใช้กล้องหลัง (facingMode = "environment") สำหรับแท็บเล็ตบนขาตั้ง
debug	1, true	เปิดหน้าต่าง AI Performance & Latency Overlay

---

3. VIP Theme & Aesthetics Layer

เพื่อเสริมสร้างอัตลักษณ์และประสบการณ์ระดับพรีเมียมแก่ผู้เชี่ยวชาญ/VIP โดยไม่กระทบกับโครงสร้างหน้าจอหลัก:

1. Glassmorphic Recording Watermark HUD: ปรากฏที่มุมจอด้านซ้ายบนขณะทำการรำ 3 นาที:
   • แสดงสัญกรณ์ ● REC 720p HD | VIP MASTER CAPTURE พร้อมไฟกระพริบสีแดง
   • ระบุอัตราการส่งข้อมูล 1.2 Mbps และลำดับท่าปัจจุบัน (เช่น Pose 1/12)
2. Obsidian & Rose Gold Luxury Aesthetics:
   • หน้าต่าง Dashboard และช่วงเวลาพัก (Rest Phase) ปรับแต่งเป็นธีมสีทอง-แดงพรีเมียม (👑 VIP Master Research Session)
   • ป้ายหัวขอบเรืองแสงสีทอง (Gold/Amber Glow) และ Badge สัญกรณ์ VIP

---

4. สถาปัตยกรรมระบบ 5 มิติหลัก (Core Architecture & Feasibility Analysis)

4.1 การจำกัดสิทธิ์และการเข้าถึง (Access Control)

• เข้าใช้งานผ่าน app.html?mode=vip หรือ ?code=VIP_RECORD
• เมื่อตรวจพบรหัส VIP ระบบจะ:
  • กำหนดค่า window.isVipMode = true
  • แสดงป้ายไฟกระพริบ 👑 VIP Master Dual-Capture Active ด้านบน
  • บายพาสด่านความยินยอมและบังคับเข้าสู่ Research Mode อัตโนมัติ

4.2 การล็อกความละเอียดกล้อง 720p (Device & Camera Constraints)

• บังคับตั้งค่า Performance Mode เป็น balanced เพื่อให้กล้องส่งข้อมูลขนาด HD 720p (1280x720) ที่มีความคมชัดสูงสำหรับใช้อ้างอิงการทำโมเดลต้นแบบ
• หากอุปกรณ์รุ่นเก่าไม่รองรับ 720p ระบบจะ Fallback ไปยังความละเอียดใกล้เคียง (เช่น 640x480) อัตโนมัติโดยไม่แครช

4.3 สถาปัตยกรรมแยกท่อบันทึกวิดีโอ (Track Cloning Pipeline & Stream Isolation)

• ปัญหาเดิม: การส่ง MediaStream เดียวกันตรงๆ เข้าทั้ง MediaPipe และ MediaRecorder มักทำให้ฮาร์ดแวร์เอ็นโค้ดเดอร์ล็อกท่อสัญญาณ (Exclusive Lock) จนกล้องสดค้าง
• ทางแก้เชิงสถาปัตยกรรม:
  • ใช้คำสั่ง videoTrack.clone() เพื่อแยกท่อบันทึก MediaRecorder ออกจากท่อแสดงผลสด
  • ตรวจสอบ MimeType ตามค่ายเบราว์เซอร์อัตโนมัติ (video/webm;codecs=vp8 สำหรับ Chrome/Firefox และ video/mp4;codecs=h264 สำหรับ Safari)
  • ติดตั้งกลไก Forced Playback Resume (videoElement.play() ดีเลย์ 100ms) หลังเริ่มบันทึก เพื่อป้องกัน Safari บน macOS/iOS สั่งหยุดวิดีโอ

4.4 วงจรควบคุมการรำและการพัก 12 ท่าอัตโนมัติ (Hands-Free State Machine)

• ช่วงรำ (3 นาทีต่อท่า): ระบบเริ่มบันทึกวิดีโอและสกัดพิกัด AI อัตโนมัติ
• ช่วงพัก (ไม่มีการบันทึกกล้อง):
  • พักย่อย 1 นาทีระหว่างท่า
  • พักเบรกใหญ่ 5 นาทีหลังท่าที่ 4 และ 8 (ตามระเบียบกลุ่ม 4+4+4)
• การบริหารหน่วยความจำ (RAM & VRAM Optimization): การแยกบันทึกรายท่า 3 นาทีทำให้ได้ไฟล์ขนาดเล็กชิ้นละ ~27-30MB ทั้งหมด 12 ชิ้น ปราศจากความเสี่ยงเรื่องหน่วยความจำล้น (OOM Crash) ที่เกิดจากการอัดไฟล์ยาวก้อนเดียว 46 นาที
• เสียงนำทาง (Web Speech API): อ่านออกเสียงบอกลำดับท่า เวลาฝึก และช่วงเวลาพักอัตโนมัติทั้งภาษาไทยและอังกฤษ

4.5 การอัปโหลดคลาวด์เบื้องหลัง (Background Supabase Upload)

• ในระหว่างที่อาสาสมัครอยู่ในช่วงพัก (Rest Period) ระบบจะส่งไฟล์วิดีโอและไฟล์ JSON ขึ้น Supabase Storage (training-sessions bucket) ในลักษณะ Asynchronous Queue เบื้องหลังทันที
• ผูกเมทาดาทา video_file_url และ vip_dual_capture = true เข้าสู่ประวัติการฝึกในฐานข้อมูล

---

5. ข้อดี ข้อเสีย และแนวทางการบริหารความเสี่ยง (Pros, Cons & Risk Management)

ข้อดีของระบบ (Pros)

1. ลดภาระผู้ฝึกวิจัย (100% Hands-Free): เมื่อยืนเข้าตำแหน่งแล้ว ระบบจะควบคุมลำดับการรำ เปลี่ยนท่า พัก และบันทึกอัตโนมัติจนครบ 12 ท่า
2. หลักฐานการประเมินตรวจสอบย้อนกลับได้ (Full Audit Trail): ผู้ทรงคุณวุฒิมีทั้งพิกัด JSON 3D และภาพวิดีโอจริงเพื่อใช้วินิจฉัยความสอดคล้องกับแบบจำลอง AI
3. การเข้าถึงเฉพาะทาง (Targeted URL Routing): ส่งลิงก์เฉพาะให้ผู้เชี่ยวชาญเข้าสู่ระบบได้ทันทีโดยไม่ต้องผ่านขั้นตอนตั้งค่าที่ซับซ้อน

ข้อเสียและความเสี่ยงที่บริหารจัดการแล้ว (Risks & Mitigations)

1. ความร้อนสะสมและการดึงพลังงาน (Thermal Management): ป้องกันโดยการตั้งค่า Bitrate ไว้ที่ 1.2 Mbps และใช้ VP8/H.264 Baseline Profile ซึ่งกินพลังงานต่ำ
2. การพักแท็บเบราว์เซอร์ (Background Tab Suspension): ใช้ Web Speech API สังเคราะห์เสียงเตือนเป็นระยะ และแนะนำให้อาสาสมัครเปิดหน้าจอค้างไว้ตลอดช่วงการฝึก
3. การส่งข้อมูลล้มเหลว (Upload Resilience): หากการเชื่อมต่ออินเทอร์เน็ตสะดุด ระบบจะคงไฟล์ไว้ในคิว (uploadQueue) และพยายามส่งใหม่อัตโนมัติในรอบพักถัดไป