SupplierHub - 仕入先・外注先評価＆取引管理システム

## 1. アプリの目的・ターゲットユーザー
中小製造業・小売業・建設業などが複数の仕入先・外注先を一元管理し、納期遵守率・品質・価格・対応力の4軸で定期的に評価・スコアリングできるWebアプリ。「仕入先ごとの実績が担当者の頭の中にしかない」「評価基準がなく感覚で発注先を決めている」課題を解消する。ターゲット：製造業の購買・調達担当者、工務店・建設会社の資材担当、バイヤー職。

---

## 2. 主要機能
- **仕入先台帳管理**：会社名・担当者・連絡先・品目カテゴリ・契約区分（単発/継続）・取引開始日・銀行口座メモ・添付ファイルURLを登録・編集・削除
- **取引実績記録**：発注日・納期（予定/実績）・発注金額・品目・数量・納品結果（正常/遅延/不良）をCSV一括インポートまたは手入力で蓄積
- **4軸スコアリング**：過去実績から「納期遵守率・不良率・価格競争力・対応速度」を自動集計し、各軸0〜100点＋総合ランクをABC3段階で算出。手動での評価コメント追記も可
- **比較・ランキングダッシュボード**：全仕入先のスコアをバーチャートと一覧テーブルで比較。同じ品目カテゴリ内のランキング表示、直近3か月トレンド折れ線グラフ付き
- **アラート機能**：連続遅延3回以上・不良率10%超・半年間取引ゼロの仕入先を自動フラグ表示。管理画面トップに要注意サプライヤーカードを表示
- **評価レポート出力**：仕入先ごとの評価サマリーをA4印刷レイアウトで出力（スコア・実績件数・コメント・推奨判定を含む）

---

## 3. 画面構成

### ① ダッシュボード（トップ）
- 登録仕入先数・今月の取引件数・遅延率・要注意フラグ数のKPIカード（4枚）
- 総合スコアTOP5仕入先バーチャート
- 要注意サプライヤーアラートリスト（赤・黄バッジ付き）

### ② 仕入先一覧・台帳
- 検索バー（会社名・カテゴリ・ランク）＋フィルタードロップダウン
- カード型一覧（会社名・カテゴリ・総合スコア・ランクバッジ・最終取引日）
- 新規登録ボタン → モーダルフォーム（基本情報入力）

### ③ 仕入先詳細ページ
- 基本情報エリア（編集ボタン付き）
- スコアメーター：4軸レーダーチャート（Chart.js）＋数値テーブル
- 取引実績タイムライン：日付順リスト、遅延・不良は赤ハイライト
- 評価コメント入力欄（自由記述、履歴表示）
- 評価レポート印刷ボタン

### ④ 取引実績入力ページ
- 仕入先選択プルダウン → 品目・発注金額・発注日・納期予定・納期実績・結果（正常/遅延/不良）を入力
- CSVインポートモーダル（フォーマットサンプルDL付き）

### ⑤ 比較ページ
- カテゴリ別フィルター付きの全仕入先スコア比較テーブル（列ソート可）
- レーダーチャート最大3社重ね表示（チェックボックスで選択）

---

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

```sql
-- 仕入先台帳
suppliers(
id INT PK AUTO_INCREMENT,
name VARCHAR(100), -- 会社名
category VARCHAR(50), -- 品目カテゴリ
contact_name VARCHAR(50), -- 担当者名
phone VARCHAR(20),
email VARCHAR(100),
contract_type ENUM('spot','continuous'),
started_at DATE,
memo TEXT,
created_at TIMESTAMP
)

-- 取引実績
transactions(
id INT PK AUTO_INCREMENT,
supplier_id INT FK,
item_name VARCHAR(100), -- 品目名
amount DECIMAL(12,0), -- 発注金額
ordered_at DATE,
due_at DATE, -- 納期予定
delivered_at DATE, -- 納期実績（NULL=未納）
result ENUM('ok','delay','defect'), -- 正常/遅延/不良
created_at TIMESTAMP
)

-- 評価コメント
reviews(
id INT PK AUTO_INCREMENT,
supplier_id INT FK,
comment TEXT,
reviewer VARCHAR(50),
reviewed_at DATE,
created_at TIMESTAMP
)
```

スコア計算はPHP側でtransactionsを集計してリアルタイム算出（DBにスコアは保存しない）。

---

## 5. デザインの方向性
- **カラー**：ネイビー（#1E3A5F）をメインに、ホワイト背景＋ライトグレーカード。アラートは赤（#D9534F）・黄（#F0AD4E）。ランクAはゴールド・BはシルバーのバッジCSSで表現。
- **テイスト**：業務系SaaS風の清潔感あるフラットデザイン。レーダーチャートはChart.js（CDN）を使用。
- **レスポンシブ**：スマホでは台帳・実績入力を優先表示。チャート系はスクロール対応。
- **規模感**：初回デプロイで全機能完成できる現実的な規模。管理者認証は簡易パスワード認証（.htaccess または PHP session）で実装可。
- **フォント**：Noto Sans JP（Google Fonts CDN）を使用。