Перейти до основного вмісту
Архітектура та хмари
16 хв читання

Детермінований фінансовий реєстр та подвійний запис: TigerBeetle, ідемпотентність і робочі процеси Temporal у Next.js 16

Усунення помилок чисел із плаваючою комою, розбіжностей балансу та стану гонитви в білінгу: впровадження суворого подвійного запису з розподіленим реєстром TigerBeetle, 128-бітною арифметикою та довговічними сагами Temporal у Next.js 16.

AY
Artur Yusupov
Провідний Fullstack-архітектор та інженер фінансових систем
Впроваджено в проєктах:Artur Yusupov Portfolio PlatformUnitrition HealthTech Platform
Детермінований фінансовий реєстр та подвійний запис: TigerBeetle, ідемпотентність і робочі процеси Temporal у Next.js 16

1. Криза фінансової цілісності: чому реляційні БД не підходять для реєстрів

Більшість fullstack-розробників будують білінгові системи, використовуючи таблицю users зі стовпцем balance:

SQL
-- АНТИПАТЕРН: Змінний стовпець балансу
UPDATE users SET balance = balance - 49.99 WHERE id = 'usr_1024';

У високонавантажених системах це призводить до фатальних помилок:

  • Помилки чисел із плаваючою комою: Типи FLOAT спричиняють невидимі розбіжності округлення, які за мільйони операцій перетворюються на тисячі доларів втрат.
  • Стан гонитви (Race Conditions): Паралельні запити списання дозволяють користувачам витратити кошти двічі без важких блокувань рядків (SELECT FOR UPDATE), що критично уповільнює базу даних.
  • Втрата аудиту: Перезапис одного значення знищує історію руху грошей.

Гроші не можуть бути змінним стовпцем. Гроші - це незмінний фінансовий реєстр подвійного запису.

Матриця вибору фінтех-архітектури: змінні стовпці балансу проти незмінного леджера TigerBeetle

Архітектурний критерій
Інваріант цілісності даних
Змінне поле SQL (`UPDATE balance`)
Вразливий до стану гонки та помилок float
Незмінний журнал подвійного запису (TigerBeetle)
Гарантовано: Сума(Дебет) - Сума(Кредит) == 0
Архітектурний критерій
Пропускна здатність запису
Змінне поле SQL (`UPDATE balance`)
1 200 - 3 500 транзакцій/сек (Блокування рядків)
Незмінний журнал подвійного запису (TigerBeetle)
> 1 000 000 транзакцій/сек (Без блокувань)
Архітектурний критерій
P99 затримка фіксації
Змінне поле SQL (`UPDATE balance`)
45мс - 180мс (Черги дискового вводу-виводу)
Незмінний журнал подвійного запису (TigerBeetle)
< 800 Мікросекунд (Кільцеві буфери Direct I/O)
Архітектурний критерій
Історія аудиту та походження
Змінне поле SQL (`UPDATE balance`)
Втрачається при перезаписі значення
Незмінний журнал подвійного запису (TigerBeetle)
100% Незмінний криптографічно зв'язаний журнал
Архітектурний критерій
Час на фінансову звірку
Змінне поле SQL (`UPDATE balance`)
Години нічних розрахунків і виправлень
Незмінний журнал подвійного запису (TigerBeetle)
Нуль (Звірка в реальному часі за частки мілісекунди)

2. Інваріант подвійного запису та архітектура TigerBeetle

Принцип подвійного запису, винайдений понад 500 років тому, гарантує непорушне математичне правило:

CODE
Кожна операція містить Дебет та Кредит.
Сума(Дебет) - Сума(Кредит) == 0

TigerBeetle - це спеціалізована база даних фінансового обліку, створена на мові Zig. Завдяки прямому вводу-виводу (Direct I/O), кільцевим буферам фіксованого розміру та консенсусу Viewstamped Replication (VSR), TigerBeetle фіксує перекази менше ніж за 800 мікросекунд і витримує до 1 000 000 операцій/сек із повною стійкістю до збоїв.


3. Двофазні перекази та 128-бітна арифметика

У реальній комерції кошти спершу блокуються, а потім списуються:

1
Авторизація (Фаза 1): Реєстр резервує кошти в pending_debits та pending_credits.
2
Списання або скасування (Фаза 2): При підтвердженні замовлення викликається post_pending_transfer, а при збої - void_pending_transfer.

Всі розрахунки ведуться виключно в нативних 128-бітних цілих числах (u128), що виключає переповнення та втрату точності.


4. Довговічні робочі процеси Temporal для оркестрації платежів

Платіжні шлюзи (Stripe, банки) мають мережеві збої та затримки вебхуків. Інтеграція TigerBeetle з Temporal.io забезпечує довговічне виконання саги платежу: навіть якщо сервер аварійно перезавантажиться під час очікування відповіді банку, стан виконання відновлюється автоматично без повторних списань.

Практичне впровадження в коді

Де ця архітектура працює у моєму портфоліо

Ці інженерні рішення не є абстрактною теорією - вони повністю реалізовані та перевірені у наступних робочих продуктах:

Архітектурний аудит

Плануєте міграцію стеку або розробку продукту?

Обговоріть архітектурні вимоги вашого проєкту з інтерактивним RAG AI-асистентом або зв’яжіться напряму для інженерної оцінки.

Написати напряму