EMS

後端 API 已完成，詳見 https://gitlab.com/sylksoft/ems/-/merge_requests/new?merge_request%5Bsource_branch%5D=feature%2Fredmine-1257-charge-group-api-private

=== 交棒給 Ryan（前端實作）===

■ 實作分支：feature/redmine-1257-charge-group-api-private
■ 測試環境：http://kh.sylksoft.com:18081（已部署最新版本）

■ 已完成的後端 API：

Charge Group CRUD：

• GET /api/charge-group/list （列表）
• GET /api/charge-group/info/{id} （單筆）
• POST /api/charge-group/upsert （新增/更新同一支）
• DELETE /api/charge-group/delete/{id} （刪除，已實作保護不可刪除已使用的 group）

Connector.chargeGroup 驗證：

• POST /api/connector/create：chargeGroup 必填，未帶回 400
• POST /api/connector/update：省略 chargeGroup 欄位會保留原值
• GET /api/common/options/charge_group（下拉選單用）

■ 前端實作重點（Ryan 請注意）：

1. ChargeGroupDto 格式（POST/PUT body）：
   {
   "id": "CG001",
   "contractCapacity": 99.0,
   "allocatedPower": 50.0
   }
   => id 在建立時填寫，更新時不需帶
   => rotationCycleActive、reservedSlots 等為唯讀，請勿放進編輯表單

2. 刪除保護：刪除前建議顯示「已有 N 個 connector 掛在此 group」的提示
   若強行刪除，API 會回 HTTP 400

3. Connector.update 時 chargeGroup 行為：
   => 若使用者沒改 chargeGroup，前端不用帶 chargeGroup 欄位，後端保留原值
   => 若有改，帶新值送出即可

4. 請記得 Authorization header，API 需登入 ADMIN 權限

■ 已通過 E2E 測試（共 15 條全數通過）
詳細內容與 API 文件請見 GitLab MR。

【更正/補充說明 - Ryan 請一併閱讀】

■ 新增一支 API：
GET /api/charge-group/connector-count/{id}
=> 回傳格式：{"chargeGroupId": "CG001", "connectorCount": 3}
=> 用途：刪除前顯示「已有 N 個 Connector 掛在此 group」的提示
=> 不存在的 CG 回 404

■ 完整 API 列表（修正版）：

■ 修正說明：
前次回覆描述的 API ID（A1210~A1214）與實際 Controller 路由不符，正確對照如下：
A1215 = /api/charge-group/list（GET）
A1212 = /api/charge-group/info/（GET）
A1216 = /api/charge-group/upsert（POST）
A1214 = /api/charge-group/delete/（DELETE）
A1217 = /api/charge-group/connector-count/*（GET）← 新增

patch SQL 已同步修正。

api已完成。

已完成前端開發，branch: feature/issue-1257-charge-group-management.

實作內容：

• 新增充電群組管理 CRUD 頁面（列表/新增/編輯）
• 刪除前呼叫 connector-count API 顯示使用中 Connector 數量提示
• Connector 表單新增供電群組下拉選單欄位
• 更新 OpenAPI schema（含新增 connector-count endpoint）