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

**版数** 1.0（DBレス構成のデモ）／ **作成日** 2026-10-22 ／ **発行** ソウゾウ合同会社
**用途** 業種特化アプリの実演デモ ／ 運輸・物流（トラックドライバー）向け「求人サイト」
**台帳** Lark Base「X・SEO・YouTube管理」デモアプリ表 `recvw0QPLtFKOt`（17番・第2弾・担当 海野）。中身は 2026-10-22 に Claude が菊池さんの指示で埋めた（定義の状態：西澤確認待ち）。**HIREBASE（業種を問わない求人サイトのデモ）とは別のアプリとして作る**（2026-10-22 菊池さん）

---

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

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

- 実装は「11. 実装タスク」の順に進める。フェーズを飛ばさない。
- 仕様に書かれていないことは推測で作らず質問する。質問できない状況では「判断に迷ったときのルール」で決め、`docs/DECISIONS.md` に1行ずつ残す。
- 3章の「作らないもの」は、思いついても作らない。
- 「デモだから」を理由に品質を落とさない。**求人の絞り込み・求人票の読み取り・案内役の答えは、テストが通るまで画面を作らない。**
- **運送の現場の言葉で書く。** 画面の文言は、ドライバーと運送会社の採用担当が普段使っている言葉に合わせる（求人・応募・面接・採用・見送り・地場・中距離・長距離・日帰り・泊まり・ルート配送・チャーター・手積み・手降ろし・フォーク・パレット・カゴ台車・平ボディ・箱車・ウイング・冷凍車・トレーラー・けん引・ユニック・準中型・中型・大型・固定給・歩合・手当・無事故手当・拘束時間・週休2日・年間休日・未経験・免許取得支援・出庫・帰庫・点呼）。「ユーザー」「エントリー」「マッチング」「ステータス」「ダッシュボード」「レコメンド」を画面に出さない。

> **このアプリが選ばれる理由**
> ドライバーの仕事は、同じ「4tドライバー」でも中身がまったく違う。手積み・手降ろしがあるか、日帰りか泊まりか、何時に出勤するか、土日に休めるか、給料のうち歩合がいくらか。ところが一般の求人サイトでは、これが本文の文章の中に埋もれていて、ドライバーは1件ずつ開いて読み比べるしかない。会社の側も、ハローワークの求人票や紙のメモはあるのに、求人サイト向けに書き直す手間で止まってしまう。
> NORITE は、**ドライバーが本当に気にする項目（免許・車種・荷役・走る範囲・泊まり・出勤の時刻・休み・給与の内訳）を、すべての求人で同じ形にそろえて載せる求人サイト。** 会社は今ある求人票を写真や文章で入れるだけで、AIがその形に分けた下書きを作り、足りない項目を知らせる。サイトのことは、女性ドライバーの案内役「ミチ」に聞けば何でも答える。答えはサイトの中の求人と案内から作り、答えられない質問は運営に届く。
> 選ぶのは、応募するドライバーと、採用を決める会社。サイトとAIは、人を選んだり合否を決めたりしない。
> 求人を1件ずつ開かないと手積みの有無が分からない、会社が求人を書き直さないと載せられない、案内役が分からない質問をそのままにする、のどれか1つでもあれば失敗とみなす。

---

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

| 項目 | 内容 |
|---|---|
| 誰に刺すか | ①運送業界に絞った求人サイトを始めたい会社（運送会社のグループ・業界の団体・地域の人材会社）②自社の採用ページを作りたい中小の運送会社の社長・採用担当（ドライバーが集まらず、一般の求人サイトに高い掲載料を払っている） |
| 場面 | 一般の求人サイトに出しても、ドライバーが欲しい情報（手積み・泊まり・休み・歩合）が伝わらず応募が来ないとき／ハローワークの求人票はあるのに、求人サイト用に書き直せないとき／応募してきた人への返事が遅れて、ほかの会社に取られたとき |
| 問題（ふわっと） | （本人の言葉は未取得）推測：求人を出しても、来てほしいドライバーに届いていない気がする |
| 理想 | ドライバーが自分の免許と条件で探すと、合う求人だけが同じ形で並び、比べて応募できる。会社は今ある求人票から数分で載せられ、応募にすぐ返事ができる |
| 課題（ギャップ） | ドライバーの仕事の中身（荷役・泊まり・時間・給与の内訳）が、求人ごとにバラバラの文章で書かれていて比べられない。会社に書き直す手間と時間がない |
| 見る前の感情 | 求人サイトは大手がたくさんある。業界に絞っても集まるのか分からない |
| 見た後の感情 | ドライバーが気にする項目で探せる。今の求人票から載せられて、案内役が質問を受けてくれる。自分たちの地域・業界で始められる |
| 見せ場（必ず見せる） | ①ドライバーが免許・車種・荷役（手積みなし）・走る範囲（地場・日帰り）・休み（土日）・給与で探せて、すべての求人が同じ形で並ぶ ②求人ごとに「1日の流れ」「給与の内訳（固定給と歩合・手当）」「荷役」「掲載日・最終更新日」が並び、比べられる ③応募 → 会社に届く → 返事・面接日の調整までサイトの中でやりとり。会社ごとに「返事までの日数」が出る ④AI：会社の今の求人票（紙・ハローワークの求人票・メモ）を読み取り、同じ形の下書きにして、足りない項目を知らせる。採用担当が確かめてから載せる ⑤AI案内役「ミチ」（女性ドライバー）：サイトの中のことを何でも答える（求人探し・言葉の意味・応募の流れ・求人の中身）。答えはサイトの中から作り、答えられない質問は運営に届く |
| 既製品で足りる部分／作る価値 | 求人サイトを作る既製品・大手の求人サイトはある。作る価値は、ドライバーの仕事の項目（荷役・泊まり・出勤の時刻・歩合）を全求人で同じ形にそろえること、今ある求人票から載せられること、サイトのことを何でも答える案内役を付けること。流用：HIREBASE（求人・応募の部品）・TSUTAE（案内役が右下にいて答える仕組み） |
| 言わないこと | 「必ず採用できる」「応募が○倍に増える」「法令対応済み」「職業安定法に対応」「届出が要らない」／AIが人を選ぶ・合否や向き不向きを判断すると言うこと／「人材紹介」「職業紹介」（このサイトは求人を載せて応募を会社に届けるだけ） |
| 完成の条件 | 架空の運送会社8社・求人24件・応募14件で、条件で探す・求人の詳細・応募と返事・求人票の読み取り（見本2枚）・案内役の答え（見本の質問20個がサイトの中のデータで答えられ、答えられない質問は運営に届く）まで動く。AIの呼び出しに回数と予算の上限を入れる |
| AIアプリの完成イメージ | 【一言】今ある求人票から、ドライバーが比べられる求人になる。案内役のミチがサイトのことを何でも答える。【動画の最初の3秒】ハローワークの求人票の写真が、「手積みなし・日帰り・土日休み」の札が並ぶ求人カードに変わる。【人が決めること】求人の中身は採用担当が確かめて載せる。採用・見送りは会社が決める |

