メインコンテンツまでスキップ

アーキテクチャ

Merlon は主に日本の非銀行系金融機関向けに設計された、セルフホスト型の AML/CFT アプリケーションである。本文書は、コンポーネント境界と運用上の統制を理解する必要がある開発者・運用担当者を対象とする。

External systems ── REST/webhooks ──> Go API (native engine)
                                         │
                                         └──────────────> PostgreSQL
React operator UI ─────────────── REST ────────────────> Go API

コンポーネント​

  • React UI（ui/） はオペレーター向けダッシュボードを提供する。
  • Go API（api/） は顧客・取引データを受け付け、REST エンドポイントを公開し、ケースおよびレポートを管理し、バックグラウンド処理をオーケストレーションする。
  • ネイティブ評価エンジン（api/internal/engine/native/） は CDD スコアリング、取引モニタリングルール、スクリーニングリスト、バックテストを Go プロセス内で評価する。
  • PostgreSQL は運用記録、スコア履歴、監査ログを永続化する。Redis とオブジェクトストレージはオプションのデプロイメント連携である。

評価エンジンの契約は Go の内部インターフェースで管理し、外部クライアントには REST/OpenAPI 契約を提供する。

設計原則​

  1. 監査可能性優先（Auditability first） — 判断の根拠と追跡可能な操作を保持する。
  2. 設定としての製品（Configuration as the product） — ルールをアプリケーションコードではなく、バージョン管理された YAML/JSON 設定として表現する。
  3. スコア駆動型アーキテクチャ（Score-driven architecture） — CDD スコアがモニタリングとレビュー優先度に反映される。
  4. アダプタによる分離（Adapter isolation） — 外部システムの差異を境界で正規化する。
  5. デフォルトで安全（Secure by default） — シークレットとメトリクスエンドポイントはデプロイメント側の統制で保護されなければならない。
  6. 契約の安定性（Contract stability） — 外部契約の互換性を最低 12 ヶ月維持する。
  7. フェイルアラート（Fail-alert） — 検知漏れを黙って見逃すより、レビュー可能なアラートを優先する。

運用上の境界​

1 つのデプロイメントは 1 つの機関にサービスを提供する。Merlon はあらゆる法域における規制遵守を保証するものではない。導入組織自身が、法的評価、ルールガバナンス、シークレット管理、バックアップ／リストア手順、および Engine 設定ファイルの管理について責任を負う。詳細は デプロイメントランブック および ADR-0012 を参照。