Загрузка данных

# Техническое задание на разработку Telegram-бота «Онлайн Юрист-Ассистент»

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

Необходимо разработать Telegram-бота, выполняющего функции онлайн-помощника юриста. Бот должен предоставлять пользователям:

1. Юридические консультации в режиме диалога с использованием искусственного интеллекта.
2. Автоматическую генерацию юридических документов на основе пошагового опроса пользователя.

Вся логика анализа запросов, формирования ответов и генерации документов должна быть полностью автоматизирована и реализована через интеграцию с моделями ИИ (основная модель — Claude, допускается использование дополнительных моделей при необходимости повышения качества или дублирования логики).

Участие человека (юриста, оператора) в процессе работы бота не предусмотрено.

---

## 2. Цели и задачи

- Обеспечить пользователю быстрый доступ к юридической помощи через Telegram.
- Автоматизировать генерацию типовых юридических документов.
- Сделать взаимодействие максимально простым: бот сам ведёт пользователя пошагово и задаёт вопросы на понятном, не юридическом языке.
- Минимизировать ручной труд: все тексты ответов, формулировки документов, юридические обороты — формируются ИИ.

---

## 3. Структура бота (главное меню)

После запуска (/start) пользователь получает приветственное сообщение и главное меню со следующими разделами:

1. Юридическая консультация (ИИ)
2. Создание документа
3. Мои документы (история сохранённых документов)
4. Помощь / Как пользоваться ботом
5. Настройки

---

## 4. Раздел «Юридическая консультация»

### Логика работы:
- Пользователь задаёт юридический вопрос в свободной форме (текстом).
- Бот отправляет запрос в ИИ (Claude и/или другие подключённые модели).
- ИИ формирует понятный, развёрнутый ответ.
- Поддерживается контекст диалога — пользователь может задавать уточняющие вопросы, бот учитывает историю переписки.
- Должна быть кнопка «Завершить консультацию» / «Новый вопрос», очищающая контекст.

### Требования:
- Ответы должны быть юридически корректными, в нейтральном стиле.
- ИИ должен быть настроен системным промптом на роль юридического ассистента, отвечающего по законодательству Российской Федерации (если иное не оговорено).
- Бот должен корректно обрабатывать длинные ответы (разбивать на сообщения при превышении лимита Telegram).

---

## 5. Раздел «Создание документа»

После выбора раздела пользователь видит подменю с категориями документов:

### 5.1. Подразделы:

1. Договоры
2. Доверенности
3. Иски (гражданские)
   - 3.1. Иски физического лица к физическому лицу
   - 3.2. Иски юридического лица к юридическому лицу
   - 3.3. Иски юридического лица к физическому лицу
   - 3.4. Иски физического лица к юридическому лицу
4. Административные иски
5. Ходатайства
   - 5.1. Ходатайства в суд по уголовным делам
   - 5.2. Ходатайства в ходе предварительного следствия или дознания
   - 5.3. Ходатайства для лиц, отбывающих наказание
6. Жалобы
7. Апелляционные жалобы
   - 7.1. По уголовным делам
   - 7.2. По гражданским делам
   - 7.3. По административным делам
8. Кассационные жалобы
   - 8.1. По уголовным делам
   - 8.2. По гражданским делам
   - 8.3. По административным делам

---

### 5.2. Перечень документов по каждому подразделу

#### Договоры:
- Договор купли-продажи (движимого и недвижимого имущества)
- Договор купли-продажи транспортного средства
- Договор купли-продажи квартиры/дома/земельного участка
- Договор аренды жилого помещения
- Договор аренды нежилого помещения
- Договор аренды транспортного средства
- Договор субаренды
- Договор найма жилого помещения
- Договор безвозмездного пользования (ссуды)
- Договор оказания услуг
- Договор подряда
- Договор строительного подряда
- Договор бытового подряда
- Договор займа (между физлицами, с организацией)
- Договор беспроцентного займа
- Договор дарения
- Договор пожертвования
- Договор поставки
- Трудовой договор
- Гражданско-правовой договор с физическим лицом (ГПХ)
- Договор хранения
- Договор поручения
- Агентский договор
- Договор комиссии
- Договор цессии (уступки прав требования)
- Договор перевода долга
- Брачный договор
- Соглашение о разделе совместно нажитого имущества
- Соглашение об уплате алиментов
- Соглашение о расторжении договора
- Соглашение об отступном
- Соглашение о новации
- Договор франчайзинга (коммерческой концессии)
- Договор лицензионный (на использование интеллектуальной собственности)
- Договор о неразглашении (NDA)
- Предварительный договор
- Договор задатка
- Договор поручительства
- Договор залога
- Учредительный договор / договор об учреждении ООО

