管理パネル
ルール
- データテーブル: サーバーサイドのページネーション、ソート、フィルタリング — すべての行をクライアント側で読み込まない —
?page=1&limit=25&sort=createdAt&order=descを使用 - CRUDパターン: 一覧(テーブル)、作成(フォーム/モーダル)、詳細表示、更新(編集フォーム)、削除(確認ダイアログ) — すべてのリソースで一貫したレイアウト
- ロールベースアクセス: ロール(admin, editor, viewer)を権限マトリックスで定義 — すべてのAPIルートでサーバーサイドの権限チェックを行い、UIだけで済ませない
- 一括操作: 複数行を選択し、バッチアクション(削除、エクスポート、ステータス変更) — 破壊的な操作には確認を要求し、大量のバッチはバックグラウンドで処理
- 検索: 主要フィールドに対するデバウンス付きテキスト検索(300ms) — カラムフィルターと組み合わせて正確なクエリを実行
- ユーザー管理: ユーザー一覧、詳細表示、ロール変更、アカウントの無効化/有効化、なりすまし(監査ログ付きで管理者のみ)
- 監査ログ: 誰がいつ何を変更したかを記録 —
{ 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 }
避けるべきこと
- クライアントサイドのみの権限チェック — 常にサーバー側で強制すること
- すべてのデータを読み込んでからブラウザでページネーションすること — サーバーサイドのページネーションを使用すること
- 破壊的な操作に対する確認がないこと — 削除や一括操作は常に確認すること
- 監査証跡の欠如 — 誰が何を変更したかを把握する必要があります