a620906209
0cd1047b10
Run Tests / test (pull_request) Successful in 30s
repo 內 35/38 份既有 spec 都是舊版歸檔流程留下的原始 delta 內容（`## ADDED Requirements`，缺標題與 Purpose），openspec CLI 現版本嚴格驗證 （--strict）會報錯或警告。逐一補上： - 缺標題/Purpose 的 30 份：加上 `# <name> Specification` 標題 + 依內容 撰寫的 Purpose 段落，`## ADDED Requirements` 改回 `## Requirements` - compose-cloud-baseline、scheduler-container：已有標題與 Requirements，只補 Purpose 包裝 - provider-verification：已有標題與 Purpose，只需把 `## ADDED Requirements` 改回 `## Requirements` - admin-user-management、notification-email：各有一條 requirement 缺 SHALL/MUST 關鍵字（純敘述句或表格），補上規範用語，內容不變 `openspec validate --specs --strict`：38/38 全過（原本 4/38）。純文件 補齊，未變更任何 requirement 的實質內容或行為描述。 Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_011LpcY9b7y9x4fusHBTXciQ
96 lines
4.2 KiB
Markdown
96 lines
4.2 KiB
Markdown
# coach-offers-api Specification
|
||
|
||
## Purpose
|
||
|
||
定義教練課程管理 API 的 provider_id 所有權驗證不變式與 CRUD 端點行為，確保教練只能查看與操作自己的課程。
|
||
|
||
## Requirements
|
||
|
||
### Requirement: provider_id 所有權不變式
|
||
對單一課程操作端點（show / update / destroy），系統 MUST 依序執行：先以 id 查找課程（不存在回 404），再比對 provider_id（不符回 403）。兩步驟不可合併為單一 WHERE 查詢。`store()` MUST 強制將 `provider_id` 設為 `auth()->id()`，忽略 request body 傳入值。
|
||
|
||
#### Scenario: 課程不存在回傳 404
|
||
- **WHEN** 指定 id 的課程不存在於資料庫
|
||
- **THEN** 回傳 HTTP 404，`{ status: false, message: "課程不存在" }`
|
||
|
||
#### Scenario: 課程存在但非本人回傳 403
|
||
- **WHEN** 課程存在（id 有效）但 `offer.provider_id !== auth()->id()`
|
||
- **THEN** 回傳 HTTP 403，`{ status: false, message: "無權限…" }`
|
||
|
||
#### Scenario: store 強制設定 provider_id
|
||
- **WHEN** 教練送出新增課程請求，body 中包含任意 provider_id 值
|
||
- **THEN** 系統忽略該值，`offer.provider_id` 固定為 `auth()->id()`
|
||
|
||
---
|
||
|
||
### Requirement: 教練課程列表
|
||
後端 SHALL 提供 `GET /api/provider/offers`（需 Bearer token，role=provider），回傳當前登入教練自己建立的課程，支援分頁。
|
||
|
||
#### Scenario: 取得自己的課程列表
|
||
- **WHEN** 已登入教練送出 GET 請求
|
||
- **THEN** 回傳 HTTP 200，只包含 `provider_id = auth()->id()` 的課程，含分頁 meta
|
||
|
||
#### Scenario: 無課程時回傳空陣列
|
||
- **WHEN** 教練尚未建立任何課程
|
||
- **THEN** 回傳 HTTP 200，`{ status: true, data: [], meta: { total: 0, ... } }`
|
||
|
||
---
|
||
|
||
### Requirement: 教練課程詳情
|
||
後端 SHALL 提供 `GET /api/provider/offers/{id}`（需 Bearer token，role=provider），回傳單一課程完整資料，只允許查看自己建立的課程。
|
||
|
||
#### Scenario: 取得自己的課程詳情
|
||
- **WHEN** 已登入教練送出 `GET /api/provider/offers/1`，且該課程 `provider_id = auth()->id()`
|
||
- **THEN** 回傳 HTTP 200，`{ status: true, data: { ...offer } }`
|
||
|
||
#### Scenario: 查看他人課程
|
||
- **WHEN** 課程存在但 `provider_id !== auth()->id()`
|
||
- **THEN** 回傳 HTTP 403，`{ status: false, message: "無權限查看此課程" }`
|
||
|
||
#### Scenario: 課程不存在
|
||
- **WHEN** 指定 id 的課程不存在
|
||
- **THEN** 回傳 HTTP 404，`{ status: false, message: "課程不存在" }`
|
||
|
||
---
|
||
|
||
### Requirement: 教練新增課程
|
||
後端 SHALL 提供 `POST /api/provider/offers`（需 Bearer token），建立新課程並自動設定 `provider_id` 為當前登入教練。
|
||
|
||
#### Scenario: 新增課程成功
|
||
- **WHEN** 教練送出包含 title / location / spot / price / region 的合法資料
|
||
- **THEN** 回傳 HTTP 201，`{ status: true, data: { ...offer, provider_id: <coach_id> } }`
|
||
|
||
#### Scenario: 缺少必填欄位
|
||
- **WHEN** 教練送出缺少 title 或 price 的資料
|
||
- **THEN** 回傳 HTTP 422，`{ status: false, message: "...", errors: { field: [...] } }`
|
||
|
||
---
|
||
|
||
### Requirement: 教練更新課程
|
||
後端 SHALL 提供 `PUT /api/provider/offers/{id}`（需 Bearer token），更新指定課程，只允許修改自己建立的課程。
|
||
|
||
#### Scenario: 更新自己的課程
|
||
- **WHEN** 教練送出合法更新資料且 offer.provider_id === auth()->id()
|
||
- **THEN** 回傳 HTTP 200，`{ status: true, data: { ...updated_offer } }`
|
||
|
||
#### Scenario: 嘗試更新他人課程
|
||
- **WHEN** offer.provider_id !== auth()->id()
|
||
- **THEN** 回傳 HTTP 403，`{ status: false, message: "無權限修改此課程" }`
|
||
|
||
#### Scenario: 課程不存在
|
||
- **WHEN** 指定 id 的課程不存在
|
||
- **THEN** 回傳 HTTP 404，`{ status: false, message: "課程不存在" }`
|
||
|
||
---
|
||
|
||
### Requirement: 教練刪除課程
|
||
後端 SHALL 提供 `DELETE /api/provider/offers/{id}`（需 Bearer token），刪除指定課程，只允許刪除自己建立的課程。
|
||
|
||
#### Scenario: 刪除自己的課程
|
||
- **WHEN** offer.provider_id === auth()->id()
|
||
- **THEN** 回傳 HTTP 200，`{ status: true, message: "課程已刪除" }`，資料庫記錄移除
|
||
|
||
#### Scenario: 嘗試刪除他人課程
|
||
- **WHEN** offer.provider_id !== auth()->id()
|
||
- **THEN** 回傳 HTTP 403，`{ status: false, message: "無權限刪除此課程" }`
|