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

**版数** 1.0（DBレス構成のデモ）／ **作成日** 2026-10-21 ／ **発行** ソウゾウ合同会社
**用途** 業種特化アプリの実演デモ ／ 元請の工務店・設備工事会社向け「職人台帳から作る作業員名簿と新規入場者教育」

---

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

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

- 実装は「11. 実装タスク」の順に進める。フェーズを飛ばさない。
- 仕様に書かれていないことは推測で作らず質問する。質問できない状況では「判断に迷ったときのルール」で決め、`docs/DECISIONS.md` に1行ずつ残す。
- 3章の「作らないもの」は、思いついても作らない。
- 「デモだから」を理由に品質を落とさない。**名簿の組み立て（どの職人のどの項目を載せるか・注意の判定）と、現場のルール文から確認テストを作るしくみは、テストが通るまで画面を作らない。**
- **現場の言葉で書く。** 画面の文言は、工事担当・安全担当・協力会社の職長・職人が毎日使っている言葉に合わせる（元請・協力会社・一次・二次・職長・職人・一人親方・現場・着工・入場・新規入場者教育・送り出し教育・作業員名簿・安全書類・朝礼・KY・職種・資格・技能講習・特別教育・社会保険・健康保険・年金・雇用保険・建退共・健康診断・血圧・フルハーネス・足場・開口部・立入禁止・退避・集合場所・火気・喫煙所・駐車）。「ユーザー」「レコード」「マスタ」「ステータス」「ワークフロー」「コンプライアンス」を画面に出さない。

> **このアプリが選ばれる理由**
> 元請の工務店や設備工事会社では、新しい現場が始まるたびに、協力会社から職人の情報（生年月日・職種・社会保険・資格・健康診断）を紙やExcelで集め直し、現場ごとの作業員名簿に書き写している。同じ職人が3つの現場に入れば、同じことを3回書く。資格の取り忘れや健康診断の古さは、書き写すときに人が気づくしかない。新規入場者教育は朝の現場で口で説明し、受けた記録は紙1枚で、どの職人がどの現場で受けたかを後から探すのが大変。
> SOROI は、**職人を1回台帳に入れれば、現場で入る職人を選ぶだけで作業員名簿がそろい、足りない資格や古い健康診断はその場で分かる。初めてその現場に入る職人には、現場のルールの文からAIが作った確認テストがスマホに届き、受けた記録が名簿の「教育」の欄にそのまま入る**ようにする。
> 同じ職人の情報を現場ごとに書き直す、名簿を作ったあとで資格の不足に気づく、入場教育の記録を紙で探す、のどれか1つでもあれば失敗とみなす。

---

## 課題定義（台帳 2026-10-21 時点・定義の状態「西澤確認待ち」。菊池さんの指示で着手）

台帳で空いている欄（理想・課題・見る前と見た後の感情）は、弊社の案として埋めた（※印）。西澤さんの確認で台帳が変わったら、この表と本文を合わせて直す。

