CSVの日付と画面の日付を一致させる。
アップロードは選択した日の日表示からしか始められず、CSVの日付が違えばブロックします。うっかり間違えることはあります。今日の画面に明日用のファイルを上げてしまうかもしれません。日付が正しく、中身だけが違うなら修正したファイルで上書きできます。しかし日付が違うと、どこに何を登録したのかわからなくなり、復旧が難しくなります。この仕組みは、早い段階で担当エンジニアと話し合って決めました。
スマートシティのエネルギー運用に使う社内ダッシュボードの機能追加・改善に伴うUX設計を担当しました。このケーススタディでは、新規に追加した「運転計画」と「運転モード切り替え」の2つの機能を取り上げます。それまではExcelやCSV、コマンドの手入力、データベースの直接更新を組み合わせて行っていた業務です。私は実装に入る前に、新しい画面の挙動とデータの流れを定義し、データやバリデーションの分担について担当エンジニアと合意しました。その内容を画面仕様設計書にまとめ、外部の実装ベンダーへ渡しました。実装が始まってからも関わり、2つの機能はいずれも本番リリースされ、現在は実際の運用で使われています。
守秘義務のため、企業名と一部の数値は非公開にしています
新しい機能では、運用担当者が電力設備の短期的・実験的な運転計画を作成し、適用できるようにします。計画を間違えると、運用コストや電力供給の安定性に影響します。供給が止まったり、翌日に必要な充電ができなかったりする可能性もあります。
運転計画はCSVでアップロードし、選択した日付のデータをスナップショットとして丸ごと置き換える方式です。ファイルに含まれないデータは、削除されたものとして扱われる可能性があります。だからこそ、画面での操作、ファイルの検証、データの更新がどうつながるかを慎重に決める必要がありました。
同じ事業で使われていた別のアプリには、その重要性を示す例がありました。日付の境界、特に深夜0時の扱いがわかりづらく、間違いが頻発していました。ユーザー同士が、気をつける点を口頭で伝え合っていました。エラーも「エラーがあります。担当者にお問い合わせください」としか出なかったり、コードだけが表示されたり、何も出なかったりします。自分では対処方法がわからず、そのアプリはやがて使われなくなっていました。
私の見立てでは、マネージャーが機能を依頼し、エンジニアが依頼どおりに作ります。そのどちらが悪いわけでもありません。ただ、依頼から実装までの間にある判断を、誰が引き受けるのかが決まっていません。このプロジェクトにはデザイナーもPMもいませんでした。その間のすり合わせこそ、私が担った仕事です。
具体的な動きを見なければ決められない要件もありました。設備数の増加も見据える必要がありました。初回リリースでは約6台。将来は50〜100台、それぞれ30分単位の48コマを扱う想定でした。
実際に画面を使う人たちに具体的な案を見せ、反応を確かめながら要件を詰めていきました。抽象的な話し合いだけでは決めにくいことは、モックアップで試してから仕様に落としました。
運用担当者に、Excel、CSV、コマンドライン、データベースの更新を組み合わせて、どう計画を作り、適用しているのかを聞きました。業務の手順、更新ごとにデータへ起こること、リスク、ユーザー自身が判断する必要のあることを整理しました。
最初は、設備ごとに1枚のカードを並べる日表示を提案しました。各カードに登録状態、48コマ分の入力欄、保存・複製・削除の操作を持たせる案です。

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


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

