Initial commit

docs/fleetmanager/RobotConnections.md

@@ -0,0 +1,68 @@
+# RobotConnections Module / Module Kết nối Robot
+
+## 📋 Overview / Tổng quan
+
+RobotConnections Module quản lý kết nối MQTT của các robot theo VDA 5050, đảm bảo giao tiếp ổn định giữa FleetManager và RobotApp.
+
+## 🎯 Mục đích / Purpose
+
+Quản lý kết nối MQTT của các robot theo VDA 5050 để đảm bảo giao tiếp ổn định và real-time.
+
+## ⚠️ Lưu ý / Important Note
+
+**MQTT Broker chạy trên service ngoài FleetManager** (không phải trong FleetManager).
+
+## 🔧 Chức năng chính / Main Features
+
+- Quản lý MQTT connection status của từng robot
+- Subscribe/unsubscribe MQTT topics theo VDA 5050
+- Connection timeout và reconnection logic
+- Heartbeat mechanism (qua VDA 5050 connection messages)
+- Thông báo cho RobotManager khi robot disconnect/reconnect
+
+## 📡 MQTT Topics Management / Quản lý MQTT Topics
+
+```mermaid
+graph TB
+    subgraph "Subscribed Topics<br/>Robot → FleetManager"
+        StateTopic[uagv/v2/{manufacturer}/+/state<br/>QoS: 0, Retain: true]
+        VizTopic[uagv/v2/{manufacturer}/+/visualization<br/>QoS: 0, Retain: false]
+        ConnTopic[uagv/v2/{manufacturer}/+/connection<br/>QoS: 1, Retain: true]
+    end
+    
+    subgraph "Published Topics<br/>FleetManager → Robot"
+        OrderTopic[uagv/v2/{manufacturer}/{serialNumber}/order<br/>QoS: 1, Retain: false]
+        InstantTopic[uagv/v2/{manufacturer}/{serialNumber}/instantActions<br/>QoS: 1, Retain: false]
+    end
+    
+    RobotConnections[RobotConnections Module] --> StateTopic
+    RobotConnections --> VizTopic
+    RobotConnections --> ConnTopic
+    RobotConnections --> OrderTopic
+    RobotConnections --> InstantTopic
+    
+    style RobotConnections fill:#e6f3ff
+```
+
+## 🔌 Connection States / Trạng thái Kết nối
+
+- **ONLINE**: Robot connected và operational
+- **OFFLINE**: Robot disconnected
+- **CONNECTIONBROKEN**: Connection lost unexpectedly
+
+## ✨ Features / Tính năng
+
+- Không lưu connection history (chỉ quản lý state hiện tại)
+- Auto-reconnection logic khi connection lost
+- Notify RobotManager về connection status changes
+
+## 🔗 Related Documents / Tài liệu Liên quan
+
+- [FleetManager Overview](README.md) - Tổng quan FleetManager
+- [RobotManager Module](RobotManager.md) - Nhận thông báo từ RobotConnections
+- [VDA 5050 Integration](../vda5050/README.md) - Chi tiết về VDA 5050 protocol
+
+---
+
+**Last Updated**: 2025-11-13
+