Автоматизация транспортно-логистических компаний - УрГУПС

Курс лекций и лабораторных работ по автоматизации транспортно-логистических компаний

Преподаватель: Шипулин Александр Валерьевич

Лекция 7. Архитектура и интеграции АРК

Эта лекция

В этой лекции мы детально рассмотрим архитектуру системы АРК: Транспортная логистика Online, изучим модули депо/стоков, личный кабинет клиента, Telegram-интеграцию и механизмы безопасности платформы.

Цель

Сформировать практические навыки работы с модулями депо/стоков, личным кабинетом клиента, Telegram-уведомлениями и механизмами безопасности системы АРК.

Содержание


7.1 Архитектура платформы АРК

Облачная архитектура платформы

АРК: Транспортная логистика Online — это облачная SaaS-платформа, развёрнутая в Yandex Cloud. Инфраструктура построена по схеме «инстанс на клиента»: для каждой транспортно-логистической компании выделяется отдельный экземпляр приложения (веб-сервер на собственной виртуальной машине), а общие ресурсы — шлюз API, управляемая СУБД, объектное хранилище и serverless-функции — используются совместно.

SaaS (Software as a Service, классификация NIST SP 800-145, подробнее — лекция 6) — модель поставки готового ПО по подписке: клиенту не нужны собственные серверы и команда разработки, а обновления и масштабирование выполняет провайдер платформы.

---
config:
  look: handDrawn
  theme: neutral
---
graph TD
    subgraph Клиентский уровень
        A[Веб-браузер] --> B[API Gateway]
        C[Telegram-бот АРКТЛ] --> F[Serverless-функции]
    end

    subgraph US["Уровень приложений: инстанс на клиента"]
        B --> S1["АРКТЛ.Online (клиент 1)"]
        B --> S2["АРКТЛ.Online (клиент 2)"]
        B --> S3["АРКТЛ.Online (клиент N)"]
    end

    subgraph Уровень данных
        S1 --> PG[(Managed PostgreSQL)]
        S2 --> PG
        S3 --> PG
        S1 --> OS[(Object Storage: документы)]
        S2 --> OS
        S3 --> OS
    end

    subgraph Serverless-функции
        F[Telegram-уведомления и диалоги]
        QR[QR-генератор]
        P[Предобработка данных ЭТРАН]
        B -.-> P
        B -.-> QR
    end

    subgraph Обслуживание
        T[Cron-триггеры] --> SN[Снапшоты ВМ: день, неделя]
    end

    subgraph Внешние интеграции
        P --> ET[ЭТРАН РЖД]
        S1 --> C1[1С:Бухгалтерия]
        S1 --> ED[ЭДО: накладные]
    end

    style B fill:#4a4a4a,stroke:#333,color:#fff

Компоненты инфраструктуры платформы (Yandex Cloud):

Компонент Назначение
API Gateway Единая точка входа: маршрутизация запросов, авторизация (HTTP Basic), ограничение доступа
Инстансы приложений (ВМ) Экземпляр АРКТЛ.Online для каждого клиента — изоляция данных и нагрузки
Managed PostgreSQL Управляемая реляционная СУБД: заявки, контрагенты, документы
Object Storage Документы клиентов, обмен файлами с 1С и ЭДО, резервные копии
Serverless-функции Telegram-уведомления и диалоги, генерация QR-кодов, предобработка данных ЭТРАН
Cron-триггеры Автоматическое создание снапшотов виртуальных машин (ежедневно и еженедельно)
NAT-инстансы / web-proxy Шлюзы для обмена с внешними системами (ЭТРАН РЖД, сети клиентов)

Преимущества облачной архитектуры для ТЛК:

Преимущество Описание
Изоляция клиентов Данные и нагрузка каждой ТЛК — в отдельном инстансе приложения
Масштабируемость Новый клиент подключается развёртыванием ещё одного инстанса
Отказоустойчивость Автоматические снапшоты ВМ и управляемая СУБД с резервным копированием
Экономия на облаке Serverless-функции оплачиваются только за фактические вызовы

Модули платформы

Платформа АРК состоит из следующих основных модулей:

Модуль Назначение Связанные практики
CRM Контрагенты, лиды, договоры Практика 2
Заявки Создание, расчёт, контроль Практика 3
Диспетчирование Назначение транспорта, задачи Практика 4
Документооборот Первичные, закрывающие документы Практика 5
Аналитика BI-дашборды, KPI, ABC/XYZ Практика 6
Депо/стоки Учёт контейнеров, транспорта Практика 7
ЛК клиента Онлайн-заявки, статусы, документы Практика 7
Интеграции 1С, ЭТРАН, ЭДО, Telegram, API Практика 8

