96 lines
3.7 KiB
Markdown
96 lines
3.7 KiB
Markdown
## Context
|
||
|
||
此變更旨在為 VFX 專案管理系統新增一個「我的任務」(My Tasks) 頁面，讓用戶能夠在一個統一的視圖中查看所有專案中分配給自己的任務。目前用戶需要逐一進入每個專案才能看到被分配的任務，這對於同時管理多個專案的 Director、Coordinator 等角色而言效率較低。
|
||
|
||
現有系統已經具備：
|
||
- 完善的任務管理系統（Task entity with assignments）
|
||
- 專案內的任務頁面（使用 DataTable 元件）
|
||
- 基於角色的存取控制 (RBAC)
|
||
- JWT 認證機制
|
||
|
||
## Goals / Non-Goals
|
||
|
||
**Goals:**
|
||
- 建立一個統一的「我的任務」頁面，展示所有分配給當前用戶的任務
|
||
- 重用現有的專案任務頁面 layout 與 DataTable 元件，確保 UI 一致性
|
||
- 支援按專案、狀態等條件篩選任務
|
||
- 支援任務排序功能
|
||
- 提供從任務列表直接導航到任務詳細頁面的功能
|
||
|
||
**Non-Goals:**
|
||
- 不會修改現有專案內的任務頁面行為
|
||
- 不會新增任務管理功能（如建立、編輯、刪除任務）- 這些應在專案上下文完成
|
||
- 不會提供跨專案的任務批量操作
|
||
|
||
## Decisions
|
||
|
||
### 1. API 設計：獨立端點 vs 擴展現有端點
|
||
**Decision**: 建立獨立的 `/api/tasks/my-tasks` 端點
|
||
|
||
**Rationale**:
|
||
- 獨立端點可讓權限過濾更清晰（僅顯示用戶有權限存取的專案任務）
|
||
- 回應格式可針對 My Tasks 視圖優化（如包含專案資訊）
|
||
- 未來擴展（如分頁、進階篩選）更彈性
|
||
|
||
**Alternative considered**: 擴展現有的 `/api/projects/{id}/tasks` 端點
|
||
- 這個方法需要傳遞多個專案 ID，不適合跨專案查詢場景
|
||
|
||
### 2. 前端架構：新建元件 vs 重用現有元件
|
||
**Decision**: 重用現有的 ProjectTaskPage layout 與 DataTable 元件
|
||
|
||
**Rationale**:
|
||
- 確保 UI/UX 一致性，用戶在專案內和 My Tasks 頁面有相同體驗
|
||
- 減少開發時間和維護成本
|
||
- DataTable 元件已經支援排序、篩選、分頁等功能
|
||
|
||
**Alternative considered**: 建立全新的 MyTasksPage 元件
|
||
- 需要重複實作相同功能，增加維護負擔
|
||
|
||
### 3. 權限模型：僅顯示有權限的任務
|
||
**Decision**: API 僅返回用戶有存取權限的專案任務
|
||
|
||
**Rationale**:
|
||
- 符合最小權限原則
|
||
- 避免資安風險（用戶不應看到無權限專案的任務）
|
||
- 與現有 RBAC 系統整合
|
||
|
||
### 4. 資料庫查詢策略
|
||
**Decision**: 單一查詢取得所有任務（而非多次查詢）
|
||
|
||
**Rationale**:
|
||
- 減少網路往返次數
|
||
- 雖然查詢較複雜，但可通過 SQLAlchemy 優化
|
||
- 考量未來加入分頁以處理大量任務
|
||
|
||
**Risks**:
|
||
- [Risk] 大型系統中任務數量可能很大 → **Mitigation**: 實作分頁機制
|
||
- [Risk] 跨專案查詢效能 → **Mitigation**: 確保 task.assignee_id 和 task.project_id 有適當索引
|
||
|
||
## Migration Plan
|
||
|
||
此變更為純新增功能，不需要資料遷移。部署步驟：
|
||
|
||
1. **後端部署**：
|
||
- 部署新 API 端點 `/api/tasks/my-tasks`
|
||
- 確認任務查詢效能（如需要則新增資料庫索引）
|
||
|
||
2. **前端部署**：
|
||
- 新增 My Tasks 頁面路由
|
||
- 確保導航選單有 My Tasks 入口
|
||
|
||
3. **驗證**：
|
||
- 測試不同角色用戶的 My Tasks 顯示正確性
|
||
- 驗證篩選、排序功能正常運作
|
||
- 確認權限控制正確（無權限專案的任務不顯示）
|
||
|
||
## Open Questions
|
||
|
||
- **Q1**: My Tasks 頁面是否需要顯示任務的詳細進度（如 shot/asset 進度）？
|
||
- **目前建議**: 暫不包含，保持與專案任務頁面一致
|
||
|
||
- **Q2**: 是否需要支援「我的最愛」或「追蹤中」的任務功能？
|
||
- **目前建議**: 留待未來擴展
|
||
|
||
- **Q3**: 如何處理任務數量眾多的效能問題？
|
||
- **建議**: 採用分頁（預設 50 筆），並在未來根據需求考慮虛擬滾動
|