Ducdata1808 commited on
Commit
573ee57
·
1 Parent(s): e039c53

feat: complete simulator, add Qwen Cloud support, add tests and CI configuration

Browse files
.github/workflows/ci.yml ADDED
@@ -0,0 +1,42 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ name: VDA5050 Simulator CI
2
+
3
+ on:
4
+ push:
5
+ branches: [ main, master ]
6
+ pull_request:
7
+ branches: [ main, master ]
8
+
9
+ jobs:
10
+ test:
11
+ runs-on: ubuntu-latest
12
+
13
+ steps:
14
+ - name: Checkout Code
15
+ uses: actions/checkout@v4
16
+
17
+ - name: Set up Python
18
+ uses: actions/setup-python@v5
19
+ with:
20
+ python-version: '3.11'
21
+ cache: 'pip'
22
+
23
+ - name: Install Dependencies
24
+ run: |
25
+ python -m pip install --upgrade pip
26
+ pip install -r requirements.txt
27
+
28
+ - name: Run Tests
29
+ run: |
30
+ python -m unittest discover -s tests -p "test_*.py"
31
+
32
+ docker-build:
33
+ runs-on: ubuntu-latest
34
+ needs: test
35
+
36
+ steps:
37
+ - name: Checkout Code
38
+ uses: actions/checkout@v4
39
+
40
+ - name: Build Docker Image (Dry Run)
41
+ run: |
42
+ docker build -t vda5050-robot-simulator:test .
report.md CHANGED
@@ -20,23 +20,21 @@ Quy trình trao đổi dữ liệu tuân thủ nghiêm ngặt chuẩn **VDA 5050
20
 
21
  ---
22
 
23
- # Scenarios
24
 
25
- ## Scenario 1: Level 1 basic
26
- * **Mô tả**: Kịch bản cơ bản nhất gồm 1 xe AGV thực hiện vận chuyển đơn lẻ. Xe phải di chuyển từ vị trí xuất phát để nhận kiện hàng tại điểm lấy hàng và chuyển giao tới điểm đích được chỉ định trên sơ đồ phẳng không có vật cản phức tạp.
27
- * **Kỳ vọng**: Xe đi đúng hành trình ngắn nhất, thực hiện đúng các tác vụ lấy hàng/dỡ hàng tuần tự, dừng lại chính xác tại điểm đích và hoàn thành nhiệm vụ an toàn.
28
 
29
- ## Scenario 2: Level 2 intermediate
30
- * **Mô tả**: Kịch bản tăng độ khó bằng cách bổ sung thêm vật cản tĩnh (`obstacles`) nằm trực diện trên đường nối trực tiếp giữa các điểm trạm, hoặc xe xuất phát với mức pin yếu buộc hệ thống phải tự đưa ra quyết định di chuyển đi sạc trước khi thực hiện đơn hàng.
31
- * **Kỳ vọng**: Xe biết đi đường vòng qua các lối đi thay thế để tránh đâm vào vật cản trung tâm, hoặc chủ động ghé qua trạm sạc điện cho đến khi mức pin an toàn rồi mới tiếp tục đi lấy hàng.
32
 
33
- ## Scenario 3: Level 3 advanced
34
- * **Mô tả**: Kịch bản điều phối đa xe (2 xe AGV trở lên) hoạt động đồng thời. Lộ trình di chuyển của các xe có các điểm giao cắt hoặc đi ngược chiều nhau trên các hành lang hẹp, tạo ra rủi ro va chạm trực tiếp.
35
- * **Kỳ vọng**: Trung tâm điều phối phải tính toán giãn cách thời gian di chuyển hoặc điều hướng một xe đi đường tránh để nhường đường cho xe còn lại, đảm bảo không xảy ra va chạm giữa các xe.
36
 
37
- ## Scenario 4: Level 4 expert
38
- * **Mô tả**: Kịch bản phức tạp nhất gồm nhiều xe vận hành đồng thời trong không gian hẹp với mật độ yêu cầu vận chuyển dày đặc, dễ xảy ra tình trạng khóa lẫn nhau (Deadlock).
39
- * **Kỳ vọng**: Mô hình phải tối ưu hóa thứ tự ưu tiên của các xe, phân luồng giao thông động thông minh để giải quyết deadlock và hoàn thành toàn bộ yêu cầu vận chuyển trong thời gian tối thiểu.
40
 
41
  ---
42
 
@@ -49,7 +47,7 @@ Bản đồ **`simple_warehouse`** có kích thước thực tế là **60m x 50
49
 
50
  ---
51
 
