アーキテクチャ

1つのPythonプロセスがFastAPIパネルと、任意の数の分離されたワークスペースをホストし、 各ワークスペースにはTelethonユーザーアカウントクライアントが配置されています。 SQLiteには、追記専用の署名付きイベントジャーナルと、変更可能な運用設定が格納されています。 暗号化された保管庫には、API認証情報、StringSession、および署名鍵が格納されています。 フロントエンドは、HTML/CSS/JavaScriptをバンドルしたシンプルな形式となっており、Nodeによるビルド、CDN、 あるいは実行時のフロントエンドダウンロードは一切必要ありません。

監視ハンドラーは、接続前に登録されます。リアルタイム収集は、 アクティブなクライアントID、明示的な実行状態、有効化されたソース、または監視 範囲（フォルダモードやアカウント全体モードでは、最初の更新時に新しいチャットがソースとして追加されます）、およびイベント ポリシーによって制御されます。拒否されたクライアントや置き換えられたクライアントは、リアルタイムの更新情報を提供できません。 生の反応およびメンバーシップの更新は、 可視性の制限を保持します。受信メッセージの内容とその永続的なメディアジョブは、 一緒にコミットされます。ジョブは元のTL記述子を保持し、そのハッシュを 署名付きメッセージの観測に紐付けます。送信者／編集者／削除者のセマンティクスは分離されています。

各ワークスペースは1つのアカウントのみを受け入れ、独自のディレクトリと署名用IDを持っています。 互換性を確保するため、メインのワークスペースはルートディレクトリに配置され、追加のワークスペースは profiles/<id>/ に配置されます。1つのベアラートークンがインストール全体を管理しており、ワークスペースは 独立した認証テナントではありません。 プロセスロックによりディレクトリが保護され、データベースロックにより イベントの挿入がシリアライズされます。各追加処理は、FULL同期モードの SQLite WALに対して同期的にコミットされます。イベントの更新・削除トリガーにより、 通常のアプリケーションによる編集が防止され、ファイルシステム管理者は信頼境界内に留まります。

APIの認証にはベアラートークンが使用されます。ログイン操作はシリアル化され、時間制限が設けられています。 アカウントへのアップロードには、エンコード済みボディの制限として12 MiB、デコード済みファイルの 制限として8 MiBが設定されています。通常のAPIリクエストについては、16 KiBの制限が維持されます。 変換処理はワーカースレッドで実行され、 アップロードデータをメモリ内に保持し、正規化された入力を認証済みの ブラウザに返します。QRログインには、ワークスペースごとの候補、短命な識別子、待機タスク、 および明示的なキャンセル機能が備わっています。承認された認証のみがアクティブなクライアントとなります。 Telegram FloodWaitはRetry-After値と共に返されます。認証情報および生のRPC エラーメッセージは、APIエラーでは公開されません。エクスポートは非同期イベント ループの外で実行され、ワークスペースごとにシリアル化されます。これらは安定した読み取りスナップショットをストリーミングし、 継続中のWAL書き込みと共存することができます。 ワークスペースコレクターは、プロセスおよびイベントループを共有します。

現在の履歴スナップショットとリアルタイムの更新情報は重複する場合があります。これらはそれぞれ独立した観測データであり、 ソースごとにラベル付けされています。重複データは自動的に折りたたまれることはありません。IDの欠落、 削除されたテキストの捏造、メンバーの強制的な列挙、またはグループへの自動参加 に基づく推論機能は実装されていません。

運用担当者向けの説明については、「収集の仕組み」 および「アカウントとセッションの形式」をご覧ください。

ネットワーク設定は暗号化された保管庫に格納されています。ルートを適用すると、古い クライアントが閉じられ、未完了のログインがキャンセルされます。その後の接続では、そのルートが使用され、 直接的なフォールバックは行われません。 新しい外部キーによるインストールでは、マスターキーファイルと保存されたランダムなソルトから、 HKDF-SHA256 を使用して各ワークスペースの Fernet キーが生成されます。これにより、 機密情報はデータディレクトリとは別に保護され、ジャーナルやメディアのコンテンツが平文で保存されることはありません。

ローカルデモへのアクセスには、別途生成されたプロセス機能を使用しており、設定済みの パネルトークンは一切使用しません。発行および受諾には、明示的なデモモード、追加のワークスペースや認証済みセッションを伴わない合成ルート、 ループバックピア／ホスト、プロキシ 転送ヘッダーなし、およびクロスオリジンブラウザリクエストなしが必須となります。 本番用APIはベアラー 認証を維持し、デモモードでの収集変更を拒否します。