| 項目 | 内容 |
|---|---|
| 誰に刺すか | 元請の工務店・設備工事会社の工事担当・安全担当（作業員名簿や安全書類を現場ごとに作り直している） |
| 場面 | 新しい現場が始まるとき／新しい職人が入場するとき（新規入場者教育） |
| 問題（ふわっと） | 「同じ職人の情報を、現場ごとに書き写している」（推測：本人の言葉は未取得） |
| 理想 ※ | 職人のことは1か所に入れておけば、どの現場の名簿もすぐにそろい、入場教育を誰が受けたかもすぐ分かる |
| 課題（ギャップ）※ | 協力会社と職人の情報を1つの台帳にまとめ、現場では入る職人を選ぶだけで名簿ができ、足りない資格・古い健康診断・入場教育の未受講がその場で分かる状態にする。入場教育の資料と確認テストは、元請が書いた現場のルールの文から作る |
| 見る前の感情 ※ | 「安全書類は面倒だけど、仕方ない」「元請から言われた形で出すしかない」「うちの規模でシステムは大げさ」 |
| 見た後の感情 ※ | 「職人を選ぶだけで名簿ができるなら楽」「資格の不足に先に気づける」「入場教育の記録を探さなくていい」 |
| 見せ場（必ず見せる） | ①職人台帳（資格・社会保険・教育歴）を1回入れれば、現場ごとの作業員名簿がそろう ②新規入場者教育を受けた記録が残る ③AI：現場のルール文から新規入場者教育の確認テストを作る（保険証などの読み取りはさせない） |
| 既製品で足りる部分／作る価値 | 元請が指定する安全書類のサービスがある現場ではそちらが優先。作る価値は、自社が元請の現場で、職人台帳を1つにすること |
| 言わないこと | 「（既存の安全書類サービス・建設キャリアアップシステム）の代わりになる・連携できる」／「施工体制台帳が作れる＝義務を果たせる」。**画面・この文書の本文・依頼書に、特定のサービス名を出さない** |

---

# 1. プロジェクト概要

## 背景（出典は末尾）

- **作業員名簿の項目は法令で決まっている。** 施工体制台帳には、建設工事に従事する人ごとに ①氏名・生年月日・年齢 ②職種 ③社会保険（医療保険・年金・雇用保険）の加入等の状況 ④建退共（中小企業退職金共済法の被共済者）か否か ⑤安全衛生に関する教育を受けているときはその内容 ⑥建設工事に関わる資格、を書く。⑥の資格は、**本人が希望しない場合は載せない**。あわせて、特定技能1号の外国人と技能実習生の従事の状況を書く（建設業法施行規則 第14条の2 第1項 第2号チ・リ、第4号チ・リ）。
- **施工体制台帳を作る義務があるのは**、特定建設業者が発注者から直接請け負い、下請代金の総額が5,000万円以上（建築一式工事は8,000万円以上）になる工事（建設業法 第24条の8、施行令 第7条の4）。地域の工務店が元請になる現場の多くは、この義務の外にある。**それでも職人の情報は現場ごとに集めている**ので、このアプリは義務の話をせず「集め直しをやめる」ことだけを言う。
- **新規入場者教育**：建設業の特定元方事業者（元請）は、関係請負人（協力会社）が、その現場で新たに作業に従事する人に場所の状況・危険な箇所・作業どうしの関係を知らせるために、場所や資料を提供する（労働安全衛生法 第30条第1項第4号・労働安全衛生規則 第638条・第642条の3）。厚生労働省の「元方事業者による建設現場安全管理指針」は、元請がその実施状況の報告を受けて把握することと、教育の内容を8つ示している：①混在して作業を行う場所の状況 ②危険を生ずる箇所の状況 ③作業相互の関係 ④退避の方法 ⑤指揮命令系統 ⑥担当する作業内容と労働災害防止対策 ⑦安全衛生に関する規定 ⑧建設現場の安全衛生管理計画の内容。
  - このアプリでは、**元請が書いた「現場のルール」の文を、この8項目に振り分けて資料にし、確認テストを作る**。説明そのものは、入場の朝に現場で職長・工事担当が行う（アプリは説明の代わりではない）。
- 検索：グリーンファイル 8,100・作業員名簿 2,900・安全書類 1,000・新規入場者教育 1,000（ラッコキーワード 2026-10-13・Google・年平均）。

## プロダクト定義

