規制当局向け安全データ報告の設定型ゲートウェイ
企業のソースデータを標準オブジェクトに、さらに各規制当局のメッセージ形式にマッピングする報告プラットフォームを設計しました。設定は9ステップのウィザードで行い、シークレットは読み取り専用でマウントします。ハードコードされた旧来の報告サービス2つを置き換えました。
要点: ハードコードされた2つの報告サービスを一つのゲートウェイに置き換えました。企業データを標準オブジェクトに、さらに各規制当局のメッセージ形式に、コードではなく設定でマッピングします。署名、送信、受領確認、再送、監査は最初から組み込んであります。
概要
規制対象の安全分野にある工業企業は、作業許可、人員、リアルタイム位置、リスク管理のデータを行政のプラットフォームに報告しなければなりません。プラットフォームごとに項目、署名、暗号化、受領確認のルールが異なります。導入担当者は9ステップのウィザードで新しい接続を設定し、シークレットはホスト上に読み取り専用でマウントします。
課題
これまでは、新しい企業、企業側システムの新バージョン、規制当局プラットフォームの新バージョンが出るたびに、旧来のサービスのコードを変更していました。業務上の意味はスクリプトと特例処理に散らばっていました。接続作業は開発者頼みで、監査も困難でした。
制約
- 旧コードは業務上の特例を見つけるために使ってよいが、新しいアーキテクチャの形を決めるために使ってはならない。
- 導入担当者はSQL、YAML、JSON、スクリプトを編集しない。設計目標は、新規接続の95%以上をUIで設定し、残りを安定したプラグインインタフェースで扱うこと。この目標は実データでまだ証明する必要がある。
- オフラインの拠点を含む顧客の構内でのデプロイ。イメージのアーキテクチャを固定し、イメージIDを検証できること。
- 認証情報は設定に保存しない。保存するのは論理的な参照だけ。
アーキテクチャ
| 部分 | 実装 |
|---|---|
| バックエンド | Java 21、Spring Boot 4.1、MySQL 8、FlywayマイグレーションV1〜V14 |
| コンソール | Vue 3 + TypeScriptの設定UI |
| マッピング | 2段階。ソース項目から標準オブジェクトへ、次に標準オブジェクトから送信先メッセージへ。スクリプト言語ではなく閉じた式ツリーで表現 |
| ウィザード | 9ステップ:範囲、データソース、調査、標準マッピング、送信先メッセージ、プラットフォームの機能、テスト、承認、リリース |
| 送信ランタイム | 認証、署名、暗号化。HTTP、TCP、メッセージングの各トランスポート。同期・非同期の受領確認。スケジューリング、増分、冪等性、再送、再報告、突き合わせ |
| シークレット | コンテナにマウントする読み取り専用のファイルベースのシークレットストア |
主な判断
- 閉じたマッピング言語。 範囲の決まった式ツリーは、自由なスクリプトと違ってリリース前に検証と監査ができます。レビュー担当者は、マッピングが何を送るかを正確に確認できます。
- 中間に標準オブジェクト。 ソースと送信先は標準オブジェクトでしか接しないため、新しい企業システムや規制当局の新バージョンを追加しても、マッピングの片側にしか手が入りません。
- 既定で安全な運用。 スモークテストはヘルスチェックだけを行い、実際の送信には明示的なフラグが必要です。データベースが新しいマイグレーションに上がった後はロールバックがイメージのダウングレードを拒否し、代わりにアップグレード前のバックアップを使うよう運用者に案内します。
根拠
- バックエンドのテストクラス78。バージョン付きマイグレーション14。最初の範囲の業務ドメインは4つ:作業許可、人員、リアルタイム測位、二重予防のリスク管理。
- 要件ベースライン、監査報告、意思決定ログ、段階的な受け入れチェックリスト、デプロイ手順書は納品物に含まれます。
限界
95%を設定で賄うという目標は設計目標であり、現場ではまだ検証されていません。規制当局の名前、エンドポイント、企業データは公開していません。
よくあるご質問
開発者でなくても新しい企業の接続を追加できますか?
それが設計目標です。導入担当者は9ステップのウィザードに沿って作業します。製品の範囲外の機能はコアの変更ではなく、プラグインインタフェースで扱います。
認証情報はどう保護されていますか?
設定に保存するのは論理的な認証情報の参照だけです。実際のシークレットはホスト上の読み取り専用でマウントしたディレクトリから読み込みます。
オフラインで動きますか?
ネットワークにつながったマシンでイメージをビルドしてエクスポートし、現地でロードしてイメージIDで確認できます。