Superkassa-B2C
Платформа для автоматизированного подбора оптимальных маршрутов, бронирования и покупки билетов
v.1.0
1. Пользовательская документация
Описание системы и её предназначение
Superkassa — онлайн-платформа для автоматизированного подбора оптимальных маршрутов, бронирования и покупки авиабилетов. Платформа предназначена для частных пользователей и корпоративных клиентов, предоставляя удобные инструменты для поиска, оформления и управления авиаперелетами.
Основные возможности Superkassa.ru
Superkassa — онлайн-платформа для автоматизированного подбора оптимальных маршрутов, бронирования и покупки авиабилетов. Платформа предназначена для частных пользователей и корпоративных клиентов, предоставляя удобные инструменты для поиска, оформления и управления авиаперелетами.

  • Поиск авиабилетов по заданным параметрам (дата, направление, авиакомпания, класс обслуживания)
  • Онлайн-оплата с использованием банковских карт и системы быстрых платежей
  • Получение билетов в электронном виде (e-mail, личный кабинет)
  • Возможность внесения изменений в бронирование и оформления возврата билетов
  • Доступ к истории заказов и персональным настройкам
  • Программы лояльности и специальные предложения
  • Круглосуточная поддержка клиентов через телефон и e-mail
Основные функции
Поиск и бронирование авиабилетов
Введите маршрут, даты перелёта и количество пассажиров и нажмите на белую стрелку в красном прямоугольнике для поиска авиабилетов.
Выберите подходящий вариант из списка предложений
Укажите данные пассажиров и дополнительные услуги (при наличии)
Оплатите билет удобным способом
Получите билет на e-mail и в личный кабинет
Управление бронированиями
Войдите в личный кабинет на Superkassa.ru и перейдите в раздел «Заказы»
Просматривайте детали заказов, изменяйте даты перелёта, аннулируйте билеты (если условия позволяют), а также скачивайте и распечатывайте авиабилеты при необходимости
Возврат авиабилетов
Откройте свой заказ в личном кабинете и нажмите «Возврат»
Ознакомьтесь с условиями возврата в зависимости от тарифа авиабилета, следуйте инструкциям и получите подтверждение возврата
Программы лояльности и скидки
Регистрация в системе позволяет накапливать бонусные баллы

Супербаллы можно тратить на покупку новых билетов или копить в личном кабинете.
Мы начисляем Супербаллы после оплаты заказа в размере 3% от стоимости заказа.
Один супербалл равен одному рублю.
Потратить Супербаллы можно только после перелета по заказу, за который они начислены. Чтобы оплатить часть заказа Супербаллами, нажмите «Применить супербаллы для оплаты заказа» на странице оформления заказа. Стоимость билетов уменьшится на количество примененных Супербаллов. Супербаллы действительны 18 месяцев со дня их активации.
Если вы решите вернуть билет, при оплате которого использовали Супербаллы, то они вернутся на бонусный счет и вы снова можете использовать их при покупке.

Супербаллами нельзя воспользоваться:
  • Если переходить на Superkassa.ru с других сайтов по поиску авиабилетов.
  • Если еще не совершен перелет по заказу, за который они были начислены.
  • Если вы пытались купить билет с частичной оплатой Супербаллами, но не купили его. Эту проблему можно решить, написав на clients@superkassa.ru. Мы вернем неиспользованные Супербаллы обратно на счёт.
Использование промокодов для получения скидок на будущие покупки

По промокоду можно получить скидку при оплате заказа на Superkassa.ru.
Промокод действует в течение ограниченного периода. Полные условия использования — в письме с промокодом. Чтобы получить скидку, нажмите «Ввести промокод» на странице оформления заказа.
Доступ к эксклюзивным скидкам и специальным предложениям
Поддержка пользователей
Раздел «Вопросы и ответы» содержит ответы на часто задаваемые вопросы
Интерактивный справочник по работе с системой
Возможность обращения через Личный кабинет.
Аннуляция билета
Если билет подлежит аннуляции согласно правилам авиакомпании, в личном кабинете отображается соответствующая кнопка. Данной услугой возможно воспользоваться только в день покупки билета.
При аннуляции билета:

  • Открывается окно подтверждения, где отображается сумма возможной компенсации.
  • После подтверждения аннуляции сумма возврата рассчитывается автоматически.
  • Если сумма изменилась, необходимо подтвердить операцию повторно.
  • После успешного подтверждения пользователя перенаправляют на оплату возможной доплаты.
  • После завершения всех шагов билет аннулируется, а информация об этом отображается в личном кабинете.
