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