Initial: архитектура Pleep24 AI Sales Agent

README.md

@@ -0,0 +1,88 @@
+# Pleep24 — AI Sales Agent
+
+Self-hosted аналог [Pleep.app](https://pleep.app/) — мультиканальный AI-агент продаж.
+
+## Что это
+
+Pleep24 закрывает полный цикл сделки: от первого сообщения клиента до оплаты — через Telegram, WhatsApp, Instagram, веб-чат и телефонные звонки.
+
+**Ключевое отличие от Pleep:** вместо встроенного CRM используется [Twenty CRM](https://twenty.com) (open-source, self-hosted). Голос — через [calls24](https://t.me/calls24).
+
+## Архитектура
+
+```
+Telegram / WhatsApp / Instagram / Web Chat / Voice
+          │
+          ▼
+   Message Router (FastAPI :8100)    ← сессии, каналы
+          │
+          ▼
+   AI Brain (FastAPI :8101)          ← LLM + RAG + tools
+          │
+          ▼
+   Twenty Gateway (FastAPI :8102)    ← Twenty CRM API + платежи
+          │
+          ▼
+   Twenty CRM + Qdrant (KB)
+```
+
+## Стек
+
+| Компонент | Технология |
+|-----------|-----------|
+| Backend | Python 3.12, FastAPI, asyncpg |
+| LLM | DeepSeek (primary), Ollama (fallback) |
+| RAG | Qdrant + embedding-модель |
+| CRM | Twenty (self-hosted) |
+| Voice | calls24 + Yandex AI Realtime API |
+| TTS | Silero TTS |
+| DB | PostgreSQL 16 |
+| Cache | Redis (опционально) |
+| Channels | Telegram (MAX API), WhatsApp, Instagram, Web Widget |
+| Deploy | Coolify + Docker Compose |
+
+## Быстрый старт
+
+```bash
+# 1. Клонировать
+git clone http://192.168.1.230:3333/neo/pleep24.git
+cd pleep24
+
+# 2. Настроить окружение
+cp .env.example .env
+# Заполнить: DEEPSEEK_API_KEY, TWENTY_API_KEY, TELEGRAM_BOT_TOKEN, etc.
+
+# 3. Запустить
+docker compose up -d
+
+# 4. Загрузить базу знаний
+python scripts/load_kb.py --dir kb/
+```
+
+## Сервисы
+
+| Порт | Сервис |
+|------|--------|
+| 8100 | Message Router |
+| 8101 | AI Brain |
+| 8102 | Twenty Gateway |
+
+## Документация
+
+- [ARCHITECTURE.md](ARCHITECTURE.md) — полная архитектура
+- [API.md](docs/API.md) — API-спецификация
+- [DEPLOY.md](docs/DEPLOY.md) — инструкция по деплою
+
+## Roadmap
+
+- [x] Архитектура
+- [ ] Twenty Gateway (CRUD для Person, Deal, Note)
+- [ ] AI Brain (LLM + Qdrant RAG)
+- [ ] Message Router (Telegram)
+- [ ] Web Widget
+- [ ] Voice integration (calls24 → Twenty)
+- [ ] WhatsApp-канал
+
+## Лицензия
+
+MIT