Дополнительные услуги
СМС-информирование — оповещение о статусе рейса и изменениях в расписании через СМС
Авторегистрация — автоматическая регистрация на рейс с выбором мест и получением посадочного талона
Платное бронирование — возможность забронировать билет на определённое время с последующей оплатой
Персональное обслуживание — поддержка в коммуникации с авиакомпанией, включая запросы на перевозку домашних животных или негабаритного багажа
Страховки — оформление страховых полисов непосредственно при покупке билета
Добавление дополнительного багажа: В зависимости от выбранного тарифа и авиакомпании могут быть доступны различные нормы провоза багажа и ручной клади. Пассажиры могут оформить дополнительный багаж во время бронирования или позже в личном кабинете.
Типовые сценарии работы
Покупка авиабилета

  1. Открыть сайт Superkassa.ru или мобильное приложение.
  2. Ввести параметры поиска билета.
  3. Выбрать подходящий вариант из доступных предложений.
  4. Ввести данные пассажира и выбрать дополнительные услуги.
  5. Оплатить билет и получить его на e-mail и в личный кабинет.
Обмен и возврат авиабилетов

  1. Перейти в личный кабинет.
  2. Открыть нужный заказ.
  3. Выбрать «Изменить» или «Запросить возврат» в зависимости от условий билета.
  4. Следовать инструкциям для изменения маршрута, даты или возврата средств.
Связь с поддержкой

  1. Перейти в раздел в личный кабинет.
  2. Открыть нужный заказ.
  3. Выбрать «Общие вопросы» и выбрать интересующий вопрос.
  4. Выбрать удобный способ связи: e-mail.
  5. Описать проблему и получить консультацию от специалиста.
Технологический стек
Набор языков программирования, фрэймворков, систем управления базами данных, компиляторов и т. д., применяющийся в проекте Superkassa.ru
PostgreSQL
Docker
Redux Toolkit
PGBouncer
JavaScript
JavaScript
Redux
Node.js
Docker composer
React
Java
Spring 3.0
2. Инструкция по скачиванию, установке и настройке
Установка операционной системы
  1. Установить на сервер Ubuntu
  2. При установке настроен пользователь superkassa с паролем superkassa. Обновить все установленные пакеты sudo apt update
Установка docker, docker compose и настройка
Установка зависимостей
1. sudo apt update

2. sudo apt install -y ca-certificates curl gnupg
Добавление официального репозитория Docker
1. sudo install -m 0755 -d /etc/apt/keyrings

2. curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo tee /etc/apt/keyrings/docker.asc > /dev/null

3. sudo chmod a+r /etc/apt/keyrings/docker.asc