52
- ## Scenario 1 (Single AGV - Simple Pickup and Delivery)
53
  **Yêu cầu**: Xe `AGV_01` (xuất phát từ `DOCK_A`) cần lấy hàng tại `DOCK_A` và giao đến `SHELF_B1`.
54
 
55
  | Metric / Model | Gemini 2.5 Flash | Qwen Max (Cloud) | Llama 3.3 70B (Groq) | GPT-OSS 20B (Groq) | Llama 3.1 8B (Groq) |
@@ -66,7 +64,7 @@ Bản đồ **`simple_warehouse`** có kích thước thực tế là **60m x 50
66
 
67
  ---
68
 
69
- ## Scenario 2 (Single AGV - Sequential Deliveries)
70
  **Yêu cầu**: Xe `AGV_01` thực hiện liên tiếp 2 đơn hàng: Nhận hàng tại `DOCK_A` giao tới `SHELF_B1`, sau đó nhận hàng tại `DOCK_B` giao tới `SHELF_B2`.
71
 
72
  | Metric / Model | Gemini 2.5 Flash | Qwen Max (Cloud) | Llama 3.3 70B (Groq) | GPT-OSS 20B (Groq) | Llama 3.1 8B (Groq) |
@@ -83,8 +81,8 @@ Bản đồ **`simple_warehouse`** có kích thước thực tế là **60m x 50
83
 
84
  ---
85
 
86
- ## Scenario 3 (Single AGV - Obstacle Avoidance)
87
- **Yêu cầu**: Xe `AGV_01` cần nhận hàng tại `DOCK_A` và chuyển đến `DOCK_B` trong điều kiện có bức tường `WALL_CENTER` chắn đường trực tiếp.
88
 
89
  | Metric / Model | Gemini 2.5 Flash | Qwen Max (Cloud) | Llama 3.3 70B (Groq) | GPT-OSS 20B (Groq) | Llama 3.1 8B (Groq) |
90
  | :--- | :---: | :---: | :---: | :---: | :---: |
@@ -96,15 +94,15 @@ Bản đồ **`simple_warehouse`** có kích thước thực tế là **60m x 50
96
 
97
  ### Ghi chú lỗi (Notes on Failed Models):
98
  * **Gemini 2.5 Flash**: Thất bại do quá thời gian kịch bản (`timeout`). Lộ trình lập đúng đi vòng qua vật cản trung tâm và pin hoàn toàn khỏe mạnh (còn 82%), tuy nhiên do mô hình sinh quá nhiều Node/Edge dư thừa lặp lại khiến xe di chuyển lòng vòng không dừng trước khi hết 90 giây giới hạn kịch bản.
99
- * **Qwen Max (Cloud)**: Thất bại do va chạm (`collision`). Tương tự như Llama 3.3 70B, mô hình cố gắng lập lộ trình đi thẳng cắt qua rìa của `WALL_CENTER` dẫn đến đâm vào vật cản ở giây thứ 19.70.
100
  * **Llama 3.3 70B (Groq)**: Thất bại do va chạm (`collision`). Mô hình cố gắng cắt góc đi sát ranh giới của `WALL_CENTER` dẫn đến va chạm.
101
  * **GPT-OSS 20B (Groq)**: Thất bại do lỗi sinh cấu trúc lộ trình VDA 5050.
102
  * **Llama 3.1 8B (Groq)**: Thất bại do va chạm với bức tường trung tâm.
103
 
104
  ---
105
 
106
- ## Scenario 4 (Single AGV - Low Battery Charging)
107
- **Yêu cầu**: Xe `AGV_01` xuất phát với mức pin thấp, cần tự tính toán ghé vào `CHARGING_ZONE` để sạc pin trước khi thực hiện đơn hàng giao từ `DOCK_B` đến `SHELF_B1`.
108
 
109
  | Metric / Model | Gemini 2.5 Flash | Qwen Max (Cloud) | Llama 3.3 70B (Groq) | GPT-OSS 20B (Groq) | Llama 3.1 8B (Groq) |
110
  | :--- | :---: | :---: | :---: | :---: | :---: |
@@ -119,9 +117,48 @@ Bản đồ **`simple_warehouse`** có kích thước thực tế là **60m x 50
119
  * **Llama 3.3 70B (Groq)**: Thất bại do cạn pin giữa đường. Mô hình chưa tối ưu hóa việc điều phối ghé trạm sạc kịp thời hoặc lộ trình sinh ra quá dài.
120
  * **GPT-OSS 20B & Llama 3.1 8B**: Thất bại do lỗi sinh cấu trúc chỉ thị không hợp lệ.
121
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
122
  # Các mục tiêu tiếp theo
