Files
CFDivePlatform/openspec/changes/realtime-booking-chat/specs/booking-lifecycle/spec.md
T
a620906209 ab24f210a6 feat: 即時預約聊天室(realtime booking chat)
## 新增功能
- 會員與教練在 confirmed 預約期間可互傳文字與圖片訊息
- Presence Channel 顯示對方在線狀態(即時加入/離線)
- 已讀回執:對方讀取訊息後即時更新
- 預約完成(completed)後訊息封存唯讀
- 圖片上傳使用 intervention/image 處理(移除 EXIF、限制尺寸、強制重新編碼)

## 通知系統
- 收到新訊息時 Bell Icon 即時更新(NotificationCreated via private channel)
- 預約列表卡片顯示未讀角標(GET /api/bookings/messages/unread-counts 批次查詢)
- 瀏覽器分頁在背景時推送 Web Notification

## 基礎建設
- 引入 Laravel Reverb 作為自架 WebSocket 伺服器
- docker-compose 新增 reverb service(連接 proxy_net,供 NPM 代理)
- 前端安裝 laravel-echo + pusher-js,初始化 Echo plugin
- Dockerfile 補 GD JPEG/WebP/FreeType 支援

## 清理
- 移除 test_broadcast.php 與 resources/js/echo.js(Blade 殘留)
- 移除 /ping、/testpost 測試路由
- channels.php 改用 class-based 授權語法,移除 debug log
- BookingChat.vue otherType 提取為 computed 消除重複
- docker-entrypoint.sh 健康檢查改用 env var 取代硬編碼密碼

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-28 03:59:14 +08:00

1.2 KiB
Raw Blame History

MODIFIED Requirements

Requirement: 預約狀態機

系統 SHALL 維護七個合法狀態,且只允許以下轉換:

  • pendingconfirmedProvider 確認)
  • pendingrejectedProvider 拒絕)
  • pendingmember_cancelledMember 取消)
  • pendingexpiredScheduler 超時)
  • confirmedcompletedScheduler 課程後自動)
  • confirmedmember_cancelledMember 取消)
  • confirmedprovider_cancelledProvider 取消)

各狀態對應訊息頻道語義:

  • confirmedpresence-booking.{id} 頻道開放,可讀寫訊息
  • completed:頻道關閉,訊息歷史封存唯讀
  • 其餘狀態(pendingrejectedexpiredmember_cancelledprovider_cancelled):無訊息頻道

Scenario: 非法狀態轉換被拒絕

  • WHEN 任何角色嘗試執行上述以外的狀態轉換
  • THEN 系統回傳 422,說明當前狀態不允許此操作

Scenario: confirmed 轉 completed 時封存訊息頻道

  • WHEN Scheduler 將 confirmed 預約轉為 completed
  • THEN 對應 presence-booking.{id} 頻道不再授權新連線;現有訊息歷史保留,後續 POST 訊息回傳 403