4. echo «deb [arch=$(dpkg —print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable» | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
Установка Docker и Docker Compose
1. sudo apt update

2. sudo apt install -y docker-ce docker-ce-cli containerd.io

3. docker-buildx-plugin docker-compose-plugin
Добавить пользователя в группу docker
1. sudo usermod -aG docker superkassa

2. Выйдите из системы, чтобы изменения вступили в силу.
Инициализировать Docker Swarm
docker swarm init
Войдите в docker registry
1. docker login registry.office.superkassa.ru:5000

2. Логин и пароль к registry будут вам предоставлены при заключении договора.
Подготовка директорий и конфигураций
1. Скопируйте файл make-env.sh, затем выполните chmod +x make-env.sh,и ./make-env.sh.

2. Скопируйте директорию secrets, файлы secret.yml, secrets.sh.

3. Настройте файлы конфигурации в директории secret под свою систему, доменное имя сервера. Затем выполните chmod +x secret.sh, и ./secrets.sh.

4. Скопируйте директорию nginx и выполните настройку файлов конфигурации в директории conf.d, и добавьте сертификаты ssl для вашего доменного имена в директорию ssl.
Скопируйте файл docker-swarm.yml, затем выполните команду
docker stack deploy -c docker-swarm.yml superkassa
Настройка базы данных
1. pg_restore -U testing -h localhost -d testing_frontend <путь_к_дампу>testing_frontend.dump

2. pg_restore -U testing -h localhost -d testing_backend <путь_к_дампу>testing_backend.dump

3. pg_restore -U testing -h localhost -d testing_charter <путь_к_дампу>testing_charter.dump

4. pg_restore -U testing -h localhost -d testing_payment <путь_к_дампу>testing_payment.dump

5. Пароль: testing

6. cp /home/server_managment/secrets/pg_hba.conf/home/postgresql_data/data/postgresql/pg_hba.conf

7. chown 101:102 /home/postgresql_data/data/postgresql/pg_hba.conf
Перезапустите стек
docker stack deploy -c docker-swarm.yml superkassa
3. Описание функциональных характеристик ПО
Главная страница — «Поиск билета»


  1. Пользователь открывает сайт superkassa.ru ⟶ Открывается сайт superkassa.ru
  2. Пользователь нажимает «Город, страна, аэропорт» в первом столбце ⟶ Открывается список
  3. Пользователь вводит или выбирает пункт из списка ⟶ Выбранный пункт отображается в первом столбце
  4. Пользователь нажимает «Куда» во втором столбце ⟶ Открывается список
  5. Пользователь вводит или выбирает пункт из списка ⟶ Выбранный пункт отображается во втором столбце
  6. Пользователь нажимает «Когда» в третьем столбце ⟶ Открывается календарь
  7. Пользователь выбирает дату в календаре ⟶ Выбранная дата отображается в третьем столбце
  8. Пользователь нажимает «Обратно» в четвёртом столбце ⟶ Открывается календарь
  9. Пользователь выбирает дату в календаре ⟶ Выбранная дата отображается в четвёртом столбце
  10. Пользователь нажимает на кнопку выбора количества пассажиров в пятом столбце ⟶ Открывается счётчик
  11. Пользователь выбирает количество пассажиров ⟶ Количество пассажиров отображается в пятом окне
  12. Пользователь нажимает на стрелку для поиска ⟶ Отображается список билетов
Главная страница — «Выбор билета»


  1. Пользователь нажимает на кнопку «Выбрать тариф» под выбранным билетом ⟶ Открываются варианты тарифов
  2. Пользователь нажимает на выбранный тариф ⟶ У выбранного тарифа появляется заливка и синяя обводка и ниже раскрывается блок «Оформление заказа»
Главная страница — «Оформление заказа»


  1. Пользователь заполняет форму «Оформление заказа» ⟶ После заполнения всех обязательных полей и выбора услуг в поле «Способы оплаты» формируются четыре способа оплаты: 1) СБП, 2) Оплата картой, 3) Бронирование, 4) Бронирование + Персональное обслуживание
Главная страница — «Оплата билета — Оплата картой»


  1. Пользователь выбирает способ оплаты Оплата картой и нажимает на кнопку «Оплатить» ⟶ Открывается модальное окно с полем для ввода кода подтверждения от банка
  2. Пользователь вводит код ⟶ Открывается окно с информацией о статусе заказа и данные заказа направляются на указанную при оформлении электронную почту
Главная страница — «Оплата билета — СБП»


  1. Пользователь выбирает способ оплаты Оплата картой и нажимает на кнопку «Оплатить» ⟶ Открывается модальное окно с полем для ввода кода подтверждения от банка
  2. Пользователь вводит код ⟶ Открывается окно с информацией о статусе заказа и данные заказа направляются на указанную при оформлении электронную почту
Главная страница — «Оплата билета — Бронирование и Бронирование + Персональное обслуживание»


  1. Пользователь выбирает способ оплаты Бронирование или Бронирование + Персональное обслуживание ⟶ Открывается поле для ввода данных банковской карты
  2. Пользователь вводит данные банковской карты и нажимает кнопку «Забронировать"⟶ Открывается модальное окно с полем для ввода кода
  3. Пользователь вводит код⟶ Открывается окно с информацией о статусе заказа. Также заказ направляется на указанную почту и в личный кабинет