| 項目 | 内容 |
|---|---|
| 名前 | SOROI（そろい）※仮称。職人を1回入れれば、どの現場の名簿もそろう |
| 一言 | 職人台帳から、現場ごとの作業員名簿と入場教育の記録がそろう |
| 提供形態 | レスポンシブWebアプリ。**フロントエンド完結（サーバー側の保存なし）** |
| 見本の会社 | 「つぎて住まい工房株式会社」（架空。リフォーム・工務店のデモ TSUGITE と同じ会社。栃野県栃野市）。リフォーム課と**新築課**。このデモは新築課が元請の現場 |
| 見本の場面 | **今日の朝 8:30、事務所**。新築課の工事担当 藤原さんが、来週月曜に着工する「みどり台 M様邸 新築工事」を作り、入る職人を選んで名簿を作る。昼に、初めてこの現場に入る職人のスマホに確認テストが届く。夕方、課長の大塚さんが3つの現場の入場教育の記録を見る |
| 主戦場 | 事務所のPC（工事担当・課長・事務）／協力会社の職長のスマホ（自社の職人の情報を入れる・直す）／職人のスマホ（確認テストを受ける。ログインなし） |

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

1. 開いた瞬間に、職人20名・協力会社5社・現場3つの台帳が見え、注意の出ている職人（健康診断が古い・特別教育の記録がない など）に印と理由の1文がある
2. 工事担当が「みどり台 M様邸」を作り、協力会社と職人を選ぶと、**作業員名簿がその場でそろう**（氏名・生年月日・年齢・職種・社会保険・建退共・教育・資格・外国人の従事の状況・健康診断）。同じ職人が別の現場の名簿にもいることが分かる
3. 名簿をそろえた時点で、**確定の前に**「この現場で足りないもの」が出る（例「やねや板金 森 浩之：屋根の作業でフルハーネスを使うが、特別教育の記録がありません」「田島工務 宮本 剛：健康診断が13か月前です（会社の決まりは1年以内）」）。確定するのは工事担当
4. 工事担当が現場のルールの文（見本あり）を貼って「確認テストを作る」を押すと、AIが文を指針の8項目に振り分け、**書かれていない項目を知らせ**（例「④退避の方法が書かれていません」）、5問の確認テストの下書きを出す。各問に、根拠になったルールの文が印付きで付く。工事担当が直して「この内容で使う」を押すまで、職人には届かない
5. 初めてこの現場に入る職人（坂口左官 坂口 颯太）のスマホに確認テストが届き、答えると正誤と根拠の文が出る。合格すると、名簿のその人の「教育」の欄に「新規入場者教育 10/27 みどり台 M様邸（確認テスト 5/5）」が入る。工事担当の画面もその場で変わる（別タブ・`/split` でも）
6. 技能実習生（青木設備 グエン・ヴァン・トゥアン）は、確認テストをふりがな付きで受けられ、名簿の「外国人の従事の状況」の欄が埋まる
7. 名簿を印刷用（A4 横）と CSV で出せる
8. リセットできる

---

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

- すべてブラウザ内で動く。保存は localStorage（見本から変えた分だけ）。見本は「今日」を基準に毎回同じものを組み立てる（生年月日・健康診断日・受講日は今日からの日数で持つ）。
- **画面どうしの同期**：別タブ・別ウィンドウの変更は `storage` イベントと `BroadcastChannel('soroi')` で受けて、その場で描き直す。`/split` は工事担当の画面と職人のスマホを1画面に並べる（見せ場②⑤を1画面で見せるため）。
- **AIは外部につながない**（2026-10-08 に決めたデモの方針：費用0円・毎回同じ動き・悪用されない）。ルール文の振り分け・確認テストの下書き・足りないものの文は `src/lib/ai/` の純粋な関数で、同じ入力なら同じ結果を返す。本番ではこの部分だけを Claude に差し替える（`Brain` の型を守る）。
- 本番で外部のAIを呼ぶときの決まり（デモでは画面の「本番での仕組み」に書くだけ）：①AIに送るのは**現場のルールの文だけ**。職人の氏名・生年月日・保険・健康診断の情報は送らない。保険証・資格証の写真をAIに読ませない ②1日の呼び出し回数（50回）と月の予算（2,000円）に上限を持たせ、超えたら手で問題を作る画面に戻す。画面に「AIの上限 今日 3/50回・今月 ¥0/¥2,000（デモは0円）」を出す ③確認テストを使うかを決めるのは工事担当。
- 個人の情報（生年月日・健康診断・保険）は、**元請の社員と、その職人の協力会社の職長にだけ見える**。ほかの協力会社には見えない。判定は `src/lib/repo/_scope.ts` の1か所に集める。職人本人のスマホには、自分の確認テストと自分の受講記録だけを出す。
- 画面はストアを直接触らず `src/lib/repo/` の関数とフックを使う。

