Initial commit

docs/fleetmanager/RobotManager.md

@@ -0,0 +1,87 @@
+# RobotManager Module / Module Quản lý Robot
+
+## 📋 Overview / Tổng quan
+
+RobotManager Module quản lý state, order, và action của robots, cung cấp APIs cho các module khác và ScriptEngine.
+
+## 🎯 Mục đích / Purpose
+
+Quản lý toàn bộ thông tin về robots bao gồm state hiện tại, orders đang thực hiện, và actions.
+
+## 🔧 Chức năng chính / Main Features
+
+### 1. State Management / Quản lý Trạng thái
+
+- Quản lý state mới nhất mà robot gửi lên (không lưu history)
+- Cập nhật state real-time từ VDA 5050 state messages
+- Expose state cho các module khác (TrafficControl, ScriptEngine)
+
+### 2. Order Management / Quản lý Order
+
+- Quản lý orders đã yêu cầu xuống robot
+- Quản lý orders đang thực hiện
+- Order timeout handling → order failed
+- Quản lý order theo từng robot
+
+### 3. Action Management / Quản lý Action
+
+- Quản lý instant actions đã gửi
+- Quản lý actions đang thực hiện
+- Track action status
+
+## ⏱️ Order Timeout Handling / Xử lý Timeout Order
+
+```mermaid
+flowchart TD
+    Start[Robot has active order] --> CheckConnection{Robot<br/>connected?}
+    
+    CheckConnection -->|Yes| UpdateState[Update state from<br/>VDA 5050 messages]
+    CheckConnection -->|No| CheckTimeout{Last state<br/>timeout?}
+    
+    UpdateState --> HasOrder{Order still<br/>active?}
+    HasOrder -->|Yes| Continue[Continue monitoring]
+    HasOrder -->|No| Completed[Order completed]
+    
+    CheckTimeout -->|Yes| OrderFailed[Order failed<br/>Notify modules]
+    CheckTimeout -->|No| Wait[Wait for reconnect]
+    
+    style OrderFailed fill:#ffe6e6
+    style Completed fill:#e6ffe6
+```
+
+## 🔌 APIs cho ScriptEngine
+
+RobotManager expose các APIs cho ScriptEngine thông qua `FleetScriptGlobals`:
+
+- `GetRobotById(string robotId)`: Lấy thông tin robot
+- `GetRobotBySerial(string serialNumber)`: Lấy robot theo serial number
+- `GetAvailableRobots()`: Lấy danh sách robot available
+- `GetRobotState(string robotSerial)`: Lấy state hiện tại của robot
+- `MoveToNode(string robotSerial, string nodeId)`: Tạo order di chuyển đến node
+- `MoveToStation(string robotSerial, string stationId)`: Tạo order di chuyển đến station
+
+## 🔗 Integration với RobotConnections
+
+- Nhận thông báo từ RobotConnections về connection status
+- Xử lý order timeout dựa trên connection status và last state timestamp
+
+## 📡 VDA 5050 Protocol Handler
+
+RobotManager cũng xử lý VDA 5050 protocol:
+- Order Generation: Tạo VDA 5050 orders từ TrafficControl
+- Order Updates: Tạo OrderUpdate khi TrafficControl yêu cầu
+- State Processing: Xử lý state messages từ robots
+- Action Generation: Tạo instant actions
+
+## 🔗 Related Documents / Tài liệu Liên quan
+
+- [FleetManager Overview](README.md) - Tổng quan FleetManager
+- [RobotConnections Module](RobotConnections.md) - Cung cấp connection status
+- [TrafficControl Module](TrafficControl.md) - Sử dụng RobotManager để check robot state
+- [ScriptEngine Module](ScriptEngine.md) - Sử dụng RobotManager APIs
+- [VDA 5050 Integration](../vda5050/README.md) - Chi tiết về VDA 5050 protocol
+
+---
+
+**Last Updated**: 2025-11-13
+