CFDivePlatform/openspec/specs/notification-email/spec.md at 03f8caf3e938b3728b630d71d7fb0f0ef06dc958

a620906209/CFDivePlatform

Files

T

a620906209 03f8caf3e9 feat:實作通知系統 — 站內通知、Email 通知、Polling 機制

後端
- 新增 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>

2026-05-17 22:26:14 +08:00

2.8 KiB

Raw Blame History

ADDED Requirements

Requirement: Laravel Mail 設定

系統 SHALL 支援透過 SMTP 寄送 Email 通知。本地開發環境使用 Mailpit（Docker service）攔截所有寄出信件，不真實發送。.env 設定：MAIL_MAILER=smtp、MAIL_HOST=mailpit（Docker service name）、MAIL_PORT=1025。

Scenario: 本地環境信件攔截

WHEN 系統觸發 Email 通知
THEN 信件出現在 Mailpit Web UI（http://localhost:8025），未真實寄出

Requirement: Queue Worker 處理 Email 投遞

Email 通知 SHALL 透過 Laravel Queue（QUEUE_CONNECTION=database）非同步投遞，不阻塞 HTTP response。Queue Worker 在 Docker Compose 中以獨立 service 啟動。

Scenario: Email 加入 Queue

WHEN 業務邏輯觸發 notify，via() 包含 'mail'
THEN Email job 進入 jobs 資料表，HTTP response 立即回傳

Scenario: Queue Worker 處理後寄出

WHEN queue:work 讀取到 Email job
THEN Mailable 被實際執行，信件送至 SMTP（本地為 Mailpit）

Scenario: 失敗重試

WHEN SMTP 連線失敗
THEN Job 重試最多 3 次（$tries = 3），超過後寫入 failed_jobs

Requirement: Email Markdown 模板

每種通知場景 SHALL 有對應的 Laravel Markdown Mailable 模板，存放於 resources/views/emails/notifications/。模板須包含：平台名稱（CFDivePlatform）、通知標題、正文、行動連結按鈕（CTA）、底部免責聲明。

涵蓋場景（共 6 種）：

booking-created.blade.php（給 Provider）
booking-confirmed.blade.php（給 Member）
booking-rejected.blade.php（給 Member）
booking-cancelled.blade.php（給對方）
booking-completed.blade.php（給 Member）
review-received.blade.php（給 Provider）

Scenario: Email 內容包含行動連結

WHEN Member 收到「預約已確認」Email
THEN 信件包含「查看預約」按鈕，點擊後導向 {APP_URL}/my-bookings/{id}

Scenario: Email 主旨語言

WHEN 系統寄出任何通知 Email
THEN 主旨以繁體中文撰寫（例：「你的預約已確認 — CFDivePlatform」）

Requirement: Email 通知觸發條件與收件人

事件	收件人	主旨
預約建立（pending）	Provider	你有新的預約申請
預約確認（confirmed）	Member	你的預約已確認
預約拒絕（rejected）	Member	你的預約申請未通過
預約取消（任一方）	對方	預約已取消
預約完成（completed）	Member	預約完成，歡迎留下評價
收到新評價	Provider	你收到了一則新評價

Scenario: 預約建立後 Provider 收到 Email

WHEN Member 成功建立預約（status 為 pending）
THEN 課程所屬 Provider 在 Queue 處理後收到「你有新的預約申請」Email

2.8 KiB Raw Blame History Unescape Escape