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

**版数** 1.0（DBレス構成のデモ）／ **作成日** 2026-10-20 ／ **発行** ソウゾウ合同会社
**用途** 業種特化アプリの実演デモ ／ 中小製造業（個別受注生産）向け「製番ごとの工程ボード」

---

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

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

- 実装は「11. 実装タスク」の順に進める。フェーズを飛ばさない。
- 仕様に書かれていないことは推測で作らず質問する。質問できない状況では「判断に迷ったときのルール」で決め、`docs/DECISIONS.md` に1行ずつ残す。
- 3章の「作らないもの」は、思いついても作らない。
- 「デモだから」を理由に品質を落とさない。**日付の計算（稼働日・見込み出荷日・遅れの判定）と、現場の一言の読み取りは、テストが通るまで画面を作らない。**
- **町工場の言葉で書く。** 画面の文言は、工場長・生産管理・営業・現場の班長が毎日使っている言葉に合わせる（製番・客先・品名・数量・納期・工程・工程表・着手・完了・仕掛かり・段取り・図面・材料・切断・曲げ・溶接・機械加工・外注・めっき・組立・検査・出荷・不良・手直し・作り直し・特急・割り込み・朝礼・班長・出荷見込み）。「ユーザー」「タスク」「ステータス」「ワークフロー」「ガントチャート」「MRP」「スケジューラ」を画面に出さない。

> **このアプリが選ばれる理由**
> 一品ずつ注文を受けて作る町工場の工程は、事務所のホワイトボード（製番を縦に、工程を横に並べてマグネットを動かす）と、生産管理の担当が持つExcelで回っている。ボードは現場に行かないと見えず、マグネットを動かすのは朝礼のときだけなので、昼に営業から「北斗電装さんの筐体、いまどこ？」と聞かれると、生産管理が現場まで見に行く。特急が入ったとき、どの製番に響くかは工場長の頭の中にしかない。
> NAGARE は、**ホワイトボードの見た目のまま、現場がスマホで「開始」「完了」を押す（または一言話す）と、事務所のボードと営業の画面がその場で変わり、納期が危ない製番だけが上に出る**ようにする。工程の名前と順番は会社のものをそのまま使う。まず工程の見える化だけを作り、負荷・原価・在庫は同じ記録の上に後から足す。
> 現場が進み具合を紙に書いて事務所で打ち直す、営業が生産管理に電話しないと答えられない、納期が危ない製番を工場長が全部の行を見て探す、のどれか1つでもあれば失敗とみなす。

---

## 課題定義（台帳 2026-10-20 時点・定義の状態「確定」）

| 項目 | 内容 |
|---|---|
| 誰に刺すか | 個別受注生産（一品一様・多品種少量）の中小製造業の工場長・生産管理担当（小さな会社では社長）。工程表をホワイトボードとExcelで回している |
| 場面 | 朝礼でホワイトボードの工程表を見るとき／営業や客先から「あの案件、いまどこ？」と聞かれたとき／特急の割り込みが入って計画を組み直すとき |
| 問題（ふわっと） | 「案件がいまどこまで進んでいるか、現場まで見に行かないと分からない」（推測：本人の言葉は未取得） |
| 理想 | どの案件がどの工程で止まっているか、事務所からもすぐ分かる |
| 課題（ギャップ） | 製番ごとの工程の進み具合と納期を1つの画面で共有し、現場はスマホ・タブレットで「開始」「完了」を押すだけ、管理者は納期が危ない製番だけを見ればよい状態にする。最初は工程の見える化だけを作り、負荷・原価・在庫は同じ土台に後から足す |
| 見る前の感情 | 「生産管理システムは高くて大がかり」「うちは一品一様だから、パッケージは合わない」「現場が入力してくれない」 |
| 見た後の感情 | 「ホワイトボードの感覚のまま使える」「『いまどこ？』にその場で答えられる」「まず工程の見える化からなら始められる」 |
| 見せ場（必ず見せる） | ①ホワイトボードのような工程ボード（製番×工程）。遅れている製番が色で分かる ②現場のスマホで「開始」「完了」を押すと、すぐに事務所と営業の画面に出る ③納期が危ない製番だけが一覧の上に出る。負荷・原価・在庫は同じ土台に後から足せることを画面の案内で示す ④AI：現場の一言（「製番1024、曲げ完了、不良2」）を製番・工程・数・不良に振り分けて下書き。確定するのは作業者 |
| 既製品で足りる部分／作る価値 | 受発注・在庫・資材の所要量計算・原価計算まで最初からそろえたい会社には、汎用の生産管理パッケージが向く。個別受注生産は会社ごとに工程の名前と順番が違い、パッケージに合わせると現場の入力が続かないことがある（推測）。作る価値は ①自社の工程名と順番のまま ②ホワイトボードの感覚で現場が押すだけ ③小さく始めて、負荷・原価・在庫を同じ土台に足していける |
| 言わないこと | 「生産管理システムを丸ごと置き換えられる」「最初からMRP・原価計算まで」／特定のパッケージを名指しで否定する言い方／「生産性◯%向上」「リードタイム◯%短縮」など成果の数字の約束／設備・IoTとの連携ができる（デモの範囲外） |

