Финансовый модуль биржи

Техническое задание: финансовый модуль биржи с комиссией системы

1. Счета пользователей

• Для каждого пользователя создается внутренний баланс.

• Валюта счета: EUR.

• Баланс изменяется только через транзакции.

• Статусы счета: active / blocked.

2. Автоматическое пополнение счета

• Интеграция с платежной системой stripe через API.

• После подтверждения платежа:

  • деньги зачисляются на баланс пользователя;

  • создается транзакция типа deposit.

• Обработка webhooks.

• Защита от дублирования платежей.

3. Автоматическое вывод средств

• Пользователь подает заявку на вывод.

• Минимальная сумма — параметр системы.

• Статусы:

  • pending

  • approved

  • rejected

  • paid

• На время заявки сумма блокируется.

• Полный лог изменений статусов.

4. Резервирование и оплата доменов / сайтов (с комиссией)

• При бронировании лота:

  • деньги покупателя переходят в статус reserved;

  • резерв действует N минут (настраивается).

• После подтверждения сделки:

  • с счета покупателя списывается полная сумма;

  • с продавца автоматически удерживается комиссия системы;

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

  • комиссия зачисляется на системный счет платформы.

• Если сделка отменена:

  • резерв возвращается покупателю автоматически.

• Все действия фиксируются транзакциями.

5. Комиссия системы

• Комиссия удерживается только с продавца.

• Типы комиссии:

  • процент от суммы сделки (например, 5%);

  • фиксированная сумма (опционально).

• Настройки:

  • глобальная комиссия в админке;

  • возможность изменять без переработки кода.

• Комиссия:

  • отображается продавцу до подтверждения сделки;

  • отдельно сохраняется в транзакциях (system_fee).

• Запрещено завершать сделку, если:

  • у продавца некорректный баланс;

  • возникла ошибка расчета комиссии.

6. История счета (пользователь)

• Типы операций:

  • deposit

  • withdrawal

  • reserve

  • release

  • sale_income

  • system_fee

• Для каждой операции:

  • дата/время

  • тип

  • сумма

  • статус

  • связанный лот

• Фильтрация по периоду и типу.

7. Статистика для администратора

• Общий баланс системы.

• Отдельно:

  • деньги пользователей;

  • деньги в резерве;

  • деньги на вывод;

  • доход платформы (комиссии).

• Аналитика:

  • комиссии за период;

  • топ-продавцы;

  • оборот биржи.

• Просмотр счета любого пользователя.

• Экспорт данных в CSV.

8. Технические требования

• Backend: Java Spring Boot.

• ACID-транзакции.

• Все суммы — BigDecimal.

• Audit log всех финансовых операций.

• Защита от race conditions.

• Тесты для:

  • списания;

  • резерва;

  • комиссии;

  • rollback при ошибках.