Программисты — удалённая работа в Москве

Разработка чат-ботов. Задачи чат-бота: сбор информации по ключевым словам. Платформа: Telegram, веб-сайт. Продукт: покупка электроники. Техзадание есть. Техническое задание (ТЗ) 1) Цель проекта Создать веб‑приложение + чат‑бота, которые: автоматически собирают сообщения из выбранных чатов/каналов (на старте — Telegram; фильтруют сообщения по вашим правилам («куплю», «продам», бренды, модели, объёмы, цена и т. п.); формируют карточки лидов с контактами и исходным сообщением; позволяют из веб‑интерфейса сразу ответить клиенту (с возможностью дублирования исходного сообщения); дают инструменты маркировки (цвет/статус/комментарий), ведут историю общения и действий; поддерживают публикацию объявлений в выбранные чаты с любых подключённых аккаунтов. Примечание: макеты поведения фильтров и карточек ориентированы на примеры на скриншотах (см. материалы). 2) Объём и границы версии (MVP → V1) MVP (обязательный минимум): Интеграция с Telegram: чтение сообщений из N чатов/каналов (около 40) и DM по списку. Гибкие фильтры по ключевым словам/фразам/регэкспам (см. §6). Лента «Новые» и карточки лидов с источником и быстрой кнопкой «Ответить». Отправка ответа из веб‑приложения от имени выбранного аккаунта/бота. Маркировка клиентов: Зелёный — работал ранее / лояльный; Красный — нежелательный / чёрный список; Без цвета — нейтральный. Комментарий + произвольные теги. Дедупликация похожих сообщений и склейка по одному автору. История действий (аудит‑лог): кто и когда менял статус, писал, публиковал. Роли: Админ, Менеджер. Импорт/экспорт лидов (CSV/XLSX) и сохранение скриншота/ссылки на оригинал. V1 (после MVP): Расширенные источники (WhatsApp Business API/Discord — опционально), Автоподсказки по товарам (NLP: нормализация брендов/моделей), Нормализация цен и валют, алерты, мобильная версия PWA, канбан‑доска, Автосообщения‑шаблоны и антиспам‑таймауты по чатам/аккаунтам, Воронка продаж + простая аналитика. 3) Стейкхолдеры и роли Владелец: Андрей. Админ: управляет подключениями, ролями, фильтрами, чатами, аккаунтами отправки. Менеджер: обрабатывает лиды, отвечает клиентам, ставит статусы/теги. 4) Ключевые сценарии (User Stories) Как Админ я подключаю 40 чатов/каналов и задаю правила фильтрации. Как Менеджер я вижу ленту подходящих сообщений, открываю карточку, читаю оригинал, жму «Написать клиенту», отправляю шаблон/свободный текст и отмечаю статус. Как Менеджер я ищу по бренду/модели/памяти/цвету/цене и по тегам. Как Админ я публикую объявление «продам/куплю» в выбранные чаты от одного из подключённых аккаунтов, соблюдая антиспам‑лимиты. 5) Архитектура и интеграции 5.1 Источники данных Telegram (обяз.): Чтение: через MTProto клиент (Telethon/GramJS) для групп/каналов, где бот не имеет доступа. Отправка: в личку/группы от user‑аккаунта (userbot) или от bot‑аккаунта там, где он присутствует. Риски: возможные ограничения/бан аккаунтов при пользовательских ботах → нужна ротация, лимиты, «серые» зоны описать в политике (§12). 5.2 Веб‑приложение SPA (React/Next.js) + API (Node.js/NestJS) + БД (PostgreSQL). Очередь задач для парсинга/отправки (BullMQ/Redis). Контейнеризация (Docker), деплой (VPS/Kubernetes — по бюджету). 5.3 Событийные потоки Ingest: слушатель MTProto → нормализатор → фильтры → индекс в БД. Ответ: UI → API → маршрутизатор отправки → Telegram. Публикация в чаты: UI → планировщик → отправка по списку чатов с лимитами. 6) Логика фильтрации и нормализации Типы правил: Ключевые слова/фразы (AND/OR, стоп‑слова), Регулярные выражения (например, цены, объём памяти, модели), Язык/локаль (RU/EN), Источник (конкретные чаты/каналы), Роль автора (админ канала, обычный участник), Мин./макс. цена, наличие эмодзи‑паттернов (как на скриншотах), Белый/чёрный список авторов. Пример JSON‑правила: { “name“: “Куплю iPhone 15 Pro“, “include“: [“куплю“, “iphone“, “15 pro“], “exclude“: [“чехол“, “стекло“], “regex“: [“(15\\s?pro|max)“, “(512|1t|256)“], “price“: {“min“: 50000, “max“: 180000}, “sources“: [“@group1“, “@group2“], “lang“: [“ru“, “en“], “action“: “mark_as_lead“ } Дедупликация: хеш по (chat_id, author_id, нормализованный текст) + «похожие» через векторный индекс (опционально — после MVP). 7) Модель данных (черновик БД) accounts (id, type: bot|user, username, limits, status) chats (id, platform, handle, title, is_private, joined_via) chat_members (chat_id, account_id, role) messages (id, chat_id, author_id, text, media_url, price, parsed, created_at) leads (id, message_id, client_id, intent: buy|sell, product, attrs JSONB, status, assignee_id) clients (id, tg_user_id, name, username, rating, color: green|red|none, comment, tags[]) filters (id, name, json_rule, enabled) outbox (id, account_id, target_chat_or_user, text, reply_to, status, error, scheduled_at, sent_at) audit_log (id, user_id, entity, action, before, after, created_at) 8) UI/UX требования 8.1 Лента Фильтры по времени/источнику/ключевым словам/цене/статусам. Плашка источника (чат, время, автор), превью эмодзи/маркеров как на скриншотах. Быстрые действия: «Создать лид»/«Открыть клиента»/«Ответить». 8.2 Карточка клиента Шапка: аватар/ник, статус‑цвет (зелёный/красный/нейтральный), теги. Блок «Исходное сообщение» + кнопка «Скопировать/дублировать в ответ». История переписки (из отправок из веба), заметки, прикреплённые файлы. 8.3 Ответ из веба Выбор аккаунта отправки (из подключённых), Шаблоны сообщений, переменные (имя, модель, цена), «Дублировать исходное сообщение» — чекбокс: вставить цитату сообщения в начало ответа. 8.4 Публикация объявлений Редактор текста + выбор чатов, Планировщик (сейчас/по расписанию), Лимиты/антиспам индикатор (оставшиеся сообщения на аккаунт/час и на чат/час). 8.5 Управление списками Чёрный/белый список клиентов, маски имён/ID, причины блокировки. 9) Безопасность и права Хранение токенов/сессий MTProto в зашифрованном виде. Разграничение прав: только Админ видит и настраивает аккаунты/чаты. Логи действий, двухфакторная аутентификация в веб‑панели (через Telegram Login Widget/OTP на e‑mail). 10) Нефункциональные требования Производительность: ≥ 10 сообщений/сек на ingest; задержка до показа в UI ≤ 3 сек. Масштабирование: горизонтальное — воркеры очереди. Доступность: 99% в рабочее время; резервное копирование БД ежедневно. 11) Ограничения и риски Userbot‑подход в Telegram формально противоречит ToS и несёт риск бана — требуется осознанный выбор и соблюдение лимитов (чередование аккаунтов, паузы, ночные окна, «медленная» отправка). Для групп, где можно добавить bot‑аккаунт, рекомендуется работать через Bot API (безопаснее, но доступ ограничен правилами групп). 12) Лимиты и антиспам‑политика (минимальные) Отправка: не чаще 1 сообщения в 5–15 сек на один аккаунт; не более X/час на чат. Рандомизация задержек; обязательные префиксы «по теме», отсутствие массовых упоминаний. 13) Тест‑кейсы при приёмке Сообщение, содержащее ключи «куплю/iphone/512», попадает в ленту ≤ 3 сек. Кнопка «Ответить» открывает окно, подставляет шаблон, отправка проходит и отображается в истории. Меняю цвет клиента на зелёный — он подсвечивается везде; лог записан. Дублирование исходного сообщения — цитата включена в отправленный текст. Публикация в 5 чатов — система соблюдает лимиты, показывает отчёт «успех/ошибка». Дедупликация: 2 одинаковых поста → 1 лид с индикатором «повтор». 14) Роадмап (после релиза V1) Каталоги товаров и нормализация моделей/цветов; прайс‑парсер и авто‑реплаи; аналитика по конверсии; мобильный PWA; интеграция с Google Sheets/1C. 15) Оценка и сроки (черновик) MVP: 3–5 недель (1 фулстек + 1 интегратор Telegram). V1: +3–6 недель. (Точные оценки после уточнения списка чатов и правил фильтрации.) 16) Приложения 16.1 Пример карточки клиента (текст) Клиент: @username (Имя Фамилия) Цвет: ЗЕЛЁНЫЙ | Статус: «Покупает с накруткой 5–7%» Теги: iphone, 15pro, 512, сша Комментарий: Работал 3 раза, платит вовремя. Исходник: «Куплю iPhone 15 Pro 512 🔶 срочно, можно 2 шт.» (группа @gorbushkin) Кнопки: [Ответить] [Скопировать исходное] [Созвон] [В ЧС] История: 2025‑10‑14 — ответил шаблоном «есть в наличии…» 16.2 Пример шаблона ответа Здравствуйте! Видел(а) ваш запрос по {product}. В наличии {qty} шт., {color}/{storage}. Цена: {price}. Доставка/самовывоз. 16.3 Пример набора фильтров «Куплю iPhone / MacBook / iPad» — по ключевым словам «куплю|ищу» + бренд + объём памяти. «Продам» — ключ «продам|отдам», исключить аксессуары («чехол», «стекло»). Гео‑ключи (RU/UA/KZ) — по флагам/словам. 17) Экранные формы (описание) Лента сообщений: таблица с колонками: Время • Источник • Автор • Сообщение (с подсветкой совпавших ключей) • Цена • [Создать лид]. Лид/Клиент: карточка с цветовой меткой, комментариями, историей и кнопкой «Ответить». Публикация: форма текста, выбор аккаунта и чатов, планировщик, индикаторы лимитов. Настройки: списки чатов, фильтры, шаблоны, аккаунты, чёрный/белый список. 18) Критерии готовности (Definition of Done) Подключено ≥ 40 чатов; поток сообщений стабилен ≥ 48 часов. Фильтры редактируются из UI, без перезапуска сервиса. Отправка/публикация из веба работает и логируется; соблюдаются лимиты. Метки/комментарии клиентов сохраняются и видны всем менеджерам. Бекапы БД и .env задокументированы; инструкция развёртывания.