---

# 1. プロジェクト概要

## 背景（出典は末尾）

- 中小企業がDXに取り組むときの問題は、デジタル化の進み具合にかかわらず「費用の負担が大きい」「DXを推進する人材が足りない」が多い（中小企業庁「2025年版 中小企業白書」第1部第1章第5節・第1-1-45図）。大きな仕組みを一度に入れるより、毎日使う1つの画面から始めるほうが合う。
- 生産管理の既製品は、基本料に業務ごとの追加料金や利用者ごとの料金が足される形が多い（例：基本パック月35,000円＋工程進捗の業務モジュール月15,000円・10IDまで・年間契約／月77,000円〜＋利用者ごとの料金。いずれも各社の公式料金ページ・2026-10-06 確認）。料金を公開していない製品も多い。**画面では製品名を出さない。比べて否定しない。**
- 検索：工程管理 1,600・工程管理システム 720・工程管理表 720・工程管理 アプリ 480・納期管理 170・工場 見える化 170・工程管理 エクセル 170・製番管理 70・工程管理 ホワイトボード 70（12か月で+82%）・個別受注生産 50（ラッコキーワード 2026-10-06・Google・年平均）。「ホワイトボード」「エクセル」で探す人がいる＝今の道具の延長を求めている。
- 公式LINEの1問アンケート（2026-10-03〜06）で、回答29人のうち製造が9人で最多。うち6人が「会社の業務で使うものを、自分たちで作りたい」。

## プロダクト定義

| 項目 | 内容 |
|---|---|
| 名前 | NAGARE（ながれ）※仮称 |
| 一言 | ホワイトボードの工程表が、現場の「開始」「完了」と一言でそのまま動く |
| 提供形態 | レスポンシブWebアプリ。**フロントエンド完結（サーバー側の保存なし）** |
| 見本の会社 | 「株式会社 早瀬精工」（架空。作業手順書のデモ KANAME と同じ会社）。精密部品の切削加工に加えて、第2工場の**装置課**で、食品・電機の工場向けの省力化装置のフレーム・制御盤の筐体・検査治具を一品ずつ受注して作る。従業員約40名、装置課は14名 |
| 見本の場面 | **今日（火曜でなくても「今日」）の朝 8:10、朝礼の前**。工場長が工程ボードを見ている。8:40 に板金班の河合さんがスマホで「製番1024、曲げ完了、不良2」と話す。10:00 に営業の藤井さんが客先から「いまどこ？」と電話を受ける。午後に特急が1件入る |
| 主戦場 | 事務所のPC（工場長・生産管理）／現場のスマホ・タブレット（班長・作業者）／営業のスマホ |

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

