diff --git a/calls24_v1_ARCHITECTURE.md b/calls24_v1_ARCHITECTURE.md new file mode 100644 index 0000000..462811f --- /dev/null +++ b/calls24_v1_ARCHITECTURE.md @@ -0,0 +1,66 @@ +# 🏗️ Архитектура calls24_v1 + +> Простая и быстрая речевая аналитика. Без робота, без SIP. + +## Система + +``` +┌─────────────────────────────────────────────────────────────┐ +│ КЛИЕНТ │ +│ Звонки (WAV/MP3) → Telegram / Email / Web-форма │ +└────────────────────────┬────────────────────────────────────┘ + │ + ▼ +┌─────────────────────────────────────────────────────────────┐ +│ calls24_v1 (FastAPI) │ +│ │ +│ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ +│ │ STT │ │ LLM │ │ Report │ │ +│ │ (STT) │ │ Анализ │ │ Генерация│ │ +│ └──────────┘ └──────────┘ └──────────┘ │ +│ │ +│ ┌──────────┐ ┌──────────┐ │ +│ │PostgreSQL│ │ Redis │ │ +│ │(звонки) │ │(кэш) │ │ +│ └──────────┘ └──────────┘ │ +└─────────────────────────────────────────────────────────────┘ +``` + +## Компоненты + +### voice-analyzer/ +- `main.py` — FastAPI эндпоинт: POST /upload, POST /analyze +- `stt.py` — Yandex SpeechKit / Whisper интеграция +- `analyzer.py` — LLM-анализ текста звонка + - Выявление скрипта продаж + - Тайминги и паттерны + - Возражения клиента и реакция оператора + - Оценка конверсии +- `report.py` — Генерация HTML-отчёта + - Что было хорошо / плохо + - Рекомендации по скрипту + - Сравнение операторов + +## Технологический стек + +| Компонент | Технология | +|-----------|------------| +| Фреймворк | FastAPI | +| БД | PostgreSQL (звонки, отчёты) | +| Кэш | Redis (очереди задач) | +| STT | Yandex SpeechKit / Whisper | +| LLM | YandexGPT / OpenAI-compatible | +| Доставка | Telegram-бот, Email | + +## Данные + +### Таблица звонков +- id, client_id, file_path, duration, created_at +- transcription (TEXT) +- analysis_result (JSON) + +### Таблица отчётов +- id, call_id, report_html, created_at +- score_overall (int) +- score_script (int) +- recommendations (JSON) diff --git a/calls24_v1_PLAN.md b/calls24_v1_PLAN.md new file mode 100644 index 0000000..88f9363 --- /dev/null +++ b/calls24_v1_PLAN.md @@ -0,0 +1,83 @@ +# 🗺️ План реализации calls24_v1 + +> Речевая аналитика для малого бизнеса. Только анализ звонков, без робота. + +## Этап 0: Инфраструктура (неделя 1) + +- [x] Репозиторий на Gitea (`neo/calls24_v1`) +- [ ] Docker Compose (PostgreSQL, Redis) +- [ ] Yandex SpeechKit API-доступ +- [ ] Локальный Whisper (альтернатива) + +## Этап 1: Анализ звонков (недели 2-3) + +### voice-analyzer/ +- [ ] `main.py` — FastAPI эндпоинт для загрузки аудио +- [ ] `stt.py` — Yandex STT интеграция (распознавание речи) +- [ ] `analyzer.py` — LLM-анализ текста звонка + - Выявление скрипта + - Тайминги и паттерны + - Возражения клиента и реакция оператора + - Оценка конверсии +- [ ] `report.py` — Генерация отчёта (HTML) + - Что было хорошо / плохо + - Рекомендации по скрипту + - Сравнение операторов + +**Вход:** WAV/MP3 файлы +**Выход:** JSON-анализ + HTML-отчёт + +## Этап 2: Доставка и упаковка (недели 3-4) + +- [ ] Telegram-бот для загрузки звонков +- [ ] Email-доставка отчётов +- [ ] Публичный лендинг с описанием услуги +- [ ] Интеграция с AmoCRM (опционально) + +**Вход:** Звонки клиентов +**Выход:** Готовые отчёты + рекомендации + +## 💰 Бизнес-модель + +### Пакеты: + +1. **Бесплатный аудит** (0 ₽) + - 3 звонка + - Базовый отчёт + - Цель: показать ценность + +2. **Стандарт** (5 000 ₽) + - 10 звонков + - Полный отчёт с рекомендациями + - Сравнение операторов + +3. **Премиум** (15 000 ₽/мес) + - Ежемесячный мониторинг + - Динамика качества + - Приоритетная поддержка + +## 🚀 Go-to-market + +### Целевая ниша: агентства недвижимости + +**Почему:** +- 611 000 риелторов в РФ +- 80% лидов теряются на звонках +- ROI: 1 потерянная сделка = 100 000–3 000 000 ₽ +- Конкурентов в речевой аналитике для агентств — **нет** + +### Каналы привлечения: + +1. **Бесплатный аудит** — входная воронка +2. **Холодные звонки** — предложение анализа для 50 агентств +3. **Партнёрства** — AmoCRM, телефонные справочники, чаты риелторов + +## 📊 Метрики успеха + +| Метрика | Целевое значение | +|---------|------------------| +| Первый платящий клиент | Месяц 2 | +| Конверсия из бесплатного аудита | > 30% | +| NPS отчёта | > 7 | +| CAC (стоимость клиента) | < 3 000 ₽ | +| LTV (пожизненная ценность) | > 45 000 ₽ |