控制 API

供外部控管端（如 Arsenal / 公控 PWR）呼叫，發起充電或放電指令；指令驅動模擬並反映於即時監控圖表。

發起充電 / 放電

功率 (kW)起始時 (0–23)

POST/api/v1/sim/control/command

下發單筆指令 { hour, power_kw, soc_target? }；power_kw > 0 放電、< 0 充電

GET/api/v1/sim/control/schedule

讀取目前排程

PUT/api/v1/sim/control/schedule

覆寫整份排程（enabled + commands）

充放電操作範例（curl）

同一支端點以 power_kw 正負號決定方向：正值放電、負值充電；hour 為起始時（0–23），soc_target（選填，0–100）會限制 SOC 收斂目標。

# 放電 200 kW（power_kw 正值）
curl -X POST /api/v1/sim/control/command \
  -H "Content-Type: application/json" \
  -d '{"hour": 7, "power_kw": 200}'

# 充電 200 kW（power_kw 負值）
curl -X POST /api/v1/sim/control/command \
  -H "Content-Type: application/json" \
  -d '{"hour": 7, "power_kw": -200}'