設計・運用資料(デモ版に付属)
間取り図の類似性評価アンケート — 実現方法のご説明
本資料は、デモで動いている仕組みと、本番環境での構成・運用方法をまとめたものです。ご回答いただいた仕様と、ご提供いただいた実データ(CSV・JSON・画像)を反映しています。
1. ご提供データの確認結果
お送りいただいた RPLAN_triplets(CSV 3,000 行・JSON 3,000 件・画像 9,000 枚)を取り込み、全件を検査しました。デモの本試行には、この実データを使用しています。
| 項目 | 結果 |
|---|---|
| CSV | 3,000 行。triplet_id の重複・空欄なし。全行で triplet_id の先頭と anchor_id が一致 |
| JSON(補助データ) | 3,000 件。CSV と ID・条件が全件一致。b_source / c_source・距離・順位を CSV 出力の列として追加済み |
| 条件の構成 | a・d・g 各 600 組、b・c・e・f 各 300 組(比率 2:1:1:2:1:1:2 と完全一致)。基準間取り 300 種類 × 各 10 組 |
| 条件の意味(JSON より) | a: 近い/近い、b: 近い/中程度、c: 近い/遠い、d: 中程度/中程度、e: 中程度/遠い、f: 遠い/遠い、g: ランダム/ランダム |
| 画像 | 256×256 の PNG(灰・白・黒の 3 色)。1 枚約 1KB、全体でも 10MB 未満で、容量面の問題はありません |
| 要対応 | 832 枚が 0 バイト(中身が空)。279 組(9.3%)・基準間取り 29 種類分で、ZIP の中でも 0 バイトです。フォルダ名の並び順で 7389_g_1/c.png 以降に集中しているため、画像の書き出し・コピーが途中で止まった可能性があります。取り込み時に自動で検出し、出題対象から除外しています(管理画面の「データ取込・検証」から一覧を CSV で出力できます)。 |
差し替え画像をいただいた場合は、取り込みスクリプトを再実行するだけで反映されます。除外中の問題も自動で出題対象に戻ります。
2. 確定した仕様(ご回答の反映)
| 項目 | 仕様 | デモ |
|---|---|---|
| 回答数の均等化 | 全問題の回答数を可能な限り同数に近づけることを最優先(最新版の割当方式) | 反映済み |
| 中断と再アクセス | ブラウザを閉じた場合・通信が切断された場合とも、未回答の問題を再割当。未完了の参加者は、再アクセス時に回答を引き継いで継続 | 反映済み |
| 明示的な取り消し | 不同意・理解度確認の不合格・本人による参加取消は「取消」として、通信切断・離脱による「中断」と区別して記録し、CSV にも出力 | 反映済み |
| 事後質問の選択肢 | 重複していた「Position of entrance and corridors」を 1 つに統合(追加なし) | 反映済み |
| B・C の表示 | 左=B・右=C で固定し、中身の画像(b_id / c_id)の左右を入れ替え。左右の画像 ID・b_id の位置・選択した画像 ID を記録 | 反映済み |
| 注意力確認 | 不正解でも調査は続行し、合否のみを記録 | 反映済み |
| 練習・注意力確認の画像 | 田端様にご用意いただく画像を使用(デモでは仮画像)。本試行と同じ形式(256×256 PNG、A・B・C の 3 枚 1 組) | 画像待ち |
3. 技術構成と運用費用
| 役割 | 本番環境 | 内容 |
|---|---|---|
| 画面・サーバー処理 | Next.js | 参加者画面・管理画面・API を 1 つのアプリケーションで提供します。 |
| データベース | Supabase(PostgreSQL) | 回答を問題ごとに即時保存します。問題の割当と回答の保存はデータベース側で 1 回の処理(トランザクション)として実行し、同時アクセスでも競合しません。 |
| サーバー・ドメイン | Xserver VPS + 独自ドメイン(HTTPS) | HTTPS 証明書の自動更新、障害時の自動再起動、データの定期バックアップまで設定してお渡しします。日常的なサーバー管理は、ほぼ不要です。 |
| 管理画面 | 同一アプリ内(ログイン必須) | 参加状況・問題別の収集状況の確認、設定変更、一時停止、CSV 出力をブラウザから操作できます。 |
※ このデモは、どなたでもすぐにお試しいただけるよう、データベースに接続せずブラウザ内だけで動作します(回答はご覧のブラウザ内にのみ保存)。割当・保存・中断処理のロジックは本番と同じ仕様です。
納品後の運用費用の目安(開発費には含みません)
| 項目 | 目安 |
|---|---|
| Xserver VPS | 月額 1,000〜2,000 円程度(プラン・契約期間によります) |
| 独自ドメイン | 年額 1,000〜2,000 円程度 |
| Supabase | 想定される回答数であれば無料プランの範囲に収まる見込み |
VPS とドメインは田端様の名義でのご契約をお勧めします(手順はご案内します)。開発期間中のサーバー費用は開発費に含んでいます。
4. 問題割当の仕組み
各問題の「負荷」を 回答確定数 + 現在ほかの参加者に割り当て中の数 として管理し、参加者が本試行を開始した時点で N 問を 1 問ずつ次の優先順位で選びます。
- 均等化(最優先):出題対象の問題のうち、負荷が最小の問題の中からしか選びません。参加者が何人増えても、各問題の負荷の差は常に 1 以内に保たれます。
- 条件比率:最小負荷の問題を持つ条件のうち、その参加者の「目標数までの不足」が最も大きい条件から選びます(N=40 なら a・d・g 各 8 問、b・c・e・f 各 4 問)。
- 基準 A の重複回避:同じ条件・同じ負荷の候補の中で、その参加者にまだ出していない anchor_id を優先します。
- 重複出題の禁止:その参加者に一度割り当てた問題(中断で解放したものも含む)は、二度と出題しません。
均等化と条件比率が両立しない場面では、均等化を優先します。N を変更した場合は、比率 2:1:1:2:1:1:2 に N を掛けて配分し、端数は小数部分の大きい条件から配分します(最大剰余法。同点の条件は参加者ごとにランダムに選ぶため、全体では比率が保たれます)。
画像に問題のある 279 組を除いた 2,721 組でも、除外が各条件にほぼ均等に分散しているため、条件比率を保ったまま割り当てられます。 シミュレーションで検証する →
5. 中断・取消・再アクセス
| 種類 | きっかけ | 検知 | 未回答問題 | 再アクセス時 |
|---|---|---|---|---|
| 中断 | ブラウザの「戻る」操作 | 即時 | 即時に解放し再割当 | 回答を引き継いで継続 |
| 中断 | タブ・ブラウザを閉じる | 即時 | 即時に解放 | 回答を引き継いで継続 |
| 中断 | 通信切断・スリープなど | 15 秒ごとの生存通知が途絶えてから一定時間(初期値 5 分・変更可) | タイムアウト時に解放 | 回答を引き継いで継続 |
| 取消 | 同意しない | 即時 | —(本試行前) | 取消済みと表示し、同意画面からやり直し可能 |
| 取消 | 理解度確認に 2 回失敗 | 即時 | —(本試行前) | 再挑戦不可(Prolific への返却手順を表示) |
| 取消 | 本人による参加取消(画面上部の「Withdraw」) | 即時 | 即時に解放 | 取消済みと表示。誤操作の場合のみ継続可能 |
完了済みの参加者が再アクセスした場合は「既に完了しています」と表示し、再回答を防ぎます(Prolific 側では外部サイトへの再アクセスを防げないため、サイト側で Prolific ID ごとに完了状態を管理します)。
6. 回答保存の確実性
- 回答は「Continue」を押すたびに 1 問ずつ保存し、保存が確認できてから次の問題を表示します。
- 通信エラー時は自動で再送します(画面に「再送中」と表示)。各回答に固有 ID を付けているため、再送で二重に保存されることはありません(デモでは「調査設定 › 通信エラーの模擬」で確認できます)。
- 前の問題への移動・回答の変更は、サーバー側でも拒否します。
- 完了時は、本試行 N 問・注意力確認 2 問・属性質問がすべて保存されていることを検証してから、Prolific の完了 URL へ遷移します。
7. 保存データと CSV
| ファイル | 内容 |
|---|---|
| 全回答(ロング形式) | 全画面の回答を 1 回答 = 1 行で出力。phase・screen_id・item_id で画面と設問を区別 |
| 本試行のみ | triplet_id・Prolific ID で紐付けた分析用データ。左右の画像 ID・b_id の位置・選択画像 ID・回答時間に加え、JSON の補助データ(b_source / c_source、距離、順位、distance_gap)を含む |
| 参加者サマリー | 1 人 = 1 行。終了の種類(completed / cancelled / interrupted)と理由、理解度・注意力確認の合否、事後質問・属性質問 |
| 問題別の回答状況 | 各問題の回答数・予約中の数・除外状態・画像の問題・補助データ |
回答時間は「画像 3 枚の読み込みと描画が完了した時点」から「Continue を押した時点」までをミリ秒単位で記録します。UTF-8(BOM 付き)で出力するため、Excel でも文字化けしません。
8. Prolific の設定手順
- Study の「Study link」に次の URL を登録し、「URL パラメータで ID を記録する」を選択します。
https://(独自ドメイン)/study?PROLIFIC_PID={{%PROLIFIC_PID%}}&STUDY_ID={{%STUDY_ID%}}&SESSION_ID={{%SESSION_ID%}} - 完了方法は「URL でリダイレクト」を選び、表示される完了 URL(完了コード付き)を管理画面の「調査設定 › 完了時の遷移先 URL」に貼り付けます。
- パイロット調査(少人数)で、完了 URL への遷移と CSV の内容を確認してから、本調査の人数を設定します。
9. 運用の流れ
| タイミング | 管理画面での操作 |
|---|---|
| 調査前 | データ取込・検証で画像の問題がないことを確認 → 調査設定で N・完了 URL・タイムアウトを設定 |
| パイロット | 数名で実施 → 参加者一覧・CSV で保存内容と回答時間を確認 → 必要に応じて N やタイムアウトを調整 |
| 本調査中 | ダッシュボードで参加者数・完了率・問題ごとの回答数を確認。問題があれば「一時停止」で新規受付を停止(回答中の参加者はそのまま完了可能) |
| 調査終了後 | CSV 出力から全データをダウンロード |
10. スケジュールと納品後の対応
| 期間 | 内容 |
|---|---|
| 11/10〜11/12 | 本番環境の構築(Xserver VPS・独自ドメイン・HTTPS・Supabase)、実データの取り込み、割当・保存処理のサーバー側の実装 |
| 11/13〜11/16 | 画面の最終調整、管理画面・CSV・Prolific 連携 |
| 11/17〜11/18 | 総合テスト。11/18(水)にご確認用の環境をお渡し |
| 11/19〜11/20 | ご確認内容の反映、操作マニュアルの作成 |
| 11/20(金) | 納品(ソースコード・設定情報・操作マニュアル) |
- 納品後 2 週間(〜12/4)は、不具合の修正と軽微な調整を無償で対応します。この期間にパイロット調査を実施いただければ、結果を踏まえた調整も無償です。
- 仕様変更・機能追加は、内容を伺ったうえで事前にお見積もりします。
- ご連絡には、平日は 2 時間以内、土日は 3 時間以内に返信します。夜間も対応可能です。