管理後台
規則
- 資料表格:伺服器端分頁、排序與篩選 — 絕不在客戶端載入所有資料列 — 使用
?page=1&limit=25&sort=createdAt&order=desc - CRUD 模式:列表(表格)、建立(表單/對話框)、檢視(詳細檢視)、更新(編輯表單)、刪除(確認對話框)— 所有資源採用一致的版面配置
- 角色基礎存取控制:定義角色(admin、editor、viewer)搭配權限矩陣 — 在每個 API 路由的伺服器端檢查權限,而不僅是 UI
- 批次操作:選取多個資料列、批次動作(刪除、匯出、狀態變更)— 對破壞性動作進行確認,大量批次則在背景處理
- 搜尋:針對關鍵欄位進行防抖文字搜尋(300 毫秒)— 結合欄位篩選器進行精確查詢
- 使用者管理:列出使用者、檢視詳細資料、變更角色、停用/啟用帳號、模擬登入(僅限管理員並記錄稽核日誌)
- 稽核日誌:記錄誰在何時變更了什麼 —
{ userId, action, resource, resourceId, changes, timestamp } - 版面配置:側邊欄導覽(可折疊)、麵包屑、頁面標題搭配動作按鈕 — 支援響應式但以桌面為最佳化
權限檢查模式
const PERMISSIONS = {
admin: ["users:read", "users:write", "users:delete", "data:read", "data:write", "data:delete"],
editor: ["data:read", "data:write"],
viewer: ["data:read"],
} as const;
function can(role: string, permission: string): boolean {
return PERMISSIONS[role]?.includes(permission) ?? false;
}
// 中介軟體
if (!can(user.role, "users:write")) return Response.json({ error: "Forbidden" }, { status: 403 });
資料表格 API 模式
GET /api/admin/users?page=1&limit=25&sort=createdAt&order=desc&search=john&role=admin
回傳:{ data: [...], total: 150, page: 1, limit: 25, totalPages: 6 }
避免事項
- 僅在客戶端進行權限檢查 — 務必在伺服器端強制執行
- 先載入所有資料再於瀏覽器中分頁 — 使用伺服器端分頁
- 對破壞性動作不加以確認 — 刪除與批次操作一定要求確認
- 缺少稽核軌跡 — 你必須知道誰變更了什麼