API Changelog

來源：docs/SaaS-API.md 版本變更紀錄

格式遵循 Keep a Changelog。

v0.10.0 (2026-02-25)

Added

• 新增 GET /analysis/attributes：獨立屬性記錄分頁查詢
• 新增 GET /analysis/attributes/{id}：單筆屬性記錄詳情

Changed

• Attributes API 與 Insights 解耦（獨立 Controller/Service）
• VLM 快照抽樣優化：>3 張時採首張 + 中間 + 末張
• VLM System Prompt 升級為事件過程導向

Fixed

• Plan Gate 行為明確化：Attributes 端點需 LEVEL_02（LEVEL_01 回 403）

v0.9.0 (2026-02-25)

Added

• 新增 vlmStructuredResult（JSONB）

Changed

• VLM 由 generateText() 升級至 generateObject()（Zod schema）
• vlmSummary 由結構化結果摘要欄位向後相容
• VLM 設定改由 Admin API 動態管理

v0.8.0 (2026-02-25)

Added

• 新增 Analysis Insights 6 個端點（列表、詳情、snapshots、attributes、stats、vlm-summaries）

Changed

• 支援多條件篩選與全文搜尋
• analytics:read 權限控制

v0.7.0 (2026-02-25)

Added

• 新增 Kafka topic：scene-analysis-attributes
• 新增資料表：scene_analysis_attributes

Changed

• 行人屬性偵測與 alert 流程解耦
• 屬性配額檢查/扣減併入新 consumer

v0.6.0 (2026-02-25)

Added

• Billing Dashboard 新增 GET /billing/transactions
• Usage API 新增 period 查詢參數

Changed

• trend 支援 deviceId 與 4-feature 聚合
• forecast.periods 擴展 1-24

Fixed

• billingPeriod 強制 YYYY-MM 驗證

v0.5.0 (2026-02-24)

Added

• 新增 Section 9 Billing Dashboard
• 4-feature 模型（analysis / alert / attribute / vlm）上線

v0.4.0 (2026-02-20)

Added

• 新增 Section 10 Usage API
• 新增 Section 11 Admin 配額管理

Changed

• Legacy 欄位移除（參考 migration 文件）

建議升級順序

1. 先改 Billing/Usage billingPeriod 與 period 參數格式
2. 再接入 Insights/Attributes 新端點
3. 最後啟用 VLM 結構化輸出欄位