Yoko Shiina

画面仕様設計書のサンプル:架空の美術館の「モバイルガイド」

このページでは、架空の美術館で使うモバイルWebガイドの画面仕様設計書を紹介します。社内業務向けのサンプルとしては、1日分のシフトのアップロードのサンプル(1回の操作で1日分のシフトを更新する機能)と、返品・返金の処理のサンプル(複数人が数日かけて対応する業務)もあります。

仕様書には、2種類の補足メモを付けています。

システム側:データ構造や実装上の制約を踏まえ、この設計にした理由。

ユーザーの視点
ユーザーの視点:どこで迷いやすいか、画面ではどう対応するか。

このガイドで実現したいこと

版画、素描、水彩画を中心に扱う美術館のモバイルWebガイドです。来館者は入口のQRコードからガイドを開き、館内で作品を探したり、解説を読んだり、音声ガイドを聴いたり、気になった作品を保存したりします。

同じガイドを帰宅後にも使います。数か月たっているかもしれませんし、別の端末からアクセスするかもしれません。その間に展覧会が終わり、借りていた作品が返却されていることもあります。

設計の中心に置いたのは、来館中に保存した作品を会期終了後も来館記録に残し、画像を掲載できなくなった場合には理由を説明することです。保存した画像がなぜ消えたのか、来館時の展示内容がなぜ現在の展示と異なるのか、来館者が戸惑わないようにしています。

来館中と帰宅後では、求められる使い方が違います。館内では片手で操作し、電波が弱い場所もあり、登録に時間をかけたくありません。帰宅後には、会期を過ぎても記録を振り返り、別の端末からも使いたくなります。そこで、作品はアカウントなしで端末に保存できるようにし、メールアドレスの登録は本人が必要になったときだけ行います。

ユーザーの視点
来館者にとってガイドも美術館のサービスの一部です。保存した画像が説明なく消えれば、美術館が記録を失くしたように感じられます。画像を掲載できない場合や、指定した訪問日に作品が展示されていなかった場合には、作品情報を残したまま、来館者に伝わる言葉で理由を説明します。

題材と前提条件

Northlight Museumは、版画、素描、水彩画を中心とする架空の美術館です。企画展「Under Changing Skies」(2026年9月12日〜2027年1月10日)では、Dawn、Daylight、Weather、Dusk、Nightの五つのテーマ別セクションで一日の空の移り変わりをたどります。各セクションをそれぞれ別の展示室で展開します。セクション名は展示内容を、展示室番号は物理的な場所を示します。所蔵品は主に版画や素描、水彩画などの紙作品です。企画展では所蔵品に加えて、キャンバスや板に描かれた絵画や紙作品も借り受けて展示します。

建物は4フロアです。3階の第1〜第4展示室では、順にDawn、Daylight、Weather、Duskの各セクションを展開します。地下1階の第5展示室ではセクション「Night」を展開し、この場所は電波が届きにくい設定です。企画展全体はこの二つの階にまたがっています。コレクション展示は2階です。作品番号の先頭の数字が展示室番号に対応します。

ガイドは8言語に対応し、英語と日本語の内容はすべて揃えています。このサンプルに掲載する画面デザインは英語版のため、画面内の文言も英語のまま紹介します。

紹介している作品は実在し、公開利用可能な画像を使っています。各作品の展示場所や番号、貸借関係は、この架空の美術館の設定です。

ガイドの利用開始
有効期限のない固定のQRコードを使う。ガイドを開いただけでは訪問記録は作らず、最初に作品を保存した時点で作成する。
初回の表示言語
端末の言語が対応する8言語に含まれていれば、その言語で開く。含まれていない場合は英語。ユーザーが選んだ言語を優先する。
認証コード
6桁で有効期間は10分。同じタブで入力する。新しいコードを発行した時点で古いコードは無効にする。
回数制限
コード1件につき入力を5回まで試せる。新しいコードの発行は1時間に5件まで。
ログイン状態の保持
最終利用から6か月。下部ナビゲーションがある各ページのメニューからログアウトできる。
借用作品の画像
貸出契約に従い、会期中に限って掲載する。端末に保存した画像にも同じ期限を適用する。
著作権で制限される画像
権利者の許可がない画像は掲載せず、その理由を文章で説明する。

画像の掲載条件は架空の設定ですが、貸出作品ごと、展示ごとに掲載許可を取り決めるという美術館の運用を踏まえています。作品を所有していても画像の利用権があるとは限りません。そのため画像の条件は作品そのものではなく、各展示に紐づけて管理します。10分、5回、5件、6か月という数値は、このサンプルのために設定したルールです。

関係する人・組織

来館者は2つの場面でガイドを使います。それとは別に、ガイドを直接使わなくても、表示できる内容を決める立場の人たちがいます。

ガイドを使う

  • 館内で鑑賞する人

    スマートフォンを片手に作品を鑑賞する。通信できない場所もある。作品番号や展示室から作品を探し、解説を読んだり音声を聴いたり、気に入った作品を保存したりする。

  • 来館後に振り返る人

    会期終了後や別の端末から、保存した作品を振り返る。必要に応じてメールアドレスを登録したり、来館日を訂正したりする。

ガイドを使わない

  • 美術館

    どの作品を、どの展示室に、何番のラベルで、いつからいつまで展示するかを公開する。公開済みの展示構成は上書きせず、変更時には新しい版を作る。

  • 作品の貸出元・権利者

    作品画像を掲載できるか、いつまで掲載できるかを決める。ガイドはその条件に従い、必要な説明を来館者に伝える。

館内で使う人と帰宅後に使う人は、同じ来館者です。同じ端末ならそのまま使い続けられます。別の端末から記録を振り返りたい場合は、メールアドレスでログインします。ログインはいつでも選べる任意の操作です。

この仕様書では「訪問」を、同じ美術館で同じ日に行った鑑賞の記録と定義しています。最初に作品を保存した時点で作成し、ログインのセッションやアカウントとは区別します。用語を統一することで、「この訪問に保存する」「2つの訪問を統合する」が画面、データ、APIのどこでも同じ意味になります。

画面の構成

通常の画面では、下部ナビゲーションに「On display」「Number」「Floor plan」「Saved」の4つを表示します。作品を鑑賞しながら頻繁に切り替える画面なので、どれも1回のタップで開けるようにします。

言語、アカウント、ガイドについての情報など、利用頻度の低い項目は、下部ナビゲーションがある画面の右上に置いた「Menu」にまとめます。認証コードの入力や画像の全画面表示など、操作に集中する画面では両方のナビゲーションを隠します。

パンくずリストは使いません。現在地は、下部ナビゲーションの選択状態、戻り先を示すリンク、セクションと作品の展示場所を示す色付きの帯という3つの手掛かりで伝えます。

