ガイドライン理解度テスト

📋実装状況サマリー

機能	状態	備考
スタート画面（氏名・職種入力）	完了	app/page.tsx
クイズ画面（1問ずつ表示）	完了	職種別問題セット対応済み
結果・解説確認画面	完了	全選択肢+間違い理由の表示に改善済み
管理者ダッシュボード	完了	CSVエクスポート対応
回答送信API	完了	SQLite保存
解説確認API	完了	confirmed_at更新
未確認アラートAPI	完了	10分タイムアウト+離脱検知
メール送信（nodemailer）	完了	SMTP設定が必要
職種別問題データ	完了	リハ職/医師看護師/事務の3カテゴリ
`.env.local` 設定	手動	下記参照
本番デプロイ	未着手	Vercelまたは院内サーバー

✍️残っている手動作業

1. `.env.local` の作成（必須・最優先）

プロジェクトルートの env.local.example をコピーして設定してください。

cd C:\Users\kawag\work\guideline-quiz
copy env.local.example .env.local

設定項目:

変数	設定内容
`SMTP_HOST`	`smtp.gmail.com`
`SMTP_PORT`	`587`
`SMTP_USER`	送信元Gmailアドレス
`SMTP_PASS`	Gmailアプリパスワード（16文字）
`ADMIN_EMAIL`	アラート送信先メールアドレス
`ADMIN_KEY`	管理画面アクセス用の秘密キー（任意の文字列）

2. Gmailアプリパスワードの取得

Googleアカウント → セキュリティ → 2段階認証を有効化
2段階認証ページ下部 → 「アプリパスワード」
アプリ名を入力して「生成」→ 表示された16文字をSMTP_PASSに設定

3. 動作確認

cd C:\Users\kawag\work\guideline-quiz
npm run dev

受験画面: http://localhost:3000
管理者画面: http://localhost:3000/admin?key=設定したADMIN_KEY

確認ポイント:

各職種（理学療法士/事務/医師等）で異なる問題が出題されるか
誤答時に全選択肢の間違い理由が赤字で表示されるか
解説確認ボタンを全て押さないと完了ボタンが押せないか
10分タイムアウトでアラートメールが届くか

4. 本番デプロイ（将来）

注意: better-sqlite3はサーバーレス環境（Vercel）では動作しません。本番運用時は以下のいずれかを検討してください:

院内サーバーでNode.js直接実行（推奨）
DBをSupabase/Turso等に移行してVercelデプロイ
Docker化して院内サーバーにデプロイ

5. 問題内容の確認・修正

職種別問題の内容が施設の実情に合っているか確認
修正する場合は lib/questions.ts を編集
問題追加時は id の重複に注意

📝職種別問題構成

共通3問 + 職種別2問 = 計5問

臨床職 = リハ職（PT/OT/ST）+ 医師 | 窓口職 = 事務 + 看護師

問題	共通	臨床職 (リハ+医師)	窓口職 (事務+看護師)
Q1: 院内ID = 個人情報?	✓	✓	✓
Q2: インシデント発見時の初動	✓	✓	✓
Q3: 全体連絡メールの匿名化レベル	✓	✓	✓
Q4: 私物PCでの業務データ取扱い		✓
Q4: FAX誤送信防止の正しい手順			✓
Q5: データ分析でのAI利用ルール		✓
Q5: 患者家族からの電話問合せ対応			✓

🔎結果画面の改善内容

改善前

「あなたの回答」と「正解」のテキストのみ表示
どの選択肢がなぜ間違いなのか分からない

改善後

全4選択肢を一覧表示し、正解は緑枠、誤選択は赤枠で強調
各不正解選択肢の下に赤字で間違いの理由を表示
「← 正解」「← あなたの回答」バッジで視覚的に区別
正解の選択肢も含め、なぜ他が間違いなのかを理解できる構成

📁ディレクトリ構成

guideline-quiz/
├── app/
│   ├── page.tsx              # スタート画面
│   ├── quiz/page.tsx         # クイズ画面（職種別問題対応）
│   ├── result/page.tsx       # 結果画面（全選択肢+間違い理由表示）
│   ├── admin/page.tsx        # 管理者ダッシュボード
│   ├── layout.tsx
│   ├── globals.css
│   └── api/
│       ├── submit/route.ts   # 回答送信
│       ├── confirm/route.ts  # 解説確認
│       ├── alert/route.ts    # アラート送信
│       └── results/route.ts  # 結果一覧（管理者用）
├── lib/
│   ├── db.ts                 # SQLite
│   ├── questions.ts          # 問題データ（職種別）
│   └── mailer.ts             # メール送信
├── env.local.example         # 環境変数テンプレート
├── quiz.db                   # DBファイル（自動生成）
└── README.md

⚠️注意事項

このアプリに患者情報を入力しないでください。
受験者の氏名・職種は施設内部管理目的でのみ使用します。

ADMIN_KEY は推測困難な文字列を設定すること
quiz.db は定期的にバックアップを取ること
HTTPS環境での運用を推奨（特にメールアドレス入力がある場合）
better-sqlite3はVercelサーバーレスでは動作しない

ガイドライン理解度テスト 引き継ぎ資料