Italia REF - Техническое задание

Реферальная платформа для партнеров, которые продвигают товары итальянской компании на Amazon и TikTok Shop.

Ключевые параметры:

• 3 товара на старте: эритритол, магний, омега
• Масштаб: до 121 товара в перспективе
• Реферальный процент: 15% от оплаты
• Аналог: M1 affiliate платформа (свой аналог)
• Целевая аудитория: Италия

Текущие ссылки на товары:

• BEPPIANI Eritritolo - лендинг
• Amazon
• TikTok Shop

Блок-схема взаимодействий

Цепочка: от клика до начисления

Пример реферальной ссылки

Партнер выбрал: Эритритол + TikTok + аккаунт @maria_fit

Система генерирует:

• https://partner-domain.it/ref?rid=UCH_001&pid=ERIT_001&src=tiktok&med=@maria_fit&cmp=bio_link

Что зашито в ссылке:

• rid=UCH_001 - ID партнера (для начисления 15%)
• pid=ERIT_001 - ID товара (эритритол)
• src=tiktok - откуда трафик
• med=@maria_fit - какой аккаунт
• cmp=bio_link - где размещена ссылка (био, пост, сторис)

Пример статистики партнера

Роли в системе

3.1 Конструктор ссылок (2 режима)

Режим 1: Один продукт - партнер продвигает 1 товар

• Генерируется прямая ссылка на лендинг этого товара
• Партнер ставит ее в шапку профиля соцсети (био)
• Простой вариант: выбрал товар -> получил ссылку -> вставил в профиль

Режим 2: Несколько продуктов - партнер продвигает 2+ товаров

• Генерируется мини-страница по типу Taplink со ссылками на все товары
• Партнер ставит одну ссылку на свою мини-страницу в био профиля
• Покупатель заходит - видит карточки товаров - кликает нужный - попадает на лендинг

Общее для обоих режимов:

• UTM параметры: source (платформа), medium (аккаунт), campaign (размещение)
• Пресеты для популярных платформ (TikTok, Instagram, YouTube, Telegram)
• Копирование в буфер одним кликом

3.2 Статистика

• Переходы по ссылкам (по каждому товару отдельно)
• Заявки (не "рефералы" а именно заявки)
• Оплаты
• Заработано денег (EUR)
• Фильтры по периоду и товару

3.3 Начисления

• 15% от каждой оплаты по реферальной ссылке партнера
• История начислений (дата, товар, сумма заказа, начислено)
• Баланс
• Вывод средств (механика уточняется)

4.1 Управление товарами

• Добавить товар (название, цена, URL лендинга, описание)
• Изменить / деактивировать товар
• Привязка товара к лендингу

4.2 Управление партнерами

• Добавить партнера (email, имя)
• Заблокировать / разблокировать
• Просмотр статистики конкретного партнера

4.3 Общая статистика

• Сводка по всем партнерам: переходы, заявки, оплаты, заработок
• Топ партнеров
• Статистика по товарам
• Экспорт данных (CSV)

4.4 Управление начислениями

• Подтверждение оплат
• Управление выплатами партнерам

Стек

• PHP 8.4 + MySQL 8.4 + jQuery 4
• SPA интерфейс (без перезагрузок страницы)
• Dark/Light тема
• Адаптивный дизайн (десктоп + мобильный)

Ключевые решения

• Своя БД MySQL - полностью автономная система, без SendPulse и без внешних CRM
• Своя авторизация - партнер логинится по email/паролю
• Своя система трекинга - переходы, заявки, оплаты
• Трекинг-скрипт на лендинге - JS скрипт встраивается в лендинг компании, фиксирует переходы/заявки и отправляет данные на ITALIA REF
• Webhook оплаты - платежная система отправляет подтверждение оплаты на ITALIA REF (не на лендинг)
• Лендинги на домене компании - мы генерируем ссылки, встраиваем скрипт, трекаем

Инфраструктура

• Платформа: VPS (italia.ai-platform.space) - кабинет партнера, админка, API, БД
• Лендинги: сайт компании (итальянский домен) + наш трекинг-скрипт
• Платежная система: от компании (уточняется), webhook на наш API

Эти вопросы нужно закрыть до начала разработки

• Платежная система - какая? Есть ли доступ от компании?
• Домен и сервер компании - когда дадут доступ?
• Трекинг оплат - как узнаем что покупатель оплатил? (webhook от платежки / API Amazon / ручной ввод админом?)
• Валюта начислений - EUR? USD?
• Вывод заработка - как партнеры будут получать деньги? (банковский перевод / PayPal / крипто?)
• CRM - нужна ли отдельная CRM или хватит встроенной аналитики?
• Язык интерфейса - русский / украинский / итальянский?
• Мобильное приложение - нужно ли или хватит веб-версии?
• Обучающие видео - Люба записывает уроки, нужна ли интеграция с обучением?
• Ограничения - максимум партнеров? Лимит на генерацию ссылок?

Точные сроки этапов 2-5 определим после закрытия открытых вопросов и получения доступов от компании