---

# 1. プロジェクト概要

## 背景（出典は末尾）

- **ドライバーは足りていない。** 自動車運転の職業の有効求人倍率（常用・パート含む）は 2026年7月で **2.53倍**（全職業は 1.18倍）。2020年10月から2倍台が続いている（厚生労働省「一般職業紹介状況」をもとにした業界紙の報道。2026-10-22 確認）。
- **求人サイトは国のルールの中にある。** 2022年10月の改正職業安定法で、求人メディア（募集情報等提供事業者）には、求人の情報を「虚偽や誤解を生じさせる表示にしない・最新で正確に保つ」こと（的確表示）、苦情を早く適切に処理すること、個人情報を守ることが義務になった。求職者の情報（応募の名前・連絡先など）を集める求人サイトは「特定募集情報等提供事業者」として国への届出が要る（厚生労働省「令和４年職業安定法の改正の概要について」2022年9月作成。2026-10-22 PDF本文で確認）。**デモでは「本番での仕組み」画面にこの決まりを書くだけで、「対応済み」とは言わない。**
- **求人に書く項目は決まっている。** 募集するときは、業務の内容・契約期間・試用期間・就業場所・始業と終業の時刻・休憩・休日・時間外労働・賃金・社会保険などを示す。2024年4月からは「従事すべき業務の変更の範囲」「就業場所の変更の範囲」「有期契約を更新する場合の基準」も加わった（職業安定法施行規則の改正。厚生労働省「令和６年４月より、募集時等に明示すべき事項が追加されます」。2026-10-22 確認）。**AIの「足りない項目」はこの一覧と、ドライバーが気にする項目（荷役・泊まり・歩合の内訳）の両方で見る。**
- **年齢・性別で絞らない。** 募集・採用で年齢を制限すること、性別で分けることは原則できない（労働施策総合推進法 第9条・男女雇用機会均等法 第5条）。サイトに年齢・性別の絞り込みは作らない。「女性ドライバーが働いています（2名）」のような会社の事実は載せてよい。

検索：台帳の「狙い」に「求人の作る意図260・業種ニッチ417」とある（出所・取得日は台帳に無い）。**運送の求人の検索数は、この版では測っていない**（この Mac からラッコキーワードを使えないため。測ったら台帳と出典に足す）。

## プロダクト定義

| 項目 | 内容 |
|---|---|
| 名前 | NORITE（のりて）※仮称。「乗り手」から |
| 一言 | ドライバーが気にする項目で探せる、運送の求人サイト |
| 提供形態 | レスポンシブWebアプリ。**フロントエンド完結（サーバー側の保存なし）** |
| 見本のサイト | 「NORITE 東京・埼玉のドライバー求人」（架空。運営は架空の「株式会社のりて」）。載っている会社は架空の8社で、その1社が「しろかね運送株式会社 本社営業所」（運行管理の記録 WADACHI・配車表 TEHAI・拘束時間 YUTORI・車両管理 SHAKO と同じ会社） |
| 人 | ドライバー（求職者）**大野 健太**（34歳・練馬区・中型免許・4t箱車の経験6年）／しろかね運送の採用担当 **河合 由紀**（総務）／運営 **藤田 奈央**（株式会社のりて）／案内役 **ミチ**（女性ドライバーの見た目のキャラクター・架空） |
| 見本の場面 | **今日 2026年10月22日（木）夜 20時30分。** 大野さんが仕事から帰って、スマホで「手積みなし・日帰り・土日休み」の仕事を探している。2日前に応募したしろかね運送から、面接日の候補が届いている。しろかね運送の河合さんは、明日の朝に新しい応募2件を見る。はやせ運輸は、ハローワークの求人票を写真で入れたところ |
| 主戦場 | ドライバーのスマホ（探す・比べる・応募・ミチに聞く）／採用担当のPC（応募の一覧・返事・求人票の読み取り）／運営のPC（掲載前の確認・古い求人・答えられなかった質問） |

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

1. ドライバーのスマホで開くと、ミチが右下にいて話しかけ、免許・車種・荷役・走る範囲・休みの札で絞れる。「手積みなし」「日帰り」「土日休み」「中型」で絞ると、合う求人だけが同じ形のカードで並ぶ
2. 求人の詳細に、1日の流れ（時刻つき）・給与の内訳（固定給・歩合・手当）・荷役・泊まりの回数・休み・拘束時間の目安・業務と就業場所の変更の範囲・掲載日と最終更新日が、どの求人も同じ並びで出る。2件を並べて比べられる
3. 応募すると会社に届き、会社が返事（面接日の候補）を出すと、ドライバーの「応募した求人」に届く。会社ごとに「返事までの日数（平均）」が出る
4. ミチに「土日休みで手積みなしの4t、ある？」と聞くと、条件を読み取って合う求人を出す。「準中型ってなに？」「応募したら何日で返事が来る？」「この求人、泊まりはある？」にも、サイトの中の情報から答える。**答えの下に「ミチがサイトの中から探した答えです」と出る。** 答えられない質問（「この会社の評判は？」など）は、そう言ったうえで運営に届く
5. 採用担当が今の求人票（見本2枚）を入れると、AIが同じ形の下書きにする。**読み取りに自信がない欄は黄色、求人票に無かった項目は「足りない」として出し、採用担当が埋めるまで「載せる」を押せない。** 載せると運営の確認を経て掲載される
6. 運営の画面で、掲載前の確認・60日以上更新がない求人・返事が遅い会社・ミチが答えられなかった質問・問い合わせが1画面で見られる
7. AIの上限（今日の回数・今月の予算）が画面に出ていて、上限に達すると「読み取る」が押せなくなる
8. リセットで見本に戻せる