#### Доверенности:
- Общая (генеральная) доверенность
- Доверенность на представление интересов в суде (общей юрисдикции, арбитражном, мировом)
- Доверенность на представление интересов в государственных органах
- Доверенность на представление интересов в налоговых органах
- Доверенность на представление интересов в Пенсионном фонде / СФР
- Доверенность на управление транспортным средством
- Доверенность на распоряжение транспортным средством (продажа, регистрация)
- Доверенность на распоряжение имуществом
- Доверенность на распоряжение недвижимостью
- Доверенность на получение документов
- Доверенность на получение денежных средств
- Доверенность на получение почтовой корреспонденции
- Доверенность на получение заработной платы / пенсии / пособий
- Доверенность на представление интересов несовершеннолетнего
- Доверенность от юридического лица
- Доверенность в порядке передоверия
- Доверенность на ведение наследственного дела
- Доверенность на регистрацию ИП / ООО
- Доверенность на представление интересов в банке

#### Иски физического лица к физическому лицу:
- Иск о взыскании долга по расписке / договору займа
- Иск о возмещении ущерба, причинённого имуществу
- Иск о возмещении ущерба при ДТП
- Иск о возмещении вреда здоровью
- Иск о компенсации морального вреда
- Иск о разделе совместно нажитого имущества супругов
- Иск о расторжении брака
- Иск о расторжении брака с разделом имущества и определением места жительства детей
- Иск о взыскании алиментов на ребёнка
- Иск о взыскании алиментов на содержание супруга / родителя
- Иск об увеличении / уменьшении размера алиментов
- Иск о лишении родительских прав
- Иск о восстановлении в родительских правах
- Иск об ограничении родительских прав
- Иск об определении места жительства ребёнка
- Иск об определении порядка общения с ребёнком
- Иск об установлении отцовства
- Иск об оспаривании отцовства
- Иск о признании права собственности
- Иск о признании права собственности в порядке наследования
- Иск об устранении препятствий в пользовании имуществом (негаторный иск)
- Иск об истребовании имущества из чужого незаконного владения (виндикационный иск)
- Иск о выселении
- Иск о признании утратившим право пользования жилым помещением
- Иск об определении порядка пользования жилым помещением
- Иск о разделе жилого помещения / земельного участка
- Иск о защите чести, достоинства и деловой репутации
- Иск о признании сделки недействительной
- Иск о признании завещания недействительным
- Иск о восстановлении срока для принятия наследства

#### Иски юридического лица к юридическому лицу:
- Иск о взыскании задолженности по договору
- Иск о взыскании неустойки (пени, штрафа)
- Иск о взыскании процентов за пользование чужими денежными средствами
- Иск о расторжении договора
- Иск об изменении условий договора
- Иск о признании сделки недействительной
- Иск о применении последствий недействительности сделки
- Иск о понуждении к исполнению обязательства в натуре
- Иск о возмещении убытков
- Иск о защите деловой репутации
- Иск о взыскании неосновательного обогащения
- Иск о признании права собственности
- Иск об обязании заключить договор
- Иск об оспаривании решения общего собрания участников
- Иск о ликвидации юридического лица
- Иск о признании должника банкротом
 #### Иски юридического лица к физическому лицу:
- Иск о взыскании задолженности по кредитному договору
- Иск о взыскании задолженности по договору займа
- Иск о взыскании задолженности по услугам ЖКХ
- Иск о взыскании задолженности по договору оказания услуг
- Иск о возмещении ущерба, причинённого работником
- Иск о взыскании неосновательного обогащения
- Иск о выселении
- Иск об обращении взыскания на заложенное имущество
- Иск о расторжении договора и взыскании задолженности
- Иск о возмещении ущерба, причинённого недостачей

