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
- Дашборд: баланс, спенд за 24 години й 7 днів, список того, що потребує уваги
- Маркетплейс офферів з фільтрами та запит кабінетів
- Кабінети: підняти чи знизити ліміт, закрити
- Покупки в шопі
Agency
- Вхідні запити: прийняти, відхилити, видати кабінет
- Оффери: створення й редагування
- Токен Meta System User із перевіркою валідності
- Виплати, відгуки, профіль
Owner
- Поповнення в USDT TRC20 з покроковим статусом
- Розподіл грошей між баєрами: видати й забрати
- Картина «Де зараз гроші»
- Інвайти для баєрів і модулі воркспейсу
Seller
- Товари за категоріями
- Замовлення до видачі з дедлайном
- Виплати й відгуки
Platform Admin
- Підтвердження поповнень і контроль депозитів
- Виплати агенціям і селлерам
- Перегляд 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 у двох браузерах
Потрібно щось подібне?
Обговорити проєкт