# SHAKO — 要件定義書 兼 Claude Code 実装指示書

**版数** 1.0（DBレス構成のデモ）／ **作成日** 2026-10-22 ／ **発行** ソウゾウ合同会社
**用途** 業種特化アプリの実演デモ ／ 運輸・物流（トラック運送）向け「車両管理」
**台帳** Lark Base「X・SEO・YouTube管理」デモアプリ表 `reczz28MiaDPYNGa`（29番・定義の状態：確定 2026-10-13・第2弾・担当 海野）

---

## このドキュメントの使い方（Claude Code へ）

これ1枚が、規約・仕様・タスクのすべて。リポジトリ直下に `CLAUDE.md` として置き、毎回読み込むこと。

- 実装は「11. 実装タスク」の順に進める。フェーズを飛ばさない。
- 仕様に書かれていないことは推測で作らず質問する。質問できない状況では「判断に迷ったときのルール」で決め、`docs/DECISIONS.md` に1行ずつ残す。
- 3章の「作らないもの」は、思いついても作らない。
- 「デモだから」を理由に品質を落とさない。**期限の計算・日常点検の取り込み・紙の読み取りは、テストが通るまで画面を作らない。**
- **運送会社の現場の言葉で書く。** 画面の文言は、整備管理者・運行管理者・ドライバーが毎日使っている言葉に合わせる（車両・号車・車番・車種・車両台帳・整備管理者・運行管理者・日常点検・日常点検表・3か月点検・12か月点検・定期点検・車検・車検証・満了日・自賠責・任意保険・入庫・整備工場・整備の記録・点検整備記録簿・不良・異常なし・交換・球切れ・溝・空気圧・走行距離・予備車）。「ユーザー」「タスク」「ステータス」「アセット」「メンテナンス」を画面に出さない。

> **このアプリが選ばれる理由**
> トラック運送会社の車両は、毎日の日常点検、3か月ごとの定期点検、毎年の車検、自賠責・任意保険と、期限の違うものを1台ずつ抱えている。ところが現場では、日常点検は点呼のついでに紙や別のアプリで、定期点検は整備工場の記録簿で、車検と保険の満了日は Excel やホワイトボードで管理されていて、「どの車の何がいつ切れるか」は整備管理者の頭の中にある。日常点検で出た不良が、そのあと直されたかも追えない。
> SHAKO は、**車両台帳に、日常点検・定期点検・車検・保険の期限と整備の記録を1台ずつまとめ、期限が近い車を真っ先に見せる。日常点検の結果は運行管理の記録（WADACHI）から自動で入り、紙の日常点検表は写真を撮るだけでAIが読み取って下書きにする。** 不良を直すか、その車を走らせるかを決めるのは整備管理者。
> 期限を Excel に別で書く、日常点検を手で写す、不良が直ったかを人に聞いて回る、のどれか1つでもあれば失敗とみなす。

---

## 課題定義（台帳より）

