a620906209
03f8caf3e9
後端 - 新增 6 個 Notification class（預約建立/確認/拒絕/取消/完成、收到評價），database + mail 雙 channel - 新增 NotificationController（list / unread-count / markRead / markAllRead / destroy） - 整合通知觸發至 MemberBookingController、ProviderBookingController、CompleteFinishedBookings、ReviewController - 新增 notifications / jobs / failed_jobs migration - Docker Compose 加入 queue-worker、mailpit service - DivingOffer 補上 provider() 關聯 前端 - 新增 notificationStore（Polling 30s/60s 自適應 + Page Visibility API） - 新增 NotificationBell（未讀 Badge）、NotificationDrawer（側邊通知中心） - main.js：auth store init 前置於 router.use()，修正 beforeEach guard 時序問題 - notificationAxios：依路徑動態選擇 member/coach token - NotificationDrawer：改用 new URL().pathname 提取 action_url 路徑 OpenSpec - 歸檔 notification-system change - 同步 notification-core / notification-email / notification-triggers specs 至主規格 - 更新 booking-lifecycle / review-lifecycle spec（補充通知觸發 requirement） Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
2.0 KiB
2.0 KiB
Why
預約確認、取消、評價等關鍵事件目前完全沒有通知機制，使用者只能主動回頁面查看，造成重要訊息遺漏。實作通知系統可閉合「事件發生→使用者知情」這段空白，提升平台使用黏著度。
What Changes
- 新增站內通知（In-App Notification）：所有角色（Member / Provider / Admin）可在導覽列看到未讀數量，點開通知中心查看全部通知
- 新增Email 通知：重要事件以信件寄送，使用 Laravel Queued Mailable + Markdown 模板
- 新增通知觸發點整合至現有業務邏輯（預約、評價、教練審核）：
- 預約建立 → 通知 Provider
- 預約確認/拒絕 → 通知 Member
- 預約取消（任一方） → 通知對方
- 預約完成 → 通知 Member（可評價）
- Member 送出評價 → 通知 Provider
- Admin 審核/拒絕教練申請 → 通知 Provider
Capabilities
New Capabilities
notification-core: 通知資料模型、API（取得列表、標記已讀、刪除）、Vue 站內通知元件（Bell Icon + 通知中心 Drawer）notification-email: Laravel Mail 設定、Markdown 模板、Queue 投遞機制notification-triggers: 在 BookingService / ReviewService / Admin 審核流程中插入通知觸發邏輯
Modified Capabilities
booking-lifecycle: 預約七狀態機各轉換點需加上通知觸發review-lifecycle: 評價建立後需觸發 Provider 通知
Impact
- 新增資料表：
notifications（Laravel 內建databasenotification channel schema） - 新增 API：
GET /api/notifications、PATCH /api/notifications/{id}/read、PATCH /api/notifications/read-all、DELETE /api/notifications/{id} - 後端依賴：Laravel Notification + Queue（database driver，可升級為 Redis）、Laravel Mail（SMTP/Mailpit 本地測試）
- 前端依賴：Pinia store for notifications、Polling 或 SSE 取得即時未讀數
- 影響範圍：BookingService、ReviewService、Admin 教練審核 controller