ICTラウンドアプリ「めぐる君」 技術仕様書

文書番号: ICT-TS-001
対象者: 情報システム部門・委員会担当者
作成日: 2026年4月18日
最終更新日: 2026年11月6日
対象バージョン: 1.19.4


1. システム概要

項目 内容
システム名 ICTラウンドアプリ「めぐる君」
種別 クライアントサイド Web アプリケーション / PWA
目的 感染対策ラウンドの記録、保存、報告書作成の効率化
利用者 ICT メンバー、感染対策ラウンド実施者
配布形態 静的ファイル配信
データ保管先 ブラウザメモリおよび localStorage
ラウンド入力データの外部送信 なし(第7章・第8章を参照)
アクセス解析 Google Analytics 4 を導入(送信項目は 7.4 を参照)

2. アーキテクチャ

2.1 構成

[利用者端末]
  ├── Webブラウザ
  │     ├── React アプリ
  │     ├── Service Worker
  │     ├── localStorage
  │     └── Web APIs
  │          ├── File API
  │          ├── Canvas API
  │          └── Web Share API
  │
  ├── 静的ファイル配信サーバー
  ├── Google Fonts(フォント取得)
  └── Google Analytics 4(アクセス解析 / ラウンド入力データは送信しない)

2.2 バックエンド

2.3 主要技術スタック

分類 技術 実装上のバージョン
フレームワーク React ^19.3.0
言語 TypeScript ~5.9.3
ビルドツール Vite ^8.3.1
CSS Tailwind CSS ^4.2.2
Word 生成 docx ^9.8.1
.docx(ZIP)の読み書き jszip ^3.10.2
ファイル保存 file-saver ^2.0.5
チェックリスト読込 read-excel-file ^9.3.10

3. 画面構成

3.1 画面一覧

  1. ラウンド開始画面
  2. 保存済みラウンド一覧画面
  3. メイン画面
  4. 写真追加画面
  5. レポートプレビュー画面
  6. 統合ページ(/merge.html。アプリ本体とは別エントリの独立したページ。3.5 を参照)

3.2 メイン画面のタブ

固定ヘッダーには以下を表示します。

固定フッターには以下を表示します。

3.3 インストールバナー

未インストール環境では、ホーム画面追加を促すバナーを表示します。

3.4 アプリ本体以外の公開ページ

同一ホスト上に、アプリ本体とは独立した静的ページを配置しています。

パス 内容
/about 紹介ページ
/updates 更新履歴ページ(/updates/releases.json を読み込み)

これらは React アプリではなく単体の HTML です。ラウンド入力機能は持ちません。外部リソースの読込先は 7.1 を参照してください。

アプリ本体からは、次のリンクで公開ページを新しいタブに開きます。いずれも相対パスで、表示中のタブは移動しません。

置き場所 表示 開くページ
開始画面の下部 使い方 使い方ガイド(./docs/user-guide/。取扱説明書の公開ページ)
開始画面の下部 めぐる君について 紹介ページ(./about/)
ラウンド中のヘッダー ?(使い方) 使い方ガイド(./docs/user-guide/)

新しいタブで開くのは、次の理由からです。

3.5 統合ページ(/merge.html)

複数部署の報告書を 1 本の Word 報告書に統合するためのページです。表を扱うため PC ブラウザでの利用を想定しています。

3.6 アプリの紹介(「同僚に紹介する」)

開始画面の「同僚に紹介する」を押すと、紹介先を選ぶダイアログを表示します。ダイアログは紹介文と紹介ページの URL を、利用者が選んだ送り先に渡すだけです。

送り先 動作 utm_medium
メール mailto: で端末のメールアプリを開き、件名と本文(紹介文と URL)を入れる。宛先は空 email
LINE https://line.me/R/share を新しいタブで開き、紹介文と URL を渡す line
X https://x.com/intent/post を新しいタブで開き、短い紹介文と URL を渡す x
リンクをコピー Clipboard API で URL をクリップボードに書き込む。書き込めない場合は URL を画面に表示し、利用者が手で選択できるようにする copy
その他のアプリ Web Share API(navigator.share)で OS の共有画面を開く。対応する端末でのみ表示 share

3.7 お問い合わせフォームへのリンク(「ご意見・ご要望」)

質問や改善の要望を受け付けるため、運営者の Google フォーム(お問い合わせフォーム)へのリンクを置いています。

項目 値
アプリのバージョン ビルド時に埋め込んだ package.json の version
端末の種類 iPhone / iPad / Android / パソコン / その他 のいずれか(フォームの選択肢と同じ文字列)

4. データモデル

4.1 チェックリスト定義

interface ChecklistItemDef {
  id: string;
  category: string;
  description: string;
}

