Files
CFDivePlatform/openspec/specs/admin-stats/spec.md
T
a620906209 0cd1047b10
Run Tests / test (pull_request) Successful in 30s
docs(openspec): 補齊所有 spec 缺少的 Purpose section 與規格標頭
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
2026-08-03 04:11:06 +08:00

19 lines
767 B
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# admin-stats Specification
## Purpose
定義平台統計數據 API 的行為,回傳總會員數、總教練數、總課程數等核心經營指標,供管理員在 Admin Dashboard 快速掌握平台規模,僅限管理員角色存取。
## Requirements
### Requirement: 平台統計數據 API
後端 SHALL 提供 `GET /api/admin/stats`(需 Bearer tokenrole=admin),回傳平台核心數據。
#### Scenario: 取得統計數據
- **WHEN** 管理員送出 GET /api/admin/stats
- **THEN** 回傳 HTTP 200`{ status: true, data: { total_members: N, total_providers: N, total_offers: N } }`
#### Scenario: 非管理員存取
- **WHEN** 非 admin role 的 token 送出請求
- **THEN** 回傳 HTTP 403`{ status: false, message: "無權限存取" }`