SubconTrack - 外注加工費・工賃台帳＆支払管理システム

## 1. アプリの目的・ターゲットユーザー
製造業・加工業の中小企業において、複数の外注先（研磨、メッキ、熱処理、塗装、溶接など）への加工依頼と工賃の管理が紙や個別Excelに分散しているケースが多い。SubconTrack は「どの外注先に・何個・いつ出して・いくら払うか」をブラウザ一元管理し、支払い漏れ・金額ミスを防ぐ業務アプリ。

**ターゲット**: 製造業の購買・外注担当者、工場事務員、町工場の経営者（1〜20名規模）

---

## 2. 主要機能

- **外注先マスタ管理**: 社名・担当者名・電話・メール・対応工程（メッキ/研磨/熱処理など）・単価表・支払サイト（末締め翌月払いなど）を登録・編集
- **加工依頼登録（作業指示）**: 品番・品名・数量・外注先・単価・出荷日・納期予定を入力し依頼レコードを生成。依頼済→納品済→請求済→支払済の4ステータスで進捗管理
- **納品・検収入力**: 実際の納品数・納品日・不良数を入力し差異（過不足）を自動計算。不良があれば外注先別不良率を累積
- **支払集計・仕切り書生成**: 締め日基準で外注先ごとに当月支払予定金額を自動集計し、A4印刷対応の仕切り書（支払明細書）をHTML印刷で出力
- **支払カレンダーダッシュボード**: 月次の支払予定額を外注先別バー・合計額で表示。「今月支払済」「未払い」「次月繰越」を色分けカード表示
- **CSV入出力**: 依頼一覧・支払明細・外注先マスタをCSVエクスポート、依頼データの一括CSVインポートにも対応

---

## 3. 画面構成

### (A) ダッシュボード（トップ）
- 今月支払予定総額・未払い件数・納期超過件数のサマリーカード
- 支払スケジュールカレンダー（月次、外注先別色分けバー）
- 最近の依頼・納品アクション履歴タイムライン

### (B) 依頼一覧
- 品番/品名/外注先/ステータス/締め月でフィルター検索できるテーブル
- ステータスを行内で直接変更できるドロップダウン
- 新規依頼登録ボタン → モーダルフォーム

### (C) 依頼詳細・編集画面
- 依頼情報・納品実績・検収差異・コメントをタブ表示
- ステータス変更履歴ログ付き

### (D) 外注先マスタ
- 外注先一覧テーブル（登録・編集・削除）
- 各外注先をクリックすると過去依頼一覧・不良率・月次取引金額推移グラフを表示

### (E) 支払集計・仕切り書
- 締め年月を選択 → 外注先別の「依頼件数・金額・検収済金額・差引支払額」を自動集計
- 「仕切り書を印刷」ボタンで印刷専用レイアウト（社名・明細・合計・銀行振込欄）を表示
- 支払済マークを一括チェック

### (F) CSVインポート・エクスポート画面
- 依頼データのCSVテンプレートDL → アップロード → プレビュー → 取込確定
- 支払明細・依頼一覧のCSVエクスポート

---

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

```sql
-- 外注先マスタ
subcontractors(
id INT PK,
name VARCHAR(100), -- 社名
contact_name VARCHAR(50), -- 担当者名
phone VARCHAR(20),
email VARCHAR(100),
processes TEXT, -- 対応工程（JSON配列）
payment_site VARCHAR(30), -- 例: "月末締め翌月末払い"
notes TEXT,
created_at DATETIME
)

-- 加工依頼
subcon_orders(
id INT PK,
subcontractor_id INT FK,
part_no VARCHAR(50), -- 品番
part_name VARCHAR(100), -- 品名
process VARCHAR(50), -- 加工工程
qty_ordered INT, -- 依頼数
unit_price DECIMAL(10,2), -- 加工単価
amount DECIMAL(12,2), -- 金額（qty×unit）
order_date DATE, -- 依頼日
due_date DATE, -- 納期予定
status ENUM('依頼済','納品済','請求済','支払済'),
closing_month CHAR(7), -- 例: "2025-07"
created_at DATETIME
)

-- 納品・検収実績
subcon_receipts(
id INT PK,
order_id INT FK,
received_date DATE,
qty_received INT, -- 実納品数
qty_defect INT DEFAULT 0, -- 不良数
note TEXT,
created_at DATETIME
)

-- ステータス変更ログ
subcon_status_logs(
id INT PK,
order_id INT FK,
old_status VARCHAR(20),
new_status VARCHAR(20),
changed_at DATETIME
)
```

---

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

- **カラー**: ダークネイビー（#1a2438）をヘッダーに使い、落ち着いた業務システム感。アクセントカラーはアンバー（#f59e0b）で支払アラートや期限超過を強調
- **フォント**: システムフォント（Noto Sans JP）。テーブルは14px・行間広めで現場での視認性を重視
- **レイアウト**: 左サイドナビ＋右コンテンツエリアの2カラム。スマホでは下部タブナビに切替
- **テーブル**: 行のホバーで薄いハイライト、ステータスはバッジ（pill型）で色分け（依頼済グレー・納品済ブルー・請求済オレンジ・支払済グリーン）
- **印刷用仕切り書**: 白地・明朝体・A4縦で紙らしいレイアウト。@media print で余分なUIを非表示
- **規模感**: PHP 5〜6ファイル（index.php / api.php / 各ページ）+ MySQL 4テーブル。外部ライブラリは Chart.js（グラフ）のみ。1週間以内に実装完了できる現実的スコープ