Add PLAN.md

ARCHITECTURE.md

@@ -0,0 +1,66 @@
+# 🏗️ Архитектура calls24_v1
+
+> Простая и быстрая речевая аналитика. Только анализ звонков.
+
+## Система
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                        КЛИЕНТ                               │
+│   Звонки (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)

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 ₽ |