Личный кабинет «Заказы»


  1. Пользователь нажимает на гиперссылку «Личный кабинет» ⟶ Открывается модальное окно «Вход в личный кабинет»
  2. Пользователь вводит данные для входа и нажимает кнопку «Войти» ⟶ Открывается главная страница Личного кабинета
  3. Пользователь нажимает на гиперссылку с его почтой⟶ Открывается страница Личного кабинета с заказами пользователя
Личный кабинет «Профиль»


  1. Пользователь нажимает на гиперссылку «Личный кабинет» ⟶ Открывается модальное окно «Вход в личный кабинет»
  2. Пользователь вводит данные для входа и нажимает кнопку «Войти» ⟶ Открывается главная страница Личного кабинета
  3. Пользователь нажимает на гиперссылку с его почтой⟶ Открывается страница Личного кабинета с заказами пользователя
  4. Пользователь нажимает на вкладку «Профиль"⟶ Открывается вкладка «Профиль» с данными пользователя
Личный кабинет «Пассажиры»


  1. Пользователь нажимает на гиперссылку «Личный кабинет» ⟶ Открывается модальное окно «Вход в личный кабинет»
  2. Пользователь вводит данные для входа и нажимает кнопку «Войти» ⟶ Открывается главная страница Личного кабинета
  3. Пользователь нажимает на гиперссылку с его почтой⟶ Открывается страница Личного кабинета с заказами пользователя
  4. Пользователь нажимает на вкладку «Пассажиры» ⟶ Открывается вкладка «Пассажиры» с данными пользователя
Личный кабинет «Аннуляция билета»


  1. Пользователь нажимает на гиперссылку «Личный кабинет» ⟶ Открывается модальное окно «Вход в личный кабинет»
  2. Пользователь вводит данные для входа и нажимает кнопку «Войти» ⟶ Открывается главная страница Личного кабинета
  3. Пользователь нажимает на гиперссылку с его почтой⟶ Открывается страница Личного кабинета с заказами пользователя
  4. Пользователь нажимает на вкладку «Аннуляция билета"⟶ Открывается окно подтверждения, где отображается сумма возможной компенсации
  5. Пользователь активирует чекбокс с подтверждением Аннуляции билета⟶ Открывается окно с вводом данных банковской карты
  6. Пользователь вводит данные банковской карты и нажимает «Подтвердить"⟶ Билет аннулируется, а информация об этом отображается в личном кабинете
Личный кабинет «Возврат авиабилетов»

  1. Пользователь нажимает на гиперссылку «Личный кабинет» ⟶ Открывается модальное окно «Вход в личный кабинет»
  2. Пользователь вводит данные для входа и нажимает кнопку «Войти» ⟶ Открывается главная страница Личного кабинета
  3. Пользователь нажимает на гиперссылку с его почтой⟶ Открывается страница Личного кабинета с заказами пользователя
  4. Пользователь выбирает возврат авиабилета ⟶ Открывается форма заявки на возврат авиабилета
  5. Пользователь заполняет форму заявки на возврат и нажимает кнопку «Отправить заявку на возврат"⟶ Открывается окно с чатом поддержки в котором происходит информирование по возврату авиабилета
4. Сведения об условиях использования ПО

  • ООО «Суперкасса» является владельцем Программного комплекса, право использования Программного Комплекса предоставляется путем удаленного доступа для поиска, бронирования, оформления, покупки, возврата, обмена Пользователем услуг третьих лиц (перевозка, размещение в гостиницах, трансфер и др.) через cайт Superkassa.

  • Нажимая кнопку «Оплатить» / «Забронировать» Пользователь подтверждает, что ознакомился с полным текстом настоящего Договора-оферты и Приложений к нему, согласен с условиями, в том числе с размером Сборов и порядком их взимания и заключает Договор-оферту на предложенных условиях без исключений.

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

  • При этом использование возможностей Программного комплекса для поиска информации о наличии авиабилетов/ж/д билетов/услуг, ценах и т. п. без приобретения посредством Программного комплекса соответствующих услуг предоставляется Пользователю безвозмездно

Оферта на изпользование Программного комплекса с приложением