開始画面。「On display today」と日付、企画展「Under Changing Skies」とコレクション展示のカード、作品番号入力とフロアマップへのボタンを配置。
01 開始画面最初に現在の展示を案内する。QRコードを読み取った人は展示を見始めたいので、歓迎メッセージは置かない。
「Under Changing Skies」の作品一覧。セクション「Dawn」と展示階を示す帯があり、正方形の台紙に作品を2列で並べている。
02 作品一覧作品を展示室ごとにまとめ、各グループの冒頭に対応するセクションの色を使った帯を設け、セクション名と階を表示する。そのグループの作品をスクロールしている間、帯を画面上部に固定する。作品画像は正方形の台紙に縦横比を保って収め、切り取らない。
歌川広重「八ツ見のはし」の作品詳細画面。縦長の版画を台紙の上に全体表示し、下に作品番号、タイトル、作家名、保存ボタンを並べている。
03 作品詳細縦長の作品は表示の高さを抑え、最初の画面に作品番号、タイトル、作家名が収まるようにする。保存ボタンはキャプションのすぐ下に置く。
展覧会終了後の2026年10月27日(火)の訪問記録。保存作品が3点あり、1点は画像のない台紙に「Image shown during the exhibition only」と表示。来館当日に各展示室で展示されていた作品へのリンクもある。
04 会期終了後の訪問記録訪問記録には、来館当日にどの作品をどの展示室に、何番・どの順序で展示していたかという展示構成を残す。借用作品も情報は残し、画像は会期中だけ掲載していたことを伝える。

Figmaでは7つのセクションに分けて44画面を制作し、ライトモードとダークモードの色も定義しています。このページでは主な4画面を紹介し、全画面はFigmaに掲載しています。

利用の流れ

ガイドの利用を7段階に整理しました。最初の4段階は来館中に、最後の2段階は主に来館後に行います。メールアドレスの登録は任意で、館内でも帰宅後でも行えます。それぞれの段階について、迷いやすい点とその対応を対にして示しています。

ガイドを開く

操作する人
館内で鑑賞する人
迷いやすい点
QRコードを読み取ってから展示を見るまでに、会員登録やアプリのダウンロードを求められる。
ガイドでの対応
初めて開いたときは、端末の言語に合わせて現在の展示を案内する。以前に言語を選んでいれば、その設定を優先する。登録や入力は求めず、訪問記録も作らない。

作品を探す

操作する人
館内で鑑賞する人
迷いやすい点
壁のラベルにある番号から、作品の解説ページへどう進めばよいか分からない。スマートフォンで番号を最後まで入力するのも手間がかかる。
ガイドでの対応
作品番号を1桁入力した時点で、その展示室の作品を候補として表示する。作品ページを開くのは来館者が候補を選んだときだけなので、入力ミスで別の作品へ移動しない。作品一覧とフロアマップからも同じ解説ページへ進める。

作品を見る・解説を聴く

操作する人
館内で鑑賞する人
迷いやすい点
画像が枠に合わせて切り取られる。作品の情報が画面の下に追いやられる。通信できない展示室では音声が再生されない。
ガイドでの対応
作品画像は台紙の上に縦横比を保って表示する。縦長の作品は表示の高さを抑え、最初の画面に作品名が入るようにする。読み込み済みの文章はオフラインでも読める。音声には通信が必要なことを明示する。

作品を保存する

操作する人
館内で鑑賞する人
迷いやすい点
保存するためにアカウント登録が必要だったり、保存した作品がどこに残るのか分からなかったりする。
ガイドでの対応
アカウントがなくてもすぐに保存でき、画面には「Saved on this device」と表示する。最初の保存時に限り、メールアドレスを登録するとほかの端末でも使えることを一度だけ案内する。

メールアドレスを登録する(任意)

操作する人
館内で鑑賞する人・来館後に振り返る人
迷いやすい点
本人確認前に「登録済み」と表示され、第三者にも登録状況が分かってしまう。認証メールのリンクが別のブラウザで開き、元のブラウザに保存した作品を引き継げないこともある。
ガイドでの対応
初めて使う人も以前利用した人も、同じ手順で、元のタブに6桁のコードを入力する。確認後には、保存した作品がそのまま残ったのか、既存のアカウントに追加されたのか、別の端末で記録した同じ日の訪問に統合されたのかを伝える。

保存した作品を振り返る

操作する人
来館後に振り返る人
迷いやすい点
保存したはずの作品が見当たらない、展示室ごとに表示される作品が来館当日の記憶と違うなど、記録と実際の鑑賞体験が結びつかない。
ガイドでの対応
ログイン前の「Saved」には、このブラウザに保存した作品を表示する。ログイン後は端末を問わず、日付ごとの訪問記録を表示する。各記録には保存作品と、来館当日に各展示室で展示されていた作品へのリンクがあり、その画面で新たに保存した作品も同じ訪問記録に追加される。

展覧会が終わった後

操作する人
来館後に振り返る人
迷いやすい点
借用作品の画像が説明なく消え、保存に失敗したのではないかと思ってしまう。
ガイドでの対応
作品そのものの記録と情報は残す。画像のあった場所に、展示期間中に限って掲載していたことを説明する。

作品の閲覧と保存にアカウントは必要ありません。ログイン前はこの端末のブラウザに保存し、ログインすると日付ごとの訪問記録としてアカウントに引き継ぎます。別の端末からも記録を振り返れます。館内での操作を短くし、ログインに問題が起きても作品鑑賞を妨げない構成です。

ユーザーの視点
戸惑いやすいのは、むしろ帰宅後、別端末で開いたときや会期が終わった後です。そのため、利用の流れを館内だけで終わらせず、後半の2段階にも前半と同じように注意を払っています。

作品画像・通知・操作ボタンの設計

来館者がガイドを開く目的は作品を見ること。そこで、紙作品を展示するときのように台紙を敷き、画像の縦横比を保って表示します。通知は、操作が必要な場合を除いて控えめにします。

作品画像

一覧では正方形の台紙を同じ大きさで並べ、その内側に縦横比を保って作品画像を収めます。画像を切り取らないので、縦長と横長の作品が混ざっても整然と並びます。

作品詳細では、基本的に画面幅いっぱいに画像を表示します。その幅で高さが440pxを超える縦長の作品は、高さ440pxに収めて台紙の中央に配置します。一般的なスマートフォンなら、最初の画面に作品番号、タイトル、作家名まで収まります。

画像を掲載できない場合も台紙は残し、代わりに理由を表示します。何もない枠だけでは、読み込みに失敗したように見えてしまうためです。

通知の種類

種類使用する場面
エラー認証コードの不一致や該当しない作品番号など、入力の修正が必要な場合。アイコンと文章、エラー色で伝え、入力済みの値は消さない。
情報誤りではないが知っておいてほしいこと。例えば解説が英語だけの場合や、画像の掲載が会期中に限られていた場合。灰色の文章で知らせ、読み上げは一度だけ行う。解説の上など独立した案内には情報アイコンを添える。
通信状態通信が切れた場合と復旧した場合。画面上部のバーの下に、引き続きできることを先に伝える案内を出し、一度だけ読み上げる。復旧時は「Back online」を短時間表示する。
操作結果の通知保存完了やログアウトなど、操作の結果を確認してもらう場合。「Saved on this device」「You have signed out.」などの短い文を、操作した場所の近くに表示する。
確認が必要な選択未送信の変更を残したままログアウトするなど、取り消せない選択をするとき。何が失われるかを先に説明するダイアログを表示し、その後に選択ボタンを置く。