## 名簿の決まりごと（`calc/`）

| 項目 | 決まり |
|---|---|
| 職人台帳 | 1人1件。所属の協力会社・氏名・ふりがな・生年月日・職種・経験年数・社会保険（健康保険の種類／年金の種類／雇用保険：加入・適用除外）・建退共（被共済者か）・資格（種類と取得日・番号の下4けた）・特別教育・職長教育・健康診断（受けた日・血圧・特記）・外国人の在留資格（特定技能1号／技能実習／それ以外は書かない）・緊急の連絡先（続柄だけ見本に出す）・**資格を名簿に載せるか（本人の希望）** |
| 年齢 | 生年月日から、名簿を作る日（着工日）の時点で数える |
| 名簿 | 現場ごとに、入る協力会社（一次・二次）と職人を選ぶと、台帳の値を**その時点の写し**として名簿に入れる。台帳をあとで直しても、確定した名簿は変わらない（「台帳の新しい内容で作り直す」を押したときだけ変わる） |
| 資格の欄 | 本人が「載せない」を選んでいる人は、名簿の資格の欄に「本人の希望により記載なし」と出す（台帳には持っている） |
| 社会保険の欄 | 一人親方など雇用保険の対象でない人は「適用除外」と出す（注意ではない）。未加入の人は「未加入」と赤で出し、理由を台帳に書けるようにする |
| この現場で足りないもの | ①**現場の作業と資格**：現場ごとに「この現場の作業」（見本：足場の組立て・高さ2m以上の作業・屋根の作業・車両系建設機械（整地）・玉掛け・研削といし）を持ち、作業ごとに要る資格・特別教育を会社の決まりとして持つ。職人の職種から、その人が就く作業を見本で決め、要るものが台帳に無ければ出す ②**健康診断**：受けた日が、会社の決まり（見本：1年以内）より古い ③**新規入場者教育**：この現場で受けていない（ほかの現場で受けていても、この現場は別に要る） ④**年齢**：18歳未満は就けない作業がある、を知らせる（見本には18歳未満はいない。テストだけ） |
| 確定 | 足りないものが残っていても確定はできる（止めない）。残っているものは「確定の時点で残っていたもの」として名簿に記録し、入場の許可は工事担当が1人ずつ押す |
| 入場教育の記録 | 現場・受けた日・説明した人（職長または工事担当）・資料の版・確認テストの点・本人の確認。名簿の「教育」の欄には、この現場の新規入場者教育と、送り出し教育・職長教育・特別教育を並べる |

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

| 項目 | 決まり |
|---|---|
| ルール文の振り分け（`ai/sort.ts`） | 元請が書いた現場のルールの文を1文ずつに分け、指針の8項目（場所の状況／危険な箇所／作業どうしの関係／退避の方法／指揮命令／担当する作業と対策／安全衛生の決まり／安全衛生の計画）に振り分ける。言葉の辞書で決める（例：「開口部・立入禁止・足場・吹き抜け」→危険な箇所、「集合場所・避難・地震・火事」→退避、「職長・工事担当・連絡・報告」→指揮命令、「喫煙・火気・ヘルメット・駐車」→決まり）。どこにも入らない文は「そのほか」。**どの項目にも文が無いときは「④退避の方法が書かれていません」と知らせる**（止めない） |
| 確認テストの下書き（`ai/quiz.ts`） | 振り分けた文から、数字・場所・「禁止」「必ず」「してはいけない」を含む文を優先して5問を作る。4択（正解1・間違い3）。間違いの選択肢は、同じ種類の言葉の入れ替え（時刻・場所・数・人）で作り、本当らしく見えるものにする。各問に、根拠の文を必ず付ける。危険な箇所・退避・指揮命令から最低1問ずつ。**同じ文と同じ設定なら、毎回同じ5問になる** |
| ふりがな（`ai/ruby.ts`） | 技能実習生と特定技能の人には、問題と選択肢と根拠の文に、ふりがなを付けて出す（見本の辞書で付ける。読めない漢字は付けずに残す） |
| 足りないものの文（`ai/gaps.ts`） | 名簿の注意を、工事担当がそのまま協力会社に伝えられる1文にする（例「森さんのフルハーネスの特別教育の修了の記録を、やねや板金さんから送ってもらってください」）。「違反」「法令違反」の言葉は使わない |
| 決めるのは人 | AIの結果は「下書き」。確認テストを使う・名簿を確定する・入場を許可する、は工事担当が押す。押したものは「変更の記録」に残り、元に戻せる |

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

