アーキテクチャ概要

GrantForge は Spring Boot 4 アプリケーション（Java 17 バイトコード）であり、ドメインごとに複数の Maven モジュールへ分割され、1 つの実行可能な配布パッケージとしてビルドされます。コンソールは Vue 3 のシングルページアプリケーションで、サーバーが併せて提供します。

モジュール

サーバーと共有インフラストラクチャは core/ に、サーバーがロードするサービスタイプのプラグインは plugins/ に、対象システムへデプロイされる具体的なエージェントは agents/ にあります。core/grantforge-agent-core は共有プロトコルとランタイムを提供し、agents/grantforge-agent-hdfs-* は HDFS NameNode 向けの権限付与アダプターを提供します。

flowchart TB
  server[grantforge-server] --> oauth[grantforge-oauth]
  server --> service[grantforge-service]
  server --> authz[grantforge-authz]
  oauth --> authz
  service --> host[grantforge-plugin-host]
  service --> identity
  host --> api[grantforge-plugin-api]
  authz --> identity[grantforge-identity]
  identity --> audit[grantforge-audit]
  audit --> persistence[grantforge-persistence]
  persistence --> common[grantforge-common]
  agent[対象システム内のエージェント] -.-> agentcore[grantforge-agent-core]
  agentcore --> engine[grantforge-policy-engine]

上の図はモジュール間の依存関係です（common や persistence などの下位層はすべてのモジュールから依存されるため、図では繰り返しの辺を省略しています）。ポリシーエンジンは他のモジュールに依存せず、対象システム内のエージェントへ組み込まれます。各モジュールの ArchUnit テストは併せて共通の規約も守ります。フィールドインジェクションを使わない、ネイティブ SQL を書かない、エンティティを API に露出しない、すべてのパッケージをデフォルトで非 null にする、などです。

リクエスト 1 件の処理の流れ

sequenceDiagram
  participant B as コンソール
  participant F as フィルターチェーン
  participant G as PermissionGuard
  participant C as コントローラー
  participant S as ドメインサービス
  B->>F: セッション Cookie + X-XSRF-TOKEN
  F->>F: セッション、CSRF、テナントのバインド、アクティビティの記録
  F->>G: ログイン済み
  G->>G: アカウントの権限スナップショットを読み取り、インターフェースが宣言した権限コードを確認
  G->>C: 通過（レスポンスに X-Authorization-Version を含む）
  C->>S: 作業者情報を添えてサービスを呼び出し
  S->>S: データ範囲、フィールドのルール、業務上の検証
  S-->>B: JSON または RFC 9457 problem details

• コントローラーの各メソッドはアクセス方式（公開、ログイン済みであれば使用可能、権限コードが必要）を必ず宣言する必要があり、宣言のないメソッドがあるとサーバーは起動できません。
• 権限コードは同時に API リソースとしても登録されるため、インターフェースの権限付与もリソースカタログで管理します。
• エラーはすべて RFC 9457 problem details に統一され、安定した code、ローカライズされた detail、requestId を含みます。エラーコード を参照してください。

技術選定