入門指南

RIVO Server 是一個專為物聯網機器人車隊管理打造的後端平台。它提供了基於 Go 語言編寫的高性能後端，協助您高效管理機器人車隊。

1. 簡介

RIVO Server 提供以下核心功能：

• 機器人註冊與監控 - 追踪機器人狀態並監控其健康狀況。
• 即時遙測資料 - 串流機器人遙測數據（里程、電池、感測器）。
• 日誌管理 - 即時收集並串流來自機器人的運行日誌。
• 告警系統 - 接收、確認並解決機器人告警。
• 地圖管理 - 上傳並管理 ROS 地圖與軌跡追踪。
• 指令與控制 - 透過 REST 或 WebSocket 下發控制指令。

2. 套件內容

發行套件包含以下結構：

release/
├── rivo-server          # 主伺服器執行檔
├── rivo-admin           # 管理員 CLI 工具
├── config.yaml          # 設定檔
├── custom_msg/          # 自訂訊息 Schema
├── data/                # SQLite 資料庫（若使用）
└── logs/                # 伺服器日誌檔案

3. 首次設定

步驟 1：安裝

Docker（推薦）：解壓縮 Docker 發行套件後執行安裝腳本：

unzip rivo-server-docker-<version>.zip
cd rivo-server-docker-<version>
./install.sh

安裝腳本會自動生成密鑰、建立 .env，並啟動 Docker 容器。完成後會印出管理員帳號資訊。

Binary（systemd）：解壓縮 Binary 發行套件後以 root 執行安裝腳本：

unzip rivo-server-linux-amd64-<version>.zip
cd rivo-server-linux-amd64-<version>
sudo ./install.sh

安裝腳本會將程式安裝至 /opt/rivo-server/，自動注入 JWT 密鑰，並設定 systemd 服務。

步驟 2：驗證狀態

檢查伺服器是否正常運行：

curl http://localhost:8080/health

步驟 3：預設帳號與使用者管理

安裝腳本完成後會印出預設管理員帳號資訊。使用 rivo-admin 新增使用者或變更密碼：

# 互動模式
./rivo-admin

# 常用指令：
#   user add -u <email> -p <password> -l master
#   user reset-password -u <email> -p <newpass>
#   user list