1. 開いた瞬間に、ホワイトボードのような工程ボード（製番14行×工程10列）が見え、遅れている工程が赤、着手が遅れている工程が黄色で分かる。右に「納期が危ない製番」が3件だけ並び、それぞれに理由が1文で添えてある
2. 見る人を「現場（板金班 河合さん）」に切り替えると、スマホに自分の班の今日の作業だけが出る。「開始」「完了」を押すと、事務所のボードのその工程のマグネットがその場で動き、営業の画面の「いまの工程」も変わる（同じブラウザの別タブ・別ウィンドウでも、`/split` の並べて表示でも）
3. 現場のスマホの「話して入力」で「製番1024、曲げ完了、不良2」と話す（または見本を押す）と、AIが「製番 1024・工程 曲げ・完了・良品 4／6・不良 2」に振り分けた下書きを出し、読み取った言葉に印を付ける。「確定」を押すまでボードは変わらない。良品が数量に足りないので「2台分の作り直しが要ります（工場長に知らせます）」と出る
4. 営業の画面で客先名か製番を入れると、いまの工程・出荷見込み日・納期との差が1枚で出る。「客先への返事の下書き」を押すと、そのまま読める文が出る（送らない。コピーするだけ）
5. 「特急が入った（デモ）」を押すと、製番1031（特急）を入れる案が最大3つ出て、案ごとにどの製番の出荷見込みが何日ずれるかが分かる。工場長が選ぶまでボードは変わらない。選んだあとも元に戻せる
6. 「あとから足せるもの」で、いまの開始・完了の記録から出せる工程ごとの仕事の山（負荷）を、実際の見本データから描いて見せる。原価・在庫は「同じ製番に足す項目」を見せるだけで、作り込まない
7. リセットできる

---

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

- すべてブラウザ内で動く。保存は localStorage（見本から変えた分だけ）。見本は「今日」を基準に毎回同じものを組み立てる（日付は今日からの稼働日数で持つ）。
- **画面どうしの同期**：別タブ・別ウィンドウの変更は `storage` イベントと `BroadcastChannel('nagare')` で受けて、その場で描き直す。`/split` は事務所のボードと現場のスマホと営業のスマホを1画面に並べる（見せ場②を1画面で見せるため）。
- **AIは外部につながない**（2026-10-08 に決めたデモの方針：費用0円・毎回同じ動き・悪用されない）。一言の読み取り・返事の下書き・特急の案・朝礼のまとめは `src/lib/ai/` の純粋な関数で、同じ入力なら同じ結果を返す。本番ではこの部分だけを Claude に差し替える（`Brain` の型を守る）。
- 本番で外部のAIを呼ぶときの決まり（デモでは画面の「本番での仕組み」に書くだけ）：①AIに送るのは現場の一言と、製番・工程の名前の一覧だけ。客先名・金額は送らない ②1日の呼び出し回数（200回）と月の予算（3,000円）に上限を持たせ、超えたら手で選ぶ入力に戻す。画面の右上に「AIの上限 今日 12/200回・今月 ¥0/¥3,000（デモは0円）」を出す ③確定は必ず人が押す。
- 日付は「今日からの稼働日の番号」で持つ。休みは土日と祝日（`calc/calendar.ts` に今年と来年の祝日の表を持つ）と会社の休み（見本では無し）。
- 画面はストアを直接触らず `src/lib/repo/` の関数とフックを使う。

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

