Техническое задание: Telegram-бот генерации персональных песен

Основные этапы и функционал

Этап 1: MVP

  • Анкета: имя, повод, стиль, настроение, факты, тип голоса.
  • Формирование промпта и отправка в LLM (GPT/Gemini) через API для генерации текста песни.
  • Показ текста пользователю: подтвердить, изменить, переделать.
  • Подтвержденный текст отправляется в сервис генерации музыки (Suno/Udio/аналог) с использованием неофициальной библиотеки типа suno-api (Python).
  • Получение mp3 с вокальным исполнением и выдача пользователю.

Этап 2

  • Веб-админка с авторизацией:
    • Управление пользователями и заказами
    • Просмотр статусов генераций
    • История текстов и аудио
    • Редактирование лимитов, тарифов, подписок
    • Баланс кредитов и бонусов
    • Управление реферальной программой
    • Рассылки (по пользователям)
    • Финансовая статистика
    • Логирование и экспорт данных
  • Интеграция платежей (позднее - по необходимости)
  • Масштабирование под нагрузкой

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

  • Язык: Python (предпочтительно) или Node.js
  • База данных: PostgreSQL или SQLite
  • Асинхронная обработка запросов и генераций
  • Telegram Bot API
  • Интеграция через сторонние API (LLM, музыкальные сервисы)
  • Защита от злоупотреблений и резервное копирование

Дополнительно

  • Логирование всех действий и мониторинг работоспособности
  • Защита от чрезмерной нагрузки и спама
  • Реферальные ссылки для шаринга
  • Хранение всей истории заказов и треков в БД
  • Наличие системы бонусов и кредитов для пользователей

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

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