色だけで状態を伝えないようにします。どの通知にも内容が分かる文章を付け、エラーと通信状態にはアイコンも使います。セクションを色で区別する場合も、必ずセクション名を併記します。

操作ボタンの使い分け

操作の種類表示方法理由
画面の主な操作プルシアンブルーの塗りつぶし画面ごとに主なボタンを一つに絞り、次の操作を見つけやすくします。例えば「Send code」「Combine visits」。
作品の保存キャプションの下にトグルボタンを置く。保存前は枠線のみ、保存後は塗りつぶしにし、保存先もラベルで示す。保存は頻繁に行い、簡単に取り消せる操作です。そのため保存前は控えめにし、保存後は色とラベルで保存できたことと保存先を確認できるようにします。
メールアドレスの登録・ログイン枠線のみ登録は任意の選択肢です。塗りつぶしのボタンにすると、次に進むための必須操作に見えてしまいます。
結果を伴う操作ボタン名に結果を明記する「Save date」ではなく「Combine visits」、「Sign out」ではなく「Sign out and remove it」とします。押す前に何が起きるかが分かります。
取り消せない損失を伴う操作エラー色の枠線のみ。主な操作にはしない。ログアウトの確認画面では「Stay signed in」を主なボタンにし、未送信の変更を失う操作は明確に選んでもらいます。
現在は実行できない操作使えない状態で表示し、その理由をそばに添える音声の再生と来館日の変更には通信が必要です。操作を隠すのではなく、なぜ今使えないか、接続すれば使えることを伝えます。

枠線は押せる要素と画像に使い、普通の文章は余白や区切り線、背景の違いで整理します。

操作に使う色はプルシアンブルーだけです。18世紀のヨーロッパで生まれた顔料で、後に北斎や広重も空や水の表現に使いました。セクションの色はテーマ別セクションを識別するために使い、フロアマップでは対応する展示室にも同じ色を使います。操作や状態の表示には使いません。

ユーザーの視点
暗い展示室で明るい画面を開くと、周囲の人の視界にも入ります。通知は控えめにし、端末の設定に合わせたダークモードと暗い背景の全画面ビューアを用意して、画面が作品より目立たないようにします。

状態の設計

ここでは、保存した作品の状態と、作品画像の掲載状態を図にまとめました。画面に表示する名称と仕様書の用語を対応させています。

作品の保存状態

未保存この端末に保存済みアカウントに未反映保存済み

作品画像の掲載状態

画像を表示掲載期間終了画像非掲載

両矢印は双方向に遷移することを示します。各遷移が起きる条件は、以下にまとめています。

サーバー上の保存状態は、リクエストが届いた順番では決めません。同じ端末では操作の順番を、端末間では後から行われた操作を優先します。そのため、アカウントへの反映待ちから「保存済み」「未保存」のどちらに変わる場合でも、画面上で作品が不意に戻ったように見えることを防げます。

ユーザーの視点
「Saved on this device」と「Saved」を使い分けるのは意図的です。ログイン前の保存先は、この端末のブラウザだけです。ブラウザのデータを削除したり、別の端末へ移ったりする前に、その違いが分かるようにしています。

状態と遷移条件の一覧

作品の保存状態

  • 未保存NOT_SAVED
    画面での表示
    "Save this work"
    遷移先
    • この端末に保存済み (ログイン前に保存する)
    • 保存済み (ログイン中、オンラインで保存する)
    • アカウントに未反映 (ログイン中、オフラインで保存する)
  • この端末に保存済みON_DEVICE
    画面での表示
    "Saved on this device"
    遷移先
    • 保存済み (ログインして作品をアカウントへ追加する)
    • 未保存 (保存を解除する)
  • アカウントに未反映NOT_YET_ADDED
    画面での表示
    「Saved」、訪問記録では「Not yet added to your account」
    遷移先
    • 保存済み (通信が戻り、変更の送信が完了する)
    • 未保存 (送信前に保存を解除する)
    • 未保存 (ログアウトし、未送信の変更を破棄する)
  • 保存済みSAVED
    画面での表示
    "Saved"
    遷移先
    • 未保存 (保存を解除する。オフラインでは画面をすぐ更新し、解除操作は後から送信する。)
    • 未保存 (別端末で後から行われた解除が適用される)

作品画像の掲載状態

  • 画像を表示SHOWN
    画面での表示
    台紙の上に作品画像を表示
    遷移先
    • 掲載期間終了 (貸出契約で定めた画像掲載期間が終了する。オンラインでも端末保存の画像でも同じ。)
  • 掲載期間終了PERIOD_ENDED
    画面での表示
    画像を表示しない台紙に「The image of this work was shown during the exhibition only.」と表示
  • 画像非掲載NOT_SHOWN
    画面での表示
    画像を表示しない台紙に「This work is still in copyright, and the guide does not show an image of it.」と表示。会期中は作品の展示場所も案内する。

画像の掲載状態が変わっても、作品名、キャプション、解説、音声、書き起こしの情報は残します。音声の再生には通信が必要です。画像を掲載しない作品は、権利者の許可が得られない限り非掲載のままです。同じ作品でも次の貸出時には別の掲載条件を設定します。

例外的なケース

例外ケースは、原因ごとに分類しています。それぞれについて、画面に何を表示するか、システムがどう処理するか、その理由、ユーザーにとっての意味、次にできる操作を記録しました。

このガイドは来館者が一人で操作するため、返品・返金のサンプルにある「引き受ける人」の項目は設けていません。その代わり、各ケースの最後に来館者が次にできることを記しています。

Aアカウント登録前の保存

作品はまずブラウザに保存し、アカウントの登録は後から選べるようにする。その切り替えを安全に行うためのケース。

6件
A1

メールアドレスを登録する前に保存する

画面での表示
「Saved on this device」と表示。最初の保存時だけ「To see your saved works later, or on another device, you can add your email address.」と案内する。
システムの処理
作品はすぐにこのブラウザへ保存する。登録の案内は最初の一度だけとし、「Saved」にはいつでもメールアドレスを登録できる入口を残す。
判断の理由
作品を鑑賞しているときにアカウント登録を必須にすると、保存を諦める人もいる。「on this device」と示し、どこに保存したかを明らかにする。
ユーザーの視点
毎回登録を勧めると、任意の機能なのに必須のように感じられる。一度知らせれば、選択肢があることは伝わる。
次にできること
そのまま保存を続ける。メールアドレスは後からいつでも「Saved」で登録できる。
A2

以前にもガイドを使ったメールアドレス

画面での表示
どのメールアドレスでも同じ入力画面と認証コード画面を使う。コードの確認後に「Welcome back」と表示する。
システムの処理
コードの確認前には登録済みかどうかを示さない。確認が終わってから完了画面を決定する。
判断の理由
メールアドレスによって反応を変えると、他人がそのアドレスの利用履歴を調べられてしまう。
ユーザーの視点
過去に登録したかどうかを覚えていなくても、同じ手順で進められる。
次にできること
コードを入力する。以前の訪問記録も今日の記録と一緒に表示される。
A3

メールで認証コードを受け取る

