Warp

Filament のスケジュールのボードで、外回りの技術者に作業を割り当てる

読む時間 9 分

修理会社の朝 8 時です。夜のあいだに 14 件の作業が入りました。詰まった排水口、分電盤の交換、水が抜けない食洗機。今日外に出る技術者は 4 人で、それぞれ得意な分野があり、もう入っている作業もあります。手配の担当者は、新しい作業を 1 件ずつだれかの 1 日に入れていきます。同じ人に同じ時間の作業を 2 つ入れてはいけません。

ふつうの Filament の管理画面では、作業ごとにフォームを開き、技術者を選び、開始の時刻を打って保存し、その技術者がその時間に空いていたかを別の一覧で確かめることになります。14 件もあれば、担当者は横に紙のタイムラインを置くことになります。

この記事では、Warp Scheduler のデモの「作業の手配ボード」を見ていきます。技術者ごとに 1 行の 1 日のタイムラインがあり、その横のふつうの Filament の表に技術者待ちの作業が並び、作業を行へドラッグすれば割り当てられます。画像はどれもライブデモで撮りました。

場面:ボードと、技術者待ちの作業

左は出張チームの 1 日で、08:00 から 18:00 まで、技術者ごとに 1 行あり、名前の下に得意な分野が出ます。右は技術者を待っている作業で、急ぎかどうかと長さが付いています。

Aiko Tanaka・Ben Carter・Chloe Martin・Diego Ruiz の 4 人の技術者の行がある 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 さんの行へドラッグします。ドラッグの間、ボードは落ちる場所と正確な時刻を見せます。

ドラッグの途中。Batz Ltd の Blocked drain の作業が Diego Ruiz の行の 10:30 の上にあり、11/19 10:30〜11:30 の印が出ている
落とす前に、15 分単位に合わせた時刻が見えます。
表から Diego さんの午前へ、1 回のドラッグで。

落とすと、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;
}

記録を返せば、ボードはすぐにそれを描きます。デモでは、落としたあとにスケジューラーが出すブラウザのイベントで表も読み込み直すので、作業は技術者待ちから消えます。

Blocked drain の作業が Diego Ruiz の行の 10:30 から 11:30 に入り、技術者待ちの表からは消えている
Diego さんの 10:30〜11:30 に入り、技術者待ちから消えました。

手順 4:ボードが予定の重なりを断る

担当者は考え直します。排水口なら配管の人が行くべきです。作業を Ben Carter さんの行へドラッグしますが、Ben さんには 09:00 から 12:00 の作業がもう入っています。手を離す前に、ボードは赤い帯で「ほかの予定と重なっています」と出します。

Leaking tap の作業がもう入っている Ben Carter の行の上に作業をドラッグしている。赤い帯に 11/19 10:30〜11:30・ほかの予定と重なっています とある
NoOverlap はドラッグの間に確かめられます。ここで落とすと、作業はメッセージ付きで Diego さんの行に戻ります。

変更を保存するときには、サーバーでもう一度決まりを確かめるので、古いままのブラウザからでもすり抜けられません。ほかの決まりも同じように足せます。

->conflictRules([
    NoOverlap::make()->capacity('capacity'),   // 同時に 2 件受けられる人もいる
    WithinAvailability::make()->warn(),        // 勤務時間の外は、断らずに注意だけ
    NoBlockedTime::make(),                     // 休みとふさがった時間
])

自分のコードから ChangeRejected を投げれば、自分の言葉で断れます(「Chloe さんはガスの資格がありません」など)。

手順 5:長引いた作業を延ばす

Chloe さんは 10:00 から空いているので、作業は Chloe さんに入れました。そこへお客さんから電話があります。思ったより悪いようです。担当者は箱の右の端を 30 分右へ引きます。

Chloe Martin の行の Blocked drain の作業が 10:30〜12:00 に延びている
Chloe さんの行で 10:30〜12:00 になりました。ほかの作業にかかるまで延ばすと、これも断られます。

「週の一覧」を押すと、同じボードが 1 週間の表示になります。金曜にもう予定が詰まっている人は、ここで分かります。

ほかにも使える場面

  • 配送:注文をトラックや運転手に割り当てる。
  • 教室:授業の申し込みを先生の行に入れる。
  • 訪問介護・通訳:訪問を担当者に入れる。勤務時間は WithinAvailability で。
  • 工場・整備場:作業を機械や作業場に入れる。1 ページの 2 つのボードの間で onAdopt() を使って作業を引き継げます。

知っておきたい制限

  • 行のない所(技術者のいない所)に落とすと、$resource は null になります。それをどう扱うかはコールバックで決めます。デモでは何もしません。
  • 決まりは、保存のトランザクションの前に確かめられます。2 人の担当者が同じ枠にほぼ同時に落とすと、両方とも通ることがあります。コールバックの中でロックをかけて確かめ直す書き方が README にあります。
  • $data はブラウザから届きます。リクエストの入力と同じに扱い、使う人とテナントで範囲をしぼったクエリとポリシーで確かめてください。
  • ドラッグ元の表がないときは、unscheduledPool() で、開始の時刻がない作業をボードの横に並べられます。それぞれのボタンで、最初に空いている枠に入れられます。

試してみる

作業の手配ボードを開いてください。技術者待ちの作業をタイトルでつかんで技術者の行へ落とし、次に予定の入っている人の所へドラッグしてみてください。登録はいらず、データは 1 時間ごとに元に戻ります。

ほかの記事

乱れたお客さんの CSV を Filament に取り込む。保存の前に全部直す

古いシステムから移るとき、書き出したファイルは列の名前が違い、壊れたメール・名前の抜け・同じお客さんの 2 行が混ざっています。列を合わせ、問題を全部見て、セルを直してから取り込みます。

Filament のフォームで、同じお客さんの二重登録を保存の前に防ぐ

メールを大文字で、電話番号をかっこ付きで打つと、同じお客さんがもう 1 件できてしまいます。打っている人に知らせ、いるお客さんを見せて、一覧をきれいに保ちます。

Excel の注文を Filament の Repeater に貼り付ける

お客さんから届いた 120 行の注文の表を、Filament の Repeater にそのまま貼り付けます。商品は自動で選ばれ、合計も計算し直されるので、打ち直しはいりません。

Filament × AI コーディングのコツをメールで

Warp のプラグインを自分のシステムにうまく組み込む方法と、Claude Code や Cursor との組み合わせ方(通じる頼み方、AI がよく間違える所、実例)を月 1〜2 回。いつでも解除できます。

Warp について何でも聞いてください

メールアドレスも登録もいりません。

質問はすべて読んで、ふだん 1 日以内にこのサイトでお答えします。ほかの人に見えるのは、こちらで確認してからです。

Warp のプラグインをまだ使っていない理由は何ですか?

1 問だけです。答えはすべて読み、次に何を作るかをこれで決めます。サイトには載りません。

Warp のプラグインをまだ使っていない理由は何ですか?