| 項目 | 内容 |
|---|---|
| 誰に刺すか | トラック運送会社の整備管理者・運行管理者（車両が10台を超え、点検・車検・保険の期限を紙やExcelで追っている） |
| 場面 | 3か月点検・12か月点検・車検・保険の期限が近い車を探すとき／日常点検で不良が出た車の整備の記録を残すとき |
| 問題（ふわっと） | （本人の言葉は未取得）推測：点検・車検・保険の期限が車ごとにバラバラで、うっかり切らしそうになる |
| 理想 | 車両ごとの台帳に、日常点検・定期点検・車検・保険の期限と整備の記録がまとまり、期限が近い車が一目で分かる |
| 課題（ギャップ） | 日常点検（運行管理の記録）と車両の台帳・整備の記録が別々で、期限の管理が人の記憶に頼っている |
| 見る前の感情 | 期限切れが怖いが、車両管理の専用ソフトを入れるほどではない |
| 見た後の感情 | 点呼や日常点検と同じデータで、車両の期限まで見られる。自分たちの車の数に合わせて作れる |
| 見せ場（必ず見せる） | ①車両台帳（車番・車種・車検・保険）と、期限が近い車の一覧 ②日常点検の結果（運行管理の記録デモの部品）が車両ごとに自動で入り、不良が出た車に整備の記録を付ける ③3か月点検・12か月点検の予定と実施の記録 ④AI：紙の日常点検表の写真を読み取って記録にする |
| 既製品で足りる部分／作る価値 | 車両管理システムは既製品がある（「車両管理システム」月590回検索・広告が多い）。作る価値は、点呼・日常点検・配車と同じデータで車両の期限まで見られること |
| 言わないこと | 「法令対応済み」「監査に通る」／整備してよいか・走らせてよいかをAIが判断すると言うこと |
| 完成の条件 | 架空の車両12台・1年分の点検で、期限が近い車の一覧・日常点検からの取り込み・紙の点検表の読み取りまで動く。AIの呼び出しに回数と予算の上限を入れる |
| 台帳の「AIアプリの完成イメージ」 | 【一言】紙の点検表を撮るだけで、車両ごとの記録と期限がそろう。【動画の最初の3秒】紙の点検表の写真が、車両台帳の表に変わる。【人が決めること】異常の判断と整備の可否は整備管理者 |

---

# 1. プロジェクト概要

## 背景（出典は末尾）

国土交通省「点検整備の種類」（2026-10-13 台帳で確認・2026-10-22 再確認）より：

- **日常点検**：事業用自動車は「一日一回、その運行の前に」行う（道路運送車両法第47条の2、自動車点検基準第1条、貨物自動車運送事業輸送安全規則第3条の2）。
- **定期点検**：事業用トラックは **3か月ごと（51項目）** と **12か月ごと（101項目）**（道路運送車両法第48条、自動車点検基準第2条）。走行距離が少ない場合に省ける項目があるが、デモでは扱わない。
- **点検整備記録簿**：点検・整備の結果を記録し、3か月点検の対象車は **1年間保存**（道路運送車両法第49条）。
- **車検（自動車検査証の有効期間）**：貨物自動車は1年。ただし車両総重量8トン未満は初回のみ2年（道路運送車両法第61条）。
- **自賠責保険**：車検の有効期間をおおう期間で入るのが普通。満了日は車ごとに持つ。任意保険は会社でまとめた契約（フリート契約）の満了日を1つ持つ。

検索：車両管理システム 590／車両管理 480／日常点検 トラック 390／日常点検表 260／車両管理表 260（ラッコキーワード 2026-10-13・Google・年平均の月間）。

## プロダクト定義

| 項目 | 内容 |
|---|---|
| 名前 | SHAKO（しゃこ）※仮称。「車庫」から |
| 一言 | 紙の点検表を撮るだけで、車両ごとの記録と期限がそろう |
| 提供形態 | レスポンシブWebアプリ。**フロントエンド完結（サーバー側の保存なし）** |
| 見本の会社 | 「しろかね運送株式会社 本社営業所」（架空。運行管理の記録 WADACHI・配車表 TEHAI・拘束時間 YUTORI・指導教育 SHIRUBE と同じ会社）。車両は WADACHI の8台に4台を足して **12台**。ドライバーは SHIRUBE と同じ15名 |
| 人 | 整備管理者 **木村 達也**（運行管理補助者を兼ねる・WADACHI と同じ人）／運行管理者 山本 恵子 |
| 見本の場面 | **今日 2026年10月22日（木）の朝 7時40分**。出庫が一段落した車庫で、整備管理者が今朝の日常点検と、今月・来月の期限を確かめる。11号車の山口さんが紙の日常点検表を出していった |
| 主戦場 | 事務所のPC（整備管理者・運行管理者）／整備管理者のスマホ（車庫で紙を撮る・不良の車に整備の記録を付ける） |

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

