
照明設定ツールを、照明担当が AI で直せるようになるまで
この記事は、NOTAのテクノロジー連載「Tech Behind the Scenes」です。
はじめに
NOTA のソフトウェアチームで、スマートホームの照明まわりを担当している深谷です。
NOT A HOTEL の建物では、照明を DALI という通信規格で制御しています。DALI では照明器具の1台ずつに番号(アドレス)を振り、その番号を指定して点けたり明るさを変えたりします。
器具ごとのアドレスの割り当てや、シーン(場面ごとの照明の明るさの組み合わせ)の設定は、ブラウザで使う社内の「照明設定ツール」で行います。
このツールで目指しているのは、開発者の僕がいなくても、照明担当のメンバーだけで最初の設定から明るさの調整まで回せる状態です。この記事では、そのために何をしてきたかを紹介します。
まず、自分で設定してみる
社内ツールって、使う人に要望を聞いて開発者が作るのが普通だと思います。でも今回は順番を逆にして、まず僕自身が照明の設定作業に入りました。1棟の設定はメンバーで分担して進めるので、僕もその一人として何棟も担当しています。
やってみると、照明がなかなか思いどおりに点いてくれないんですよね。点くはずの器具が点かないので飛ばして先に進み、あとで点け直そうとしても、やっぱり点かない・・・。そんなことの連続でした。
それでも、自分で手を動かしてみて、どこで時間を取られているのかが身にしみてわかりました。
設定作業の手間を、機能で減らす
実際にやってみてわかった手間は、楽に設定できる機能を作って一つずつ改善していきました。
図面を見ながら、器具を1台ずつ入力していた
照明の器具は、多い棟だと1棟で数百台あります。最初は図面を見ながら、それを1台ずつ手で入力していました。何時間もかかることもありました。
そこで、作図ツールで描いた図面データを読み込めるようにしました。読み込むと照明が図面の上に並び、アドレスの候補も自動で振られます。もう1台ずつ打ち込む必要はありません。
どの器具が何番か、1台ずつ点けて探していた
器具を取り付けただけの状態では、どの器具が何番のアドレスなのかがわかりません。これまでは1台ずつ点けて、どれが光ったかを図面と照らし合わせていました。1つの系統には最大64台つながるので、多いときは64回くり返すことになります。
そこで、アドレスの各ビットに合わせて点灯と消灯を6回くり返す機能を作りました。各回で点いたかどうかを並べると、それがそのままアドレスになります。64通りのアドレスが、6回の点滅で全部見分けられるんです。

シーンの明るさの入力に、時間がかかっていた
シーンの明るさは、器具やグループごとに数値で入れていきます。部屋ごとにシーンがいくつもあるので、入れる数値はかなりの数になります。シーンごとにページを変えていたので、それだけでも時間がかかっていました。
そこで、表計算ソフトのように、キーボードだけで移動しながら入力できるようにしました。
何から手をつければいいか、迷っていた
設定には決まった順番があります。でも、初めて触る人にはそれがわかりません。そこでトップページを、構築の手順どおりに並べたガイドにしました。
要望を、直接受け取れるようにする
設定作業を照明担当の美崎さんに渡し始めると、今度は使う人の気づきをどう拾うかが大事になってきました。そこで、GitHub の Issueに、要望を書いてもらうようにしています。
たとえば、シーンの数値をもっと手早く入力したいという声を受けて、入力の操作を見直しました。要望は今も届いていて、次に取り組むものも見えています。
画面だけで直せるように、土台を API にまとめる
ここまで、ツールを直していたのは僕です。でも、照明のことを一番わかっていて、毎日このツールを使っているのは照明担当です。困りごとに最初に気づくのも、どう直せば使いやすくなるかを知っているのも、照明担当なんですよね。
だから最終的には、ツールの改善も照明担当に渡したい。僕を間にはさむより、そのほうが早くて的確です。ただ、どこでも直していいわけではありません。
照明設定ツールには、大きく2つの部分があります。照明を直接動かすプログラムと、それを操作する画面です。照明を動かすほうは、間違えると現場の照明に影響が出ますし、組み込み機器や DALI の知識も要ります。一方、画面なら、変えた結果を手元で見ながら確かめられます。
なので、照明担当に任せるのは画面だけにしたい。そのためには、画面だけを直せば済む状態にしておく必要があります。
そこで、DALI への書き込みや設定データの保存といった建物側の処理は、組み込み機器のライブラリを調べたうえで Web の API にまとめ、仕様書に残しています。画面からは、この API を呼ぶだけです。
新しい画面は、次の順番で作っています。
設計書を書く
ブラウザの中だけで動くモックを作り、操作感を確かめる
データベースと API を作る
モックを外して、本物のデータにつなぎ替える

図面の上で照明を紐付ける画面は、この1〜4を2日で作りました。先にモックで触ってみると、API に何が必要かがはっきりするんですよね。既存の画面は残したまま新しい画面を並行して作ったので、現場の作業を止めずに切り替えられました。
照明担当が、自分でツールを直す
いよいよ、ツールの改善そのものを照明担当に渡します。美崎さんは照明制御の仕事を18年続けてきたプロですが、Web アプリの開発は専門ではありません。それでも Claude Code を使えば、画面を直せます。美崎さんのこれまでの歩みは、こちらの記事に書かれています。
ただ、AI に任せていると、画面の外のファイルまでうっかり変えてしまうこともありえます。そこで、変更できる範囲をフロントエンドだけに限る仕組みを作りました。建物側の処理を API にまとめてあるので、範囲を画面に絞っても、できることは十分にあります。
止める仕組みは2段構えです。Claude Code が範囲の外のファイルを変えようとすると、その場で止まって理由を説明します。PR(取り込みの依頼)を出したときも、範囲の外の変更が混ざっていれば自動チェックで止まります。あわせて用語集やセットアップの手順をまとめた作業ガイドも用意して、最初のセットアップは開発者と一緒にやるようにしました。
最初の PR は、シーン編集の表の余白を詰めて、一画面に見える行数を10行から20行に増やす修正でした。表を毎日見ている美崎さんが、自分で気づいて直したものです。美崎さんが記事に書いていた「プログラマーはデザイナーでもある」が、このツールの上でも始まったなと感じています。

PR の説明には、変更の内容と効果だけでなく、テストが全部通ったことや、手元の開発環境で表示を確かめたことまで書かれていました。僕のレビューを経て、そのまま取り込んでいます。取り込んだあとは、PR に付けたラベルをもとに配布用パッケージの作成まで自動で進みます。
残っている課題と、これから
照明担当がツールを直せるようになって、次のボトルネックも見えてきました。画面の部品が増えていったときに、見た目や操作がばらばらにならないか、という点です。
美崎さんの最初の PR でも、部品の既定の見た目を上書きして調整する場面がありました。直す人が増えるほど、こういう小さなずれは積み重なっていきます。
いまは、色や余白のルールをまとめたスタイルガイドと、パネルやダイアログの作り方を Claude Code に伝える手順書を用意しています。画面に必要な UI はひととおり揃ってきたので、これからは部品を一つずつ見直して、バランスがよく使いやすい部品集を作るつもりです。照明設定ツールの中に、小さなデザインシステムを育てていくイメージですね。
開発者が手を離しても回るツールを目指して、これからも作業の現場から改善を続けていきます。
NOTAでは、一緒に働く仲間を募集しています。気になった方は、ぜひ採用ページものぞいてみてください。
テクノロジー関係中途採用はこちら
採用全般はこちら
カジュアル面談からでもお気軽にどうぞ!