Table of Contents
Deal — SaaS-мониторинг Telegram
Что это. Deal (Дейл) — сервис, который мониторит заданные Telegram-каналы и чаты, отсеивает рекламу и мусор, классифицирует сообщения (ML + ИИ) и складывает потенциальные заказы и клиентов в канбан-доску. Вместо ручного листания сотен каналов — очередь разобранных лидов.
Для чего. Агентства и фрилансеры теряют заказы в рекламном шуме: Deal автоматизирует процесс «сообщение → кандидат → карточка → сделка», показывает, почему сообщение попало в карточку (ключевое слово / ML / ИИ), и ведёт воронку до результата.
Из чего состоит
- Ядро (
src/core): модули Cards/Kanban (доска), Pipeline («Обработка»: очередь → стоп-правила → дедуп → ML/ИИ → карточка), Tenants (мультитенантность, инвайты, лимиты), Settings, Discovery (поиск и авто-вступление в каналы), оператор-консоль и аналитика. - Сервисы:
telegram-service(шлюз Telegram),ai-service(LLM-классификация),ml-service(обучаемый фильтр),storage-service(файлы). - Фронт (
src/frontend): Vue 3 — дашборд, обработка, настройки, оператор-консоль. - Деплой (
deploy/): compose dev/prod, Caddy+mTLS, observability (Prometheus/Loki/Grafana), раннер CI.
Как посмотреть
docker compose -f deploy/compose.dev.yml up -d --build # полный dev-стек
cd src/frontend && npm run dev # фронт: http://localhost:5173
Вход: admin / admin (dev). Оператор-консоль: http://localhost:5173/#/operator (operator/operator).
Процесс работы
Задачи — в трекере, доска «Deal Board»: Todo → In Progress → Review → Done.
Изменения кода — через ветки t{номер}_название и МР с апрувом владельца; CI гоняет
сборку 5 решений, тесты, скан уязвимостей и фронт.
Документы
Основные документы — в Sidebar справа: ТЗ, Техническая документация, Инструкция пользователя, API-карта, Код-стайл, Бэклог, Статус разработки.