#### Иски физического лица к юридическому лицу:
- Иск о защите прав потребителя (возврат товара, замена товара)
- Иск о защите прав потребителя (некачественная услуга, работа)
- Иск к застройщику (нарушение сроков, недостатки, расторжение ДДУ)
- Иск к управляющей компании
- Иск к страховой компании о взыскании страхового возмещения
- Иск к банку (незаконные комиссии, навязанные услуги)
- Иск о взыскании заработной платы
- Иск о взыскании компенсации за неиспользованный отпуск
- Иск о восстановлении на работе
- Иск об изменении формулировки увольнения
- Иск о признании отношений трудовыми
- Иск о возврате денежных средств
- Иск о возмещении вреда, причинённого работником организации
- Иск к туристической компании
- Иск к перевозчику (авиакомпании, ж/д)
- Иск о компенсации морального вреда

#### Административные иски:
- Административный иск об оспаривании решений, действий (бездействия) органов государственной власти
- Административный иск об оспаривании решений, действий (бездействия) должностных лиц
- Административный иск об оспаривании решений, действий (бездействия) органов местного самоуправления
- Административный иск об оспаривании постановления о привлечении к административной ответственности
- Административный иск об оспаривании действий судебного пристава-исполнителя
- Административный иск об оспаривании бездействия судебного пристава-исполнителя
- Административный иск об оспаривании решения налогового органа
- Административный иск об оспаривании решения миграционного органа
- Административный иск об оспаривании отказа в выдаче документов (паспорта, загранпаспорта, разрешений)
- Административный иск о признании нормативного правового акта недействующим
- Административный иск об оспаривании кадастровой стоимости
- Административный иск об оспаривании решения призывной комиссии
- Административный иск о взыскании обязательных платежей и санкций (налогов, страховых взносов)
- Административный иск о помещении иностранного гражданина в специальное учреждение
- Административный иск о принудительной госпитализации
- Административный иск об установлении административного надзора
- Административный иск о продлении / прекращении административного надзора
- Административный иск об оспаривании решения квалификационной коллегии судей
- Административный иск об оспаривании решения избирательной комиссии

#### Ходатайства в суд по уголовным делам:
- Ходатайство об ознакомлении с материалами уголовного дела
- Ходатайство о вызове свидетеля
- Ходатайство о вызове и допросе специалиста
- Ходатайство о приобщении документов / доказательств
- Ходатайство о приобщении вещественных доказательств
- Ходатайство о назначении экспертизы
- Ходатайство о назначении повторной / дополнительной экспертизы
- Ходатайство об отложении судебного заседания
- Ходатайство о возобновлении судебного следствия
- Ходатайство об изменении меры пресечения
- Ходатайство об отмене меры пресечения
- Ходатайство о прекращении уголовного дела
- Ходатайство о прекращении уголовного преследования в связи с примирением сторон
- Ходатайство о прекращении уголовного дела в связи с деятельным раскаянием
- Ходатайство о возвращении уголовного дела прокурору
- Ходатайство о рассмотрении дела в особом порядке
- Ходатайство об исключении доказательства как недопустимого
 - Ходатайство о допросе в закрытом заседании
- Ходатайство об отводе судьи / прокурора / следователя
- Ходатайство о назначении переводчика
- Ходатайство о применении мер безопасности к свидетелю
- Ходатайство об оглашении показаний свидетеля
- Ходатайство о вызове и допросе понятых
- Ходатайство о выдаче копий процессуальных документов
- Ходатайство о допуске защитника
- Ходатайство о замене защитника
- Ходатайство о допуске общественного защитника

