CFDivePlatform/openspec/changes/provider-verification-gaps/specs/provider-verification/spec.md at 3384210c5c42dbbb4d3d690a7fd313ec21853c89

a620906209/CFDivePlatform

Fork 0

Files

T

a620906209 99cf35c1ec

Run Tests / test (pull_request) Successful in 2m1s

Details

docs: 稽核文檔改為執行紀錄、開 provider-verification-gaps change 規劃遺留缺口

- 稽核報告：已完成的修補計畫改寫為執行紀錄（commit 對照表 + 偏差說明），
  未處理事項收斂為三項（verification 缺口 / 效能優化 / 新功能路線圖）
- 新 change provider-verification-gaps：規劃 schedules/reviews 公開子端點
  過濾與預約入口檢查（含「既有預約不受影響」政策決定），待實作

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

2026-06-11 19:06:34 +08:00

1.7 KiB

Raw Blame History

ADDED Requirements

Requirement: 公開子端點套用相同可見性

課程的公開子端點（GET /api/diving-offers/{id}/schedules、GET /api/diving-offers/{id}/reviews）SHALL 套用與課程詳情相同的可見性規則：課程屬未驗證教練時回傳 HTTP 404。

Scenario: 隱藏課程的時段查詢回 404

WHEN 匿名使用者請求 GET /api/diving-offers/{id}/schedules，該課程屬未驗證教練
THEN 回傳 HTTP 404

Scenario: 隱藏課程的評價查詢回 404

WHEN 匿名使用者請求 GET /api/diving-offers/{id}/reviews，該課程屬未驗證教練
THEN 回傳 HTTP 404

Scenario: 可見課程的子端點正常

WHEN 課程屬已驗證教練或 provider_id 為 null
THEN 時段與評價端點照常回傳資料

Requirement: 未驗證教練的課程不可建立新預約

POST /api/member/bookings SHALL 在建立預約前驗證 schedule 所屬課程可預約（provider_id 為 null 或教練 is_verified = true），不符時回傳 HTTP 422，不建立預約。既有預約（pending / confirmed / completed）SHALL 不受教練驗證狀態變動影響：教練仍可處理 pending、confirmed 的聊天與完課流程照常、completed 可正常評價。

Scenario: 未驗證教練課程的新預約被拒絕

WHEN 會員以未驗證教練課程的 schedule_id 送出預約
THEN 回傳 HTTP 422，{ status: false, message: "此課程目前不開放預約" }，不建立 Booking

Scenario: 教練被取消驗證後既有預約照常

WHEN 教練在預約 confirmed 之後被取消驗證
THEN 該預約的聊天、完課、評價流程照常運作；僅新預約被擋

1.7 KiB Raw Blame History Unescape Escape