Техническое задание: Скрипт для автоматизации отправки Telegram Stars

Цель проекта

Разработать программное решение для автоматизации процесса отправки Telegram Stars (звёзд) покупателям после успешной оплаты заказа на торговых площадках.

Описание процесса

1. Покупатель приобретает определённое количество звёзд и указывает свой Telegram @username для получения.
2. После оплаты система генерирует и предоставляет покупателю уникальный 16-значный код.
3. Покупатель отправляет этот код в чат.
4. Скрипт должен автоматически:
   • Принимать и проверять валидность уникального кода.
   • Сопоставлять код с данными заказа (количество звёзд, юзернейм получателя).
   • При успешной проверке - осуществлять отправку указанного количества звёзд на указанный @username через внешнюю платформу для работы с фрагментами (fragment.com).

Требования к функционалу

Основные функции

• Интеграция с API торговой площадки для проверки заказов и получения данных (код, количество звёзд, юзернейм).
• Интеграция с API платформы для отправки звёзд (fragment.com) для выполнения транзакций.
• Валидация 16-значных уникальных кодов.
• Обработка и выполнение транзакции отправки звёзд.

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

• Система логирования: Детальное протоколирование всех действий скрипта (успешные проверки, отправки, ошибки) в файл или базу данных.
• Обработка ошибок и оповещения: Реализация механизма оповещения (например, в Telegram-чат или по email) при возникновении сбоев (неверный код, ошибка API, неудачная отправка).
• Надёжность: Скрипт должен корректно обрабатывать исключительные ситуации и иметь механизмы предотвращения повторной отправки по одному коду.

Требования к результату

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

Сроки

Ориентировочный срок выполнения работ - до одной недели.