TEHAI — 要件定義書 兼 Claude Code 実装指示書
版数 1.0(DBレス構成のデモ)/ 作成日 2026-10-06 / 発行 ソウゾウ合同会社 用途 業種特化アプリの実演デモ / 運輸・物流向け「配車表」
このドキュメントの使い方(Claude Code へ)
これ1枚が、規約・仕様・タスクのすべて。リポジトリ直下に CLAUDE.md として置き、毎回読み込むこと。
- 実装は「11. 実装タスク」の順に進める。フェーズを飛ばさない。
- 仕様に書かれていないことは推測で作らず質問する。質問できない状況では「判断に迷ったときのルール」で決め、
docs/DECISIONS.mdに1行ずつ残す。 - 3章の「作らないもの」は、思いついても作らない。
- 「デモだから」を理由に品質を落とさない。
- 配車係の言葉で書く。 画面の文言は、配車担当とドライバーと協力会社が毎日使っている言葉に合わせる(配車・配車表・案件・荷主・積地・卸地・積込日・自社便・傭車・協力会社・元請・一次請け・二次請け・請負次数・運行の指示・車番・車格・実運送体制管理簿・下請情報・実運送事業者情報)。「ユーザー」「タスク」「ステータス」「レコード」を画面に出さない。
このアプリが選ばれる理由 中小の運送会社の配車は、ホワイトボードとExcelで回っている。前日の夕方に、車・ドライバー・荷主・傭車先を割り当て、ドライバーには電話とLINEで指示を出す。2025年4月からは、傭車(利用運送)を使った運送について、元請は実運送体制管理簿を作らなければならなくなった。多くの会社は、配車表を見ながら管理簿を別のExcelに手で書き写している。 TEHAI は、いつもの配車表の形のまま割り当てれば、ドライバーへの運行の指示と、実運送体制管理簿が同じデータから出るようにする。 配車表と管理簿に同じことを2回入力する、ドライバーへの指示を電話で読み上げる、傭車先の車番やドライバー名を電話で聞き取って書き写す、のどれか1つでもあれば失敗とみなす。
課題定義
| 項目 | 内容 |
|---|---|
| 誰に刺すか | 傭車(協力会社)も使って配車を組む運送会社の配車担当・運行管理者(小さな会社では社長が兼ねる) |
| 場面 | 前日の夕方に翌日の配車を組むとき/荷主から急な追加・変更が入ったとき/実運送体制管理簿を作るとき・荷主から閲覧を求められたとき |
| 問題(ふわっと) | 「配車表はExcel、ドライバーへの指示は電話とLINE、管理簿は別に手で書き写している」(推測) |
| 理想 | 「配車を組んだら、ドライバーへの指示と管理簿が勝手にそろっていてほしい」 |
| 課題(ギャップ) | 配車表で「荷主・積込日・運送区間・貨物の内容・車番・ドライバー・自社便か傭車か(請負次数)」を一度入れれば、ドライバーのスマホへの運行の指示と、実運送体制管理簿が同じデータから出る状態にする |
| 見る前の感情 | 「配車システムは高い・大げさ」「うちの配車表の形と違う」「管理簿は面倒」 |
| 見た後の感情 | 「いつもの配車表の形のまま使える」「管理簿を別に作らなくていい」「ドライバーに送る手間が減る」 |
| 見せ場(必ず見せる) | ①ホワイトボードのような配車表(日付×車両)に案件を割り当てる。自社便か傭車か(何次請けか)もその場で選ぶ ②割り当てた内容がドライバーのスマホに運行の指示として届き、ドライバーが確認すると配車表に印が付く ③配車表から実運送体制管理簿(積込日・運送区間・貨物の内容・実運送事業者・請負次数・車番・ドライバー)をそのまま一覧にし、Excel と PDF で出せる |
| 既製品で足りる部分/作る価値 | 自動配車・最適ルート・GPSの動態管理まで要る会社は既製の配車システムで十分。作る価値は ①いまのホワイトボード・Excelの形のまま ②実運送体制管理簿が配車表から出る ③傭車先からの「実運送事業者情報」を電話でなくリンクで受け取れる、の3つ |
| 言わないこと | 「法令対応済み」「監査に通る」「この管理簿で義務を果たせる」/「運行指示書がそのまま作れる」(運行指示書の要件は未確認)/自動配車・最適ルート(デモは人が組む配車表)/実在の荷主・運送会社の名前 |
1. プロジェクト概要
背景(出典は末尾)
- 改正貨物自動車運送事業法(2025年4月1日施行)で、元請事業者は、真荷主から引き受けた貨物の運送について利用運送(傭車)を行ったとき、運送ごとに実運送体制管理簿を作らなければならない。引き受けた貨物をすべて自社で実運送する場合は作らなくてよい。
- 対象は、1荷主の1運送依頼あたり1.5トン以上の貨物(実運送する際の重量ではなく、真荷主から引き受けるときの重量で判断する)。
- 記載事項は ①実運送事業者の商号又は名称 ②実運送事業者が実運送を行う貨物の内容及び区間 ③実運送事業者の請負階層(一次請け・二次請け等)。国交省のイメージでは、これに積込日・車番・ドライバー名を並べた表になっている。
- 「既存の配車表を活用するなど、事業者の取り組みやすい形で作成可能。電磁的記録での作成も可」。運送を完了した日から1年間保存。真荷主は閲覧を請求できる。下請構造が固定化している場合は運送ごとに作らなくてよい。
- 情報通知の義務:利用運送を行う事業者は委託先へ「下請情報」(元請事業者の連絡先・真荷主の名称・委託先の請負次数)を、実運送事業者は元請へ「実運送事業者情報」(実運送事業者の名称・運送区間・貨物の内容・請負次数)を通知する。元請は、管理簿の対象である運送を委託するとき、その旨を委託先へ伝える。
- 検索:「実運送体制管理簿」1,600(2026年3月 2,900 → 8月 880)・運行指示書 720・配車表 480・配車システム 390・配車表 エクセル 90(ラッコキーワード 2026-10-05)。
プロダクト定義
| 項目 | 内容 |
|---|---|
| 名前 | TEHAI(てはい)※仮称。配車の「手配」 |
| 一言 | ホワイトボードの形のままの配車表。運行の指示と実運送体制管理簿が同じ配車から出る |
| 提供形態 | レスポンシブWebアプリ。フロントエンド完結(サーバー側の保存なし) |
| 見本の会社 | 「しろかね運送株式会社」(架空。運行管理の記録 WADACHI と同じ会社・同じ車両とドライバー)。自社車両8台・ドライバー10人・協力会社3社 |
| 主戦場 | 配車担当の事務所のPC(配車表)/ドライバーのスマホ(運行の指示)/協力会社のスマホ(実運送事業者情報の入力) |
デモとしての成功条件
- 開いた瞬間に「うちの配車表と同じ形」と分かる(日付×車両のマス目、マグネットのような案件の札)
- 明日の未配車の案件を、ドラッグか、押して選ぶだけで割り当てられる。休みのドライバー・車格不足・時間の重なりはその場で知らせる
- 傭車に回すと、管理簿の対象かどうか(元請か・1.5トン以上か)がその場で分かり、協力会社に送るリンクができる
- 協力会社がリンクを開いて車番・ドライバー(再委託なら二次請けの会社)を入れると、管理簿の空欄が埋まる
- ドライバーの画面に運行の指示が届き、「確認しました」で配車表に印が付く
- 実運送体制管理簿を真荷主ごと・期間で絞って、Excel と PDF で出せる
- リセットできる
2. アーキテクチャ方針 — データベースを持たない
- すべてブラウザ内で動く。保存は localStorage(見本から変わった分だけ)。見本は「見本を作った日(anchor)」から毎回同じものを組み立てる。
- 画面はストアを直接触らず
src/lib/repo/の関数とフックを使う(本番ではここを API に差し替える)。 - 判定(管理簿の対象・請負次数・割り当ての注意)は
src/lib/calc/の純粋な関数にし、テストを書く。 - 協力会社へのリンクは、デモでは同じブラウザの中で開く(
/p/:token)。本番ではログイン不要の期限つきリンクとして、サーバー側で発行・確認する。
判断に迷ったときのルール
- 迷ったら、前日の17時、明日の案件が12件並んだホワイトボードの前で、電話を片手に配車を組む配車担当を思い浮かべる
- 法令の判定は「対象かどうかの目安」として出し、言い切らない(言わないことを守る)
- 入力を1つ減らせるなら減らす。同じことを2回入れさせない
3. スコープ
作るもの
| ID | 機能 |
|---|---|
| F-01 | 配車表(週):行=自社車両8台+協力会社3社、列=7日。案件の札を置く。未配車の案件の置き場 |
| F-02 | 割り当て:ドラッグ(PC)/札を押して選ぶ(スマホ・キーボード)。自社便(車両・ドライバー)か傭車(協力会社・請負次数)か |
| F-03 | 割り当ての注意:ドライバーの休み・同じ車の時間の重なり・車格不足(重量・冷凍・ゲート)・免許(大型) |
| F-04 | 案件:一覧・新規・変更(荷主・受託の区分・積込日時・積地・卸地・貨物の内容・重量・必要な車) |
| F-05 | 管理簿の対象の判定:元請(真荷主から直接)か・利用運送(傭車)か・1.5トン以上か |
| F-06 | 協力会社へ送るリンク(下請情報つき)と、協力会社の入力画面(実運送事業者情報) |
| F-07 | 実運送体制管理簿:真荷主ごと・期間で絞る・空欄(未通知)の印・Excel/PDF |
| F-08 | 元請への通知(自社が下請として受けた案件):実運送事業者情報・下請情報の文面とPDF |
| F-09 | ドライバーの運行の指示:明日・今日の行程・確認しました・電話・運行管理の記録(WADACHI)へ |
| F-10 | 配車表の Excel(週) |
| F-11 | マスタ:車両・ドライバー・協力会社・荷主(閲覧と一部の変更) |
| F-12 | デモ切替(配車担当/ドライバー/協力会社)・リセット・スタートページ |
作らないもの(Won't have)
- 自動配車・最適ルート・地図・GPSの動態管理
- 運賃の計算・請求
- 運行指示書の様式(要件が未確認のため。「運行の指示」は画面での連絡)
- 拘束時間・休息期間の判定(台帳の別のデモ「拘束時間の見える化」で扱う)
- 実在の荷主・運送会社の名前
4. 役割とデモ切替
| 役割 | 見本の人 | できること |
|---|---|---|
| 配車担当 | 木村 達也(運行管理補助者・配車) | 配車表・案件・管理簿・通知・マスタ |
| ドライバー | 佐藤 健一(2号車)ほか2人 | 運行の指示を見る・確認する |
| 協力会社 | 東和輸送(一次請け) | 送られたリンクから実運送事業者情報を入れる |
上部の細い帯で切り替える。「デモをリセット」で見本に戻す。
5. 画面一覧
| パス | 画面 |
|---|---|
/ |
スタート(何のアプリかを3行で。配車表の見本が組み上がる動き) |
/b |
配車表(週)=ホーム |
/b/orders |
案件の一覧・新規 |
/b/ledger |
実運送体制管理簿 |
/b/notify |
元請への通知(自社が下請の案件) |
/b/partners |
協力会社・車両・ドライバー・荷主 |
/d |
ドライバー:運行の指示 |
/p/:token |
協力会社:実運送事業者情報の入力 |
6. 機能要件
6.1 配車表(このデモの心臓部)
| ID | 要件 |
|---|---|
| FR-101 | 週の表:行は自社車両(号車・車格・いつものドライバー)と協力会社(社名)、列は今日から7日。今日と明日の列を目立たせる。前の週・次の週へ動ける |
| FR-102 | マスには案件の札を時刻順に並べる。札=荷主の色の帯・積込時刻・積地→卸地・貨物・重量。傭車の札には「一次」「二次」の印、管理簿の対象には「簿」の印、運行の指示を確認済みなら「✓」 |
| FR-103 | 未配車の案件は上の置き場に積込日順に並ぶ。数を見出しに出す。明日の未配車があれば赤く数える |
| FR-104 | PCでは札をマスへドラッグして割り当てる。マスの日付と案件の積込日が違うときは、積込日を動かすか確かめる |
| FR-105 | 札を押すと割り当ての小窓(スマホは下からのシート):自社便(車両を選ぶとその日のドライバーが入る。替えられる)/傭車(協力会社・請負次数・再委託の有無)/外す |
| FR-106 | 割り当てる前に注意を出す(止めない):ドライバーの休み・同じ車の時間の重なり・車格不足(積載量・冷凍・ゲート)・大型免許が要る車に中型のドライバー |
| FR-107 | 割り当てを変えたら、ドライバーの確認を外し「変更あり」を知らせる |
| FR-108 | 週の配車表を Excel で出す(行と列は画面と同じ) |
6.2 案件と管理簿の判定
| ID | 要件 |
|---|---|
| FR-201 | 案件:荷主・受託の区分(真荷主から直接=元請/他社から=一次請け など)・積込日時・積地・卸地・貨物の内容・重量(トン)・必要な車(冷凍・ゲート・ウイング)・メモ |
| FR-202 | 管理簿の対象(目安):自社が元請 かつ 傭車に回した かつ 重量1.5トン以上。対象外の理由も短く出す(「全部自社で運ぶので作成不要」「1.5トン未満」「自社は下請」) |
| FR-203 | 請負次数:元請の自社から傭車に出すと協力会社は一次請け、協力会社がさらに再委託すると二次請け。自社が一次請けで受けた案件を傭車に出すと二次請け |
6.3 協力会社とのやり取り
| ID | 要件 |
|---|---|
| FR-301 | 傭車に回した案件ごとに、協力会社へ送るリンクと文面(下請情報:元請事業者の連絡先・真荷主の名称・委託先の請負次数/管理簿の対象であること)を作る。コピーできる |
| FR-302 | 協力会社の画面:案件の中身(積込日・区間・貨物)を見て、実運送事業者情報(自社で運ぶか・車番・ドライバー名、再委託するなら再委託先の社名と車番)を入れて送る。ログインなし |
| FR-303 | 届いた情報は管理簿にそのまま入る。届くまでは管理簿の欄に「未通知」と出し、管理簿の画面の先頭で数える |
6.4 実運送体制管理簿
| ID | 要件 |
|---|---|
| FR-401 | 真荷主ごとに、運送ごとの行:積込日・運送区間・貨物の内容・実運送事業者の商号又は名称・請負階層・車番・ドライバー名(国交省のイメージと同じ並び)。必須の3項目は見出しに印 |
| FR-402 | 期間・真荷主で絞る。未通知の行を先頭に |
| FR-403 | Excel と PDF で出す(真荷主ごとにシート・ページを分ける)。出した日時を残す |
| FR-404 | 画面の下に「運送を完了した日から1年間保存」「真荷主は閲覧を請求できる」を書く(目安として) |
6.5 元請への通知(自社が下請)
| ID | 要件 |
|---|---|
| FR-501 | 他社から受けた案件のうち、元請から管理簿の対象と伝えられたものを並べる |
| FR-502 | 自社で運んだもの:実運送事業者情報(自社名・区間・貨物・請負次数・車番・ドライバー)の文面。さらに傭車に出したもの:委託先への下請情報の文面 |
6.6 ドライバーの運行の指示
| ID | 要件 |
|---|---|
| FR-601 | 今日と明日の行程(積込時刻順):荷主・積地→卸地・貨物・重量・メモ・荷主の連絡先 |
| FR-602 | 「確認しました」で配車表に✓。変更があったら先頭に「変更あり」 |
| FR-603 | 「運行管理の記録(WADACHI)を開く」への導線(点呼と日報はそちらで) |
7. データ設計(要点)
type Basis = 'prime' | 'sub1' | 'sub2' // 受託の区分:元請/一次請け/二次請け
interface Order { id; shipperId; basis; primeName?; primeContact?; date; loadAt; loadPlace; dropPlace; cargo; tons; needs: ('冷凍'|'ゲート'|'ウイング')[]; note? }
interface Assignment { orderId; mode: 'own'|'charter'; vehicleId?; driverId?; partnerId?; reSub?: { company; plate? }; ackAt?; changedAt? }
interface CarrierInfo { orderId; selfCarry: boolean; plate?; driver?; reSubCompany?; reSubPlate?; at } // 協力会社から届いた実運送事業者情報
interface Partner { id; name; permit; contact; area }
- 請負次数・管理簿の対象・注意は保存せず、毎回算出する(
calc/rules.ts)。 - 見本は anchor の日の前後3週間。明日は未配車が5件・傭車3件(うち1件は未通知)・確認済みと未確認が混ざる。
8. デザイン要件
- 世界観:「事務所のホワイトボード」。白いボードに、荷主ごとの色のマグネットの札。罫線は細い灰、今日と明日の列だけ薄く色を敷く。ブランドは黒板の深緑 #1F5F3B(白文字 7:1 以上)、墨 #17201B、地 #F2F3EE。
- 札は角の丸い長方形+左に荷主の色の帯。荷主の色は6色(どれも白い地で文字が読める濃さ)。傭車は斜めの縞の地、管理簿の対象は「簿」の小さな角印。
- 注意は琥珀、休み・重なりは赤。色だけでなく文字と印を添える。
- ドライバーと協力会社の画面:スマホ前提。ボタンの高さ 56px 以上。
- 写真は、ドライバーの顔・車両・積み込み場所の入口の3種類だけ。写真が無いものは頭文字の丸・文字だけで出す。配車表の行には出さない(車格とドライバー名が切れるため)。ロゴ・空の状態の絵は SVG。
9. 技術
Vite 6 + React 19 + React Router 7 + Tailwind v4 + Zustand(persist)。PDF は @react-pdf/renderer(日本語は Noto Sans JP、押したときだけ読み込む)。Excel は fflate で .xlsx を組み立てる(WADACHI と同じ)。ドラッグは @dnd-kit/core(キーボード操作に対応させる)。Cloudflare Workers の静的アセットで配信。
10. 非機能
- 320px〜2560px で横にはみ出さない。配車表はスマホでは「日ごとの表示」に切り替える(車両が縦に並ぶ)
- 初期の JS は 200KB(gzip)以下。PDF・Excel は押したときだけ読み込む
- axe の重大な指摘0件。キーボードだけで割り当てられる
11. 実装タスク
Phase 1 — 土台と見本データ
- 型・マスタ(WADACHI と同じ車両・ドライバー+協力会社3社・荷主6社)・見本の生成(3週間)
- calc/rules.ts:請負次数・管理簿の対象・割り当ての注意。テスト
Phase 2 — 配車表
- 週の表・未配車の置き場・札・ドラッグ・割り当ての小窓・注意・スマホの日ごと表示
Phase 3 — 協力会社と管理簿
- 協力会社へのリンク・入力画面・管理簿・Excel/PDF・元請への通知
Phase 4 — ドライバー
- 運行の指示・確認・変更あり
Phase 5 — 仕上げ
- スタートページ・案件の一覧と新規・マスタ・配車表の Excel・レスポンシブ総点検・axe・公開
12. 受入基準
- 見せ場①〜③が動く
- 管理簿の対象の判定が、元請/下請・自社/傭車・1.5トンの境目(1.49t と 1.50t)で正しい(テスト)
- 協力会社の入力で、管理簿の未通知が埋まる
- 割り当てを変えると、ドライバーの確認が外れ「変更あり」が出る
- 320/375/768/1024/1280/1920px で横はみ出し0・文字の切れなし
- 「言わないこと」が画面の文言に入っていない
出典
- 国土交通省「改正貨物自動車運送事業法(令和7年4月1日施行)実運送体制管理簿の作成・情報通知の義務化」(近畿運輸局掲載のリーフレット、2026-10-06 確認)
- ラッコキーワード(Google・年平均の月間検索数、2026-10-05)