---

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

- すべてブラウザ内で動く。保存は localStorage（見本から変えた分）。見本は「今日＝2026-10-22 20:30」を基準に毎回同じものを組み立てる（日付は固定。実際の今日に合わせて動かさない）。
- **AIは外部につながない**（2026-10-08 に決めたデモの方針：費用0円・毎回同じ動き・悪用されない）。求人票の読み取りと案内役の答えは `src/lib/ai/` の純粋な関数で、同じ入力なら同じ結果を返す。本番ではこの部分だけを Claude に差し替える（`Reader`・`Concierge` の型を守る）。
- 本番で外部のAIを呼ぶときの決まり（デモでは画面の「本番での仕組み」に書くだけ）：
  1. 求人票の読み取り：AIに送るのは求人票の写真か文章だけ。結果は採用担当が確かめて保存するまで載らない。運営の確認を経て掲載する
  2. 案内役：AIに渡すのは、サイトに載っている求人・会社の公開情報・よくある質問・使い方だけ。応募者の名前・連絡先・やりとりは渡さない。答えには、もとにした求人・案内へのリンクを必ず付ける。答えの元が見つからない質問には答えを作らず「分かりません」と言って運営に届ける
  3. 1日の呼び出し回数と月の予算に上限を持たせ、超えたら止める
  4. AIは人を選ばない。応募者の並べ替え・点数づけ・合否の判断はしない
- 日付は `YYYY-MM-DD`、時刻は `HH:MM` の文字で持つ。

## 絞り込みの決まりごと（`calc/`）

- **免許**：普通 ＜ 準中型 ＜ 中型 ＜ 大型 の順で、上の免許は下の車を運転できる（大型を持っていれば中型の求人も出る）。けん引は大型と別に持つ。5t限定準中型・8t限定中型は「準中型（5t限定）」「中型（8t限定）」として、4t（車両総重量 8t未満）の車に乗れるかを見本の車ごとに持つ（求人ごとに `needs: 'futsu'|'junchu5'|'junchu'|'chu8'|'chu'|'ogata'|'kenin'`）。免許取得支援がある求人は「今の免許では足りないが、会社が取らせてくれる」として別の札で出す。
- **荷役**：`none`（手積み・手降ろしなし。フォーク・パレット・カゴ台車だけ）／`some`（一部あり）／`all`（手積み・手降ろしあり）。「手積みなし」で絞ると `none` だけ。
- **走る範囲と泊まり**：地場（日帰り）／中距離（月の泊まり 0〜4回）／長距離（5回以上）。「日帰り」で絞ると、月の泊まりが0回の求人だけ。
- **出勤**：始業の時刻（例 6:00）と、夜勤の有無。「朝6時より後」「夜勤なし」で絞れる。
- **休み**：「土日休み」「週休2日（シフト）」「日曜＋平日1日」と年間休日の日数。「土日休み」は土日の両方が休みの求人だけ。
- **給与**：月給の例の下限〜上限と内訳（基本給・歩合・手当）。下限で絞る（「月30万円以上」）。歩合の割合が半分を超える求人には「歩合が多め」と書く（良い悪いは言わない）。
- **並べ方**：新しい順（最終更新日）／月給の下限が高い順／会社の返事が早い順。**AIや運営が勝手に並べ替えない。** 「おすすめ順」は作らない。
- **古い求人**：最終更新日から60日を過ぎた求人には「最終更新から○日」の札を出し、運営の画面に「会社に確認」として出る。
- **返事までの日数**：会社ごとに、直近の応募で「応募から最初の返事まで」の日数の平均（小数1桁）。返事がない応募は今日までの日数で数える。
- テスト必須：大型の人に中型の求人が出る／8t限定中型の人に 10t の求人が出ない／準中型（5t限定）で 2t 冷凍車（車両総重量 5t 超）が出ない／免許取得支援の札／手積みなしで `some` が出ない／日帰りで泊まり1回の求人が出ない／土日休みで「日曜＋平日1日」が出ない／月給下限の境目（ちょうど30万）／60日と61日の境目／返事なしの応募を今日までで数える。

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

### 求人票の読み取り（`ai/reader.ts`）

- 入力：見本の求人票（2枚）のどれか。デモでは、写真を選ぶ・文章を貼るのどちらでも、見本のどちらかとして扱う。
- 出力：求人の各項目（1日の流れ以外の全部）と、それぞれの「自信あり／自信なし（理由）／求人票に無い」。
- 足りない項目の見方：①募集のときに示す項目（業務の内容・契約期間・試用期間・就業場所・始業と終業・休憩・休日・時間外・賃金・社会保険・業務の変更の範囲・就業場所の変更の範囲・受動喫煙を防ぐ措置）②ドライバーが気にする項目（荷役・泊まりの回数・給与の内訳・車種・必要な免許）。**①の不足と②の不足は分けて出す。** ①は「募集のときに示す項目です」、②は「ドライバーがよく見る項目です」と添える。
- 年齢・性別の条件が書いてあったら（「40歳まで」「男性のみ」など）、その欄は載せずに「年齢・性別で絞る書き方は載せられません。理由がある場合は運営に相談してください」と出す。
- 自信なし・足りない・載せられない欄が1つでもあると「載せる」が押せない。採用担当が直した欄は「直した」と残る。
- 見本の求人票：
  1. **はやせ運輸 4tウイング 日帰り（ハローワークの求人票の写し・印刷を写真で撮ったもの）**：業務の内容・就業場所・時間・休日・賃金（基本給 21万円＋歩合）・社会保険は読める。**歩合の金額**が「歩合給 月平均 ○万円」の数字がかすれていて自信なし（「6」か「8」か）。**荷役の書き方がない**（足りない・ドライバーがよく見る項目）。**就業場所の変更の範囲がない**（足りない・募集のときに示す項目）。1日の流れは求人票に無いので、採用担当が書く（空欄で出す）
  2. **大泉ハウス配送 2t家具配送（社長の手書きのメモを写真で撮ったもの）**：「家具・家電の配送と設置、2人1組、朝8時、日曜休み＋シフト、月27〜32万、未経験OK、**40歳くらいまで**」。年齢の書き方は載せられない。契約期間・試用期間・社会保険・業務と就業場所の変更の範囲・受動喫煙が足りない。荷役は「設置まで」から「手積み・手降ろしあり」と読むが自信なし（読み取った理由を書く）