1. 開いた瞬間に「期限と不良」が見える：期限を過ぎた点検 1台・30日以内の期限 3台・整備待ちの不良 1件・読み取り待ちの紙 1枚
2. 車両台帳（12台）に、車番・車種・主に乗る人・車検の満了日・自賠責の満了日・次の定期点検・最後の日常点検が並び、期限の近い順に並べ替えられる
3. 1台を開くと、その車の車検・保険・定期点検の予定と実施、日常点検（1年分・日ごとの○×）、整備の記録、整備工場の入庫の予定が1画面でまとまっている
4. 日常点検は「運行管理の記録（WADACHI）から取り込み」の札つきで毎日入っている。不良（×）が入ると、その車に「整備待ち」が付き、整備の記録を付けると外れる
5. 点検の予定表（12台×2026年4月〜2027年3月）で、3か月点検・12か月点検・車検の月が並び、済・予定・過ぎたが色と文字で分かる。実施の記録を付けると次の予定が自動で出る
6. 紙の日常点検表の写真を選ぶ（またはスマホで撮る）と、AIが車番・日付・点検した人・走行距離・15項目の○×・特記を読み取って下書きにする。**読み取りに自信がない欄は黄色で、人が選ぶまで保存できない。** 整備管理者が確かめて「この内容で保存」を押すと、日常点検に入り、×の項目は「整備待ち」になる
7. AIの上限（今日の回数・今月の予算）が画面に出ていて、上限に達すると「読み取る」が押せなくなる
8. 点検整備記録簿（1台分）を印刷用の1枚で、車両台帳を CSV で出せる。リセットできる

---

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

- すべてブラウザ内で動く。保存は localStorage（見本から変えた分）。見本は「今日＝2026-10-22」を基準に毎回同じものを組み立てる（日付は固定。実際の今日に合わせて動かさない）。
- **AIは外部につながない**（2026-10-08 に決めたデモの方針：費用0円・毎回同じ動き・悪用されない）。紙の読み取りは `src/lib/ai/` の純粋な関数で、見本の紙ごとに「紙に書いてあること」と「かすれ・はみ出し」を持ち、同じ紙なら同じ結果を返す。本番ではこの部分だけを Claude（画像を読めるモデル）に差し替える（`Reader` の型を守る）。
- 本番で外部のAIを呼ぶときの決まり（デモでは画面の「本番での仕組み」に書くだけ）：①AIに送るのは点検表の写真だけ。読み取った結果は、車両台帳にある車番・在籍しているドライバーの名前と照らして、合わないものは黄色にする ②1日の呼び出し回数と月の予算に上限を持たせ、超えたら「読み取る」を止める ③読み取った結果は、整備管理者が確かめて保存するまで記録に入れない ④AIは「整備してよいか」「走らせてよいか」を判断しない。×を拾うだけ。
- 日付は `YYYY-MM-DD` の文字で持ち、計算は日の単位で行う（時差で1日ずれないように）。

## 計算の決まりごと（`calc/`）

- **車検**：車検証の満了日を持つ。次の満了日＝受けた日（満了日の1か月前から受けた場合は前の満了日）から1年。車両総重量8トン未満で初めての車検だけは2年。
- **自賠責**：車ごとの満了日。車検の満了日より前に切れる車は「車検まで足りない」と出す。
- **任意保険**：会社のまとめた契約の満了日（2027-03-31）を全車に出す。
- **定期点検**：3か月点検の次の予定＝前回の実施日から3か月。4回に1回は12か月点検（12か月点検の月は車検の月に合わせる。車検の前の整備で一緒に行う）。予定日を過ぎても実施がない車は「予定を過ぎています」（赤）。
- **期限の色**：過ぎた＝赤「切れ／過ぎた」、30日以内＝黄「近い」、それ以外＝色なし。**色だけで伝えない**（「あと17日」「4日過ぎ」の文字を必ず添える）。
- **日常点検の取り込み**：運行管理の記録（WADACHI の部品＝同じ15項目）の点呼前の日常点検を、車両ごと・日ごとにまとめる。同じ車・同じ日に2回あれば、運行の前のもの（早い時刻）を使い、両方を記録に残す。走らなかった日は「運行なし」で、点検の抜けとは数えない。
- **整備待ち**：日常点検・定期点検で×が出た項目ごとに「整備待ち」を1件作る。整備の記録（日付・内容・した人・部品・費用・整備工場）を付けると外れる。同じ項目の×が続いても、整備の記録が付くまでは1件のまま。
- **記録の保存期限**：定期点検の記録は「記録の日から1年」を表示する（消す機能は作らない）。
- テスト必須：車検 1年／8トン未満の初回だけ2年／満了日の1か月前から受けたときの次の満了日、3か月点検の次の予定と12か月点検の月、予定日ちょうど（あと0日）・1日過ぎ・30日前・31日前の色、自賠責が車検より前に切れる、日常点検の同じ日2回、運行なしを抜けと数えない、×が続いても整備待ちは1件、整備の記録で外れる。