interface ChecklistCategory {
  category: string;
  items: ChecklistItemDef[];
}

interface SavedChecklist {
  id: string;
  name: string;
  createdAt: string;
  isDefault?: boolean;
  categories: ChecklistCategory[];
}

4.2 ラウンドデータ

type Rating = 'A' | 'B' | 'C' | null;

interface Photo {
  id: string;
  dataUrl: string;
  comment: string;
  timestamp: string;
}

interface ChecklistItemResult {
  itemId: string;
  rating: Rating;
  photos: Photo[];
}

interface RoundData {
  inspectorName: string;
  wardName: string;
  startTime: string;
  checklistResults: ChecklistItemResult[];
  generalPhotos: Photo[];
  overallEvaluation: string;
  checklistName?: string;
}

interface SavedRound {
  id: string;
  title: string;
  savedAt: string;
  version: 1;
  checklistId: string;
  roundData: RoundData;
}

4.3 部署間の受け渡し形式

報告書の .docx に同梱し、統合ページが読み取る形式です(6.6、6.8 を参照)。統合ページは localStorage を参照しないため、チェックリスト定義も併せて同梱します。

interface RoundExport {
  format: 'meguru-round';
  version: 1;
  exportedAt: string;
  checklistName: string;
  categories: ChecklistCategory[];
  roundData: RoundData;
}

読み込み時は format と version に加え、統合処理が参照するフィールドの型(カテゴリと項目、担当者名・部署名・実施日時・総評、チェック結果の項目 ID・評価・写真)を実行時に検証します。想定外の内容は「どこが不正か」を示して読み込みを中止します。


5. 永続化仕様

5.1 localStorage キー

キー 内容
icn-round:checklist-library 保存済みチェックリスト一覧
icn-round:active-checklist-id 選択中チェックリスト ID
icn-round:saved-rounds 保存済みラウンド一覧(担当者名・病棟名・評価・写真・総評を含む)
icn-round-theme テーマ設定
icn-round-icon アイコン設定
pwa_install_tracked インストール計測の重複送信防止フラグ
pwa_banner_dismissed インストールバナーを閉じたかどうか
icn-round:last-seen-version 新機能のお知らせを最後に確認したアプリのバージョン
icn-round:round-used 通常のラウンド(サンプル以外)を保存、または報告書を出力したことがあるか(値は 1。開始画面の「サンプルデータで試す」の出し分けに使う。6.1.1 を参照)

IndexedDB、Cookie、sessionStorage はアプリ本体では使用していません。Cookie は Google Analytics 4 が設定します(7.4 を参照)。

5.2 保存方針

5.3 保存形式と暗号化

暗号化を実装していない理由

本アプリはバックエンドを持たないため、暗号鍵の保管場所が JavaScript のバンドル内しかありません。バンドルは誰でも取得して内容を確認できるため、鍵を同梱した暗号化は次のいずれの脅威にも効果がありません。

脅威 バンドルに鍵を同梱した暗号化の効果
端末の紛失・盗難 効果なし(OS のストレージ暗号化と画面ロックが防御にあたる)
共用端末で他者がアプリを開く 効果なし(アプリが自動的に復号するため素通りする)
XSS・悪意のあるブラウザ拡張 効果なし(同一コンテキストから鍵を参照できる)
ストレージの物理的な解析 効果なし(鍵が公開されているため。OS 暗号化が防御にあたる)

実効性を持たせるには利用者ごとのパスフレーズ入力と鍵導出(PBKDF2 等)が必要ですが、起動のたびに入力が発生すること、失念時に復号不能となりデータを失うことから、ラウンド業務での可用性を著しく損ないます。

以上より、保存データの機密性は端末側の管理策(画面ロック、ストレージ暗号化、MDM)で担保する方針としています。施設の要件として利用者認証つきの暗号化が必要な場合は、別途ご相談ください。

併用を推奨する運用上の対策

暗号化の有無にかかわらず、端末内に記録が残り続けること自体が主要なリスクです。次の運用を推奨します。

5.4 初期データ

初回起動時、seedDefaultIfFirstRun() により標準チェックリストを 1 件生成します。


6. 機能仕様

6.1 ラウンド開始

6.1.1 サンプルデータで試す

初めて使う利用者が、入力済みのサンプルで報告書の出力までを試すための機能です(実装: src/sampleRound.ts、src/samplePhotos.ts、src/useSampleStart.ts、src/useRound.ts)。

6.2 チェックリスト評価

6.3 チェックリスト取り込み

6.3.1 チェックリストの作成・複製(エディタ)

