AttendanceCore - 工場・現場向け勤怠・作業者管理システム

## 1. アプリの目的・ターゲットユーザー
製造現場・建設現場・物流倉庫などで働く中小企業向けに、作業者の出退勤打刻・シフト管理・残業集計・有給残数・資格証明書の有効期限を一元管理するWebアプリ。既存の「ShiftMate」がシフト表作成に特化しているのに対し、本アプリは「打刻〜給与計算用データ出力」まで現場運用の全フローをカバーする。スマホからのQRコード打刻に対応し、紙の出勤簿・Excelを廃止したい中小製造業の総務担当・現場管理者が主なターゲット。

## 2. 主要機能
- **QRコード打刻（出勤・退勤・休憩）**: 作業者ごとに個人QRコードを発行。スマホカメラでスキャンして打刻。入力端末不要でタブレット1台で運用可能
- **月次勤怠集計**: 作業者ごとに所定労働時間・残業時間・深夜時間・遅刻早退・有給取得日数を自動集計。月次サマリーをCSV出力（給与ソフト連携用）
- **シフトカレンダー管理**: 月次シフトを担当者が登録し、作業者はカレンダーで自分のシフトを確認。「シフトと実績の乖離」を色分けで警告
- **作業者台帳＋資格期限アラート**: 氏名・雇用形態・所属工程・保有資格（フォークリフト・危険物取扱・玉掛けなど）・有効期限を登録。期限30日前・7日前に台帳画面でアラート表示
- **日次ダッシュボード**: 当日の出勤人数・未打刻者リスト・残業上位者・有給取得状況をワンページで確認
- **管理者・作業者の2ロール**: 管理者は全データ閲覧・修正可。作業者は自分のシフト・打刻履歴・有給残数のみ閲覧。URLパラメータ＋4桁PINで簡易認証

## 3. 画面構成
### 管理者側
- **ダッシュボード（/admin/dashboard）**: 当日出勤状況カード、未打刻アラート一覧、今月の残業ランキング、資格期限切れ警告バナー
- **作業者台帳（/admin/workers）**: 一覧表、新規登録・編集フォーム（氏名・社員番号・雇用形態・所属工程・時給/月給・資格リスト）、個人QRコード印刷ボタン
- **打刻管理（/admin/attendance）**: 月次カレンダービュー＋日次一覧。セルクリックで手動修正モーダル。打刻種別（出勤・退勤・休憩開始・休憩終了）を選択して保存
- **シフト管理（/admin/shift）**: 月次グリッド（縦：作業者、横：日付）。セルクリックでシフト種別（日勤/夜勤/休み/有給）を入力。一括コピー・前月複製ボタン
- **集計・CSV出力（/admin/report）**: 対象月・対象者を選択して集計テーブル表示。列：氏名・出勤日数・所定内時間・残業時間・深夜時間・遅刻回数・有給取得日数。CSVダウンロード
- **資格期限アラート（/admin/qualifications）**: 期限が近い順のリスト。更新完了ボタンで新しい期限日を再登録

### 作業者側
- **打刻ページ（/clock）**: 大きなQRスキャナー表示（jsQR使用）。読み取り成功で出勤/退勤/休憩を自動判定して登録。作業者名と打刻時刻をフルスクリーン表示（入口タブレット設置用）
- **マイページ（/mypage?pin=XXXX）**: 今月のシフトカレンダー、打刻履歴（直近10件）、有給残数、保有資格と期限

## 4. データ構造（MySQLテーブル概要）
```
workers（作業者台帳）
id, employee_no, name, employment_type（正社員/パート/派遣）,
department, hourly_wage, monthly_salary, pin_code（4桁）,
qr_token（個人QR用UUIDトークン）, created_at

qualifications（資格・免許）
id, worker_id, qual_name, expires_at, updated_at

shifts（シフト登録）
id, worker_id, shift_date, shift_type（day/night/off/paid_leave/absence）,
start_time, end_time, note

attendance_logs（打刻ログ）
id, worker_id, punch_type（clock_in/break_start/break_end/clock_out）,
punched_at, input_method（qr/manual）, modified_by

monthly_summaries（月次集計キャッシュ）
id, worker_id, year_month（YYYYMM）,
work_days, scheduled_hours, actual_hours, overtime_hours,
night_hours, late_count, paid_leave_used, generated_at
```

## 5. デザインの方向性
- **カラーパレット**: ネイビー（#1a2f4b）をヘッダー基調に、アクセントはオレンジ（#f47c20）。現場の安全色（工場・建設）をイメージ
- **フォント**: 数字が見やすいRoboto / Noto Sans JP。打刻確認画面は極大フォント（6rem）でタブレット遠見対応
- **レイアウト**: 管理者画面はサイドナビ＋コンテンツ2カラム（PC）、スマホでは1カラムに折りたたみ。作業者向け打刻ページはフルスクリーン1カラムで視認性最優先
- **テーブルUI**: シフトグリッドはセル色分け（日勤：水色、夜勤：紺、有給：緑、休み：グレー、未登録：白）でひと目で把握できるように
- **規模感**: PHP 7ファイル程度、MySQL 5テーブル、jQueryなし素のJS。外部ライブラリはjsQR（QR読取）とChart.js（集計グラフ）のみ