## AIの決まり（`ai/`）

- 入力：見本の紙の点検表（3枚）のどれか、またはスマホで撮った写真（デモでは見本の3枚のどれかとして扱う）。
- 出力：車番・日付・点検した人・走行距離・15項目それぞれの「○／×／空欄」・特記の文。**各欄に「自信あり／自信なし」を付け、自信なしは理由を書く**（「かすれていて○か×か読めない」「数字の1と7が見分けにくい」「欄の外に書いてある」）。
- 読み取った車番・名前は、車両台帳・在籍しているドライバーと照らす。合わなければ自信なし。
- 自信なしの欄は、人が選ぶまで「この内容で保存」が押せない。人が直した欄は「直した」と記録に残る。
- 見本の紙：
  1. **10/22 11号車（2t 冷凍車）山口 勝**：14項目○、「ワイパーの払拭状態」×、特記「右のワイパー 拭きムラあり」。「タイヤの空気圧」の○がかすれていて自信なし。走行距離 48,2□7km の1桁が読みにくく自信なし → 前日の WADACHI の値（48,180km）と照らして「48,217km の見込み」と添える
  2. **10/21 10号車（10t ウイング・予備車）鈴木 誠**：15項目○。点検した人の名前が「鈴木」だけで自信あり（在籍に鈴木は1人）
  3. **10/19 1号車（2t 平ボディ）吉田 剛**：「灯火装置」×、特記「左のウインカー 点滅が速い」。この×は 10/19 に交換済みの整備の記録がすでにあるので、保存すると「整備済み」と結び付く
- 上限：1日 30回・月 ¥3,000（デモは0円で、回数だけ数える）。見本の今日は「今日 2/30回・今月 ¥0/¥3,000」から始める。
- テスト：同じ紙なら同じ結果／自信なしの欄があると保存できない／車番が台帳に無いと自信なし／×が整備待ちになる／整備済みの×は新しい整備待ちを作らない／上限に達すると読み取れない。

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

1. 法令の言葉と画面の言葉が違ったら、画面は現場の言葉に、記録の書き出し（CSV・印刷）は法令・様式の言葉（点検整備記録簿など）に合わせる。
2. 「法令に適合しているか」「走らせてよいか」を判定する表示は作らない。出すのは「記録の有無」「×の項目」「期限まで何日」だけ。
3. 迷ったら、整備管理者が朝の車庫で、1画面で確かめられる方を選ぶ。

---

# 3. スコープ

## 作るもの

- 期限と不良（ホーム）／車両台帳（一覧・1台ごと）／点検の予定表（12台×12か月・実施の記録）／日常点検（取り込んだ1年分・日ごと車ごとの○×・紙から入れたものの写真）／紙の日常点検表の読み取り（AI → 確かめて保存）／整備待ちと整備の記録／整備工場の入庫の予定（車検・定期点検）／記録の書き出し（点検整備記録簿の印刷用1枚・車両台帳の CSV）／本番での仕組み／スタート／デモの帯（見る人の切り替え・リセット）
- 整備管理者のスマホ：今朝の不良と期限／紙を撮る → 読み取り → 確かめて保存／1台の車両カードと整備の記録を付ける

## 作らないもの