- テスト：同じ求人票なら同じ結果／自信なし・足りない・年齢の欄があると載せられない／直すと載せられる／①と②の不足が分かれて出る／上限に達すると読み取れない。

### 案内役「ミチ」（`ai/concierge.ts`）

- 入力：質問の文と、いまの画面（どの求人・どの会社を開いているか）と、見ている人（ドライバー・採用担当・運営）。
- 答えの元は **サイトの中だけ**：載っている求人（掲載中だけ）・会社の公開情報・言葉の説明（用語集 20語）・よくある質問（ドライバー向け 15・会社向け 10）・使い方・その人の応募の状況（ドライバー本人のものだけ）。
- 答え方（決まりの型）：
  1. **探す**：質問から条件（免許・車種・荷役・範囲・泊まり・出勤・休み・給与の下限・未経験）を読み取り、合う求人を最大3件のカードで返す。読み取った条件を札で見せ、押すと一覧の画面にその条件で移る。合う求人が0件なら、外すと出てくる条件を1つ言う（「土日休みを外すと2件あります」）
  2. **言葉**：用語集から説明する（「準中型免許は、車両総重量7.5トン未満の車を運転できる免許です…」）
  3. **この求人について**：開いている求人の項目から答える（「この求人の泊まりは月4〜6回です」）。開いていないときは、どの求人か聞き返す
  4. **使い方・応募の流れ**：よくある質問から答える
  5. **自分の応募**：ドライバー本人の応募の状況を答える（「しろかね運送から面接日の候補が届いています」）
  6. **答えられない**：元が見つからない、または評判・口コミ・合否の見込み・ほかの人の情報を聞かれたとき。「サイトの中に答えがありませんでした。運営に伝えておきます」と言い、運営の「答えられなかった質問」に入る。**それらしい答えを作らない**
- どの答えにも「ミチがサイトの中から探した答えです」と、元にした求人・案内へのリンクを付ける。
- 画面ごとに話しかける（画面が変わって約1.4秒後・約9秒で消える。言うことは実際のデータから作り、数字をでっち上げない）。例：さがす「大野さん、手積みなしで日帰りの求人は今5件あります（j01・j04・j06・j09・j19）」／求人の詳細「休みや荷物のこと、この求人について聞いてくださいね」／応募した求人「しろかね運送から面接日の候補が届いています」／採用担当のホーム「新しい応募が2件あります。返事までの平均は1.2日です」／運営「答えられなかった質問が5件あります」
- 見本の質問（20個・全部テストにする）：
  - 探す：「土日休みで手積みなしの4t、ある？」「日帰りで大型の仕事」「夜勤なしで朝遅めがいい」「未経験でも乗れる2t」「月35万以上で手積みなし」「トレーラーの仕事ある？」「練馬の近くで冷凍車」
  - 言葉：「準中型ってなに？」「地場ってどういう意味？」「歩合ってなに？」「拘束時間って？」「けん引免許がいる仕事は？」（言葉＋探す）
  - この求人：「この求人、泊まりはある？」「休みは？」「手積みはある？」（しろかね運送の 4t ウイング を開いた状態）
  - 使い方：「応募したら何日で返事が来る？」「応募を取り消したい」「このサイトはお金がかかる？」
  - 自分の応募：「応募した会社から返事きた？」
  - 答えられない（運営に届く）：「この会社の評判は？」（テストでは20個に含めない予備）
- 上限（本番の想定）：1日 1,000回・月 ¥20,000。デモは0円で回数だけ数える。今日は「86/1,000回」から始める。求人票の読み取りは1日20回・月 ¥2,000、今日は「1/20回・今月 ¥0/¥2,000」から始める。
- テスト：20個の質問がそれぞれ決まった型と答えになる／掲載前・下書きの求人は答えに出ない／応募者の名前・ほかの人の応募は答えに出ない／答えられない質問が運営に届く／同じ質問なら同じ答え。

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

1. 法令の言葉と画面の言葉が違ったら、画面は現場の言葉に合わせ、「本番での仕組み」と求人の詳細の「募集の条件」欄は法令の言葉（就業場所の変更の範囲など）に合わせる。
2. 「法令に適合しているか」「この人は採用されそうか」を判定する表示は作らない。出すのは「書いてある・書いていない」「最終更新から何日」「返事までの日数」だけ。
3. 迷ったら、仕事から帰ったドライバーが、スマホで片手で比べられる方を選ぶ。

---

# 3. スコープ

## 作るもの

