試験問題管理ツール利用ガイド

最終更新: 2025-10-29
このドキュメントは、問題の登録・改訂・出力・集計の運用ルールをまとめたものです。

1. ツールの画面構成

画面上部に4つのタブがあります。

問題一覧（あるいは「問題管理」）
読み込んだ全問題を検索・一覧表示し、クリックすると詳細が表示されます。
作問・編集（「問題作成・編集」）
新規作問・既存問題の改訂・一部編集を行います。
入出力
CSVファイルの読み込み（過去問題・出題履歴）、および新規CSV/更新CSVとしての出力を行います。
統計
問題数の集計（言語×難易度、作問者×難易度、領域×難易度など）を確認できるように準備中です。
まだ運用できていません。
案内
関連するリンクや簡単な解説がついています。

2. データの基本項目

本ツールでは、問題は1行1レコードとして扱われ、主に以下のフィールドを持ちます。

question_id	問題ID。例: `Q2025-101a`。改訂版は `Q2025-101aR1` のように末尾にR番号を付ける。
case_id	症例ID。連問で共通させるID。例: `CASE2025-101`。症例のない単問は空欄にする。
case_text	症例文（症例提示）。HTML可。
title	問題のタイトル（内部用。受験者には表示されない）。例: `肺炎の尿中抗原`
department	作成教室・講座。例: `細菌学`
author	作問者（担当者名・チーム名）。
language	問題の使用言語。`ja` または `en`。
difficulty	難易度（1〜5）。 Lv1: 正答率80%以上 / Lv5: 10%未満など。
domain1, domain2	領域。最大2つまで。例: 呼吸器感染症 / 診断。
active	`true`（現役） or `false`（非現役）。
tag	自由タグ（補助的な分類や注意書き）。
question_text	問題文。リッチテキスト可（`<b>`, `<i>`, `<u>`, `<em>` のみ許可）。
choice_a〜e	選択肢a〜e。リッチテキスト可。
correct	正解肢（`a`や`a,c`などカンマ区切り）。
keywords	検索・分類補助用のキーワード。カンマ区切り。例: `肺炎,尿中抗原,診断`
image_file	画像ファイル名（例: `case101_xray.png`）。
comment	教員向けコメント（意図・注意点など）。イタリック、ボールド、下線はタグ付きで入力が可能です。
explanation	学生向け解説。イタリック、ボールド、下線はタグ付きで入力が可能です。
created_at	作成日時。
updated_at	最終更新日時。
revision_note	修正メモ。「第107回医師国家試験A14を改変」など由来も含めて記録する。

※ question_text / choice_a〜e / case_text は、
太字（,）・斜体（,）・下線（）のみHTML可。

3. 症例・連問・改訂のルール

3.1 単問 / 症例なし

case_id は空欄。
「単問（症例なし）」として扱われる。

3.2 単問 / 症例あり

case_id はあるが、そのIDを持つのが1問だけ。
「単問（症例あり）」として扱われる。

3.3 連問

複数の問題が同一の case_id を共有する。
例: Q2025-101a, Q2025-101b, Q2025-101c がすべて CASE2025-101。
詳細画面では「連問（Q2025-101a、Q2025-101b、Q2025-101c）」のように関連ID一覧が自動表示される。

3.4 改訂（R1, R2...）

問題の内容を大きく修正する場合は、元の問題を直接書き換えず、新IDで保存します。
Q2025-001 → 改訂版は Q2025-001R1 → さらに Q2025-001R2。
詳細画面では同系列（Rつき含む）が「履歴」として一覧表示される。
古い版を active=false にするかどうかは人が判断する（自動では切り替えない）。

4. 作問タブでの操作

4.1 モード

新規作成 (new)
完全な新しい問題を作る。
question_id は新規のIDを入力する。
既存編集 (edit)
既存の問題をそのIDのまま一部修正するモード。
通常はロックされており、直接の上書きは推奨しない。
ロック解除ボタンを押さないとハード項目（ID/症例など）は編集できない。
改訂（複製）(revise)
既存問題を複製し、新ID（例: 元がQ2025-001ならQ2025-001R1など）で保存する。
元の問題は残り、複製後の問題は「新しい問題」として扱われる。

4.2 ロック

data-lock="hard" の項目（ID、症例ID、教室、言語など）は安全のため編集ロックされる。
data-lock="soft" の項目（選択肢、キーワード、解説など）は編集しやすい。
ロック解除を押すと、data-lock="hard" の項目も一時的に編集できる。
これは「過去問の直接修正」というリスクを伴う操作なので、注意喚起のアラートが出る。

4.3 保存ボタン

保存ボタンは「保存（新規・更新）」のみ。
new / revise モード
入力した question_id が既存と重複していたら保存できない。必ず新しいIDにする。
保存するとこの問題は「新規問題」としてリストに追加され、new.csv の対象にもなる。
edit モード
ロック解除後のみ、同じ question_id を上書き保存できる。
これは“元の問題を直接手術する”イメージ。履歴管理の都合でむやみに使わない。

