Техническое задание: Telegram-бот с партнерской программой

Цель проекта

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

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

Для администратора:

Панель управления с обзором статистики.
Возможность регистрации новых партнеров и выдачи им уникальных ссылок/промокодов.
Настройка условий вознаграждения (фиксированная сумма или процент от заказа).
Просмотр списка всех привлеченных клиентов с привязкой к партнеру.
Ручное подтверждение завершенных заказов для начисления выплат.
Формирование финансовых отчетов по партнерам.

Для партнера (агента):

Личный кабинет в Telegram.
Получение уникальной реферальной ссылки для привлечения клиентов.
Просмотр списка привлеченных клиентов и статуса их заказов.
Отслеживание накопленного вознаграждения и истории выплат.
Уведомления о новых привлеченных клиентах и изменении статуса заказов.

Для привлеченного клиента:

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

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

Бот должен быть написан на Python с использованием библиотек aiogram или python-telegram-bot.
Данные должны храниться в базе данных (предпочтительно PostgreSQL или SQLite).
Код должен быть чистым, документированным и готовым к развертыванию.
Необходимо предусмотреть систему логирования ключевых действий.

Ожидаемый результат

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

код