🏠 日本語ドキュメント
English →

🏠Aegis Voice Firewall — System Overview

代表電話の入口・AI 受付・人への取次の全体像と、このサイトの歩き方。

Aegis（イージス）は、法人の代表電話の入口で、名簿・AI 受付・人への取次を組み合わせる 「通話の司令塔」です。稼働中・PR・枝・設計の境と現在の経路は SSoT が正です。

初めての方はまず → はじめに — Aegisの全体像

全体像（Route A / Route C）

📞 着信（発信者） 代表電話 / ひかり電話 HGW Raspberry Pi 3B（1階・宅内） Asterisk 22 Voice Edge / Layer 1 bridge.py chan_audiosocket :9092 移植予定（32bit→64bit・ 残課題参照） RTS RDS Arrowfone Route A：Retell（現行運用が主） Route C：OpenAI Realtime（Phase A/C） Retell AI（SIP / inbound webhook） Custom LLM webhook /llm/* OpenAI Realtime GA gpt-realtime Aegis Cloud（Layer 3） classify_call → tools_core → verdict spam → Hangup fail-safe（遮断） allow → 正常転送 ALLOW_DESTINATION unknown → 人へ取次 fail-open（業務継続）
図: Route A（Retell）と Route C（OpenAI Realtime）が Aegis Cloud で合流し、verdict（spam / allow / unknown）で 3 分岐する。spam=fail-safe で遮断、unknown=fail-open で人へ取次。実線の紫枠 = Raspberry Pi 3B（宅内）の機器境界（Asterisk 22 + chan_audiosocket + bridge.py）で、HGW・Retell・OpenAI・Aegis Cloud（NAS）は枠外。点線=64bit移植後に同居予定の既存Rhodium機能。

2階建てと2つの関門（旧・SUN4 以前）

📌この節と図は旧・SUN4 以前

以下は旧構成の説明です。稼働中の経路は SSoTを参照してください。

実電話番号の経路（Phase C）は 2階建てで考える。1階が現場のエッジ（Pi: voice-edge = Asterisk 22 + bridge.py）、2階が頭脳（NAS: aegis-platform）。 守りの門は 2 つある:

  • 第1関門（着信時・通話前）: dialplan が route-decision API に問い合わせる。応答の語彙と障害時の扱いは SSoT「verdict の流れ」を参照する。
  • 第2関門（通話中）: 通話中の判定は第1関門とは別レイヤ。稼働中の動作と設計との差は SSoT「2026-10-13 の正」を参照する。
📌第2関門の旧・SUN4 以前の説明

AI の classify_call が should_terminate を返しても、旧記録上の現行コードは切断しない （AMI Hangup の経路は残っているが発火しない・2026-09-16 確定設計で撤去予定）。用件を預かる側へ進み、 人を求めた発信者は人へ。route-decision（通話前）と通話中の判定は別レイヤです。

2階 — 頭脳（NAS）: aegis-platform / Aegis Cloud route-decision API 通話前の判定: block / human / ai / take_message 判定エンジン（classify_call → tools_core） 通話中の spam_score / should_terminate 1階 — エッジ（Pi）: voice-edge = Asterisk 22 + bridge.py Raspberry Pi 3B（1階・宅内） HGW（ひかり電話） Asterisk 22 dialplan 第1関門（着信時・通話前） curl → route-decision で 4 分岐 移植予定（32bit→64bit・ 残課題参照） RTS RDS Arrowfone block → 切る Hangup(21) / 登録番号 human → 人へ通す Dial／fail-open も人へ ai → AI 対応 AudioSocket :9092 bridge.py 音声中継＋ツール呼出 第2関門（通話中） — 通話中の判定 → 用件を預かる／人へ（自動切断なし） AMI Hangup の経路は在るが発火しない（撤去予定）
図: 2階建て構成。1階=現場のエッジ（Pi: Asterisk 22 + bridge.py）、2階=頭脳（NAS: aegis-platform）。第1関門は着信時（通話前）: dialplan が curl で route-decision に問い合わせ、block / human / ai / take_message の 4 分岐。第2関門は通話中の判定: AI の classify_call を platform へ中継し、用件を預かる側か人へ進む。AMI Hangup（B案）の経路はコードに残るが発火せず、確定設計（2026-09-16）で撤去予定。実線の紫枠 = Raspberry Pi 3B（宅内）の機器境界で、HGW と 2階の NAS（aegis-platform）は枠外。※設計構造の図解であり、実機検証はこれから。点線=64bit移植後に同居予定の既存Rhodium機能。
⚠️図は構造、現在地の正は SSoT

稼働確認と実通話・箱で分かった穴は既にあります。図だけから未確認・完了を判断せず、 SSoT の稼働版と「分かっている穴」を参照してください。

リポジトリ構成

リポ役割
aegis-platformクラウド本体（ダッシュボード / API / DB）
aegis-sip-bridgebridge.py（音声中継）
voice-edge電話の入口。稼働版は SSoTを参照
aegis-docsこのドキュメントサイト

数字でわかる現状（旧・SUN4 以前）

📌ここは旧・SUN4 以前の動的カード

下のカードは古い src/data/ の集計で、SSoT の四つの状態語とは揃っていません。 今回は src/data/ を変更しないため履歴として残し、現在地には使いません。

🧩 実装 18/20

Aegis Cloud 機能

Layer 3 の機能マップ

🖥️ 30 ページ

ダッシュボード

operator / reseller / client の3ロール

🔀 92 件

Pull Request

Merged 72 / Open 17 / Draft 2

🔍 22 件 修正済

レビュー指摘

全 26 件中（残課題 3）

主要機能（旧・SUN4 以前の抜粋）

📌ここは旧・SUN4 以前の機能カード

以下は旧資料の分類と数を含む履歴です。現在地には使いません。

📞

着信の一次受付（Route A: Retell / Route C: OpenAI Realtime）

🛡️

登録番号=第1関門で遮断 / unknown=人へ取次（fail-safe + fail-open・通話中の自動切断は発火しない）

🔐

Item A 迂回不能ゲート + 4-eyes 承認 + 監査ログ

🔌

MCP server（28 tools）/ Realtime / 録音暗号化 / 監視 v0.1

このサイトの歩き方（トリセツ）

ℹ️どこを見ればよいか
  • アーキテクチャを知りたい → 左メニュー「Layer 1〜4」
  • 進捗・PR・レビュー結果 → 「Phases」「PR Timeline」「Reviews & Findings」
  • 事業・価格 → 「Strategy & Pricing」
  • 言葉が分からない → 「用語集」（fail-safe / fail-open / verdict など）
📌更新のしかた（非エンジニアでも）

このサイトは データとページが分離しています。多くは src/data/*.ts を1行足すだけで反映されます。 詳しくは リポジトリ直下の README.md を参照（PR を増やしたら prs.ts、機能なら features.ts、用語なら glossary.ts に追記）。