画面での表示
「Keep this page open while you check your email.」と案内し、6桁の数字を入力する欄を一つ置く。
システムの処理
受け取ったコードは、元のページと同じタブで入力する。一つの入力欄で、貼り付けとワンタイムコードの自動入力に対応する。
判断の理由
メール内のリンクは、メールアプリ内のブラウザなど別の環境で開く場合がある。そこからは元のブラウザに保存した作品を参照できない。
ユーザーの視点
スマートフォンでアプリを切り替えると、元のページに戻れなくなることがあるため、戻って入力するよう案内する。
次にできること
コードをコピーするか入力して、元のページで認証する。
A4

認証コードが使えない

画面での表示
コードが違う場合は入力欄の上にエラーを出し、入力値を残す。期限切れや試行回数の上限に達した場合は、見出しを「Get a new code」に変えて入力欄を隠す。再送の回数制限では「Try again at 15:42」と表示する。
システムの処理
一致しないコードは修正できるよう入力欄を残す。期限切れや使用停止になったコードには再入力させない。次のコードを請求できる時刻を表示する。
判断の理由
見出しで、いま必要な操作を伝える。「後で」より具体的な時刻の方が分かりやすい。
ユーザーの視点
この間も作品の保存データは端末に残るため、そのことを画面に明示する。
次にできること
コードを修正する、新しいコードを請求する、表示された時刻に試す。
A5

同じ日の訪問記録が2つの端末にある

画面での表示
コード確認後に「Welcome back」と表示。同じ日付の既存の訪問記録へ保存作品を追加する。
システムの処理
端末とアカウントの訪問記録を、美術館と日付で照合する。両方にある作品は重複させず一件にまとめる。引き継ぐのは現在保存されている作品だけで、端末側で過去に解除した履歴は送らない。
判断の理由
一度の訪問は、同じ美術館の同じ日付の記録として扱う。別々に残すと一度の訪問が分割され、古い解除履歴を送ると別の端末で保存した作品まで消してしまうおそれがある。
ユーザーの視点
どちらの端末で保存しても、その日の作品を一つの訪問記録にまとめて確認できる。
次にできること
追加の操作は不要。記録をそのまま確認できる。
A6

ログイン処理の応答が届かない

画面での表示
認証コードの画面にとどまり、入力したコードを残して、応答を受信できなかったことを知らせる。再送しても、同じ完了結果に進む。
システムの処理
リクエストに端末で生成したIDを付ける。コードの有効期間である10分以内に再送した場合は、初回の処理結果を返し、同じ保存作品を重複して追加しない。応答を受け取るまでは端末の保存データを保持する。
判断の理由
スマートフォンに結果が届かなくても、サーバー側ではログイン処理が完了している可能性がある。
ユーザーの視点
もう一度ボタンを押すのは自然な行動なので、繰り返しても安全な処理にする。
次にできること
同じボタンをもう一度押す。

O通信できないとき

セクション「Night」を展示する第5展示室は地下1階にあり、電波が弱い。通信がなくても解説を読んだり作品を保存したりでき、後からアカウントへ正しい状態で反映できるようにする。

6件
O1

オフラインで作品を開く

画面での表示
上部バーの下に「No connection. You can keep browsing and saving works. Audio will play again when you are back online.」と表示。音声は「Audio needs a connection」とし、代わりに「Read the transcript (available offline)」のリンクを示す。
システムの処理
読み込みが終わった作品は通常どおり開く。通知ではまず利用できる機能を伝え、読み上げは一度だけにする。音声は再生できないことを示し、書き起こしへ案内する。
判断の理由
ガイドを開いた後、当日の展示の解説文と軽量画像をバックグラウンドで読み込む。音声は事前取得せず、ガイドを開くだけで大量のモバイル通信が発生しないようにする。
ユーザーの視点
通信が切れても、ガイド全体が使えなくなったわけではないと分かるようにする。音声の内容も書き起こしで確認できる。
次にできること
書き起こしを読むか、電波が届く場所へ移動して音声を再生する。
O2

ログイン中、オフラインで作品を保存する

画面での表示
「Saved」と表示し、その下に「It will be added to your account when you are back online.」を一度だけ出す。訪問記録には時計アイコンと「Not yet added to your account」を表示する。
システムの処理
作品は端末に保存し、通信復旧時、ガイドを再び開いたとき、または後の再試行でアカウントへ送る。「Saved」の件数にはすぐに含める。
判断の理由
保存の操作は完了しているので「Saved」と表示する。まだ終わっていないのは、アカウントへの反映だけ。
ユーザーの視点
説明がないと、別の端末に表示されるまで時間がかかったとき、保存できていないように思われる。
次にできること
操作は不要。通信できるようになれば送信する。
O3

オフラインで保存してから解除する

画面での表示
ボタンをすぐに「Save this work」に戻す。
システムの処理
保存と解除を端末内で通し番号を付け、操作順に記録する。送信時は、時刻が同じでも端末の時計が変更されていても、最後の操作を優先する。
判断の理由
同じ端末で続けて行った操作は、時刻だけでは順序を判定できない場合がある。
ユーザーの視点
来館者の最後の操作を優先する。解除した作品が勝手に復活することはない。
次にできること
追加の操作は不要。
O4

未送信の変更を残してログインの有効期間が終了する

画面での表示
「Saved」に「Your sign-in has ended. 1 change on this device has not been added to your account yet. Sign in with name@example.com to add it.」と表示。「Sign in」はこの画面とメニューの両方に置く。
システムの処理
未送信の変更は、操作時にログインしていたアカウントに紐づく。同じアカウントへログインし直した場合に限って送信し、別のメールアドレスでは送らない。
判断の理由
共用端末で、一人の保存作品が別の人のアカウントへ混ざらないようにする。
ユーザーの視点
ログイン期限が切れても、未送信の変更そのものは失われない。
次にできること
同じメールアドレスで再度ログインする。
O5

未送信の変更を残してログアウトする

画面での表示
「Sign out?」のダイアログに「Nocturne: Palaces has not been added to your account yet. It will be added when you are back online. If you sign out now, it will be removed from this device, together with your other saved works and visits.」と表示。ボタンは「Stay signed in」「Sign out and remove it」。
システムの処理
保存も解除も未送信の変更として扱い、状況に応じて確認文を変える。主な選択肢はログインを続けること。ログアウトを選ぶと、アカウントに紐づくデータと未送信の変更を端末から削除する。
判断の理由
共用端末では、ログアウト後にアカウントのデータを残してはいけない。一方、未送信の変更が消えるなら、本人に知らせず消してはいけない。
ユーザーの視点
失う情報を理解したうえで、来館者が選択できる。
次にできること
オンラインに戻るまでログインを続けるか、未送信の変更を破棄してログアウトする。
O6

オフラインで来館日を変更する

画面での表示
「Changing the date needs a connection」と理由を表示し、日付入力欄と変更ボタンを操作できない状態にする。
システムの処理
記録は変更しない。通信できる場合は、その訪問記録の未送信変更を先に送ってから日付を更新する。
判断の理由
変更後の日付の展示内容を確認し、同じ日付に別の訪問記録があるか調べるには、サーバーへの接続が必要。
ユーザーの視点
なぜ操作できないかを説明し、通信障害による誤動作ではないと伝える。訪問記録と保存作品はそのまま残る。
次にできること
オンラインに戻ってから日付を変更する。

