feat: implement workload heatmap module

- Backend (FastAPI):
  - Workload heatmap API with load level calculation
  - User workload detail endpoint with task breakdown
  - Redis caching for workload calculations (1hr TTL)
  - Department isolation and access control
  - WorkloadSnapshot model for historical data
  - Alembic migration for workload_snapshots table

- API Endpoints:
  - GET /api/workload/heatmap - Team workload overview
  - GET /api/workload/user/{id} - User workload detail
  - GET /api/workload/me - Current user workload

- Load Levels:
  - normal: <80%, warning: 80-99%, overloaded: >=100%

- Tests:
  - 26 unit/API tests
  - 15 E2E automated tests
  - 77 total tests passing

- OpenSpec:
  - add-resource-workload change archived
  - resource-management spec updated

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

openspec/specs/resource-management/spec.md

@@ -1,41 +1,54 @@
 # Resource Management
 
-資源管理系統，提供負載熱圖與人員容量追蹤，協助主管進行資源分配決策。
+## Purpose
 
+資源管理系統，提供負載熱圖與人員容量追蹤，協助主管進行資源分配決策。讓主管能即時掌握團隊成員的工作負載狀況，及早發現超載或閒置問題，優化資源分配。
 ## Requirements
-
 ### Requirement: Workload Heatmap
-系統 SHALL 提供負載熱圖，自動統計每人每週分配的任務總時數。
+
+系統 SHALL 提供負載熱圖 API，自動統計每人每週分配的任務總時數，並以顏色等級表示負載狀態。
 
 #### Scenario: 負載正常顯示
 - **GIVEN** 某人員本週被指派的任務總時數低於其容量的 80%
-- **WHEN** 主管查看負載熱圖
-- **THEN** 該人員顯示為綠色（正常）
+- **WHEN** 主管查詢負載熱圖 API
+- **THEN** 該人員的 `load_level` 為 `normal`
+- **AND** 回傳包含 `load_percentage`、`allocated_hours`、`capacity_hours`
 
 #### Scenario: 負載警告顯示
-- **GIVEN** 某人員本週被指派的任務總時數達到其容量的 80%-100%
-- **WHEN** 主管查看負載熱圖
-- **THEN** 該人員顯示為黃色（警告）
+- **GIVEN** 某人員本週被指派的任務總時數達到其容量的 80%-99%
+- **WHEN** 主管查詢負載熱圖 API
+- **THEN** 該人員的 `load_level` 為 `warning`
 
 #### Scenario: 負載超載顯示
-- **GIVEN** 某人員本週被指派的任務總時數超過其容量的 100%
-- **WHEN** 主管查看負載熱圖
-- **THEN** 該人員顯示為紅色（超載）
-- **AND** 可點擊查看詳細任務分配
+- **GIVEN** 某人員本週被指派的任務總時數達到或超過其容量的 100%
+- **WHEN** 主管查詢負載熱圖 API
+- **THEN** 該人員的 `load_level` 為 `overloaded`
+
+#### Scenario: 查詢特定週的負載
+- **GIVEN** 主管需要查看非當週的負載
+- **WHEN** 主管以 `week_start` 參數查詢負載熱圖 API
+- **THEN** 系統回傳該週的負載資料
+
+#### Scenario: 快取機制
+- **GIVEN** 負載資料已被計算並快取
+- **WHEN** 相同查詢在 1 小時內再次發生
+- **THEN** 系統從 Redis 快取回傳結果
 
 ### Requirement: Capacity Planning
-系統 SHALL 支援人員容量規劃與追蹤。
 
-#### Scenario: 設定人員容量
+系統 SHALL 支援人員容量規劃，包含預設容量與臨時調整。
+
+#### Scenario: 設定人員預設容量
 - **GIVEN** 管理者需要設定人員的週工時上限
-- **WHEN** 管理者更新使用者的 Capacity 值
+- **WHEN** 管理者更新使用者的 `capacity` 值
 - **THEN** 系統儲存新的容量設定
-- **AND** 重新計算該人員的負載百分比
+- **AND** 後續負載計算使用新容量值
 
-#### Scenario: 容量調整（如請假）
-- **GIVEN** 人員某週有請假安排
-- **WHEN** 系統計算該週負載
-- **THEN** 考慮實際可用工時進行計算
+#### Scenario: 容量為零處理
+- **GIVEN** 使用者的容量設為 0
+- **WHEN** 系統計算該使用者的負載
+- **THEN** `load_percentage` 顯示為 `null`
+- **AND** `load_level` 顯示為 `unavailable`
 
 ### Requirement: Multi-Project Health Dashboard
 系統 SHALL 提供多專案健康看板，讓主管一覽所有專案狀態。
@@ -53,19 +66,38 @@
 - **AND** 顯示延遲任務數量與影響
 
 ### Requirement: Team Workload Distribution
-系統 SHALL 視覺化呈現團隊工作分配狀況。
+
+系統 SHALL 提供團隊工作分配查詢功能。
 
 #### Scenario: 部門負載總覽
 - **GIVEN** 主管需要了解部門整體負載
-- **WHEN** 主管查看團隊負載視圖
-- **THEN** 顯示部門內每位成員的負載狀況
-- **AND** 可按專案或任務類型篩選
+- **WHEN** 主管以 `department_id` 參數查詢負載熱圖 API
+- **THEN** 僅顯示該部門成員的負載狀況
 
-#### Scenario: 資源分配不均警示
-- **GIVEN** 團隊中存在負載差異過大的情況
-- **WHEN** 系統偵測到分配不均
-- **THEN** 在看板上標示警示
-- **AND** 建議可重新分配的任務
+#### Scenario: 使用者負載詳情
+- **GIVEN** 主管需要了解某人的詳細任務分配
+- **WHEN** 主管查詢使用者負載詳情 API
+- **THEN** 回傳該週指派給該使用者的所有任務
+- **AND** 包含每個任務的 `original_estimate` 與 `due_date`
+
+### Requirement: Workload Data Access Control
+
+系統 SHALL 限制負載資料的存取權限。
+
+#### Scenario: 系統管理員查看所有人
+- **GIVEN** 登入者為 `super_admin`
+- **WHEN** 查詢負載熱圖 API
+- **THEN** 可查看所有使用者的負載資料
+
+#### Scenario: 一般使用者查看自己
+- **GIVEN** 登入者為一般使用者
+- **WHEN** 查詢負載熱圖 API 未指定 `user_ids`
+- **THEN** 僅回傳自己的負載資料
+
+#### Scenario: 跨部門存取拒絕
+- **GIVEN** 登入者非系統管理員
+- **WHEN** 查詢其他部門使用者的負載
+- **THEN** 系統拒絕存取並回傳 403 Forbidden
 
 ## Data Model