3470428411
- Backend (FastAPI): - Task comments with nested replies and soft delete - @mention parsing with 10-mention limit per comment - Notification system with read/unread tracking - Blocker management with project owner notification - WebSocket endpoint with JWT auth and keepalive - User search API for @mention autocomplete - Alembic migration for 4 new tables - Frontend (React + Vite): - Comments component with @mention autocomplete - NotificationBell with real-time WebSocket updates - BlockerDialog for task blocking workflow - NotificationContext for state management - OpenSpec: - 4 requirements with scenarios defined - add-collaboration change archived 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
77 lines
2.7 KiB
Markdown
77 lines
2.7 KiB
Markdown
## 1. Database Schema
|
||
|
||
- [x] 1.1 建立 Comment model (`pjctrl_comments`)
|
||
- [x] 1.2 建立 Mention model (`pjctrl_mentions`)
|
||
- [x] 1.3 建立 Notification model (`pjctrl_notifications`)
|
||
- [x] 1.4 建立 Blocker model (`pjctrl_blockers`)
|
||
- [x] 1.5 建立 Alembic migration
|
||
- [x] 1.6 更新 Task model 加入 comments relationship
|
||
- [x] 1.7 更新 User model 加入 notifications relationship
|
||
|
||
## 2. Backend API - Comments
|
||
|
||
- [x] 2.1 建立 Comment schemas (request/response)
|
||
- [x] 2.2 實作 POST `/api/tasks/{task_id}/comments` - 新增留言
|
||
- [x] 2.3 實作 GET `/api/tasks/{task_id}/comments` - 取得留言列表
|
||
- [x] 2.4 實作 PUT `/api/comments/{comment_id}` - 編輯留言
|
||
- [x] 2.5 實作 DELETE `/api/comments/{comment_id}` - 刪除留言
|
||
- [x] 2.6 實作 @mention 解析邏輯（從留言內容提取 @username）
|
||
|
||
## 3. Backend API - Notifications
|
||
|
||
- [x] 3.1 建立 Notification schemas
|
||
- [x] 3.2 實作 NotificationService（建立、發送通知）
|
||
- [x] 3.3 實作 GET `/api/notifications` - 取得通知列表
|
||
- [x] 3.4 實作 PUT `/api/notifications/{id}/read` - 標記已讀
|
||
- [x] 3.5 實作 PUT `/api/notifications/read-all` - 全部已讀
|
||
- [x] 3.6 實作 GET `/api/notifications/unread-count` - 未讀數量
|
||
|
||
## 4. Backend API - Blockers
|
||
|
||
- [x] 4.1 建立 Blocker schemas
|
||
- [x] 4.2 實作 POST `/api/tasks/{task_id}/blockers` - 標記阻礙
|
||
- [x] 4.3 實作 PUT `/api/blockers/{blocker_id}/resolve` - 解除阻礙
|
||
- [x] 4.4 實作 GET `/api/tasks/{task_id}/blockers` - 取得阻礙歷史
|
||
- [x] 4.5 整合阻礙通知（通知專案 Owner）
|
||
|
||
## 5. WebSocket Integration
|
||
|
||
- [x] 5.1 建立 WebSocket connection manager
|
||
- [x] 5.2 實作 `/ws/notifications` endpoint
|
||
- [x] 5.3 整合 Redis Pub/Sub 發布通知
|
||
- [x] 5.4 實作 WebSocket 認證（JWT token）
|
||
- [x] 5.5 實作心跳機制（keepalive）
|
||
|
||
## 6. Backend API - User Search
|
||
|
||
- [x] 6.1 實作 GET `/api/users/search?q={query}` - 使用者搜尋（支援 @mention 自動完成）
|
||
|
||
## 7. Frontend - Comments
|
||
|
||
- [x] 7.1 建立 CommentList 元件
|
||
- [x] 7.2 建立 CommentItem 元件（支援巢狀回覆）
|
||
- [x] 7.3 建立 CommentForm 元件（含 @mention 自動完成）
|
||
- [x] 7.4 整合至 Task 詳情頁
|
||
|
||
## 8. Frontend - Notifications
|
||
|
||
- [x] 8.1 建立 NotificationContext（狀態管理）
|
||
- [x] 8.2 建立 NotificationBell 元件（未讀數量 badge）
|
||
- [x] 8.3 建立 NotificationList 元件
|
||
- [x] 8.4 建立 NotificationItem 元件
|
||
- [x] 8.5 整合 WebSocket 連線
|
||
|
||
## 9. Frontend - Blockers
|
||
|
||
- [x] 9.1 建立 BlockerDialog 元件（標記阻礙表單）
|
||
- [x] 9.2 建立 BlockerHistory 元件
|
||
- [x] 9.3 整合至 Task 詳情頁
|
||
|
||
## 10. Testing
|
||
|
||
- [x] 10.1 Comment API 單元測試
|
||
- [x] 10.2 Notification API 單元測試
|
||
- [x] 10.3 Blocker API 單元測試
|
||
- [x] 10.4 WebSocket 連線測試
|
||
- [x] 10.5 @mention 解析測試
|