システム設定パラメータリファレンス

CXMind はクラウドネイティブなアーキテクチャの理念に基づき設計されており、システム内のすべてのマイクロサービス（基礎となる Ingestion Engine、バックエンドロジック処理、管理インターフェースを含む）の実行パラメータは、環境設定（.env）を通じて分離および管理されます。

1. 設定の注入方法

Docker Compose に基づく標準的なデプロイでは、関連するすべての環境変数はプロジェクトのルートディレクトリにある .env ファイルで一元的に保守されます。

初めてデプロイする際は、プロジェクトに付属しているサンプル設定ファイルを直接コピーすることができます：

cp .env.example .env

その後、お好みのテキストエディタを使用して重要なパラメータを編集してください。

2. コアモジュール設定の概要

2.1 基礎エンジン接続パラメータ (IE)

変数名	デフォルト値	グローバルな説明
REDIS_ADDR	redis:6379	リアルタイムアラート、監視ストリーム、および分散メモリキューサービスのアドレス
DB_DSN	...	バックエンド永続化データベースの接続文字列。通話明細レコード (CDR) の保存に使用されます
LISTEN_HEP	0.0.0.0:9060	Ingestion Engine が Homer/PBX からの HEP カプセル化データストリームを待受する IP とポート

2.2 JWT および認証設定 (AS & AU)

通信の安全性を確保するため、管理コンソールバックエンドの API にはトークンの検証が必要です：

• JWT_SECRET: （必須）すべての承認トークンの署名と検証に使用されます。本番デプロイ時、この値は必ず強力でランダムに生成された文字列に変更してください。
• ADMIN_EMAIL: 初期デプロイ時のデフォルトネットワーク管理用のアカウント（メールアドレス）。
• ADMIN_PASSWORD_HASH: 初期デプロイ時のデフォルトアカウント用のシークレットハッシュ。

2.3 クロスオリジン通信制御 (CORS)

フロントエンドとバックエンドが分離されたアーキテクチャでは、セキュリティ攻撃を防ぐため、設定項目を通じてクロスオリジン・ポリシーが制限されます：

• ALLOWED_ORIGINS: 管理コンソールバックエンド API へのアクセスを許可するドメイン名のホワイトリスト。例：http://localhost:5173,https://admin.yourdomain.com。

3. Pro 向け高度機能の特別設定オプション

有効な商用ライセンス LICENSE_KEY をインポートすると、以下の設定が有効になります：

• AI_PROVIDER: 音声感情および意図分析プロバイダーの統合選択（例：OpenAI、Azure）。
• AUDIO_STORAGE_PATH: RTP 音声録音ファイルの物理メディアマウントパス。
• MAX_CONCURRENT_CALLS: ライセンスから読み取られる、ノードあたりの最大 RTP 解析数のソフト制限。

このリリースの詳細および非表示の開発用デバッグパラメータの完全なリストについては、ソースコードリポジトリのルートディレクトリにある docker-compose.yml の宣言セクションを参照してください。