SpotAudit - 現場5S・安全パトロール記録＆改善フォローシステム

## 1. アプリの目的・ターゲットユーザー
製造業・建設業・物流倉庫・食品加工業の安全衛生担当者・現場監督者が、5S活動（整理・整頓・清掃・清潔・躾）や定期安全パトロールの指摘事項をスマホから即時記録し、改善完了まで追跡・可視化できる業務Webアプリ。従来の紙の巡回チェックシートやExcel管理を置き換え、未対応指摘の放置ゼロを目指す。

---

## 2. 主要機能

- **パトロール記録入力**：エリア・カテゴリ（整理/整頓/清掃/清潔/躾/安全/設備/防火）・危険度（高/中/低）・指摘内容テキスト・写真メモ（Base64でDBに保存）・担当者を現場スマホから登録。パトロール日時は自動付与。
- **改善アクション管理（カンバン）**：指摘ごとに「未対応 → 対応中 → 改善完了 → 効果確認済」の4ステータスをカンバンカード形式で管理。担当者・期限・対策内容・完了写真を追記可能。期限超過カードは赤ハイライト。
- **ダッシュボード**：今月の指摘件数・未対応件数・改善率・危険度別内訳をカード＋棒グラフで表示。エリア別・カテゴリ別パレート図で多発箇所を即把握。
- **パトロール計画スケジューラー**：週次・月次のパトロール予定をカレンダーに登録し、担当者と対象エリアを割り当て。実施済／未実施を管理し、未実施はアラート表示。
- **帳票印刷**：指摘一覧・改善報告書・月次まとめをA4フォーマットでブラウザ印刷（window.print）。パトロール記録はPDF化しやすいシンプルレイアウト。
- **CSV出力**：指摘記録・改善実績を月次CSVでエクスポート。安全委員会資料や上位管理者への報告に活用。

---

## 3. 画面構成

### ① ダッシュボード（TOP）
- 上部：今月サマリーカード（指摘件数・未対応・改善率・高危険度件数）
- 中段：エリア別指摘棒グラフ ／ カテゴリ別パレート図
- 下段：未対応・期限超過の指摘カード一覧（最新5件）

### ② パトロール記録入力画面
- フォーム形式。日付（自動）、パトロール担当者名、エリア選択（プルダウン）、カテゴリ、危険度（ラジオ）、指摘内容（テキストエリア）、写真（file inputでBase64変換）、対応期限、担当者
- 「登録」ボタンでDBに保存後、カンバン画面へリダイレクト

### ③ 改善カンバン画面
- 4列カンバン（未対応 / 対応中 / 改善完了 / 効果確認済）
- カードには：エリア・カテゴリ・危険度バッジ・指摘内容・期限・担当者を表示
- カードクリックでモーダル詳細表示：写真プレビュー・対策入力・完了写真・ステータス変更
- 列上部に件数カウンター

### ④ 指摘一覧画面
- エリア・カテゴリ・危険度・ステータス・期間でフィルター＋テーブル表示
- 行クリックで詳細モーダル
- CSV出力・印刷ボタン

### ⑤ パトロール計画画面
- 月次カレンダービュー
- 予定クリックで登録モーダル（日付・担当者・エリア・備考・実施フラグ）
- 未実施予定はオレンジ背景でアラート表示

### ⑥ マスタ管理画面
- エリアマスタ（追加・編集・削除）
- 担当者マスタ（追加・編集・削除）
- 管理者パスワード（.htaccess or セッション簡易認証）

---

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

```sql
-- エリアマスタ
areas(id, name, sort_order, created_at)

-- 担当者マスタ
users(id, name, department, created_at)

-- パトロール計画
patrol_plans(
id, plan_date, area_id, user_id,
note, is_done, done_at, created_at
)

-- 指摘記録（メインテーブル）
findings(
id, found_at, patrol_plan_id,
area_id, category, severity(enum: high/mid/low),
description, photo_before(MEDIUMTEXT/Base64),
assignee_id, due_date,
status(enum: open/in_progress/done/verified),
action_note, photo_after(MEDIUMTEXT/Base64),
closed_at, created_at, updated_at
)
```

---

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

- **カラー**：ベースは白・ライトグレー。危険度バッジは赤（高）・オレンジ（中）・青（低）。ステータス列はグリーン系グラデーション。ナビは濃いネイビー。
- **フォント**：Noto Sans JP（Google Fonts）、見やすい14〜16pxベース。
- **レイアウト**：左サイドバーナビ（PCは固定、スマホはハンバーガーメニュー）＋メインコンテンツ領域。カンバンはflexbox横並び、スマホでは縦スクロール1列に折り畳む。
- **グラフ**：Chart.js（CDN）で棒グラフ・パレート図を描画。外部APIキー不要。
- **写真**：file inputでBase64変換しMEDIUMTEXTに保存。最大サイズはクライアント側でcanvasリサイズ（最大800px幅）して容量を抑える。
- **認証**：簡易セッション認証（管理者パスワード1つ）。登録不要で現場スタッフは記録入力のみ可能、管理者のみマスタ編集・削除可。
- **規模感**：PHPファイル8〜12本、JS/CSS各1〜2ファイル。1スプリントで完成できる規模。