T時間の経過に伴う変化

会期が終わり、展示構成が変わり、貸出条件にも期限がある。訪問記録には当日の展示を残し、表示できなくなった情報には理由を添える。

5件
T1

借用作品の画像掲載期間が終わる

画面での表示
訪問記録では画像のない台紙に「Image shown during the exhibition only」と表示。作品詳細では「The image of this work was shown during the exhibition only.」と説明する。
システムの処理
サーバーはリクエストのたびに画像掲載の可否を判定する。端末に保存した画像にも掲載期限を持たせ、オフラインでも期限後は表示しない。再接続時に画像データを削除する。作品名、キャプション、解説、音声、書き起こしは残す。
判断の理由
掲載期限は貸出契約で決まる。作品の記録ごと消すと来館者の思い出が失われ、画像を残すと契約に違反する。
ユーザーの視点
画像の代わりに理由を表示すれば、読み込み不良や保存ミスではなく、掲載条件によるものだと理解できる。
次にできること
作品の解説を読み、音声を聴く。
T2

著作権のある作品

画面での表示
会期中は「This work is still in copyright, and the guide does not show an image of it.」と「You can see it in Room 4, second floor.」を表示。会期終了後は最初の文だけを残す。
システムの処理
台紙には画像を置かず、理由を表示する。画像の全画面表示も開かない。
判断の理由
権利者から画像の掲載許可を得ていない。会期中は作品の実物がある展示室を案内する。
ユーザーの視点
作品ページには画像があると考える人が多いので、理由を先に伝える。
次にできること
会期中は第4展示室で実物を鑑賞する。作品の解説はいつでも読める。
T3

過去の訪問に当日の展示構成を表示する

画面での表示
「Find other works from this visit」には、来館当日に使われていた展示室を、対応するセクション名と色で示し、「as the exhibition was arranged on the day of your visit」と案内する。展示室を選んで当日の作品一覧を開くと「As arranged on your visit, Tuesday 27 October 2026」と表示し、その訪問で保存した作品には「Saved in this visit」と示す。
システムの処理
公開済みの展示構成の版は変更せず、来館日から企画展とコレクション展示の該当する版を選ぶ。「On display」「Number」「Floor plan」は常に現在の展示を表示する。過去の訪問から保存すると、その訪問記録に作品を加える。
判断の理由
来館者は作品を見た展示室と結びつけて覚えている。展示替えによって過去の訪問記録が変わってはいけない。
ユーザーの視点
現在の展示と過去の訪問では似た画面を使う。戻るリンクに来館日を示し、ナビゲーションでは「Saved」を選択状態に保って、どちらの画面を開いているか分かるようにする。
次にできること
来館当日に各展示室で展示されていた作品を振り返り、そのとき保存しなかった作品も追加できる。
T4

保存した作品が展示されていなかった日付へ変更する

画面での表示
選択した日付の展示を「On this day」で示し、保存作品がその日には展示されていなかったことを警告する。変更後は該当作品に「Not on display on this day」と表示する。
システムの処理
日付の変更は許可し、保存作品は訪問記録に残す。
判断の理由
保存作品は来館者が残した記録なので、日付変更だけで削除しない。元の展示データが誤っていた場合、変更自体を禁止すると訂正できなくなる。
ユーザーの視点
警告によって日付を確認する機会を設けるが、最終判断は来館者に任せる。
次にできること
その日付のまま確定するか、別の日付を選ぶ。
T5

同じ日付の訪問記録が2つある

画面での表示
「You already have a visit on this day」と表示し、各記録の保存作品数と統合後の件数、「This cannot be undone.」を示す。ボタンは「Combine visits」、中止リンクは「Keep Wednesday 28 October 2026」。
システムの処理
その訪問記録に未送信の変更があれば、先に送信する。確認画面は両方の記録のその時点の状態に対応する。途中でどちらかが変わった場合は統合せず、新しい件数を示して再確認する。
判断の理由
訪問記録は最初の保存日に作られるため、帰宅翌日に現在の展示から作品を保存すると別の日の記録になる。一方、過去の訪問画面から保存すれば元の記録に加わる。統合は取り消せないため、結果を正確に示して確認を求める。
ユーザーの視点
日付が分かれた理由も説明し、なぜ2つの訪問記録があるのか分かるようにする。
次にできること
記録を統合するか、元の日付を維持する。

言語とアクセシビリティ

来館者はさまざまな国や地域から訪れます。暗い展示室で片手で操作する人も、スクリーンリーダーを使う人もいます。以下のルールはガイド全体に適用します。

言語

  • 端末の言語が対応する8言語のいずれかなら、その言語で開きます。それ以外は英語です。言語はどのページからもメニューで変更でき、文字を読めなくても見つけられるよう、言語の項目には地球儀のアイコンを付けています。
  • 言語の選択肢は、それぞれの言語で書きます。英語しか用意していない解説がある場合は、その注意書きを選択肢の言語で表示します。読む人が理解できる形で案内するためです。
  • 未翻訳の項目は英語で表示し、画面の使用言語で灰色の案内を添えます。例えばイタリア語版なら「Questa descrizione è disponibile solo in inglese.」。音声の再生時間にも「In inglese, 2 min 20 s」と示し、再生前に英語音声だと分かるようにします。
  • 画面の言語と異なる言語の文章には、その言語コードを設定します。スクリーンリーダーが正しい発音で読み上げるためです。
  • 数値、日付、階数も言語に合わせます。例えばイタリア語の寸法は「81,6 × 93 cm」。階数は数値の階層として保持し、英語のsecond floorは日本語で「3階」と表示します。
  • 日本語では肯定形の文を使い、所蔵先の表示は「〜蔵」とするなど、美術館の作品ラベルの表記に合わせます。タイトルや作家名は意味の区切りで改行し、語や名前の途中では切らないようにします。

アクセシビリティ

  • 状態は色だけに頼らずに伝えます。セクションの色には必ずセクション名を添え、エラーには色に加えてアイコンと文章を使います。
  • すべての音声に書き起こしを用意します。一度開いた書き起こしは、その端末では別の作品でも開いた状態を保ちます。
  • 作品番号を最後まで入力しても、勝手にページを切り替えません。検索候補の件数など、一覧の変化は入力欄のフォーカスを動かさず、控えめに読み上げます。
  • フロアマップと同じ情報を、展示室の一覧でも提供します。
  • 画像の拡大縮小は、2本指の操作だけでなく、ボタンを1回ずつ押す方法にも対応します。
  • ダイアログを開いたら見出しにフォーカスを移し、閉じるまでダイアログ内に保ちます。変更せずに閉じた場合は、開く前のボタンへ戻します。ログアウト後は次の画面の「Saved works」見出しへ移します。「Top」でページ先頭に戻るときも、最初の見出しにフォーカスを移します。
  • 文字はブラウザの拡大設定に追従し、大きく表示してもレイアウトが崩れないようにします。
  • ダークモードは端末の設定に従います。専用の色を定義し、コントラストを確認しています。

ガイドは位置情報を使わないため、来館者がセクション「Night」を展示する暗い第5展示室にいるのか、自宅にいるのか判定できません。ダークモードは端末の設定に合わせ、展示室によって表示を切り替えることはしません。