- 整備してよいか・走らせてよいかの判断（整備管理者が決める）
- 点呼・日報・配車・拘束時間・指導教育（WADACHI・TEHAI・YUTORI・SHIRUBE にある。リンクで紹介するだけ）
- 燃費・給油・ETC・リース料などのお金の管理、GPS・動態、故障の予測
- 整備工場への予約の実送信、通知の実送信、ログイン
- 定期点検の51項目・101項目の1項目ずつの入力（デモは「実施日・走行距離・整備工場・主な整備の内容・次の予定」まで。項目表は印刷用1枚の欄だけ用意する）

---

# 4. 画面

| パス | 画面 | 主な人 |
|---|---|---|
| `/` | スタート（見せ場4つと、整備管理者／運行管理者／スマホの入口） | — |
| `/m` | 期限と不良（ホーム） | 整備管理者 |
| `/m/vehicles` `/m/vehicles/:id` | 車両台帳（一覧・1台ごと） | 整備管理者・運行管理者 |
| `/m/plan` | 点検の予定表（12台×12か月） | 整備管理者 |
| `/m/daily` | 日常点検（取り込み・日ごと車ごと） | 整備管理者 |
| `/m/scan` `/m/scan/:id` | 紙の日常点検表を読み取る → 確かめて保存 | 整備管理者 |
| `/m/repairs` | 整備待ちと整備の記録 | 整備管理者 |
| `/m/export` | 記録の書き出し（点検整備記録簿・CSV） | 整備管理者 |
| `/m/how` | 本番での仕組み | 整備管理者 |
| `/s` | 今朝の不良と期限（スマホ） | 整備管理者 |
| `/s/scan` | 紙を撮る → 読み取り → 確かめて保存 | 整備管理者 |
| `/s/v/:id` | 車両カード・整備の記録を付ける | 整備管理者 |

デモの帯（黒地・画面の骨組みとは別に、どの画面にも出す）：見る人の切り替え（整備管理者 木村 達也（PC）／運行管理者 山本 恵子（PC）／整備管理者 木村 達也（スマホ））、リセット、「これはデモです。会社・人物・車両は架空。AIは外部につながず、このブラウザの中だけで動きます」。
運行管理者で見ると、ホームで最初に「今日走らせる前に整備管理者の確認が要る車」（整備待ちのある車）が出る。

---

# 5. 見本データ

- 会社：しろかね運送株式会社 本社営業所（東京都練馬区のまわり・架空）。整備管理者 木村 達也、運行管理者 山本 恵子。整備工場は協力工場「ねりま自動車整備」（架空）と、ディーラーの工場「北関東トラックサービス 練馬工場」（架空）。
- 車両12台（1〜8号車は WADACHI と同じ。9〜12号車を足す）：

| 号車 | 車番 | 車種 | 8t未満 | 主に乗る人 | 車検の満了日 | 自賠責の満了日 | 次の定期点検 | 今日の札 |
|---|---|---|---|---|---|---|---|---|
| 1 | 練馬 100 あ 21-01 | 2t 平ボディ | ○ | 小林 修・吉田 剛 | 2027-05-21 | 2027-06-20 | 3か月 11/25 | — |
| 2 | 練馬 130 あ 21-02 | 4t 箱車 | ○ | 佐藤 健一 | 2027-01-28 | 2027-02-27 | 3か月 **10/25（あと3日）** | 黄 |
| 3 | 練馬 130 あ 21-03 | 4t ウイング | ○ | 田中 浩二 | 2027-07-09 | 2027-08-08 | 3か月 12/10 | **整備待ち**（10/21 左後輪外側 タイヤの溝） |
| 4 | 練馬 100 い 21-04 | 10t ウイング | — | 鈴木 誠 | **2026-11-08（あと17日）** | 2026-12-08 | 12か月 11/05（車検と一緒・ねりま自動車整備に入庫予約） | 黄 |
| 5 | 練馬 130 い 21-05 | 4t 冷凍車 | ○ | 高橋 翔 | 2027-03-16 | 2027-04-15 | 3か月 12/16 | — |
| 6 | 練馬 400 う 21-06 | 2t 箱車 | ○ | 伊藤 美咲・松田 昭夫 | 2027-09-30 | **2026-11-20（あと29日・車検まで足りない）** | 3か月 12/28 | 黄 |
| 7 | 練馬 100 う 21-07 | 10t 箱車 | — | 中村 大輔 | 2026-12-14（あと53日） | 2027-01-13 | 12か月 12/07 | — |
| 8 | 練馬 130 え 21-08 | 4t ゲート付き | ○ | 渡辺 隆・加藤 亮 | 2027-04-02 | 2027-05-02 | 3か月 1/04 | 10/20 ブレーキ灯 左 球切れ → 同日交換済み |
| 9 | 練馬 400 お 21-09 | 2t 箱車 | ○ | 森 拓也 | 2027-02-19 | 2027-03-21 | 3か月 **10/18（4日過ぎ・入庫の予約なし）** | 赤 |
| 10 | 練馬 100 お 21-10 | 10t ウイング（予備車） | — | 大型の人が交代で | 2027-06-11 | 2027-07-11 | 3か月 12/11 | — |
| 11 | 練馬 400 か 21-11 | 2t 冷凍車 | ○ | 山口 勝 | 2027-08-26 | 2027-09-25 | 3か月 11/26 | **読み取り待ちの紙**（今朝） |
| 12 | 練馬 130 か 21-12 | 4t ウイング（2025-12 新車） | ○ | 石井 陸（10/27 から） | 2027-12-13（初回2年） | 2028-01-12 | 3か月 12/14 | — |

  任意保険：フリート契約 全12台 2027-03-31 満了（あと160日）。
