通院付き添い・訪問ケアのマルチロール型プラットフォーム
通院付き添い、介護スタッフ、訪問サービスの注文を扱うモジュラーモノリスのプラットフォーム。患者向けミニプログラム、スタッフ向けミニプログラムとアプリ、病院と運営者のコンソール、支払いの分配と精算を担う独立した台帳ドメインで構成されます。
要点: 付き添いと訪問ケアの注文について、患者、スタッフ、病院、運営者にサービスを提供するバックエンドをモジュラーモノリスで構築しました。お金の動きは独立した台帳スキーマに分け、手配と追跡はスマートフォン上のミニプログラムでできる範囲に絞りました。
概要
患者と家族はミニプログラムから注文します。スタッフは別のミニプログラムとFlutterアプリで仕事を受け、完了させます。病院と運営者はWebコンソールを使います。開発は構造化したアーキテクチャレビューから始まり、フレームワークの選択よりもコンプライアンスと支払い分配のリスクを先に扱いました。
課題
付き添いとケアのサービスには、患者、家族、スタッフ、病院、運営者と複数の当事者が関わり、それぞれ別の画面が必要です。支払いは決済チャネルのルールの範囲内で、プラットフォームとサービス提供者の間で分配しなければなりません。位置情報と仕事の割り当ても、スマートフォン上のミニプログラムが実際にできる範囲で動かす必要があります。
制約
- 患者側の入口はメッセージングプラットフォームのミニプログラムのみ。スタッフ側は必要な権限が異なるため、別のアプリIDが必要。
- ミニプログラムはバックグラウンドで一時停止するため、常時のライブ追跡は確実に守れる約束ではなかった。製品上の表現は「サービスの各ステップを記録」に改めた。
- 決済チャネルは支払いのうち分配できる割合を制限している。精算ルールはこの制限に収める必要があった。
- 訪問看護は、省の看護サービス基準に基づく許認可と記録機器の要件を満たせるまで、最初のマイルストーンから外した。
アーキテクチャ
| 部分 | 実装 |
|---|---|
| バックエンド | Java 21、Spring Boot 4.1。order、staff、hospital、market、pay、settle、notifyなど15のドメインモジュールを持つMavenマルチモジュールのモノリス |
| データ | 業務と台帳のスキーマを分けたPostgreSQL 17。台帳ドメインはjOOQ、業務ドメインはSpring Data JDBC。スキーマ変更はすべてバージョン付きのFlywayマイグレーション |
| クライアント | プラットフォームのネイティブフレームワークで作った2つのミニプログラム、スタッフ向けFlutterアプリ、Vue 3の病院・運営コンソール |
| ローカル環境 | メッセージングプラットフォームのモックサービスを含むDocker Compose。ログインと決済のフローを本番の認証情報なしで動かせる |
主な判断
- マイクロサービスではなくモジュラーモノリス。 注文、手配、精算を一つのデプロイ単位にまとめ、トランザクションをローカルに保ちます。モジュールの境界はネットワーク越しではなくコードで強制します。
- 独立した台帳ドメイン。 精算と分配は専用スキーマで明示的なSQLとして書き、業務ドメインが金銭の記録を直接書くことはありません。お金の動きはすべて一つのモジュールまでたどれます。
- 守れない約束はしない。 注文を一斉に流して早い者勝ちにするのではなく、指名による割り当て、確認タイムアウト時のエスカレーション、自動音声電話でスタッフを手配します。
- コードより先に契約。 API、データベース、テーマ、環境、テストの契約を先に文書化し、アーキテクチャレビューではプロジェクトオーナーにしか決められない項目を記録しました。
根拠
- バックエンドにJavaのテストクラス287、バージョン付きマイグレーションファイル156。
- リポジトリの文書には、全体の監査報告(2026-09-17)と納品レビュー(2026-09-19)が含まれます。
限界
注文数、現在の運用状況、提携機関、金銭的な条件は公開していません。この事例での規制の解釈はエンジニアリング上の参考情報であり、法的助言ではありません。
よくあるご質問
患者向けにネイティブアプリではなくミニプログラムを選んだのはなぜですか?
患者は病院でコードを読み取って入ってきます。アーキテクチャレビューでは、この入口と決済チャネルにはミニプログラムが合っており、別のネイティブアプリは患者にとって得るものが少ないと判断しました。
お金はどう扱いますか?
台帳ドメインは独自のスキーマを持ち、金銭の記録を書き込むのはこのドメインだけです。分配ルールは決済チャネルの制限内で設計しています。
スタッフのリアルタイム追跡には対応していますか?
プラットフォームはサービスの各ステップを記録します。ミニプログラムはバックグラウンドで位置情報を送り続けられないため、常時のライブ追跡は約束していません。