ユーザーの視点
イタリア語で読む人が、長い英語の解説を途中まで読んだり、再生ボタンを押したりしてから、初めて英語だと気づくことのないようにします。読む前・聴く前に言語を伝えるのは、ユーザーの時間を大切にするためです。

APIの仕様

以下の7つは、画面に必要な範囲に絞って検討したAPIの仕様案です。展示や作品の情報は全来館者に共通で、/api/museumsと/api/worksから取得します。訪問記録や保存情報はアカウント固有のため、/api/meから取得します。

まずフロントエンド側で、各画面にいつ、どんなデータが必要かを整理します。バックエンド側が返せる内容を提案し、それを画面でどう扱うかを検討します。各エンドポイントには、その検討過程を記録しています。

画像の掲載可否は、リクエスト時にサーバーが判定します。画面には「shown」または「not shown」と理由・掲載期限を返し、表示する説明文を画面側で選びます。貸出条件と著作権の情報はサーバー側で管理するため、条件が変わってもガイドの再リリースは不要です。未翻訳の文章は言語コード付きの英語で返し、日付は美術館のタイムゾーンの暦日、時刻はUTCで扱います。

1フロントエンドからの要望

2バックエンドからの提案

3決定した仕様

1. 指定日の展示情報を取得する

GET /api/museums/northlight/displays?date=2026-10-27&lang=en
1

開始画面、作品一覧、作品番号検索、フロアマップ、過去の訪問から開く作品一覧、来館日の変更プレビューでは、現在または過去の指定日に展示されていた作品を同じ形式で取得する必要がある。作品番号検索はオフラインでも使うため、一覧全体をまとめて取得する。

2

公開した展示構成の版は変更しないため、指定日の作品配置は確定している。一方、画像を表示できるかどうかはリクエスト時点で決まる。一度に展示する作品は数十点なので、レスポンスは大きくならない。

3

日付を指定するエンドポイントを一つ設ける。dateで展示構成を選び、画像の掲載可否はリクエスト時点で判定する。キャッシュは可能だが、含まれる画像のshownUntilのうち最も早い期限を超えて保持しない。

レスポンス形式
{
  "date": "2026-10-27",
  "floors": [{ "level": 2, "name": "Second floor", "short": "2" }],
  "displays": [
    {
      "type": "exhibition",
      "id": "under-changing-skies",
      "title": { "text": "Under Changing Skies", "lang": "en" },
      "from": "2026-09-12",
      "to": "2027-01-10",
      "rooms": [
        {
          "room": 1, "section": "dawn", "sectionName": "Dawn", "level": 2,
          "works": [
            {
              "workId": "w_monet_1897",
              "labelNumber": "105",
              "title": { "text": "Morning on the Seine near Giverny", "lang": "en" },
              "artist": "Claude Monet",
              "image": { "state": "shown", "thumbnail": "https://…", "shownUntil": "2027-01-10T23:00:00Z" }
            }
          ]
        }
      ]
    },
    { "type": "collection", "id": "prints-and-drawings", "rooms": [] }
  ]
}

現在の展示情報を取得した後、各作品の詳細(2)と軽量画像をバックグラウンドで読み込む。オフラインで利用できるのは読み込みが完了したものだけ。音声や過去の訪問日の展示は先読みしない。

image.stateはshownまたはnot_shown。not_shownの場合はreasonにcopyright、loan_period_ended、artist_wishのいずれかが入り、画面はその理由に応じた文言を表示する。

作品番号の検索は端末側でこのレスポンスを使って行う。オフラインでも動作するので、検索専用のエンドポイントは設けない。

展示構成の版(Display version)は、企画展またはコレクション展示について、ある期間の作品、展示室への割り当て、作品番号、展示順序を記録する。

各展示室のデータでは、roomは物理的な展示室番号、sectionはテーマ別セクションの識別子、sectionNameはその表示名、levelは階の数値を表す。階のデータにあるnameは階の名称を表す。

2. 作品情報を取得する

GET /api/works/w_monet_1897?lang=it&date=2026-10-27
1

作品のキャプション、解説、音声、書き起こし、画像に加え、指定日にどこに展示されていたかを取得したい。イタリア語版では、どの項目が英語しかないのかも判定する必要がある。来館日を展示されていなかった日に変更しても、保存した作品の詳細は開けなければならない。

2

文章は項目と言語ごとに保持し、展示場所は指定日に有効な展示構成の版から取得する。

3

各テキスト項目にlangを付ける。その日に展示されていなければplacementはnullとするが、作品自体の情報は返す。

レスポンス形式
{
  "workId": "w_monet_1897",
  "title": { "text": "Mattino sulla Senna vicino a Giverny", "lang": "it" },
  "artist": "Claude Monet",
  "date": "1897",
  "medium": { "text": "Olio su tela", "lang": "it" },
  "dimensions": { "heightCm": 81.6, "widthCm": 93 },
  "credit": { "type": "loan", "text": "…", "lang": "it" },
  "placement": { "labelNumber": "105", "room": 1, "section": "dawn", "level": 2 },
  "image": { "state": "shown", "url": "https://…", "zoomUrl": "https://…", "shownUntil": "2027-01-10T23:00:00Z" },
  "description": { "text": "…", "lang": "en" },
  "audio": { "title": { "text": "…", "lang": "en" }, "url": "https://…", "seconds": 140 },
  "transcript": { "text": "…", "lang": "en" }
}

寸法は数値で返し、表示時に言語に応じて整形する(イタリア語では81,6 × 93 cm)。

placementがnullの場合、訪問記録では「Not on display on this day」と表示する。

3. 認証コードを送る

POST /api/auth/codes

{ "email": "name@example.com" }
1

初回利用か再訪かを外部に知られないよう、どちらも同じ手順でコードを送る。1時間あたりの送信上限に達した場合は、次に請求できる時刻を示す必要がある。

2

どのメールアドレスにもコードを送信でき、アドレスごとに請求回数を数えられる。

3

アドレスに関係なく通常は同じ202を返す。上限に達した場合のみ429とretryAtを返す。新しいコードを発行すると、以前のコードは無効になる。

レスポンス形式一覧

202 — 送信済み

{ "result": "sent", "expiresAt": "2026-10-27T14:20:00Z" }

429 — 送信回数の上限

{ "result": "rejected", "code": "CODE_LIMIT_REACHED", "retryAt": "2026-10-27T14:42:00Z" }

画面ではretryAtを現地時刻に直し、「Try again at 15:42」と表示する。

ニュース配信のチェック状態はここでは送らない。4を参照。

4. コードを確認し、ログインと保存作品の引き継ぎを行う

POST /api/auth/codes/verify

{
  "requestId": "c3a1…",
  "email": "name@example.com",
  "code": "482915",
  "news": false,
  "carryOver": [
    { "visitId": "v_7f3a", "museumId": "northlight", "date": "2026-10-27",
      "workIds": ["w_monet_1897", "w_hiroshige_1856", "w_whistler_1880"] }
  ]
}
1

認証後の完了画面には3つのパターンがある。応答が届かなかった場合も含め、端末の保存作品を消失・重複させずにアカウントへ引き継ぐ必要がある。