- ドライバー：さがす（札での絞り込み・並べ方）／求人の一覧／求人の詳細（同じ形の項目・1日の流れ・会社の情報・返事までの日数）／2件を並べて比べる／応募（名前・連絡先・持っている免許・経験・会社への質問）／応募した求人（状況・会社とのやりとり・面接日の候補を選ぶ）／気になる（保存）／ミチに聞く（全画面）
- 採用担当（しろかね運送）：応募の一覧（新着・返事済み・面接・採用・見送り）／応募の詳細とやりとり（返事のひな形・面接日の候補を3つまで出す）／自社の求人の一覧（掲載中・確認待ち・下書き・終了）／求人票を読み取る（AI → 確かめて載せる）／求人を直す
- 運営：掲載前の確認（中身を見て「載せる」「直してもらう」）／古い求人／返事が遅い会社／ミチが答えられなかった質問（よくある質問に足す）／問い合わせ／本番での仕組み
- 案内役ミチ：どの画面にも右下にいる（スタート・全画面のミチ・求人票の読み取り中は出さない）。話しかける・小さなチャット・全画面へ・表情（ふだん・探している・見つけた・休む）・動かせる・休ませられる（TSUTAE の 6.9 と同じ動き）
- スタート／デモの帯（見る人の切り替え・リセット）

## 作らないもの

- 年齢・性別での絞り込み、「おすすめ順」、AIによる応募者の点数づけ・並べ替え・合否の判断
- 職業紹介（運営が人を会社に薦める・会社の代わりに選ぶ）、スカウト（会社からドライバーに声をかける）
- 実際のメール・LINE・SMSの送信、ログイン・会員登録、掲載料の請求・支払い
- 地図・通勤時間の計算（所在地と最寄りの駅を文字で出すだけ）
- 口コミ・評判、給与の相場の比較
- 点呼・配車・拘束時間の計算・車両の管理（WADACHI・TEHAI・YUTORI・SHAKO にある。しろかね運送の会社の情報からリンクで紹介するだけ）

---

# 4. 画面

| パス | 画面 | 主な人 |
|---|---|---|
| `/` | スタート（見せ場と、ドライバー（スマホ）／採用担当（PC）／運営（PC）の入口。ミチが大きく出て名乗る） | — |
| `/d` | さがす（札の絞り込み・求人の一覧） | ドライバー |
| `/d/jobs/:id` | 求人の詳細 | ドライバー |
| `/d/compare` | 2件を並べて比べる | ドライバー |
| `/d/jobs/:id/apply` | 応募 | ドライバー |
| `/d/me` | 応募した求人・やりとり・気になる | ドライバー |
| `/d/ask` | ミチに聞く（全画面） | ドライバー |
| `/c` | 応募の一覧 | 採用担当 |
| `/c/applicants/:id` | 応募の詳細とやりとり | 採用担当 |
| `/c/jobs` | 自社の求人 | 採用担当 |
| `/c/read` | 求人票を読み取る（AI → 確かめて載せる） | 採用担当（見本は はやせ運輸・大泉ハウス配送として入る） |
| `/o` | 運営のホーム（掲載前の確認・古い求人・返事が遅い会社・答えられなかった質問・問い合わせ） | 運営 |
| `/o/review/:id` | 掲載前の確認 | 運営 |
| `/o/how` | 本番での仕組み | 運営 |

ドライバーの画面はスマホが主だが、PCで開いても同じ中身で使える（PCの見え方は承認した全体案に合わせる）。
デモの帯（黒地・画面の骨組みとは別に、どの画面にも出す）：見る人の切り替え（ドライバー 大野 健太／しろかね運送 採用担当 河合 由紀／運営 藤田 奈央）、リセット、「これはデモです。会社・人物・求人は架空。AIは外部につながず、このブラウザの中だけで動きます」。

---

# 5. 見本データ

## 会社（8社・すべて架空）

| ID | 会社 | 所在地 | 中身 | 返事までの平均 |
|---|---|---|---|---|
| c1 | しろかね運送株式会社 本社営業所 | 東京都練馬区 | 車両12台・ドライバー15名（女性2名）。食品・日用品の地場と中距離 | **1.2日** |
| c2 | 武蔵野ロジ株式会社 府中センター | 東京都府中市 | コンビニ・ドラッグストアのルート配送 | 2.0日 |
| c3 | 東邦エキスプレス株式会社 戸田営業所 | 埼玉県戸田市 | 大型の長距離（関西・東北） | 3.5日 |
| c4 | かわせみ冷凍輸送株式会社 | 埼玉県川口市 | 冷凍・冷蔵（スーパー・外食） | 1.8日 |
| c5 | 青梅トランスポート株式会社 | 東京都青梅市 | トレーラー・平ボディ・ユニック（建材） | 4.0日 |
| c6 | はやせ運輸株式会社 | 埼玉県所沢市 | 中型・大型のウイング。**今日、求人票を写真で入れた**（読み取りの見本1） | — |
| c7 | 港南カーゴ株式会社 | 東京都大田区 | 海上コンテナのトレーラー | 2.5日 |
| c8 | 大泉ハウス配送株式会社 | 東京都練馬区 | 家具・家電の配送と設置（2人1組）。**返事が遅い**（返事待ち4件）。手書きのメモが読み取りの見本2 | **6.0日** |

## 求人（24件）

掲載中20件・掲載前の確認3件（j12・j18・j21）・下書き1件（j16＝読み取りの見本1から作るもの）。月給は「月給の例」（下限〜上限）。