1. 迷ったら、来週の着工を前に名簿をそろえたい工務店の工事担当と、朝の現場でスマホを片手に入場教育を受ける若い職人を思い浮かべる
2. 職人のスマホは、ログインなし・大きな文字・押す回数を少なく（1問1画面・答えを押すだけ）
3. 色には必ず文と数字を添える（「赤」だけで終わらせず「健康診断 13か月前」）
4. 法令の言葉で人を責めない。「足りないもの」「確かめてください」と書く

---

# 3. スコープ

## 作るもの

| ID | 機能 |
|---|---|
| F-01 | 職人台帳：職人20名の一覧（協力会社・職種・年齢・資格の数・健康診断・入っている現場・注意）。絞り込み（協力会社・職種・注意のある人・この現場で未受講）。**絞り込みで隠れた人数と「すべて表示」を必ず出す** |
| F-02 | 職人の詳細：台帳の全項目・入っている現場と名簿・教育の記録（現場ごと）・変更の記録。資格を名簿に載せるかの切り替え |
| F-03 | 協力会社：5社の一覧と詳細（一次・二次・建設業許可の番号（架空）・社会保険の加入状況・職長・所属の職人） |
| F-04 | 現場：3つの現場の一覧（工期・工事担当・入る会社と人数・名簿の状態・入場教育の済み／まだ）。「新しい現場」 |
| F-05 | 名簿をそろえる：現場を選ぶ → 協力会社を選ぶ → 職人を選ぶ（その現場の作業ごとに、足りないものがその場で出る）→ 名簿のプレビュー → 確定。1人ずつ「入場を許可」 |
| F-06 | 作業員名簿：現場ごとの名簿（会社ごとに並べる）。印刷用（A4 横）・CSV。確定の版と日付・確定の時点で残っていたもの |
| F-07 | 現場のルールと確認テスト：ルールの文を入れる（見本あり）→「確認テストを作る」→ 8項目への振り分けと抜けの知らせ → 5問の下書き（根拠の文つき）→ 直す → 「この内容で使う」。版を持つ |
| F-08 | 入場教育の記録：現場ごとに、入る予定の職人・受けた日・説明した人・テストの点・本人の確認。まだの人に「確認テストを送る（デモ）」 |
| F-09 | 職人のスマホ（ログインなし。送られたリンクから開く想定）：現場の名前と集合場所・今日の説明の要点（8項目の短い資料）・確認テスト（1問1画面・答えるとすぐ正誤と根拠の文）・「説明を受け、内容を確かめました」・自分の受講記録。ふりがなの切り替え |
| F-10 | 協力会社の職長のスマホ：自社の職人の一覧・情報を直す（資格の追加・健康診断の日付）・送り出し教育をした印。**直した内容は元請の台帳に「協力会社が更新」として出る**（元請が受け取るまで名簿には入らない） |
| F-11 | 並べて表示 `/split`：工事担当の画面と職人のスマホを1画面に |
| F-12 | 本番での仕組み：ログインと役割・協力会社への入力の頼み方・外部AIに送る範囲と上限・個人の情報の扱い（見える人・残す期間）・Excelの台帳の取り込み |
| F-13 | スタート・リセット・変更の記録 |