- ホームの数字：期限を過ぎた点検 **1台**（9号車）／30日以内の期限 **3台**（2号車 3か月点検・4号車 車検・6号車 自賠責）／整備待ちの不良 **1件**（3号車）／読み取り待ちの紙 **1枚**（11号車）。7号車の車検（あと53日）は「60日以内」として、30日以内の3台とは分けて出る。**30日以内に入る期限は、この3つだけになるように見本を組む**（1号車 11/25・11号車 11/26 は31日より先。テストで確かめる）。
- 日常点検：2025-10-23〜2026-10-22 の1年分。WADACHI の運行（土日・休みの日のずれ）と同じ決まりで、運行した日は毎日15項目。×は1年で11件（タイヤの空気圧3・灯火装置3・ワイパー2・タイヤの溝1・ブレーキ液1・前日の異状1）、うち10件は整備の記録で外れていて、残り1件が3号車の 10/21。紙の点検表から入れた日が、11号車に週2回ほどある（山口さんはスマホの点呼に慣れておらず、日常点検は紙。点呼はスマホで受ける）。
- 定期点検：各車、前回の実施日と整備工場・走行距離・主な整備の内容（「ブレーキ・ライニング交換」「エア・ドライヤー乾燥剤交換」「異常なし」など）を1年分。
- 整備の記録：1年で約30件（日常点検の×から10件・定期点検で見つかったもの・タイヤ交換・バッテリー交換）。費用は書くが、合計や予算は出さない。
- 紙の日常点検表の見本：3枚（2章「AIの決まり」）。**紙の画像は Claude が作る**：実在の様式に似せない「しろかね運送 日常点検表」（15項目・○×の欄・車番・日付・点検者・走行距離・特記）を、手書き風の○×と字で描き、写真（白紙を挟んだクリップボード）に重ねる。かすれ・はみ出しも描く。

# 6〜8. 見た目

- **デザイン画像（Codex で作るもの）を正とする。** デザインは2段：第1段で骨組みの違う全体案3つ → 菊池さんが1案を承認 → 第2段で残りの画面と写真。画像が届くまで画面を作らない（計算・AI・見本データ・テストは先に作ってよい）。
- 画面の並べ方（どこに何を置くか）はこの要件定義書では決めない。決めるのは承認した全体案。
- 世界観の方針（依頼書と同じ）：運送会社の車庫と事務所で毎日使う業務の画面。地は白〜薄いグレー、差し色は1色（WADACHI・TEHAI・YUTORI・SHIRUBE とは別の色にして別のアプリに見せる）、注意は赤・黄に文と記号を添える。紫のグラデーション・キラキラの印・チャットの窓は使わない。
- 写真を画面のあちこちに使う（スタートの大きな写真・各画面の上の帯・車両の写真・不良の写真・空の状態）。車両の写真は1〜8号車を WADACHI から流用し、9〜12号車を新しく作る。
- 整備管理者のスマホは、大きな文字・大きなボタン。車庫で手袋を外して片手で使える量に絞る。
- 日本語は Noto Sans JP、数字は等幅の数字。車番は1行で折り返さない。