| 項目 | 決まり |
|---|---|
| 工程 | 会社の工程の一覧（見本：設計・材料手配・切断・曲げ・溶接・機械加工・外注・組立・検査・出荷の10）。**製番ごとに使う工程と順番を持つ**（使わない工程はボードで斜線）。名前と並びは「設定」で変えられる（デモでは名前の変更だけ） |
| 標準の日数 | 工程ごとに、製番の数量と品物の種類から決めた稼働日数を見本で持つ（例：曲げ 1日・溶接 2日・外注 4日）。外注は社外の日数なので、同時にいくつでも進む |
| 同時に進む数 | 社内の工程は、1つの工程で同時に進む製番は1件（設計と検査は2件・材料手配・外注・出荷は何件でも）。見本の予定は `calc/schedule.ts` の「順番に詰めて並べる」関数で作る |
| 予定 | 製番の各工程に予定の開始日・完了日。最初の予定は schedule で作り、見本の中で「実際」がずれている |
| 工程のマグネットの色 | 済（完了・灰）／作業中（主色）／**遅れ**（予定の完了日を過ぎて完了していない・赤）／**着手遅れ**（予定の開始日を過ぎて始まっていない・黄）／これから（白）／使わない（斜線）。遅れと着手遅れには、何日過ぎたかの数字を添える |
| 出荷見込み日 | 残りの工程を、今日（作業中の工程は残りの日数、最低1日）から順に schedule で詰めて、出荷が終わる日。他の製番との取り合いも含めて数える |
| 納期が危ない | 出荷見込み日が納期より後 ＝「間に合わない見込み」（赤）／納期までの余裕が0〜1稼働日 ＝「余裕なし」（黄）／それ以外は順調。一覧には赤と黄だけを、余裕が少ない順に出す。**理由を1文で必ず添える**（例「外注のめっきが予定より2日遅れて戻っていないため」） |
| 不良 | 完了のときに良品と不良の数を入れる。良品が数量に足りないときは「作り直しが要る」の印を製番に付け、工場長の「確認待ち」に出す（作り直しの工程を足すかは工場長が決める） |
| 特急の割り込み | 特急の製番を、ある工程の順番のどこに入れるかを変えて schedule を数え直す。割り込みで出荷見込みがずれる製番と日数を出す |

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

| 項目 | 決まり |
|---|---|
| 一言の読み取り（`ai/voice.ts`） | 製番（「製番」「せいばん」の後ろの3〜4けた、または「1024番」）・工程（工程の名前と言い換えの辞書：曲げ＝ベンダー・折り／溶接＝付け・ようせつ／機械加工＝旋盤・マシニング・フライス／外注＝めっき・塗装・焼き入れの戻り／検査＝検品 など）・動き（開始＝始め・入った・取りかかった／完了＝終わり・上がった・済み／中断＝止めた・待ち）・数（「6台」「6個」「全部」）・不良（「不良2」「NG2」「2個だめ」「手直し1」）・それ以外の言葉はメモに入れる。漢数字（二・十二）と全角数字も読む。**読み取れなかった項目は空けて、作業者に選んでもらう（止めない）**。読み取ったもとの言葉にそれぞれ印を付ける |
| 確かめ | 製番が無い／その製番がその工程を使わない／前の工程が終わっていない、はその場で文で知らせる（「1024 は溶接の前に曲げが済んでいません。曲げも完了にしますか」）。確定は作業者 |
| 返事の下書き（`ai/reply.ts`） | 客先・品名・いまの工程・残りの工程・出荷見込み日・納期との差から、営業がそのまま読める3〜4文を作る。遅れているときは理由と、次にいつ知らせるかを入れる。「お約束します」「必ず」は使わない |
| 特急の案（`ai/rush.ts`） | 特急を優先の順のどこに入れるかを変えて数え直し、案を最大3つ：①いちばん後ろ（ほかに響かない）②特急が納期に間に合い、ほかの製番も納期を過ぎない、一番後ろの位置（響く製番が少ない）③いちばん先（特急がいちばん早い）。どの案も「入れると、どの製番の出荷見込みが何日ずれるか」と、ずれても納期に間に合うかを書く。効果の無い案・納期を割る製番が出る案は「おすすめしない」と書いて出す（隠さない）。選ぶのは工場長 |
| 朝礼のまとめ（`ai/brief.ts`） | 今日の朝の時点で、納期が危ない製番ごとに「何をするか」（最大2行）と、今日始まる工程の数を、短い3行にまとめる（朝礼で読み上げる用。危ない製番が少なければ昨日の不良を足す） |
| 決めるのは人 | AIの結果は「下書き」と「確認待ち」に出すだけ。確定・選ぶ・作り直しを足す、は人が押す。押したものは「変更の記録」に残り、元に戻せる |

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

1. 迷ったら、朝礼前の事務所でホワイトボードの前に立つ工場長と、油の付いた手袋のままスマホを持つ板金班の作業者を思い浮かべる
2. 現場の画面は、手袋をしたまま押せる大きさと、押す回数（「開始」「完了」で1回ずつ。数は完了のときだけ）にする
3. 色には必ず文と数字を添える（「赤」だけで終わらせず「溶接 2日遅れ」）

---

# 3. スコープ

