Filament のスケジュールのボードで、外回りの技術者に作業を割り当てる
修理会社の朝 8 時です。夜のあいだに 14 件の作業が入りました。詰まった排水口、分電盤の交換、水が抜けない食洗機。今日外に出る技術者は 4 人で、それぞれ得意な分野があり、もう入っている作業もあります。手配の担当者は、新しい作業を 1 件ずつだれかの 1 日に入れていきます。同じ人に同じ時間の作業を 2 つ入れてはいけません。
ふつうの Filament の管理画面では、作業ごとにフォームを開き、技術者を選び、開始の時刻を打って保存し、その技術者がその時間に空いていたかを別の一覧で確かめることになります。14 件もあれば、担当者は横に紙のタイムラインを置くことになります。
この記事では、Warp Scheduler のデモの「作業の手配ボード」を見ていきます。技術者ごとに 1 行の 1 日のタイムラインがあり、その横のふつうの Filament の表に技術者待ちの作業が並び、作業を行へドラッグすれば割り当てられます。画像はどれもライブデモで撮りました。
場面:ボードと、技術者待ちの作業
左は出張チームの 1 日で、08:00 から 18:00 まで、技術者ごとに 1 行あり、名前の下に得意な分野が出ます。右は技術者を待っている作業で、急ぎかどうかと長さが付いています。
手順 1:技術者ごとに 1 行のスケジューラー
ボードは、Warp Scheduler を使う Filament のウィジェットです。行は自分のアプリの Technician の記録、箱は WorkOrder の記録で、NoOverlap が「1 人に同じ時間の作業は 1 つ」を守ります。
use Qalainau\FilamentWarpScheduler\Conflicts\NoOverlap;
use Qalainau\FilamentWarpScheduler\Enums\SchedulerView;
use Qalainau\FilamentWarpScheduler\Enums\TimelineZoom;
use Qalainau\FilamentWarpScheduler\EventSource;
use Qalainau\FilamentWarpScheduler\Scheduler;
public function scheduler(Scheduler $scheduler): Scheduler
{
return $scheduler
->resources(fn () => Technician::query()->where('team', 'Field')->orderBy('name'))
->resourceLabel('技術者')
->resourceDescription('skill')
->views([SchedulerView::ResourceTimeline])
->timelineZooms([TimelineZoom::Day, TimelineZoom::Week])
->visibleHours('08:00', '18:00')
->conflictRules([NoOverlap::make()])
->onExternalDrop(fn (array $data, CarbonImmutable $start, ?Technician $resource): ?WorkOrder =>
$this->assignWaitingWorkOrder($data, $start, $resource))
->events([
EventSource::make(WorkOrder::class)
->resource('technician_id')->start('starts_at')->end('ends_at')
->title('title')->subtitle('customer')
->color(fn (WorkOrder $record): string => $record->priority === 'urgent' ? 'danger' : 'primary'),
]);
}
手順 2:表の行をドラッグできるようにする
技術者待ちの作業は、ふつうの Filament の表のウィジェットです。Filament 5 の表には行の属性がないので、タイトルの列に、スケジューラーが探す属性を付けます。そのセルが、つかんでドラッグする所になります。
TextColumn::make('title')
->description(fn (WorkOrder $record): string => $record->customer)
->extraAttributes(fn (WorkOrder $record): array => [
'draggable' => 'true',
'data-warp-scheduler-draggable' => e(json_encode(['id' => $record->id])),
'data-warp-scheduler-title' => $record->title,
'data-warp-scheduler-duration' => $record->duration_minutes,
'data-warp-scheduler-color' => $record->priority === 'urgent' ? 'danger' : 'primary',
]),
JSON は e() で囲んでください。Filament は属性の値をエスケープしないので、引用符がそのまま入ると属性がそこで切れ、落としても何も起きません。duration は、ドラッグ中の箱の長さになります。
手順 3:作業を技術者の行へドラッグする
担当者は「Blocked drain」をタイトルでつかみ、Diego さんの行へドラッグします。ドラッグの間、ボードは落ちる場所と正確な時刻を見せます。
落とすと、onExternalDrop() に、属性に入れた id、マウスの下の開始の時刻、行の技術者が渡されます。作業を入れるのは自分のコールバックです。
protected function assignWaitingWorkOrder(array $data, CarbonImmutable $start, ?Technician $resource): ?WorkOrder
{
// $data はブラウザから届く。範囲をしぼったクエリで探し、fill() には渡さない
$workOrder = WorkOrder::query()->unscheduled()->find($data['id'] ?? null);
if (! $workOrder || ! $resource) {
return null;
}
$workOrder->update([
'technician_id' => $resource->getKey(),
'starts_at' => $start,
'ends_at' => $start->addMinutes($workOrder->duration_minutes),
]);
return $workOrder;
}
記録を返せば、ボードはすぐにそれを描きます。デモでは、落としたあとにスケジューラーが出すブラウザのイベントで表も読み込み直すので、作業は技術者待ちから消えます。
手順 4:ボードが予定の重なりを断る
担当者は考え直します。排水口なら配管の人が行くべきです。作業を Ben Carter さんの行へドラッグしますが、Ben さんには 09:00 から 12:00 の作業がもう入っています。手を離す前に、ボードは赤い帯で「ほかの予定と重なっています」と出します。
NoOverlap はドラッグの間に確かめられます。ここで落とすと、作業はメッセージ付きで Diego さんの行に戻ります。変更を保存するときには、サーバーでもう一度決まりを確かめるので、古いままのブラウザからでもすり抜けられません。ほかの決まりも同じように足せます。
->conflictRules([
NoOverlap::make()->capacity('capacity'), // 同時に 2 件受けられる人もいる
WithinAvailability::make()->warn(), // 勤務時間の外は、断らずに注意だけ
NoBlockedTime::make(), // 休みとふさがった時間
])
自分のコードから ChangeRejected を投げれば、自分の言葉で断れます(「Chloe さんはガスの資格がありません」など)。
手順 5:長引いた作業を延ばす
Chloe さんは 10:00 から空いているので、作業は Chloe さんに入れました。そこへお客さんから電話があります。思ったより悪いようです。担当者は箱の右の端を 30 分右へ引きます。
「週の一覧」を押すと、同じボードが 1 週間の表示になります。金曜にもう予定が詰まっている人は、ここで分かります。
ほかにも使える場面
- 配送:注文をトラックや運転手に割り当てる。
- 教室:授業の申し込みを先生の行に入れる。
- 訪問介護・通訳:訪問を担当者に入れる。勤務時間は
WithinAvailabilityで。 - 工場・整備場:作業を機械や作業場に入れる。1 ページの 2 つのボードの間で
onAdopt()を使って作業を引き継げます。
知っておきたい制限
- 行のない所(技術者のいない所)に落とすと、
$resourceはnullになります。それをどう扱うかはコールバックで決めます。デモでは何もしません。 - 決まりは、保存のトランザクションの前に確かめられます。2 人の担当者が同じ枠にほぼ同時に落とすと、両方とも通ることがあります。コールバックの中でロックをかけて確かめ直す書き方が README にあります。
$dataはブラウザから届きます。リクエストの入力と同じに扱い、使う人とテナントで範囲をしぼったクエリとポリシーで確かめてください。- ドラッグ元の表がないときは、
unscheduledPool()で、開始の時刻がない作業をボードの横に並べられます。それぞれのボタンで、最初に空いている枠に入れられます。
試してみる
作業の手配ボードを開いてください。技術者待ちの作業をタイトルでつかんで技術者の行へ落とし、次に予定の入っている人の所へドラッグしてみてください。登録はいらず、データは 1 時間ごとに元に戻ります。