# 9. 技術

Vite 6 + React 19 + React Router 7 + Tailwind v4 + Zustand（persist）+ lucide-react。MUKAE（souzoh-official/mukae）と同じ構成。画像は `scripts/images/`（prepare・import）と `src/lib/images.ts`。Cloudflare Workers の静的アセットで配信（`shako.souzohnic.workers.dev`）。日常点検の15項目は WADACHI の `INSPECTION_ITEMS` と同じものを写して使う。

# 10. 非機能

- 320px〜2560px で横にはみ出さない
- 初期の JS は 200KB（gzip）以下
- スマホの画面は、ボタンの高さ 48px 以上・文字 16px 以上
- 印刷用の1枚（点検整備記録簿）は A4 縦で崩れない
- 1年分の日常点検（12台×約250日）を開いても、画面の切り替えが重くならない（車両ごと・月ごとにまとめてから描く）

# 11. 実装タスク

## Phase 1 — 計算とAI
- [ ] calc/expiry.ts（車検・自賠責・任意保険・期限の色）・calc/periodic.ts（3か月・12か月点検の予定）・calc/daily.ts（日常点検の取り込み・整備待ち）
- [ ] ai/reader.ts（紙の読み取り）・ai/limit.ts（上限）
- [ ] テスト（2章の「テスト必須」と AI のテスト）
## Phase 2 — 見本データ
- [ ] 会社・車両12・ドライバー15・日常点検1年分・定期点検・整備の記録・入庫の予定・紙の点検表3枚（画像も）
## Phase 3 — 画面（デザイン画像が届いてから）
- [ ] 外枠・デモの帯・ホーム・車両台帳（一覧・1台）・点検の予定表・日常点検・紙の読み取り・整備待ちと整備の記録・スマホ（今朝・撮る・車両カード）・書き出し・本番での仕組み・スタート
## Phase 4 — 仕上げ
- [ ] 写真の取り込み・CSV・印刷・リセット・レスポンシブ総点検・公開

# 12. 受入基準

1. 見せ場①〜④が動く
2. 計算とAIのテストがすべて通る（`npm test`）
3. 紙の点検表を保存すると、ホームの数字・車両台帳・日常点検・整備待ちが同時に変わる。整備の記録を付けると整備待ちが外れ、ホームの数字が減る
4. 自信なしの欄が残っている読み取り結果は、保存できない（記録に1つも入らない）
5. 320／375／768／1024／1280／1920px で横はみ出し0・文字の切れなし
6. 「言わないこと」（法令対応済み・監査に通る・AIが整備や運行の可否を判断する）が画面の文言に入っていない

# 出典

- 国土交通省「点検整備の種類」https://www.mlit.go.jp/jidosha/jidosha/tenkenseibi/tenken/t1/t1-2/ （日常点検＝一日一回その運行の前に／事業用 3か月51項目・12か月101項目／記録簿 1年保存。2026-10-13 台帳で確認、2026-10-22 再確認）
- 道路運送車両法 第47条の2（日常点検）・第48条（定期点検）・第49条（点検整備記録簿）・第61条（自動車検査証の有効期間）、自動車点検基準、貨物自動車運送事業輸送安全規則 第3条の2
- 国土交通省 資料「車両総重量8トン未満のトラックの自動車検査証の有効期間を初回のみ2年に延長（平成12年5月1日施行）」
- ラッコキーワード（Google・年平均の月間検索数、2026-10-13）
- Lark Base デモアプリ表 reczz28MiaDPYNGa（2026-10-13 定義確定）


---

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

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

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

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

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

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