cb9c9a9385
- Token 過期時間設為 7 天(sanctum.php expiration) - prune-expired 每日排程清除過期 token 記錄 - Google OAuth redirect 改用 URL fragment(#token=)避免 token 出現在 server log - SocialAuthController env() 改 config() 修正 config:cache 下 redirect 失效問題 - 登入端點加 rate limiting:member/provider throttle:5,1,admin throttle:3,1 - axios/coachAxios 加 401 response interceptor,token 過期自動登出 - 修正 migration SQLite 相容性(MODIFY COLUMN),Feature tests 從 7 通過恢復至 41 - 新增 AuthRateLimitTest(5 tests)驗證各角色頻率限制行為 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
48 lines
1.9 KiB
Markdown
48 lines
1.9 KiB
Markdown
## ADDED Requirements
|
||
|
||
### Requirement: 管理員登入
|
||
後端 SHALL 提供 `POST /api/admin/login`(現有 AuthController 方法),驗證 email/password 並確認 role=admin,回傳有效期 7 天的 Bearer token。
|
||
|
||
#### Scenario: 正確帳密登入
|
||
- **WHEN** 管理員送出正確 email 與 password
|
||
- **THEN** 回傳 HTTP 200,`{ status: true, data: { user, token, token_type: "Bearer" } }`
|
||
|
||
#### Scenario: 非 admin 角色帳號嘗試登入
|
||
- **WHEN** role 非 admin 的帳號嘗試呼叫此端點
|
||
- **THEN** 回傳 HTTP 401,`{ status: false, message: "電子郵件或密碼錯誤" }`
|
||
|
||
#### Scenario: 超過登入頻率限制
|
||
- **WHEN** 同一 IP 在 1 分鐘內送出超過 3 次登入請求
|
||
- **THEN** 回傳 HTTP 429,帶有 `Retry-After` header
|
||
|
||
---
|
||
|
||
### Requirement: 管理員登出
|
||
後端 SHALL 提供 `POST /api/admin/logout`(需 Bearer token),撤銷當前 token。
|
||
|
||
#### Scenario: 登出成功
|
||
- **WHEN** 已登入管理員送出登出請求
|
||
- **THEN** 回傳 HTTP 200,`{ status: true, message: "..." }`,token 失效
|
||
|
||
---
|
||
|
||
### Requirement: 管理員個人資料
|
||
後端 SHALL 提供 `GET /api/admin/profile`(需 Bearer token),回傳管理員基本資訊與 AdminProfile。
|
||
|
||
#### Scenario: 取得個人資料
|
||
- **WHEN** 已登入管理員送出 GET 請求
|
||
- **THEN** 回傳 HTTP 200,包含 name / email / role / adminProfile(position / department)
|
||
|
||
---
|
||
|
||
### Requirement: 管理員 Bearer Token 有效期
|
||
後端 SHALL 發行有效期為 7 天的管理員 Bearer Token,過期後需重新登入。
|
||
|
||
#### Scenario: Token 過期後管理員請求被拒絕
|
||
- **WHEN** 管理員使用已過期(超過 7 天)的 token 送出 API 請求
|
||
- **THEN** 回傳 HTTP 401,token 視為無效
|
||
|
||
#### Scenario: 有效期內 token 正常通過認證
|
||
- **WHEN** 管理員使用未過期的 token 送出 API 請求
|
||
- **THEN** 請求正常通過認證,回傳對應資源
|