diff --git a/docs/test-cases-location.md b/docs/test-cases-location.md new file mode 100644 index 0000000..ed19dcd --- /dev/null +++ b/docs/test-cases-location.md @@ -0,0 +1,860 @@ +# Test Cases: Location Features +# HRMS Check-in/Check-out System + +## Document Information + +| Field | Value | +|-------|-------| +| **Document Version** | 1.0.0 | +| **Last Updated** | 2025-03-09 | +| **Project** | HRMS Check-in/Check-out | +| **Module** | Location Features | +| **Author** | QA Team | + +--- + +## 1. Overview (ภาพรวม) + +ระบบ HRMS Check-in/Check-out มีฟีเจอร์ Location ที่สำคัญในการลงเวลาเข้า-ออกงาน ฟีเจอร์ Location ประกอบด้วย: + +### 1.1 Location Features + +| Feature | Description | +|---------|-------------| +| **Location Services** | รับพิกัด GPS จากอุปกรณ์ผ่าน Geolocation API | +| **Location Validation** | ตรวจสอบความถูกต้องของตำแหน่ง (Mock Location Detection) | +| **POI Resolution** | แปลงพิกัดเป็นชื่อสถานที่ (Bangkok GIS / ArcGIS) | +| **Check-in/Check-out** | บันทึกตำแหน่งพร้อมรูปถ่าย | +| **Privacy Consent** | ขอความยินยอมการเข้าถึงตำแหน่ง | + +### 1.2 Related Files + +| File Path | Description | +|-----------|-------------| +| `/src/composables/useLocationValidation.ts` | Location validation logic | +| `/src/views/HomeView.vue` | Check-in/Check-out page | +| `/src/components/AscGISMap.vue` | Map component with location validation | +| `/src/api/api.checkin.ts` | Check-in API endpoints | +| `/src/stores/privacy.ts` | Privacy store for consent management | +| `/src/composables/usePermissions.ts` | Permission checking utilities | + +--- + +## 2. Test Environment (สภาพแวดล้อมการทดสอบ) + +### 2.1 Devices (อุปกรณ์ทดสอบ) + +| Device Type | OS | Browser | Notes | +|-------------|-------|---------|-------| +| Mobile | iOS 17+ | Safari | Test with real GPS | +| Mobile | Android 13+ | Chrome | Test with mock location apps | +| Desktop | macOS 14+ | Chrome 121+ | Test with Developer Tools | +| Desktop | Windows 11 | Edge 121+ | Test with Developer Tools | + +### 2.2 Tools (เครื่องมือทดสอบ) + +| Tool | Purpose | +|------|---------| +| Fake GPS Location (Android) | Mock location testing | +| Location Changer (iOS) | Mock location testing | +| Chrome DevTools | Sensor simulation | +| Xcode Simulator | iOS location simulation | +| Android Studio Emulator | Android location simulation | + +### 2.3 Test Data (ข้อมูลทดสอบ) + +| Data Type | Valid Value | Invalid Value | +|-----------|-------------|---------------| +| Latitude | 13.7563 (Bangkok) | 0, 91, -91 | +| Longitude | 100.5018 (Bangkok) | 0, 181, -181 | +| Accuracy (meters) | 10-50 | 101+ | +| Timestamp | Current time | 60+ seconds old | + +--- + +## 3. Validation Rules (กฎการตรวจสอบ) + +### 3.1 Location Validation Rules + +| Rule | Threshold | Error Message (Thai) | Mock Indicator | +|------|-----------|---------------------|----------------| +| Valid Coordinates | -90 to 90 lat, -180 to 180 lon, not (0,0) | "พิกัดตำแหน่งไม่ถูกต้อง กรุณาลองใหม่" | +3 | +| Fresh Timestamp | <= 60 seconds old | "ข้อมูลตำแหน่งเก่าเกินไป กรุณารับสัญญาณ GPS ใหม่" | +2 | +| GPS Accuracy | <= 100 meters | "ความแม่นยำตำแหน่งต่ำเกินไป กรุณาตรวจสอบการรับสัญญาณ GPS" | +1 | +| Movement Speed | <= 100 m/s (~360 km/h) | "ตรวจพบการเคลื่อนที่ด้วยความเร็วผิดปกติ อาจเป็นการจำลองตำแหน่ง" | +3 | +| Mock Detection | >= 3 indicators | "ตรวจพบว่าตำแหน่ง GPS อาจไม่ถูกต้อง กรุณาปิดแอปจำลองตำแหน่งและลองใหม่" | - | + +### 3.2 Validation Configuration + +```typescript +VALIDATION_CONFIG = { + MAX_TIMESTAMP_AGE_MS: 60_000, // 60 seconds + MAX_ACCURACY_METERS: 100, // 100 meters + MAX_SPEED_MS: 100, // ~360 km/h + POSITION_HISTORY_SIZE: 5, // positions for pattern detection + MOCK_INDICATOR_THRESHOLD: 3, // indicators for mock detection +} +``` + +--- + +## 4. Test Scenarios + +### 4.1 TC-LOC-01: Location Permission + +| Test Case | Description | Priority | +|-----------|-------------|----------| +| TC-LOC-01-01 | อนุญาตให้เข้าถึงตำแหน่ง | High | +| TC-LOC-01-02 | ปฏิเสธการเข้าถึงตำแหน่ง | High | + +### 4.2 TC-LOC-02: Location Acquisition + +| Test Case | Description | Priority | +|-----------|-------------|----------| +| TC-LOC-02-01 | รับพิกัด GPS สำเร็จ (Outdoor) | High | +| TC-LOC-02-02 | รับพิกัด GPS สำเร็จ (Indoor) | Medium | +| TC-LOC-02-03 | รับพิกัด GPS ล้มเหลว (GPS ไม่ทำงาน) | High | +| TC-LOC-02-04 | หมดเวลาขอรับพิกัด (Timeout) | Medium | + +### 4.3 TC-LOC-03: Location Validation + +| Test Case | Description | Priority | +|-----------|-------------|----------| +| TC-LOC-03-01 | พิกัดถูกต้อง (Valid coordinates) | High | +| TC-LOC-03-02 | พิกัดไม่ถูกต้อง (Invalid coordinates - (0,0)) | High | +| TC-LOC-03-03 | พิกัดนอกช่วง (Out of range) | Medium | +| TC-LOC-03-04 | ข้อมูลตำแหน่งเก่าเกินไป (Stale timestamp) | High | +| TC-LOC-03-05 | ความแม่นยำต่ำ (Poor accuracy) | Medium | +| TC-LOC-03-06 | ความเร็วเคลื่อนที่ผิดปกติ (Impossible speed) | High | + +### 4.4 TC-LOC-04: Mock Location Detection + +| Test Case | Description | Priority | +|-----------|-------------|----------| +| TC-LOC-04-01 | ไม่พบ Mock Location (Normal GPS) | High | +| TC-LOC-04-02 | พบ Mock Location - Fake GPS App | High | +| TC-LOC-04-03 | พบ Mock Location - พิกัด (0,0) | High | +| TC-LOC-04-04 | พบ Mock Location - ข้อมูลเก่าเกินไป | High | +| TC-LOC-04-05 | พบ Mock Location - ความเร็วผิดปกติ | High | +| TC-LOC-04-06 | พบ Mock Location - หลาย indicators (Confidence High) | High | + +### 4.5 TC-LOC-05: POI Resolution + +| Test Case | Description | Priority | +|-----------|-------------|----------| +| TC-LOC-05-01 | แปลงพิกัดเป็นชื่อสถานที่สำเร็จ (Bangkok GIS) | High | +| TC-LOC-05-02 | แปลงพิกัดเป็นชื่อสถานที่สำเร็จ (ArcGIS Fallback) | Medium | +| TC-LOC-05-03 | แปลงพิกัดล้มเหลว (ทั้งสอง service down) | Low | + +### 4.6 TC-LOC-06: Check-in with Location + +| Test Case | Description | Priority | +|-----------|-------------|----------| +| TC-LOC-06-01 | ลงเวลาเข้าสำเร็จ - ณ สถานที่ตั้ง (In-place) | High | +| TC-LOC-06-02 | ลงเวลาเข้าสำเร็จ - นอกสถานที่ตั้ง (Off-site) | High | +| TC-LOC-06-03 | ลงเวลาเข้าล้มเหลว - Mock Location detected | High | +| TC-LOC-06-04 | ลงเวลาเข้าล้มเหลว - Location permission denied | High | + +### 4.7 TC-LOC-07: Check-out with Location + +| Test Case | Description | Priority | +|-----------|-------------|----------| +| TC-LOC-07-01 | ลงเวลาออกสำเร็จ | High | +| TC-LOC-07-02 | ลงเวลาออกล้มเหลว - Mock Location detected | High | + +### 4.8 TC-LOC-08: Special Time Entry + +| Test Case | Description | Priority | +|-----------|-------------|----------| +| TC-LOC-08-01 | บันทึกเวลาพิเศษพร้อมตำแหน่งสำเร็จ | Medium | +| TC-LOC-08-02 | บันทึกเวลาพิเศษล้มเหลว - ไม่ระบุตำแหน่ง | Medium | + +### 4.9 TC-LOC-09: Privacy Consent + +| Test Case | Description | Priority | +|-----------|-------------|----------| +| TC-LOC-09-01 | แสดง Privacy Modal ก่อนใช้ Location | High | +| TC-LOC-09-02 | ยอมรับ Privacy Policy | High | +| TC-LOC-09-03 | ปฏิเสธ Privacy Policy | High | + +--- + +## 5. Test Cases Details + +### Test Case Template + +``` +Test Case ID: TC-LOC-XX-XX +Test Case Name: [ชื่อ Test Case] +Description: [คำอธิบาย] +Priority: High/Medium/Low +Pre-conditions: [เงื่อนไขเบื้องต้น] +Test Data: [ข้อมูลทดสอบ] +Test Steps: [ขั้นตอนการทดสอบ] +Expected Result: [ผลลัพธ์ที่คาดหวัง] +Actual Result: [ผลลัพธ์จริง - ว่างไว้กรอก] +Status: [Pass/Fail/Not Run] +Tested By: [ผู้ทดสอบ] +Test Date: [วันที่ทดสอบ] +``` + +--- + +### TC-LOC-01: Location Permission + +#### TC-LOC-01-01: อนุญาตให้เข้าถึงตำแหน่ง + +| Field | Value | +|-------|-------| +| **Test Case ID** | TC-LOC-01-01 | +| **Test Case Name** | อนุญาตให้เข้าถึงตำแหน่ง | +| **Description** | ผู้ใช้อนุญาตให้แอปเข้าถึงตำแหน่ง GPS | +| **Priority** | High | +| **Pre-conditions** | 1. ยอมรับ Privacy Policy แล้ว
2. เปิดแอปครั้งแรก หรือยังไม่เคยอนุญาต Location Permission | +| **Test Data** | - | +| **Test Steps** | 1. เปิดแอป HRMS
2. กดปุ่มขอตำแหน่ง (ถ้าจำเป็น)
3. เลือก "Allow" เมื่อระบบขอ Location Permission | +| **Expected Result** | 1. แสดงแผนที่พร้อมตำแหน่งปัจจุบัน
2. แสดงชื่อสถานที่ใกล้เคียง
3. ปุ่มลงเวลาเข้า/ออกใช้งานได้ | +| **Actual Result** | | +| **Status** | Not Run | +| **Tested By** | | +| **Test Date** | | + +#### TC-LOC-01-02: ปฏิเสธการเข้าถึงตำแหน่ง + +| Field | Value | +|-------|-------| +| **Test Case ID** | TC-LOC-01-02 | +| **Test Case Name** | ปฏิเสธการเข้าถึงตำแหน่ง | +| **Description** | ผู้ใช้ปฏิเสธการเข้าถึงตำแหน่ง GPS | +| **Priority** | High | +| **Pre-conditions** | 1. ยอมรับ Privacy Policy แล้ว
2. เปิดแอปครั้งแรก หรือยังไม่เคยอนุญาต Location Permission | +| **Test Data** | - | +| **Test Steps** | 1. เปิดแอป HRMS
2. กดปุ่มขอตำแหน่ง (ถ้าจำเป็น)
3. เลือก "Deny" เมื่อระบบขอ Location Permission | +| **Expected Result** | 1. แสดงข้อความแจ้งเตือน: "ไม่สามารถระบุตำแหน่งปัจจุบันได้ เนื่องจากคุณปฏิเสธการเข้าถึงตำแหน่ง กรุณาเปิดการเข้าถึงตำแหน่ง"
2. แผนที่ไม่แสดง
3. ปุ่มลงเวลาเข้า/ออกใช้งานไม่ได้ | +| **Actual Result** | | +| **Status** | Not Run | +| **Tested By** | | +| **Test Date** | | + +--- + +### TC-LOC-02: Location Acquisition + +#### TC-LOC-02-01: รับพิกัด GPS สำเร็จ (Outdoor) + +| Field | Value | +|-------|-------| +| **Test Case ID** | TC-LOC-02-01 | +| **Test Case Name** | รับพิกัด GPS สำเร็จ (Outdoor) | +| **Description** | รับพิกัด GPS สำเร็จในพื้นที่เปิดกว้าง | +| **Priority** | High | +| **Pre-conditions** | 1. อนุญาต Location Permission แล้ว
2. ยอมรับ Privacy Policy แล้ว | +| **Test Data** | Location: อาคารรัฐสภา แขวง ถนนนครไชยศรี เขตดุสิต กรุงเทพมหานคร (13.7563, 100.5018) | +| **Test Steps** | 1. เปิดแอป HRMS
2. อยู่ในพื้นที่เปิดกว้าง (Outdoor)
3. รอรับพิกัด GPS | +| **Expected Result** | 1. รับพิกัด GPS สำเร็จ
2. แสดงแผนที่พร้อมตำแหน่ง
3. แสดงชื่อสถานที่ใกล้เคียง
4. locationGranted = true | +| **Actual Result** | | +| **Status** | Not Run | +| **Tested By** | | +| **Test Date** | | + +#### TC-LOC-02-02: รับพิกัด GPS สำเร็จ (Indoor) + +| Field | Value | +|-------|-------| +| **Test Case ID** | TC-LOC-02-02 | +| **Test Case Name** | รับพิกัด GPS สำเร็จ (Indoor) | +| **Description** | รับพิกัด GPS สำเร็จในพื้นที่ปิด | +| **Priority** | Medium | +| **Pre-conditions** | 1. อนุญาต Location Permission แล้ว
2. ยอมรับ Privacy Policy แล้ว | +| **Test Data** | Location: ภายในอาคารสำนักงาน | +| **Test Steps** | 1. เปิดแอป HRMS
2. อยู่ในพื้นที่ปิด (Indoor)
3. รอรับพิกัด GPS | +| **Expected Result** | 1. รับพิกัด GPS สำเร็จ
2. แสดงแผนที่พร้อมตำแหน่ง
3. แสดงชื่อสถานที่ใกล้เคียง
4. อาจมีความแม่นยำต่ำกว่า Outdoor | +| **Actual Result** | | +| **Status** | Not Run | +| **Tested By** | | +| **Test Date** | | + +#### TC-LOC-02-03: รับพิกัด GPS ล้มเหลว (GPS ไม่ทำงาน) + +| Field | Value | +|-------|-------| +| **Test Case ID** | TC-LOC-02-03 | +| **Test Case Name** | รับพิกัด GPS ล้มเหลว (GPS ไม่ทำงาน) | +| **Description** | GPS ไม่ทำงาน หรืออยู่ในพื้นที่ที่ไม่มีสัญญาณ GPS | +| **Priority** | High | +| **Pre-conditions** | 1. อนุญาต Location Permission แล้ว
2. ยอมรับ Privacy Policy แล้ว | +| **Test Data** | - | +| **Test Steps** | 1. เปิดแอป HRMS
2. ปิด GPS ในอุปกรณ์
3. พยายามขอรับพิกัด | +| **Expected Result** | 1. แสดงข้อความแจ้งเตือน: "ไม่สามารถระบุตำแหน่งปัจจุบันได้"
2. แผนที่ไม่แสดง | +| **Actual Result** | | +| **Status** | Not Run | +| **Tested By** | | +| **Test Date** | | + +#### TC-LOC-02-04: หมดเวลาขอรับพิกัด (Timeout) + +| Field | Value | +|-------|-------| +| **Test Case ID** | TC-LOC-02-04 | +| **Test Case Name** | หมดเวลาขอรับพิกัด (Timeout) | +| **Description** | การร้องขอตำแหน่งหมดเวลา | +| **Priority** | Medium | +| **Pre-conditions** | 1. อนุญาต Location Permission แล้ว
2. ยอมรับ Privacy Policy แล้ว | +| **Test Data** | - | +| **Test Steps** | 1. เปิดแอป HRMS
2. จำลองสภาวะที่ GPS ตอบสนองช้า (ใช้ Developer Tools)
3. รอจนหมดเวลา | +| **Expected Result** | 1. แสดงข้อความแจ้งเตือน: "การร้องขอตำแหน่งหมดเวลา กรุณาลองอีกครั้ง" | +| **Actual Result** | | +| **Status** | Not Run | +| **Tested By** | | +| **Test Date** | | + +--- + +### TC-LOC-03: Location Validation + +#### TC-LOC-03-01: พิกัดถูกต้อง (Valid coordinates) + +| Field | Value | +|-------|-------| +| **Test Case ID** | TC-LOC-03-01 | +| **Test Case Name** | พิกัดถูกต้อง (Valid coordinates) | +| **Description** | ตรวจสอบพิกัดที่ถูกต้อง | +| **Priority** | High | +| **Pre-conditions** | 1. อนุญาต Location Permission แล้ว
2. ยอมรับ Privacy Policy แล้ว | +| **Test Data** | Latitude: 13.7563, Longitude: 100.5018, Accuracy: 10m, Timestamp: current | +| **Test Steps** | 1. เปิดแอป HRMS
2. รับพิกัด GPS ที่ถูกต้อง | +| **Expected Result** | 1. validation = { isValid: true, isMockDetected: false }
2. locationGranted = true
3. ไม่มี error/warning | +| **Actual Result** | | +| **Status** | Not Run | +| **Tested By** | | +| **Test Date** | | + +#### TC-LOC-03-02: พิกัดไม่ถูกต้อง (Invalid coordinates - (0,0)) + +| Field | Value | +|-------|-------| +| **Test Case ID** | TC-LOC-03-02 | +| **Test Case Name** | พิกัดไม่ถูกต้อง (Invalid coordinates - (0,0)) | +| **Description** | ตรวจสอบพิกัด (0,0) ซึ่งเป็นค่า default ของ mock location | +| **Priority** | High | +| **Pre-conditions** | 1. อนุญาต Location Permission แล้ว
2. ยอมรับ Privacy Policy แล้ว | +| **Test Data** | Latitude: 0, Longitude: 0 | +| **Test Steps** | 1. เปิดแอป HRMS
2. จำลองพิกัด (0,0) ด้วย Mock Location App | +| **Expected Result** | 1. validation = { isValid: false, isMockDetected: true, confidence: 'high' }
2. แสดงข้อความ: "พิกัดตำแหน่งไม่ถูกต้อง กรุณาลองใหม่"
3. disabledBtn = true | +| **Actual Result** | | +| **Status** | Not Run | +| **Tested By** | | +| **Test Date** | | + +#### TC-LOC-03-03: พิกัดนอกช่วง (Out of range) + +| Field | Value | +|-------|-------| +| **Test Case ID** | TC-LOC-03-03 | +| **Test Case Name** | พิกัดนอกช่วง (Out of range) | +| **Description** | ตรวจสอบพิกัดที่อยู่นอกช่วงที่กำหนด | +| **Priority** | Medium | +| **Pre-conditions** | 1. อนุญาต Location Permission แล้ว
2. ยอมรับ Privacy Policy แล้ว | +| **Test Data** | Latitude: 91, Longitude: 181 (out of range) | +| **Test Steps** | 1. เปิดแอป HRMS
2. จำลองพิกัดนอกช่วงด้วย Developer Tools | +| **Expected Result** | 1. validation = { isValid: false }
2. แสดงข้อความ: "พิกัดตำแหน่งไม่ถูกต้อง กรุณาลองใหม่" | +| **Actual Result** | | +| **Status** | Not Run | +| **Tested By** | | +| **Test Date** | | + +#### TC-LOC-03-04: ข้อมูลตำแหน่งเก่าเกินไป (Stale timestamp) + +| Field | Value | +|-------|-------| +| **Test Case ID** | TC-LOC-03-04 | +| **Test Case Name** | ข้อมูลตำแหน่งเก่าเกินไป (Stale timestamp) | +| **Description** | ตรวจสอบว่าข้อมูลตำแหน่งเก่าเกิน 60 วินาที | +| **Priority** | High | +| **Pre-conditions** | 1. อนุญาต Location Permission แล้ว
2. ยอมรับ Privacy Policy แล้ว | +| **Test Data** | Timestamp: Date.now() - 70,000 ms (70 seconds old) | +| **Test Steps** | 1. เปิดแอป HRMS
2. จำลอง timestamp เก่าเกิน 60 วินาที | +| **Expected Result** | 1. validation.errors = ["ข้อมูลตำแหน่งเก่าเกินไป กรุณารับสัญญาณ GPS ใหม่"]
2. mockIndicators += 2 | +| **Actual Result** | | +| **Status** | Not Run | +| **Tested By** | | +| **Test Date** | | + +#### TC-LOC-03-05: ความแม่นยำต่ำ (Poor accuracy) + +| Field | Value | +|-------|-------| +| **Test Case ID** | TC-LOC-03-05 | +| **Test Case Name** | ความแม่นยำต่ำ (Poor accuracy) | +| **Description** | ตรวจสอบความแม่นยำของ GPS ต่ำกว่า 100 เมตร | +| **Priority** | Medium | +| **Pre-conditions** | 1. อนุญาต Location Permission แล้ว
2. ยอมรับ Privacy Policy แล้ว | +| **Test Data** | Accuracy: 150 meters | +| **Test Steps** | 1. เปิดแอป HRMS
2. จำลองความแม่นยำต่ำด้วย Developer Tools | +| **Expected Result** | 1. validation.warnings = ["ความแม่นยำตำแหน่งต่ำเกินไป กรุณาตรวจสอบการรับสัญญาณ GPS"]
2. mockIndicators += 1 | +| **Actual Result** | | +| **Status** | Not Run | +| **Tested By** | | +| **Test Date** | | + +#### TC-LOC-03-06: ความเร็วเคลื่อนที่ผิดปกติ (Impossible speed) + +| Field | Value | +|-------|-------| +| **Test Case ID** | TC-LOC-03-06 | +| **Test Case Name** | ความเร็วเคลื่อนที่ผิดปกติ (Impossible speed) | +| **Description** | ตรวจสอบความเร็วเคลื่อนที่เกิน 100 m/s (360 km/h) | +| **Priority** | High | +| **Pre-conditions** | 1. อนุญาต Location Permission แล้ว
2. ยอมรับ Privacy Policy แล้ว
3. มีตำแหน่งเดิมใน history | +| **Test Data** | Position 1: (13.7563, 100.5018) at t=0
Position 2: (15.8700, 100.9925) at t=60 (~180 km in 60s = 3000 km/h) | +| **Test Steps** | 1. เปิดแอป HRMS
2. จำลองการเคลื่อนที่ด้วยความเร็วผิดปกติ | +| **Expected Result** | 1. validation.errors = ["ตรวจพบการเคลื่อนที่ด้วยความเร็วผิดปกติ อาจเป็นการจำลองตำแหน่ง"]
2. mockIndicators += 3 | +| **Actual Result** | | +| **Status** | Not Run | +| **Tested By** | | +| **Test Date** | | + +--- + +### TC-LOC-04: Mock Location Detection + +#### TC-LOC-04-01: ไม่พบ Mock Location (Normal GPS) + +| Field | Value | +|-------|-------| +| **Test Case ID** | TC-LOC-04-01 | +| **Test Case Name** | ไม่พบ Mock Location (Normal GPS) | +| **Description** | การใช้งาน GPS ปกติ ไม่พบ mock location | +| **Priority** | High | +| **Pre-conditions** | 1. อนุญาต Location Permission แล้ว
2. ยอมรับ Privacy Policy แล้ว
3. ไม่ได้เปิด Mock Location App | +| **Test Data** | Normal GPS data | +| **Test Steps** | 1. เปิดแอป HRMS
2. ใช้งาน GPS ปกติ | +| **Expected Result** | 1. validation = { isValid: true, isMockDetected: false }
2. locationGranted = true
3. isMockLocationDetected = false
4. ปุ่มลงเวลาเข้า/ออกใช้งานได้ | +| **Actual Result** | | +| **Status** | Not Run | +| **Tested By** | | +| **Test Date** | | + +#### TC-LOC-04-02: พบ Mock Location - Fake GPS App + +| Field | Value | +|-------|-------| +| **Test Case ID** | TC-LOC-04-02 | +| **Test Case Name** | พบ Mock Location - Fake GPS App | +| **Description** | ตรวจพบ mock location จาก Fake GPS App | +| **Priority** | High | +| **Pre-conditions** | 1. อนุญาต Location Permission แล้ว
2. ยอมรับ Privacy Policy แล้ว | +| **Test Data** | Mock location from Fake GPS App | +| **Test Steps** | 1. เปิด Fake GPS Location App
2. ตั้งค่าตำแหน่งปลอม
3. เปิดแอป HRMS
4. ขอรับพิกัด | +| **Expected Result** | 1. ตรวจพบ mock location (indicators >= 3)
2. แสดงข้อความ: "ตรวจพบว่าตำแหน่ง GPS อาจไม่ถูกต้อง กรุณาปิดแอปจำลองตำแหน่งและลองใหม่"
3. isMockLocationDetected = true
4. disabledBtn = true | +| **Actual Result** | | +| **Status** | Not Run | +| **Tested By** | | +| **Test Date** | | + +#### TC-LOC-04-03: พบ Mock Location - พิกัด (0,0) + +| Field | Value | +|-------|-------| +| **Test Case ID** | TC-LOC-04-03 | +| **Test Case Name** | พบ Mock Location - พิกัด (0,0) | +| **Description** | ตรวจพบพิกัด (0,0) ซึ่งเป็นค่า default ของ mock location | +| **Priority** | High | +| **Pre-conditions** | 1. อนุญาต Location Permission แล้ว
2. ยอมรับ Privacy Policy แล้ว | +| **Test Data** | Latitude: 0, Longitude: 0 | +| **Test Steps** | 1. จำลองพิกัด (0,0) ด้วย Mock Location App
2. เปิดแอป HRMS
3. ขอรับพิกัด | +| **Expected Result** | 1. mockIndicators = 3 (จาก invalid coordinates)
2. isMockDetected = true
3. confidence = 'medium'
4. แสดงข้อความแจ้งเตือน | +| **Actual Result** | | +| **Status** | Not Run | +| **Tested By** | | +| **Test Date** | | + +#### TC-LOC-04-04: พบ Mock Location - ข้อมูลเก่าเกินไป + +| Field | Value | +|-------|-------| +| **Test Case ID** | TC-LOC-04-04 | +| **Test Case Name** | พบ Mock Location - ข้อมูลเก่าเกินไป | +| **Description** | ตรวจพบข้อมูลตำแหน่งเก่าเกิน 60 วินาที | +| **Priority** | High | +| **Pre-conditions** | 1. อนุญาต Location Permission แล้ว
2. ยอมรับ Privacy Policy แล้ว | +| **Test Data** | Timestamp: Date.now() - 70,000 ms | +| **Test Steps** | 1. จำลอง timestamp เก่าเกิน 60 วินาที
2. เปิดแอป HRMS
3. ขอรับพิกัด | +| **Expected Result** | 1. mockIndicators = 2 (จาก stale timestamp)
2. แสดง warning: "ข้อมูลตำแหน่งเก่าเกินไป กรุณารับสัญญาณ GPS ใหม่" | +| **Actual Result** | | +| **Status** | Not Run | +| **Tested By** | | +| **Test Date** | | + +#### TC-LOC-04-05: พบ Mock Location - ความเร็วผิดปกติ + +| Field | Value | +|-------|-------| +| **Test Case ID** | TC-LOC-04-05 | +| **Test Case Name** | พบ Mock Location - ความเร็วผิดปกติ | +| **Description** | ตรวจพบความเร็วเคลื่อนที่ผิดปกติ | +| **Priority** | High | +| **Pre-conditions** | 1. อนุญาต Location Permission แล้ว
2. ยอมรับ Privacy Policy แล้ว
3. มีตำแหน่งเดิมใน history | +| **Test Data** | Speed > 100 m/s | +| **Test Steps** | 1. จำลองการเคลื่อนที่ด้วยความเร็ว > 100 m/s
2. เปิดแอป HRMS | +| **Expected Result** | 1. mockIndicators = 3 (จาก impossible speed)
2. isMockDetected = true
3. confidence = 'medium' | +| **Actual Result** | | +| **Status** | Not Run | +| **Tested By** | | +| **Test Date** | | + +#### TC-LOC-04-06: พบ Mock Location - หลาย indicators (Confidence High) + +| Field | Value | +|-------|-------| +| **Test Case ID** | TC-LOC-04-06 | +| **Test Case Name** | พบ Mock Location - หลาย indicators (Confidence High) | +| **Description** | ตรวจพบหลาย mock indicators พร้อมกัน | +| **Priority** | High | +| **Pre-conditions** | 1. อนุญาต Location Permission แล้ว
2. ยอมรับ Privacy Policy แล้ว | +| **Test Data** | Combined: invalid coordinates (0,0) + stale timestamp + impossible speed | +| **Test Steps** | 1. จำลอง multiple mock indicators
2. เปิดแอป HRMS | +| **Expected Result** | 1. mockIndicators >= 5
2. isMockDetected = true
3. confidence = 'high'
4. แสดงข้อความแจ้งเตือนชัดเจน | +| **Actual Result** | | +| **Status** | Not Run | +| **Tested By** | | +| **Test Date** | | + +--- + +### TC-LOC-05: POI Resolution + +#### TC-LOC-05-01: แปลงพิกัดเป็นชื่อสถานที่สำเร็จ (Bangkok GIS) + +| Field | Value | +|-------|-------| +| **Test Case ID** | TC-LOC-05-01 | +| **Test Case Name** | แปลงพิกัดเป็นชื่อสถานที่สำเร็จ (Bangkok GIS) | +| **Description** | แปลงพิกัดเป็นชื่อสถานที่สำเร็จผ่าน Bangkok GIS API | +| **Priority** | High | +| **Pre-conditions** | 1. อนุญาต Location Permission แล้ว
2. ยอมรับ Privacy Policy แล้ว
3. รับพิกัดสำเร็จแล้ว | +| **Test Data** | Latitude: 13.7563, Longitude: 100.5018 (Sanam Suea Pa, Bangkok) | +| **Test Steps** | 1. เปิดแอป HRMS
2. รับพิกัด GPS
3. รอให้ระบบแปลงพิกัดเป็นชื่อสถานที่ | +| **Expected Result** | 1. เรียก Bangkok GIS API: `https://bmagis.bangkok.go.th/...`
2. แสดงชื่อสถานที่ (POI name)
3. poiPlaceName มีค่า | +| **Actual Result** | | +| **Status** | Not Run | +| **Tested By** | | +| **Test Date** | | + +#### TC-LOC-05-02: แปลงพิกัดเป็นชื่อสถานที่สำเร็จ (ArcGIS Fallback) + +| Field | Value | +|-------|-------| +| **Test Case ID** | TC-LOC-05-02 | +| **Test Case Name** | แปลงพิกัดเป็นชื่อสถานที่สำเร็จ (ArcGIS Fallback) | +| **Description** | แปลงพิกัดเป็นชื่อสถานที่สำเร็จผ่าน ArcGIS API (เมื่อ Bangkok GIS fail) | +| **Priority** | Medium | +| **Pre-conditions** | 1. อนุญาต Location Permission แล้ว
2. ยอมรับ Privacy Policy แล้ว
3. Bangkok GIS API ล้มเหลว | +| **Test Data** | Latitude: 13.7563, Longitude: 100.5018 | +| **Test Steps** | 1. เปิดแอป HRMS
2. รับพิกัด GPS
3. จำลอง Bangkok GIS API fail
4. รอ fallback ไป ArcGIS | +| **Expected Result** | 1. เรียก ArcGIS API: `https://geocode.arcgis.com/...`
2. แสดงชื่อสถานที่ (POI name)
3. poiPlaceName มีค่า | +| **Actual Result** | | +| **Status** | Not Run | +| **Tested By** | | +| **Test Date** | | + +#### TC-LOC-05-03: แปลงพิกัดล้มเหลว (ทั้งสอง service down) + +| Field | Value | +|-------|-------| +| **Test Case ID** | TC-LOC-05-03 | +| **Test Case Name** | แปลงพิกัดล้มเหลว (ทั้งสอง service down) | +| **Description** | แปลงพิกัดล้มเหลวเมื่อทั้ง Bangkok GIS และ ArcGIS down | +| **Priority** | Low | +| **Pre-conditions** | 1. อนุญาต Location Permission แล้ว
2. ยอมรับ Privacy Policy แล้ว | +| **Test Data** | - | +| **Test Steps** | 1. เปิดแอป HRMS
2. จำลองทั้งสอง API fail | +| **Expected Result** | 1. แอปยังทำงานต่อไปได้
2. แผนที่แสดงตำแหน่งแต่ไม่มีชื่อสถานที่
3. formLocation.POI = '' | +| **Actual Result** | | +| **Status** | Not Run | +| **Tested By** | | +| **Test Date** | | + +--- + +### TC-LOC-06: Check-in with Location + +#### TC-LOC-06-01: ลงเวลาเข้าสำเร็จ - ณ สถานที่ตั้ง (In-place) + +| Field | Value | +|-------|-------| +| **Test Case ID** | TC-LOC-06-01 | +| **Test Case Name** | ลงเวลาเข้าสำเร็จ - ณ สถานที่ตั้ง (In-place) | +| **Description** | ลงเวลาเข้าสำเร็จเมื่ออยู่ ณ สถานที่ตั้ง | +| **Priority** | High | +| **Pre-conditions** | 1. อนุญาต Location Permission แล้ว
2. ยอมรับ Privacy Policy แล้ว
3. รับพิกัดและชื่อสถานที่สำเร็จ
4. ถ่ายรูปภาพแล้ว
5. statusCheckin = true (เข้างาน) | +| **Test Data** | workplace: 'in-place', locationName: '', POI: 'สนามเสือป่า', img: (รูปถ่าย) | +| **Test Steps** | 1. เลือก "ในสถานที่"
2. กด "ลงเวลาเข้างาน"
3. ยืนยันการลงเวลา | +| **Expected Result** | 1. API call: POST `/leave/check-in`
2. formdata: { lat, lon, POI, isLocation: true, locationName: '', img, remark, checkInId }
3. แสดง modal ลงเวลาเข้างานสำเร็จ
4. statusCheckin = false | +| **Actual Result** | | +| **Status** | Not Run | +| **Tested By** | | +| **Test Date** | | + +#### TC-LOC-06-02: ลงเวลาเข้าสำเร็จ - นอกสถานที่ตั้ง (Off-site) + +| Field | Value | +|-------|-------| +| **Test Case ID** | TC-LOC-06-02 | +| **Test Case Name** | ลงเวลาเข้าสำเร็จ - นอกสถานที่ตั้ง (Off-site) | +| **Description** | ลงเวลาเข้าสำเร็จเมื่ออยู่นอกสถานที่ตั้ง | +| **Priority** | High | +| **Pre-conditions** | 1. อนุญาต Location Permission แล้ว
2. ยอมรับ Privacy Policy แล้ว
3. รับพิกัดและชื่อสถานที่สำเร็จ
4. ถ่ายรูปภาพแล้ว
5. statusCheckin = true (เข้างาน) | +| **Test Data** | workplace: 'off-site', locationName: 'ปฏิบัติงานที่บ้าน (WFH)', POI: 'บ้าน', img: (รูปถ่าย) | +| **Test Steps** | 1. เลือก "นอกสถานที่"
2. เลือก "ปฏิบัติงานที่บ้าน (WFH)"
3. กด "ลงเวลาเข้างาน"
4. ยืนยันการลงเวลา | +| **Expected Result** | 1. API call: POST `/leave/check-in`
2. formdata: { lat, lon, POI, isLocation: false, locationName: 'ปฏิบัติงานที่บ้าน (WFH)', img, remark, checkInId }
3. แสดง modal ลงเวลาเข้างานสำเร็จ | +| **Actual Result** | | +| **Status** | Not Run | +| **Tested By** | | +| **Test Date** | | + +#### TC-LOC-06-03: ลงเวลาเข้าล้มเหลว - Mock Location detected + +| Field | Value | +|-------|-------| +| **Test Case ID** | TC-LOC-06-03 | +| **Test Case Name** | ลงเวลาเข้าล้มเหลว - Mock Location detected | +| **Description** | ลงเวลาเข้าล้มเหลวเมื่อตรวจพบ mock location | +| **Priority** | High | +| **Pre-conditions** | 1. อนุญาต Location Permission แล้ว
2. ยอมรับ Privacy Policy แล้ว
3. เปิด Mock Location App | +| **Test Data** | Mock location enabled | +| **Test Steps** | 1. เปิด Mock Location App
2. ตั้งค่าตำแหน่งปลอง
3. เปิดแอป HRMS
4. พยายามลงเวลาเข้างาน | +| **Expected Result** | 1. แสดงข้อความ: "ตรวจพบว่าตำแหน่ง GPS อาจไม่ถูกต้อง..."
2. isMockLocationDetected = true
3. disabledBtn = true
4. ไม่สามารถลงเวลาเข้างานได้ | +| **Actual Result** | | +| **Status** | Not Run | +| **Tested By** | | +| **Test Date** | | + +#### TC-LOC-06-04: ลงเวลาเข้าล้มเหลว - Location permission denied + +| Field | Value | +|-------|-------| +| **Test Case ID** | TC-LOC-06-04 | +| **Test Case Name** | ลงเวลาเข้าล้มเหลว - Location permission denied | +| **Description** | ลงเวลาเข้าล้มเหลวเมื่อปฏิเสธ Location Permission | +| **Priority** | High | +| **Pre-conditions** | 1. ยอมรับ Privacy Policy แล้ว
2. ปฏิเสธ Location Permission | +| **Test Data** | - | +| **Test Steps** | 1. เปิดแอป HRMS
2. ปฏิเสธ Location Permission
3. พยายามลงเวลาเข้างาน | +| **Expected Result** | 1. locationGranted = false
2. ปุ่มลงเวลาเข้า/ออก disabled
3. ไม่สามารถลงเวลาเข้างานได้ | +| **Actual Result** | | +| **Status** | Not Run | +| **Tested By** | | +| **Test Date** | | + +--- + +### TC-LOC-07: Check-out with Location + +#### TC-LOC-07-01: ลงเวลาออกสำเร็จ + +| Field | Value | +|-------|-------| +| **Test Case ID** | TC-LOC-07-01 | +| **Test Case Name** | ลงเวลาออกสำเร็จ | +| **Description** | ลงเวลาออกสำเร็จพร้อมตำแหน่ง | +| **Priority** | High | +| **Pre-conditions** | 1. อนุญาต Location Permission แล้ว
2. ยอมรับ Privacy Policy แล้ว
3. เคยลงเวลาเข้างานแล้ว
4. statusCheckin = false (ออกงาน) | +| **Test Data** | POI: 'Office', img: (รูปถ่าย) | +| **Test Steps** | 1. เปิดแอป HRMS
2. ถ่ายรูปภาพ
3. กด "ลงเวลาออกงาน" | +| **Expected Result** | 1. API call: POST `/leave/check-in` (with checkInId)
2. แสดง modal ลงเวลาออกงานสำเร็จ
3. statusCheckin = true | +| **Actual Result** | | +| **Status** | Not Run | +| **Tested By** | | +| **Test Date** | | + +#### TC-LOC-07-02: ลงเวลาออกล้มเหลว - Mock Location detected + +| Field | Value | +|-------|-------| +| **Test Case ID** | TC-LOC-07-02 | +| **Test Case Name** | ลงเวลาออกล้มเหลว - Mock Location detected | +| **Description** | ลงเวลาออกล้มเหลวเมื่อตรวจพบ mock location | +| **Priority** | High | +| **Pre-conditions** | 1. อนุญาต Location Permission แล้ว
2. ยอมรับ Privacy Policy แล้ว
3. เคยลงเวลาเข้างานแล้ว
4. เปิด Mock Location App | +| **Test Data** | Mock location enabled | +| **Test Steps** | 1. เปิด Mock Location App
2. พยายามลงเวลาออกงาน | +| **Expected Result** | 1. แสดงข้อความ: "ตรวจพบว่าตำแหน่ง GPS อาจไม่ถูกต้อง..."
2. disabledBtn = true
3. ไม่สามารถลงเวลาออกงานได้ | +| **Actual Result** | | +| **Status** | Not Run | +| **Tested By** | | +| **Test Date** | | + +--- + +### TC-LOC-08: Special Time Entry + +#### TC-LOC-08-01: บันทึกเวลาพิเศษพร้อมตำแหน่งสำเร็จ + +| Field | Value | +|-------|-------| +| **Test Case ID** | TC-LOC-08-01 | +| **Test Case Name** | บันทึกเวลาพิเศษพร้อมตำแหน่งสำเร็จ | +| **Description** | บันทึกเวลาพิเศษพร้อมตำแหน่งสำเร็จ | +| **Priority** | Medium | +| **Pre-conditions** | 1. อนุญาต Location Permission แล้ว
2. ยอมรับ Privacy Policy แล้ว
3. รับพิกัดสำเร็จ | +| **Test Data** | POI: 'Meeting Room', img: (รูปถ่าย) | +| **Test Steps** | 1. เปิดแอป HRMS
2. ไปที่หน้าบันทึกเวลาพิเศษ
3. กรอกข้อมูล
4. บันทึก | +| **Expected Result** | 1. บันทึกเวลาพิเศษสำเร็จ
2. มีข้อมูลตำแหน่ง | +| **Actual Result** | | +| **Status** | Not Run | +| **Tested By** | | +| **Test Date** | | + +#### TC-LOC-08-02: บันทึกเวลาพิเศษล้มเหลว - ไม่ระบุตำแหน่ง + +| Field | Value | +|-------|-------| +| **Test Case ID** | TC-LOC-08-02 | +| **Test Case Name** | บันทึกเวลาพิเศษล้มเหลว - ไม่ระบุตำแหน่ง | +| **Description** | บันทึกเวลาพิเศษล้มเหลวเมื่อไม่ระบุตำแหน่ง | +| **Priority** | Medium | +| **Pre-conditions** | 1. ยอมรับ Privacy Policy แล้ว
2. ปฏิเสธ Location Permission | +| **Test Data** | - | +| **Test Steps** | 1. เปิดแอป HRMS
2. ปฏิเสธ Location Permission
3. พยายามบันทึกเวลาพิเศษ | +| **Expected Result** | 1. แจ้งเตือนให้ระบุตำแหน่ง | +| **Actual Result** | | +| **Status** | Not Run | +| **Tested By** | | +| **Test Date** | | + +--- + +### TC-LOC-09: Privacy Consent + +#### TC-LOC-09-01: แสดง Privacy Modal ก่อนใช้ Location + +| Field | Value | +|-------|-------| +| **Test Case ID** | TC-LOC-09-01 | +| **Test Case Name** | แสดง Privacy Modal ก่อนใช้ Location | +| **Description** | แสดง Privacy Modal ก่อนใช้ Location | +| **Priority** | High | +| **Pre-conditions** | 1. เปิดแอปครั้งแรก
2. ยังไม่ยอมรับ Privacy Policy | +| **Test Data** | - | +| **Test Steps** | 1. เปิดแอป HRMS
2. กดปุ่มที่ต้องการ Location (แผนที่/กล้อง) | +| **Expected Result** | 1. privacyStore.modalPrivacy = true
2. แสดง Privacy Modal
3. ไม่สามารถใช้งาน Location ได้จนกว่าจะยอมรับ | +| **Actual Result** | | +| **Status** | Not Run | +| **Tested By** | | +| **Test Date** | | + +#### TC-LOC-09-02: ยอมรับ Privacy Policy + +| Field | Value | +|-------|-------| +| **Test Case ID** | TC-LOC-09-02 | +| **Test Case Name** | ยอมรับ Privacy Policy | +| **Description** | ยอมรับ Privacy Policy และใช้งาน Location ได้ | +| **Priority** | High | +| **Pre-conditions** | 1. เปิดแอปครั้งแรก
2. Privacy Modal แสดงขึ้นมา | +| **Test Data** | - | +| **Test Steps** | 1. เปิดแอป HRMS
2. แสดง Privacy Modal
3. กด "ยอมรับ" | +| **Expected Result** | 1. privacyStore.isAccepted = true
2. privacyStore.modalPrivacy = false
3. สามารถใช้งาน Location ได้
4. เรียก mapRef.value?.requestLocationPermission() | +| **Actual Result** | | +| **Status** | Not Run | +| **Tested By** | | +| **Test Date** | | + +#### TC-LOC-09-03: ปฏิเสธ Privacy Policy + +| Field | Value | +|-------|-------| +| **Test Case ID** | TC-LOC-09-03 | +| **Test Case Name** | ปฏิเสธ Privacy Policy | +| **Description** | ปฏิเสธ Privacy Policy และไม่สามารถใช้งาน Location | +| **Priority** | High | +| **Pre-conditions** | 1. เปิดแอปครั้งแรก
2. Privacy Modal แสดงขึ้นมา | +| **Test Data** | - | +| **Test Steps** | 1. เปิดแอป HRMS
2. แสดง Privacy Modal
3. กด "ปฏิเสธ" หรือปิด Modal | +| **Expected Result** | 1. privacyStore.isAccepted = false
2. privacyStore.modalPrivacy = false
3. ไม่สามารถใช้งาน Location ได้
4. แจ้งเตือนเมื่อพยายามใช้งาน Location | +| **Actual Result** | | +| **Status** | Not Run | +| **Tested By** | | +| **Test Date** | | + +--- + +## 6. Test Summary + +### 6.1 Test Case Statistics + +| Category | Total | Critical | High | Medium | Low | +|----------|-------|----------|------|--------|-----| +| Location Permission | 2 | - | 2 | - | - | +| Location Acquisition | 4 | - | 2 | 2 | - | +| Location Validation | 6 | - | 4 | 2 | - | +| Mock Location Detection | 6 | - | 6 | - | - | +| POI Resolution | 3 | - | 1 | 1 | 1 | +| Check-in with Location | 4 | - | 4 | - | - | +| Check-out with Location | 2 | - | 2 | - | - | +| Special Time Entry | 2 | - | - | 2 | - | +| Privacy Consent | 3 | - | 3 | - | - | +| **Total** | **32** | - | **24** | **7** | **1** | + +### 6.2 Execution Status + +| Status | Count | Percentage | +|--------|-------|------------| +| Not Run | 32 | 100% | +| Pass | 0 | 0% | +| Fail | 0 | 0% | +| Blocked | 0 | 0% | + +--- + +## 7. References + +### 7.1 API Endpoints + +| Endpoint | Method | Description | +|----------|--------|-------------| +| `/leave/check-in` | POST | Check-in/Check-out with location data | +| `/leave/check-time` | GET | Get check-in/check-out status | +| `/leave/check-status` | GET | Get queue status | +| `/leave/user/checkout-check/{isSeminar}` | GET | Check before check-out | + +### 7.2 Key Functions + +| Function | Location | Description | +|----------|----------|-------------| +| `validateLocation()` | `useLocationValidation.ts` | Main validation function | +| `validateCoordinates()` | `useLocationValidation.ts` | Coordinate validation | +| `validateTimestamp()` | `useLocationValidation.ts` | Timestamp validation | +| `validateAccuracy()` | `useLocationValidation.ts` | Accuracy validation | +| `validateSpeed()` | `useLocationValidation.ts` | Speed validation | +| `haversineDistance()` | `useLocationValidation.ts` | Distance calculation | +| `checkPrivacyAccepted()` | `usePermissions.ts` | Check privacy consent | +| `requestLocationPermission()` | `AscGISMap.vue` | Request location permission | + +### 7.3 Related Files + +- `/src/composables/useLocationValidation.ts` - Location validation logic +- `/src/views/HomeView.vue` - Check-in/Check-out page +- `/src/components/AscGISMap.vue` - Map component with location validation +- `/src/api/api.checkin.ts` - Check-in API endpoints +- `/src/stores/privacy.ts` - Privacy store for consent management +- `/src/composables/usePermissions.ts` - Permission checking utilities + +--- + +## 8. Revision History + +| Version | Date | Author | Changes | +|---------|------|--------|---------| +| 1.0.0 | 2025-03-09 | QA Team | Initial version - 32 test cases for Location features | + +--- + +## 9. Approval + +| Role | Name | Signature | Date | +|------|------|-----------|------| +| QA Lead | | | | +| Developer | | | | +| Product Owner | | | | diff --git a/docs/test-steps-location.md b/docs/test-steps-location.md new file mode 100644 index 0000000..f62a2fa --- /dev/null +++ b/docs/test-steps-location.md @@ -0,0 +1,1026 @@ +# Test Steps: Location Features +# HRMS Check-in/Check-out System + +## Document Information + +| Field | Value | +|-------|-------| +| **Document Version** | 1.0.0 | +| **Last Updated** | 2025-03-09 | +| **Project** | HRMS Check-in/Check-out | +| **Module** | Location Features | +| **Author** | QA Team | + +--- + +## Table of Contents + +1. [Overview](#1-overview) +2. [Test Environment Setup](#2-test-environment-setup) +3. [Manual Testing Procedures](#3-manual-testing-procedures) +4. [Mock Location Testing](#4-mock-location-testing) +5. [Developer Tools Testing](#5-developer-tools-testing) +6. [Device-Specific Testing](#6-device-specific-testing) +7. [Test Data & Scenarios](#7-test-data--scenarios) +8. [Troubleshooting](#8-troubleshooting) + +--- + +## 1. Overview + +เอกสารนี้ประกอบด้วยขั้นตอนการทดสอบ (Test Steps) แบบละเอียดสำหรับการทดสอบฟีเจอร์ Location ของระบบ HRMS Check-in/Check-out โดยเน้นการทดสอบแบบ Manual Testing และการจำลองสถานการณ์ต่าง ๆ + +### 1.1 Testing Scope + +| Area | Description | +|------|-------------| +| **Location Permission** | การขอและการจัดการสิทธิ์การเข้าถึงตำแหน่ง | +| **Location Acquisition** | การรับพิกัด GPS จากอุปกรณ์ | +| **Location Validation** | การตรวจสอบความถูกต้องของตำแหน่ง | +| **Mock Detection** | การตรวจจับการจำลองตำแหน่ง | +| **POI Resolution** | การแปลงพิกัดเป็นชื่อสถานที่ | +| **Check-in/Check-out** | การลงเวลาเข้า-ออกงานพร้อมตำแหน่ง | +| **Privacy Consent** | การขอความยินยอมการใช้ข้อมูล | + +--- + +## 2. Test Environment Setup + +### 2.1 Device Preparation + +#### 2.1.1 Android Device Setup + +1. **Enable Developer Options** + - เปิด Settings > About Phone + - แตะที่ Build Number 7 ครั้ง + - กลับมาที่ Settings > Developer Options + +2. **Enable Mock Location (สำหรับการทดสอบ)** + - เปิด Settings > Developer Options + - เลือก "Select mock location app" + - เลือก Fake GPS Location App ที่ติดตั้ง + +3. **Install Fake GPS Apps** + - Fake GPS Location (by Lexa) - [Google Play](https://play.google.com/store/apps/details?id=com.lexa.fakegps) + - GPS Joystick - [Google Play](https://play.google.com/store/apps/details?id=com.theappninjas.android.gpsjoke) + +#### 2.1.2 iOS Device Setup + +1. **Xcode Simulation (ต้องใช้ Mac)** + - เปิด Xcode + - เลือก Device > Debug Location > Custom Location... + - ป้อน Latitude และ Longitude + +2. **Location Changer Apps** + - Location Changer - [App Store](https://apps.apple.com/app/location-changer/id1383869695) + +#### 2.1.3 Desktop Browser Setup + +1. **Chrome DevTools** + - กด F12 หรือ Cmd+Option+I (Mac) / Ctrl+Shift+I (Windows) + - เลือก More tools > Sensors + - ตั้งค่า Location ใน Sensors tab + +2. **Edge DevTools** + - กด F12 + - เลือก More tools > Sensors + - ตั้งค่า Location ใน Sensors tab + +### 2.2 Network Setup + +| Scenario | Setup | +|----------|-------| +| **Normal Network** | WiFi/4G/5G เชื่อมต่อปกติ | +| **Slow Network** | Chrome DevTools > Network > Throttling > Slow 3G | +| **Offline** | Chrome DevTools > Network > Offline | +| **GPS Blocking** | Disable Location Service ในระบบ | + +### 2.3 Test Location Data + +| Location Name | Latitude | Longitude | Notes | +|---------------|----------|-----------|-------| +| Sanam Suea Pa (สนามเสือป่า) | 13.7563 | 100.5018 | Bangkok Government Office | +| Suvarnabhumi Airport | 13.6900 | 100.7501 | Outdoor, high GPS accuracy | +| Central World | 13.7944 | 100.5439 | Indoor shopping mall | +| Null Island | 0 | 0 | Default mock location (invalid) | +| Out of Range | 91 | 181 | Invalid coordinates | +| Chiang Mai | 18.7883 | 98.9853 | Northern Thailand | + +--- + +## 3. Manual Testing Procedures + +### 3.1 TC-LOC-01: Location Permission Testing + +#### Test Case: TC-LOC-01-01 - อนุญาตให้เข้าถึงตำแหน่ง + +**Objective**: ทดสอบการอนุญาตให้เข้าถึงตำแหน่ง + +| Step | Action | Expected Result | Screenshot | +|------|--------|-----------------|------------| +| 1 | เปิดแอป HRMS ครั้งแรก | แสดงหน้าแรกของแอป | [ ] | +| 2 | แสดง Privacy Modal (ถ้ายังไม่ยอมรับ) | แสดง Privacy Policy Modal | [ ] | +| 3 | กด "ยอมรับ" เพื่อยอมรับ Privacy Policy | Modal ปิด, `isAccepted = true` | [ ] | +| 4 | กดปุ่มขอตำแหน่ง (mapRef.requestLocationPermission()) | ระบบขอ Location Permission | [ ] | +| 5 | เลือก "Allow" เมื่อระบบขอ Location Permission | รับสิทธิ์สำเร็จ | [ ] | +| 6 | รอรับพิกัด GPS | แสดง Skeleton loading | [ ] | +| 7 | รับพิกัดสำเร็จ | แสดงแผนที่พร้อมตำแหน่งปัจจุบัน | [ ] | +| 8 | ตรวจสอบชื่อสถานที่ใกล้เคียง | แสดงชื่อสถานที่ (POI) | [ ] | +| 9 | ตรวจสอบสถานะปุ่มลงเวลา | ปุ่มใช้งานได้ (disabled = false) | [ ] | + +**Verification Checklist:** + +- [ ] แผนที่แสดงตำแหน่งปัจจุบันถูกต้อง +- [ ] ชื่อสถานที่ใกล้เคียงแสดงถูกต้อง +- [ ] `locationGranted = true` +- [ ] ปุ่มลงเวลาเข้า/ออกใช้งานได้ +- [ ] ไม่มีข้อความ error แสดงขึ้น + +--- + +#### Test Case: TC-LOC-01-02 - ปฏิเสธการเข้าถึงตำแหน่ง + +**Objective**: ทดสอบการปฏิเสธการเข้าถึงตำแหน่ง + +| Step | Action | Expected Result | Screenshot | +|------|--------|-----------------|------------| +| 1 | เปิดแอป HRMS ครั้งแรก | แสดงหน้าแรกของแอป | [ ] | +| 2 | ยอมรับ Privacy Policy | Modal ปิด | [ ] | +| 3 | กดปุ่มขอตำแหน่ง | ระบบขอ Location Permission | [ ] | +| 4 | เลือก "Deny" เมื่อระบบขอ Location Permission | ปฏิเสธสิทธิ์ | [ ] | +| 5 | ตรวจสอบ error message | แสดง "ไม่สามารถระบุตำแหน่งปัจจุบันได้ เนื่องจากคุณปฏิเสธการเข้าถึงตำแหน่ง กรุณาเปิดการเข้าถึงตำแหน่ง" | [ ] | +| 6 | ตรวจสอบแผนที่ | แผนที่ไม่แสดง (poiPlaceName = '') | [ ] | +| 7 | ตรวจสอบปุ่มลงเวลา | ปุ่มใช้งานไม่ได้ (disabled = true) | [ ] | + +**Verification Checklist:** + +- [ ] แสดง error message ถูกต้อง +- [ ] แผนที่ไม่แสดง +- [ ] `locationGranted = false` +- [ ] ปุ่มลงเวลาเข้า/ออก disabled +- [ ] ไม่สามารถลงเวลาได้ + +--- + +### 3.2 TC-LOC-02: Location Acquisition Testing + +#### Test Case: TC-LOC-02-01 - รับพิกัด GPS สำเร็จ (Outdoor) + +**Objective**: ทดสอบการรับพิกัด GPS สำเร็จในพื้นที่เปิดกว้าง + +| Step | Action | Expected Result | Screenshot | +|------|--------|-----------------|------------| +| 1 | ไปยังพื้นที่เปิดกว้าง (Outdoor) | อยู่กลางแจ้ง มีสัญญาณ GPS ดี | [ ] | +| 2 | เปิดแอป HRMS | แสดงหน้าแรก | [ ] | +| 3 | อนุญาต Location Permission | รับสิทธิ์สำเร็จ | [ ] | +| 4 | กดปุ่มขอตำแหน่ง | เริ่มรับพิกัด GPS | [ ] | +| 5 | รอรับพิกัด (ประมาณ 3-5 วินาที) | แสดง Skeleton loading | [ ] | +| 6 | รับพิกัดสำเร็จ | แสดงแผนที่ | [ ] | +| 7 | ตรวจสอบพิกัด | Latitude และ Longitude ถูกต้อง | [ ] | +| 8 | ตรวจสอบความแม่นยำ | Accuracy <= 100 meters | [ ] | +| 9 | ตรวจสอบ timestamp | Timestamp ภายใน 60 วินาที | [ ] | +| 10 | ตรวจสอบชื่อสถานที่ | แสดงชื่อสถานที่ใกล้เคียง | [ ] | + +**Verification Checklist:** + +- [ ] รับพิกัดสำเร็จ +- [ ] พิกัดอยู่ในช่วงที่ถูกต้อง (lat: -90 to 90, lon: -180 to 180) +- [ ] ไม่ใช่ (0, 0) +- [ ] Accuracy <= 100 meters +- [ ] Timestamp ภายใน 60 วินาที +- [ ] ชื่อสถานที่ใกล้เคียงแสดงถูกต้อง + +--- + +#### Test Case: TC-LOC-02-02 - รับพิกัด GPS สำเร็จ (Indoor) + +**Objective**: ทดสอบการรับพิกัด GPS สำเร็จในพื้นที่ปิด + +| Step | Action | Expected Result | Screenshot | +|------|--------|-----------------|------------| +| 1 | ไปยังพื้นที่ปิด (Indoor) | อยู่ภายในอาคาร | [ ] | +| 2 | เปิดแอป HRMS | แสดงหน้าแรก | [ ] | +| 3 | อนุญาต Location Permission | รับสิทธิ์สำเร็จ | [ ] | +| 4 | กดปุ่มขอตำแหน่ง | เริ่มรับพิกัด GPS | [ ] | +| 5 | รอรับพิกัด (อาจนานกว่าปกติ) | แสดง Skeleton loading | [ ] | +| 6 | รับพิกัดสำเร็จ | แสดงแผนที่ | [ ] | +| 7 | ตรวจสอบพิกัด | Latitude และ Longitude ถูกต้อง | [ ] | +| 8 | ตรวจสอบความแม่นยำ | อาจมีความแม่นยำต่ำกว่า Outdoor | [ ] | + +**Verification Checklist:** + +- [ ] รับพิกัดสำเร็จ +- [ ] อาจมีความแม่นยำต่ำกว่า Outdoor +- [ ] แผนที่แสดงถูกต้อง + +--- + +#### Test Case: TC-LOC-02-03 - รับพิกัด GPS ล้มเหลว (GPS ไม่ทำงาน) + +**Objective**: ทดสอบกรณี GPS ไม่ทำงาน + +| Step | Action | Expected Result | Screenshot | +|------|--------|-----------------|------------| +| 1 | เปิดแอป HRMS | แสดงหน้าแรก | [ ] | +| 2 | อนุญาต Location Permission | รับสิทธิ์สำเร็จ | [ ] | +| 3 | ไปที่ Settings > Location > ปิด GPS | GPS ปิดอยู่ | [ ] | +| 4 | กดปุ่มขอตำแหน่ง | เริ่มรับพิกัด GPS | [ ] | +| 5 | ตรวจสอบ error message | แสดง "ไม่สามารถระบุตำแหน่งปัจจุบันได้" | [ ] | +| 6 | ตรวจสอบแผนที่ | แผนที่ไม่แสดง | [ ] | + +**Verification Checklist:** + +- [ ] แสดง error message ถูกต้อง +- [ ] แผนที่ไม่แสดง +- [ ] ไม่สามารถรับพิกัดได้ + +--- + +### 3.3 TC-LOC-03: Location Validation Testing + +#### Test Case: TC-LOC-03-01 - พิกัดถูกต้อง (Valid coordinates) + +**Objective**: ทดสอบการตรวจสอบพิกัดที่ถูกต้อง + +| Step | Action | Expected Result | Screenshot | +|------|--------|-----------------|------------| +| 1 | เปิดแอป HRMS | แสดงหน้าแรก | [ ] | +| 2 | อนุญาต Location Permission | รับสิทธิ์สำเร็จ | [ ] | +| 3 | รับพิกัด GPS ปกติ | พิกัดถูกต้อง (เช่น 13.7563, 100.5018) | [ ] | +| 4 | เปิด Console และตรวจสอบ validationResult | { isValid: true, isMockDetected: false } | [ ] | +| 5 | ตรวจสอบ locationGranted | locationGranted = true | [ ] | +| 6 | ตรวจสอบปุ่มลงเวลา | ปุ่มใช้งานได้ | [ ] | + +**Verification Checklist:** + +- [ ] `validationResult.isValid = true` +- [ ] `validationResult.isMockDetected = false` +- [ ] `validationResult.errors = []` +- [ ] `locationGranted = true` +- [ ] ไม่มี error/warning message + +--- + +#### Test Case: TC-LOC-03-02 - พิกัดไม่ถูกต้อง (Invalid coordinates - (0,0)) + +**Objective**: ทดสอบการตรวจสอบพิกัด (0,0) + +| Step | Action | Expected Result | Screenshot | +|------|--------|-----------------|------------| +| 1 | เปิด Fake GPS App | เปิดแอป | [ ] | +| 2 | ตั้งค่าพิกัด (0, 0) | Latitude: 0, Longitude: 0 | [ ] | +| 3 | เปิดแอป HRMS | แสดงหน้าแรก | [ ] | +| 4 | กดปุ่มขอตำแหน่ง | เริ่มรับพิกัด GPS | [ ] | +| 5 | ตรวจสอบ Console (validateCoordinates) | validateCoordinates(0, 0) = false | [ ] | +| 6 | ตรวจสอบ validationResult | { isValid: false, isMockDetected: true, confidence: 'high' } | [ ] | +| 7 | ตรวจสอบ error message | "พิกัดตำแหน่งไม่ถูกต้อง กรุณาลองใหม่" | [ ] | +| 8 | ตรวจสอบ disabledBtn | disabledBtn = true | [ ] | + +**Verification Checklist:** + +- [ ] `validateCoordinates(0, 0) = false` +- [ ] `mockIndicators = 3` +- [ ] `isMockDetected = true` +- [ ] `confidence = 'high'` +- [ ] แสดง error message ถูกต้อง +- [ ] ปุ่มลงเวลา disabled + +--- + +#### Test Case: TC-LOC-03-04 - ข้อมูลตำแหน่งเก่าเกินไป (Stale timestamp) + +**Objective**: ทดสอบการตรวจสอบ timestamp เก่าเกิน 60 วินาที + +| Step | Action | Expected Result | Screenshot | +|------|--------|-----------------|------------| +| 1 | เปิด Chrome DevTools | F12 > Sensors | [ ] | +| 2 | เลือก Custom Location | กำหนดพิกัด | [ ] | +| 3 | เปิด Console และเขียน script | จำลอง timestamp เก่า | [ ] | +| 4 | Run script: | | | +| ```javascript | | | +| const stalePosition = { | | | +| coords: { latitude: 13.7563, longitude: 100.5018, accuracy: 10 }, | | | +| timestamp: Date.now() - 70000 // 70 seconds ago | | | +| } | | | +| navigator.geolocation.getCurrentPosition(pos => console.log(pos)) | | | +| ``` | | | +| 5 | รีเฟรชแอป | รับพิกัด | [ ] | +| 6 | ตรวจสอบ validationResult | mockIndicators += 2 | [ ] | +| 7 | ตรวจสอบ error message | "ข้อมูลตำแหน่งเก่าเกินไป กรุณารับสัญญาณ GPS ใหม่" | [ ] | + +**Verification Checklist:** + +- [ ] `validateTimestamp(staleTimestamp) = false` +- [ ] `mockIndicators += 2` +- [ ] แสดง error message ถูกต้อง + +--- + +#### Test Case: TC-LOC-03-05 - ความแม่นยำต่ำ (Poor accuracy) + +**Objective**: ทดสอบการตรวจสอบความแม่นยำต่ำ + +| Step | Action | Expected Result | Screenshot | +|------|--------|-----------------|------------| +| 1 | เปิด Chrome DevTools | F12 > Sensors | [ ] | +| 2 | เลือก Custom Location | กำหนดพิกัด | [ ] | +| 3 | เปิด Console และเขียน script | จำลอง accuracy ต่ำ | [ ] | +| 4 | Run script: | | | +| ```javascript | | | +| const poorAccuracyPosition = { | | | +| coords: { latitude: 13.7563, longitude: 100.5018, accuracy: 150 }, | | | +| timestamp: Date.now() | | | +| } | | | +| ``` | | | +| 5 | รีเฟรชแอป | รับพิกัด | [ ] | +| 6 | ตรวจสอบ validationResult | warnings = ["ความแม่นยำตำแหน่งต่ำเกินไป..."] | [ ] | +| 7 | ตรวจสอบ mockIndicators | mockIndicators += 1 | [ ] | + +**Verification Checklist:** + +- [ ] `validateAccuracy(150) = false` +- [ ] `mockIndicators += 1` +- [ ] แสดง warning message ถูกต้อง + +--- + +#### Test Case: TC-LOC-03-06 - ความเร็วเคลื่อนที่ผิดปกติ (Impossible speed) + +**Objective**: ทดสอบการตรวจสอบความเร็วเคลื่อนที่ผิดปกติ + +| Step | Action | Expected Result | Screenshot | +|------|--------|-----------------|------------| +| 1 | เปิดแอป HRMS ที่ตำแหน่ง A (13.7563, 100.5018) | รับพิกัด A | [ ] | +| 2 | รอสักครู่เพื่อให้บันทึกตำแหน่ง A ลง history | previousPositions มีค่า | [ ] | +| 3 | เปิด Fake GPS App | เปิดแอป | [ ] | +| 4 | ตั้งค่าพิกัด B (15.8700, 100.9925) ที่ห่างกัน ~180 กม. | พิกัด B | [ ] | +| 5 | รีเฟรชแอปทันที (ภายใน 60 วินาที) | รับพิกัด B | [ ] | +| 6 | ตรวจสอบ Console (calculateSpeed) | speed = ~3000 km/h (> 100 m/s) | [ ] | +| 7 | ตรวจสอบ validationResult | mockIndicators += 3 | [ ] | +| 8 | ตรวจสอบ error message | "ตรวจพบการเคลื่อนที่ด้วยความเร็วผิดปกติ..." | [ ] | + +**Verification Checklist:** + +- [ ] `calculateSpeed()` = ความเร็ว > 100 m/s +- [ ] `mockIndicators += 3` +- [ ] แสดง error message ถูกต้อง + +--- + +### 3.4 TC-LOC-04: Mock Location Detection Testing + +#### Test Case: TC-LOC-04-01 - ไม่พบ Mock Location (Normal GPS) + +**Objective**: ทดสอบการใช้งาน GPS ปกติ ไม่พบ mock location + +| Step | Action | Expected Result | Screenshot | +|------|--------|-----------------|------------| +| 1 | ตรวจสอบว่าปิด Fake GPS App | ไม่มี Fake GPS App ทำงาน | [ ] | +| 2 | เปิดแอป HRMS | แสดงหน้าแรก | [ ] | +| 3 | อนุญาต Location Permission | รับสิทธิ์สำเร็จ | [ ] | +| 4 | กดปุ่มขอตำแหน่ง | เริ่มรับพิกัด GPS | [ ] | +| 5 | รับพิกัดสำเร็จ | แสดงแผนที่ | [ ] | +| 6 | ตรวจสอบ Console (validationResult) | { isValid: true, isMockDetected: false } | [ ] | +| 7 | ตรวจสอบ locationGranted | locationGranted = true | [ ] | +| 8 | ตรวจสอบ isMockLocationDetected | isMockLocationDetected = false | [ ] | +| 9 | ตรวจสอบปุ่มลงเวลา | ปุ่มใช้งานได้ | [ ] | + +**Verification Checklist:** + +- [ ] `isValid = true` +- [ ] `isMockDetected = false` +- [ ] `locationGranted = true` +- [ ] `isMockLocationDetected = false` +- [ ] ปุ่มลงเวลาใช้งานได้ + +--- + +#### Test Case: TC-LOC-04-02 - พบ Mock Location - Fake GPS App + +**Objective**: ทดสอบการตรวจจับ mock location จาก Fake GPS App + +| Step | Action | Expected Result | Screenshot | +|------|--------|-----------------|------------| +| 1 | เปิด Fake GPS Location App | เปิดแอป | [ ] | +| 2 | ตั้งค่าตำแหน่งปลอง (เช่น 13.7563, 100.5018) | ตั้งค่าสำเร็จ | [ ] | +| 3 | เปิด Developer Options > Select mock location app | เลือก Fake GPS App | [ ] | +| 4 | เปิดแอป HRMS | แสดงหน้าแรก | [ ] | +| 5 | กดปุ่มขอตำแหน่ง | เริ่มรับพิกัด GPS | [ ] | +| 6 | รับพิกัดจาก Fake GPS | แสดงพิกัดปลอง | [ ] | +| 7 | ตรวจสอบ Console (validationResult) | isMockDetected = true | [ ] | +| 8 | ตรวจสอบ mockIndicators | mockIndicators >= 3 | [ ] | +| 9 | ตรวจสอบ error message | "ตรวจพบว่าตำแหน่ง GPS อาจไม่ถูกต้อง..." | [ ] | +| 10 | ตรวจสอบ isMockLocationDetected | isMockLocationDetected = true | [ ] | +| 11 | ตรวจสอบ disabledBtn | disabledBtn = true | [ ] | +| 12 | พยายามกดปุ่มลงเวลา | กดไม่ได้ | [ ] | + +**Verification Checklist:** + +- [ ] `isMockDetected = true` +- [ ] `mockIndicators >= 3` +- [ ] แสดง error message ถูกต้อง +- [ ] `isMockLocationDetected = true` +- [ ] `disabledBtn = true` +- [ ] ไม่สามารถลงเวลาได้ + +--- + +### 3.5 TC-LOC-05: POI Resolution Testing + +#### Test Case: TC-LOC-05-01 - แปลงพิกัดเป็นชื่อสถานที่สำเร็จ (Bangkok GIS) + +**Objective**: ทดสอบการแปลงพิกัดเป็นชื่อสถานที่สำเร็จผ่าน Bangkok GIS API + +| Step | Action | Expected Result | Screenshot | +|------|--------|-----------------|------------| +| 1 | เปิดแอป HRMS | แสดงหน้าแรก | [ ] | +| 2 | อนุญาต Location Permission | รับสิทธิ์สำเร็จ | [ ] | +| 3 | กดปุ่มขอตำแหน่ง | เริ่มรับพิกัด GPS | [ ] | +| 4 | รับพิกัดสำเร็จ | แสดงแผนที่ | [ ] | +| 5 | เปิด Network Tab (DevTools) | แสดง requests | [ ] | +| 6 | ตรวจสอบ request ไป Bangkok GIS | GET `https://bmagis.bangkok.go.th/...` | [ ] | +| 7 | ตรวจสอบ response | status = 200, มี PlaceName | [ ] | +| 8 | ตรวจสอบ poiPlaceName | poiPlaceName มีค่า | [ ] | +| 9 | ตรวจสอบ formLocation.POI | formLocation.POI มีค่า | [ ] | +| 10 | ตรวจสอบหน้าจอ | แสดงชื่อสถานที่ใกล้เคียง | [ ] | + +**Verification Checklist:** + +- [ ] เรียก Bangkok GIS API สำเร็จ +- [ ] Response มี PlaceName +- [ ] `poiPlaceName` มีค่า +- [ ] แสดงชื่อสถานที่ใกล้เคียงถูกต้อง + +--- + +#### Test Case: TC-LOC-05-02 - แปลงพิกัดเป็นชื่อสถานที่สำเร็จ (ArcGIS Fallback) + +**Objective**: ทดสอบการแปลงพิกัดเป็นชื่อสถานที่สำเร็จผ่าน ArcGIS API (เมื่อ Bangkok GIS fail) + +| Step | Action | Expected Result | Screenshot | +|------|--------|-----------------|------------| +| 1 | เปิด Chrome DevTools > Network Tab | แสดง requests | [ ] | +| 2 | เปิด Throttling > Offline | จำลอง Bangkok GIS down | [ ] | +| 3 | เปิดแอป HRMS | แสดงหน้าแรก | [ ] | +| 4 | อนุญาต Location Permission | รับสิทธิ์สำเร็จ | [ ] | +| 5 | กดปุ่มขอตำแหน่ง | เริ่มรับพิกัด GPS | [ ] | +| 6 | รับพิกัดสำเร็จ | แสดงแผนที่ | [ ] | +| 7 | ปิด Throttling (กลับสู่ Online) | Bangkok GIS ยังไม่พร้อม | [ ] | +| 8 | ตรวจสอบ Console | Bangkok GIS API fail | [ ] | +| 9 | ตรวจสอบ fallback | เรียก ArcGIS API | [ ] | +| 10 | ตรวจสอบ response | GET `https://geocode.arcgis.com/...` | [ ] | +| 11 | ตรวจสอบ poiPlaceName | poiPlaceName มีค่า | [ ] | + +**Verification Checklist:** + +- [ ] Bangkok GIS API fail +- [ ] Fallback ไป ArcGIS API สำเร็จ +- [ ] `poiPlaceName` มีค่า +- [ ] แสดงชื่อสถานที่ใกล้เคียง + +--- + +### 3.6 TC-LOC-06: Check-in with Location Testing + +#### Test Case: TC-LOC-06-01 - ลงเวลาเข้าสำเร็จ - ณ สถานที่ตั้ง (In-place) + +**Objective**: ทดสอบการลงเวลาเข้าสำเร็จเมื่ออยู่ ณ สถานที่ตั้ง + +| Step | Action | Expected Result | Screenshot | +|------|--------|-----------------|------------| +| 1 | เปิดแอป HRMS | แสดงหน้าแรก | [ ] | +| 2 | ตรวจสอบ statusCheckin | statusCheckin = true (เข้างาน) | [ ] | +| 3 | อนุญาต Location Permission | รับสิทธิ์สำเร็จ | [ ] | +| 4 | กดปุ่มขอตำแหน่ง | รับพิกัดสำเร็จ | [ ] | +| 5 | ถ่ายรูปภาพ | แสดงรูปที่ถ่าย | [ ] | +| 6 | เลือก "ในสถานที่" | workplace = 'in-place' | [ ] | +| 7 | กด "ลงเวลาเข้างาน" | แสดง dialog ยืนยัน | [ ] | +| 8 | ตรวจสอบ dialog message | "ยืนยันการลงเวลาเข้างาน ในสถานที่..." | [ ] | +| 9 | กด "ยืนยัน" | ส่งข้อมูลไป API | [ ] | +| 10 | เปิด Network Tab | POST `/leave/check-in` | [ ] | +| 11 | ตรวจสอบ payload | { lat, lon, POI, isLocation: true, locationName: '', img, remark } | [ ] | +| 12 | ตรวจสอบ response | status = 200 | [ ] | +| 13 | ตรวจสอบ modal | แสดง modal ลงเวลาเข้างานสำเร็จ | [ ] | +| 14 | ตรวจสอบ statusCheckin | statusCheckin = false | [ ] | + +**Verification Checklist:** + +- [ ] API call ถูกต้อง +- [ ] Payload ถูกต้อง (isLocation: true, locationName: '') +- [ ] Response status 200 +- [ ] แสดง modal สำเร็จ +- [ ] `statusCheckin = false` + +--- + +#### Test Case: TC-LOC-06-02 - ลงเวลาเข้าสำเร็จ - นอกสถานที่ตั้ง (Off-site) + +**Objective**: ทดสอบการลงเวลาเข้าสำเร็จเมื่ออยู่นอกสถานที่ตั้ง + +| Step | Action | Expected Result | Screenshot | +|------|--------|-----------------|------------| +| 1 | เปิดแอป HRMS | แสดงหน้าแรก | [ ] | +| 2 | ตรวจสอบ statusCheckin | statusCheckin = true (เข้างาน) | [ ] | +| 3 | อนุญาต Location Permission | รับสิทธิ์สำเร็จ | [ ] | +| 4 | กดปุ่มขอตำแหน่ง | รับพิกัดสำเร็จ | [ ] | +| 5 | ถ่ายรูปภาพ | แสดงรูปที่ถ่าย | [ ] | +| 6 | เลือก "นอกสถานที่" | workplace = 'off-site' | [ ] | +| 7 | เลือก "ปฏิบัติงานที่บ้าน (WFH)" | model = 'ปฏิบัติงานที่บ้าน (WFH)' | [ ] | +| 8 | ตรวจสอบ useLocation | useLocation = 'ปฏิบัติงานที่บ้าน (WFH)' | [ ] | +| 9 | กด "ลงเวลาเข้างาน" | แสดง dialog ยืนยัน | [ ] | +| 10 | ตรวจสอบ dialog message | "ยืนยันการลงเวลาเข้างาน นอกสถานที่ (ปฏิบัติงานที่บ้าน (WFH))..." | [ ] | +| 11 | กด "ยืนยัน" | ส่งข้อมูลไป API | [ ] | +| 12 | เปิด Network Tab | POST `/leave/check-in` | [ ] | +| 13 | ตรวจสอบ payload | { lat, lon, POI, isLocation: false, locationName: 'ปฏิบัติงานที่บ้าน (WFH)', img, remark } | [ ] | +| 14 | ตรวจสอบ response | status = 200 | [ ] | + +**Verification Checklist:** + +- [ ] API call ถูกต้อง +- [ ] Payload ถูกต้อง (isLocation: false, locationName มีค่า) +- [ ] Response status 200 +- [ ] แสดง modal สำเร็จ + +--- + +#### Test Case: TC-LOC-06-03 - ลงเวลาเข้าล้มเหลว - Mock Location detected + +**Objective**: ทดสอบการลงเวลาเข้าล้มเหลวเมื่อตรวจพบ mock location + +| Step | Action | Expected Result | Screenshot | +|------|--------|-----------------|------------| +| 1 | เปิด Fake GPS Location App | เปิดแอป | [ ] | +| 2 | ตั้งค่าตำแหน่งปลอง | ตั้งค่าสำเร็จ | [ ] | +| 3 | เปิดแอป HRMS | แสดงหน้าแรก | [ ] | +| 4 | อนุญาต Location Permission | รับสิทธิ์สำเร็จ | [ ] | +| 5 | กดปุ่มขอตำแหน่ง | เริ่มรับพิกัด GPS | [ ] | +| 6 | รับพิกัดจาก Fake GPS | ตรวจจับ mock location | [ ] | +| 7 | ตรวจสอบ error message | "ตรวจพบว่าตำแหน่ง GPS อาจไม่ถูกต้อง..." | [ ] | +| 8 | ตรวจสอบ isMockLocationDetected | isMockLocationDetected = true | [ ] | +| 9 | ตรวจสอบ disabledBtn | disabledBtn = true | [ ] | +| 10 | ถ่ายรูปภาพ | แสดงรูปที่ถ่าย | [ ] | +| 11 | พยายามกด "ลงเวลาเข้างาน" | กดไม่ได้ (ปุ่ม disabled) | [ ] | + +**Verification Checklist:** + +- [ ] ตรวจจับ mock location สำเร็จ +- [ ] `isMockLocationDetected = true` +- [ ] `disabledBtn = true` +- [ ] ไม่สามารถลงเวลาเข้างานได้ + +--- + +### 3.7 TC-LOC-07: Check-out with Location Testing + +#### Test Case: TC-LOC-07-01 - ลงเวลาออกสำเร็จ + +**Objective**: ทดสอบการลงเวลาออกสำเร็จพร้อมตำแหน่ง + +| Step | Action | Expected Result | Screenshot | +|------|--------|-----------------|------------| +| 1 | เปิดแอป HRMS | แสดงหน้าแรก | [ ] | +| 2 | ตรวจสอบ statusCheckin | statusCheckin = false (ออกงาน) | [ ] | +| 3 | อนุญาต Location Permission | รับสิทธิ์สำเร็จ | [ ] | +| 4 | กดปุ่มขอตำแหน่ง | รับพิกัดสำเร็จ | [ ] | +| 5 | ถ่ายรูปภาพ | แสดงรูปที่ถ่าย | [ ] | +| 6 | กด "ลงเวลาออกงาน" | เรียก checkoutCheck API | [ ] | +| 7 | เปิด Network Tab | GET `/leave/user/checkout-check/N` | [ ] | +| 8 | ตรวจสอบ response | status = 'NORMAL' หรือ 'ABSENT' | [ ] | +| 9 | ตรวจสอบ dialog | แสดง dialog ยืนยันการลงเวลาออกงาน | [ ] | +| 10 | กด "ยืนยัน" | ส่งข้อมูลไป API | [ ] | +| 11 | เปิด Network Tab | POST `/leave/check-in` | [ ] | +| 12 | ตรวจสอบ payload | { lat, lon, POI, isLocation, locationName, img, remark, checkInId } | [ ] | +| 13 | ตรวจสอบ response | status = 200 | [ ] | +| 14 | ตรวจสอบ modal | แสดง modal ลงเวลาออกงานสำเร็จ | [ ] | +| 15 | ตรวจสอบ statusCheckin | statusCheckin = true | [ ] | + +**Verification Checklist:** + +- [ ] checkoutCheck API ถูกต้อง +- [ ] API call ถูกต้อง (มี checkInId) +- [ ] Response status 200 +- [ ] แสดง modal สำเร็จ +- [ ] `statusCheckin = true` + +--- + +### 3.8 TC-LOC-09: Privacy Consent Testing + +#### Test Case: TC-LOC-09-01 - แสดง Privacy Modal ก่อนใช้ Location + +**Objective**: ทดสอบการแสดง Privacy Modal ก่อนใช้ Location + +| Step | Action | Expected Result | Screenshot | +|------|--------|-----------------|------------| +| 1 | เปิดแอป HRMS ครั้งแรก (หรือ clear localStorage) | แสดงหน้าแรก | [ ] | +| 2 | ตรวจสอบ privacyStore.isAccepted | isAccepted = false | [ ] | +| 3 | กดปุ่มที่ต้องการ Location (แผนที่/กล้อง) | checkPrivacyAccepted() return false | [ ] | +| 4 | ตรวจสอบ privacyStore.modalPrivacy | modalPrivacy = true | [ ] | +| 5 | ตรวจสอบ Privacy Modal | แสดง Privacy Modal | [ ] | +| 6 | ตรวจสอบว่าไม่สามารถใช้งาน Location ได้ | แผนที่/กล้องไม่ทำงาน | [ ] | + +**Verification Checklist:** + +- [ ] `isAccepted = false` +- [ ] `modalPrivacy = true` +- [ ] แสดง Privacy Modal +- [ ] ไม่สามารถใช้งาน Location ได้ + +--- + +#### Test Case: TC-LOC-09-02 - ยอมรับ Privacy Policy + +**Objective**: ทดสอบการยอมรับ Privacy Policy + +| Step | Action | Expected Result | Screenshot | +|------|--------|-----------------|------------| +| 1 | เปิดแอป HRMS ครั้งแรก | แสดงหน้าแรก | [ ] | +| 2 | แสดง Privacy Modal | แสดง Privacy Modal | [ ] | +| 3 | กด "ยอมรับ" | เรียก privacyStore.setAccepted(true) | [ ] | +| 4 | ตรวจสอบ privacyStore.isAccepted | isAccepted = true | [ ] | +| 5 | ตรวจสอบ privacyStore.modalPrivacy | modalPrivacy = false | [ ] | +| 6 | ตรวจสอบ Privacy Modal | Modal ปิด | [ ] | +| 7 | กดปุ่มขอตำแหน่ง | เรียก mapRef.value?.requestLocationPermission() | [ ] | +| 8 | อนุญาต Location Permission | รับสิทธิ์สำเร็จ | [ ] | +| 9 | รับพิกัดสำเร็จ | แสดงแผนที่ | [ ] | + +**Verification Checklist:** + +- [ ] `isAccepted = true` +- [ ] `modalPrivacy = false` +- [ ] Modal ปิด +- [ ] สามารถใช้งาน Location ได้ + +--- + +#### Test Case: TC-LOC-09-03 - ปฏิเสธ Privacy Policy + +**Objective**: ทดสอบการปฏิเสธ Privacy Policy + +| Step | Action | Expected Result | Screenshot | +|------|--------|-----------------|------------| +| 1 | เปิดแอป HRMS ครั้งแรก | แสดงหน้าแรก | [ ] | +| 2 | แสดง Privacy Modal | แสดง Privacy Modal | [ ] | +| 3 | กด "ปฏิเสธ" หรือปิด Modal | เรียก privacyStore.modalPrivacy = false | [ ] | +| 4 | ตรวจสอบ privacyStore.isAccepted | isAccepted = false | [ ] | +| 5 | ตรวจสอบ privacyStore.modalPrivacy | modalPrivacy = false | [ ] | +| 6 | ตรวจสอบ Privacy Modal | Modal ปิด | [ ] | +| 7 | กดปุ่มขอตำแหน่ง | checkPrivacyAccepted() return false | [ ] | +| 8 | ตรวจสอบ | Privacy Modal แสดงอีกครั้ง | [ ] | + +**Verification Checklist:** + +- [ ] `isAccepted = false` +- [ ] `modalPrivacy = false` +- [ ] Modal ปิด +- [ ] ไม่สามารถใช้งาน Location ได้ +- [ ] แจ้งเตือนเมื่อพยายามใช้งาน Location + +--- + +## 4. Mock Location Testing + +### 4.1 Fake GPS Apps for Testing + +#### 4.1.1 Android Fake GPS Apps + +| App Name | Link | Features | +|----------|------|----------| +| Fake GPS Location | [Play Store](https://play.google.com/store/apps/details?id=com.lexa.fakegps) | Simple location spoofing | +| GPS Joystick | [Play Store](https://play.google.com/store/apps/details?id=com.theappninjas.android.gpsjoke) | Joystick control, route simulation | +| Mock GPS | [Play Store](https://play.google.com/store/apps/details?id=com.incorporateapps.fakegps) | Multiple location saving | + +#### 4.1.2 iOS Fake GPS Apps + +| App Name | Link | Features | +|----------|------|----------| +| Location Changer | [App Store](https://apps.apple.com/app/location-changer/id1383869695) | Location spoofing (needs jailbreak) | +| Xcode Simulation | - | Built-in location simulation | + +### 4.2 Mock Location Test Scenarios + +#### Scenario 1: Basic Mock Location + +1. **Setup** + - เปิด Fake GPS Location App + - ตั้งค่าตำแหน่ง: 13.7563, 100.5018 (Sanam Suea Pa) + - ตั้งค่าความแม่นยำ: 10 meters + +2. **Execute** + - เปิดแอป HRMS + - กดปุ่มขอตำแหน่ง + - ตรวจสอบผลลัพธ์ + +3. **Expected** + - ตรวจจับ mock location (indicators >= 3) + - แสดง error message + - ปุ่มลงเวลา disabled + +#### Scenario 2: Rapid Location Change + +1. **Setup** + - เปิดแอป HRMS ที่ตำแหน่ง A (13.7563, 100.5018) + - รอสักครู่เพื่อให้บันทึกตำแหน่ง A ลง history + +2. **Execute** + - เปิด Fake GPS App + - เปลี่ยนตำแหน่งไป B (15.8700, 100.9925) + - รีเฟรชแอป HRMS ทันที (ภายใน 60 วินาที) + +3. **Expected** + - คำนวณความเร็ว = ~3000 km/h (> 100 m/s) + - mockIndicators += 3 + - แสดง error: "ตรวจพบการเคลื่อนที่ด้วยความเร็วผิดปกติ..." + +#### Scenario 3: Null Island (0,0) + +1. **Setup** + - เปิด Fake GPS App + - ตั้งค่าตำแหน่ง: 0, 0 (Null Island) + +2. **Execute** + - เปิดแอป HRMS + - กดปุ่มขอตำแหน่ง + +3. **Expected** + - validateCoordinates(0, 0) = false + - mockIndicators += 3 + - แสดง error: "พิกัดตำแหน่งไม่ถูกต้อง กรุณาลองใหม่" + +--- + +## 5. Developer Tools Testing + +### 5.1 Chrome DevTools Sensor Simulation + +#### 5.1.1 Enable Sensors + +1. เปิด Chrome DevTools (F12) +2. เลือก More tools > Sensors +3. ตั้งค่า Location + +#### 5.1.2 Pre-defined Locations + +| Location | Latitude | Longitude | Use Case | +|----------|----------|-----------|----------| +| Sanam Suea Pa | 13.7563 | 100.5018 | Bangkok office | +| Suvarnabhumi Airport | 13.6900 | 100.7501 | Outdoor high accuracy | +| Central World | 13.7944 | 100.5439 | Indoor | +| Null Island | 0 | 0 | Invalid coordinates | +| Out of Range | 91 | 181 | Out of range test | + +#### 5.1.3 Custom Location + +1. เลือก "Other..." ใน Sensors tab +2. ป้อน Latitude และ Longitude +3. กด Enter + +### 5.2 Network Throttling + +#### 5.2.1 Enable Throttling + +1. เปิด Chrome DevTools (F12) +2. เลือก Network tab +3. เลือก Throttling +4. เลือก preset หรือ custom + +#### 5.2.2 Throttling Presets + +| Preset | Download | Upload | Latency | Use Case | +|--------|----------|--------|---------|----------| +| Offline | 0 | 0 | - | API failure test | +| Slow 3G | 500 Kbps | 500 Kbps | 2000ms | Slow network | +| Fast 3G | 1.6 Mbps | 750 Kbps | 100ms | Normal mobile | + +### 5.3 Console Testing + +#### 5.3.1 Test Location Validation + +```javascript +// Test 1: Valid coordinates +const validPosition = { + coords: { latitude: 13.7563, longitude: 100.5018, accuracy: 10 }, + timestamp: Date.now() +} +console.log(validateLocation(validPosition)) +// Expected: { isValid: true, isMockDetected: false } + +// Test 2: Invalid coordinates (0,0) +const invalidPosition = { + coords: { latitude: 0, longitude: 0, accuracy: 10 }, + timestamp: Date.now() +} +console.log(validateLocation(invalidPosition)) +// Expected: { isValid: false, isMockDetected: true, confidence: 'high' } + +// Test 3: Stale timestamp +const stalePosition = { + coords: { latitude: 13.7563, longitude: 100.5018, accuracy: 10 }, + timestamp: Date.now() - 70000 // 70 seconds ago +} +console.log(validateLocation(stalePosition)) +// Expected: errors = ["ข้อมูลตำแหน่งเก่าเกินไป..."] + +// Test 4: Poor accuracy +const poorAccuracyPosition = { + coords: { latitude: 13.7563, longitude: 100.5018, accuracy: 150 }, + timestamp: Date.now() +} +console.log(validateLocation(poorAccuracyPosition)) +// Expected: warnings = ["ความแม่นยำตำแหน่งต่ำเกินไป..."] +``` + +#### 5.3.2 Test Distance Calculation + +```javascript +// Test haversineDistance +const distance = haversineDistance(13.7563, 100.5018, 15.8700, 100.9925) +console.log(`Distance: ${distance} meters`) +// Expected: ~180,000 meters (180 km) + +// Test speed calculation +const pos1 = { latitude: 13.7563, longitude: 100.5018, timestamp: Date.now() - 60000 } +const pos2 = { latitude: 15.8700, longitude: 100.9925, timestamp: Date.now() } +const speed = calculateSpeed(pos1, pos2) +console.log(`Speed: ${speed} m/s (${speed * 3.6} km/h)`) +// Expected: ~3000 km/h (> 100 m/s = 360 km/h) +``` + +--- + +## 6. Device-Specific Testing + +### 6.1 Mobile Device Testing + +#### 6.1.1 Android Testing + +| Step | Action | Notes | +|------|--------|-------| +| 1 | Install Fake GPS App | Google Play Store | +| 2 | Enable Developer Options | Settings > About Phone > Build Number (7 taps) | +| 3 | Enable Mock Location | Settings > Developer Options > Select mock location app | +| 4 | Set Fake Location | Fake GPS App > Set Location | +| 5 | Open HRMS App | Test mock detection | + +#### 6.1.2 iOS Testing + +| Step | Action | Notes | +|------|--------|-------| +| 1 | Connect iPhone to Mac | USB cable | +| 2 | Open Xcode | Mac | +| 3 | Select Device > Debug Location | Xcode menu | +| 4 | Set Custom Location | Enter lat/lon | +| 5 | Open HRMS App | Test mock detection | + +### 6.2 Desktop Browser Testing + +#### 6.2.1 Chrome Testing + +| Step | Action | Notes | +|------|--------|-------| +| 1 | Open Chrome | - | +| 2 | Open DevTools | F12 | +| 3 | More tools > Sensors | - | +| 4 | Set Location | Choose or custom | +| 5 | Open HRMS App | Test location | + +#### 6.2.2 Edge Testing + +| Step | Action | Notes | +|------|--------|-------| +| 1 | Open Edge | - | +| 2 | Open DevTools | F12 | +| 3 | More tools > Sensors | - | +| 4 | Set Location | Choose or custom | +| 5 | Open HRMS App | Test location | + +--- + +## 7. Test Data & Scenarios + +### 7.1 Valid Locations + +| Name | Latitude | Longitude | Accuracy | Expected | +|------|----------|-----------|----------|----------| +| Sanam Suea Pa | 13.7563 | 100.5018 | <= 100m | Pass | +| Suvarnabhumi | 13.6900 | 100.7501 | <= 100m | Pass | +| Central World | 13.7944 | 100.5439 | <= 100m | Pass | +| Chiang Mai | 18.7883 | 98.9853 | <= 100m | Pass | + +### 7.2 Invalid Locations + +| Name | Latitude | Longitude | Accuracy | Expected | +|------|----------|-----------|----------|----------| +| Null Island | 0 | 0 | Any | Fail (invalid coordinates) | +| Out of Range (lat) | 91 | 100.5018 | Any | Fail (invalid coordinates) | +| Out of Range (lon) | 13.7563 | 181 | Any | Fail (invalid coordinates) | +| NaN | NaN | NaN | Any | Fail (invalid coordinates) | + +### 7.3 Edge Cases + +| Scenario | Latitude | Longitude | Accuracy | Timestamp | Expected | +|----------|----------|-----------|----------|-----------|----------| +| Stale Data | 13.7563 | 100.5018 | 10 | t - 70s | Fail (stale) | +| Poor Accuracy | 13.7563 | 100.5018 | 150 | current | Warning | +| Impossible Speed | 15.8700 | 100.9925 | 10 | t + 60s (from 13.7563, 100.5018) | Fail (speed) | + +--- + +## 8. Troubleshooting + +### 8.1 Common Issues + +| Issue | Cause | Solution | +|-------|-------|----------| +| ไม่ได้รับพิกัด GPS | GPS ปิดอยู่ | เปิด Location Service | +| แผนที่ไม่แสดง | ยังไม่ยอมรับ Privacy Policy | ยอมรับ Privacy Policy | +| ปุ่มลงเวลา disabled | Mock location detected | ปิด Fake GPS App และรีเฟรช | +| POI ไม่แสดง | Bangkok GIS down | รอ fallback ไป ArcGIS | +| ความแม่นยำต่ำ | อยู่ในอาคาร | ไปยังพื้นที่เปิดกว้าง | + +### 8.2 Debug Mode + +#### Enable Debug Mode + +1. เปิด Console ใน Browser +2. ตรวจสอบค่าต่าง ๆ: + +```javascript +// Check validation result +console.log('Validation:', validationResult) + +// Check location granted +console.log('Location Granted:', locationGranted) + +// Check mock detected +console.log('Mock Detected:', isMockLocationDetected) + +// Check form location +console.log('Form Location:', formLocation) + +// Check privacy accepted +console.log('Privacy Accepted:', privacyStore.isAccepted) +``` + +--- + +## 9. Test Execution Checklist + +### 9.1 Pre-Test Checklist + +- [ ] ติดตั้ง Fake GPS App (สำหรับการทดสอบ mock location) +- [ ] เปิด Developer Options (Android) หรือเตรียม Xcode (iOS) +- [ ] เตรียม Test Data และ Test Scenarios +- [ ] เตรียม Screenshot/Screen Recording tool +- [ ] ตรวจสอบ Test Environment (Network, GPS, etc.) + +### 9.2 During Test Checklist + +- [ ] บันทึกผลลัพธ์ทุก Test Case +- [ ] ถ่าย Screenshot สำคัญ +- [ ] บันทึกข้อผิดพลาดที่พบ +- [ ] ตรวจสอบ Console logs +- [ ] ตรวจสอบ Network requests + +### 9.3 Post-Test Checklist + +- [ ] สรุปผลการทดสอบ +- [ ] รายงาน bugs ที่พบ +- [ ] อัปเดต Test Cases document +- [ ] เตรียม Test Evidence (Screenshots, Videos) +- [ ] ส่งรายงานให้ทีมที่เกี่ยวข้อง + +--- + +## 10. References + +### 10.1 Related Documents + +- [Test Cases: Location Features](./test-cases-location.md) +- [Location Validation Logic](../src/composables/useLocationValidation.ts) +- [Home View Component](../src/views/HomeView.vue) +- [AscGISMap Component](../src/components/AscGISMap.vue) + +### 10.2 External Resources + +- [W3C Geolocation API](https://www.w3.org/TR/geolocation-API/) +- [MDN Geolocation API](https://developer.mozilla.org/en-US/docs/Web/API/Geolocation_API) +- [Chrome DevTools Sensors](https://developer.chrome.com/docs/devtools/device-mode/override-device-metrics/) + +--- + +## 11. Revision History + +| Version | Date | Author | Changes | +|---------|------|--------|---------| +| 1.0.0 | 2025-03-09 | QA Team | Initial version - Detailed test steps for Location features | + +--- + +## 12. Approval + +| Role | Name | Signature | Date | +|------|------|-----------|------| +| QA Lead | | | | +| Developer | | | | +| Product Owner | | | |