DeliveryNote Pro - 納品書・受領確認クラウド台帳

## 1. アプリの目的・ターゲットユーザー
小規模製造業・卸売業・建設資材業などで、紙の納品書を手書きしてFAXやメール添付で送り、受領確認を電話で取るという非効率な運用を改善する。納品書の作成から発行、得意先ごとの受領確認状況、未確認アラートまでをブラウザ一本で完結させる。
- **主なターゲット**: 従業員5〜30名規模の中小製造業・卸売業・物流下請業の事務担当者・営業担当者
- **課題解決**: 「納品書をいつ誰に送ったか分からない」「受領確認の電話が面倒」「月末に納品書を探し回る」を解消

---

## 2. 主要機能

- **納品書作成・発行**
得意先・品番・品名・数量・単価・備考をフォームで入力し、PDFプレビュー相当のA4印刷レイアウトを生成。納品書番号は自動採番（YYMMDDxxxx形式）。発行済みステータスに変更するとロック（編集不可）。

- **受領確認ステータス管理**
「作成中 → 発行済 → 受領確認済 → 差異あり」の4ステータスをカンバン形式（列並び）で管理。担当者コメントと確認日時を記録できる。差異ありの場合は差異内容メモ欄を表示。

- **得意先台帳**
得意先コード・会社名・担当者名・電話番号・メールアドレスを登録。納品書作成時にプルダウン選択して自動転記。

- **未確認アラートダッシュボード**
発行から3日・7日・14日経過しても受領確認済にならない案件をトップ画面の警告カードで一覧表示。件数バッジ付き。

- **月次集計・CSV出力**
得意先別・月別の納品件数・金額合計を一覧表示。絞り込み後のデータをCSVエクスポート。

- **印刷用レイアウト**
納品書1件をA4縦レイアウトで印刷できるprint用CSSを別途用意。会社ロゴテキスト・発行者情報をシステム設定として保存。

---

## 3. 画面構成

### ① ダッシュボード（/index.php）
- 上部: 未確認アラートカード（3日超・7日超・14日超の件数を信号機色で表示）
- 中部: 今月の納品件数・金額・確認率をKPIカード3枚で表示
- 下部: 最近の納品書10件リスト（番号・得意先・金額・ステータス・日付）

### ② 納品書一覧（/list.php）
- 検索バー（番号・得意先名・日付範囲・ステータス）
- テーブル表示（チェックボックス、納品書番号、発行日、得意先名、品目数、金額合計、ステータスバッジ、確認日、操作ボタン）
- 一括ステータス変更ボタン（選択した複数件をまとめて「受領確認済」に更新）

### ③ 納品書新規作成・編集（/form.php）
- ヘッダー部: 得意先選択（プルダウン）、納品日、自社担当者名、備考
- 明細部: 品番・品名・数量・単価・税区分（内税/外税/非課税）をテーブル行で入力、「行追加」「行削除」ボタン付き、金額・消費税・合計をリアルタイム自動計算
- フッター: 「一時保存」「発行確定」「印刷プレビュー」ボタン

### ④ 納品書詳細・受領確認（/detail.php）
- 納品書の全情報表示（印刷レイアウトと同一ビュー）
- 受領確認パネル: ステータス変更ドロップダウン、確認者名、確認日、差異メモ、「更新」ボタン
- 履歴ログ: ステータス変更の日時・操作者を自動記録して一覧表示

### ⑤ 得意先台帳（/customers.php）
- 得意先一覧テーブル（コード・会社名・担当者・電話・メール・累計納品件数）
- 新規登録・編集・削除モーダル

### ⑥ システム設定（/settings.php）
- 自社情報（会社名・住所・電話・メール・ロゴテキスト）
- アラート日数設定（デフォルト: 3/7/14日、任意変更可）
- ユーザー管理（簡易的に名前とパスワードのみ、セッション認証）

---

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

```sql
-- 得意先
customers(id, code, name, contact_name, phone, email, created_at)

-- 納品書ヘッダー
delivery_notes(
id, note_number VARCHAR(12),
customer_id, delivery_date,
staff_name, remarks,
subtotal, tax_amount, total_amount,
status ENUM('draft','issued','confirmed','discrepancy'),
confirmed_by, confirmed_at, discrepancy_note,
issued_at, created_at, updated_at
)

-- 納品書明細
delivery_note_items(
id, note_id, line_no,
item_code, item_name,
quantity, unit_price, tax_type ENUM('in','ex','none'),
amount, created_at
)

-- ステータス変更履歴
status_logs(
id, note_id, old_status, new_status,
changed_by, changed_at, note
)

-- ユーザー（簡易認証）
users(id, name, password_hash, created_at)

-- システム設定（KVS形式）
settings(key VARCHAR(64), value TEXT, updated_at)
```

---

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

- **カラーパレット**: メインカラーは深みのある紺（#1E3A5F）、アクセントに橙（#F5A623）、ステータスバッジは緑・黄・赤・グレーの信号機カラー
- **レイアウト**: サイドバーナビ（PC）、ハンバーガーメニュー（スマホ）のレスポンシブ2カラム構成
- **印刷CSS**: 納品書詳細ページのみ専用のprint.cssを用意し、サイドバー・ナビを非表示にしてA4縦サイズで正確に出力
- **フォント**: ゴシック系システムフォント（游ゴシック/Noto Sans JP）、明細テーブルは等幅フォントで金額を右揃え
- **UX**: 明細行の追加・削除はJS動的操作で画面遷移なし、金額は入力のたびにリアルタイム計算、発行確定後は誤編集防止のため全フィールドをdisabled表示
- **スマホ最適化**: 一覧テーブルは横スクロール+固定左列（得意先名）、詳細フォームは1カラム縦積みレイアウト