MUKAE — 要件定義書 兼 Claude Code 実装指示書
版数 1.0(DBレス構成のデモ)/ 作成日 2026-10-13 / 発行 ソウゾウ合同会社 用途 業種特化アプリの実演デモ / 介護・福祉(デイサービス)向け「送迎表と送迎メモ」
このドキュメントの使い方(Claude Code へ)
これ1枚が、規約・仕様・タスクのすべて。リポジトリ直下に CLAUDE.md として置き、毎回読み込むこと。
- 実装は「11. 実装タスク」の順に進める。フェーズを飛ばさない。
- 仕様に書かれていないことは推測で作らず質問する。質問できない状況では「判断に迷ったときのルール」で決め、
docs/DECISIONS.mdに1行ずつ残す。 - 3章の「作らないもの」は、思いついても作らない。
- 「デモだから」を理由に品質を落とさない。時刻の計算と組み直しの案は、テストが通るまで画面を作らない。
- デイサービスの現場の言葉で書く。 画面の文言は、管理者・生活相談員・送迎の職員が毎日使っている言葉に合わせる(送迎・送迎表・迎え・送り・便・号車・運転・添乗・利用者・ご家族・欠席・お休み・振替・乗降介助・車いす・玄関・声かけ・申し送り・アルコール確認)。「ユーザー」「タスク」「ステータス」「ルート最適化」を画面に出さない。
このアプリが選ばれる理由 デイサービスの送迎は、管理者が前日に組んだ送迎表(Excel や紙)と、職員の頭の中にある「この方の玄関は段差が高い」「ご家族に先に電話」といった注意点で回っている。送迎だけ出るパートの職員を増やしたくても、注意点が送迎表と別々なので、初めての人には伝わらない。欠席の電話が朝に入ると、組み直しは管理者の頭の中でしかできない。 MUKAE は、送迎表を組むと、担当の職員のスマホに自分の便だけが出て、利用者ごとの注意点・地図・連絡先がワンタップで見えるようにする。欠席の連絡が入ったら、AIが組み直しの案を出し、決めるのは管理者。 注意点を送迎表とは別の紙で渡す、初めての職員に口で説明する、欠席が出るたびに管理者が全部組み直す、のどれか1つでもあれば失敗とみなす。
課題定義
| 項目 | 内容 |
|---|---|
| 誰に刺すか | デイサービスの管理者(送迎だけ出る職員・パートを増やしたい事業所) |
| 場面 | 毎朝夕の送迎の割り当て/欠席の連絡が入ったとき/初めて送迎に出る職員が利用者の家に向かうとき |
| 問題(ふわっと) | 「送迎だけ出る職員も今後ちょっと増やしていきたい」「スマホアプリで、送迎の注意点とか、地図もクリックしたら見れる、トラブルがあったときに連絡できるように」(デイサービスの管理者・2026-10-12 初回商談)/「在庫管理、送迎システムが外注」(介護の経営者・公式LINEの1問アンケート 2026-10-07) |
| 理想 | 送迎表を組むと、担当の職員のスマホに自分の便と利用者の注意点・地図・連絡先だけが出る。欠席が出ても組み直しがすぐできる |
| 課題(ギャップ) | 送迎表と利用者ごとの注意点が別々で、送迎だけの職員には伝わりにくい。組み直しが管理者の頭の中にある |
| 見る前の感情 | 送迎の段取りが管理者に集中している/送迎の仕組みを外注しているが、自分たちで変えられない |
| 見た後の感情 | 送迎だけの職員でも迷わずに回せる。自分たちで項目を変えられる |
| 見せ場(必ず見せる) | ①送迎表(便×車×職員×利用者)を組むと、担当者のスマホに自分の便だけが出る ②利用者ごとの注意点・地図・連絡先をワンタップで ③AI:電話メモをAIに渡すと、誰の・何の連絡かを読み取り、送迎の変更案を「AIアシスト」に出す。注意点メモの要約(申し送り)も(決めるのは人) ④運転する職員のアルコール確認の記録(運行管理のデモ WADACHI と同じ項目) |
| 既製品で足りる部分/作る価値 | 送迎の専用ソフト(配車計画・ルート作成・タブレット)はある(料金は公開されていないものが多い)。作る価値は、事業所ごとの注意点の持ち方・送迎だけの職員の見え方・アルコール確認の記録を1つにする部分 |
| 言わないこと | 「最適なルートを自動で決める」と断定する言い方(表示は「移動が少なくなる順の案」)/「法令対応済み」/「違反を防げる」 |
1. プロジェクト概要
背景(出典は末尾)
- 令和6年度の介護報酬改定で、送迎は、責任の所在などを明確にしたうえで、他事業所の利用者との同乗が認められた(厚生労働省「令和6年度介護報酬改定の主な事項」)。送迎の組み方の選択肢が増え、送迎表を組む手間はむしろ増える。
- 安全運転管理者の選任が必要な事業所(乗車定員11人以上の車1台以上、またはその他の車5台以上)は、運転の前後にアルコール検知器で酒気帯びの有無を確かめ、記録を1年間保存する(2023年12月1日から検知器の使用が義務。警察庁)。記録の項目は、確認者名・運転者名・自動車の登録番号・確認の日時・確認の方法・酒気帯びの有無・指示事項など。
- 検索:送迎表 170・デイサービス 送迎表 110・送迎表 エクセル 20・介護 送迎 システム 10・送迎ソフト 10(ラッコキーワード 2026-10-13・Google・年平均)。道具の名前より「送迎表」という帳票の名前で探されている。
プロダクト定義
| 項目 | 内容 |
|---|---|
| 名前 | MUKAE(むかえ)※仮称 |
| 一言 | 送迎表を組むと、担当の職員のスマホに自分の便だけが出る。注意点・地図・連絡先もワンタップ |
| 提供形態 | レスポンシブWebアプリ。フロントエンド完結(サーバー側の保存なし) |
| 見本の事業所 | 「ひだまりデイサービス」(架空。通常規模の通所介護・定員25名)。所在地は東京都練馬区大泉学園町のまわり(地図は実在。事業所・利用者は架空で、地点は道路の上の点)。利用者20名(今日来るのは16名)・車3台・職員6名 |
| 見本の場面 | 今日の朝 8:00。管理者が朝の送迎表を確かめ、送迎の職員がスマホで自分の便を開く前。8:05 に欠席の電話が入る |
| 主戦場 | 事務所のPC(管理者・送迎表)/送迎の職員のスマホ(自分の便) |
デモとしての成功条件
- 開いた瞬間に、朝の送迎表(3台の便が路線図のように並ぶ)と、各便の到着予定が見える
- 利用者を別の便へドラッグすると、両方の便の時刻がその場で数え直される。定員・車いすの席を超えると止まる
- 職員を「送迎の職員(パート)」に切り替えると、スマホに自分の便だけが出る。他の便の利用者は出ない
- 便の中の利用者を押すと、注意点の要約(3行)・地図・連絡先がワンタップで開く。要約のもとになったメモも見られる
- 右の「AIアシスト」の電話・連絡メモに、電話で聞いたことをそのまま書いて「変更案を作成」を押すと、AIが「誰・内容・いつ・電話をくれた人」を読み取り、変更案(前 → 後の時刻と、何が変わるか)を出す。案は最大3つ。「確認して反映」を押すと送迎表と職員のスマホが同時に変わる。元に戻せる
- 職員がスマホで「乗車を記録」すると、所長の送迎表の便にも乗車の進み具合が出る
- 運転する職員は、出発の前にアルコール確認を入れないと「出発」を押せない。記録は一覧で見られ、CSVで出せる
- リセットできる
2. アーキテクチャ方針 — データベースを持たない
- すべてブラウザ内で動く。保存は localStorage(見本から変えた分)。見本は「今日」を基準に毎回同じものを組み立てる。
- AIは外部につながない(2026-10-08 に決めたデモの方針:費用0円・毎回同じ動き・悪用されない)。組み直しの案と注意点の要約は、
src/lib/ai/の純粋な関数で、同じ入力なら同じ結果を返す。本番ではこの部分だけを Claude に差し替える(Brainの型を守る)。 - 本番で外部のAIを呼ぶときの決まり(デモでは画面の「本番での仕組み」に書くだけ):①AIに送るのは注意点メモの本文だけで、氏名・住所・電話番号は送らない(置き換えて送り、戻す)②1日の呼び出し回数と月の予算に上限を持たせ、超えたらルールの案に戻す ③利用者の情報(要配慮個人情報を含みうる)の保存先とログインは本番化の論点として説明する。
- 時刻は「その日の0:00からの分」で持つ。移動時間は、実在の道路データ(OpenStreetMap・OSRM)で数えた車の所要時間の表を使う(
geo/places.ts)。 - 地図:アプリの中は国土地理院の淡色地図(Leaflet)に、道路に沿った道順の線を引く。ナビ・道順は Googleマップの URL で開く(APIキーなし・費用0円)。本番では事業所と利用者の住所から、地図サービスで数え直す。
- 画面はストアを直接触らず
src/lib/repo/の関数とフックを使う。
計算の決まりごと(calc/)
| 項目 | 決まり |
|---|---|
| 便 | 朝の迎え(事業所に 9:30 到着)・夕方の送り(事業所を 16:00 出発)。1台に1便ずつ |
| 移動時間 | 実在の道路を車で走る時間(OSRM で数えた表・分は切り上げ)。事業所から一番遠い地点でおよそ6分 |
| 乗り降りの時間 | ふつう3分。歩行器・杖は5分、車いすは8分 |
| 迎えの時刻 | 到着時刻から逆算する。最後の家の出発 = 9:30 − 事業所までの移動。そこから順に前へ |
| 送りの時刻 | 16:00 から順に足す |
| 迎えの早すぎ | 利用者ごとの「この時刻より前は迎えに来ないで」(例 8:30)より早くなる組み方は、注意を出す |
| 定員 | 車ごとの定員(運転を除く)と車いすの席を超えて入れられない |
| 乗車時間 | 1人の乗っている時間が45分を超えると注意 |
AIの決まり(ai/)
| 項目 | 決まり |
|---|---|
| 組み直しの案 | 欠席が出た便から、その利用者を外して時刻を数え直す。案は最大3つ:①外すだけ(到着が何分早まるか)②空いた席に、ほかの便で迎えが早すぎる・乗車時間が長い利用者を移す(その便がどれだけ楽になるか)③便の順番を移動が少なくなる順に並べ直す(何分短くなるか)。どの案も「押すと何が起きるか」を書く。効果が無い案は出さない |
| 並べ直し | 事業所から遠い順に回る並びと、近い家から順に回る並びの2通りを試し、移動の合計が短いほうを案にする(「最適」とは言わない) |
| 注意点の要約 | 利用者ごとのメモ(日付・書いた人つき)から、「乗り降り」「声かけ」「家族・連絡」「家まわり」の4つの見出しのどれに当たるかを言葉で振り分け、安全にかかわる順(乗り降り → 家まわり → 声かけ → 家族・連絡)に、見出しごとに一番新しいものを1行ずつ、最大3行にする。要約のもとになったメモは必ず見られる |
| 電話メモの読み取り | 利用者の姓・職員の「〇〇さん」・続柄(娘・ご主人など)・お休みの言い回し・「〇時過ぎ/以降」・振替の言い回しを言葉で読み取る。どれにも当たらなければ「送迎メモに足す」にし、名前が無ければ誰のメモかを選んでもらう(止めない) |
| 時刻の希望の案 | 同じ便のまま回る順を後ろにする/ほかの便へ移す。どちらも合わなければ「組み直さず、ご家族に時刻を伝える」 |
| 運転の代わりの案 | 添乗の人が運転にまわる → 手のあいている運転できる人(送迎のみ → 生活相談員 → 介護職 → 所長の順に頼みやすい)。最大3つ |
| 振替の案 | 席が空いていて、その方の迎えが早すぎない便を2つまで。ほかの方の乗車が長くなるときは文で添える |
| 決めるのは人 | 案は「確認待ちの提案」に出すだけ。「確認して反映」を押すまで送迎表は変わらない(ボタンに重ねると変わったあとの道順が点線で見える)。決めたものは元に戻せる |
判断に迷ったときのルール
- 迷ったら、朝7時半の事務所で、欠席の電話を受けながら、今日初めて送迎に出るパートの職員の顔を思い浮かべる
- 送迎の職員の画面は、運転の前に片手で読める量だけにする(1人あたり3行)
- 時刻と案には、必ず理由を文で添える(「なぜ 8:42 なのか」まで書く)
3. スコープ
作るもの
| ID | 機能 |
|---|---|
| F-01 | 送迎表(朝・夕):3台の便を路線図のように並べ、利用者・時刻・運転・添乗・車を表示。ドラッグで便を移す・順番を変える。定員・車いす・迎えの早すぎ・乗車時間の注意 |
| F-02 | 今日来ない利用者・未割り当ての利用者のトレイ |
| F-03 | 欠席の連絡:利用者を選んで欠席にする(デモの「欠席の電話が入った」ボタンもある)→ AIアシストに変更案 |
| F-04 | 送迎の職員のスマホ:自分の便だけ。出発前のアルコール確認 → 順番に「乗りました/お休みでした」→ 事業所に到着 |
| F-05 | 利用者の送迎メモ:注意点の要約(3行)・メモの一覧と追加・地図(実在の地図・Googleマップで開く/ナビ)・連絡先(本人・ご家族) |
| F-11 | 送迎ルートの地図:送迎表の「地図で見る」と便ごとの「地図」で、全便または1便の道順を実在の地図に出す。便ごとに「Googleマップで道順を開く」。送迎の職員のスマホでは「道順を地図で見る」「Googleマップで開く」と、利用者ごとの「Googleマップでナビを始める」 |
| F-06 | アルコール確認の記録:運転の前後。確認者・運転者・車の登録番号・日時・方法・検知器の使用・数値・酒気帯びの有無・指示事項。一覧とCSV |
| F-07 | 職員・車・利用者の一覧(見本の内容を見る・注意点を足す) |
| F-08 | 本番での仕組み:介護ソフトの利用者データの取り込み、外部AIに送る範囲と上限、ログイン |
| F-09 | スタートページ・リセット |
| F-10 | 電話メモをAIに渡す:送迎表のいちばん上に置く。電話で聞いたことをそのまま書くと、AIが読み取ったこと(誰・内容・いつ・電話をくれた人)を見せ、1つのボタンで次の動きにつなぐ。お休み → 組み直しの案/迎えの時刻の希望 → 間に合う組み方の案/職員が送迎に出られない → 代わりに運転できる人の案/振替で今日も来る → 入れやすい便の案/それ以外 → 送迎メモに足す。「ためしに」の見本を4つ置く。音声入力:メモ欄の「話して入力」を押して話すと、話した言葉がその場でメモに入る(ブラウザの音声認識・日本語。使えないブラウザでは理由を出す)。デモの帯の「欠席の電話が入った」は、このメモに電話の内容を入れる |
作らないもの
- ルートの自動計算・アプリ内のカーナビ・位置情報の追跡(ナビは Googleマップに任せる)
- 介護記録・請求・LIFE(介護ソフトの領分。置き換えない)
- 他事業所との同乗の調整・委託契約の管理
- 実際の電話・メッセージ送信(押すと「デモのため架空の番号です」と出す)
- 送迎加算・減算の計算
4. 画面
| パス | 画面 | 主な人 |
|---|---|---|
/ |
スタート(見せ場4つと、管理者/送迎の職員の入口) | — |
/m |
今日の送迎表(朝・夕の切り替え) | 管理者 |
/m/riders /m/riders/:id |
利用者と送迎メモ | 管理者 |
/m/alcohol |
アルコール確認の記録 | 管理者 |
/m/master |
職員と車 | 管理者 |
/m/how |
本番での仕組み | 管理者 |
/d |
自分の便(スマホ) | 送迎の職員 |
/d/stop/:id |
利用者の注意点・地図・連絡先 | 送迎の職員 |
/d/alcohol |
出発前・帰着後のアルコール確認 | 送迎の職員 |
画面上部に、デモの帯(黒地):見る人の切り替え(管理者・所長 早川さん/送迎の職員 小林さん(パート・送迎のみ)/介護職 中村さん)、「欠席の電話が入った(デモ)」、リセット、「これはデモです。AIは外部につながず、このブラウザの中だけで動きます」。
5. 見本データ
- 利用者20名(架空)。曜日ごとの利用日・車いす/歩行器/杖・「この時刻より前は来ないで」・家の座標・連絡先(本人・ご家族、架空の番号)・メモ(2〜7件、日付と書いた人つき)。今日来るのは16名。
- 車3台:1号車(ハイエース・定員8・車いす2席・登録番号は架空)/2号車(セレナ・定員6)/3号車(軽ワゴン・定員3・車いす1席)。
- 職員6名:所長(管理者)・生活相談員・介護職2名・送迎のみのパート2名。運転と添乗を朝夕で割り当てる。
- 朝の便は、組んだ状態で始める。1号車の最初の原田さまが「8:45より前は来ないで」に引っかかり、乗っている時間も45分を超える、の2つの注意をわざと入れておく(組み直しの案②「空いた席に移す」が効く場面を作るため。原田さまの家は2号車の道すじに近い)。
- 8:05 の欠席:2号車の松本さま(ご家族から「熱が出たので休みます」)。
6〜8. 見た目
- デザイン画像(2026-10-13 受領)を正とする。 世界観は「送迎の路線図」。便は路線の線、利用者は駅(停留所)、事業所は終点の家の印。車ごとに色を分ける(橙・青・緑)。
- 地は薄いグレー、面は白、差し色は深緑。注意は赤で、必ず文と記号を添える。
- 管理者のPCは、左にメニュー(今日の送迎・利用者・職員・車両・アルコール確認・変更履歴・設定)、真ん中に車両別の送迎ルート、右に「AIアシスト」(電話・連絡メモ → 変更案を作成 → 確認待ちの提案 → 確認して反映 → 直近の変更)。チャットの窓・キラキラの印・紫のグラデーションは使わない。
- 送迎の職員のスマホは、次のお迎え1人を大きく(名前・到着予定・乗り方・申し送りのAI要約・地図・連絡・乗車を記録)、このあとのお迎えを下に。下に「送迎・連絡・記録」のタブ。
- 送迎の職員のスマホは、大きな文字・大きなボタン。1人あたり注意点は3行まで。
- 日本語は Noto Sans JP、数字は等幅の数字。
9. 技術
Vite 6 + React 19 + React Router 7 + Tailwind v4 + Zustand(persist)。地図は国土地理院の淡色地図+Leaflet、道順と所要時間は OSRM(OpenStreetMap)で一度だけ数えて同梱、ナビは Googleマップの URL。Cloudflare Workers の静的アセットで配信。
10. 非機能
- 320px〜2560px で横にはみ出さない
- 初期の JS は 200KB(gzip)以下
- 送迎の職員の画面は、ボタンの高さ 48px 以上・文字 16px 以上
11. 実装タスク
Phase 1 — 計算とAI
- travel.ts(移動時間・乗り降り)・route.ts(迎え・送りの時刻・注意)
- ai/replan.ts(欠席の組み直し案)・ai/summary.ts(注意点の要約)
- ai/phone.ts(電話メモの読み取り)とテスト:お休み・迎えの時刻・職員・振替・気づいたこと・名前の無いメモ
- テスト:到着 9:30 からの逆算、車いすの乗り降り、定員・車いす席の超え、「この時刻より前は来ないで」、乗車45分、欠席の3案(効果が無い案を出さない)、要約の見出しと並び
Phase 2 — 見本データ
- 事業所・町・利用者20・車3・職員6・メモ・アルコール確認の記録(過去2週間)
Phase 3 — 画面
- 外枠・デモの帯・送迎表・AIアシスト・利用者と送迎メモ・地図・職員のスマホ(送迎・連絡・記録)・アルコール確認・職員と車・変更履歴・本番での仕組み・スタート
Phase 4 — 仕上げ
- 元に戻す・CSV・リセット・レスポンシブ総点検・公開
12. 受入基準
- 見せ場①〜④が動く
- 計算とAIのテストがすべて通る(
npm test) - 欠席の案を押すと、送迎表と送迎の職員のスマホが同時に変わる。元に戻すと両方戻る
- 送迎の職員の画面に、他の便の利用者が1人も出ない
- 320/375/768/1024/1280px で横はみ出し0・文字の切れなし
- 「言わないこと」が画面の文言に入っていない
出典
- 厚生労働省「令和6年度介護報酬改定の主な事項」(送迎における他事業所の利用者との同乗)
- 警察庁「安全運転管理者制度の概要」/道路交通法施行規則の改正(アルコール検知器の使用、2023年12月1日施行。記録は1年間保存)https://www.npa.go.jp/bureau/traffic/insyu/index-2.html
- ラッコキーワード(Google・年平均の月間検索数、2026-10-13)
- デイサービスの管理者との初回商談(2026-10-12)、公式LINEの1問アンケート(2026-10-07)

