# 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（今月の一覧・明日の配車）／運行管理者のスマホ（外出先で明日の配車を確かめる） |

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

1. 開いた瞬間に、誰の今月が危ないかが分かる（284時間の線・このペースの見込み）
2. 明日の配車で、休息が9時間を下回る人に赤い注意。理由（休息何時間・前日の拘束が何時間になるか）が文で出る
3. 直し方（始業を何時にする／明日空いていて免許の足りる人に替える）を押すと、その場で注意が消える
4. 「終業点呼」を入れると、棒がその時刻で確定し、明日の休息が数え直される
5. 1か月の勤務が「24時間の帯」で見え、日をまたぐ勤務・次の日に入り込んだ分が分かる
6. 月の一覧（全員＋日別）を Excel と PDF で出せる
7. リセットできる

---

# 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回あたりの平均 × 予定が入っていない残りの勤務日（休みの曜日を除く） |

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

1. 迷ったら、木曜の17:30、明日の配車表を前に、戻っていないドライバーの終業時刻を気にしている運行管理者を思い浮かべる
2. 判定は「目安」として出し、言い切らない（言わないことを守る）
3. 数字の理由を必ず文で添える（「なぜ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 — 計算
- [x] time.ts（壁時計の分）・rules.ts（原則の数字と出典）・engine.ts（1日の拘束・休息・月・年・注意）
- [x] 境目のテスト：休息 8時間59分／9時間／11時間、日をまたぐ勤務、翌日の始業が早い分、13h/15h/15h01m、月284時間ちょうどと1分超え、月末にまたぐ勤務、年度の起算、14時間超の週3回目、重なり
## Phase 2 — 見本データ
- [x] マスタ・生成・場面の決め打ち・5つの日付での場面テスト
## Phase 3 — 画面
- [x] 外枠・今月・明日の配車・ドライバー別・月の一覧・ルール・スタート
## Phase 4 — 仕上げ
- [x] Excel・PDF・終業点呼・リセット・レスポンシブ総点検・公開

# 12. 受入基準

1. 見せ場①〜③が動く
2. 境目のテストがすべて通る（`npm test`）
3. 直し方を押すと、注意がその場で消える。終業点呼を入れると、棒と明日の休息がその場で変わる
4. 320／375／768／1024／1280px で横はみ出し0・文字の切れなし
5. 「言わないこと」が画面の文言に入っていない

# 出典

- 厚生労働省「トラック運転者の改善基準告示」https://driver-roudou-jikan.mhlw.go.jp/truck/notice（2026-10-07 確認）
- 国土交通省 報道発表（2014-12-01）運行記録計の装着義務付け対象の拡大（車両総重量7トン以上又は最大積載量4トン以上）
- ラッコキーワード（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/