2

ログインと保存作品の引き継ぎは一つのトランザクションにでき、コードの有効期間中はそのリクエストの結果を保持できる。

3

両方を一つのリクエストで処理する。ログインだけ成功して作品が引き継がれない状態を作らず、一つの応答で完了画面を決められる。端末はコード入力時にrequestIdを生成し、再送時にも同じ値を使う。有効期間の10分以内でアドレス・コード・requestIdが同じなら、初回の結果を返して重複処理を防ぐ。応答を受け取るまで端末の保存作品は消さない。

レスポンス形式一覧

200 — ログイン完了

{
  "result": "signed_in",
  "account": "existing",
  "carriedOver": 3,
  "visits": [{ "deviceVisitId": "v_7f3a", "visitId": "v_2c91", "combinedWithExisting": true }],
  "savedCount": 5
}

422 — コード不一致

{ "result": "rejected", "code": "CODE_MISMATCH", "attemptsLeft": 3 }

410 — コードの期限切れ・新しいコードによる失効

{ "result": "rejected", "code": "CODE_EXPIRED" }
{ "result": "rejected", "code": "CODE_REPLACED" }

429 — 試行回数の上限

{ "result": "rejected", "code": "TOO_MANY_ATTEMPTS" }

完了画面はaccountが「new」なら「Your saved works are kept」、「existing」なら「Welcome back」。combinedWithExistingがtrueなら、同じ日の既存の訪問記録に作品が追加されたことを示す。

引き継ぐのは、現在その端末に保存されている作品の追加だけ。

newsがtrueの場合は、メールアドレスを確認できたこの段階で初めて同意を記録する。他人のアドレスを勝手に登録できないようにするため。falseでも過去の同意は取り消さない。チェック欄はメールアドレス入力画面に置き、その値をこのリクエストまで端末で保持する。

応答がない場合も入力したコードを残し、結果を受け取れなかったと伝える。再送には同じrequestIdを使う。

セッションの管理方法(安全なCookieを使うかなど)は、実装担当者が決める。

5. 訪問記録を取得する

GET /api/me/visits?lang=en
1

一覧と詳細に必要なのは、各訪問の日付、当日の展示構成、画像の状態を含む保存作品、訪問ごとの件数、ナビゲーションに表示する合計件数。

2

来館者が持つ訪問記録は多くないため、作品と一緒に全件返せる。

3

一つのレスポンスを一覧と詳細の両方で使う。「Find other works from this visit」の展示室情報は、訪問日を指定して1から取得する。

レスポンス形式
{
  "savedCount": 5,
  "visits": [
    {
      "visitId": "v_2c91",
      "museumId": "northlight",
      "date": "2026-10-27",
      "displays": [{ "id": "under-changing-skies", "title": { "text": "Under Changing Skies", "lang": "en" }, "ended": true }],
      "works": [
        {
          "workId": "w_monet_1897",
          "displayId": "under-changing-skies",
          "onDisplayThatDay": true,
          "title": { "text": "Morning on the Seine near Giverny", "lang": "en" },
          "artist": "Claude Monet",
          "section": "dawn",
          "image": { "state": "not_shown", "reason": "loan_period_ended" }
        }
      ]
    }
  ]
}

日付変更後、onDisplayThatDayがfalseの作品には「Not on display on this day」を表示する。

未送信の作品は端末内の送信待ち変更から一覧に追加し、「Not yet added to your account」と示す。

6. 保存・解除の操作を送信する

POST /api/me/operations

{
  "deviceId": "d_91c2",
  "operations": [
    {
      "opId": "5b0e…",
      "seq": 41,
      "createdAt": "2026-10-27T11:02:10Z",
      "action": "save",
      "workId": "w_whistler_1880",
      "visit": { "id": "v_7f3a", "museumId": "northlight", "date": "2026-10-27" }
    }
  ]
}
1

オフライン中の保存と解除は、操作した順序でアカウントに反映し、二重処理せず、より新しい変更を上書きしない必要がある。最初の保存によって、オフラインでも訪問記録を作成できる。

2

適用済みの操作IDを記録できる。各作品の保存状態には、その状態を決めた端末・操作順序・時刻を記録できる。

3

操作はまとめて送る。同じ端末内ではseqの順に適用し、端末が異なる場合は新しいcreatedAtを優先する。同時刻なら端末IDで順序を決める。訪問IDは端末で生成し、同じ美術館・日付の訪問がすでにアカウントにあればサーバーで統合して、残ったIDを返す。各操作の結果にはバッチ処理後のサーバー上の保存状態も含め、端末の表示を合わせられるようにする。

レスポンス形式一覧

200 — 操作ごとの結果とサーバー側の状態

{
  "results": [
    { "opId": "5b0e…", "status": "applied", "visitId": "v_2c91", "workId": "w_whistler_1880", "saved": true },
    { "opId": "9d4a…", "status": "duplicate", "visitId": "v_2c91", "workId": "w_hiroshige_1856", "saved": true },
    { "opId": "e71f…", "status": "superseded", "visitId": "v_2c91", "workId": "w_monet_1897", "saved": false }
  ],
  "savedCount": 4
}

401 — セッション期限切れ

{ "result": "rejected", "code": "SESSION_EXPIRED" }

端末はレスポンスのsavedに合わせて各作品の保存状態を更新し、端末で作った訪問IDを存続するvisitIdに置き換える。その後、未送信の操作や応答待ちリクエストに含まれる操作を再適用し、送信中に行われた操作を失わないようにする。

duplicateは適用済みを意味する。supersededは、同じ端末または別の端末でより新しい操作が適用されたことを示す。その場合はサーバーの最新状態を表示する(例:別端末で後から解除された場合)。どちらもエラー扱いせず、通知も出さない。

401が返った場合は操作を端末に残し、同じアカウントへ再ログインした後に送信する。

7. 来館日を変更する

PATCH /api/me/visits/v_7f3a

{ "date": "2026-10-27" }

// After the visitor confirms the combine page
{ "date": "2026-10-27", "combine": { "confirmToken": "k8q2…" } }
1

2つの訪問記録を統合する前に、それぞれの保存件数を示して確認を求めたい。確認画面を開いた後で別の端末から記録が更新されても、本人が見ていない内容で統合してはいけない。

2

訪問記録と保存作品の更新ごとに、訪問のバージョンを進める。サーバーは更新時に両方の記録を確認し、一つのトランザクションで統合できる。統合で消える記録には、残す記録への参照を持たせる。

3

まずその訪問の未送信変更を6で送る。統合が必要な日付変更では、両方の記録の状態に紐づいたconfirmTokenと件数を409で返す。確認画面からそのトークンを送る。確認後にどちらかの記録が変わっていたら統合せず、新しい件数とトークンを返して、再度確認を求める。

レスポンス形式一覧

200 — 日付変更完了

{ "result": "changed", "visitId": "v_7f3a", "date": "2026-10-26" }

200 — 訪問記録の統合完了

{ "result": "combined", "visitId": "v_2c91", "savedCount": 5 }

409 — 同じ日の別の訪問記録が存在