## 作るもの

| ID | 機能 |
|---|---|
| F-01 | 工程ボード（事務所）：製番を縦に、工程を横に。マグネットの色・遅れの日数・作業中の人。行を押すと製番の詳細。並べ替え（納期の近い順・製番順・客先順）と絞り込み（班・客先・危ないものだけ）。**絞り込みで隠れた行の数と「すべて表示」を必ず出す** |
| F-02 | 納期が危ない製番：ボードの右に、赤と黄だけを余裕の少ない順に。理由の1文・出荷見込み日・納期。朝礼のまとめ（3行）もここ |
| F-03 | 製番の詳細：客先・品名・数量・納期・図面の写真（見本）・工程ごとの予定と実際（開始・完了・誰が・良品と不良）・メモ・変更の記録 |
| F-04 | 現場のスマホ・タブレット：自分の班の今日の作業（作業中・今日始める予定・遅れている）を大きなカードで。「開始」「完了」（完了のときに良品・不良）・「止まっている（材料待ち・図面待ち・機械の不調）」。前の工程の完了を待っているものは押せない理由を出す |
| F-05 | 話して入力：音声入力（ブラウザの音声認識・日本語。使えないブラウザでは理由を出し、文字で入れられる）→ AIの下書き → 確定。見本の一言を4つ置く（完了＋不良／開始／止まっている／製番の言い間違い） |
| F-06 | 営業の「いまどこ？」：客先名・製番・品名で探す → いまの工程・残りの工程・出荷見込み日・納期との差 → 返事の下書き（コピー）。営業は見るだけ（工程は動かせない） |
| F-07 | 確認待ち（工場長）：作り直しが要る・止まっている・特急の案。押すと決める画面へ |
| F-08 | 特急の割り込み：「特急が入った（デモ）」→ 製番1031 の内容 → AIの案（最大3）→ 選ぶ → ボードと出荷見込みが変わる。元に戻せる |
| F-09 | あとから足せるもの：負荷（工程ごとの仕事の山を、いまの予定から描く）・原価（製番ごとの作業時間と材料を足すと出せる、の説明と項目）・在庫（材料と購入品の引き当て、の説明）。「同じ製番と工程の記録の上に足す」を図で |
| F-10 | 並べて表示 `/split`：事務所のボード・現場のスマホ・営業のスマホを1画面に |
| F-11 | 設定：工程の名前と並び・班・人・休みの日（デモでは名前の変更だけ保存） |
| F-12 | 本番での仕組み：ログインと役割・現場の端末（共用タブレット）・外部AIに送る範囲と上限・Excelの工程表の取り込み・バーコード（製番の札）の案 |
| F-13 | スタート・リセット・変更の記録・CSV（工程の実績） |

## 作らないもの

- 受注・見積・請求・発注（購買）・在庫の引き当て・資材の所要量計算・原価計算（F-09 の案内だけ）
- 設備・機械・IoT・バーコードリーダーとのつながり（「本番での仕組み」に書くだけ）
- 時間単位の細かい計画（日の単位まで）・自動で最適な計画を決める仕組み（特急の案は「案」）
- 図面の管理（見本の写真を見せるだけ）・品質記録の帳票
- 実際の電話・メール・メッセージの送信

---

# 4. 画面

| パス | 画面 | 主な人 |
|---|---|---|
| `/` | スタート（見せ場4つと、事務所／現場／営業の入口・並べて表示） | — |
| `/o` | 工程ボード＋納期が危ない製番＋確認待ち | 工場長・生産管理 |
| `/o/job/:no` | 製番の詳細 | 工場長・生産管理 |
| `/o/rush` | 特急の割り込み | 工場長 |
| `/o/next` | あとから足せるもの（負荷・原価・在庫） | 工場長 |
| `/o/log` | 変更の記録 | 工場長・生産管理 |
| `/o/settings` `/o/how` | 設定・本番での仕組み | 工場長 |
| `/f` | 今日の作業（スマホ・タブレット） | 班長・作業者 |
| `/f/talk` | 話して入力 | 班長・作業者 |
| `/s` `/s/job/:no` | いまどこ？（スマホ） | 営業 |
| `/split` | 並べて表示 | — |