#### Ходатайства в ходе предварительного следствия или дознания:
- Ходатайство об ознакомлении с материалами уголовного дела
- Ходатайство об ознакомлении с постановлением о назначении экспертизы и заключением эксперта
- Ходатайство о допросе свидетеля
- Ходатайство о проведении очной ставки
- Ходатайство о проведении следственного эксперимента
- Ходатайство о проведении опознания
- Ходатайство о назначении экспертизы
- Ходатайство о назначении повторной / дополнительной экспертизы
- Ходатайство о приобщении доказательств
- Ходатайство об изменении меры пресечения
- Ходатайство об отмене меры пресечения
- Ходатайство о прекращении уголовного преследования
- Ходатайство о прекращении уголовного дела
- Ходатайство о переквалификации действий
- Ходатайство о допуске защитника
- Ходатайство о замене защитника
- Ходатайство о свидании с обвиняемым
- Ходатайство о выдаче копий процессуальных документов
- Ходатайство об отводе следователя / дознавателя
- Ходатайство о назначении переводчика
- Ходатайство об установлении дополнительных обстоятельств
- Ходатайство о выделении уголовного дела в отдельное производство
- Ходатайство о соединении уголовных дел
- Ходатайство о применении мер безопасности

#### Ходатайства для лиц, отбывающих наказание:
- Ходатайство об условно-досрочном освобождении (УДО)
- Ходатайство о замене неотбытой части наказания более мягким видом наказания
- Ходатайство о приведении приговора в соответствие с действующим законодательством
- Ходатайство об изменении вида исправительного учреждения (смене режима)
- Ходатайство о переводе из колонии строгого режима в колонию-поселение
- Ходатайство о переводе в исправительное учреждение по месту жительства родственников
- Ходатайство об освобождении от наказания в связи с болезнью
- Ходатайство об отсрочке исполнения приговора
- Ходатайство об отсрочке отбывания наказания (беременным, имеющим малолетних детей)
- Ходатайство о снятии судимости
- Ходатайство о помиловании
- Ходатайство о зачёте времени содержания под стражей в срок отбывания наказания
- Ходатайство о предоставлении длительного / краткосрочного свидания
- Ходатайство о предоставлении телефонного звонка
- Ходатайство о выезде за пределы исправительного учреждения
- Ходатайство о переводе на облегчённые условия содержания
- Ходатайство о переводе в колонию общего режима
- Ходатайство об освобождении от дальнейшего отбывания наказания
- Ходатайство о применении акта амнистии
- Ходатайство о пересмотре приговора по новым / вновь открывшимся обстоятельствам
- Ходатайство о замене штрафа другим видом наказания (при невозможности уплаты)
- Ходатайство о разрешении на длительное свидание с проживанием за пределами учреждения
- Ходатайство о выдаче характеристики
- Ходатайство о трудоустройстве в исправительном учреждении

#### Жалобы:
- Жалоба в порядке статьи 124 УПК РФ (прокурору на действия следователя / дознавателя)
- Жалоба в порядке статьи 125 УПК РФ (в суд на действия / бездействие следователя, дознавателя, прокурора)
- Жалоба на постановление об отказе в возбуждении уголовного дела
- Жалоба на постановление о возбуждении уголовного дела
- Жалоба на постановление о прекращении уголовного дела
- Жалоба на постановление о приостановлении предварительного следствия
- Жалоба на действия / бездействие судебного пристава-исполнителя (старшему судебному приставу)
- Жалоба на действия сотрудников полиции
 - Жалоба на действия сотрудников ФСИН
- Жалоба в прокуратуру (общая надзорная)
- Жалоба в Следственный комитет
- Жалоба в Роспотребнадзор
- Жалоба в Роскомнадзор
- Жалоба в трудовую инспекцию
- Жалоба в налоговую инспекцию (ФНС)
- Жалоба в жилищную инспекцию
- Жалоба в Центральный банк РФ (на банки, МФО, страховые)
- Жалоба в антимонопольную службу (ФАС)
- Жалоба в Роспотребнадзор на нарушение прав потребителя
- Жалоба на управляющую компанию
- Жалоба на бездействие должностных лиц
- Жалоба Уполномоченному по правам человека
- Жалоба Уполномоченному по правам ребёнка
- Жалоба Уполномоченному по защите прав предпринимателей
- Жалоба в квалификационную коллегию судей
- Жалоба в адвокатскую палату
- Жалоба в Европейский суд по правам человека (для информации, по применимым случаям)
- Жалоба в Конституционный Суд РФ
- Жалоба в порядке надзора
- Досудебная претензия (потребительская, договорная)
- Жалоба в Министерство здравоохранения
- Жалоба в Министерство образования
- Жалоба на действия миграционной службы
- Жалоба на постановление по делу об административном правонарушении

