YieldTracker - 歩留まり・不良率リアルタイム集計＆改善提案システム

## 1. アプリの目的・ターゲットユーザー
製造ラインで発生する不良品・廃棄品の数量を工程・製品・日時単位で手軽に入力し、歩留まり率と不良率をリアルタイムに集計・可視化するWebアプリ。
ターゲットは中小製造業（食品・樹脂・金属・印刷・縫製など）の品質担当者・製造リーダー・工場長。
Excelでバラバラに管理していた不良記録を一元化し、問題工程の早期発見と改善アクションの定着を支援する。

---

## 2. 主要機能

- **不良実績入力フォーム**
製品マスタ・工程マスタから選択し、投入数・良品数（または不良数）・不良原因カテゴリ（寸法NG／外観NG／異物混入／機械トラブル／その他）・発生時刻・担当者名を記録。スマホから1分以内に入力できるシンプルなUI。

- **歩留まり・不良率ダッシュボード**
日次・週次・月次の歩留まり率（良品数÷投入数×100）と不良率を折れ線グラフ・棒グラフで表示。工程別・製品別・原因カテゴリ別の内訳をドーナツグラフで可視化。目標歩留まり率をラインで重ね表示し、達成/未達を一目で把握。

- **パレート分析（不良原因ランキング）**
原因カテゴリ別の累積不良数をパレート図（棒グラフ＋累積折れ線）で自動生成。上位3原因を自動ハイライトし、「重点対策候補」としてカード表示。

- **改善提案ヒントカード**
不良原因カテゴリ×工程タイプの組み合わせに対応した改善ヒント（内製ナレッジDB：約60パターン）を自動表示。例：「外観NG×成形工程 → 金型クリーニング頻度の見直し、成形温度ログの確認を推奨」。

- **対策登録・進捗トラッキング**
パレート上位の原因に対して対策内容・担当者・期限を登録し、「未着手／対応中／効果確認中／完了」の4ステータスで管理。完了後は前後の不良率比較グラフを自動生成して効果を可視化。

- **CSVエクスポート・印刷レポート**
日次・月次の不良実績データをCSVダウンロード。A4縦レイアウトの月次品質レポート（ダッシュボード＋パレート＋対策一覧）を印刷用CSSで出力。

---

## 3. 画面構成

### 共通ヘッダー
- ロゴ「YieldTracker」、工場名表示、ナビゲーション（ダッシュボード／実績入力／対策管理／マスタ設定）

### ① ダッシュボード（トップ画面）
- KPIカード3枚（本日の歩留まり率／今月累計不良数／対策進行中件数）
- 歩留まり推移グラフ（直近30日、目標ライン付き）
- 工程別不良率ヒートマップ（工程×曜日）
- 上位不良原因パレート図
- 要注意工程アラートバナー（前週比不良率+5%以上を赤表示）

### ② 不良実績入力
- 製品選択（プルダウン）→ 工程選択（プルダウン）→ 投入数・不良数入力（数値）→ 原因カテゴリ選択（タップ可能な大きめボタン）→ 担当者名・メモ → 登録ボタン
- 直近5件の入力履歴をページ下部に表示（修正・削除ボタン付き）

### ③ 対策管理
- 対策一覧テーブル（原因・対策内容・担当者・期限・ステータス・効果グラフボタン）
- 新規対策登録モーダル
- ステータスフィルター（全件／未着手／対応中／完了）

### ④ マスタ設定
- 製品マスタ（製品名・目標歩留まり率の登録・編集・削除）
- 工程マスタ（工程名・工程タイプ選択）
- 工場名・担当者名プリセット設定

---

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

```sql
-- 製品マスタ
products(id, name, target_yield_rate, created_at)

-- 工程マスタ
processes(id, name, process_type, created_at)
-- process_type: 成形／加工／組立／検査／梱包 など

-- 不良実績
defect_records(
id,
product_id,
process_id,
input_qty, -- 投入数
defect_qty, -- 不良数
defect_category, -- ENUM(寸法NG, 外観NG, 異物, 機械, その他)
operator_name,
memo,
recorded_at -- 発生日時
)

-- 対策管理
countermeasures(
id,
defect_category,
process_id,
content, -- 対策内容
assigned_to,
due_date,
status, -- ENUM(未着手, 対応中, 効果確認中, 完了)
created_at,
completed_at
)
```

改善ヒントは外部DBではなくPHP配列の内製ナレッジとして実装（defect_category × process_type の組み合わせキー）。

---

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

- **カラーパレット**：ネイビー（#1A2E44）をベースに、アクセントカラーはグリーン（歩留まり良好）／アンバー（要注意）／レッド（アラート）の信号機3色。現場での視認性を最優先。
- **フォント**：Noto Sans JP、見出しは太め（700）、数値は大きくLCDライクなモノスペースフォント。
- **レイアウト**：PC時は左サイドバー＋右コンテンツエリア。スマホ時はハンバーガーメニュー＋シングルカラムに切替。入力フォームのボタンは大きめ（min-height 48px）でタッチ対応。
- **グラフ**：Chart.js（CDN）を使用。ダークテーマのグリッドラインで工場現場のモニター表示にも映えるデザイン。
- **全体印象**：華美な装飾を排除した業務ライクな清潔感。現場のタブレット・スマホでも素早く操作できることを最優先とする。