ShiftBudget - 残業・休日出勤 事前申請＆予算管理システム

## 1. アプリの目的・ターゲットユーザー
製造業・物流・小売・サービス業の中小企業において、残業・休日出勤の事前申請、上長承認、人件費予算の消化率管理を一元化するWebアプリ。
- **申請者（作業員・一般社員）**: スマホから残業・休日出勤を事前申請し、承認結果をリアルタイムで確認できる。
- **管理者（リーダー・上長）**: 申請一覧を確認・承認／差戻し、部門ごとの残業予算消化率をダッシュボードで把握できる。
- **月次集計で「残業費がいくらかかったか」を見える化し、コスト意識を浸透させる。**

---

## 2. 主要機能
- **残業・休日出勤申請**: 日付・開始〜終了時刻・理由・作業内容を入力して申請送信。申請種別（法定外残業／法定内残業／休日出勤／深夜）を選択式で区分。
- **承認ワークフロー**: 管理者画面に申請一覧を表示し、承認／差戻し（コメント付き）を1クリックで実施。ステータス（申請中・承認済・差戻し・取消）を色バッジで管理。
- **残業予算管理**: 部門・月ごとに残業時間予算（上限時間数）と単価を設定し、承認済み時間の消化率をプログレスバーで可視化。超過リスク時は赤アラート。
- **月次集計レポート**: 社員別・部門別の残業時間合計・費用合計を自動集計し、A4印刷レイアウトとCSV出力に対応。
- **社員マスタ管理**: 社員番号・氏名・部門・時給（基本・残業・深夜・休日）・雇用区分を登録。管理者権限フラグを設定可能。

---

## 3. 画面構成

### 共通
- **ログイン画面**: 社員番号＋パスワードでログイン。管理者は別フラグで判別し同一画面から遷移。

### 申請者側
- **マイ申請一覧画面（TOP）**: 当月の申請カード一覧。ステータスバッジ（申請中・承認済・差戻し）、差戻しコメント確認ボタン。新規申請ボタン（フローティングボタン）。
- **申請フォーム画面**: 日付、種別（プルダウン）、開始時刻・終了時刻（time入力）、作業内容テキスト、理由テキストを入力してPOST送信。予想残業費をリアルタイム表示。

### 管理者側
- **承認ダッシュボード（TOP）**: 未承認件数バッジ付きの申請一覧テーブル。部門フィルター・日付範囲フィルター。一括承認ボタン。
- **予算管理画面**: 部門×月の予算時間と消化済み時間のプログレスバー一覧。超過アラートを赤表示。部門別設定フォーム。
- **月次レポート画面**: 月・部門を選択して社員別集計テーブルを表示。費用合計（種別別内訳）。CSV出力・印刷ボタン。
- **社員マスタ管理画面**: 社員一覧CRUD。管理者権限切替。

---

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

```sql
-- 社員マスタ
employees (id, emp_code, name, department, hourly_rate, overtime_rate, holiday_rate, night_rate, employment_type, is_admin, password_hash, created_at)

-- 残業申請
ovt_requests (id, employee_id, request_date, work_date, type ENUM('overtime','legal_overtime','holiday','night'), start_time, end_time, duration_minutes, reason, work_detail, status ENUM('pending','approved','rejected','cancelled'), approver_id, approved_at, reject_comment, created_at)

-- 残業予算設定
ovt_budgets (id, department, year_month, budget_hours, note, created_at)

-- 部門マスタ
departments (id, name, sort_order)
```

---

## 5. デザインの方向性
- **カラー**: ネイビー（#1e3a5f）をメインカラー、オレンジ（#f59e0b）をアクセント・アラート色とした落ち着いたビジネストーン。
- **レイアウト**: モバイルファースト。申請フォームは縦スクロール1画面で完結。管理者の承認一覧はカード型（スマホ）とテーブル型（PC）をレスポンシブで切替。
- **ステータスバッジ**: 申請中＝黄、承認済＝緑、差戻し＝赤、取消＝グレーの信号機カラー統一。
- **予算プログレスバー**: 消化率70%未満＝緑、70〜90%＝黄、90%超＝赤のグラデーション切替。
- **フォント**: Noto Sans JP 使用。数値は太字・大きめで視認性重視。
- **規模**: PHP（PDO）+ MySQL + Bootstrap5 + 素のJS。セッション認証。1人でも1週間以内に実装完了できる現実的スコープ。