4.4 クリア

「新しい問題としてリセット」ボタンで、フォームを初期化し、モードを new に戻す。
これにより、うっかり既存問題を上書きすることを防ぎます。

5. CSV入出力

5.1 読み込み

「問題CSV」から data.csv（既存/過去問）を読み込むと、一覧に反映される。
「履歴CSV」から history.csv を読み込むと、各問題の出題歴（どの試験で出たか等）が詳細に表示される。
読み込み時に、古いCSVの列名（「難易度」「領域1」など）も内部の標準フィールドに自動でマッピングされる。

5.2 出力

new.csv
このセッションで新規または改訂として保存した問題のみ。
新しく追加・配布したい問題リストとして利用する。
new_update.csv
現在管理中の全問題（過去から含めて）をエクスポートしたもの。
バックアップや一括レビュー用。

5.3 ExcelでCSVを正しく開く方法（文字化け防止）

作成したCSVファイルを直接Excelで開くと、文字化けが起こることがあります。
以下の手順で開くと正しく表示されます。

Excelを起動し、新しいブックを作成します。
「データ」タブを開き、左側の「テキストまたはCSVから」をクリックします。
作成したCSVファイルを選択して開きます。
通常は自動で正しく認識されるため、特別な変換は不要です。そのまま 「読み込み」をクリックします。
文字化けしていないことを確認したら、名前を付けて保存を選びます。
ファイル形式に「CSV UTF-8（コンマ区切り）（*.csv）」を選び、任意の名前で保存します。
保存後、Excel本体は閉じても構いません。閉じる際にメッセージが表示されても、そのままで問題ありません。

※この方法で保存したCSVは、再度ツールに読み込んでも文字化けしません。

別の方法：メモ帳でUTF-8として保存する

Excelを使わずにメモ帳で開いて保存する方法でも、文字化けを防ぐことができます。

CSVファイルを右クリックし、「プログラムから開く」→「メモ帳」を選びます。
開いた内容を確認し、上部メニューの「ファイル」→「名前を付けて保存」を選びます。
保存ダイアログの右下にある「エンコード」を 「UTF-8（BOM付き）」に変更します。
保存ボタンを押します。

この方法で保存したCSVも、Excelで開いても本ツールに読み込んでも文字化けしません。

6. 統計タブ

統計タブでは、読み込んだ全問題（=現在の一覧に入っている問題）を集計する。

6.1 表示される主な集計

総問題数
言語 × 難易度
例：行=日本語/英語、列=難易度1〜5と合計
作問者 × 難易度
行=作問者（author）、列=難易度1〜5と合計
領域 × 難易度
行=領域名（domain1とdomain2を両方カウント）、列=難易度1〜5と合計

難易度は1〜5で扱う。
過去データ由来で Lv2 のような表記になっていても、内部で 2 に正規化して集計する。

7. よくある運用の流れ

7.1 新しい問題を作るとき

「作問・編集」タブ → モードを「新規作成」にする。
question_id を新規でふる（例: Q2025-210）。
症例問題なら case_id を入れる（例: CASE2025-210）。単問なら空欄でよい。
問題文と選択肢を入力。リッチテキストボタン（B/I/U）や学名挿入を使える。
正解肢にチェック。
保存（新規・更新）→ 新規として登録される。
→ 統計タブにも反映される。

7.2 既存問題を改訂（別IDでR1などをつける）するとき

「問題一覧」タブで該当の問題をクリック → 詳細を確認。
「複製（改訂版作成）」を押すと、作問タブに複製された状態で入る。
モードが「改訂（複製）」になっていることを確認。
question_id を ...R1 のような新IDに変更。
必要な修正を行って「保存（新規・更新）」。
元の問題は残り、新しい問題として一覧に追加される。

7.3 過去問を直接直したい（本当にやむを得ないときだけ）

「問題一覧」→ 問題クリック→「編集」。
モードが「既存編集」になる。
ロック解除ボタンを押す。（警告が出る）
修正する。
「保存（新規・更新）」。
この場合は同じ question_id のまま上書きされる。

基本方針は「既存は残して、改訂版を別IDで作る」。
直接編集は最小限にして、必ず revision_note に理由と日付を書き残す。

8. 注意と推奨事項

question_id は重複禁止。
new / revise モードで同じIDを使うと保存できません。
症例ID (case_id) は症例単位で統一。
連問のときは全問で同じ case_id を入れる。
症例がない単問は case_id を空欄にする。（自動で埋めない）
領域（domain1/domain2）は統計に使われるので、できれば2つまで正確に選ぶ。
学生向け公開前のチェック用に、comment で「この選択肢はひっかけ？」などの設計意図を必ず残す。
解説（explanation）は学生配布にも使える想定。

このツールは「作問の透明化」「改訂の追跡」「出題の再利用性向上」「守り（事故防止）」を目的としています。
運用ルールを守ることで、誰がいつどの問題をどう変えたかが後から追えるようになります。

このツールはChatGPTを用いて作成しています。

試験問題管理ツール 利用ガイド