Техническое задание на создание чат-бота в Telegram

1. Описание задачи

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

2. Функциональные требования

Чат-бот должен иметь следующие функции:

2.1 Регистрация пользователя

Чат-бот должен позволять пользователям зарегистрироваться в системе. Для этого чат-бот должен обладать следующими функциями:

• Пользователь отправляет чат-боту сообщение с командой регистрации.
• Чат-бот запрашивает у пользователя информацию "о себе".
• Чат-бот сохраняет информацию о пользователе в базе данных.

2.2 Создание игры с контролем времени

Чат-бот должен позволять пользователям создавать игры с контролем времени. Для этого чат-бот должен обладать следующими функциями:

• Пользователь отправляет чат-боту сообщение о том, что он хочет создать игру с контролем времени.
• Чат-бот предлагает пользователю выбрать один из трех вариантов игры: "Шахматы 960 с контролем времени 10+0", "Классические шахматы с контролем времени 10+0" и "Шахматы на четверых".
• Чат-бот создает ссылку на партию на базе chess.com и ссылку на Zoom конференцию.
• Чат-бот начинает поиск партнера и отправляет анкету участника, содержащую два-три предложения о себе, ссылку на профиль игрока в chess.com и ссылку на социальную сеть.
• Создатель игры получает анкеты игроков в листе ожидания и выбирает из двух кнопок "подтвердить" и "отклонить".
• После нажатия кнопки "подтвердить" чат-бот присылает пригласительное письмо первому в очереди, кто выбрал соответствующую игру в варианте "присоединиться к игре". Через 30 секунд первому в очереди, нажавшему "предлагать все варианты". Через 20 секунд всем остальным в листе ожидания и получившим "подтверждение от создателя партии.
• Если создатель игры не получает подтверждение от игрока в течение 5 минут, то чат-бот отменяет игру.

2.3 Присоединение к игре с контролем времени

Чат-бот должен позволять пользователям присоединяться к играм с контролем времени. Для этого чат-бот должен обладать следующими функциями:

• Пользователь отправляет чат-боту сообщение о том, что он хочет присоединиться к игре с контролем времени.
• Чат-бот предлагает пользователю выбрать один из четырёх вариантов игры: "Шахматы 960 с контролем времени 10+0", "Классические шахматы с контролем времени 10+0", "Шахматы на четверых" и "Любой вариант".
• Если в данный момент существует созданная игра с контролем времени выбранного варианта, чат-бот присылает игроку ссылку на эту игру.
• Если созданной игры нет, пользователь попадает в лист ожидания. Если в момент времени появляются два игрока, желающие присоединиться к одному и тому же (либо любому) типу игры, им присылаются ссылки на анкеты друг друга и в случае подтверждения от обоих создается партия на chess.com двоих/четверых.

3. Технические требования

Чат-бот должен быть разработан на языке программирования Python с использованием библиотеки python-telegram-bot. Для работы с базой данных должна использоваться СУБД PostgreSQL. Для создания ссылок на игру на базе chess.com и Zoom конференцию можно использовать API этих сервисов.

4. Результаты

Результатом работы над проектом должен стать рабочий чат-бот в Telegram, способный находить соперников для игры в шахматы, создавать ссылки на игру на базе chess.com и Zoom конференцию, регистрировать пользователей, отображать статистику игр и предлагать создать или присоединиться к игре с контролем времени.