Initial commit

docs/ScriptEngine/ExtensionAPIs.md

@@ -0,0 +1,117 @@
+# Extension APIs / API Mở rộng
+
+## 📋 Overview / Tổng quan
+
+Apps implement `IScriptResource` interface để expose custom APIs cho scripts.
+
+## 🔌 IScriptResource Interface
+
+```mermaid
+classDiagram
+    class IScriptResource {
+        <<interface>>
+        +Type AppGlobalType
+        +GetTaskGlobals() IDictionary
+        +GetMissionGlobals(id, ct) IDictionary
+        +UsingNamespaces ImmutableArray~string~
+        +Modules ImmutableArray~string~
+    }
+
+    class RobotScriptResource {
+        +AppGlobalType: typeof(RobotGlobals)
+        +GetTaskGlobals()
+        +GetMissionGlobals()
+    }
+
+    class FleetScriptResource {
+        +AppGlobalType: typeof(FleetGlobals)
+        +GetTaskGlobals()
+        +GetMissionGlobals()
+    }
+
+    class RobotGlobals {
+        +MoveTo(x, y) Task
+        +GetBatteryLevel() double
+        +IsMoving() bool
+    }
+
+    class FleetGlobals {
+        +GetAvailableRobots() List~Robot~
+        +SendOrder(serial, order) Task
+        +GetRobotState(serial) RobotState
+    }
+
+    IScriptResource <|-- RobotScriptResource
+    IScriptResource <|-- FleetScriptResource
+    RobotScriptResource ..> RobotGlobals: exposes
+    FleetScriptResource ..> FleetGlobals: exposes
+```
+
+## 🤖 RobotApp Example
+
+**Define AppGlobalType**:
+```csharp
+public class RobotScriptGlobals
+{
+    public Task MoveTo(double x, double y) { }
+    public double GetBatteryLevel() { }
+    public bool IsMoving() { }
+}
+```
+
+**Use in Script**:
+```csharp
+[Task(Interval = 5000)]
+public async Task CheckBattery()
+{
+    var level = Robot.GetBatteryLevel();
+    Logger.Info($"Battery: {level}%");
+
+    if (level < 20.0)
+    {
+        await Robot.MoveTo(0, 0); // Home position
+    }
+}
+```
+
+## 🏭 FleetManager Example
+
+**Define AppGlobalType**:
+```csharp
+public class FleetScriptGlobals
+{
+    public List<Robot> GetAvailableRobots() { }
+    public Task SendOrder(string robotSerial, Order order) { }
+    public RobotState GetRobotState(string robotSerial) { }
+    public Task MoveToNode(string robotSerial, string nodeId) { }
+    public Task MoveToStation(string robotSerial, string stationId) { }
+}
+```
+
+**Use in Script**:
+```csharp
+[Task(Interval = 10000)]
+public void MonitorFleet()
+{
+    var robots = Fleet.GetAvailableRobots();
+    foreach (var robot in robots)
+    {
+        var state = Fleet.GetRobotState(robot.SerialNumber);
+        if (state?.BatteryCharge < 20.0)
+        {
+            Logger.Warning($"Robot {robot.SerialNumber} low battery");
+        }
+    }
+}
+```
+
+## 🔗 Related Documents / Tài liệu Liên quan
+
+- [ScriptEngine Overview](README.md) - Tổng quan ScriptEngine
+- [FleetManager ScriptEngine Module](../fleetmanager/ScriptEngine.md) - FleetManager implementation
+- [RobotApp Documentation](../robotapp/README.md) - RobotApp implementation
+
+---
+
+**Last Updated**: 2025-11-13
+