7.2 Модуль депо и стоков

Учёт контейнеров

Модуль депо и стоков предназначен для учёта и контроля контейнеров, оборудования и транспортных средств на складах и терминалах.

Основные функции:

Функция Описание
Учёт контейнеров Реестр всех контейнеров с характеристиками (тип, объём, вес, номер)
Текущее местоположение Где находится каждый контейнер в данный момент
История перемещений Полный путь контейнера от загрузки до разгрузки
Статус контейнера Свободен, занят, в ремонте, в пути
---
config:
  look: handDrawn
  theme: neutral
---
flowchart TD
    A[Контейнер №12345] --> B{Статус?}
    B -->|Свободен| C[Депо А]
    B -->|Занят| D[В перевозке]
    B -->|В ремонте| E[Ремонтная зона]
    
    D --> F[Контроль загрузки]
    F --> G[Макс. загрузка: 20 тонн]
    F --> H[Текущая: 15 тонн]
    F --> I[Загрузка: 75%]
    
    style C fill:#d9d9d9,stroke:#333
    style E fill:#d9d9d9,stroke:#333

Контроль загрузки и простоя

Контроль загрузки — мониторинг использования мощностей депо и стоков.

Показатель Описание Формула
Загрузка Процент использования мощностей Используемая площадь / Общая площадь × 100%
Простой Время бездействия контейнера/транспорта Сумма часов с момента последнего движения
Оборачиваемость Сколько раз контейнер использован за период Количество перевозок / Количество контейнеров

Управление парком транспорта:

Параметр Описание
Учёт единиц Реестр всех транспортных единиц с характеристиками
ТО и ремонт Планирование технического обслуживания
Простои Контроль времени бездействия транспорта
Загрузка Мониторинг использования каждой единицы

7.3 Личный кабинет клиента

Возможности ЛК

Личный кабинет клиента (ЛК) — веб-интерфейс, через который клиенты ТЛК могут самостоятельно управлять перевозками.

Функции личного кабинета:

Функция Описание
Подача заявок онлайн Создание заявок без звонков и email
Отслеживание статусов Real-time статус каждой перевозки
Просмотр документов Все документы по перевозкам в одном месте
Баланс и платежи История платежей, текущий баланс, счета
Аналитика клиента Статистика перевозок, расходы, эффективность
---
config:
  look: handDrawn
  theme: neutral
---
sequenceDiagram
    participant К as Клиент
    participant ЛК as ЛК АРК
    participant S as Система АРК
    participant T as Telegram
    
    К->>ЛК: Подача заявки
    ЛК->>S: Создание в общей системе
    S->>ЛК: Подтверждение
    ЛК->>К: Уведомление о создании
    S->>T: Отправка статуса
    T->>К: Telegram-уведомление
    S->>ЛК: Обновление статуса
    ЛК->>К: Push-уведомление

Преимущества ЛК для ТЛК:

Преимущество Эффект
Снижение нагрузки на менеджеров -40% звонков и email
Повышение NPS Клиенты ценят самостоятельность
Скорость оформления Заявка за 3 минуты вместо 30
Прозрачность Клиент видит весь процесс

Интеграция с Telegram

Telegram-интеграция — настройка уведомлений о статусах заявок через Telegram-бот.

Возможности Telegram-интеграции в АРК:

Уведомление Триггер Канал
Новая заявка Создание заявки клиентом Менеджер
Статус изменён Переход на следующий этап Клиент + Менеджер
Транспорт назначен Назначение водителя/машины Клиент
Доставлено Завершение перевозки Клиент + Менеджер
Документы готовы Подписание закрывающих документов Клиент

Настройка webhook-уведомлений:

---
config:
  look: handDrawn
  theme: neutral
---
flowchart LR
    A[Событие в АРК] --> B[Webhook]
    B --> C{Тип события}
    C -->|Заявка| D[Telegram-бот]
    C -->|Оплата| E[Email]
    C -->|Статус| F[Push-уведомление]
    
    style B fill:#4a4a4a,stroke:#333,color:#fff

7.4 Безопасность платформы

Аутентификация и авторизация

Двухфакторная аутентификация (2FA) — дополнительный уровень защиты учётной записи в АРК.

Организационная структура и разграничение прав:

Система АРК поддерживает учёт деятельности нескольких компаний в одной системе с хранением управленческой организационной структуры для разграничения прав доступа.

Настройки по компаниям для заполнения документов:

Настройка Описание
Префиксы номеров документов Уникальные префиксы для каждой компании
Руководитель (подпись) Данные для подписи документов
Бухгалтер (подпись) Данные для подписи документов
Логотип Корпоративный логотип компании
Печать Изображение печати компании

Настройки правил для работы с разделами:

Правила настраиваются для разделов: заявки, счета, отчёты и другие. Это позволяет кастомизировать поведение системы под бизнес-процессы конкретной ТЛК.

Механизмы 2FA в АРК:

Метод Описание Уровень защиты
SMS-код Код подтверждения на телефон Средний
Токен-приложение Google Authenticator, Authy Высокий
Email-подтверждение Ссылка подтверждения на email Базовый

Процесс аутентификации:

---
config:
  look: handDrawn
  theme: neutral
---
sequenceDiagram
    participant U as Пользователь
    participant S as Система АРК
    participant A as 2FA-фактор
    
    U->>S: Логин + пароль
    S->>S: Проверка учётных данных
    S->>A: Запрос 2FA-кода
    A->>U: SMS / Push / Email
    U->>A: Ввод кода
    A->>S: Подтверждение
    S->>U: Доступ разрешён

Организационная структура и права доступа

Ролевая модель доступа — разграничение прав на основе организационной структуры компании.

Матрица прав доступа в АРК:

Раздел Руководитель Менеджер Диспетчер Бухгалтер Клиент
CRM Полный Полный Только просмотр Только просмотр —
Заявки Полный Создание/редактирование Создание Только просмотр Свои
Диспетчирование Полный Просмотр Полный — —
Документы Полный Просмотр — Полный Свои
Аналитика Полный Только свои — Полный Только свои
Депо/стоки Полный Просмотр Полный — —
Настройки Полный — — — —

Организационная структура — иерархия подразделений компании в АРК:

---
config:
  look: handDrawn
  theme: neutral
---
graph TD
    A[Генеральный директор] --> B[Коммерческий отдел]
    A --> C[Операционный отдел]
    A --> D[Бухгалтерия]
    
    B --> B1[Отдел продаж]
    B --> B2[CRM-менеджеры]
    
    C --> C1[Автодиспетчеры]
    C --> C2[ЖД-диспетчеры]
    C --> C3[Склад]
    
    D --> D1[Бухгалтеры]
    D --> D2[Финансисты]
    
    style A fill:#4a4a4a,stroke:#333,color:#fff

Практическое задание: Настройте модуль депо/стоков, личный кабинет клиента и Telegram-уведомления в демо-версии АРК для лабораторной работы 7.

Транспортный контекст

Примеры из «Управления процессами перевозок»

На железнодорожном транспорте модуль депо/стоков решает задачи:

Примеры из «Транспортной логистики»

В автомобильной логистике личный кабинет клиента позволяет:

Связь с ФГОС 23.05.04 «Эксплуатация железных дорог»

Код компетенции Описание компетенции
УК-4 Способен оценивать архитектуру информационных систем и механизмы безопасности для ТЛК
ПК-7 Способен настраивать ролевую модель доступа и организационную структуру в ИС
ПК-12 Способен интегрировать IoT-уведомления (Telegram, webhook) в транспортные процессы

Заключение и выводы для специалиста

  1. Микросервисная архитектура — стандарт для облачных платформ. Она обеспечивает масштабируемость, отказоустойчивость и гибкость обновлений.

  2. Модуль депо/стоков — критический для контейнерных перевозок. Контроль загрузки, простоев и оборачиваемости напрямую влияет на прибыль.

  3. Личный кабинет клиента — конкурентное преимущество. Снижает нагрузку на менеджеров и повышает удовлетворённость клиентов.

  4. Telegram-интеграция — быстрый канал уведомлений. Мгновенные уведомления о статусах повышают прозрачность без дополнительных затрат.

  5. Безопасность — основа доверия. Двухфакторная аутентификация и ролевая модель доступа защищают данные компании и клиентов.

Вопросы для самопроверки

  1. Опишите облачную архитектуру платформы АРК. Какие уровни и компоненты вы выделите?

  2. Что включает модуль депо и стоков? Какие функции?

  3. Какие функции предоставляет личный кабинет клиента?

  4. Как работает интеграция АРК с Telegram? Какие уведомления настраиваются?

  5. Какие механизмы двухфакторной аутентификации поддерживает АРК?