| ID | 会社 | 仕事 | 車種 | 免許 | 荷役 | 範囲・泊まり | 出勤 | 休み | 月給の例 | 札 | 状態 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| j01 | c1 | 食品工場→物流センターの地場 | 4t ウイング | 中型（8t限定可） | なし（パレット・フォーク） | 地場・日帰り | 6:00 | 土日休み（年間105日） | 30〜36万（基本22万＋歩合＋無事故手当1万） | 経験者 | 掲載中 |
| j02 | c1 | 練馬→静岡・愛知の中距離 | 10t ウイング | 大型 | なし（パレット・フォーク） | 中距離・月4〜6泊 | シフト | 週休2日（シフト） | 38〜45万 | 経験者 | 掲載中 |
| j03 | c1 | スーパーの店舗配送 | 2t 冷凍車 | 準中型 | 一部（カゴ台車・一部手降ろし） | 地場・日帰り | 4:30 | 日曜＋平日1日 | 26〜30万 | 未経験可・免許取得支援（中型） | 掲載中 |
| j04 | c2 | コンビニのルート配送（夜） | 2t 箱車 | 準中型 | なし（カゴ台車） | 地場・日帰り | 22:00（夜勤） | 週休2日（シフト） | 28〜33万 | 未経験可 | 掲載中 |
| j05 | c2 | ドラッグストアのルート配送 | 4t 箱車 | 中型（8t限定可） | あり（段ボールの手積み・手降ろし） | 地場・日帰り | 7:00 | 土日休み | 27〜31万 | — | 掲載中 |
| j06 | c2 | 昼のルート配送 | 2t 箱車 | 準中型（5t限定可） | なし（カゴ台車） | 地場・日帰り | 9:00 | 土日祝休み | 24〜27万 | 未経験可・女性ドライバーが働いています | 掲載中 |
| j07 | c3 | 関西便 | 10t ウイング | 大型 | なし（パレット・フォーク） | 長距離・月8〜10泊 | 夕方発 | 週休2日（シフト） | 45〜55万（歩合多め） | 経験者 | 掲載中 |
| j08 | c3 | 東北便 | 10t 箱車 | 大型 | あり（バラ積み） | 中距離・月4泊 | シフト | 週休2日（シフト） | 38〜48万 | 経験者 | 掲載中 |
| j09 | c3 | 戸田まわりの地場 | 4t ウイング | 中型 | なし（フォーク） | 地場・日帰り | 7:30 | 土日休み | 28〜32万 | — | 掲載中 |
| j10 | c4 | スーパーの冷凍便 | 4t 冷凍車 | 中型 | 一部（カゴ台車） | 地場・日帰り | 3:00 | 週休2日（シフト） | 30〜35万 | — | 掲載中 |
| j11 | c4 | 外食チェーンの冷凍便 | 2t 冷凍車 | 準中型 | 一部（カゴ台車） | 地場・日帰り | 5:00 | 日曜＋平日1日 | 26〜29万 | 未経験可・免許取得支援（中型） | 掲載中 |
| j12 | c4 | 大型冷凍の中距離 | 10t 冷凍車 | 大型 | なし（パレット） | 中距離・月3泊 | シフト | 週休2日（シフト） | 40〜47万 | 経験者 | **掲載前の確認** |
| j13 | c5 | 建材のトレーラー | トレーラー | けん引＋大型 | なし（積込みは荷主のフォーク） | 中距離・月2泊 | 6:00 | 日祝休み | 45〜52万 | 経験者 | 掲載中 |
| j14 | c5 | 建材の大型平ボディ | 10t 平ボディ | 大型 | 一部（荷締め・シート掛け） | 地場・日帰り | 6:00 | 日祝休み | 38〜44万 | — | 掲載中 |
| j15 | c5 | 4t ユニックの地場 | 4t 平ボディ（ユニック） | 中型＋小型移動式クレーン・玉掛け | 一部（クレーン作業） | 地場・日帰り | 7:00 | 土日休み | 33〜38万 | 資格取得支援 | 掲載中 |
| j16 | c6 | 4t ウイングの日帰り | 4t ウイング | 中型 | （読み取りで不足） | 地場・日帰り | 7:00 | 土日休み | 基本21万＋歩合（かすれ） | — | **下書き**（読み取りの見本1） |
| j17 | c6 | 大型ウイングの中距離 | 10t ウイング | 大型 | なし（パレット） | 中距離・月4泊 | シフト | 週休2日（シフト） | 40〜46万 | 経験者 | 掲載中 |
| j18 | c6 | 2t の地場 | 2t 箱車 | 準中型 | 一部 | 地場・日帰り | 8:00 | 土日休み | 25〜28万 | 未経験可 | **掲載前の確認** |
| j19 | c7 | 海上コンテナ（港→倉庫） | トレーラー | けん引＋大型 | なし | 地場・日帰り | 6:30 | 土日休み | 42〜50万 | 女性ドライバーが働いています | 掲載中 |
| j20 | c7 | 港まわりの 4t | 4t 平ボディ | 中型 | 一部（荷締め） | 地場・日帰り | 8:00 | 土日休み | 30〜34万 | — | 掲載中 |
| j21 | c7 | 海上コンテナ（夜） | トレーラー | けん引＋大型 | なし | 地場・日帰り | 20:00（夜勤） | 週休2日（シフト） | 45〜53万 | 経験者 | **掲載前の確認** |
| j22 | c8 | 家具・家電の配送と設置（2人1組） | 2t 箱車 | 準中型 | あり（設置まで） | 地場・日帰り | 8:00 | 週休2日（シフト） | 27〜32万 | 未経験可 | 掲載中・**最終更新 7/30（84日）** |
| j23 | c8 | 大型家具の配送 | 4t 箱車 | 中型 | あり | 地場・日帰り | 8:00 | 週休2日（シフト） | 27〜33万 | — | 掲載中・**最終更新 8/10（73日）** |
| j24 | c8 | 配送の助手 | 2t 箱車（助手席） | 普通 | あり | 地場・日帰り | 8:00 | 週休2日（シフト） | 22〜24万 | 未経験可・免許取得支援（準中型） | 掲載中 |

- **大野さんの条件「中型・手積みなし・日帰り・土日休み」で出るのは j01・j06・j09 の3件**（j06 は準中型の 2t だが、中型の免許で乗れるので出る。j05 は手積みあり、j04 は夜勤でシフトの休みなので出ない。テストで確かめる）。「夜勤なし」を足しても3件のまま。ミチの「土日休みで手積みなしの4t」は 4t に絞るので j01・j09 の2件。
- 1日の流れ・業務と就業場所の変更の範囲・試用期間・社会保険・受動喫煙・拘束時間の目安（月）は、掲載中の全求人に書く（j01 の例：5:40 出勤・点呼 → 6:00 出庫 → 7:00 食品工場で積込み（フォーク）→ 9:00 物流センターで降ろし → 昼休憩 → 13:00 2便目 → 16:30 帰庫・点呼・日報。拘束時間の目安 月230時間。業務の変更の範囲「会社の定める運転業務・構内作業」、就業場所の変更の範囲「本社営業所（練馬区）のみ」）。
- 掲載日・最終更新日を全求人に持つ。j22・j23 だけが60日を超える。**画面に「記載なし」を出さない**（全体案の画像の「掲載日・更新日：記載なし」「内訳は記載なし」は仮。下の表で埋める）。

