LabelRoute - 出荷ラベル・送り状一括発行システム

## 1. アプリの目的・ターゲットユーザー
小規模EC事業者・製造業の出荷担当者・倉庫スタッフを対象に、送り状・出荷ラベル・梱包明細ラベルをブラウザだけで一括生成・印刷できるWebアプリ。宛先リストのCSVインポートやフォーム入力から送り状・ラベルを即作成し、A4普通紙・ラベル用紙(A4×4面/6面/8面)でそのまま印刷できる。外部APIキー不要・コスト0で導入できることが最大の差別化。

---

## 2. 主要機能
- **ラベルテンプレート管理**: 送り状(宅急便・ゆうパック・メール便・国際便)、梱包明細、受領書、荷物タグの6種類を内蔵テンプレートとして用意。自社ロゴ・注意文言をカスタマイズ保存可能
- **宛先登録・CSVインポート**: フォームでの1件登録のほか、CSV一括インポート(最大500件)に対応。得意先マスタに登録して次回から選択入力できる
- **バーコード自動生成**: 発送番号・管理番号をCode128またはQRコードで自動生成し、ラベル上に印字(外部ライブラリ ZXing.js を使用)
- **印刷レイアウト選択**: A4縦1面・2面・4面・6面・8面の5レイアウトをリアルタイムプレビューで確認してからブラウザ印刷。ハガキサイズにも対応
- **発行履歴・ステータス管理**: 発行済みラベルの一覧を日付・得意先・追跡番号で検索でき、「未発送・発送済・到着確認」のステータスを更新管理
- **日次・月次発行レポート**: 発行枚数・配送業者別件数・得意先別件数をグラフ表示しCSVダウンロード

---

## 3. 画面構成

### (1) ダッシュボード
- 本日の発行枚数カード、未発送件数カード、今月累計カード
- 直近10件の発行履歴テーブル(追跡番号・宛先・ステータス・印刷ボタン)
- クイック発行ボタン(1件手入力 / CSV一括インポート)

### (2) ラベル作成画面(手入力)
- テンプレート選択(タブ切替)
- 差出人情報(初回登録後は自動補完)
- 宛先入力フォーム(得意先マスタ検索またはフリー入力)
- 品名・重量・個数・代引き金額・配送業者・サービス種別
- バーコード種別選択(Code128 / QR)
- 右側リアルタイムプレビューペイン
- 「発行して印刷」「発行のみ保存」ボタン

### (3) CSV一括インポート画面
- テンプレートCSVダウンロードリンク
- ファイルアップロードエリア(ドラッグ&ドロップ)
- インポートプレビューテーブル(バリデーションエラーを行ごとに赤表示)
- 印刷レイアウト選択(4面/6面/8面)
- 「一括発行・印刷」ボタン

### (4) 発行履歴画面
- 日付範囲・得意先・ステータス・配送業者でフィルター
- 一覧テーブル(チェックボックスで複数選択して再印刷可能)
- ステータスをプルダウンで変更保存
- CSV出力ボタン

### (5) マスタ管理画面
- 自社情報(差出人・ロゴ画像・印影画像)
- 得意先マスタ(住所・担当者・よく使う品名)
- ラベルテンプレートのカスタム文言編集

### (6) レポート画面
- 月別発行枚数棒グラフ
- 配送業者別円グラフ
- 得意先別ランキングテーブル
- CSV・印刷ボタン

---

## 4. データ構造 (MySQLテーブル概要)

```sql
-- 自社情報
company_profile (id, company_name, zip, address, tel, logo_path, created_at)

-- 得意先マスタ
customers (id, customer_code, name, zip, address, tel, contact_name, memo, created_at)

-- ラベルテンプレート
label_templates (id, template_key, template_name, layout_type, header_text, footer_text, is_active)

-- 発行履歴
shipments (id, template_id, customer_id, tracking_no, barcode_type, barcode_value,
sender_name, sender_address, recipient_name, recipient_address,
item_name, weight, quantity, carrier, service_type, cod_amount,
status ENUM('draft','dispatched','delivered','cancelled'),
issued_at, updated_at)

-- CSVインポートバッチ
import_batches (id, filename, total_count, success_count, error_count, imported_at)
```

---

## 5. デザインの方向性
- **カラー**: ロジスティクス・物流をイメージする「ネイビー×オレンジ×ホワイト」
- **スタイル**: シンプルなフラットUI。現場のスタッフが操作ミスしないよう、ボタンは大きめ・コントラスト高め
- **レイアウト**: PC優先の左サイドナビ + コンテンツエリア。タブレットでも支障なく使えるレスポンシブ
- **印刷プレビュー**: ラベル枠・バーコード・文字が実寸で確認できるよう `@media print` を活用し、ブラウザUI要素を非表示にして印刷
- **フォント**: メイリオ/Noto Sans JPを使用し、住所・氏名の可読性を最優先
- **規模感**: PHP 10〜15ファイル、MySQL 5テーブル程度の現実的な構成で1スプリント完成可能