LotTrace - ロット追跡・トレーサビリティ管理システム

## 1. アプリの目的・ターゲットユーザー
食品・製造・医療機器・化粧品など「原材料→製造→出荷→納品先」の流れを追跡する必要がある中小製造業向けのトレーサビリティ管理システム。異物混入・品質問題発生時に「どのロットが、どこへ出荷されたか」「そのロットにはどの原材料が使われたか」を即座に特定し、リコール・回収対応をスムーズに行うことを目的とする。食品衛生法・ISO対応の現場帳票としても活用可能。

ターゲット：食品メーカー、製造業の品質管理担当者・工場長・経営者（従業員5〜100名規模）

---

## 2. 主要機能

- **原材料ロット登録**：仕入れ先、品目名、ロット番号、入荷日、数量、検査結果（合格/保留/不合格）を登録。QRコードラベル生成（印刷用）。
- **製造ロット登録**：製品名、製造ロット番号、製造日、使用した原材料ロット（複数紐付け可）、製造数量、担当者、工程メモを登録。親子ロットの紐付けで「どの原材料が入っているか」を即追跡。
- **出荷・納品先登録**：得意先名、出荷日、製造ロット、出荷数量、納品書番号を登録。1ロットを複数得意先へ分割出荷にも対応。
- **トレース検索（川上・川下）**：ロット番号を入力すると「川上（どの原材料か）」と「川下（どこへ出荷したか）」を即座に一覧表示。異物・品質問題発生時の影響範囲を一画面で確認。
- **アラート管理**：使用期限が近い原材料ロット、長期未使用在庫、出荷後の保管日数超過をハイライト表示。
- **帳票出力**：トレース結果一覧・製造記録・出荷記録をA4印刷レイアウトで出力。CSVエクスポートも対応。

---

## 3. 画面構成

### ページ構成
1. **ダッシュボード（トップ）**
- 本日の製造ロット数・出荷件数・アラート件数をカード表示
- 期限切れ・在庫切れ原材料アラート一覧
- 最近登録されたロット（原材料・製品）タイムライン

2. **原材料ロット管理ページ**
- 一覧テーブル（ロット番号/品目/仕入先/入荷日/残数/ステータス）
- 新規登録フォーム（モーダル）
- QRコード表示ボタン（JSで生成、印刷用ポップアップ）

3. **製造ロット管理ページ**
- 一覧テーブル（製造ロット/製品名/製造日/製造数/使用原材料ロット数）
- 新規登録フォーム：使用原材料ロットをチェックボックスで複数選択
- 詳細ページ：使用原材料ロットの一覧（紐付き表示）

4. **出荷管理ページ**
- 一覧テーブル（出荷日/得意先/製造ロット/数量/ステータス）
- 新規出荷登録フォーム

5. **トレース検索ページ（最重要）**
- ロット番号入力フィールド（原材料ロット番号 or 製造ロット番号）
- 検索結果：ツリー形式またはテーブル形式で川上・川下を表示
- 川上：使用された原材料ロット一覧（仕入先・入荷日付き）
- 川下：出荷先得意先一覧（出荷日・数量付き）
- 「問題発生時の影響範囲」として未回収の出荷先数を赤字でハイライト
- 帳票印刷ボタン

6. **マスタ管理ページ**
- 得意先マスタ（得意先名・担当者・連絡先）
- 仕入先マスタ（仕入先名・品目・担当者・連絡先）
- 原材料品目マスタ（品目名・単位・使用期限日数）
- 製品マスタ（製品名・カテゴリ）

### UI要素
- スマホ対応レスポンシブ（現場タブレット・スマホからの入力を想定）
- ステータスバッジ（合格：緑 / 保留：黄 / 不合格：赤 / 回収済：灰）
- モーダルフォームによるページ遷移なし入力
- 検索バー（ロット番号・品目名・得意先名で絞り込み）

---

## 4. データ構造（DBテーブル概要）

```sql
-- 仕入先マスタ
suppliers: id, name, contact_person, phone, email, created_at

-- 得意先マスタ
customers: id, name, contact_person, phone, email, created_at

-- 原材料品目マスタ
material_items: id, name, unit, shelf_life_days, created_at

-- 製品マスタ
products: id, name, category, unit, created_at

-- 原材料ロット
material_lots: id, lot_number(unique), material_item_id, supplier_id,
received_date, quantity, remaining_quantity, expiry_date,
status(enum: ok/hold/ng), inspection_note, created_at

-- 製造ロット
production_lots: id, lot_number(unique), product_id,
manufactured_date, quantity, remaining_quantity,
operator_name, note, created_at

-- 製造ロット×原材料ロット（多対多）
production_material_links: id, production_lot_id, material_lot_id,
used_quantity

-- 出荷記録
shipments: id, production_lot_id, customer_id,
shipped_date, quantity, delivery_note_number,
status(enum: shipped/delivered/recalled), note, created_at
```

---

## 5. デザインの方向性

- **テーマカラー**：ネイビー（#1a3a5c）＋ライトグレー（#f4f6f8）＋アクセントにオレンジ（#e8640c）
- **フォント**：Noto Sans JP（日本語対応・読みやすさ優先）
- **レイアウト**：左サイドバーナビ（PC） / ハンバーガーメニュー（スマホ）
- **雰囲気**：工場・品質管理現場で使われるシステムらしい「清潔感・信頼感」重視。過剰な装飾は避け、表・ステータスバッジ・アイコンで視認性を高める。
- **トレース結果画面**：影響範囲の深刻度（出荷先数・未回収数）を視覚的に強調するため、件数をカード形式で大きく表示し、詳細一覧はテーブルで展開する2段構成にする。
- **QRコード**：`qrcode.js`（CDN）を使いサーバー不要で生成。