# 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. 開いた瞬間に「うちの配車表と同じ形」と分かる（日付×車両のマス目、マグネットのような案件の札）
2. 明日の未配車の案件を、ドラッグか、押して選ぶだけで割り当てられる。休みのドライバー・車格不足・時間の重なりはその場で知らせる
3. 傭車に回すと、管理簿の対象かどうか（元請か・1.5トン以上か）がその場で分かり、協力会社に送るリンクができる
4. 協力会社がリンクを開いて車番・ドライバー（再委託なら二次請けの会社）を入れると、管理簿の空欄が埋まる
5. ドライバーの画面に運行の指示が届き、「確認しました」で配車表に印が付く
6. 実運送体制管理簿を真荷主ごと・期間で絞って、Excel と PDF で出せる
7. リセットできる

---

# 2. アーキテクチャ方針 — データベースを持たない

- すべてブラウザ内で動く。保存は localStorage（見本から変わった分だけ）。見本は「見本を作った日（anchor）」から毎回同じものを組み立てる。
- 画面はストアを直接触らず `src/lib/repo/` の関数とフックを使う（本番ではここを API に差し替える）。
- 判定（管理簿の対象・請負次数・割り当ての注意）は `src/lib/calc/` の純粋な関数にし、テストを書く。
- 協力会社へのリンクは、デモでは同じブラウザの中で開く（`/p/:token`）。本番ではログイン不要の期限つきリンクとして、サーバー側で発行・確認する。

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

1. 迷ったら、前日の17時、明日の案件が12件並んだホワイトボードの前で、電話を片手に配車を組む配車担当を思い浮かべる
2. 法令の判定は「対象かどうかの目安」として出し、言い切らない（言わないことを守る）
3. 入力を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. データ設計（要点）

```ts
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. 見せ場①〜③が動く
2. 管理簿の対象の判定が、元請／下請・自社／傭車・1.5トンの境目（1.49t と 1.50t）で正しい（テスト）
3. 協力会社の入力で、管理簿の未通知が埋まる
4. 割り当てを変えると、ドライバーの確認が外れ「変更あり」が出る
5. 320／375／768／1024／1280／1920px で横はみ出し0・文字の切れなし
6. 「言わないこと」が画面の文言に入っていない

# 出典

- 国土交通省「改正貨物自動車運送事業法（令和7年4月1日施行）実運送体制管理簿の作成・情報通知の義務化」（近畿運輸局掲載のリーフレット、2026-10-06 確認）
- ラッコキーワード（Google・年平均の月間検索数、2026-10-05）


---

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

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

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

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

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

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