123
  - Thử nghiệm thêm các models có lượng tham số lớn hơn
124
  - Thử nghiệm thêm các layout có độ khó cao hơn
125
  - Thử nghiệm thêm các scenario có độ khó cao hơn
126
  - Sử dụng các biện pháp để dùng chung cho các APIs, tránh phải viết adapter cho từng cái
127
- - Tiềm kiếm và thử nghiệm được các cases xuất hiện trong thực tế
 
 
20
 
21
  ---
22
 
23
+ # Các Cấp Độ Kịch Bản (Scenarios Levels)
24
 
25
+ ## Level 1: Basic
26
+ * **Scenario 001 (Simple Pickup and Delivery)**: 1 xe AGV di chuyển từ vị trí xuất phát để nhận kiện hàng tại điểm lấy hàng và chuyển giao tới điểm đích trên sơ đồ phẳng không có vật cản phức tạp. Pin xe khởi điểm ở mức cao (100%).
27
+ * **Scenario 002 (Sequential Deliveries)**: 1 xe AGV thực hiện chuỗi nhiều đơn hàng nhận và giao tuần tự qua các trạm khác nhau trên sơ đồ trống để thử nghiệm khả năng duy trì trạng thái hàng đợi chỉ thị của model.
28
 
29
+ ## Level 2: Intermediate
30
+ * **Scenario 010 (Obstacle Avoidance)**: 1 xe AGV cần di chuyển qua khu vực có chứa vật cản tĩnh lớn nằm chắn trực diện trên lối đi để kiểm thử khả năng tìm đường vòng tránh của mô hình.
31
+ * **Scenario 012 (Low Battery Charging)**: 1 xe AGV xuất phát với mức pin yếu (40%), bắt buộc mô hình phải tự nhận biết dung lượng pin để điều hướng xe đến vùng sạc pin trước khi thực hiện đơn hàng.
32
 
33
+ ## Level 3: Advanced
34
+ * **Scenario 020 (Multi-AGV Junction Conflict)**: Điều phối từ 2 xe AGV hoạt động đồng thời ngược chiều nhau trên các đoạn đường hẹp, bắt buộc mô hình phải tính toán thời gian hoặc đổi hướng một xe để tránh va chạm chéo tại giao lộ.
 
35
 
36
+ ## Level 4: Expert
37
+ * **Scenario 030 (Multi-AGV Deadlock Resolution)**: Nhiều xe vận hành đồng thời trong không gian hẹp với mật độ yêu cầu dày đặc, đòi hỏi mô hình phải lập lộ trình phân luồng khôn ngoan để giải quyết nguy cơ kẹt xe (deadlock).
 
38
 
39
  ---
40
 
 
47
 
48
  ---
49
 
50
+ ## Level 1 - Scenario 001 (Simple Pickup and Delivery)
51
  **Yêu cầu**: Xe `AGV_01` (xuất phát từ `DOCK_A`) cần lấy hàng tại `DOCK_A` và giao đến `SHELF_B1`.
52
 
53
  | Metric / Model | Gemini 2.5 Flash | Qwen Max (Cloud) | Llama 3.3 70B (Groq) | GPT-OSS 20B (Groq) | Llama 3.1 8B (Groq) |
 
64
 
65
  ---
66
 
67
+ ## Level 1 - Scenario 002 (Sequential Deliveries)
68
  **Yêu cầu**: Xe `AGV_01` thực hiện liên tiếp 2 đơn hàng: Nhận hàng tại `DOCK_A` giao tới `SHELF_B1`, sau đó nhận hàng tại `DOCK_B` giao tới `SHELF_B2`.
69
 
70
  | Metric / Model | Gemini 2.5 Flash | Qwen Max (Cloud) | Llama 3.3 70B (Groq) | GPT-OSS 20B (Groq) | Llama 3.1 8B (Groq) |
 
81
 
82
  ---
83
 
84
+ ## Level 2 - Scenario 010 (Obstacle Avoidance)
85
+ **Yêu cầu**: Xe `AGV_01` cần nhận hàng tại `DOCK_A` và chuyển đến `DOCK_B` trong điều kiện có bức tường `WALL_CENTER` chắn đường trực tiếp (Pin khởi điểm 100%).
86
 
87
  | Metric / Model | Gemini 2.5 Flash | Qwen Max (Cloud) | Llama 3.3 70B (Groq) | GPT-OSS 20B (Groq) | Llama 3.1 8B (Groq) |
88
  | :--- | :---: | :---: | :---: | :---: | :---: |
 
94
 
95
  ### Ghi chú lỗi (Notes on Failed Models):
