add test case and test step location
All checks were successful
Build & Deploy on Dev / build (push) Successful in 4m20s
All checks were successful
Build & Deploy on Dev / build (push) Successful in 4m20s
This commit is contained in:
parent
f0d4eba9d3
commit
7fdece0a28
2 changed files with 1886 additions and 0 deletions
860
docs/test-cases-location.md
Normal file
860
docs/test-cases-location.md
Normal file
|
|
@ -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 แล้ว<br>2. เปิดแอปครั้งแรก หรือยังไม่เคยอนุญาต Location Permission |
|
||||
| **Test Data** | - |
|
||||
| **Test Steps** | 1. เปิดแอป HRMS<br>2. กดปุ่มขอตำแหน่ง (ถ้าจำเป็น)<br>3. เลือก "Allow" เมื่อระบบขอ Location Permission |
|
||||
| **Expected Result** | 1. แสดงแผนที่พร้อมตำแหน่งปัจจุบัน<br>2. แสดงชื่อสถานที่ใกล้เคียง<br>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 แล้ว<br>2. เปิดแอปครั้งแรก หรือยังไม่เคยอนุญาต Location Permission |
|
||||
| **Test Data** | - |
|
||||
| **Test Steps** | 1. เปิดแอป HRMS<br>2. กดปุ่มขอตำแหน่ง (ถ้าจำเป็น)<br>3. เลือก "Deny" เมื่อระบบขอ Location Permission |
|
||||
| **Expected Result** | 1. แสดงข้อความแจ้งเตือน: "ไม่สามารถระบุตำแหน่งปัจจุบันได้ เนื่องจากคุณปฏิเสธการเข้าถึงตำแหน่ง กรุณาเปิดการเข้าถึงตำแหน่ง"<br>2. แผนที่ไม่แสดง<BR>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 แล้ว<BR>2. ยอมรับ Privacy Policy แล้ว |
|
||||
| **Test Data** | Location: อาคารรัฐสภา แขวง ถนนนครไชยศรี เขตดุสิต กรุงเทพมหานคร (13.7563, 100.5018) |
|
||||
| **Test Steps** | 1. เปิดแอป HRMS<BR>2. อยู่ในพื้นที่เปิดกว้าง (Outdoor)<BR>3. รอรับพิกัด GPS |
|
||||
| **Expected Result** | 1. รับพิกัด GPS สำเร็จ<BR>2. แสดงแผนที่พร้อมตำแหน่ง<BR>3. แสดงชื่อสถานที่ใกล้เคียง<BR>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 แล้ว<BR>2. ยอมรับ Privacy Policy แล้ว |
|
||||
| **Test Data** | Location: ภายในอาคารสำนักงาน |
|
||||
| **Test Steps** | 1. เปิดแอป HRMS<BR>2. อยู่ในพื้นที่ปิด (Indoor)<BR>3. รอรับพิกัด GPS |
|
||||
| **Expected Result** | 1. รับพิกัด GPS สำเร็จ<BR>2. แสดงแผนที่พร้อมตำแหน่ง<BR>3. แสดงชื่อสถานที่ใกล้เคียง<BR>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 แล้ว<BR>2. ยอมรับ Privacy Policy แล้ว |
|
||||
| **Test Data** | - |
|
||||
| **Test Steps** | 1. เปิดแอป HRMS<BR>2. ปิด GPS ในอุปกรณ์<BR>3. พยายามขอรับพิกัด |
|
||||
| **Expected Result** | 1. แสดงข้อความแจ้งเตือน: "ไม่สามารถระบุตำแหน่งปัจจุบันได้"<BR>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 แล้ว<BR>2. ยอมรับ Privacy Policy แล้ว |
|
||||
| **Test Data** | - |
|
||||
| **Test Steps** | 1. เปิดแอป HRMS<BR>2. จำลองสภาวะที่ GPS ตอบสนองช้า (ใช้ Developer Tools)<BR>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 แล้ว<BR>2. ยอมรับ Privacy Policy แล้ว |
|
||||
| **Test Data** | Latitude: 13.7563, Longitude: 100.5018, Accuracy: 10m, Timestamp: current |
|
||||
| **Test Steps** | 1. เปิดแอป HRMS<BR>2. รับพิกัด GPS ที่ถูกต้อง |
|
||||
| **Expected Result** | 1. validation = { isValid: true, isMockDetected: false }<BR>2. locationGranted = true<BR>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 แล้ว<BR>2. ยอมรับ Privacy Policy แล้ว |
|
||||
| **Test Data** | Latitude: 0, Longitude: 0 |
|
||||
| **Test Steps** | 1. เปิดแอป HRMS<BR>2. จำลองพิกัด (0,0) ด้วย Mock Location App |
|
||||
| **Expected Result** | 1. validation = { isValid: false, isMockDetected: true, confidence: 'high' }<BR>2. แสดงข้อความ: "พิกัดตำแหน่งไม่ถูกต้อง กรุณาลองใหม่"<BR>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 แล้ว<BR>2. ยอมรับ Privacy Policy แล้ว |
|
||||
| **Test Data** | Latitude: 91, Longitude: 181 (out of range) |
|
||||
| **Test Steps** | 1. เปิดแอป HRMS<BR>2. จำลองพิกัดนอกช่วงด้วย Developer Tools |
|
||||
| **Expected Result** | 1. validation = { isValid: false }<BR>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 แล้ว<BR>2. ยอมรับ Privacy Policy แล้ว |
|
||||
| **Test Data** | Timestamp: Date.now() - 70,000 ms (70 seconds old) |
|
||||
| **Test Steps** | 1. เปิดแอป HRMS<BR>2. จำลอง timestamp เก่าเกิน 60 วินาที |
|
||||
| **Expected Result** | 1. validation.errors = ["ข้อมูลตำแหน่งเก่าเกินไป กรุณารับสัญญาณ GPS ใหม่"]<BR>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 แล้ว<BR>2. ยอมรับ Privacy Policy แล้ว |
|
||||
| **Test Data** | Accuracy: 150 meters |
|
||||
| **Test Steps** | 1. เปิดแอป HRMS<BR>2. จำลองความแม่นยำต่ำด้วย Developer Tools |
|
||||
| **Expected Result** | 1. validation.warnings = ["ความแม่นยำตำแหน่งต่ำเกินไป กรุณาตรวจสอบการรับสัญญาณ GPS"]<BR>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 แล้ว<BR>2. ยอมรับ Privacy Policy แล้ว<BR>3. มีตำแหน่งเดิมใน history |
|
||||
| **Test Data** | Position 1: (13.7563, 100.5018) at t=0<br>Position 2: (15.8700, 100.9925) at t=60 (~180 km in 60s = 3000 km/h) |
|
||||
| **Test Steps** | 1. เปิดแอป HRMS<BR>2. จำลองการเคลื่อนที่ด้วยความเร็วผิดปกติ |
|
||||
| **Expected Result** | 1. validation.errors = ["ตรวจพบการเคลื่อนที่ด้วยความเร็วผิดปกติ อาจเป็นการจำลองตำแหน่ง"]<BR>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 แล้ว<BR>2. ยอมรับ Privacy Policy แล้ว<BR>3. ไม่ได้เปิด Mock Location App |
|
||||
| **Test Data** | Normal GPS data |
|
||||
| **Test Steps** | 1. เปิดแอป HRMS<BR>2. ใช้งาน GPS ปกติ |
|
||||
| **Expected Result** | 1. validation = { isValid: true, isMockDetected: false }<BR>2. locationGranted = true<BR>3. isMockLocationDetected = false<BR>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 แล้ว<BR>2. ยอมรับ Privacy Policy แล้ว |
|
||||
| **Test Data** | Mock location from Fake GPS App |
|
||||
| **Test Steps** | 1. เปิด Fake GPS Location App<BR>2. ตั้งค่าตำแหน่งปลอม<BR>3. เปิดแอป HRMS<BR>4. ขอรับพิกัด |
|
||||
| **Expected Result** | 1. ตรวจพบ mock location (indicators >= 3)<BR>2. แสดงข้อความ: "ตรวจพบว่าตำแหน่ง GPS อาจไม่ถูกต้อง กรุณาปิดแอปจำลองตำแหน่งและลองใหม่"<BR>3. isMockLocationDetected = true<BR>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 แล้ว<BR>2. ยอมรับ Privacy Policy แล้ว |
|
||||
| **Test Data** | Latitude: 0, Longitude: 0 |
|
||||
| **Test Steps** | 1. จำลองพิกัด (0,0) ด้วย Mock Location App<BR>2. เปิดแอป HRMS<BR>3. ขอรับพิกัด |
|
||||
| **Expected Result** | 1. mockIndicators = 3 (จาก invalid coordinates)<BR>2. isMockDetected = true<BR>3. confidence = 'medium'<BR>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 แล้ว<BR>2. ยอมรับ Privacy Policy แล้ว |
|
||||
| **Test Data** | Timestamp: Date.now() - 70,000 ms |
|
||||
| **Test Steps** | 1. จำลอง timestamp เก่าเกิน 60 วินาที<BR>2. เปิดแอป HRMS<BR>3. ขอรับพิกัด |
|
||||
| **Expected Result** | 1. mockIndicators = 2 (จาก stale timestamp)<BR>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 แล้ว<BR>2. ยอมรับ Privacy Policy แล้ว<BR>3. มีตำแหน่งเดิมใน history |
|
||||
| **Test Data** | Speed > 100 m/s |
|
||||
| **Test Steps** | 1. จำลองการเคลื่อนที่ด้วยความเร็ว > 100 m/s<BR>2. เปิดแอป HRMS |
|
||||
| **Expected Result** | 1. mockIndicators = 3 (จาก impossible speed)<BR>2. isMockDetected = true<BR>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 แล้ว<BR>2. ยอมรับ Privacy Policy แล้ว |
|
||||
| **Test Data** | Combined: invalid coordinates (0,0) + stale timestamp + impossible speed |
|
||||
| **Test Steps** | 1. จำลอง multiple mock indicators<BR>2. เปิดแอป HRMS |
|
||||
| **Expected Result** | 1. mockIndicators >= 5<BR>2. isMockDetected = true<BR>3. confidence = 'high'<BR>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 แล้ว<BR>2. ยอมรับ Privacy Policy แล้ว<BR>3. รับพิกัดสำเร็จแล้ว |
|
||||
| **Test Data** | Latitude: 13.7563, Longitude: 100.5018 (Sanam Suea Pa, Bangkok) |
|
||||
| **Test Steps** | 1. เปิดแอป HRMS<BR>2. รับพิกัด GPS<BR>3. รอให้ระบบแปลงพิกัดเป็นชื่อสถานที่ |
|
||||
| **Expected Result** | 1. เรียก Bangkok GIS API: `https://bmagis.bangkok.go.th/...`<BR>2. แสดงชื่อสถานที่ (POI name)<BR>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 แล้ว<BR>2. ยอมรับ Privacy Policy แล้ว<BR>3. Bangkok GIS API ล้มเหลว |
|
||||
| **Test Data** | Latitude: 13.7563, Longitude: 100.5018 |
|
||||
| **Test Steps** | 1. เปิดแอป HRMS<BR>2. รับพิกัด GPS<BR>3. จำลอง Bangkok GIS API fail<BR>4. รอ fallback ไป ArcGIS |
|
||||
| **Expected Result** | 1. เรียก ArcGIS API: `https://geocode.arcgis.com/...`<BR>2. แสดงชื่อสถานที่ (POI name)<BR>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 แล้ว<BR>2. ยอมรับ Privacy Policy แล้ว |
|
||||
| **Test Data** | - |
|
||||
| **Test Steps** | 1. เปิดแอป HRMS<BR>2. จำลองทั้งสอง API fail |
|
||||
| **Expected Result** | 1. แอปยังทำงานต่อไปได้<BR>2. แผนที่แสดงตำแหน่งแต่ไม่มีชื่อสถานที่<BR>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 แล้ว<BR>2. ยอมรับ Privacy Policy แล้ว<BR>3. รับพิกัดและชื่อสถานที่สำเร็จ<BR>4. ถ่ายรูปภาพแล้ว<BR>5. statusCheckin = true (เข้างาน) |
|
||||
| **Test Data** | workplace: 'in-place', locationName: '', POI: 'สนามเสือป่า', img: (รูปถ่าย) |
|
||||
| **Test Steps** | 1. เลือก "ในสถานที่"<BR>2. กด "ลงเวลาเข้างาน"<BR>3. ยืนยันการลงเวลา |
|
||||
| **Expected Result** | 1. API call: POST `/leave/check-in`<BR>2. formdata: { lat, lon, POI, isLocation: true, locationName: '', img, remark, checkInId }<BR>3. แสดง modal ลงเวลาเข้างานสำเร็จ<BR>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 แล้ว<BR>2. ยอมรับ Privacy Policy แล้ว<BR>3. รับพิกัดและชื่อสถานที่สำเร็จ<BR>4. ถ่ายรูปภาพแล้ว<BR>5. statusCheckin = true (เข้างาน) |
|
||||
| **Test Data** | workplace: 'off-site', locationName: 'ปฏิบัติงานที่บ้าน (WFH)', POI: 'บ้าน', img: (รูปถ่าย) |
|
||||
| **Test Steps** | 1. เลือก "นอกสถานที่"<BR>2. เลือก "ปฏิบัติงานที่บ้าน (WFH)"<BR>3. กด "ลงเวลาเข้างาน"<BR>4. ยืนยันการลงเวลา |
|
||||
| **Expected Result** | 1. API call: POST `/leave/check-in`<BR>2. formdata: { lat, lon, POI, isLocation: false, locationName: 'ปฏิบัติงานที่บ้าน (WFH)', img, remark, checkInId }<BR>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 แล้ว<BR>2. ยอมรับ Privacy Policy แล้ว<BR>3. เปิด Mock Location App |
|
||||
| **Test Data** | Mock location enabled |
|
||||
| **Test Steps** | 1. เปิด Mock Location App<BR>2. ตั้งค่าตำแหน่งปลอง<BR>3. เปิดแอป HRMS<BR>4. พยายามลงเวลาเข้างาน |
|
||||
| **Expected Result** | 1. แสดงข้อความ: "ตรวจพบว่าตำแหน่ง GPS อาจไม่ถูกต้อง..."<BR>2. isMockLocationDetected = true<BR>3. disabledBtn = true<BR>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 แล้ว<BR>2. ปฏิเสธ Location Permission |
|
||||
| **Test Data** | - |
|
||||
| **Test Steps** | 1. เปิดแอป HRMS<BR>2. ปฏิเสธ Location Permission<BR>3. พยายามลงเวลาเข้างาน |
|
||||
| **Expected Result** | 1. locationGranted = false<BR>2. ปุ่มลงเวลาเข้า/ออก disabled<BR>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 แล้ว<BR>2. ยอมรับ Privacy Policy แล้ว<BR>3. เคยลงเวลาเข้างานแล้ว<BR>4. statusCheckin = false (ออกงาน) |
|
||||
| **Test Data** | POI: 'Office', img: (รูปถ่าย) |
|
||||
| **Test Steps** | 1. เปิดแอป HRMS<BR>2. ถ่ายรูปภาพ<BR>3. กด "ลงเวลาออกงาน" |
|
||||
| **Expected Result** | 1. API call: POST `/leave/check-in` (with checkInId)<BR>2. แสดง modal ลงเวลาออกงานสำเร็จ<BR>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 แล้ว<BR>2. ยอมรับ Privacy Policy แล้ว<BR>3. เคยลงเวลาเข้างานแล้ว<BR>4. เปิด Mock Location App |
|
||||
| **Test Data** | Mock location enabled |
|
||||
| **Test Steps** | 1. เปิด Mock Location App<BR>2. พยายามลงเวลาออกงาน |
|
||||
| **Expected Result** | 1. แสดงข้อความ: "ตรวจพบว่าตำแหน่ง GPS อาจไม่ถูกต้อง..."<BR>2. disabledBtn = true<BR>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 แล้ว<BR>2. ยอมรับ Privacy Policy แล้ว<BR>3. รับพิกัดสำเร็จ |
|
||||
| **Test Data** | POI: 'Meeting Room', img: (รูปถ่าย) |
|
||||
| **Test Steps** | 1. เปิดแอป HRMS<BR>2. ไปที่หน้าบันทึกเวลาพิเศษ<BR>3. กรอกข้อมูล<BR>4. บันทึก |
|
||||
| **Expected Result** | 1. บันทึกเวลาพิเศษสำเร็จ<BR>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 แล้ว<BR>2. ปฏิเสธ Location Permission |
|
||||
| **Test Data** | - |
|
||||
| **Test Steps** | 1. เปิดแอป HRMS<BR>2. ปฏิเสธ Location Permission<BR>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. เปิดแอปครั้งแรก<BR>2. ยังไม่ยอมรับ Privacy Policy |
|
||||
| **Test Data** | - |
|
||||
| **Test Steps** | 1. เปิดแอป HRMS<BR>2. กดปุ่มที่ต้องการ Location (แผนที่/กล้อง) |
|
||||
| **Expected Result** | 1. privacyStore.modalPrivacy = true<BR>2. แสดง Privacy Modal<BR>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. เปิดแอปครั้งแรก<BR>2. Privacy Modal แสดงขึ้นมา |
|
||||
| **Test Data** | - |
|
||||
| **Test Steps** | 1. เปิดแอป HRMS<BR>2. แสดง Privacy Modal<BR>3. กด "ยอมรับ" |
|
||||
| **Expected Result** | 1. privacyStore.isAccepted = true<BR>2. privacyStore.modalPrivacy = false<BR>3. สามารถใช้งาน Location ได้<BR>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. เปิดแอปครั้งแรก<BR>2. Privacy Modal แสดงขึ้นมา |
|
||||
| **Test Data** | - |
|
||||
| **Test Steps** | 1. เปิดแอป HRMS<BR>2. แสดง Privacy Modal<BR>3. กด "ปฏิเสธ" หรือปิด Modal |
|
||||
| **Expected Result** | 1. privacyStore.isAccepted = false<BR>2. privacyStore.modalPrivacy = false<BR>3. ไม่สามารถใช้งาน Location ได้<BR>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 | | | |
|
||||
1026
docs/test-steps-location.md
Normal file
1026
docs/test-steps-location.md
Normal file
File diff suppressed because it is too large
Load diff
Loading…
Add table
Add a link
Reference in a new issue