Разработка WebView telegram приложения

Техническое задание
Разработка Case Opening WebView приложения для Telegram
Проект: Case Opening Telegram WebView
Срок выполнения: 12-14 рабочих дней

1. Общие требования
1.1. Назначение проекта
Разработка полнофункционального Case Opening приложения в формате Telegram WebView с интеграцией TON платежей через ArcPay, административной панелью на Filament v3 и системой монетизации (промокоды, реферальная программа).

1.2. Технический стек

Backend: Laravel 11 + Filament v3  
Frontend: Vue 3 + Pinia + Vite + TypeScript  
База данных: MySQL 8.0  
Платежи: ArcPay TON (1.5% комиссия)  
Очереди: Laravel Horizon + Redis 7  
Кеширование: Redis  
Деплой: Ubuntu 22.04 + Nginx + PHP 8.3 + SSL  

2. Функциональные требования
2.1. Пользовательское приложение (WebView)
2.1.1. Case Opening
Открытие кейсов с 3D анимацией (рулетка/капсула)

20+ предустановленных кейсов с настраиваемыми шансами выпадения

Звуковые эффекты открытия

История личных выигрышей (последние 50)

2.1.2. Профиль пользователя
Отображение баланса (TON)

История транзакций (пополнения, выигрыши, выводы)

Реферальная ссылка + статистика приглашенных

Настройки профиля (Telegram ID, аватар)

2.1.3. Монетизация
Пополнение через ArcPay TON (генерация инвойса + webhook)

Активация промокодов (1 использование на пользователя)

Реферальная система (настраиваемый бонус)

2.1.4. UI/UX элементы
Live-лента выигрышей (бутафорская, обновление каждые 15 сек)

Темная/светлая тема (system preference)

Telegram WebApp интеграция (themeParams, haptic feedback)

PWA поддержка (manifest + service worker)

2.2. Административная панель (Filament v3)
2.2.1. Ресурсы (CRUD операции):

1. Users – пользователи  
   • Баланс, статус (active/blocked), дата регистрации  
   • История транзакций, рефералы  
   • Действия: блокировка, сброс баланса  

2. Cases – кейсы  
   • Название, обложка, цена открытия, статус  
   • Настройка содержимого + шансы выпадения  

3. CaseItems – предметы кейсов  
   • Изображение, название, редкость, цена  
   • Связь с кейсами (many-to-many)  

4. PromoCodes – промокоды  
   • Генерация кодов (batch), срок действия  
   • Статистика использований по пользователям  

5. Transactions – транзакции  
   • Тип (пополнение/выигрыш/вывод), сумма, статус  
   • Фильтрация по дате/пользователю/типу  

6. Withdrawals – заявки на вывод  
   • Модерация (approve/reject), сумма, статус  
   • История выплат, блокировка подозрительных  

• Live-лента (интервал обновления, шаблоны сообщений)  
• Реферальная программа (% бонуса для приглашающего)  
• Лимиты вывода (мин/макс сумма, автоапрув до X TON)  
• Коэффициенты кейсов (house edge)  
• Системные уведомления  

2.2.3. Техподдержка
Тикет-система через Telegram Bot

Deep link в @support_bot с автосозданием тикета

История обращений по пользователям

3. Нефункциональные требования
3.1. Производительность

• API Rate Limiting: 100 req/мин на пользователя  
• Response time: <200ms для критических эндпоинтов  
• WebSocket соединения: <50ms latency  
• Поддержка 1000+ одновременных пользователей  

• Laravel Sanctum (API токены)  
• Policy-based авторизация  
• Защита от CSRF/XSS/SQL Injection  
• ArcPay webhook signature verification  
• Rate limiting + CAPTCHA для подозрительных IP  

• Horizontal scaling (добавление worker'ов)  
• Queue workers (Laravel Horizon)  
• Redis кластеризация (при необходимости)  
• Database read replicas (опционально)
5. Этапы разработки и приемки
Этап 1 (Дни 1-3): Backend + ArcPay
text
• Laravel 11 + Filament v3 setup  
• User/Case/CaseItem/Promo модели + миграции  
• ArcPay интеграция (инвойсы + webhook)  
• Базовая API авторизация  
Этап 2 (Дни 4-7): Админка
text
• Полная Filament админка (все ресурсы)  
• Система настроек  
• Тикет-система + @support_bot  
• 20+ готовых кейсов с предметами  
Этап 3 (Дни 8-11): Frontend WebView
text
• Vue3 + Pinia + Telegram WebApp  
• Case opening анимации (Three.js/GSAP)  
• Live-лента (бутафорская)  
• Профиль + рефералка  
• PWA manifest  
Этап 4 (Дни 12-14): Тестирование + Деплой
text
• End-to-end тестирование  
• Load testing (1000 users)  
• VPS деплой (Ubuntu 22.04)  
• Документация + обучение  

6. Результат передачи
text
1. Полный исходный код (GitHub Private Repository)  
2. Документация деплоя (README.md + docker-compose)  
3. Рабочий Telegram Bot @support_bot  
4. Тестовый ArcPay мерчант аккаунт  
5. 20+ готовых кейсов с предметами и обложками  
6. Демо-сервер (7 дней доступ)  
7. Видео-инструкция по админке (15 мин)  
8. SQL дамп с тестовыми данными  

7. Требования к исполнителю
text
Обязательный опыт:
• Laravel 11 + Filament v3 (3+ коммерческих проекта)  
• Vue 3 + TypeScript (WebView/Mini Apps)  
• ArcPay или TON Connect интеграция  
• 3D анимации (Three.js/GSAP)  
• Деплой Laravel приложений (Forge/Vapor/CLI)  

Желательно:
• Telegram Bot API (Payments/Stickers)  
• Laravel Horizon + Broadcasting  
• Оптимизация под мобильные WebView