ТЕХНИЧЕСКОЕ ЗАДАНИЕ

Семейный AI-ассистент в Telegram

Февраль 2026

1. Общее описание проекта

Необходимо развернуть семейного AI-ассистента на базе Telegram-группы с темами (Forum Group). Бот должен пассивно собирать данные из всех чатов группы, хранить их в Google Sheets, и отвечать на запросы через Google Gemini API (ключ предоставляет заказчик).

Группа используется семьёй из 2–5 человек в закрытом приватном режиме. Новорождённая дочь Нина — отдельная тема с логированием здоровья и развития.

2. Стек технологий

3. Инфраструктура (обязанность исполнителя)

3.1 Аренда и настройка сервера

Исполнитель обязан:

• Подобрать оптимальный VPS-хостинг (рекомендуется: Timeweb, Selectel, Hetzner или аналог)

• Минимальные требования: 2 vCPU, 2 GB RAM, 20 GB SSD, Ubuntu 22.04

• Арендовать сервер на 1 месяц для тестирования, затем передать управление заказчику

• Установить Docker и Docker Compose

• Развернуть n8n через Docker с постоянным хранилищем данных

• Настроить SSL-сертификат (Let's Encrypt) для доступа к n8n через браузер

• Настроить базовую защиту: firewall (ufw), fail2ban, автообновления безопасности

3.2 Передача доступов заказчику

После настройки исполнитель обязан передать:

• Доступ к панели управления хостингом (логин + пароль)

• SSH-доступ к серверу

• URL, логин и пароль к интерфейсу n8n

• Пошаговую инструкцию (текст или видео) по темам: продление сервера, проверка работы n8n, перезапуск одной командой, просмотр логов, создание резервной копии

4. Telegram: структура группы

Исполнитель создаёт Telegram Forum Group со следующими темами:

Настройки группы:

• Тип: приватная (Private)

• Topics/Forum: включено

• Права бота: администратор. Group Privacy у бота отключить через BotFather

5. Google Sheets: структура базы данных

Исполнитель создаёт и подключает Google Sheets таблицу со следующими листами:

6. Логика работы бота: два режима

6.1 Пассивный режим (без Gemini API)

Срабатывает на каждое сообщение автоматически, без AI, без расхода токенов:

• Любое сообщение в любой теме → запись в лист «Все_сообщения»

• Тема «Финансы» + число в тексте → парсинг суммы → запись в «Расходы» → ответ бота «✅ Записал: [сумма]р»

• Тема «Покупки» → добавить товары в лист → прислать актуальный чеклист

• Тема «Нина» → добавить запись в лист «Нина»

• Расписание (08:00 каждый день) → взять напоминания на сегодня из Sheets → написать в «Главную» (без AI)

6.2 Активный режим (с Gemini API)

Gemini подключается только в двух случаях:

• Сообщение написано в теме «🤖 Ассистент»

• Сообщение является голосовым в любой теме

Перед каждым запросом к Gemini n8n автоматически подтягивает контекст:

• Лист «Память_бота» — полностью (небольшой файл с ключевыми фактами)

• Последние 50 записей из «Все_сообщения»

• Данные из профильного листа в зависимости от темы запроса

Системный промпт для Gemini (исполнитель настраивает в n8n):

Ты семейный AI-ассистент. Отвечай по-русски, дружелюбно и по делу. У тебя есть доступ к базе данных семьи. Есть новорождённая дочь Нина. Контекст: [GOOGLE SHEETS]. История сообщений: [АВТОМАТИЧЕСКИ]. Запрос: [ТЕКСТ ПОЛЬЗОВАТЕЛЯ]

7. Список Workflow в n8n

8. Голосовые сообщения

Голосовые должны работать в любой теме. Схема обработки:

• n8n перехватывает голосовое сообщение через Telegram Trigger

• Скачивает аудиофайл с серверов Telegram

• Отправляет в Gemini 2.0 API с инструкцией «расшифруй и ответь на запрос»

• Ответ бота публикуется в тот же чат откуда пришло голосовое

9. Что НЕ входит в задачу

• Разработка мобильного или веб-приложения

• Интеграция с банками или финансовыми сервисами

• Техническая поддержка после сдачи (обсуждается отдельно)

10. Что предоставляет заказчик

• Google Gemini API ключ

• Доступ к Google аккаунту для создания Google Sheets

• Telegram аккаунт для создания группы и бота

• Оплату хостинга (включить в стоимость или отдельно — обсудить)

11. Критерии сдачи проекта

Проект считается выполненным при соблюдении всех условий:

По всем вопросам связываться с заказчиком до начала работы. Приветствуется предварительный созвон для уточнения деталей.