## 作らないもの

- 施工体制台帳・施工体系図・再下請負通知書・工事安全衛生計画書などの、ほかの安全書類（「本番での仕組み」で、同じ台帳から足せると書くだけ）
- ほかのサービス・システムとのつながり（画面に名前を出さない）
- 保険証・資格証・在留カードの写真の取り込みと、AIによる読み取り
- 入退場の記録（顔認証・ICカード）・日報・勤怠・労務費
- 実際のメール・SMS・LINE の送信（「送る（デモ）」はアプリの中で届くだけ）

---

# 4. 画面

| パス | 画面 | 主な人 |
|---|---|---|
| `/` | スタート（見せ場3つと、事務所／職長／職人の入口・並べて表示） | — |
| `/o` | 今日の事務所（3つの現場の名簿と入場教育の状態・協力会社からの更新・足りないもの） | 工事担当・課長 |
| `/o/people` `/o/people/:id` | 職人台帳・職人の詳細 | 工事担当・事務 |
| `/o/companies` `/o/companies/:id` | 協力会社 | 工事担当・事務 |
| `/o/sites` `/o/sites/:id` | 現場の一覧・現場（名簿・入場教育・現場のルール） | 工事担当・課長 |
| `/o/sites/:id/roster` | 名簿をそろえる → 作業員名簿 | 工事担当 |
| `/o/sites/:id/rules` | 現場のルールと確認テスト | 工事担当 |
| `/o/log` `/o/how` | 変更の記録・本番での仕組み | 課長 |
| `/k` | 職長のスマホ（自社の職人） | 協力会社の職長 |
| `/w/:token` | 職人のスマホ（資料・確認テスト・受講記録） | 職人 |
| `/split` | 並べて表示 | — |

画面上部に、デモの帯（黒地）：見る人の切り替え（工事担当 藤原さん／課長 大塚さん／事務 桜井さん／坂口左官 職長 坂口さん／職人 坂口 颯太さん／職人 グエンさん）、リセット、「これはデモです。会社・人・数字は架空です。AIは外部につながず、このブラウザの中だけで動きます」。

**画面の並べ方（メニュー・帯・カードの位置）は、ここでは決めない。** Codex に頼む全体デザインの3案から菊池さんが承認したものを正とする（6〜8章）。

# 5. 見本データ

- **元請**：つぎて住まい工房株式会社（架空・栃野県栃野市本郷3丁目・建設業許可 栃野県知事 許可（般-5）第000000号（架空））。新築課：課長 大塚 健二／工事担当 藤原 誠・杉山 由香・松下 亮。事務 桜井 典子。リフォーム課 課長 長谷部 修（TSUGITE と同じ人）。
- **協力会社5社・職人20名**（すべて架空。TSUGITE の協力業者と同じ会社。名前は `scripts/images/manifest.json` の顔写真と同じ）：
  - 田島工務（大工・一次）6名：職長 田島 正和（46）・宮本 剛（42）・**北村 修一（58）**・土屋 亮太（31）・野口 大輔（27）・千葉 拓海（23）
  - 青木設備（給排水設備・一次）4名：職長 青木 秀樹（52）・**グエン・ヴァン・トゥアン（26・技能実習 2号・ベトナム）**・**西田 浩（45）**・小林 翔（29）
  - 坂口左官（左官・一次）3名：職長 坂口 和也（55）・**坂口 颯太（19・入社8か月。和也さんの息子）**・吉川 誠（48）
  - やねや板金（屋根・板金・一次）4名：職長 屋根谷 誠（50）・**森 浩之（38）**・菅原 健（41）・高橋 優斗（25）
  - 花村インテリア（内装・一次）2名：**花村 雅人（51・一人親方）**・岡本 加奈（36）。その下に二次の **内田クロス 内田 隆（44・一人親方）** 1名
