feat: implement kanban real-time sync and fix workload cache

## Kanban Real-time Sync (NEW-002)
- Backend:
  - WebSocket endpoint: /ws/projects/{project_id}
  - Project room management in ConnectionManager
  - Redis Pub/Sub: project:{project_id}:tasks channel
  - Task CRUD event publishing (5 event types)
  - Redis connection retry with exponential backoff
  - Race condition fix in broadcast_to_project

- Frontend:
  - ProjectSyncContext for WebSocket management
  - Reconnection with exponential backoff (max 5 attempts)
  - Multi-tab event deduplication via event_id
  - Live/Offline connection indicator
  - Optimistic updates with rollback

- Spec:
  - collaboration spec: +1 requirement (Project Real-time Sync)
  - 7 new scenarios for real-time sync

## Workload Cache Fix (NEW-001)
- Added cache invalidation to all task endpoints:
  - create_task, update_task, update_task_status
  - delete_task, restore_task, assign_task
- Extended to clear heatmap cache as well

## OpenSpec Archive
- 2026-01-05-add-kanban-realtime-sync

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

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

openspec/changes/archive/2026-01-05-add-kanban-realtime-sync/proposal.md

@@ -0,0 +1,87 @@
+# Proposal: Add Kanban Real-time Sync
+
+## Change ID
+add-kanban-realtime-sync
+
+## Status
+PROPOSED
+
+## Summary
+實作看板 (Kanban) 多人即時同步功能，讓多位使用者同時查看同一專案看板時能即時看到任務狀態變更。
+
+## Problem Statement
+目前系統的 WebSocket 僅用於通知推播 (`/ws/notifications`)，看板頁面沒有即時同步機制：
+- 當使用者 A 拖曳任務改變狀態時，使用者 B 需要手動重新整理才能看到更新
+- 這導致協作效率降低，可能造成衝突或重複操作
+- 不符合 `project.md` 中「Real-time Sync: WebSocket for live collaboration」的要求
+
+## Proposed Solution
+擴展現有 WebSocket 基礎架構，新增專案房間訂閱 (Project Room Subscription) 機制：
+
+### 核心功能
+1. **專案房間訂閱**：使用者進入專案看板時自動訂閱該專案的即時更新
+2. **任務變更廣播**：任務狀態變更時，透過 Redis Pub/Sub 廣播給同一專案的所有訂閱者
+3. **增量更新**：僅推送變更的任務資料，而非整個看板重載
+
+### 技術架構
+```
+Frontend (KanbanBoard)
+    │
+    ▼ WebSocket: /ws/projects/{project_id}
+Backend (WebSocket Router)
+    │
+    ▼ Redis Pub/Sub: channel:project:{project_id}:tasks
+Backend (Tasks API)
+```
+
+### 訊息類型
+- `task_created`: 新任務建立
+- `task_updated`: 任務更新（含欄位變更）
+- `task_status_changed`: 任務狀態變更（拖曳看板）
+- `task_deleted`: 任務刪除
+- `task_assigned`: 任務指派變更
+
+## Scope
+
+### In Scope
+- 專案級 WebSocket 連線端點
+- 任務 CRUD 事件廣播
+- 前端看板即時更新
+- 樂觀更新 (Optimistic Update) 搭配衝突回滾
+
+### Out of Scope
+- 任務欄位鎖定 (Field Locking) - 未來可擴展
+- 離線編輯同步 - 未來可擴展
+- 多專案同時訂閱 - 目前一次訂閱一個專案
+
+## Impact Analysis
+
+### Affected Components
+- `backend/app/api/websocket/router.py` - 新增專案 WebSocket 端點
+- `backend/app/services/websocket_manager.py` - 新增專案房間管理
+- `backend/app/api/tasks/router.py` - 任務變更時發送事件
+- `frontend/src/components/KanbanBoard.tsx` - 接收即時更新
+- `frontend/src/contexts/NotificationContext.tsx` - 可能需要擴展或新增專案同步 Context
+
+### Performance Considerations
+- Redis Pub/Sub 已用於通知系統，可直接復用
+- 每專案一個 channel，避免全域廣播
+- 增量更新減少資料傳輸量
+
+### Security Considerations
+- WebSocket 連線需驗證 JWT Token
+- 確認使用者有權限存取該專案
+- 防止未授權的專案訂閱
+
+## Dependencies
+- 現有 WebSocket 基礎架構 (collaboration spec)
+- Redis Pub/Sub (已實作)
+- JWT Token 驗證 (user-auth spec)
+- 專案權限檢查 (resource-management spec)
+
+## Related Specs
+- `collaboration` - 擴展 Real-time Notifications requirement
+- `task-management` - 任務 CRUD 操作
+
+## Author
+Claude Code