#### Апелляционные жалобы по уголовным делам:
- Апелляционная жалоба на приговор
- Апелляционная жалоба на оправдательный приговор (от потерпевшего)
- Апелляционная жалоба на постановление об избрании меры пресечения
- Апелляционная жалоба на постановление о продлении меры пресечения
- Апелляционная жалоба на постановление о прекращении уголовного дела
- Апелляционная жалоба на постановление об отказе в УДО
- Апелляционная жалоба на постановление об отказе в замене наказания
- Апелляционная жалоба на иные промежуточные решения суда
- Апелляционное представление прокурора (для информации)

#### Апелляционные жалобы по гражданским делам:
- Апелляционная жалоба на решение суда первой инстанции
- Апелляционная жалоба на определение суда
- Апелляционная жалоба на заочное решение суда
- Апелляционная жалоба на решение по семейным спорам
- Апелляционная жалоба на решение по трудовым спорам
- Апелляционная жалоба на решение по жилищным спорам
- Апелляционная жалоба на решение по делам о защите прав потребителей

#### Апелляционные жалобы по административным делам:
- Апелляционная жалоба на решение по административному делу
- Апелляционная жалоба на постановление по делу об административном правонарушении
- Апелляционная жалоба на решение об оспаривании действий должностных лиц

#### Кассационные жалобы по уголовным делам:
- Кассационная жалоба на приговор, вступивший в законную силу
- Кассационная жалоба на апелляционное определение / постановление
- Кассационная жалоба на постановление об отказе в УДО (вступившее в силу)
- Кассационная жалоба в Верховный Суд РФ
- Кассационная жалоба Председателю Верховного Суда РФ

#### Кассационные жалобы по гражданским делам:
- Кассационная жалоба на решение суда первой инстанции и апелляционное определение
- Кассационная жалоба в кассационный суд общей юрисдикции
- Кассационная жалоба в Верховный Суд РФ (вторая кассация)
- Кассационная жалоба на определение суда

#### Кассационные жалобы по административным делам:
- Кассационная жалоба на решение по административному делу
- Кассационная жалоба в кассационный суд общей юрисдикции
- Кассационная жалоба в Верховный Суд РФ

> Перечни могут быть дополнены разработчиком и/или ИИ. В каждом подразделе обязательно должен быть пункт «Другое», где пользователь самостоятельно вводит название нужного документа, а ИИ формирует его по аналогии.

---

### 5.3. Алгоритм генерации документа

После выбора конкретного документа бот должен:

1. Определить (с помощью ИИ) перечень полей, необходимых для составления выбранного документа (ФИО сторон, адреса, паспортные данные, реквизиты, обстоятельства дела, сумма, дата, наименование суда и т.д.).
2. Запрашивать у пользователя информацию пошагово, по одному вопросу за раз.
 3. Каждый вопрос задаётся простым, понятным, не юридическим языком, с пояснением, что именно нужно ввести, и при необходимости — с примером.
4. После каждого ответа пользователя бот переходит к следующему вопросу.
5. После сбора всех данных бот формирует готовый документ через ИИ и отправляет пользователю в виде текстового сообщения и файла в форматах .docx и .pdf.

### 5.4. Возможность пропуска шага

- На каждом шаге у пользователя должна быть кнопка «Пропустить».
- При нажатии «Пропустить» соответствующее поле в документе остаётся пустым, но с подсказкой-плейсхолдером в квадратных скобках, например: [ФИО заявителя], [адрес регистрации], [сумма задолженности], [наименование суда].
- Пользователь должен понимать, что пропущенные поля он сможет заполнить вручную в готовом документе.

### 5.5. Дополнительные функции в процессе сбора данных