| ID | 掲載日 | 最終更新日 | 給与の内訳 |
|---|---|---|---|
| j01 | 9/14 | 10/15 | 基本給22万＋歩合＋無事故手当1万 |
| j02 | 9/14 | 10/15 | 基本給24万＋歩合＋運行手当（1泊3,000円） |
| j03 | 10/01 | 10/01 | 基本給20万＋歩合＋早朝手当2万 |
| j04 | 8/25 | 10/10 | 基本給21万＋深夜手当＋歩合 |
| j05 | 8/25 | 9/30 | 基本給23万＋残業代 |
| j06 | 9/05 | 10/12 | 基本給21万＋残業代＋無事故手当5,000円 |
| j07 | 7/01 | 10/03 | 基本給20万＋歩合（多め）＋運行手当 |
| j08 | 7/01 | 9/20 | 基本給25万＋歩合＋運行手当 |
| j09 | 9/20 | 10/14 | 基本給23万＋残業代＋皆勤手当1万 |
| j10 | 8/18 | 10/08 | 基本給24万＋早朝手当＋歩合 |
| j11 | 8/18 | 10/08 | 基本給20万＋早朝手当1.5万＋歩合 |
| j12 | （確認待ち・10/21 申請） | 10/21 | 基本給26万＋歩合＋運行手当 |
| j13 | 6/10 | 9/26 | 基本給28万＋歩合＋けん引手当2万 |
| j14 | 6/10 | 9/26 | 基本給27万＋残業代＋無事故手当1万 |
| j15 | 8/01 | 9/12 | 基本給25万＋クレーン手当2万＋残業代 |
| j16 | （下書き・10/22） | 10/22 | 基本給21万＋歩合（読み取りで金額がかすれ） |
| j17 | 9/28 | 10/18 | 基本給25万＋歩合＋運行手当 |
| j18 | （確認待ち・10/21 申請） | 10/21 | 基本給20万＋残業代 |
| j19 | 7/22 | 10/05 | 基本給26万＋歩合＋けん引手当2万 |
| j20 | 7/22 | 9/18 | 基本給24万＋残業代 |
| j21 | （確認待ち・10/20 申請） | 10/20 | 基本給27万＋深夜手当＋けん引手当2万 |
| j22 | 5/12 | **7/30（84日）** | 基本給20万＋設置手当＋残業代 |
| j23 | 5/12 | **8/10（73日）** | 基本給21万＋残業代 |
| j24 | 6/02 | 9/01 | 基本給19万＋残業代 |

## 応募（14件）

- **大野 健太**（ドライバー）：j01 しろかね運送に 10/20 応募 → 10/21 河合さんから返事「面接日の候補：10/27（火）10:00／10/28（水）15:00／10/29（木）10:00」（**まだ選んでいない**）。j09 東邦エキスプレスに 10/19 応募 → 返事待ち（3日）。気になる：j06・j19・j10。
- **しろかね運送への応募 7件**：大野 健太（j01・面接日の調整中）／**新着2件**（村上 千尋 j03・未経験・10/22 18:10／長谷川 豊 j02・大型の経験12年・10/22 19:45）／返事済み1件（林 和也 j01・面接 10/24）／面接済み1件（岡田 拓真 j02・10/20 面接）／採用1件（**石井 陸** 9/12 応募・4t ウイングの募集 → 10/27 から入社。SHAKO の12号車に乗る人。その募集は終了）／見送り1件（松本 大樹・大型の免許がないため、会社の判断）。
- ほかの会社への応募 7件（東邦エキスプレス1件＝大野さん・武蔵野ロジ1件・かわせみ冷凍輸送1件・大泉ハウス配送の返事待ち4件）。直近7日（10/16〜10/22）の応募は11件。応募者はすべて架空。名前は採用担当と本人の画面にだけ出る（運営の画面には件数だけ）。

## よくある質問・言葉

- 言葉（20語）：普通・準中型・中型・大型・けん引の各免許、5t限定・8t限定、地場・中距離・長距離、ルート配送・チャーター、手積み・手降ろし、パレット・フォーク・カゴ台車、歩合、無事故手当、拘束時間、点呼、ユニック、ウイング。説明は免許の区分など一次情報で確かめて書く。
- よくある質問：ドライバー向け15（応募の流れ・返事までの日数・取り消し・お金はかからない・会社に質問できる・免許取得支援とは・未経験の求人の見方など）、会社向け10（求人の載せ方・求人票の読み取り・確認にかかる日数・直し方・応募への返事の出し方など）。**掲載料の金額はデモでは決めない**（聞かれたら「運営にお問い合わせください」と答える）。

## 運営の画面に出るもの（今日の時点）

掲載中の求人 20件・掲載前の確認 3件・最終更新から60日を過ぎた求人 2件（大泉ハウス配送）・返事が遅い会社 1社（大泉ハウス配送 平均6.0日・返事待ち4件）・ミチが答えられなかった質問 5件（「この会社の評判は？」「年収1000万の仕事は？」「面接に受かるコツは？」「寮がある会社は？」「女性用の更衣室はある？」）・問い合わせ 2件（「求人の休みと面接で聞いた話が違う」→ 会社に確認中／「応募を取り消したい」→ 案内済み）。今週の応募 11件・今日ミチに聞かれた 86回。

---

# 6〜8. 見た目

