Smart Field CMS

多品牌機器人車隊統一管理平台 — 季享科技 NexOS Robotics

1. 系統概覽

1.1 設計目標

1.2 系統架構

1.3 資料流

2. 技術棧

2.1 前端技術

2.2 後端技術

2.3 資料庫

3. Monorepo 結構

4. 後端架構

4.1 模組列表 (25 個)

4.2 架構分層

4.3 統一回應格式

// 成功
{ "success": true, "data": { ... }, "meta": { "timestamp": "..." } }

// 分頁
{ "success": true, "data": [...], "meta": { "page": 1, "limit": 20, "total": 150 } }

// 錯誤
{ "success": false, "error": { "code": "ROBOT_NOT_FOUND", "message": "..." } }

5. 前端架構

5.1 頁面總覽 (47+ 頁面)

總覽

客戶中心

機器人管理

任務與排程

資料中心

更多模組

5.2 Pinia Store (11 個)

5.3 Composables (17 個)

6. 資料庫設計

6.1 PostgreSQL + TimescaleDB (25+ 表格)

6.2 MongoDB Collections

6.3 Redis 用途

7. API 設計

7.1 API 端點總覽

Auth (認證)

POST   /auth/login              登入
POST   /auth/refresh            刷新 Token
POST   /auth/logout             登出
GET    /auth/me                 目前使用者
PUT    /auth/me/password        變更密碼
PUT    /auth/me/profile         更新個人資料

Robots (機器人) — 核心

GET    /robots                  機器人列表
POST   /robots                  註冊機器人
GET    /robots/:id              詳情 (含即時狀態)
PUT    /robots/:id              更新
DELETE /robots/:id              移除
GET    /robots/:id/status       即時狀態 (Redis)
GET    /robots/:id/telemetry    歷史遙測 (TimescaleDB)
POST   /robots/:id/commands     發送控制指令
GET    /robots/stats            統計

Tasks (任務)

GET    /tasks                   任務列表
POST   /tasks                   建立任務
GET    /tasks/:id               任務詳情
POST   /tasks/:id/cancel        取消任務
POST   /tasks/:id/assign        手動分配

其他核心端點

GET/POST /schedules             排程 CRUD
GET/POST /alerts                告警 CRUD
GET/POST /alert-rules           告警規則 CRUD
GET/POST /fields/:siteId/zones  區域 CRUD
GET/POST /iot/devices           IoT 設備 CRUD
POST     /emergency/activate    緊急啟動
GET      /analytics/overview    數據分析
POST     /ai/chat               AI 對話
GET      /stores                門店列表
GET      /agents                經銷商列表
GET      /health                健康檢查

8. WebSocket 即時通訊

8.1 Namespace & Room

8.2 Server → Client 事件 (27 個)

8.3 Client → Server 事件 (6 個)

9. 共享套件

9.1 shared-types (28 檔)

9.2 shared-constants

10. 機器人適配器模式

10.1 IRobotAdapter 介面

interface IRobotAdapter {
  connect(config): Promise<void>
  disconnect(): Promise<void>
  getStatus(): Promise<RobotRealtimeStatus>
  sendCommand(cmd): Promise<RobotCommandResult>
  getPosition(): Promise<RobotPosition>
  navigate(target): Promise<void>
  stop(): Promise<void>
  returnToCharge(): Promise<void>
}

10.2 已實作適配器

11. RBAC 權限模型

權限粒度：{module}:{action}，例如 robot:read、task:create、alert:acknowledge

12. 多國語系 (i18n)

13. 開發階段與進度

里程碑

14. 部署架構

PM2 服務

15. 專案統計

Smart Field CMS — 季享科技 NexOS Robotics
文件版本 v1.0 | 最後更新 2026-03-12