Yoko Shiinaケーススタディ

エネルギー運用ダッシュボードの挙動とデータ設計

スマートシティのエネルギー運用に使う社内ダッシュボードの機能追加・改善に伴うUX設計を担当しました。このケーススタディでは、新規に追加した「運転計画」と「運転モード切り替え」の2つの機能を取り上げます。それまではExcelやCSV、コマンドの手入力、データベースの直接更新を組み合わせて行っていた業務です。私は実装に入る前に、新しい画面の挙動とデータの流れを定義し、データやバリデーションの分担について担当エンジニアと合意しました。その内容を画面仕様設計書にまとめ、外部の実装ベンダーへ渡しました。実装が始まってからも関わり、2つの機能はいずれも本番リリースされ、現在は実際の運用で使われています。

役割
UX設計者
対象
スマートシティのエネルギー管理に使う社内運用ダッシュボード
関係者
運用担当者、画面を使う管理職、エンジニア、外部実装ベンダー
結果
2つの機能を本番リリースし、実運用で使用中

守秘義務のため、企業名と一部の数値は非公開にしています

何が決まっていなかったか

新しい機能では、運用担当者が電力設備の短期的・実験的な運転計画を作成し、適用できるようにします。計画を間違えると、運用コストや電力供給の安定性に影響します。供給が止まったり、翌日に必要な充電ができなかったりする可能性もあります。

運転計画はCSVでアップロードし、選択した日付のデータをスナップショットとして丸ごと置き換える方式です。ファイルに含まれないデータは、削除されたものとして扱われる可能性があります。だからこそ、画面での操作、ファイルの検証、データの更新がどうつながるかを慎重に決める必要がありました。

同じ事業で使われていた別のアプリには、その重要性を示す例がありました。日付の境界、特に深夜0時の扱いがわかりづらく、間違いが頻発していました。ユーザー同士が、気をつける点を口頭で伝え合っていました。エラーも「エラーがあります。担当者にお問い合わせください」としか出なかったり、コードだけが表示されたり、何も出なかったりします。自分では対処方法がわからず、そのアプリはやがて使われなくなっていました。

私の見立てでは、マネージャーが機能を依頼し、エンジニアが依頼どおりに作ります。そのどちらが悪いわけでもありません。ただ、依頼から実装までの間にある判断を、誰が引き受けるのかが決まっていません。このプロジェクトにはデザイナーもPMもいませんでした。その間のすり合わせこそ、私が担った仕事です。

具体的な動きを見なければ決められない要件もありました。設備数の増加も見据える必要がありました。初回リリースでは約6台。将来は50〜100台、それぞれ30分単位の48コマを扱う想定でした。

どうやって決めていったか

実際に画面を使う人たちに具体的な案を見せ、反応を確かめながら要件を詰めていきました。抽象的な話し合いだけでは決めにくいことは、モックアップで試してから仕様に落としました。

  1. 聞いた

    運用担当者に、Excel、CSV、コマンドライン、データベースの更新を組み合わせて、どう計画を作り、適用しているのかを聞きました。業務の手順、更新ごとにデータへ起こること、リスク、ユーザー自身が判断する必要のあることを整理しました。

  2. 提案した

    最初は、設備ごとに1枚のカードを並べる日表示を提案しました。各カードに登録状態、48コマ分の入力欄、保存・複製・削除の操作を持たせる案です。

    設備ごとにカードを並べ、30分単位の入力欄を設けた初期の日表示案
    ドラフト1:設備ごとのカード設備ごとにカードを作り、登録状態、各時間枠の入力欄、保存・複製・削除の操作を持たせた案。
  3. 組み直した

    将来、50〜100台の設備を48コマで扱うなら、カードを並べるだけでは全体を見渡せません。そこで、計画の有無を2か月分まとめて確認する「月表示」と、1日分を詳しく扱う「日表示」に分け、日表示はテーブル形式に変更しました。

    各設備について、2か月分の計画の有無が見える月間グリッド
    ドラフト2.5:月表示のグリッド2か月を並べて計画の有無を一覧する。日付を複数選んで一括削除するか、日付を開いて日表示へ進む。
    設備と30分単位の48コマを1つのテーブルにまとめた日表示
    ドラフト3:日表示のテーブル設備ごとのカードから1つのテーブルへ。設備数と時間枠が増えても、まとめて扱えるようにした。
  4. 細部を詰めた

    編集時の状態、一括操作、データ更新の挙動、操作ミスを防ぐ仕組みを詰めてから、最終仕様にしました。最終版では、月表示も日表示も設備を行に配置しています。設備を列にすると、台数が増えるほど画面が横に広がります。行なら、台数が増えても横幅を広げずに対応できます。

    編集中の変更、複数行・列の削除、表計算ソフトからの貼り付けを検討した日表示案
    ドラフト4:編集と一括操作要望を受けて検討し、次のリリースに回した画面内編集の案。編集モード、保存前の変更、行・列単位の一括削除、表計算ソフトからの貼り付けを試した。過去日と、開始まで5分を切った時間枠は編集できない。