- Кнопка «Назад» — вернуться к предыдущему вопросу и изменить ответ.
- Кнопка «Отмена» — прервать создание документа и вернуться в главное меню.
- Кнопка «Показать введённые данные» — отобразить сводку всех ответов перед генерацией.
- После генерации — кнопка «Перегенерировать» (если документ не устроил) и «Внести правку» (пользователь пишет, что изменить, ИИ перегенерирует с учётом правок).

---

## 6. Требования к работе ИИ

- Основная модель: Claude (актуальная версия через официальный API).
- Допускается каскадное использование нескольких моделей ИИ (например, одна — для сбора данных и формулировки вопросов, другая — для генерации финального текста документа), если это улучшает результат.
- Для каждого типа документа должен быть подготовлен системный промпт, обеспечивающий:
  - корректную юридическую формулировку;
  - соответствие требованиям процессуального законодательства РФ (УПК, ГПК, КАС, АПК, УИК и др.);
  - правильную структуру документа (шапка, тело, просительная часть, приложения, подпись, дата);
  - подстановку плейсхолдеров вместо пропущенных данных.
- ИИ должен уметь самостоятельно определять, какие поля нужны для конкретного документа, и формировать список вопросов динамически.
- При создании ходатайств и жалоб ИИ должен ссылаться на конкретные статьи соответствующих кодексов.

---

## 7. Дополнительные требования

### 7.1. Пользовательский интерфейс
- Все меню реализуются через inline-кнопки Telegram.
- Понятные названия кнопок, отсутствие перегруженности.
- Поддержка возврата в главное меню из любой точки бота.
- Возможность поиска документа по названию (через текстовый запрос).

### 7.2. Хранение данных
- История консультаций и созданных документов сохраняется в личном кабинете пользователя.
- Раздел «Мои документы» — список ранее созданных документов с возможностью скачать повторно и удалить.
- Все данные хранятся с соблюдением требований конфиденциальности.

### 7.3. Безопасность
- Защита от спама и флуда (ограничение количества запросов в минуту).
- Логирование ошибок.
- Резервное копирование данных.
- Шифрование персональных данных пользователей.

### 7.4. Прочее
- Бот должен корректно обрабатывать ошибки ИИ (таймауты, отказы API) и информировать пользователя.
- При сбое — предлагать повторить попытку.
- Должна быть админ-панель (или хотя бы базовая статистика) для просмотра количества пользователей, запросов, ошибок.
- Возможность вносить правки в системные промпты ИИ без изменения кода (через конфигурационный файл или админ-панель).

---

## 8. Результат работы

По завершении разработки должны быть предоставлены:

1. Полностью рабочий Telegram-бот, размещённый на сервере.
2. Доступы к админ-панели и серверу.
3. Краткая инструкция по эксплуатации и обновлению.
4. Возможность редактирования перечня документов и системных промптов без вмешательства в исходный код.

---

Все технологические решения (язык программирования, фреймворк, база данных, способ хостинга) — на усмотрение разработчика, при условии стабильной, безопасной и масштабируемой работы бота.

# Дополнение к техническому заданию: Монетизация Telegram-бота «Онлайн Юрист-Ассистент»

## 1. Общая концепция монетизации

Монетизация бота строится по гибридной модели:
- Freemium — бесплатный доступ с жёсткими ограничениями для привлечения пользователей.
- Подписки — основной источник дохода (от суток до года).
- Разовые покупки — для пользователей, которым нужен один документ или несколько консультаций без оформления подписки.

Цель — обеспечить низкий порог входа (бесплатная проба), доступные цены для массового пользователя и высокую маржинальность за счёт автоматизации (отсутствие затрат на юристов-консультантов).

---

## 2. Структура тарифов

### 2.1. Бесплатный доступ (для всех новых пользователей)

| Возможность | Лимит |
|---|---|
| Юридическая консультация | 1 консультация бесплатно (до 5 сообщений в рамках одного диалога) |
| Создание документов | ❌ недоступно |
| Доступ к разделу «Мои документы» | ✅ (просмотр уже созданных, если были) |

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

---

### 2.2. Разовые покупки

