Files
CFDivePlatform/openspec/changes/archive/2026-05-10-admin-panel/proposal.md
T
a620906209 ad2c05779d feat:實作 Admin Panel — 平台管理後台
後端:
- AdminStatsController:總會員/教練/課程數統計 API
- AdminUserController:會員與教練列表、詳情、啟用/停用、教練驗證(toggle 反轉語意)
- AdminOfferController:全平台課程列表與刪除
- routes/api.php:新增 /api/admin/stats、members、providers、offers 等路由

前端(frontend/):
- adminAuth store、adminAxios(第三套獨立認證)
- /admin/* 路由群組 + requiresAdmin guard
- AdminNavBar、AdminLayout
- App.vue:isCoachPage → isBackofficePage(/coach/* 和 /admin/* 皆隱藏會員 NavBar)
- LoginView、DashboardView(統計卡片)
- MembersView、ProvidersView(含驗證操作)、OffersView(含刪除確認)

OpenSpec:
- 新增 specs:admin-auth / admin-user-management / admin-offer-management / admin-stats / admin-panel-ui
- 歸檔:openspec/changes/archive/2026-05-10-admin-panel

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
2026-05-10 04:07:13 +08:00

1.9 KiB
Raw Blame History

Why

Member Portal 和 Coach Portal 已上線,但平台缺乏管理工具:教練驗證無法操作、問題帳號無法停用、課程品質無法把關。Admin Panel 補上這塊,讓平台可以實際營運。

What Changes

  • 後端:新增 AdminUserController 處理會員/教練的列表、詳情、啟用/停用、教練驗證
  • 後端:新增 AdminOfferController 處理全平台課程列表與刪除
  • 後端:新增 AdminStatsController 提供統計數據
  • 前端:新增 /admin/* 路由群組,包含登入、儀表板、用戶管理、課程管理、個人資料
  • 前端App.vue 擴充隱藏邏輯,/admin/* 也不顯示會員 NavBar

Capabilities

New Capabilities

  • admin-auth:管理員登入/登出/個人資料(沿用現有 AuthController 方法,不需新增)
  • admin-user-management:管理員查看、啟用/停用會員與教練,驗證/取消驗證教練
  • admin-offer-management:管理員查看全平台課程並刪除違規內容
  • admin-stats:平台統計數據 API(會員數、教練數、課程數)
  • admin-panel-ui:管理後台前端介面(儀表板、用戶管理、課程管理)

Modified Capabilities

(無)

Impact

後端

  • 新增 AdminUserControllerAdminOfferControllerAdminStatsController
  • 現有 AuthController Admin 方法(login / logout / profile)直接沿用,路由已存在
  • 所有新 Admin API 套用 auth:sanctum middleware 並在 Controller 層驗證 role === admin

前端(frontend/ 目錄)

  • 新增 src/stores/adminAuth.jssrc/api/adminAxios.js
  • 新增 src/layouts/AdminLayout.vuesrc/components/AdminNavBar.vue
  • 新增 src/views/admin/ 目錄下各頁面
  • src/router/index.js 新增 /admin/* 路由與 requiresAdmin guard
  • App.vue 隱藏邏輯擴充:/admin/* 同樣不顯示會員 NavBar