96
  * **Gemini 2.5 Flash**: Thất bại do quá thời gian kịch bản (`timeout`). Lộ trình lập đúng đi vòng qua vật cản trung tâm và pin hoàn toàn khỏe mạnh (còn 82%), tuy nhiên do mô hình sinh quá nhiều Node/Edge dư thừa lặp lại khiến xe di chuyển lòng vòng không dừng trước khi hết 90 giây giới hạn kịch bản.
97
+ * **Qwen Max (Cloud)**: Thất bại do va chạm (`collision`). Mô hình cố gắng lập lộ trình đi thẳng cắt qua rìa của `WALL_CENTER` dẫn đến đâm vào vật cản ở giây thứ 19.70.
98
  * **Llama 3.3 70B (Groq)**: Thất bại do va chạm (`collision`). Mô hình cố gắng cắt góc đi sát ranh giới của `WALL_CENTER` dẫn đến va chạm.
99
  * **GPT-OSS 20B (Groq)**: Thất bại do lỗi sinh cấu trúc lộ trình VDA 5050.
100
  * **Llama 3.1 8B (Groq)**: Thất bại do va chạm với bức tường trung tâm.
101
 
102
  ---
103
 
104
+ ## Level 2 - Scenario 012 (Low Battery Charging)
105
+ **Yêu cầu**: Xe `AGV_01` xuất phát với mức pin thấp (40%), cần tự tính toán ghé vào `CHARGING_ZONE` để sạc pin trước khi thực hiện đơn hàng giao từ `DOCK_B` đến `SHELF_B1`.
106
 
107
  | Metric / Model | Gemini 2.5 Flash | Qwen Max (Cloud) | Llama 3.3 70B (Groq) | GPT-OSS 20B (Groq) | Llama 3.1 8B (Groq) |
108
  | :--- | :---: | :---: | :---: | :---: | :---: |
 
117
  * **Llama 3.3 70B (Groq)**: Thất bại do cạn pin giữa đường. Mô hình chưa tối ưu hóa việc điều phối ghé trạm sạc kịp thời hoặc lộ trình sinh ra quá dài.
118
  * **GPT-OSS 20B & Llama 3.1 8B**: Thất bại do lỗi sinh cấu trúc chỉ thị không hợp lệ.
119
 
120
+ ---
121
+
122
+ ## Level 3 - Scenario 020 (Multi-AGV Junction Conflict)
123
+ **Yêu cầu**: Điều phối 2 xe AGV tránh đụng nhau tại giao lộ. Xe `AGV_01` giao hàng từ `DOCK_A` đến `SHELF_B2`. Xe `AGV_02` giao hàng từ `SHELF_B2` đến `DOCK_A`. Lộ trình đi chéo của hai xe giao cắt trực tiếp tại khu vực hành lang hẹp trung tâm.
124
+
125
+ | Metric / Model | Gemini 2.5 Flash | Qwen Max (Cloud) | Llama 3.3 70B (Groq) |
126
+ | :--- | :---: | :---: | :---: |
127
+ | **Trạng thái chạy** | **SUCCESS** | **SUCCESS** | **SUCCESS** |
128
+ | **Độ trễ API (ms)** | ~17845.8 | ~14678.0 | ~2430.0 |
129
+ | **Thời gian mô phỏng (s)**| 60.45 | 60.45 | 60.45 |
130
+ | **Số vụ va chạm** | 0 | 0 | 0 |
131
+ | **Pin AGV_01 (%)** | 78.36% | 78.36% | 78.36% |
132
+ | **Pin AGV_02 (%)** | 73.36% | 73.36% | 73.36% |
133
+
134
+ ### Ghi chú phân tích kịch bản:
135
+ * Cả 3 mô hình lớn **Gemini 2.5 Flash**, **Qwen Max** và **Llama 3.3 70B** đều hoàn thành kịch bản xuất sắc nhờ việc lập hành trình phân tách nhịp nhàng. Hai xe đi qua điểm giao cắt lệch thời gian nên không hề xảy ra va chạm.
136
+
137
+ ---
138
+
139
+ ## Level 4 - Scenario 030 (Multi-AGV Deadlock Resolution)
140
+ **Yêu cầu**: 3 xe AGV (`AGV_01`, `AGV_02`, `AGV_03`) hoạt động đồng thời tại các khu vực đường hẹp đan xen, với 3 yêu cầu vận tải độc lập diễn ra cùng lúc.
141
+
142
+ | Metric / Model | Gemini 2.5 Flash | Qwen Max (Cloud) | Llama 3.3 70B (Groq) |
143
+ | :--- | :---: | :---: | :---: |
144
+ | **Trạng thái chạy** | **SUCCESS** | **FAILED** | **FAILED** |
145
+ | **Độ trễ API (ms)** | ~31766.8 | ~13309.0 | ~3400.0 |
146
+ | **Thời gian mô phỏng (s)**| 85.40 | 9.70 | 6.20 |
147
+ | **Số vụ va chạm** | 0 | 1 | 1 |
148
+ | **Pin AGV_01 (%)** | 93.35% | 98.08% | 98.80% |
149
+ | **Pin AGV_02 (%)** | 85.04% | 98.08% | 98.80% |
150
+ | **Pin AGV_03 (%)** | 83.37% | 100.00% | 98.80% |
151
+
152
+ ### Ghi chú lỗi (Notes on Failed Models):
153
+ * **Qwen Max (Cloud)**: Thất bại do lỗi lập lộ trình trống cho xe `AGV_03` ("Warning - Accepted order has no nodes"), dẫn đến xe này đứng im tại chỗ cản đường và bị 2 xe còn lại đâm vào ở giây thứ 9.70.
154
+ * **Llama 3.3 70B (Groq)**: Thất bại do lỗi va chạm giao lộ hẹp ở giây thứ 6.20 vì không phân luồng xe đi vòng.
155
+
156
+ ---
157
+
158
  # Các mục tiêu tiếp theo