- **現場3つ**：
  - **みどり台 M様邸 新築工事**（木造2階建て・来週月曜 着工・工事担当 藤原）— 今日、名簿をそろえる現場。最初は名簿なし
  - 本郷 S様邸 新築工事（施工中・工事担当 杉山）— 名簿確定済み・入場教育は全員済み
  - 栃野駅前 店舗の改装工事（施工中・リフォーム課 長谷部）— 名簿確定済み・入場教育 1名まだ
- わざと入れる場面（**これが無いと見せ場が出ない**）：
  - **坂口 颯太**：みどり台に初めて入る。送り出し教育は済み・この現場の新規入場者教育はまだ → 確認テストが届く → 合格で名簿の教育の欄が埋まる
  - **宮本 剛**（田島工務）：本郷 S様邸では入場教育を受けている。みどり台は別の現場なので「この現場は初めて」と出る
  - **森 浩之**（やねや板金）：みどり台で屋根の作業に就くが、フルハーネスの特別教育の記録が台帳に無い → 足りないもの。職長のスマホで修了の記録を足す → 元請が受け取る → 消える
  - **北村 修一**（田島工務）：健康診断が13か月前 → 「会社の決まりは1年以内」
  - **花村 雅人**：一人親方。健康保険は国民健康保険、年金は国民年金、雇用保険は「適用除外」（注意ではないことを見せる）。建退共は「被共済者でない」
  - **西田 浩**（青木設備）：資格を名簿に載せない希望 → 名簿の資格の欄に「本人の希望により記載なし」
  - **グエン・ヴァン・トゥアン**：技能実習。名簿の外国人の欄が埋まる。確認テストはふりがな付き
- **現場のルールの見本**（みどり台 M様邸。約20行。わざと「退避の方法」を書かない）：朝礼は8:00・道路に車を停めない（近くの月極駐車場の3番〜5番）・喫煙は敷地の北東の喫煙所だけ・2階の床の開口部（階段の吹き抜け）は手すりの完成まで立入禁止・足場の昇り降りは階段の枠だけ・火気を使うときは前日までに藤原へ・資材の搬入は9:00〜16:00（近所の通学路のため7:30〜8:30は車を入れない）・高さ2m以上はフルハーネス・作業の変更は職長から藤原へ、など
- 変更の記録：過去10日ぶんの台帳の更新・名簿の確定・入場教育。
- AIの上限の数字：今日 3/50回・今月 ¥0/¥2,000（デモは0円）。

# 6〜8. 見た目

- **全体デザインは、Codex に頼む「骨組みの違う3案」から菊池さんが承認したものを正とする**（`翔平/SOROI/デザイン/全体案/`）。承認の前に画面と写真を作らない。承認のあと、残りの画面の画像と写真を頼み、届いたら同じ大きさで自分の画面を撮って横に並べ、1px の差まで直す。
- これまでのデモと同じ骨組み（左にメニュー・上に数字の帯・真ん中に一覧・右にまとめ）にしない。TSUGITE（同じ会社のデモ）とも別のアプリに見えるようにする。
- 色は落ち着いた主色1つ＋注意の赤＋確かめての黄。色には必ず文字と数字を添える。
- 職人のスマホは、大きな文字・大きなボタン（高さ 56px 以上）・1問1画面。
- 写真を画面全体に使う（スタートの現場の写真・職人の顔の丸・現場のカード・空の状態）。白地にカードと文字だけにしない。
- 日本語は Noto Sans JP、数字は等幅の数字。

# 9. 技術

Vite 6 + React 19 + React Router 7 + Tailwind v4 + Zustand（persist）。Cloudflare Workers の静的アセットで配信（`soroi.souzohnic.workers.dev`）。写真は `scripts/images/`（manifest → import → `src/lib/images.gen.ts`）。印刷は CSS の印刷用の指定（A4 横）。

# 10. 非機能

