arys
2cb358e80d
request_handoff() (called by ai_voice_runtime_service for every real call handoff, the only handoff path production calls actually use) reserved an agent from the same routing pool as create_escalation() but never created an EscalationRow, so the Phase 2 no-answer-retry listener (DialEnd/Hangup) could never find it. A failed transfer (no SIP registration, no answer, redirect error) left the agent stuck in RESERVED forever with no retry to the next agent. Now creates an EscalationRow (status=ringing) alongside the agent reservation, releases the agent + marks the escalation failed if the AMI Redirect itself errors immediately, and lets the existing DialEnd/Hangup handler drive no-answer retry / release exactly like the /escalations endpoint already does. Reproduced live: call handed off to extension 2002 with no SIP contact registered -> immediate hangup, cause=3, both pool agents stuck in RESERVED indefinitely (had to release manually via psql).
call-center
Омниканальный контакт-центр: телефония (Asterisk), Telegram, WhatsApp, веб-чат, email — плюс встроенный голосовой ИИ-оператор (распознавание речи → LLM → синтез речи). Написан на Python (FastAPI), ~25 сервисов вокруг одной SQLAlchemy-схемы, локально работает на SQLite, в проде — на PostgreSQL.
Документация
| Документ | Про что |
|---|---|
docs/architecture/overview.md |
Обзор микросервисов и их ролей |
docs/architecture/voice-ai.md |
Голосовой ИИ-оператор подробно |
docs/architecture/real-time-voice-service.md |
Рантайм голосового моста (AudioSocket, TTS/ASR) |
docs/architecture/event-schemas.md |
Схемы событий шины (RabbitMQ) |
docs/runbooks/local-setup.md |
Как поднять проект локально (демо-режим и ручной запуск) |
docs/runbooks/deployment.md |
Как разворачивать (Docker Compose / Kubernetes) |
longread.md |
Сквозной архитектурный ревью репозитория — что реально есть, где технический долг |
Быстрый старт
Подробности — в docs/runbooks/local-setup.md. Коротко:
python -m pip install -r requirements.txt
cp .env.example .env # по умолчанию SQLite, без Docker
python scripts/migrate_core_db.py
uvicorn gateway.app:app --reload --port 8080
Точки входа (после старта gateway): /operator, /supervisor, /admin, /analyst на http://localhost:8080.
Демо-режим одной командой (поднимает весь стек + тестовые данные): scripts/prepare_demo.ps1.
Тесты
pytest -q
Частые задачи
- Поменять greeting/system prompt голосового бота Айнур — правится в коде:
services/shared/ai_operator_config.py→ai_operator_default_config(), коммит и деплой; сервис сам синкает значение в БД при старте.