stanislav_dubich@dev:~$ cat b2b-crm/README.md

B2B CRM System

CRM для сети филиалов B2B-компании. Расписание в реальном времени, строгий учёт материальных ценностей, медицинский допуск персонала, генерация PDF/Excel.

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

Сеть филиалов нуждалась в единой системе управления: расписание, учёт специфических активов, медицинский допуск сотрудников, аналитика по клиентам. Все филиалы должны работать в единой системе с разделением доступа.

Архитектура

┌─────────────────┐         HTTP/REST         ┌─────────────────┐
│    Frontend     │◀─────────────────────────▶│  Spring Boot    │
│   (отдельная    │                           │   (Backend)     │
│    команда)     │◀────WebSocket/STOMP──────▶│                 │
└─────────────────┘   (double booking         └────────┬────────┘
                       prevention)                     │
        ┌──────────────────────────────────────────────┼─────────────────┐
        │                        │                     │                 │
        ▼                        ▼                     ▼                 ▼
┌───────────────┐       ┌───────────────┐     ┌───────────────┐  ┌───────────────┐
│  PostgreSQL   │       │  Audit Log    │     │   Amazon S3   │  │   Telegram    │
│               │       │ (immutable)   │     │   (files)     │  │   Bot API     │
└───────────────┘       └───────────────┘     └───────────────┘  └───────────────┘

Ключевые модули

Расписание тренировок:

WebSocket + STOMP для предотвращения двойного бронирования при одновременной работе нескольких администраторов
Машина состояний: Черновик → Ожидание → Подтверждено → В процессе → Завершено
Черновики для незавершённых бронирований

Учёт активов:

Учёт материальных ценностей по категориям
Стоп-лист неисправных единиц
Выдача по заявке к мероприятию
Журнал операций: неизменяемый лог операций (кто, когда, что выдал/принял)

Медицинский допуск:

Форма осмотра с автоматической PDF-генерацией
Соответствие приказу МЗ РФ №1144н
Статусы: Допущен / Не допущен / Опасность

Ролевая модель

Гранулярный доступ (полный → редактирование → просмотр → нет доступа) по модулям:

Владелец сети: управление всеми филиалами
Администратор: полный доступ к CRM
Специалист: работа с мероприятиями
Врач: медицинский допуск
Кладовщик: выдача активов

Генерация документов

PDF: медицинские заключения (iTextPDF)
Excel: расписание, статистика (Apache POI)
Email: автоматическая рассылка отчётов

Стек

Backend

Java 21 Spring Boot 3.4 Spring Security Spring WebSocket + STOMP Spring Data JPA

Data

PostgreSQL 16 Liquibase JPA Specifications Audit Log (immutable)

Integrations

Amazon S3 Telegram Bot API iTextPDF Apache POI

Моя роль

Архитектура backend с нуля: сложная нормализованная схема БД для строгого учёта материальных ценностей
WebSocket + STOMP для предотвращения конфликтов при одновременном редактировании
Гранулярная ролевая модель с динамическими правами по модулям
Неизменяемый журнал операций с активами

← На главную