first commit

2026-07-13 09:22:58 +07:00
commit c08ff54676
1 changed files with 104 additions and 0 deletions
--- a/README.md
+++ b/README.md
@@ -0,0 +1,104 @@
+# RobotNet10 - AMR Fleet Management System
+
+## 📋 Tổng quan dự án / Project Overview
+
+RobotNet10 là hệ thống quản lý và điều khiển robot di động tự động (AMR - Autonomous Mobile Robot) theo tiêu chuẩn VDA 5050. Dự án bao gồm hai phần mềm chính:
+
+- **RobotApp**: Phần mềm điều khiển robot AMR đơn lẻ
+- **FleetManager**: Phần mềm điều phối đội xe robot AMR
+
+### 🎯 Mục tiêu / Goals
+
+1. Xây dựng hệ thống AMR tuân thủ tiêu chuẩn VDA 5050
+2. Đảm bảo khả năng tương tác với các hệ thống quản lý robot khác
+3. Hỗ trợ nhiều robot từ nhiều nhà sản xuất khác nhau
+4. Giao tiếp thông qua MQTT broker theo chuẩn VDA 5050
+
+### 🏗️ Kiến trúc / Architecture
+
+```
+┌─────────────────┐                    ┌──────────────────┐
+│  FleetManager   │◄───── MQTT ───────►│   RobotApp #1    │
+│   (Factory)     │      VDA 5050      │  (Robot AMR #1)  │
+│                 │                    └──────────────────┘
+│  - Web UI       │◄───── MQTT ───────►┌──────────────────┐
+│  - Blazor App   │      VDA 5050      │   RobotApp #2    │
+│  - .NET         │                    │  (Robot AMR #2)  │
+└─────────────────┘                    └──────────────────┘
+        │                                       │
+        └───────────────┬───────────────────────┘
+                        │
+                  ┌─────▼─────┐
+                  │   MQTT    │
+                  │  Broker   │
+                  └───────────┘
+```
+
+## 🚀 Công nghệ / Technology Stack
+
+- **Framework**: .NET (latest LTS)
+- **Web Framework**: Blazor Web App
+- **Communication Protocol**: MQTT
+- **Standard**: VDA 5050
+- **OS Target**:
+  - RobotApp: Ubuntu Server 22.04 (on robot)
+  - FleetManager: Linux/Windows Server (factory)
+- **Real-time Kernel**: Linux RT 6.6.116-rt66 (optional, for low-latency)
+
+## 📚 Tài liệu / Documentation
+
+Tài liệu chi tiết được tổ chức trong thư mục [docs/](docs/):
+
+- 🗺️ **[Documentation Map](docs/DOCUMENTATION_MAP.md)** - Bản đồ tìm kiếm tài liệu nhanh
+- [Documentation Hub](docs/README.md) - Trung tâm tài liệu
+- [Architecture Overview](docs/architecture/README.md) - Kiến trúc hệ thống
+- [ScriptEngine](docs/scriptengine/README.md) - Module C# Scripting (Shared)
+- [MapEditor](docs/mapeditor/README.md) - Module Map Management (Shared)
+- [RobotApp Documentation](docs/robotapp/README.md) - Tài liệu RobotApp
+- [FleetManager Documentation](docs/fleetmanager/README.md) - Tài liệu FleetManager
+- [VDA 5050 Integration](docs/vda5050/README.md) - Tích hợp VDA 5050
+- [Development Guide](docs/development/README.md) - Hướng dẫn phát triển
+- 🤖 **[AI Collaboration Guide](docs/ai-guide/README.md)** - Hướng dẫn cho AI (Required for AI agents)
+
+## 🛠️ Cấu trúc dự án / Project Structure
+
+```
+RobotNet10/
+├── docs/                      # Tài liệu dự án
+├── srcs/                      # Source code
+│   ├── RobotApp/             # Robot control application
+│   ├── FleetManager/         # Fleet management system
+│   └── Shared/               # Shared libraries
+├── IPC/                       # Linux RT kernel (optional)
+├── tests/                     # Unit & integration tests
+└── README.md                  # File này
+```
+
+## 🚦 Trạng thái dự án / Project Status
+
+**Current Phase**: 📝 Documentation & Architecture Design
+
+- [x] Initialize project structure
+- [x] Linux RT kernel configuration
+- [ ] Documentation system setup
+- [ ] RobotApp core development
+- [ ] FleetManager core development
+- [ ] VDA 5050 implementation
+- [ ] MQTT integration
+- [ ] Web UI development
+
+## 🤝 Đóng góp / Contributing
+
+Dự án đang trong giai đoạn phát triển. Vui lòng tham khảo [Development Guide](docs/development/README.md) để biết thêm chi tiết.
+
+## 📝 License
+
+[Chưa xác định / To be determined]
+
+## 📧 Liên hệ / Contact
+
+[Thông tin liên hệ / Contact information]
+
+---
+
+**Note**: This project follows VDA 5050 standard for interoperability with other AMR systems and fleet management platforms.