YUTORI — 要件定義書 兼 Claude Code 実装指示書
版数 1.0(DBレス構成のデモ)/ 作成日 2026-10-07 / 発行 ソウゾウ合同会社 用途 業種特化アプリの実演デモ / 運輸・物流向け「拘束時間・休息期間の見える化」
このドキュメントの使い方(Claude Code へ)
これ1枚が、規約・仕様・タスクのすべて。リポジトリ直下に CLAUDE.md として置き、毎回読み込むこと。
- 実装は「11. 実装タスク」の順に進める。フェーズを飛ばさない。
- 仕様に書かれていないことは推測で作らず質問する。質問できない状況では「判断に迷ったときのルール」で決め、
docs/DECISIONS.mdに1行ずつ残す。 - 3章の「作らないもの」は、思いついても作らない。
- 「デモだから」を理由に品質を落とさない。計算は境目のテストが通るまで画面を作らない。
- 運行管理者と配車担当の言葉で書く。 画面の文言は、毎日使っている言葉に合わせる(拘束時間・休息期間・始業・終業・点呼・日報・配車・配車表・運行中・終業点呼・改善基準告示・延長・目安)。「ユーザー」「レコード」「ステータス」「アラート」を画面に出さない。
このアプリが選ばれる理由 2024年4月から、トラック運転者の改善基準告示が変わった(拘束時間 1か月284時間・休息期間は継続11時間が基本で9時間を下回らない)。ルールの名前は検索されている(「拘束時間」1,900・「改善基準告示」1,600)が、道具はほとんど探されていない(「拘束時間 管理」10)。デジタコのある大きい車は、デジタコや運行管理ソフトで集計できる。一方、デジタコのない小型車が中心の会社は、手書きの日報を月末にExcelで集計している。しかも「始業から24時間」で数える1日の拘束時間は、翌日の始業が早いと前日の分が延びるので、手で追うのが難しい。 YUTORI は、点呼・日報にもう入っている始業・終業の時刻から自動で積み上げ、配車を組む前に「今月の残り」と「明日いちばん早く始業できる時刻」を見せる。 月末まで集計しない、拘束時間の計算をExcelで手でやり直す、明日の配車を組んでから休息が足りないと気づく、のどれか1つでもあれば失敗とみなす。
課題定義
| 項目 | 内容 |
|---|---|
| 誰に刺すか | トラック運送会社の運行管理者・配車担当(2024年4月からの改善基準告示に合わせて、ドライバーごとの拘束時間と休息期間を確かめている) |
| 場面 | 前日の夕方に翌日の配車を組むとき(この人を入れると休息期間が足りるか)/月の後半(今月の拘束時間の残り)/労働基準監督署の調査や運輸局の監査の前 |
| 問題(ふわっと) | 「計算がややこしくて、Excelでは追いきれない。デジタコの集計は月末にしか見ない」(推測) |
| 理想 | 「配車を組む前に、この人はあと何時間入れるか、明日は何時から入れるかが分かっていてほしい」 |
| 課題(ギャップ) | 点呼・日報に入った始業・終業の時刻から、ドライバーごとの拘束時間(1日・1か月・1年)と休息期間を自動で積み上げ、配車を組む前に「今月の残り」と「翌日いちばん早く始業できる時刻」が分かる状態にする |
| 見る前の感情 | 「計算が複雑で、うちでは無理」「デジタコのない小さい車は手書きの日報だけ」「知らないうちに上限を超えていないか不安」 |
| 見た後の感情 | 「明日入れられるかが一目で分かる」「月末に慌てなくていい」「うちの日報の時刻のまま使える」 |
| 見せ場(必ず見せる) | ①ドライバーごとに、今月の拘束時間と残り(原則 月284時間に対して)が棒で見える ②翌日の配車で、休息期間が9時間を下回る組み方をすると、その場で注意が出る(継続11時間を基本とする目安も表示)③点呼・日報の始業・終業の時刻から自動で積み上がり、月の一覧をPDF・Excelで出せる |
| 既製品で足りる部分/作る価値 | 車両総重量7トン以上または最大積載量4トン以上の事業用トラックは運行記録計の装着が義務で、デジタコや運行管理ソフトで集計できる会社が多い。作る価値は ①デジタコのない小型車も日報の時刻から同じ基準で見られる ②集計を月末ではなく配車の前に見られる ③運行管理の記録・配車表とつながる、の3つ |
| 言わないこと | 「違反を防げる」「労基署の調査に通る」「法令対応済み」/正式な判定(表示は目安。最終的な判断は改善基準告示・労働基準監督署・社会保険労務士)/特例(長距離の例外・分割休息・2人乗務・フェリー)まで入っていると言わない |
1. プロジェクト概要
背景(出典は末尾)
トラック運転者の改善基準告示(2024年4月1日施行)の原則:
| 項目 | 原則 |
|---|---|
| 1年の拘束時間 | 3,300時間以内(労使協定で3,400時間まで) |
| 1か月の拘束時間 | 284時間以内(労使協定で、年6か月まで310時間まで。284時間超は連続3か月まで) |
| 1日の拘束時間 | 始業時刻から24時間について13時間以内。延長しても15時間まで。14時間を超える回数は週2回までが目安 |
| 休息期間 | 継続11時間以上を与えるよう努めることを基本とし、継続9時間を下回らない |
| 運転時間 | 2日平均で1日9時間、2週平均で1週44時間 |
| 連続運転時間 | 4時間以内 |
- 「始業から24時間」で数えるので、翌日の始業が前日の始業より早いと、早い分が前日の拘束時間に入る。例:8:00〜20:00(12時間)のあと翌日 6:00 始業 → 前日の1日の拘束時間は14時間。
- このため「休息期間9時間以上」と「1日の拘束時間15時間以内」は、同じ組み方で同時に崩れる(休息が9時間を切ると、前日の拘束は必ず15時間を超える)。
- 検索:拘束時間 1,900・改善基準告示 1,600・改善基準告示 トラック 590・トラック 拘束時間 390・休息期間 90・拘束時間 計算 70・拘束時間 管理 10・デジタコ 2,900(ラッコキーワード 2026-10-05)。
プロダクト定義
| 項目 | 内容 |
|---|---|
| 名前 | YUTORI(ゆとり)※仮称。「あと何時間入れるか」の余裕 |
| 一言 | 点呼・日報の時刻から、拘束時間と休息期間を自動で積み上げる。配車の前に見る |
| 提供形態 | レスポンシブWebアプリ。フロントエンド完結(サーバー側の保存なし) |
| 見本の会社 | 「しろかね運送株式会社」(架空。運行管理の記録 WADACHI・配車表 TEHAI と同じ会社・同じ車両とドライバー)。車両8台・ドライバー10人(夜間便・早朝の冷凍・10t・予備・週2日の人を含む) |
| 見本の場面 | 月の後半の木曜 17:30。運行管理者が明日(金曜)の配車を確かめている。見る日に関係なく同じ場面にするため、22〜28日の木曜を選ぶ(今月のその木曜がまだなら先月) |
| 主戦場 | 事務所のPC(今月の一覧・明日の配車)/運行管理者のスマホ(外出先で明日の配車を確かめる) |
デモとしての成功条件
- 開いた瞬間に、誰の今月が危ないかが分かる(284時間の線・このペースの見込み)
- 明日の配車で、休息が9時間を下回る人に赤い注意。理由(休息何時間・前日の拘束が何時間になるか)が文で出る
- 直し方(始業を何時にする/明日空いていて免許の足りる人に替える)を押すと、その場で注意が消える
- 「終業点呼」を入れると、棒がその時刻で確定し、明日の休息が数え直される
- 1か月の勤務が「24時間の帯」で見え、日をまたぐ勤務・次の日に入り込んだ分が分かる
- 月の一覧(全員+日別)を Excel と PDF で出せる
- リセットできる
2. アーキテクチャ方針 — データベースを持たない
- すべてブラウザ内で動く。保存は localStorage(見本から変えた分だけ:配車の予定の変更・入れた終業)。見本は場面の日から毎回同じものを組み立てる(決まった種の乱数)。
- 時刻は「2000-01-01 0:00 からの分」の壁時計で持つ。日付の計算は Date の UTC 側だけを使い、見る人の端末のタイムゾーンに左右されないようにする。
- 計算は
src/lib/calc/の純粋な関数。点呼・日報の時刻は書き換えず、毎回そこから数え直す。 - 画面はストアを直接触らず
src/lib/repo/の関数とフックを使う(本番ではここを点呼・日報・配車表の API に差し替える)。
計算の決まりごと(calc/engine.ts)
| 項目 | 決まり |
|---|---|
| 勤務 | 始業〜終業の1回。種類は「済んだ(終業点呼まで)」「運行中(終業は配車の予定)」「予定(配車表)」 |
| 1日の拘束時間 | その勤務の始業から24時間の窓に入る、自分の勤務+次の勤務(重なった分)の合計 |
| 休息期間 | 終業から次の始業まで |
| 1か月・1年 | 勤務ごとの「始業〜終業」の合計。重なった分を二重に数えない。日をまたぐ勤務は始業した日の月・年に入れる。1年は4月1日から |
| 段階 | 1日:13時間以下=原則/15時間以下=延長/超え=上限超え。休息:11時間以上=基本/9時間以上=基本未満/未満=下回る |
| 14時間超 | 週(日曜はじまり)に3回目以上で注意 |
| いちばん早い始業 | 前の終業+9時間(基本どおりなら+11時間) |
| このペースの見込み | 今月の済んだ勤務の1回あたりの平均 × 予定が入っていない残りの勤務日(休みの曜日を除く) |
判断に迷ったときのルール
- 迷ったら、木曜の17:30、明日の配車表を前に、戻っていないドライバーの終業時刻を気にしている運行管理者を思い浮かべる
- 判定は「目安」として出し、言い切らない(言わないことを守る)
- 数字の理由を必ず文で添える(「なぜ14時間15分なのか」まで書く)
3. スコープ
作るもの
| ID | 機能 |
|---|---|
| F-01 | 今月の拘束時間:ドライバーごとのゲージ(済んだ/運行中/配車の予定/このペースの見込み)と284時間の線・残り。残りが少ない順 |
| F-02 | 3つの数字:明日の配車で注意の人数/月末に残り24時間を切りそうな人数/いま運行中の人数 |
| F-03 | 今日の点呼から:運行中の人と「終業点呼」の入力(本番は WADACHI から自動) |
| F-04 | 明日の配車:配車表(TEHAI)の予定ごとに、休息期間の帯(9h・11h・前の始業から24hの線)と注意。直し方(始業を11h/9h後にする・替えられる人) |
| F-05 | 始業の予定の変更(15分きざみ) |
| F-06 | ドライバー別:1か月の24時間の帯・月の集計(回数・最大・13h超・15h超・14h超が週3回以上・休息の最短・9h未満・11h未満)・1年・直近の勤務と時刻の出どころ・前の月へ |
| F-07 | 月の一覧:全員の表/Excel(全員+1人1シート)/PDF(全員+1人1ページ) |
| F-08 | ルールのおさらい:原則と、デモに入っていないもの |
| F-09 | スタートページ・リセット |
作らないもの
- 特例(宿泊を伴う長距離の例外・分割休息・2人乗務・フェリー・隔日勤務)、労使協定による延長の切り替え
- 運転時間・連続運転時間の計算(デジタコの領分。日報の始業・終業だけでは数えられない)
- 休日労働の回数・時間外労働の集計・給与計算
- 配車表そのもの(TEHAI の領分)。点呼の記録そのもの(WADACHI の領分)
- 自動配車・最適化
4. 画面
| パス | 画面 |
|---|---|
/ |
スタート(夜空の地。今日の終業→明日の始業の帯を3人分。見せ場3つ) |
/m |
今月の拘束時間(F-01〜F-03) |
/m/tomorrow |
明日の配車(F-04・F-05) |
/m/d/:id |
ドライバー別(F-06) |
/m/books |
月の一覧(F-07) |
/m/rules |
ルールのおさらい(F-08) |
5. 見本データ
- 4月1日(場面の月の前の月が属する年度)から今週の土曜まで。ドライバーごとの決まったリズム(夜間便 20:30〜翌6:50 前後/冷凍 4:50〜/10t 5:00〜13時間前後 ほか)+決まった種の揺れ。ふだんは休息を9時間半以上空ける。
- 場面のための決め打ち:
- 高橋さん:今日 9:00〜21:40(運行中・荷待ちで遅れ)→ 明日 5:00 の予定 → 休息7時間20分・今日の拘束16時間40分
- 鈴木さん:今週の火・水に14時間超、今日 6:30〜19:45、明日 5:30 → 今日の拘束が14時間15分になり、今週3回目の14時間超。先週に休息8時間40分の日が1回
- 中村さん:今月は「このペースだと月末に284時間を少し超える」ように1回の長さを決める
- 吉田さん(予備):明日は空けておく(入れ替えの候補)
- 見本の場面が5つの日付で同じになることをテストで確かめる(
seed.test.ts)。
6〜8. 見た目
- 世界観は「24時間の帯」。勤務(拘束)は墨、休息は夜の藍、予定は藍の斜線、運行中は流れる縞、9時間未満の休息は朱で光らせる。地は温かい灰、面は白、上のバーは夜空。
- 数字は Inter(等幅数字)、日本語は Noto Sans JP。
- 注意は色だけに頼らず、必ず文と記号を添える。
9. 技術
Vite 6 + React 19 + React Router 7 + Tailwind v4 + Zustand(persist)。PDF は @react-pdf/renderer(日本語は Noto Sans JP、押したときだけ読み込む)。Excel は fflate で .xlsx を組み立てる(WADACHI・TEHAI と同じ)。Cloudflare Workers の静的アセットで配信。
10. 非機能
- 320px〜2560px で横にはみ出さない
- 初期の JS は 200KB(gzip)以下。PDF は押したときだけ読み込む
- 時刻の入力は 15分きざみの選択(端末の言語で AM/PM 表示にならないように)
11. 実装タスク
Phase 1 — 計算
- time.ts(壁時計の分)・rules.ts(原則の数字と出典)・engine.ts(1日の拘束・休息・月・年・注意)
- 境目のテスト:休息 8時間59分/9時間/11時間、日をまたぐ勤務、翌日の始業が早い分、13h/15h/15h01m、月284時間ちょうどと1分超え、月末にまたぐ勤務、年度の起算、14時間超の週3回目、重なり
Phase 2 — 見本データ
- マスタ・生成・場面の決め打ち・5つの日付での場面テスト
Phase 3 — 画面
- 外枠・今月・明日の配車・ドライバー別・月の一覧・ルール・スタート
Phase 4 — 仕上げ
- Excel・PDF・終業点呼・リセット・レスポンシブ総点検・公開
12. 受入基準
- 見せ場①〜③が動く
- 境目のテストがすべて通る(
npm test) - 直し方を押すと、注意がその場で消える。終業点呼を入れると、棒と明日の休息がその場で変わる
- 320/375/768/1024/1280px で横はみ出し0・文字の切れなし
- 「言わないこと」が画面の文言に入っていない
出典
- 厚生労働省「トラック運転者の改善基準告示」https://driver-roudou-jikan.mhlw.go.jp/truck/notice(2026-10-07 確認)
- 国土交通省 報道発表(2014-12-01)運行記録計の装着義務付け対象の拡大(車両総重量7トン以上又は最大積載量4トン以上)
- ラッコキーワード(Google・年平均の月間検索数、2026-10-05)