159
  - Thử nghiệm thêm các models có lượng tham số lớn hơn
160
  - Thử nghiệm thêm các layout có độ khó cao hơn
161
  - Thử nghiệm thêm các scenario có độ khó cao hơn
162
  - Sử dụng các biện pháp để dùng chung cho các APIs, tránh phải viết adapter cho từng cái
163
+ - Tìm kiếm và thử nghiệm được các cases xuất hiện trong thực tế
164
+ - Bổ sung câu lệnh can thiệp từ người dùng khi xe đang chạy
requirements.txt CHANGED
@@ -5,3 +5,6 @@ google-genai
5
  python-dotenv
6
  fastapi
7
  uvicorn
 
 
 
 
5
  python-dotenv
6
  fastapi
7
  uvicorn
8
+ requests
9
+ pytest
10
+
tests/test_simulator.py ADDED
@@ -0,0 +1,53 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ import os
2
+ import json
3
+ import unittest
4
+ from utils import get_distance, iterate_position
5
+ from config import get_config
6
+
7
+ class TestSimulator(unittest.TestCase):
8
+ def test_distance_calculation(self):
9
+ # Test distance formula
10
+ dist = get_distance(0, 0, 3, 4)
11
+ self.assertEqual(dist, 5.0)
12
+
13
+ def test_iterate_position(self):
14
+ # Test incremental movement step towards a target
15
+ # Moving from (0, 0) to (10, 0) with step size (speed) = 2.0
16
+ new_x, new_y, theta = iterate_position(0.0, 0.0, 10.0, 0.0, 2.0)
17
+ self.assertEqual(new_x, 2.0)
18
+ self.assertEqual(new_y, 0.0)
19
+ self.assertEqual(theta, 0.0)
20
+
21
+ def test_load_layout_files(self):
22
+ # Verify that layouts exist and are valid JSON
23
+ layouts_dir = "factory_layouts"
24
+ self.assertTrue(os.path.exists(layouts_dir))
25
+ layout_files = [f for f in os.listdir(layouts_dir) if f.endswith(".json")]
26
+ self.assertGreater(len(layout_files), 0)
27
+
28
+ for file_name in layout_files:
29
+ with open(os.path.join(layouts_dir, file_name), "r", encoding="utf-8") as f:
30
+ data = json.load(f)
31
+ self.assertIn("layout_id", data)
32
+ self.assertIn("nodes", data)
33
+ self.assertIn("edges", data)
34
+
35
+ def test_load_scenario_files(self):
36
+ # Verify that scenarios exist and are valid JSON
37
+ scenarios_dir = "scenarios"
38
+ self.assertTrue(os.path.exists(scenarios_dir))
39
+
40
+ found_scenarios = 0
41
+ for root, dirs, files in os.walk(scenarios_dir):
42
+ for file in files:
43
+ if file.endswith(".json"):
44
+ found_scenarios += 1
45
+ with open(os.path.join(root, file), "r", encoding="utf-8") as f:
46
+ data = json.load(f)
47
+ self.assertIn("scenario_id", data)
48
+ self.assertIn("factory_layout", data)
49
+ self.assertIn("agvs", data)
50
+ self.assertGreater(found_scenarios, 0)
51
+
52
+ if __name__ == "__main__":
53
+ unittest.main()