CustomerVoice - 顧客クレーム・VOC収集&改善サイクル管理システム

## 1. アプリの目的・ターゲットユーザー
顧客からの問い合わせ・クレーム・改善要望（Voice of Customer）を一元受付し、担当者アサイン→原因分類→対策登録→再発防止水平展開→効果確認まで、PDCAサイクルを可視化・追跡できる業務アプリ。

**ターゲット：** 中小製造業・小売業・サービス業の品質管理担当・カスタマーサポート担当・経営者（1〜20名規模）

---

## 2. 主要機能

- **VOC受付登録**
顧客名・受付日・チャネル（電話/メール/対面/Web）・カテゴリ（クレーム/要望/問い合わせ/称賛）・製品・内容・緊急度（高/中/低）を登録。受付番号を自動採番。

- **ステータス管理 & 担当者アサイン**
「受付済→調査中→対策立案→対応完了→効果確認済」の5ステップをカンバン型で管理。担当者マスタから担当者を割り当て、期日設定とアラートで対応漏れを防止。

- **原因分析 & 対策登録**
各VOC案件に対して「直接原因・根本原因・再発防止策・水平展開先部門」を入力。5M1E（Man/Machine/Material/Method/Measurement/Environment）の原因区分タグを選択式で付与。

- **ダッシュボード & パレート分析**
月次/年次のカテゴリ別件数棒グラフ、ステータス別ドーナツグラフ、原因区分パレート図をトップ画面に表示。未完了案件の件数と最大経過日数をアラートカードで強調。

- **報告書印刷 & CSV出力**
案件単票（受付情報＋原因＋対策＋担当者欄を1枚にまとめたA4レイアウト）をブラウザ印刷で出力。案件一覧をCSV出力して上位者への報告・外部共有に利用可能。

- **水平展開チェックリスト**
「再発防止策が他製品・他工程・他拠点に展開されたか」をチェックリスト形式で確認し、未完了の展開タスクを一覧表示することで対策の徹底状況を管理。

---

## 3. 画面構成

| 画面 | 内容 |
|---|---|
| **ダッシュボード (TOP)** | 未対応件数アラートカード、月次件数グラフ、パレート図、最近の案件リスト5件 |
| **VOC一覧** | 検索・フィルター（期間/カテゴリ/ステータス/担当者/緊急度）付きテーブル、CSV出力ボタン |
| **VOC登録・編集** | 受付情報フォーム。登録後に案件詳細画面へ遷移 |
| **案件詳細** | 基本情報・ステータス履歴タイムライン・原因分析フォーム・対策登録・水平展開チェックリスト・A4印刷ボタン |
| **マスタ管理** | 担当者マスタ（名前・部署・メモ）、製品マスタ（製品名・カテゴリ）のCRUD |
| **月次レポート** | 月を選択するとKPI（受付件数・完了件数・平均対応日数・未完了率）と原因区分別グラフを表示。印刷対応 |

ヘッダーにグローバルナビゲーション（ダッシュボード/VOC一覧/登録/マスタ/レポート）を配置。スマホはハンバーガーメニューに収納。

---

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

```sql
-- 担当者マスタ
staff(id, name, department, memo, created_at)

-- 製品マスタ
products(id, name, category, memo, created_at)

-- VOC案件
voc_cases(
id, case_no VARCHAR(20), received_at DATE,
customer_name VARCHAR(100), channel ENUM('電話','メール','対面','Web','その他'),
category ENUM('クレーム','要望','問い合わせ','称賛'),
urgency ENUM('高','中','低'),
product_id INT, staff_id INT,
due_date DATE, status ENUM('受付済','調査中','対策立案','対応完了','効果確認済'),
summary TEXT, detail TEXT,
direct_cause TEXT, root_cause TEXT, cause_tag VARCHAR(50),
countermeasure TEXT, horizontal_target TEXT,
closed_at DATE, created_at TIMESTAMP, updated_at TIMESTAMP
)

-- ステータス変更履歴
voc_history(id, case_id INT, old_status, new_status, note TEXT, changed_at TIMESTAMP)

-- 水平展開チェックリスト
horizontal_checks(id, case_id INT, target_dept VARCHAR(100), action TEXT, is_done TINYINT, done_at DATE)
```

---

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

- **カラースキーム：** ベース白 (#FAFAFA)、プライマリ青 (#2563EB)、緊急度「高」赤 (#EF4444)、完了緑 (#10B981) のシンプルな4色構成
- **フォント：** Noto Sans JP（視認性重視）
- **UIスタイル：** 業務アプリらしいフラットデザイン。カードとテーブルの組み合わせで情報密度を確保しつつ、ボタン・フォームはタップしやすい大きめサイズ（スマホ入力対応）
- **ステータスバッジ：** 色分けピル型バッジ（受付済グレー→調査中黄→対策立案青→対応完了緑→効果確認済深緑）でひと目で状況を把握
- **印刷CSS：** `@media print` でナビ非表示・A4縦レイアウトに最適化された案件単票・月次レポートを実装