75 lines
2.5 KiB
Markdown
75 lines
2.5 KiB
Markdown
# MapEditor Module / Module Quản lý Bản đồ
|
|
|
|
## 📋 Overview / Tổng quan
|
|
|
|
MapEditor Module quản lý bản đồ nhà máy theo tiêu chuẩn VDMA LIF, cho phép tạo, chỉnh sửa và quản lý maps cho robot navigation.
|
|
|
|
## 🎯 Mục đích / Purpose
|
|
|
|
Quản lý bản đồ nhà máy theo tiêu chuẩn VDMA LIF để hỗ trợ robot navigation và route planning.
|
|
|
|
## 🏗️ Kiến trúc / Architecture
|
|
|
|
- **Shared Library**: MapEditor là shared library cho FleetManager và RobotApp
|
|
- **Components**:
|
|
- C# Library: Xử lý logic (map data, pathfinding, validation)
|
|
- Blazor Library: UI components (shared cho FleetManager và RobotApp)
|
|
|
|
## 🔧 Chức năng chính / Main Features
|
|
|
|
- Tạo và chỉnh sửa maps
|
|
- Import/Export VDMA LIF JSON
|
|
- Visual editing với SVG canvas
|
|
- PathFinding giữa các stations (A* algorithm)
|
|
- Validate map data theo VDMA LIF standard
|
|
- Quản lý stations, nodes, edges
|
|
|
|
## 📊 Map States / Trạng thái Bản đồ
|
|
|
|
```mermaid
|
|
stateDiagram-v2
|
|
[*] --> Draft: Create map
|
|
Draft --> Active: Activate map
|
|
Active --> Draft: Deactivate
|
|
Active --> [*]: Delete map
|
|
|
|
note right of Draft
|
|
Map có thể chỉnh sửa
|
|
Không thể tạo order
|
|
end note
|
|
|
|
note right of Active
|
|
Map không thể chỉnh sửa
|
|
Có thể tạo order cho robot
|
|
end note
|
|
```
|
|
|
|
## 📋 Map Activation Rules / Quy tắc Kích hoạt Bản đồ
|
|
|
|
- Map ở trạng thái **Draft**: Có thể chỉnh sửa, không thể tạo order
|
|
- Map ở trạng thái **Active**: Không thể chỉnh sửa, có thể tạo order cho robot
|
|
- **FleetManager**: Có thể active nhiều maps cùng lúc
|
|
- **RobotApp**: Chỉ active 1 map tại một thời điểm
|
|
|
|
## 💾 Data Storage / Lưu trữ Dữ liệu
|
|
|
|
- Map data lưu trong SQL Server database (FleetManager)
|
|
- MapEditor sử dụng dữ liệu từ database để tính toán routes
|
|
|
|
## ✅ VDMA LIF Compliance / Tuân thủ VDMA LIF
|
|
|
|
- Import/Export VDMA LIF JSON format
|
|
- Validate map structure theo VDMA LIF standard
|
|
- Cấu trúc dữ liệu có thể thể hiện được theo tiêu chuẩn VDMA LIF
|
|
|
|
## 🔗 Related Documents / Tài liệu Liên quan
|
|
|
|
- [FleetManager Overview](README.md) - Tổng quan FleetManager
|
|
- [TrafficControl Module](TrafficControl.md) - Sử dụng map data để tính toán routes
|
|
- [MapEditor Documentation](../MapEditor/README.md) - Chi tiết về MapEditor shared library
|
|
|
|
---
|
|
|
|
**Last Updated**: 2025-11-13
|
|
|