Личный кабинет и реферальная система для дизайнеров «Философии Стиля»

Задача

«Философия Стиля» работает с сетью дизайнеров, которые рекомендуют продукцию компании своим клиентам и влияют на продажи.

По мере роста партнёрской сети возникла необходимость объединить всех дизайнеров в единой системе. Нужно было не только предоставить каждому партнёру личный кабинет, но и автоматизировать внутренний учёт продаж, комиссий, выплат и реферальных вознаграждений.

Отдельной частью задачи стала многоуровневая партнёрская механика: дизайнер может приглашать других дизайнеров и получать процент с продаж привлечённых партнёров.

Решение

Мы разработали две связанные SPA-системы:

• личный кабинет дизайнера — для работы партнёров с продажами, приглашениями и профилем;
• административную панель — для сотрудников компании, где управляются дизайнеры, заказы, проценты, выплаты, реферальные программы и отчётность.

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

Личный кабинет дизайнера

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

Dashboard

На главном экране отображается ключевая статистика:

• общий оборот;
• комиссия к выплате;
• количество заказов;
• количество приглашённых дизайнеров;
• текущий уровень в реферальной программе.

Продажи

Все продажи дизайнера собраны в одном разделе и группируются по чекам.

Для каждого заказа отображаются:

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

Внутри заказа можно раскрыть отдельные позиции и увидеть категорию, сумму, применённый процент, комиссию и комментарий.

Выплаченные заказы визуально выделяются отдельно, поэтому дизайнер сразу понимает, какие продажи уже закрыты по выплатам.

Реферальная программа

Каждый дизайнер получает собственный инвайт-код.

С его помощью он может приглашать в систему других дизайнеров и получать вознаграждение с их продаж.

В разделе «Инвайты» отображаются:

• приглашённые дизайнеры;
• применяемый реферальный процент;
• заработанный бонус;
• срок начисления бонуса относительно первой продажи приглашённого партнёра.

Таким образом, дизайнерская сеть становится не только каналом продаж, но и самостоятельным каналом привлечения новых партнёров.

Профиль

В личном кабинете дизайнер самостоятельно управляет персональными данными и реквизитами для выплат:

• ФИО;
• телефон;
• email;
• форма работы;
• ИНН;
• компания;
• расчётный счёт;
• банк;
• БИК.

Также доступна смена пароля и отображается индикатор заполненности профиля.

Административная панель

Для сотрудников «Философии Стиля» создан отдельный интерфейс управления всей партнёрской системой.

Дизайнеры

Администратор видит полный список зарегистрированных дизайнеров с поиском и основной информацией:

• ФИО;
• email;
• телефон;
• форма работы;
• ИНН;
• количество заказов.

В карточке дизайнера собрана вся связанная информация: персональные данные, реквизиты, инвайт-код, индивидуальные проценты по категориям, приглашённые дизайнеры и история заказов.

При необходимости базовый процент можно переопределить персонально для конкретного дизайнера.

Заказы

Заказы можно создавать и редактировать непосредственно из административной панели.

Для поиска предусмотрены фильтры по:

• дизайнеру;
• номеру заказа;
• периоду;
• сумме;
• статусу выплаты.

Заказ состоит из отдельных позиций. Для каждой позиции можно указать категорию, сумму и процент комиссии.

При изменении процента система сразу пересчитывает размер комиссии.

Это позволяет компании учитывать разные условия сотрудничества для разных категорий продукции и отдельных дизайнеров.

Отчёты

Отдельный раздел предназначен для формирования реестра выплат.

Отчёт можно фильтровать по месяцу, а в сводной части отображаются:

• количество дизайнеров;
• общий оборот;
• сумма к выплате.

Детализация позволяет увидеть по каждому дизайнеру количество заказов, оборот, реферальный бонус и итоговую сумму выплаты.

Реферальные реестры

Для реферальной программы реализована отдельная система ежемесячных реестров.

В конце периода администратор формирует снапшот за выбранный месяц. Повторное создание такого же реестра защищено от дублей.

В детализации можно увидеть, какие именно приглашённые дизайнеры сформировали бонус и какая комиссия стала основанием для начисления.

После формирования реестр фиксирует расчёт за соответствующий период.

Настройки

Администратор управляет категориями продукции и условиями начислений:

• название категории;
• базовый процент;
• бонусный процент за рефералов;
• порядок отображения.

Также предусмотрена отдельная система уровней реферальной программы, позволяющая менять условия вознаграждения в зависимости от объёма привлечённых продаж.

Сотрудники

Для внутренних пользователей предусмотрено разделение ролей.

В системе используются роли:

• DESIGNER — партнёр-дизайнер;
• MANAGER — сотрудник компании;
• ADMIN — администратор с расширенными правами.

Это позволяет разделить доступ к данным и административным операциям.

Архитектура

Проект построен как монорепозиторий на npm workspaces и состоит из трёх независимых приложений:

• admin — административная панель;
• lk — личный кабинет дизайнера;
• api — серверная часть и REST API.

Frontend

• React 19
• TypeScript
• Vite 8
• Tailwind CSS 4
• React Router 7

Админка и личный кабинет собираются и разворачиваются независимо друг от друга.

Backend

• Node.js
• Express 5
• TypeScript
• Prisma 6
• JWT-аутентификация
• REST API

Общая бизнес-логика, включая расчёт комиссий и реферальные начисления, вынесена в отдельный слой API.

Database

PostgreSQL 16 работает в Docker-контейнере.

Для управления структурой базы используются Prisma Migrate.

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

Система развёрнута на VPS под управлением Debian.

Инфраструктура включает:

• Docker;
• Docker Compose;
• Nginx;
• SSL-сертификаты Let's Encrypt;
• reverse proxy для API;
• отдельную раздачу статики админки и личного кабинета.

Результат

«Философия Стиля» получила единую систему для управления партнёрской сетью дизайнеров.

Теперь в одном интерфейсе можно:

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

Для дизайнеров система стала единым личным кабинетом, где можно видеть собственные продажи, начисления, выплаты и развивать собственную партнёрскую сеть.

Таким образом, вместо разрозненного ручного учёта компания получила полноценную цифровую платформу управления продажами и партнёрской программой.