画面上部に、デモの帯（黒地）：見る人の切り替え（工場長 早瀬さん／生産管理 高木さん／板金班 河合さん／機械加工 佐々木さん／営業 藤井さん）、「特急が入った（デモ）」、リセット、「これはデモです。会社・人・数字は架空です。AIは外部につながず、このブラウザの中だけで動きます」。

# 5. 見本データ

- **会社**：株式会社 早瀬精工（架空）第2工場 装置課。班：設計（2名）・板金班（切断・曲げ・溶接 4名）・機械加工（旋盤・マシニング 3名。KANAME の旋盤班・マシニング班の人）・組立班（2名）・検査・出荷（2名）。
- **人**（架空・KANAME と重なる人はそのまま）：工場長 早瀬 正人（KANAME では品質保証課。このデモでは工場長として兼ねる）／生産管理 高木 美咲／営業 藤井 翔／設計 堀 和樹・小松 由香／板金班 班長 大谷 剛・河合 雄一（曲げ）・坂本 樹（溶接）・グエン・ヴァン・ナム（切断）／機械加工 石原 健一（班長）・佐々木 蓮・小田 浩二／組立班 村上 典子（班長）・遠藤 美穂／検査・出荷 原 智子（班長）・河野 匠。
- **客先**（架空）：北斗電装・東和食品機械・みなと化成・さくら精機・丸栄パッケージ・青葉ロボティクス。
- **製番14件**（1018〜1031。1030 は出荷済み、1031 は午後の特急で、最初はボードに無い）。品名の例：搬送コンベヤ用フレーム・制御盤の筐体・検査治具・カバー一式・架台・シュート。数量1〜8。工程は製番ごとに4〜9（設計が無い＝客先の図面どおり、外注が無い、など）。
- わざと入れる場面（**これが無いと見せ場が出ない**）：
  - **1024 北斗電装 制御盤の筐体 6台**：曲げが作業中（河合さん）。8:40 の一言で完了・不良2 → 良品4／6 → 作り直しの確認待ち
  - **1018 東和食品機械 搬送コンベヤ用フレーム 2台**：検査で手直しが出て溶接に戻った（溶接の升目に「手直し」の札）。出荷見込みが納期を1日過ぎる（赤「間に合わない見込み」）
  - **1021 みなと化成 検査治具 5台**：外注のめっきが予定より2日遅れて戻っていない（外注のマグネットが赤「2日遅れ」）。余裕0日（黄）
  - **1026 さくら精機 カバー一式**：材料手配の予定の開始日を1日過ぎて始まっていない（黄「着手遅れ 1日」）。納期に余裕があるので危ない一覧には出ない（色と一覧の違いを見せるため）
  - **1031（特急）青葉ロボティクス 架台 2台・納期 今日から8稼働日**：「特急が入った」で現れる。案①いちばん後ろ＝特急が納期を過ぎる（おすすめしない）／案②納期に間に合う一番後ろの位置（1023 の前）＝1023・1027・1029 が2日ずれるが、どれも納期に間に合う（おすすめ）／案③いちばん先
  - 残りは順調（灰・主色・白が並ぶ）。1030 は昨日出荷済み
- 変更の記録：過去5稼働日ぶんの開始・完了（負荷の山を描くため）。
- AIの上限の数字：今日 12/200回・今月 ¥0/¥3,000（デモは0円）。

# 6〜8. 見た目

- **デザイン画像（Codex に依頼中）を正とする。** 届いたら、画像と同じ大きさで自分の画面を撮って横に並べ、1px の差まで直す。
- 世界観は「事務所のホワイトボードと、マグネット」。ただし手書き風・付箋・紙の質感の飾りはしない。白い面に、薄い罫線の升目、角の丸いマグネット（工程の色）。
- 色は落ち着いた主色1つ＋遅れの赤＋着手遅れの黄。色には必ず文字と数字を添える。
- 事務所のPCは、左にメニュー（工程ボード・確認待ち・特急・あとから足せるもの・変更の記録・設定）、真ん中に工程ボード、右に「納期が危ない製番」と朝礼のまとめと AIの上限。
- 現場のスマホは、大きな文字・大きなボタン（高さ 56px 以上）。カード1枚に1つの作業。下に「今日の作業・話して入力・記録」のタブ。
- 営業のスマホは、探す欄を一番上に。答えの1枚（いまの工程・出荷見込み・納期との差）を大きく。
- 写真を画面全体に使う（スタートの工場の写真・品物の写真のサムネイル・人の顔の丸・空の状態）。白地にカードと文字だけにしない。
- 日本語は Noto Sans JP、数字は等幅の数字。