Figmaとコードを、設計と実装の別々の工程として扱いませんでした。構造やレイアウトを比べるならFigma、データ量や操作の影響を確かめるならコード。何を確かめたいかに応じて、両方を行き来しました。

実装前に決めたこと

CSVの日付と画面の日付を一致させる。

アップロードは選択した日の日表示からしか始められず、CSVの日付が違えばブロックします。うっかり間違えることはあります。今日の画面に明日用のファイルを上げてしまうかもしれません。日付が正しく、中身だけが違うなら修正したファイルで上書きできます。しかし日付が違うと、どこに何を登録したのかわからなくなり、復旧が難しくなります。この仕組みは、早い段階で担当エンジニアと話し合って決めました。

アップロードを止めるエラーと、ユーザーが修正できるエラーを分ける。

起こりうるケースを先にできるだけ洗い出し、それぞれをどう扱うか決めました。フロントエンドでは、ファイルの種類とサイズ、日付の不一致、許可範囲外の日付、48コマの欠損、無効な設備ID、停止中の設備、設備ごとの上限を超える値を確認します。処理を続けられない場合はアップロードを止めます。ユーザーが直せるデータのエラーは、行と列の情報を付けてまとめて表示し、一度に確認して修正できるようにします。検証結果や処理失敗ごとに、画面がどう変わるかも定義しました。

エラーに何と表示するか。

バックエンドが返すエラーコードに対して、フロントエンドで表示する文言を日英それぞれ対応づけました。ユーザーが何が起きたかを理解し、その場で直せること。そしてバックエンドが伝えたい内容と、画面に表示される内容が食い違わないことを目指しました。

削除や運用に影響する操作をどう扱うか。

1日分の削除と、複数日をまとめて削除する操作は分けました。削除や運転モードの切り替え前には、何が対象になり、運用にどう影響するかを確認画面で示します。アップロードした計画をいつ有効にするかも、ユーザーが制御できるようにしました。

データをどこに置くか。

データの種類ごとに、サーバーへ保存するのか、フロントエンドで一時的に持つのか、Contextやアプリケーションのstateで管理するのかを決めました。データがそれぞれの間を移るときにどう処理するかも決めました。

データとAPIの役割分担。

各画面でどのようなデータが、どのタイミングで必要になるかを整理し、データ構造の案を提示しました。効率性、一貫性、再利用性、安全性を考慮しながら、データの変換処理をフロントエンドとバックエンドのどちらで行うかについて開発側と協議しました。バリデーションの担当範囲についても同様に検討し、合意しました。APIの最終設計はバックエンド担当のエンジニアが担い、私は合意した画面の挙動、APIエンドポイント、ペイロード、レスポンス、バリデーションの担当範囲、エラーコードを仕様書にまとめました。

今回どこまで作るか。

ユーザーからは、スプレッドシートを直接取り込みたいという要望がありました。自分たちの手元で記録や計算を続けたいという事情もあります。そこで、表計算ソフトから簡単に出力でき、検証しやすく、表にも戻しやすいCSVを採用しました。その後、画面上で直接編集し、表計算ソフトのように貼り付けたいという要望も出ました。Material UIにはそのまま使える機能がなかったので、コピー&ペーストまで動くモックアップを作って検討しました(ドラフト4)。リリースまで残り2週間となった段階で、外部ベンダーによる実装とバックエンド側の依存関係を考えると、両方を届ける時間はありませんでした。必須の機能と、あると便利な機能を分け、今回はCSVに絞り、画面内編集は次のリリースへ回しました。実装コスト、既存の業務手順、データの制約、操作ミスのリスクを踏まえた判断です。