この ID の振り方は、複数部署の報告書の統合(6.8)とも関係します。統合では行を「項目 ID + カテゴリ名 + 項目の文言」で識別し、同じ項目 ID に別の項目が割り当てられていると、行を分けたうえで警告を表示します。エディタで複製・編集したチェックリストでは、カテゴリ名と文言が複製元と同じ項目だけが複製元の ID を引き継ぎ、文言かカテゴリ名を変えた項目には新しい ID を振ります。空にして削除した項目の ID も、新しく振る ID には使いません。そのため、複製元のチェックリストで記録した報告書と、複製・編集したチェックリストで記録した報告書を統合しても、変更していない項目は同じ行にまとまり、同じ ID が別の文言を指すことによる行の食い違いと警告を避けられます。なお、片方にしかない項目がある場合の警告(6.8)は、この ID の振り方とは別に表示されます。

6.4 写真入力

6.5 総評入力

6.6 レポートプレビュー / 出力

6.7 外観設定

6.8 複数部署の報告書の統合

統合ページ(3.5)の機能です。サーバーを介さず、利用者が集めたファイルをブラウザ内で処理します。


7. 通信・オフライン

7.1 外部通信

アプリ本体(/)が自動で行う通信は以下がすべてです。利用者の操作で開く外部サービスは、この表の後に別記します。

