stanislav_dubich@dev:~$ cat logistics-portal/README.md

Logistics Portal Backend

Личный кабинет B2B клиента для транспортно-логистической компании. WebSocket + Kafka архитектура, интеграция с legacy SOAP-системами, мультимодальные перевозки (море, ж/д, авто).

Бизнес-задача

Цифровая платформа для B2B клиентов логистической компании:

Управление заявками на перевозку (контейнеры, грузы)
Отслеживание статусов заказов в реальном времени
Интеграция с legacy-системами (верификация компаний, синхронизация заказов)
Трёхэтапная регистрация с проверкой через ИНН/КПП

Архитектура

┌─────────────────┐      WebSocket/STOMP      ┌─────────────────┐
│     Client      │◀────────────────────────▶│   Web Service   │
│   (Browser)     │      JSON-RPC             │   (Gateway)     │
└─────────────────┘                           └────────┬────────┘
                                                       │
                                              Kafka    │    Kafka
                                           (request)   │  (response)
                                                       ▼
                                              ┌─────────────────┐
                                              │ Process Service │
                                              │ (Business Logic)│
                                              └────────┬────────┘
                                                       │
        ┌──────────────────────────────────────────────┼──────────────────┐
        │                            │                 │                  │
        ▼                            ▼                 ▼                  ▼
┌───────────────┐           ┌───────────────┐  ┌───────────────┐  ┌───────────────┐
│  PostgreSQL   │           │   Keycloak    │  │  BitFinance   │  │   DataCore    │
│  (state)      │           │   (OAuth2)    │  │  (SOAP/XML)   │  │  (SOAP/XML)   │
└───────────────┘           └───────────────┘  └───────────────┘  └───────────────┘

WebSocket + Kafka

Event-driven архитектура для обновлений в реальном времени:

Web Service: STOMP/WebSocket gateway, маршрутизация JSON-RPC запросов
Process Service: бизнес-логика, 70+ обработчиков, интеграции
Kafka: pub/sub между сервисами (request/response топики)
Маршрутизация: ответы направляются клиенту по sessionId

Интеграция с legacy-системами

SOAP-клиенты для работы с существующими системами:

Финансовая система: верификация компаний по ИНН/КПП, получение GUID контрагента
Система заказов: синхронизация статусов, парсинг вложенных CDATA в XML
Периодическая синхронизация: CRON-задачи для актуализации данных

Регистрация

Трёхэтапная регистрация B2B клиента:

Шаг 1: Клиент заполняет данные компании, подтверждение email
Шаг 2: Админ проверяет через финансовый API, назначает менеджера
Шаг 3: Менеджер подтверждает, привязывает контракты

Система прав

Гранулярная модель доступа:

RBAC: роли (admin, manager, client) с базовыми правами
Переопределение: индивидуальные права поверх ролей
@RoleSecured: аннотация для проверки прав на уровне обработчика

Стек

Backend

Java 21 Spring Boot 3.4 Spring WebSocket + STOMP Spring Web Services (SOAP)

Data

PostgreSQL Liquibase Caffeine (cache)

Messaging

Apache Kafka JSON-RPC over WebSocket

Auth & Infra

Keycloak (OAuth2) Docker Yandex Cloud

Моя роль

Архитектура WebSocket + Kafka для обновлений в реальном времени с горизонтальным масштабированием
Гранулярная система прав с переопределением поверх RBAC

← На главную