README.md

AGV System

AGV (Automated Guided Vehicle) 系統是一個用於管理和控制自動導引車輛的綜合解決方案。本系統使用 .NET 8.0 開發，整合了 ROS (Robot Operating System) 橋接功能，提供完整的車輛管理、任務調度和監控功能。

Setup the Build Environment

系統需求

• Windows 10/11 作業系統
• .NET 8.0 SDK 或更新版本
• Visual Studio 2022 (可使用社群版本）
• Git 版本控制工具

開發環境設置

1. 安裝 .NET 8.0 SDK

   # 確認 .NET SDK 版本
   dotnet --version

2. 克隆專案

   # 使用提供的批次檔克隆專案
   .\agvsystem_projects_clone.bat
   # 或使用 GitLab 版本
   .\agvsystem_projects_clone_gitlab.bat

3. 還原相依套件

   dotnet restore

4. 建置專案

   dotnet build

設定檔配置

1. 確保 appsettings.json 設定正確
2. 檢查 nlog.config 日誌配置

開發工具建議

• Visual Studio 2022
  • 建議安裝的擴充功能：
    • Web Compiler
    • NLog Viewer
    • Git Extensions
• Visual Studio Code（可選）
  • 建議安裝的擴充功能：
    • C# Dev Kit
    • .NET Core Tools
    • GitLens

首次執行

1. 執行前置腳本

   .\prebuild.bat

2. 使用 Visual Studio 開啟解決方案

   start AGVSystem.sln

3. 設定啟動設定（Properties/launchSettings.json）

4. 按 F5 執行偵錯或 Ctrl+F5 執行不偵錯

注意事項

待續...

接下來將會繼續補充：

• 系統架構說明
• API 文件
• 部署指南
• 故障排除指南
• 貢獻指南