通信先 用途 ラウンド入力データの送信
配信元ホスト HTML / JS / CSS / 画像配信、更新履歴データ(/updates/releases.json)、サンプルの写真(/sample/*.jpg、6.1.1) なし
fonts.googleapis.com Google Fonts CSS なし
fonts.gstatic.com Google Fonts 本体 なし
www.googletagmanager.com gtag.js の取得 なし
www.google-analytics.com アクセス解析イベントの送信(7.4) なし

利用者の操作で開く外部サービス: 次の場合に限り、外部サービスのページを新しいタブで開きます。アプリが自動で外部サービスへ接続することはありません。

開く先 開くとき URL で渡す内容 ラウンド入力データ
line.me / x.com 開始画面の「同僚に紹介する」で利用者が LINE または X を押した場合(3.6) アプリに固定で書かれた紹介文と、公開している紹介ページの URL なし
docs.google.com(お問い合わせフォーム) 開始画面の「ご意見・ご要望」、または報告書の出力後に表示する「使ってみた感想を送る」を利用者が押した場合(3.7) アプリのバージョンと端末の種類(フォームの事前入力) なし

紹介ページ /about と更新履歴ページ /updates は、上記に加えて以下を読み込みます。これらのページにラウンド入力機能はありません。

通信先 用途
cdn.tailwindcss.com Tailwind CSS(CDN 版)
api.qrserver.com アプリ URL の QR コード画像生成(/about のみ)

統合ページ /merge.html から発生する通信は、配信元ホスト(HTML / JS / CSS)と Google Fonts(fonts.googleapis.com / fonts.gstatic.com)のみです。アクセス解析(gtag.js)は読み込まず、Service Worker も登録しません。読み込んだ報告書ファイルの内容を外部へ送信する処理はありません。

/about には同じお問い合わせフォームへのリンク(forms.gle)を設置していますが、これはページ読込時に通信するリソースではなく、利用者がリンクを押して遷移した場合にのみ通信が発生する外部サイトです。フォームへ入力した内容は Google のサービス上で処理されます。

7.2 Service Worker

index.html で ./sw.js を登録します。

キャッシュ戦略は以下です。

7.3 オフライン動作

7.4 アクセス解析(Google Analytics 4)

7.4.1 構成

7.4.2 送信するイベント

イベント 送信契機 パラメータ
page_view 初回表示時(SPA のため実質1回) gtag 標準項目
pwa_install インストール検知時 method(appinstalled / standalone_first_launch)
pwa_install_banner_click インストールバナーの操作 method
pwa_install_prompt_result インストールプロンプトの結果 outcome
pwa_install_banner_dismiss バナーを閉じた時 method
photo_add_attempt 写真追加画面で「撮影」または「ギャラリーから選択」を押した時 method(camera / gallery)
photo_add_success 選択した写真の読み込みに成功した時 method(camera / gallery)、photo_age(ファイルの最終更新時刻から選択時までの経過時間の区分。1 分以内 under_1m / 10 分以内 1m_10m / それより前 over_10m。端末の時計のずれで未来の時刻になった場合は under_1m。時刻そのものは送信しない。ブラウザによってはギャラリーから選んだファイルの最終更新時刻が選択した時刻になるため、撮影時期を正確に表す値ではなく、method と組み合わせて傾向を見るための値)
photo_add_failure 写真の追加が完了しなかった時。1 回の photo_add_attempt に対し、photo_add_success と合わせて最大 1 回 method(camera / gallery)、reason(ファイルが 10MB を超えた too_large / 写真の読み込み・縮小に失敗した compress_error / 選択画面やカメラを閉じた cancelled。cancelled はファイル選択の cancel イベントに対応したブラウザでのみ送信)
checklist_import_open チェックリスト取り込みダイアログを開いた時 なし
checklist_import_error 取り込むファイルの読み込みに失敗した時 file_type(csv / xlsx)
checklist_import_success 取り込んだチェックリストを保存した時 file_type(csv / xlsx)
checklist_editor_open チェックリストのエディタを開いた時 source(new / copy)
checklist_editor_save エディタで作成したチェックリストを保存した時 なし
round_start ラウンドを新しく開始した時(サンプルを含む。保存済みラウンドを開いた時は送信しない) sample(サンプルなら true、通常のラウンドなら false)
report_open 報告書の画面を開いた時(画面を開くたびに 1 回) sample(サンプルなら true、通常のラウンドなら false)
round_export 報告書の共有が完了した時、またはファイル保存を実行した時(共有をキャンセルした場合は送信しない) method(share / download)、sample(true / false)
help_open 「使い方」を押した時 from(開始画面 start / ラウンド中のヘッダー round)
about_link_click 開始画面の「めぐる君について」を押した時 なし
app_share 「同僚に紹介する」のダイアログで、メール・LINE・X を押した時、リンクのコピーに成功した時、その他のアプリの共有が完了した時(共有をキャンセルした場合は送信しない) method(email / line / x / copy / share)
feedback_open お問い合わせフォームへのリンクを押した時(3.7) from(開始画面の「ご意見・ご要望」 start / 報告書の画面の「使ってみた感想を送る」 report)

写真の追加・チェックリストの取り込みと作成・ラウンドの開始・報告書の画面の表示と出力・使い方の表示・アプリの紹介・お問い合わせフォームを開く操作に関するイベントは、操作の種類と押した場所、サンプルかどうか、写真の新しさの区分、写真の追加が完了しなかった理由の種類だけを送信します。写真、撮影日時、ファイル名、ファイルサイズ、チェックリストの内容や件数、エラーメッセージは含みません。

上記に加え、GA4 が自動収集する session_start、first_visit、user_engagement が送信されます。 ユーザープロパティとして display_mode(standalone / browser)を設定します。

7.4.3 送信しないもの

以下は GA4 へ一切送信しません。送信する実装が存在しません。

アプリは SPA であり、URL に入力値を含めないため、page_view の URL 経由で入力内容が送信されることもありません。

7.4.4 GA4 側で取得される標準情報

gtag.js の標準動作として、以下が Google に送信・記録されます。

データ保持期間は GA4 の設定で 14 ヶ月としています。

7.4.5 エラーログ収集

Sentry 等のエラー監視サービスは導入していません。例外情報を外部へ送信する実装はありません。

7.5 音声入力について

本アプリに音声入力機能はありません。 マイクを使用せず、音声データを扱う実装も持ちません。

なお、利用者が端末キーボードの音声入力(iOS の音声入力、Android の音声認識など)を用いて総評を入力することは可能です。この場合の音声データの扱いは端末 OS の機能に属し、本アプリの管理外です。OS の実装によっては音声が OS 提供元のサーバーへ送信されて認識されるため、利用可否は各施設のポリシーに従って判断してください。


8. セキュリティ・個人情報

8.1 取り扱うデータ

これらはすべて利用端末内にとどまります。バックエンドが存在しないため、サーバー側に保管される複製はありません。

ただし、担当者が共有・保存する報告書 .docx には、統合機能のためにラウンドデータ(担当者名・病棟名・評価・写真・総評)が機械可読な形で同梱されます(6.6)。統合ページが出力する統合報告書には同梱されません。ファイルを渡した相手には、報告書の記載内容とあわせてこのデータも渡ることになります。端末外へ持ち出したファイルの管理は利用施設の運用に委ねられます。

8.2 外部送信

8.3 保存データの暗号化

8.4 個人情報上の留意点

8.5 認証


9. ホスティング要件

9.1 配信条件

9.2 Vite 設定

9.3 配置ファイル


10. ビルド・運用

10.1 コマンド

npm install
npm run dev
npm run build
npm run preview
npm run lint

10.2 本番ビルド

10.3 更新反映


11. 既知の実装前提


12 関連文書

文書 内容 公開 URL
docs/privacy-policy.md プライバシーポリシー https://ict-round.conect.llc/docs/privacy-policy/
docs/user-guide.md 取扱説明書 https://ict-round.conect.llc/docs/user-guide/

この技術仕様書自体も https://ict-round.conect.llc/docs/technical-spec/ で公開しています。公開ページは上記の公開対象3文書の Markdown からビルド時に生成しており、内容は同一です。docs/ 配下のその他の文書は公開していません。


13 ライセンス

Apache 2.0