📖Glossary
When to use fail-safe / fail-open / fail-closed, plus Phase C terminology. Bilingual (JA/EN).
Aligned with aegis-sip-bridge/docs/glossary.md. The three easily-confused fail-* terms are illustrated first.
Each term key is shared across languages, so this page serves as the JA/EN parallel reference.
fail-safe / fail-open / fail-closed (most important)
fail-safe
If judged as spam, hang up (block).
Adopted (defense against spam)
verdict=spam → Hangup(21) fail-open
Fall back to business continuity — route legitimate calls to a human.
Adopted (Aegis default)
verdict=unknown/空/想定外 → Dial(PJSIP/${HUMAN_PEER}) fail-closed
Cut everything off (let no one through).
Not adopted
旧 dialplan の unknown→Hangup（C-2(b) で廃止） - verdict
- The AI's decision (from classify_call) normalized into three dialplan values: spam / allow / unknown. Written to AstDB as aegis_verdict/${UNIQUEID}.
- AstDB
- Asterisk's built-in key-value store. The bridge writes the verdict via AMI and the dialplan reads it with ${DB(...)}.
- AudioSocket
- The TCP audio protocol of Asterisk chan_audiosocket: [type:1][len:2 BE][payload]. The bridge listens on 127.0.0.1:9092. type: 0x00=hangup / 0x01=UUID / 0x10=audio (μlaw 8kHz).
- AMI
- Asterisk Manager Interface — the TCP control channel (127.0.0.1:5039) the bridge uses to write the verdict into AstDB via Action: DBPut.
- HUMAN_PEER
- The human hand-off target for C-2(b) business-side fail-open; a placeholder in extensions.conf. Used as Dial(PJSIP/${HUMAN_PEER}) when the verdict is empty/unknown/unexpected, or the bridge is unreachable.
- ALLOW_DESTINATION
- The normal forwarding target when verdict=allow (a legitimate call); a placeholder in extensions.conf.
- classify_call
- An OpenAI Realtime tool that classifies a call and returns a classification (spam/allow/unknown) and related data.
- Aegis Cloud
- The aegis-platform backend. The bridge forwards tool calls to /api/realtime/tools/{tool_name} (AegisCloudProxy).
- HGW
- The home gateway (e.g. for Hikari Denwa fiber phone). Asterisk REGISTERs to it as an extension to receive inbound calls.
- commodity 箱
- A generic package containing only the Asterisk wiring and deployment steps (the bridge itself is not included).
- Item A (strict_approval_mode)
- A per-client non-bypassable gate. It rejects direct loosening writes with 409 and allows only the propose→approve→apply flow.
- 4-eyes
- Two-person approval that forces the proposer and approver to be different people; applied via strict_approval / change_approval.
✅Aegis defaults
Reliably cut only spam (fail-safe), and route everything else to a human (fail-open). Even if the bridge / AMI / OpenAI go down, we never “cut everything off (fail-closed)” (verdict=unknown → hand to a human).
ℹ️Phase C terms
verdict / AstDB / AudioSocket / AMI / HUMAN_PEER / ALLOW_DESTINATION / classify_call / Aegis Cloud / HGW / commodity box / Item A / 4-eyes — definitions are shown in the list above (GlossaryView).