Initial commit

docs/ScriptEngine/ScriptFiles.md

@@ -0,0 +1,48 @@
+# Script Files / File Script
+
+## 📋 Overview / Tổng quan
+
+ScriptEngine hỗ trợ multi-file C# scripts, cho phép tổ chức code như một C# project thực sự.
+
+## 📁 File Organization / Tổ chức File
+
+Scripts được tổ chức như C# project:
+
+```
+Scripts/
+├── Common/
+│   ├── Helpers.cs          # Shared helper methods
+│   └── Constants.cs        # Global constants
+├── Tasks/
+│   ├── MonitorTask.cs      # Periodic monitoring
+│   └── MaintenanceTask.cs  # Periodic maintenance
+└── Missions/
+    ├── DeliverMission.cs   # Delivery workflow
+    └── ChargeMission.cs    # Charging workflow
+```
+
+## ✨ Đặc điểm / Features
+
+- **Multi-file support**: Files share variables & methods
+- **Top-level statements**: Allowed trong C# scripts
+- **Class definitions**: Can define classes, structs, enums
+- **Using directives**: Supported for namespaces
+- **File system storage**: Scripts lưu trong file system
+- **Backup & Restore**: ZIP format với preserved structure
+
+## 🔒 File Locking / Khóa File
+
+- SignalR-based file locking
+- Khi user đang edit, các session khác không được sửa file
+- ScriptEngine quản lý trạng thái cho phép chỉnh sửa hay không
+- Không có realtime update file content, chỉ khi user gọi action Save mới gửi lên server
+
+## 🔗 Related Documents / Tài liệu Liên quan
+
+- [ScriptEngine Overview](README.md) - Tổng quan ScriptEngine
+- [Backup & Restore](DataPersistence.md#backup--restore) - Sao lưu và khôi phục scripts
+
+---
+
+**Last Updated**: 2025-11-13
+