テックブログ
更新が反映されない医療システムの画面を、自動で最新版に戻すには
目次
医療システムの更新は、出したら全部の端末にすぐ反映される、とは限りません。Web の画面は、一度読み込むとその版のまま動き続けるからです。MENTRA では、万が一ある端末にだけ更新が反映されず、前の版のまま使われ続けることがあっても、録音や入力の邪魔をせずに、自動で最新版へ戻す安全網を入れました。ふだん職員の皆さまが押すボタンはありません。この記事では、何を待つ条件にしたか、どのくらいの頻度で確かめるかを、実装と実測でご説明します。
先に、言葉の整理
| 言葉 | どういうものか |
|---|---|
| Webアプリ(SPA) | 最初に画面の部品(JavaScript)を丸ごと読み込み、そのあとは読み込み直さずに画面を切り替えて動く作り。MENTRA の画面もこの形 |
| 版(バージョン) | 画面の部品の一式。更新のたびに新しい版ができ、それぞれに「版の印」が付く |
| デプロイ | 新しい版をサーバに置き、配れる状態にすること |
| 再読み込み | 画面を一度捨てて、サーバから読み込み直すこと。新しい版に切り替わるが、保存していない入力は消える |
| 自動更新 | この記事では、端末が新しい版に気づき、人が操作しなくても再読み込みして切り替わること |
| 版の印のファイル | いま配っている版の印を書いた小さなファイル。端末はこれを取りに行き、自分の版と比べる |
| キャッシュ | 一度取ったものをブラウザや途中の経路に控えておき、次は控えから返す仕組み。新しい版を出した直後は、控えが前の版を返すことがある |
| 待つ理由 | 録音中・送信中など、いま読み込み直すと何かを失う状態。1つでもあれば入れ替えない |
なぜ更新が反映されない画面が残りうるのか
SPA は、画面を切り替えるたびにサーバから読み込み直すのではなく、最初に読み込んだ部品で動き続けます。そのぶん操作は軽くなりますが、新しい版をデプロイしても、端末の側は読み込み直すまで前の版のままです。「SPA デプロイ 反映されない」「Webアプリ 古いバージョン」で検索すると多くの解説が見つかるのは、どの Web アプリでも起こりうることだからです。
ふつうは、朝に画面を開き直したときや、ログインし直したときに新しい版へ切り替わります。ただ、端末の使われ方は病院ごと・職種ごとにさまざまで、切り替わるきっかけが来ない端末が出ることもありえます。前の版の画面は、たいていはそのまま問題なく動きます。気をつけたいのは、サーバ側の決まりが新しい版に合わせて変わったときで、前の版の画面が送る問い合わせが受け付けられず、保存や読み込みが止まることがあります。
対策の方向は、すでにいくつか公開されています。版の印のファイルをビルドのたびに出し、画面の切り替え・一定の間隔・タブに戻ったときに比べ、違えば読み込み直す方法(Zenn の解説)。タイマーで読み込み直すと入力の邪魔をしうるので、利用者がリンクを押した瞬間に、保存していない編集が無いときだけ切り替える方法(Scrapbox の開発者の記事)。MENTRA も考え方は同じで、そこに医療の記録ならではの「待つ理由」を足しました。
「更新があります」のボタンを置かなかったのはなぜか
最初に検討したのは、新しい版があると分かったら画面に案内を出し、ボタンで読み込み直してもらう形でした。よく見かける形ですが、比べると次のようになりました。
| 案 | 押す操作(新しい版ごと・1台あたり) | 録音・書きかけへの影響 | 選んだか |
|---|---|---|---|
| 画面を覆う案内+〔最新版に更新〕のボタン | 1回 | 押すと録音や書きかけが消える。キャッシュが前の版を返す間は、押しても前の版のまま画面が使えなくなる | 選ばない |
| ほかの画面から戻るたびに入れ替える | 0回 | 行き来のたびに一覧へ戻り、自動保存の無い欄の書きかけが消えうる | 選ばない |
| 書きかけを退避し、入れ替えたあと同じ記録に戻す | 0回 | 守れるが、画面の数だけ退避の作りが要り重い。出し方で防げば要らない | 選ばない |
| 待つ理由が無く、触れていないときだけ、何も表示せずに入れ替える | 0回 | 録音・入力・送信の間は待つので、何も失わない | 選んだ |
押してもらう形は、正しく押せば問題ありません。ただ、毎日何十回も画面を使う方に「新しい版のたびに1回押す」をお願いすると、その1回が端末の数だけ積み上がります。押すタイミングを誤れば録音を失います。そこで、押す人を無くし、邪魔にならない時を端末が自分で待つことにしました。
何を待てば、録音や入力の邪魔をしないか
「入力していないとき」と一言で言っても、医療の記録では失うものが段階ごとに違います。録音している間、録り終えて送っている間、送り終えてAIが文字起こしと分析をしている間、下書きを確定する前。どれも、その途中で読み込み直すと何かが消えるか止まります。画面を移るだけなら分析は進み続けますが、読み込み直しは、画面が起動した分析まで止めてしまうからです。そこで、録音から確定までの全段階を表に書き出し、1つずつ「待つ理由」に登録しました。
| 待つ理由 | どんな状態か | 外れるとき |
|---|---|---|
| 録音 | 端末に録音を抱えている | 送り終えたとき |
| 送信 | 送信中・送信に失敗・まだ送っていない | 送り終えたとき |
| 文字起こし・分析 | 送り終えた録音を、AIが文字起こし・分析している | 処理が終わったとき |
| 自動保存 | 入力から保存までの待ち・保存中・保存に失敗 | 保存できたとき |
| 送り直し | 端末に控えた録音を送り直している | 送り直しが終わったとき |
| 確定前の下書き | 議事録・福祉訪問記録の確定待ち | 確定したとき |
| 問診 | 患者さんが答えている途中・予約の案内の画面 | 最初の画面か、送信と予約を終えた画面に戻ったとき |
| ダイアログ | 画面の上に確認や入力の窓が開いている | 閉じたとき |
実装では、待つ理由を1か所の台帳に集め、各部品はそこへ1行で登録するだけにしました。登録すると「外す関数」が返り、部品が役目を終えると外れます。台帳を件数で持つので、録音中の画面と送信中の画面が同時にあっても、両方が外れるまで待ちます。以下のコードは実装からの抜粋で、名前は一般的なものに置き換えています。
const holdCounts = new Map<HoldReason, number>();
/** 待つ理由を1件登録する。返る関数で解除する(2回呼んでも1回だけ減る) */
export function registerHold(reason: HoldReason): () => void {
holdCounts.set(reason, (holdCounts.get(reason) ?? 0) + 1);
let released = false;
return () => {
if (released) return;
released = true;
const next = (holdCounts.get(reason) ?? 1) - 1;
if (next > 0) holdCounts.set(reason, next);
else holdCounts.delete(reason);
// (0件になった瞬間の知らせは省略)
};
}
/** 部品の側は1行で使う。active の間だけ登録し、終わればアンマウントでも必ず外れる */
export function useHold(active: boolean, reason: HoldReason): void {
useEffect(() => {
if (!active) return undefined;
return registerHold(reason);
}, [active, reason]);
}台帳だけでは拾えない書きかけもあります。自動保存の無い入力欄に打ちかけて、ほかの画面へ移った場合などです。これに備えて、どこかに入力してから2時間は入れ替えないという条件を足しました。判定は副作用を持たない関数にまとめ、テストで条件を1つずつ確かめています。
export function decideUpdate(input: UpdateInput): UpdateDecision {
const { currentBuild, latestBuild, settings, now } = input;
if (!settings.enabled) return { kind: 'disabled' };
if (!isBuildId(currentBuild) || !isBuildId(latestBuild)) return { kind: 'unknown' };
if (currentBuild === latestBuild) return { kind: 'same' };
// 直近2時間(returnNoInputMinutes)にどこかへ入力したか。台帳で拾えない欄の書きかけを守る
const typedRecently = now - input.lastInputAt < settings.returnNoInputMinutes * MINUTE_MS;
if (input.trigger === 'stale_error') {
// サーバに断られた=このままでは保存できない。録音・分析の待ちは案内も出さずに待つ
const holds = input.holds;
if (holds.some((h) => NO_NOTICE_REASONS.has(h))) return { kind: 'wait', reasons: [...holds] };
if (holds.some((h) => h !== 'dialog') || typedRecently) return { kind: 'show_save_blocked' };
if (holds.length > 0) return { kind: 'wait', reasons: [...holds] };
} else {
if (input.holds.length > 0) return { kind: 'wait', reasons: [...input.holds] };
// 戻った瞬間は「戻ったときの条件」だけで決める(裏にいた時間を、触れていない時間に数えない)
const idle = input.trigger !== 'return' && now - input.lastInteractionAt >= settings.idleMinutes * MINUTE_MS;
const returnedAfterLongAway = input.trigger === 'return' && input.awayMs >= settings.returnAwayMinutes * MINUTE_MS;
if (typedRecently) return { kind: 'wait', reasons: ['recent_input'] };
if (!idle && !returnedAfterLongAway) return { kind: 'wait', reasons: ['recent_activity'] };
}
return markAndReload(input); // 下の「開き直しの印」へ
}入れ替えてよいのは、待つ理由が0件で、2時間入力が無く、さらに次のどちらかのときです。1つは、画面に30分触れていないとき。もう1つは、30分以上ほかの画面やスリープにいて、戻ってきた瞬間です。後者は、朝に画面を開いたときにあたります。このほか、前の版の画面のままではサーバに受け付けてもらえなくなったときは、待つ理由も直近2時間の入力も無いことを確かめてから、その場で最新版に戻します(コードの stale_error の分岐)。書きかけがあれば戻さず、下の案内を出します。逆に、ほかの画面と短く行き来しているだけなら入れ替えません。
開き直しても前の版のままなら、どうするか
新しい版を出した直後は、途中の経路のキャッシュが前の版を返すことがあります。そのまま読み込み直すと、前の版がまた届き、また読み込み直す、という繰り返しになりかねません。そこで、読み込み直す前に端末へ「どの版を目指して、いつ、何回目か」の印を書き、書けたときだけ読み込み直します。同じ版を目指しているなら、15分あけて試し直します。回数で打ち切らず、画面を覆うこともしません。前の版でも、たいていの操作はそのまま続けられるからです。
function markAndReload(input: UpdateInput): UpdateDecision {
const { latestBuild, settings, now, storage } = input;
if (!storage) return { kind: 'show_button' }; // 印を書けない端末には、操作を止めない案内だけ
const mark = readReloadMark(storage);
const sameTarget = mark !== null && mark.build === latestBuild;
if (sameTarget && now - mark.lastAt < settings.retryMinutes * MINUTE_MS) {
return { kind: 'retry_later', attempt: mark.count }; // 15分たつまで待つ(画面は止めない)
}
const next = sameTarget
? { ...mark, lastAt: now, count: mark.count + 1 }
: { build: latestBuild, firstAt: now, lastAt: now, count: 1, reportedCount: 0 };
return writeReloadMark(storage, next) ? { kind: 'reload', attempt: next.count } : { kind: 'show_button' };
}書きかけがあるのにサーバに保存を断られたときは、画面の下に「古い画面のため保存できません」「内容を控えてから押してください」と〔最新版に更新〕の案内を出します。押すと書きかけが消えることを先に伝え、押すかどうかはご本人が決められる形にしました。録音中とAIの分析中は、この案内も出しません。また、端末に印を書けず自動で読み込み直せない端末には、「新しい版があります」「入力中でなければ更新してください」と閉じられる案内を出します。どちらも画面を覆わず、操作は止めません。
どのくらいの頻度で確かめ、通信量はどれだけ増えるか
確かめる頻度は、多すぎれば通信が増え、少なすぎれば前の版が長く残ります。MENTRA は新しい版を基本的に夜のあいだに出すので、間隔は3時間にしました。そのうえで、画面に戻ったとき、スリープから戻ったとき(1分ごとの時計が3分以上飛んだとき)、サーバに断られたときは、間隔を待たずにすぐ確かめます。値はコードに書かず、設定ファイルから読みます。
{
"enabled": true,
"checkIntervalMinutes": 180,
"focusCheckCooldownSeconds": 60,
"idleMinutes": 30,
"returnAwayMinutes": 30,
"returnNoInputMinutes": 120,
"returnRecheckSeconds": 120,
"retryMinutes": 15,
"fetchTimeoutSeconds": 10,
"clockJumpMinutes": 3,
"waitingLongHours": 6
}| 設定 | 値 | 何に効くか |
|---|---|---|
| 確かめる間隔 | 180分 | 1分ごとの時計で、前回からこれだけ過ぎたら取りに行く |
| 戻ったときに確かめない幅 | 60秒 | 前回から60秒以内の戻りでは取りに行かない |
| 触れていない時間 | 30分 | 待つ理由が無く、これだけ触れていなければ入れ替える |
| 戻った瞬間に入れ替える条件 | 裏に30分以上・入力なし120分 | 朝に開いた瞬間は入れ替え、短い行き来では入れ替えない |
| 判定し直す幅 | 120秒 | 戻った直後に一瞬だけ立つ待つ理由が外れたら、戻った瞬間の条件で判定し直す |
| 試し直す間隔 | 15分 | 読み込み直しても前の版のままなら、これだけあけて再び試す |
| 取りに行く時間切れ | 10秒 | 通信が詰まっても待ち続けない |
| スリープとみなす時計の飛び | 3分 | 1分ごとの時計がこれ以上飛んだら、戻ったとみなす |
設定は版の印と同じファイルに載せて配るので、間隔を2時間にしたいときは値を1つ変えて出すだけで、開いている端末も次に確かめたときに新しい値を使います。1分ごとの時計がすることは、次の4つのどれかだけです。
export function planTick(input: { now: number; lastTickAt: number; lastCheckAt: number; hidden: boolean; knownStale: boolean; settings: Settings }): TickPlan {
const { now, settings } = input;
if (input.hidden) return 'none'; // 裏にある画面では取りに行かない(戻ったときに確かめる)
if (now - input.lastTickAt >= settings.clockJumpMinutes * MINUTE_MS) return 'return'; // スリープから戻った
if (now - input.lastCheckAt >= settings.checkIntervalMinutes * MINUTE_MS) return 'check'; // 間隔が過ぎた
return input.knownStale ? 'decide' : 'none'; // 前の版と分かっていれば、取りに行かずに判定だけし直す
}
export function shouldFetchOnReturn(now: number, lastCheckAt: number, settings: Settings): boolean {
return now - lastCheckAt >= settings.focusCheckCooldownSeconds * 1000;
}通信量は、最初は「3時間おき」の分だけを数えていました。ところが、ほかの画面との行き来でも確かめるので、それでは少なく見積もりすぎます。試験の環境で、別のウィンドウとの行き来を10回して取りに行った回数を数え、見積もりを直しました。
| 数えたもの | 値 |
|---|---|
| ほかのウィンドウから戻った回数(実測) | 10回 |
| そのうち版の印を取りに行った回数(実測) | 8回(前回から60秒以内の2回は取りに行かない) |
| 1日の行き来を50回と置いたとき | 約40回 |
| 画面に向かう8時間のうち、3時間おきの確認 | 約3回 |
| 1台・1日 | 約43回 |
取りに行くのは版の印を書いた小さなファイル1つで、画面の部品を読み込み直すわけではありません。普通に画面を開いた直後も取りに行きません。読み込んだばかりの画面は最新だからです。
サーバ側の変更は、次の夜を越えてから出す
この仕組みを入れたことで、出す順番の決まりも1つ持てるようになりました。前の版の画面が受け付けられなくなる種類のサーバ側の変更(権限を閉じる・列や関数を消す・名前を変える)は、新しい画面を出したあと、次の夜を越えてから出す、というものです。夜のあいだの確認と、朝に画面を開いた瞬間の確認を通れば、前の版の端末はほとんど残らないからです。MENTRA では出す前の確認の手順に、本番の版の印から画面を出した時刻を読み、6時間以上あけた後の最初の朝9時を過ぎていなければ止める検査を入れています。
いまの流れを伺い、これまでとこれからを整理しました
これまでも、患者一覧の画面や問診の最初の画面を開いたときに版を比べ、新しければ読み込み直す仕組みはありました。ただ、職種によって最初に開く画面は違います。職種によっては、患者一覧を通らずに目的の画面を開く使い方もあります。どの画面から使い始めても同じように新しい版が届くよう、病院での画面の使われ方を職種ごとに確かめ、これまでとこれからを整理しました。
| これまで | これから | |
|---|---|---|
| 新しい版を確かめる画面 | 患者一覧・問診の最初の画面 | すべての画面(職員・問診・書類の問診・ログイン) |
| 確かめるきっかけ | その画面を開いたとき | 3時間おき・画面に戻ったとき・スリープから戻ったとき |
| 職員の操作 | 読み込み直しが要ることがある | ふだんは無し(何も表示しない) |
| 録音・入力・送信の間 | その画面では確かめない | 待つ理由として登録し、終わるまで待つ |
| 前の版のままの端末 | 次にその画面を開くまで残る | 15分おきに試し直し、画面は止めない |
| サーバ側の変更 | 画面と同じ夜に出すこともある | 画面を出した次の夜を越えてから |
厚生労働省の医療機関向けのセキュリティ教材も、端末やソフトの更新について「止めづらいシステムほど更新が後回しになりがちです」と書いています(MIST 病院あるある)。画面の更新も、止めずに届く形にしておくと、更新そのものを先送りせずに済みます。処理が途中で止まったときに機械が拾い直す仕組みは止まった処理を自動で復旧させる記事に、読み込み直しで録音を失わないための確認の条件は確認ダイアログの出し方の記事に、利用者から見た変化はプロダクトアップデートにまとめました。
自院のシステムで確かめるには
更新のお知らせが来るたびに、院内で「画面を開き直してください」と声をかけている。端末によって画面の見え方が違うと言われたことがある。夜間に入る電子カルテのアップデートの翌朝、念のため全端末を再起動している。医療機関で情報システムを担当されている方なら、思い当たる場面があるかもしれません。MENTRA では今回の仕組みを、職員の皆さまの操作を1つも増やさずに入れました。自院の流れに合わせたい場合も、まずいまの流れを伺い、整理するところからご一緒します。進め方は導入の流れに、院内の仕組みづくりのご相談は医療機関のDX支援にまとめています。
参考
よくあるご質問
昼に急ぎの更新を出したときは、どうなりますか
端末が新しい版に気づくのは、3時間おきの確認か、ほかの画面やスリープから戻ったときです。気づいたあとも、待つ理由が無く、直近2時間に入力が無く、画面に30分触れていない端末から入れ替わります。録音や入力が続いている端末は、それが終わって時間が空くまで待つので、急ぎの更新でも届くまでには時間の幅があります。
入れ替えを止めたいときは、どうしますか
設定の1項目を止める値にして出すだけです。設定は版の印と同じファイルで配っているので、開いている端末も次に確かめたときに新しい設定を読み、入れ替えをやめます。
患者さんが答えている問診の画面も入れ替わりますか
問診は、最初の画面と、送信と予約を終えた画面だけで入れ替わります。答えている途中や、送信のあとの予約の案内の画面では入れ替えません。