エンジニアに任せたこと

画面をどう実装するかはエンジニアに任せました。条件分岐、コンポーネントの構造やprops、ネスト、stateとeffectの実装方法、既存画面との整合性を保ちながら読みやすく拡張しやすいコードにすること。一方、私は何をいつ表示するか、データをどこに置くか、バリデーションをどう分担するか、どんなメッセージを出すかを定義しました。

挙動の判断をコーディングの段階まで残すと、実装上の都合がそのままユーザー体験を決めてしまうことがあります。先に挙動を決めておけば、エンジニアはどう実装するかに集中できます。文言まで含めたのも、意図する挙動と表示内容を推測せずに済むようにするためです。

引き渡したもの

文書だけでは挙動を判断しにくい部分は、実案件と同じ技術構成(React、Next.js、TypeScript、Material UI、MSW)で動くプロトタイプを作り、検証しました。既存のコードベース上で、CSVの解析、バリデーション、選択状態、エラー処理、破壊的な操作、データ量を試すことで、技術的な制約も早い段階から判断に反映できました。プロトタイプは補足資料としてベンダーに共有し、一部のコードは本番でも再利用されています。

実装まで関わったこと

ベンダーのコードをレビューし、合意した挙動、バリデーション、エラー処理、データの流れと一致しているか、既存画面に影響しないかを確認しました。レビューコメントだけでは修正方法が伝わりにくい場合は、安全な実装のサンプルコードも示しました。複雑な箇所や未完成の箇所、仕様と異なる箇所については、自分で実装・修正した部分もあり、その変更は本番に反映されました。GitHub Copilotも使ってバグ、バリデーションの漏れ、セキュリティ上の懸念を洗い出し、それぞれ実際のコードと状況に照らして確かめたうえで、確認できた問題を修正しました。

結果

画面

運転計画の月表示に関する注釈付き仕様
運転計画:月表示2か月分を一覧し、設備ごと・日付ごとの計画の有無がわかる。CSVテンプレートのダウンロードや選択した複数日付の一括削除はここから。日付を選ぶと日表示へ進む。
運転計画の日表示に関する注釈付き仕様
運転計画:日表示選択した日の設備と30分単位の48コマを並べ、CSVのアップロード・ダウンロード・検証・削除を行う。アップロードできるのはこの画面だけ。
CSVの検証結果。行、列、原因を示したエラー一覧
CSVの検証結果修正できるエラーを行・列・原因とともにまとめて表示し、一度に確認できるようにした。処理を止める種類のエラーは、この一覧へは進まない。
運転モードと状態の表示、切り替え前後の操作
運転モード切り替え現在の運転モードを表示し、アップロード済みの計画をいつ有効にするかユーザーが制御できる。
運転モード切り替えを適用する前の確認画面
運転モード切り替え:確認適用する前に、現在の状態と切り替え後の状態を並べて確認できる。

シフトのサンプル

実案件の設計は公開できないため、同じ構造を使って架空のシフト管理業務向けのサンプルを作りました。日単位でデータを丸ごと置き換える方式と、そこから導かれる判断は、実案件と同じです。

実際の案件シフトのサンプル
設備 × 48コマスタッフ × 1時間枠8つ
運転計画の月表示と日表示シフト表の月表示と日表示
CSVで1日分をスナップショット置換CSVで1日分をスナップショット置換
停止中の設備ID退職済みのスタッフID
設備ごとの出力の上限・下限スタッフごとに連続3時間以上の1区間、分割勤務なし
運転モード切り替えシフトの下書き・公開の切り替え
計画を間違えると電力供給に影響するシフトを間違えると実際の勤務に影響する

シフトのサンプルを開く

画面を操作してみてください。実際にバリデーションが動き、対応する仕様が横に表示されます。

開く