Перейти до вмісту
Обговорити проєкт
Усі роботи

Buyer Hub

Платформа-гарант між медіабаєрами, агенціями Meta та селлерами: рекламні кабінети, ліміти й гроші під контролем подвійного запису.

Тип
Маркетплейс / платформа-гарант
Стек
Next.js / TypeScript / Turborepo / PostgreSQL 16 / Drizzle ORM / Redis + BullMQ / Meta Graph API / USDT TRC20 / better-auth / Chrome Extension (MV3) / Vitest + Playwright

Відтворення інтерфейсу, дані вигадані

Задача

Баєр платить агенції за рекламний кабінет наперед і не знає, чи отримає його. Агенція видає кабінет і не знає, чи їй заплатять за спенд. Обидві сторони ризикують грошима на довірі.

Рішення

Платформа тримає гроші в резерві. У момент видачі кабінету блокується ліміт разом з обома комісіями, спенд із Meta списується з резерву дельтами, а залишок повертається лише після закриття кабінету.

5
ролей
138
екранів
92
таблиці
25
міграцій бази
~25
фонових джоб
4
черги BullMQ
192
файли тестів
7
e2e-сценаріїв

Ролі

Кожна роль має власне меню, власний зріз даних і власні обмеження. Нижче — що зроблено для кожної.

  • Buyer

    01
    • Дашборд: баланс, спенд за 24 години й 7 днів, список того, що потребує уваги
    • Маркетплейс офферів з фільтрами та запит кабінетів
    • Кабінети: підняти чи знизити ліміт, закрити
    • Покупки в шопі
  • Agency

    02
    • Вхідні запити: прийняти, відхилити, видати кабінет
    • Оффери: створення й редагування
    • Токен Meta System User із перевіркою валідності
    • Виплати, відгуки, профіль
  • Owner

    03
    • Поповнення в USDT TRC20 з покроковим статусом
    • Розподіл грошей між баєрами: видати й забрати
    • Картина «Де зараз гроші»
    • Інвайти для баєрів і модулі воркспейсу
  • Seller

    04
    • Товари за категоріями
    • Замовлення до видачі з дедлайном
    • Виплати й відгуки
  • Platform Admin

    05
    • Підтвердження поповнень і контроль депозитів
    • Виплати агенціям і селлерам
    • Перегляд ledger і примусові переходи статусів з обов'язковою причиною
    • Спори, модерація відгуків, сторінка провалених джоб

Модулі

Кабінети
Запит, прийняття, видача, ліміт, синхронізація спенду, закриття. Автомат станів: pending → accepted → issued → active ⇄ limited → closing → closed
Гаманець
Подвійний запис, резерви, комісії агенції та платформи, розподіл між баєрами, виплати, щогодинна звірка балансів
Депозити
Окрема адреса на кожне поповнення, відстеження переказів у мережі TRON, підтвердження блоків, зарахування
Шоп
Товари селлерів, замовлення зі статусами paid → delivered → completed, спори, автозавершення й повернення за SLA

Інтеграції

Meta Graph API v21
Перевірка токена, читання кабінетів пакетами по 50, запис spend cap
TRON / USDT TRC20
Адреси з xpub, TronGrid стежить за переказами, Tronscan перевіряє їх повторно
Meta, TikTok, Google OAuth
Підключення рекламних джерел у модулі трафіку, токени зашифровані
Telegram Bot
Сповіщення, прив'язка акаунта, скидання пароля
better-auth
Реєстрація лише за інвайтом, ліміти запитів у Postgres
Sentry / GlitchTip
Помилки та структуровані логи
S3
Резервні копії бази з тренуванням відновлення
Chrome Extension (MV3)
Дістає токен і сесію з власного браузера користувача; нічого не зберігає і не надсилає

Архітектура

  • Монорепозиторій на Turborepo: web, worker, спільні пакети core і db
  • PostgreSQL 16 і Drizzle ORM: 92 таблиці, 25 міграцій, суми в центах як bigint
  • Ledger подвійного запису: CHECK-обмеження на баланс і тригери, що роблять записи незмінними
  • Транзакції SERIALIZABLE з повтором, блокування рахунків у відсортованому порядку проти дедлоків
  • BullMQ на Redis: чотири черги, джоби видачі, лімітів, синхронізації спенду й закриття
  • Адаптер Meta з двома реалізаціями: справжній Graph API і симулятор для тестів
  • Docker Compose на VPS: caddy, web, worker, migrate, backup, postgres, redis
  • CI: typecheck, lint, тести, збірка, образи Docker, окремо e2e у Chromium і WebKit

Інженерні рішення

  • Незмінність ledger гарантує сама база: тригери й CHECK-обмеження, а не код застосунку
  • Резерв замість передоплати: у момент видачі блокується ліміт і обидві комісії, спенд списується дельтами
  • Статус closing існує навмисно: гроші, які Meta ще може витратити, не повертаються завчасно
  • Таблиця переходів для кожного актора; з кінцевих станів виходу немає навіть для адміна
  • Обмежувач запитів до Meta на кожну агенцію і повтори з урахуванням retry-after
  • Дедуплікація джоб «одна в польоті» замість фіксованого jobId, який мовчки губив наступні зміни ліміту

Що зроблено

  • 5 ролей з окремими кабінетами
  • Маркетплейс офферів
  • Автомат станів кабінету
  • Ledger подвійного запису
  • Депозити USDT TRC20
  • Синхронізація спенду з Meta
  • Шоп зі спорами
  • Telegram-сповіщення
  • Симулятор Meta
  • Chrome-розширення
  • CI з e2e у двох браузерах
Наступний кейсEsports Prediction Platform

Потрібно щось подібне?

Обговорити проєкт