- **デザイン画像（Codex で作るもの）を正とする。** デザインは2段：第1段で骨組みの違う全体案3つ → 菊池さんが1案を承認 → 第2段で残りの画面・写真・ミチの絵。画像が届くまで画面を作らない（絞り込み・AI・見本データ・テストは先に作ってよい）。
- 画面の並べ方（どこに何を置くか）はこの要件定義書では決めない。決めるのは承認した全体案。
- **承認した全体案：改訂版 A「検索と詳細」**（2026-10-22 菊池さん「Aで」。`デザイン/全体案/改訂版/A/`）。PCは左に求人の一覧・右に選んだ求人の詳細、白地に青（#2557A7）、上に「さがす・応募した求人・気になる・ミチに聞く」。スマホの「ミチに聞く」は会話の中に求人カードが並ぶ。
- 世界観の方針：仕事から帰ったドライバーが、スマホで落ち着いて仕事を比べられる求人サイト。差し色は1色（WADACHI・TEHAI・YUTORI・SHAKO・HIREBASE とは別の色にして別のアプリに見せる）。注意は赤・黄に文と記号を添える。
- **案内役ミチ**：女性ドライバーの見た目のキャラクター（架空・実在の人に似せない）。30代くらい、作業着とキャップ、明るく落ち着いた人柄。働く人として描き、性的な見せ方・アイドル風にしない。表情は4つ（ふだん・探している・見つけた（笑う）・休む）。**画面の右下にいつもいて、そこに「いる」ことが大事**（TSUTAE の案内役「つたえ」と同じ動き。見た目だけが違う）。絵は第2段で Codex が作る（第1段は仮の絵で可）。
- 写真を画面のあちこちに使う（スタート・求人のカード（車・荷台・積み場）・会社の写真・空の状態）。しろかね運送の車の写真は WADACHI・SHAKO から流用する。人物の写真は使わない（応募者・採用担当は名前の頭文字の丸）。
- ドライバーのスマホは、大きな文字・大きなボタン。札は押しやすい大きさ。
- 日本語は Noto Sans JP、数字は等幅の数字。月給・時刻は折り返さない。

# 9. 技術

Vite 6 + React 19 + React Router 7 + Tailwind v4（色はチャンネル値の CSS 変数）+ Zustand（persist）+ lucide-react。SHAKO（souzoh-official/shako）と同じ構成。画像は `scripts/images/`（prepare・import）と `src/lib/images.ts`。Cloudflare Workers の静的アセットで配信（`norite.souzohnic.workers.dev`）。案内役の動き（右下にいる・話しかける・小さなチャット・ドラッグ・休む）は TSUTAE（souzoh-official/tsutae）の `AgentPet` を写して、見た目だけ差し替える。

# 10. 非機能

- 320px〜2560px で横にはみ出さない
- 初期の JS は 200KB（gzip）以下
- スマホの画面は、ボタンの高さ 48px 以上・文字 16px 以上
- 絞り込みは押してすぐ（100ms 以下）に一覧が変わる
- ミチはキーボードでも操作できる（Enter/スペースで開く・Escで閉じる）。吹き出しは読み上げに知らせる

# 11. 実装タスク

## Phase 1 — 絞り込みとAI
- [ ] calc/filter.ts（免許・荷役・範囲・出勤・休み・給与）・calc/stale.ts（古い求人）・calc/reply.ts（返事までの日数）
- [ ] ai/reader.ts（求人票の読み取り・足りない項目）・ai/concierge.ts（ミチの答え）・ai/limit.ts（上限）
- [ ] テスト（2章の「テスト必須」・読み取りのテスト・ミチの20問）
## Phase 2 — 見本データ
- [ ] 会社8・求人24（1日の流れ・変更の範囲まで全部）・応募14・やりとり・言葉20・よくある質問25・求人票の見本2枚（画像も Claude が作る：実在の様式に似せない求人票と手書きのメモ）
## Phase 3 — 画面（デザイン画像が届いてから）
- [ ] 外枠・デモの帯・ミチ・ドライバー（さがす・詳細・比べる・応募・応募した求人・ミチに聞く）・採用担当（応募・やりとり・自社の求人・読み取り）・運営（ホーム・確認・本番での仕組み）・スタート
## Phase 4 — 仕上げ
- [ ] 写真とミチの絵の取り込み・リセット・レスポンシブ総点検・公開

# 12. 受入基準

1. 見せ場①〜⑤が動く
2. 絞り込みとAIのテストがすべて通る（`npm test`）
3. ドライバーが応募すると、採用担当の「新着」が増え、返事を出すとドライバーの「応募した求人」に届く。面接日を選ぶと両方の画面が変わる
4. 自信なし・足りない・年齢の欄が残っている読み取り結果は載せられない。載せると運営の「掲載前の確認」に入り、運営が載せるとドライバーの一覧に出る
5. ミチが答えられなかった質問は、運営の画面に入る。ミチの答えに、掲載前の求人・応募者の名前が出ない
6. 320／375／768／1024／1280／1920px で横はみ出し0・文字の切れなし
7. 「言わないこと」が画面の文言に入っていない（`grep` で0件）

# 出典

- 厚生労働省「令和４年職業安定法の改正の概要について ～求人メディア等のマッチング機能の質の向上～」（令和4年9月作成）https://www.mhlw.go.jp/content/11600000/000992910.pdf （募集情報等提供の定義の拡大・的確表示・苦情処理・個人情報の保護・特定募集情報等提供事業者の届出。2026-10-22 PDF本文で確認）
- 厚生労働省「令和６年４月より、募集時等に明示すべき事項が追加されます」https://www.mhlw.go.jp/stf/seisakunitsuite/bunya/koyou_roudou/koyou/haken-shoukai/r0604anteisokukaisei1.html （業務の変更の範囲・就業場所の変更の範囲・有期契約の更新の基準。2026-10-22 確認）
- 厚生労働省「2024年4月から労働条件明示のルールが変わります」https://www.mhlw.go.jp/stf/newpage_32105.html
- 自動車運転の職業の有効求人倍率：カーゴニュース「７月の有効求人倍率 ドライバー職は2.53倍」https://cargo-news.online/news/detail.php?id=11980 （厚生労働省「一般職業紹介状況」をもとにした報道。全職業 1.18倍は 令和8年7月分。2026-10-22 確認。**厚労省の表そのものは未確認**）
- 労働施策総合推進法 第9条（募集・採用における年齢にかかわりない均等な機会）、男女雇用機会均等法 第5条
- Lark Base デモアプリ表 recvw0QPLtFKOt（17番）


---

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

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

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

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

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

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