# 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（管理者・送迎表）／送迎の職員のスマホ（自分の便） |

## デモとしての成功条件

1. 開いた瞬間に、朝の送迎表（3台の便が路線図のように並ぶ）と、各便の到着予定が見える
2. 利用者を別の便へドラッグすると、両方の便の時刻がその場で数え直される。定員・車いすの席を超えると止まる
3. 職員を「送迎の職員（パート）」に切り替えると、スマホに自分の便だけが出る。他の便の利用者は出ない
4. 便の中の利用者を押すと、注意点の要約（3行）・地図・連絡先がワンタップで開く。要約のもとになったメモも見られる
5. 右の「AIアシスト」の電話・連絡メモに、電話で聞いたことをそのまま書いて「変更案を作成」を押すと、AIが「誰・内容・いつ・電話をくれた人」を読み取り、変更案（前 → 後の時刻と、何が変わるか）を出す。案は最大3つ。「確認して反映」を押すと送迎表と職員のスマホが同時に変わる。元に戻せる
8. 職員がスマホで「乗車を記録」すると、所長の送迎表の便にも乗車の進み具合が出る
6. 運転する職員は、出発の前にアルコール確認を入れないと「出発」を押せない。記録は一覧で見られ、CSVで出せる
7. リセットできる

---

# 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つまで。ほかの方の乗車が長くなるときは文で添える |
| 決めるのは人 | 案は「確認待ちの提案」に出すだけ。「確認して反映」を押すまで送迎表は変わらない（ボタンに重ねると変わったあとの道順が点線で見える）。決めたものは元に戻せる |

## 判断に迷ったときのルール

1. 迷ったら、朝7時半の事務所で、欠席の電話を受けながら、今日初めて送迎に出るパートの職員の顔を思い浮かべる
2. 送迎の職員の画面は、運転の前に片手で読める量だけにする（1人あたり3行）
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. 受入基準

1. 見せ場①〜④が動く
2. 計算とAIのテストがすべて通る（`npm test`）
3. 欠席の案を押すと、送迎表と送迎の職員のスマホが同時に変わる。元に戻すと両方戻る
4. 送迎の職員の画面に、他の便の利用者が1人も出ない
5. 320／375／768／1024／1280px で横はみ出し0・文字の切れなし
6. 「言わないこと」が画面の文言に入っていない

# 出典

- 厚生労働省「令和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）


---

## 付録　本番運用に向けて（ソウゾウ合同会社より）

> **この章は実装の対象ではありません。Claude Code は、この章の内容を実装しないでください。** 要件定義書を読んでいる方へのご案内です。

この要件定義書は、画面と動きを確かめるための**デモ**として書かれています。社内やお客さまに実際に使ってもらうには、次の4つが別に必要です。

| 項目 | デモでは | 本番では |
|---|---|---|
| データの保存 | データはその端末のブラウザの中にしか残りません。ほかの端末やほかの人とは共有されず、消えることもあります。 | サーバーのデータベースに保存し、バックアップと復元ができるようにします。 |
| セキュリティ | ログインがなく、誰でもすべての画面とデータを見られます。 | ログイン、権限（誰が何を見られるか）、通信とデータの暗号化、不正なアクセスへの対策を入れます。 |
| ガバナンス（運用ルール） | 決めていません。 | 誰がいつ何をしたかの記録、個人情報の扱い（プライバシーポリシー・同意）、アカウントの発行と削除、障害のときの連絡体制を決めます。 |
| 公開・デプロイ | 手元で動かすか、デモとして公開するだけです。 | 独自ドメイン、本番とテストの環境分け、更新の手順、監視と障害対応、月々の費用の管理を整えます。 |

本番運用をお考えの方は、ぜひ一度ご相談ください。最適なプランのご紹介と、進め方をお伝えします。

- 日程を選んで相談する（代表 西澤）：https://vszh6zudz50.jp.larksuite.com/scheduler/e7fecdad1a756dbe
- 公式LINE：https://lin.ee/UNwvWjp
- お問い合わせフォーム：https://service.souzoh-official.com/contact/
