Moduł finansowy giełdy

Specyfikacja techniczna: moduł finansowy giełdy z prowizją systemu

1. Konta użytkowników

• Dla każdego użytkownika tworzony jest wewnętrzny bilans.

• Waluta konta: EUR.

• Bilans zmienia się tylko przez transakcje.

• Statusy konta: aktywne / zablokowane.

2. Automatyczne doładowanie konta

• Integracja z systemem płatności stripe przez API.

• Po potwierdzeniu płatności:

  • środki są przekazywane na bilans użytkownika;

  • tworzona jest transakcja typu deposit.

• Obsługa webhooks.

• Ochrona przed duplikowaniem płatności.

3. Automatyczne wypłaty środków

• Użytkownik składa wniosek o wypłatę.

• Minimalna kwota — parametr systemu.

• Statusy:

  • oczekujące

  • zatwierdzone

  • odrzucone

  • wypłacone

• W czasie wniosku kwota jest blokowana.

• Pełny log zmian statusów.

4. Rezerwacja i płatność domen / stron (z prowizją)

• Przy rezerwacji oferty:

  • środki kupującego przechodzą w status reserved;

  • rezerwacja trwa N minut (konfigurowalne).

• Po potwierdzeniu transakcji:

  • z konta kupującego pobierana jest pełna kwota;

  • z sprzedawcy automatycznie pobierana jest prowizja systemu;

  • sprzedawcy przekazywana jest kwota po odjęciu prowizji;

  • prowizja jest przekazywana na systemowe konto platformy.

• Jeśli transakcja zostanie anulowana:

  • rezerwacja jest automatycznie zwracana kupującemu.

• Wszystkie działania są rejestrowane jako transakcje.

5. Prowizja systemu

• Prowizja pobierana jest tylko od sprzedawcy.

• Rodzaje prowizji:

  • procent od kwoty transakcji (na przykład 5%);

  • kwota stała (opcjonalnie).

• Ustawienia:

  • globalna prowizja w panelu administracyjnym;

  • możliwość zmiany bez przeróbek kodu.

• Prowizja:

  • wyświetlana sprzedawcy przed potwierdzeniem transakcji;

  • oddzielnie przechowywana w transakcjach (system_fee).

• Zabronione jest zakończenie transakcji, jeśli:

  • sprzedawca ma nieprawidłowy bilans;

  • wystąpił błąd w obliczeniu prowizji.

6. Historia konta (użytkownik)

• Rodzaje operacji:

  • deposit

  • withdrawal

  • reserve

  • release

  • sale_income

  • system_fee

• Dla każdej operacji:

  • data/czas

  • typ

  • kwota

  • status

  • powiązana oferta

• Filtrowanie według okresu i typu.

7. Statystyki dla administratora

• Całkowity bilans systemu.

• Osobno:

  • środki użytkowników;

  • środki w rezerwie;

  • środki do wypłaty;

  • dochód platformy (prowizje).

• Analiza:

  • prowizje za okres;

  • top sprzedawcy;

  • obrót giełdy.

• Podgląd konta dowolnego użytkownika.

• Eksport danych do CSV.

8. Wymagania techniczne

• Backend: Java Spring Boot.

• Transakcje ACID.

• Wszystkie kwoty — BigDecimal.

• Audit log wszystkich operacji finansowych.

• Ochrona przed warunkami wyścigu.

• Testy dla:

  • pobierania;

  • rezerwacji;

  • prowizji;

  • rollback w przypadku błędów.