登録種別管理機能仕様書
機能概要
登録種別管理機能は、ECサイトで扱う登録種別マスタを管理するための管理画面機能です。登録種別の作成、編集、削除、一覧表示、並び替えなどの操作が可能です。
URL: /admin/basic-master/register-types
ナビゲーション: 店舗管理グループ > 基本マスタクラスター
技術スタック: Filament v4, Livewire v3
画面構成
一覧画面（List Register Types）
登録種別の一覧を表示し、検索、ソート、並び替え、削除などの操作が可能です。
テーブルカラム
| カラム名 | 表示内容 | 検索 | ソート | 表示/非表示 |
|---|---|---|---|---|
| 名称 | name |
✅ | ✅ | 常時表示（インライン編集可能） |
| 表示順序 | sort_order |
- | ✅ | 常時表示（インライン編集可能） |
| 有効 | is_active |
- | - | 常時表示（トグル） |
| 作成日時 | created_at |
- | - | 常時表示 |
機能詳細
検索機能
- 名称（name）で検索可能
- リアルタイム検索（入力と同時にフィルタリング）
ソート機能
- デフォルトソート: sort_order 昇順
- 名称、表示順序でソート可能
並び替え機能
- ドラッグ&ドロップで表示順序を変更可能
- sort_order カラムの値を自動更新
インライン編集 - 名称と表示順序をテーブル内で直接編集可能 - 編集後、自動的に保存
トグル編集 - 有効/無効をテーブル内で直接切り替え可能 - 切り替え後、自動的に保存
作成画面（Create Register Type）
新しい登録種別を作成するためのフォーム画面です。
フォーム項目
| 項目名 | フィールド名 | 必須 | 最大文字数 | 説明 |
|---|---|---|---|---|
| 名称 | name |
✅ | 100 | 登録種別名 |
| 表示順序 | sort_order |
✅ | - | 表示順序（数値、自動設定: 最大値+1） |
| 有効 | is_active |
- | - | 有効/無効トグル（デフォルト: true） |
バリデーション
| 項目 | ルール |
|---|---|
| 名称 | 必須、最大100文字 |
| 表示順序 | 必須、数値 |
バリデーション
フォームバリデーション
| フィールド | ルール | エラーメッセージ |
|---|---|---|
name |
required, max:100 |
名称は必須です / 名称は100文字以内で入力してください |
sort_order |
required, integer |
表示順序は必須です / 表示順序は数値で入力してください |
技術仕様
ファイル構成
app/Admin/Clusters/BasicMaster/Resources/RegisterTypes/
├── RegisterTypeResource.php # メインリソースクラス
└── Pages/
├── ListRegisterTypes.php # 一覧ページ
└── CreateRegisterType.php # 作成ページ
app/Models/
└── RegisterType.php # モデルクラス
モデル機能
リレーション
- products(): hasMany(Product::class) - この登録種別に属する商品
スコープ
- active(): is_active = true の登録種別を取得
- ordered(): sort_order でソート
関連機能
商品管理機能との連携
- 商品作成・編集画面で登録種別を選択可能
- デフォルト値: 1（最初の登録種別）
基本マスタ共通機能
- 登録種別管理は基本マスタクラスター配下の機能です
- 他の基本マスタ（都道府県、国、性別、職業）と同様の構造を持ちます