| Услуга | Что входит | Цена |
|---|---|---|
| Одна консультация | 1 диалог с ИИ-юристом (до 10 сообщений в рамках одной темы) | 149 ₽ |
| Один документ | Генерация 1 документа любого типа + 2 бесплатные перегенерации/правки | 299 ₽ |
| Документ + консультация | 1 документ + 1 консультация по нему | 399 ₽ |

---

### 2.3. Подписки

| Тариф | Срок | Консультации | Документы | Цена | Цена в день |
|---|---|---|---|---|---|
| Сутки | 24 часа | до 10 | до 3 | 199 ₽ | 199 ₽ |
| 3 дня | 72 часа | до 25 | до 7 | 399 ₽ | ~133 ₽ |
| Неделя | 7 дней | до 50 | до 15 | 699 ₽ | ~100 ₽ |
| Месяц | 30 дней | до 150 | до 40 | 1 490 ₽ | ~50 ₽ |
| Год | 365 дней | до 1500 | до 400 | 9 990 ₽ | ~27 ₽ |

Под «консультацией» понимается один тематический диалог с ИИ объёмом до 15 сообщений пользователя (с учётом уточняющих вопросов). После 15 сообщений бот предлагает начать новую консультацию (списывается ещё одна).

Под «документом» понимается один сгенерированный документ. В рамках одного документа пользователю предоставляется до 3 бесплатных перегенераций и до 5 правок без дополнительного списания.

---

### 2.4. Тариф «Премиум» (опционально, для VIP-пользователей)

| Тариф | Срок | Консультации | Документы | Цена |
|---|---|---|---|---|
| Премиум-месяц | 30 дней | без ограничений* | без ограничений* | 2 990 ₽ |
| Премиум-год | 365 дней | без ограничений* | без ограничений* | 19 990 ₽ |

\* «Без ограничений» — справедливое использование (Fair Use): не более 30 консультаций и 10 документов в сутки во избежание злоупотреблений и автоматизированного парсинга.

---

## 3. Логика работы лимитов

### 3.1. Принципы учёта
- Все лимиты считаются в рамках одной подписки (не суммируются между подписками).
- Неиспользованные лимиты не переносятся на следующий период.
- При досрочном продлении/смене подписки остатки текущего тарифа сгорают, начинается новый период с лимитами нового тарифа.

### 3.2. Учёт сообщений
- Сообщения, отправленные ботом (приветствия, уточняющие вопросы), не считаются в лимит.
- В лимит «сообщений в консультации» считаются только текстовые запросы пользователя по сути дела.

### 3.3. Перегенерация документа
- В рамках одного документа: до 3 полных перегенераций + до 5 точечных правок (когда пользователь пишет, что изменить) — бесплатно.
- Сверх лимита — новая генерация считается за новый документ и списывается из квоты.

### 3.4. Защита от злоупотреблений
- Ограничение скорости: не более 20 запросов в минуту от одного пользователя.
- Антифрод: блокировка при подозрении на автоматизированное использование (скрипты, боты).
- Один аккаунт = один Telegram ID. Передача доступа третьим лицам приводит к блокировке.

---

## 4. Уведомления и удержание пользователей

Бот должен автоматически уведомлять пользователя:
 1. После использования бесплатной консультации — предложение оформить подписку с указанием выгодных тарифов.
2. При достижении 80% лимита — напоминание о возможности апгрейда.
3. При исчерпании лимита — предложение продлить/повысить тариф или докупить разовый пакет.
4. За 24 часа до окончания подписки — предложение продлить со скидкой 10%.
5. После окончания подписки — предложение специальной цены на возврат (промо-тариф).

---

## 5. Способы оплаты

Бот должен поддерживать следующие способы оплаты:

- Telegram Payments (через ЮKassa, CloudPayments, Stripe или иной агрегатор).
- СБП (Система быстрых платежей).
- Банковские карты (Visa, Mastercard, МИР).
- ЮMoney / QIWI (по возможности).
- Криптовалюта (опционально, для расширения аудитории) — USDT, BTC.