- 320px〜2560px で横にはみ出さない（名簿の表は横に送れる枠の中だけ。`data-hscroll`）
- 初期の JS は 200KB（gzip）以下
- 職人のスマホの画面は、ボタンの高さ 56px 以上・文字 16px 以上

# 11. 実装タスク

## Phase 1 — 名簿の計算とAI
- [x] calc/age.ts・calc/roster.ts（名簿の写し・資格の欄・社会保険の欄）・calc/gaps.ts（現場の作業と資格・健康診断・入場教育・年齢）
- [x] ai/sort.ts・ai/quiz.ts・ai/ruby.ts・ai/gaps.ts
- [x] テスト：年齢の数え方（誕生日の前日・当日）、確定した名簿は台帳を直しても変わらない、資格を載せない人、雇用保険の適用除外と未加入の違い、ほかの現場の入場教育は数えない、健康診断の境目（ちょうど1年は注意しない）、現場の作業に要る特別教育が無い、ルール文の振り分け（見本の20行＋退避が無いことの知らせ）、確認テストが毎回同じ5問になる・根拠の文が付く・危険な箇所と指揮命令から1問以上、ふりがな
## Phase 2 — 見本データ
- [x] 元請・協力会社5社・職人20名・現場3つ・名簿2つ・入場教育の記録・現場のルール・過去10日の記録（5章のわざと入れる場面がテストで出ることを確かめる）
## Phase 3 — 画面（全体デザインの承認と、第2段の画像が届いてから）
- [x] 外枠・デモの帯・今日の事務所・職人台帳と詳細・協力会社・現場・名簿をそろえる・作業員名簿（印刷・CSV）・現場のルールと確認テスト・入場教育の記録・職長のスマホ・職人のスマホ・変更の記録・本番での仕組み・スタート・並べて表示
## Phase 4 — 仕上げ
- [ ] 別タブの同期・元に戻す・リセット・レスポンシブ総点検・言わないことの文言検索・公開

# 12. 受入基準

1. 見せ場①〜③が動く
2. 名簿の計算とAIのテストがすべて通る（`npm test`）
3. 職人のスマホで確認テストに合格すると、別のタブの工事担当の名簿と入場教育の記録が、再読み込みなしで変わる（`/split` でも）
4. 確認テストは「この内容で使う」を押すまで職人に届かない。名簿の確定と入場の許可は工事担当が押す。どちらも元に戻せる
5. 320／375／768／1024／1280px で横はみ出し0・文字の切れ・画像なし・リンク切れなし
6. 「言わないこと」が画面の文言に入っていない（「代わりになる」「連携」「施工体制台帳が作れる」「義務を果たせる」「法令対応」「違反」と、既存の安全書類サービス・建設キャリアアップシステムの名前を `grep` で0件）

# 出典

- 建設業法 第24条の8（施工体制台帳及び施工体系図の作成等）、建設業法施行令 第7条の4、建設業法施行規則 第14条の2（施工体制台帳の記載事項等）e-Gov 法令検索 https://laws.e-gov.go.jp/law/324AC0000000100 ・ https://laws.e-gov.go.jp/law/331CO0000000273 ・ https://laws.e-gov.go.jp/law/324M50004000014 （2026-10-21 本文を確認）
- 労働安全衛生法 第30条、労働安全衛生規則 第638条・第642条の3 e-Gov 法令検索 https://laws.e-gov.go.jp/law/347AC0000000057 ・ https://laws.e-gov.go.jp/law/347M50002000032 （2026-10-21 本文を確認）
- 厚生労働省「元方事業者による建設現場安全管理指針のポイント」（指針は平成7年4月21日 労働省労働基準局長通達）https://www.mhlw.go.jp/new-info/kobetu/roudou/gyousei/anzen/dl/040330-3a.pdf （2026-10-21 確認。新規入場者教育の8項目）
- ラッコキーワード（Google・年平均の月間検索数、2026-10-13。台帳の記載）


---

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

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

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

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

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

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