Figmaとコードを、設計と実装の別々の工程として扱いませんでした。構造やレイアウトを比べるならFigma、データ量や操作の影響を確かめるならコード。何を確かめたいかに応じて、両方を行き来しました。
アップロードは選択した日の日表示からしか始められず、CSVの日付が違えばブロックします。うっかり間違えることはあります。今日の画面に明日用のファイルを上げてしまうかもしれません。日付が正しく、中身だけが違うなら修正したファイルで上書きできます。しかし日付が違うと、どこに何を登録したのかわからなくなり、復旧が難しくなります。この仕組みは、早い段階で担当エンジニアと話し合って決めました。
起こりうるケースを先にできるだけ洗い出し、それぞれをどう扱うか決めました。フロントエンドでは、ファイルの種類とサイズ、日付の不一致、許可範囲外の日付、48コマの欠損、無効な設備ID、停止中の設備、設備ごとの上限を超える値を確認します。処理を続けられない場合はアップロードを止めます。ユーザーが直せるデータのエラーは、行と列の情報を付けてまとめて表示し、一度に確認して修正できるようにします。検証結果や処理失敗ごとに、画面がどう変わるかも定義しました。
バックエンドが返すエラーコードに対して、フロントエンドで表示する文言を日英それぞれ対応づけました。ユーザーが何が起きたかを理解し、その場で直せること。そしてバックエンドが伝えたい内容と、画面に表示される内容が食い違わないことを目指しました。
1日分の削除と、複数日をまとめて削除する操作は分けました。削除や運転モードの切り替え前には、何が対象になり、運用にどう影響するかを確認画面で示します。アップロードした計画をいつ有効にするかも、ユーザーが制御できるようにしました。
データの種類ごとに、サーバーへ保存するのか、フロントエンドで一時的に持つのか、Contextやアプリケーションのstateで管理するのかを決めました。データがそれぞれの間を移るときにどう処理するかも決めました。
各画面でどのようなデータが、どのタイミングで必要になるかを整理し、データ構造の案を提示しました。効率性、一貫性、再利用性、安全性を考慮しながら、データの変換処理をフロントエンドとバックエンドのどちらで行うかについて開発側と協議しました。バリデーションの担当範囲についても同様に検討し、合意しました。APIの最終設計はバックエンド担当のエンジニアが担い、私は合意した画面の挙動、APIエンドポイント、ペイロード、レスポンス、バリデーションの担当範囲、エラーコードを仕様書にまとめました。
ユーザーからは、スプレッドシートを直接取り込みたいという要望がありました。自分たちの手元で記録や計算を続けたいという事情もあります。そこで、表計算ソフトから簡単に出力でき、検証しやすく、表にも戻しやすいCSVを採用しました。その後、画面上で直接編集し、表計算ソフトのように貼り付けたいという要望も出ました。Material UIにはそのまま使える機能がなかったので、コピー&ペーストまで動くモックアップを作って検討しました(ドラフト4)。リリースまで残り2週間となった段階で、外部ベンダーによる実装とバックエンド側の依存関係を考えると、両方を届ける時間はありませんでした。必須の機能と、あると便利な機能を分け、今回はCSVに絞り、画面内編集は次のリリースへ回しました。実装コスト、既存の業務手順、データの制約、操作ミスのリスクを踏まえた判断です。
画面をどう実装するかはエンジニアに任せました。条件分岐、コンポーネントの構造やprops、ネスト、stateとeffectの実装方法、既存画面との整合性を保ちながら読みやすく拡張しやすいコードにすること。一方、私は何をいつ表示するか、データをどこに置くか、バリデーションをどう分担するか、どんなメッセージを出すかを定義しました。
挙動の判断をコーディングの段階まで残すと、実装上の都合がそのままユーザー体験を決めてしまうことがあります。先に挙動を決めておけば、エンジニアはどう実装するかに集中できます。文言まで含めたのも、意図する挙動と表示内容を推測せずに済むようにするためです。
文書だけでは挙動を判断しにくい部分は、実案件と同じ技術構成(React、Next.js、TypeScript、Material UI、MSW)で動くプロトタイプを作り、検証しました。既存のコードベース上で、CSVの解析、バリデーション、選択状態、エラー処理、破壊的な操作、データ量を試すことで、技術的な制約も早い段階から判断に反映できました。プロトタイプは補足資料としてベンダーに共有し、一部のコードは本番でも再利用されています。
ベンダーのコードをレビューし、合意した挙動、バリデーション、エラー処理、データの流れと一致しているか、既存画面に影響しないかを確認しました。レビューコメントだけでは修正方法が伝わりにくい場合は、安全な実装のサンプルコードも示しました。複雑な箇所や未完成の箇所、仕様と異なる箇所については、自分で実装・修正した部分もあり、その変更は本番に反映されました。GitHub Copilotも使ってバグ、バリデーションの漏れ、セキュリティ上の懸念を洗い出し、それぞれ実際のコードと状況に照らして確かめたうえで、確認できた問題を修正しました。





実案件の設計は公開できないため、同じ構造を使って架空のシフト管理業務向けのサンプルを作りました。日単位でデータを丸ごと置き換える方式と、そこから導かれる判断は、実案件と同じです。
| 実際の案件 | シフトのサンプル |
|---|---|
| 設備 × 48コマ | スタッフ × 1時間枠8つ |
| 運転計画の月表示と日表示 | シフト表の月表示と日表示 |
| CSVで1日分をスナップショット置換 | CSVで1日分をスナップショット置換 |
| 停止中の設備ID | 退職済みのスタッフID |
| 設備ごとの出力の上限・下限 | スタッフごとに連続3時間以上の1区間、分割勤務なし |
| 運転モード切り替え | シフトの下書き・公開の切り替え |
| 計画を間違えると電力供給に影響する | シフトを間違えると実際の勤務に影響する |
画面を操作してみてください。実際にバリデーションが動き、対応する仕様が横に表示されます。