istlab/admin-crud

Laravel アプリのデータベーステーブルをブラウザ上から参照・インライン編集するための管理用 CRUD パッケージです。 ReviewHub の AdminController の CRUD 機能 (admin.crud*) を切り出したもので、デフォルト設定では元の URI・ルート名をそのまま再現します。

機能

• テーブル一覧と行数の表示 (GET /admin_crud)
• テーブル内容の表示・カラム絞り込み (LIKE / 整数完全一致)
• セルのクリック編集 (Ajax, POST /admin_crud)
• tinyint カラムのトグルスイッチ
• 行の追加 (Eloquent ファクトリ) / コピー (replicate) / 削除
• チェックした行の一括コピー・一括削除
• 全行削除 (truncate)
• AUTO_INCREMENT 値の設定 (MySQL / SQLite)
• 予約更新 (scheduled update) 連携 (オプション)

インストール

ローカルパスリポジトリとして読み込む場合:

// 宿主アプリ側 composer.json
"repositories": [
    {
        "type": "path",
        "url": "../CrudPkg",
        "options": { "symlink": true }
    }
],

composer require istlab/admin-crud:*
php artisan vendor:publish --tag=admin-crud-assets   # public/vendor/admin-crud に JS/CSS を配置 (必須)
php artisan vendor:publish --tag=admin-crud-config   # config/admin-crud.php を公開 (任意)

サービスプロバイダ (Istlab\AdminCrud\AdminCrudServiceProvider) はパッケージ自動検出で登録されます。

設定 (config/admin-crud.php)

ReviewHub で使う場合の設定例

// config/admin-crud.php
'layout_component' => 'app-layout',              // <x-app-layout> 内に描画
'jquery_url' => '/js/jquery.min.js',             // 既存の jQuery を利用
'scheduled_update_create_route' => 'scheduled_update.create',

app-layout を使う場合、レイアウトに @stack('localcss') と @stack('localjs') が必要です。

認可について

デフォルトでは role_any という Gate を $user->can('role_any', 'admin') の形で呼びます。 宿主アプリ側で次のような Gate を定義してください (ReviewHub では定義済みです):

Gate::define('role_any', function ($user, string $roles_str) {
    // $roles_str は 'admin|manager' のようなパイプ区切り
    ...
});

Gate を使わない場合は 'gate' => null にし、middleware で独自に保護してください。

旧実装からの移行 (ReviewHub)

1. 上記の設定でパッケージをインストール
2. routes/web.php の // begin CRUD 〜 // end CRUD のルート定義を削除
3. AdminController の crud* メソッドと resources/views/admin/crud*.blade.php は不要になります (パッケージ側が同じ URI・ルート名を引き継ぐため、既存の route('admin.crud', ...) へのリンクはそのまま動きます)

既存アプリとの共存

旧ルートを残したままインストールする場合は、ルート名・URI が衝突しないよう path と route_name_prefix を変更してください (例: 'path' => 'crud', 'route_name_prefix' => 'crud.')。

セキュリティ上の注意

• テーブル名は実在テーブルのホワイトリストで検証されます。
• 更新対象カラム名もスキーマ情報で検証されます。
• それでも本パッケージは任意テーブルを直接編集できる強力な管理機能です。必ず認証・認可を設定した上で、信頼できる管理者のみに公開してください。