設計・運用資料(デモ版に付属)

間取り図の類似性評価アンケート — 実現方法のご説明

本資料は、デモで動いている仕組みと、本番環境での構成・運用方法をまとめたものです。ご回答いただいた仕様と、ご提供いただいた実データ(CSV・JSON・画像)を反映しています。

1. ご提供データの確認結果

お送りいただいた RPLAN_triplets(CSV 3,000 行・JSON 3,000 件・画像 9,000 枚)を取り込み、全件を検査しました。デモの本試行には、この実データを使用しています。

項目結果
CSV3,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. 均等化(最優先):出題対象の問題のうち、負荷が最小の問題の中からしか選びません。参加者が何人増えても、各問題の負荷の差は常に 1 以内に保たれます。
  2. 条件比率:最小負荷の問題を持つ条件のうち、その参加者の「目標数までの不足」が最も大きい条件から選びます(N=40 なら a・d・g 各 8 問、b・c・e・f 各 4 問)。
  3. 基準 A の重複回避:同じ条件・同じ負荷の候補の中で、その参加者にまだ出していない anchor_id を優先します。
  4. 重複出題の禁止:その参加者に一度割り当てた問題(中断で解放したものも含む)は、二度と出題しません。

均等化と条件比率が両立しない場面では、均等化を優先します。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 の設定手順

  1. Study の「Study link」に次の URL を登録し、「URL パラメータで ID を記録する」を選択します。
    https://(独自ドメイン)/study?PROLIFIC_PID={{%PROLIFIC_PID%}}&STUDY_ID={{%STUDY_ID%}}&SESSION_ID={{%SESSION_ID%}}
  2. 完了方法は「URL でリダイレクト」を選び、表示される完了 URL(完了コード付き)を管理画面の「調査設定 › 完了時の遷移先 URL」に貼り付けます。
  3. パイロット調査(少人数)で、完了 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 時間以内に返信します。夜間も対応可能です。