{ "result": "conflict", "code": "COMBINE_REQUIRED", "existingVisitId": "v_2c91",
  "savedInThisVisit": 2, "savedInExisting": 3, "afterCombining": 5, "confirmToken": "k8q2…" }

409 — 確認画面を開いた後に訪問記録が変更された

{ "result": "conflict", "code": "COMBINE_CHANGED", "existingVisitId": "v_2c91",
  "savedInThisVisit": 2, "savedInExisting": 4, "afterCombining": 6, "confirmToken": "p3w7…" }

422 — 未来の日付

{ "result": "rejected", "code": "DATE_IN_FUTURE" }

「On this day」のプレビューは指定日を使って1から展示情報を取得し、この訪問の保存作品と比較する。専用のエンドポイントは不要。統合の最終判定はサーバーが行う。

COMBINE_CHANGEDの場合は、確認画面を開いた後で記録が更新されたことと新しい件数を示し、再確認を求める。画面に表示した内容を来館者が承認するまでは統合しない。

ログアウト

ログアウトそのものには認証サービスの標準機能を使うため、専用のエンドポイントはありません。周辺の動作を次のように定義します。

  • 未送信の変更を確認した後、通信状態にかかわらず、端末からそのアカウントのデータ、送信待ちの変更、セッションをまとめて削除する。
  • オンラインの場合は、サーバー上のセッションも終了する。
  • オフラインでも端末からセッション情報を削除するため、その端末では利用できなくなる。サーバー上のセッションは設定された期限で終了する。

実装担当者に委ねること

この仕様書では、状態ごとの画面表示、正しいデータの判定、画像の掲載可否、保存・解除の適用順、未送信操作を送るタイミング、再試行の間隔を徐々に延ばすこと、IndexedDBへの保存、表示するメッセージまでを決めています。

一方、具体的な実装方法はエンジニアが選びます。例えば、オフライン用キャッシュの仕組み、再試行の秒数、IndexedDB内のデータ構造、セッション管理、日本語を適切な位置で改行するためのツール、コンポーネントや状態管理の構成などです。

オフライン保存や同期の扱いは、開発の終盤にコードの中で決まることがあり、画面には設計されていない状態が生じがちです。変更の順序、送信待ちに何を表示するか、どの結果を優先するかを先に合意しておけば、エンジニアは定義済みの挙動を実現する方法に集中できます。

このサンプルについて

Figmaでは7セクション、44画面を設計しました。下部ナビゲーションのコンポーネントと、ライト・ダーク両モードのカラーバリアブルも作成しています。英語と日本語にはそれぞれ書体と文字スタイルを設定し、日本語の本文は行間を広めにしています。

配色と書体は、紙に描かれた作品、北から入る光、一日の空の変化という題材に合わせて選びました。テーマ別セクションの色だけを強調し、それ以外の要素は控えめにまとめています。

紹介作品はすべて実在する公共コレクションの作品で、公開利用可能な画像を使用しています。出典は下記にまとめました。

作品画像の出典(23点)
  • Utagawa Hiroshige, Dawn at Kanda Myōjin Shrine, 1857

    Art Institute of Chicago, 1939.1396. Frederick W. Gookin Collection. CC0

  • Camille Pissarro, The Garden of the Tuileries on a Spring Morning, 1899

    The Metropolitan Museum of Art, 1992.103.3. Gift of Mr. and Mrs. Douglas Dillon, 1992. CC0

  • J. M. W. Turner, Fluelen: Morning (Looking towards the Lake), 1845

    Yale Center for British Art, B1977.14.4715. Paul Mellon Collection. Public domain

  • Samuel Palmer, The Early Ploughman, 1861 or before

    National Gallery of Art, Washington, 1991.150.98. Courtesy National Gallery of Art, Washington

  • Claude Monet, Morning on the Seine near Giverny, 1897

    The Metropolitan Museum of Art, 56.135.4. Bequest of Julia W. Emmons, 1956. CC0 (file provided by the Met on Wikimedia Commons)

  • David Cox, Beach Scene – Sunrise, about 1820

    Yale Center for British Art, B1975.4.192. Paul Mellon Collection. Public domain

  • Utagawa Hiroshige, Mishima: Morning Mist, about 1833

    RISD Museum, 13.1057. Courtesy of the RISD Museum, Providence, RI. CC0

  • Attributed to Thomas Lindsay, Sky Study, No. 4

    Yale Center for British Art, B1975.4.65. Paul Mellon Collection. Public domain

  • Winslow Homer, Native hut at Nassau, 1885

    National Gallery of Art, Washington, 1994.59.20. Courtesy National Gallery of Art, Washington

  • Pierre-Henri de Valenciennes, Study of Clouds over the Roman Campagna, about 1782–1785

    National Gallery of Art, Washington, 1997.23.1. Courtesy National Gallery of Art, Washington

  • John Constable, Cloud Study, 1821

    Yale Center for British Art, B1981.25.156. Paul Mellon Collection. Public domain

  • Jacob van Ruisdael, View of Haarlem from the Northwest, with the Bleaching Fields in the Foreground

    Rijksmuseum, SK-A-351. Rijksmuseum, Amsterdam. Public domain

  • Eugène Boudin, Figures on the Beach, about 1867–1870

    National Gallery of Art, Washington, 1983.1.12. Courtesy National Gallery of Art, Washington

  • Utagawa Hiroshige, Yatsumi Bridge, 1856

    Art Institute of Chicago, 1925.3741. Clarence Buckingham Collection. CC0

  • Aelbert Cuyp, A Pier Overlooking Dordrecht, early 1640s

    National Gallery of Art, Washington, 2012.73.1. Courtesy National Gallery of Art, Washington

  • Utagawa Hiroshige, Sudden Shower over Shin Ohashi Bridge and Atake, 1857

    Art Institute of Chicago, 1925.3742. Clarence Buckingham Collection. CC0

  • Rembrandt van Rijn, The Three Trees, 1643

    National Gallery of Art, Washington, 1955.6.10. Courtesy National Gallery of Art, Washington

  • John Constable, A Cloud Study, Sunset, about 1821

    Yale Center for British Art, B1981.25.128. Paul Mellon Collection. Public domain

  • James McNeill Whistler, Nocturne: Palaces, 1879–1880

    RISD Museum, 84.198.24. Courtesy of the RISD Museum, Providence, RI. CC0

  • Utagawa Hiroshige, Fireworks at Ryōgoku Bridge, 1858

    The Metropolitan Museum of Art, JP642. Purchase, Joseph Pulitzer Bequest, 1918. CC0

  • Charles-François Daubigny, The Boat in Conflans, 1866

    The Cleveland Museum of Art, 1920.666. Gift of Ralph King, the Frederick Keppel Memorial. CC0

  • James McNeill Whistler, Black Lion Wharf, 1859

    National Gallery of Art, Washington, 1943.3.9104. Courtesy National Gallery of Art, Washington

  • Utagawa Hiroshige, The Plum Garden at Kameido (Famous Places in the Eastern Capital), about 1832–1838

    Art Institute of Chicago, 1925.3462. Clarence Buckingham Collection. CC0

画面デザイン

このページで使用した技術

React / TypeScript / Next.js / Tailwind CSS

デザインに使用したツール

Figma(ライト/ダークモードのバリアブル、コンポーネント)