# 9. 技術

Vite 6 + React 19 + React Router 7 + Tailwind v4 + Zustand（persist）。音声入力は Web Speech API。Cloudflare Workers の静的アセットで配信（`nagare.souzohnic.workers.dev`）。写真は `scripts/images/`（manifest → import → `src/lib/images.gen.ts`）。

# 10. 非機能

- 320px〜2560px で横にはみ出さない（工程ボードは横に送れる枠の中だけ。`data-hscroll`）
- 初期の JS は 200KB（gzip）以下
- 現場の画面は、ボタンの高さ 56px 以上・文字 16px 以上

# 11. 実装タスク

## Phase 1 — 計算とAI
- [ ] calendar.ts（稼働日・祝日）・schedule.ts（順番に詰めて並べる）・status.ts（マグネットの色・遅れの日数）・forecast.ts（出荷見込み・危ない判定と理由）
- [ ] ai/voice.ts（一言の読み取り）・ai/reply.ts・ai/rush.ts・ai/brief.ts
- [ ] テスト：祝日と土日をまたぐ稼働日、同じ工程の取り合い、外注は同時に進む、遅れと着手遅れの境目（予定日の当日はまだ遅れではない）、出荷見込みと納期の差（−1・0・1・2日）、良品が数量に足りない、一言の読み取り（見本4つ＋漢数字・全角・言い換え・製番なし・工程を使わない製番・前の工程が済んでいない）、特急の3案（ずれる製番と日数・おすすめしない案）
## Phase 2 — 見本データ
- [ ] 会社・班・人・客先・製番14件・予定と実際・過去5稼働日の記録（5章のわざと入れる場面がテストで出ることを確かめる）
## Phase 3 — 画面
- [ ] 外枠・デモの帯・工程ボード・納期が危ない製番・製番の詳細・現場のスマホ・話して入力・営業・確認待ち・特急・あとから足せるもの・変更の記録・設定・本番での仕組み・スタート・並べて表示
## Phase 4 — 仕上げ
- [ ] 別タブの同期・元に戻す・CSV・リセット・レスポンシブ総点検・言わないことの文言検索・公開

# 12. 受入基準

1. 見せ場①〜④が動く
2. 計算とAIのテストがすべて通る（`npm test`）
3. 現場のスマホで「完了」を押すと、別のタブの事務所のボードと営業の画面が、再読み込みなしで変わる（`/split` でも）
4. 一言の下書きは「確定」を押すまでボードを変えない。特急の案は選ぶまでボードを変えない。どちらも元に戻せる
5. 320／375／768／1024／1280px で横はみ出し0・文字の切れ・画像なし・リンク切れなし
6. 「言わないこと」が画面の文言に入っていない（「丸ごと置き換え」「MRP」「原価計算まで」「生産性」「%向上」「%短縮」「IoT」「設備と連携」を `grep` で0件。F-09 の原価・在庫は「後から足せる」の言い方だけ）

# 出典

- 中小企業庁「2025年版 中小企業白書」第1部第1章第5節 デジタル化・DX（第1-1-45図：DXに向けた取組を進めるに当たっての問題点）https://www.chusho.meti.go.jp/pamflet/hakusyo/2025/chusho/b1_1_5.html （2026-10-20 確認）
- 生産管理の既製品の公式料金ページ（2026-10-06 確認。台帳の記載。画面には製品名を出さない）
- ラッコキーワード（Google・年平均の月間検索数、2026-10-06）
- 公式LINEの1問アンケート（2026-10-03〜06）


---

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

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

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

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

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

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