Все платежи проходят через защищённый платёжный шлюз, чеки отправляются автоматически на e-mail (если пользователь указал) или сохраняются в профиле.

---

## 6. Промо-механики и скидки

Для увеличения конверсии должны быть реализованы:

1. Промокоды — на скидку (в процентах или фиксированную сумму) или на дополнительные лимиты.
2. Реферальная программа — за приглашённого друга, который оплатил подписку, оба получают +3 дня к текущему тарифу или скидку 15% на следующую оплату.
3. Скидка на первую подписку — 20% для пользователей, ранее не оформлявших подписку.
4. Скидка при оплате года — уже заложена в цене (~27 ₽/день вместо 50 ₽/день при месячной).
5. Сезонные акции (управляются через админ-панель).

---

## 7. Расчёт рентабельности (для обоснования цен)

### 7.1. Себестоимость одного запроса к ИИ

Ориентировочные расходы на использование Claude API (на момент составления ТЗ — могут меняться):

- Одна консультация (≈ 10 сообщений, средний размер запроса+ответ ~2000 токенов): 0,03–0,07 $ ≈ 3–7 ₽.
- Один документ (включая сбор данных и генерацию, ~5000–10000 токенов): 0,10–0,25 $ ≈ 10–25 ₽.

### 7.2. Маржинальность по тарифам

| Тариф | Цена | Макс. себестоимость ИИ | Маржа |
|---|---|---|---|
| 1 консультация | 149 ₽ | 7 ₽ | ~95% |
| 1 документ | 299 ₽ | 25 ₽ | ~92% |
| Подписка сутки | 199 ₽ | ~145 ₽ (если использован полный лимит) | ~27% (но реально пользователи используют 30–40% лимита → маржа ~70%) |
| Подписка неделя | 699 ₽ | ~725 ₽ при 100% использовании / реально ~250 ₽ | ~64% |
| Подписка месяц | 1 490 ₽ | ~2000 ₽ при 100% / реально ~600 ₽ | ~60% |
| Подписка год | 9 990 ₽ | ~20000 ₽ при 100% / реально ~4000 ₽ | ~60% |

Поведенческие данные (статистика по аналогичным сервисам): средний пользователь подписки использует 30–40% лимитов, что обеспечивает реальную маржинальность 60–70% даже на крупных тарифах.

### 7.3. Дополнительные расходы (учитываются в общей экономике)
- Хостинг сервера: 1 500–3 000 ₽/мес.
- Платёжная комиссия эквайринга: ~2,5–3% с каждой оплаты.
- Поддержка и сопровождение.

С учётом всех расходов итоговая чистая маржа сервиса прогнозируется на уровне 50–60%, что является высоким показателем для SaaS-продукта.

---

## 8. Технические требования к реализации монетизации

1. База данных пользователей должна хранить:
   - Telegram ID, дату регистрации.
   - Статус подписки (активна/неактивна, тариф, дата начала и окончания).
   - Остаток лимитов (консультации, документы).
   - Историю платежей.
   - Использованные промокоды.
   - Реферальные связи.

2. Автоматическое списание лимитов — при каждом действии (консультация, генерация документа).

3. Автоматическая блокировка функций при исчерпании лимита или окончании подписки — с предложением продлить/докупить.

4. Раздел «Мой тариф» в меню бота, где пользователь видит:
   - Текущий тариф и дату окончания.
   - Остаток консультаций и документов.
   - Кнопку «Продлить» и «Сменить тариф».
   - Историю платежей.
5. Админ-панель должна позволять:
   - Управлять ценами и лимитами тарифов без правки кода.
   - Создавать/редактировать промокоды.
   - Просматривать статистику оплат, конверсий, активных подписчиков.
   - Вручную выдавать/отменять подписки конкретным пользователям.
   - Просматривать использование лимитов в разрезе пользователей.

6. Автоматические уведомления настраиваются через админ-панель (шаблоны сообщений, триггеры).

7. Возврат средств — реализовать кнопку обращения в поддержку (без автоматического возврата). Решение о возврате принимается администратором.

---

Все цены могут быть скорректированы через админ-панель без изменения исходного кода бота.