Ремонт

Базовые сущности и роли

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

• Операция ремонта: агрегирует несколько повреждений одной сессии, сводит их статусы в сводный статус операции, хранит общую стоимость ремонта. В рамках одной контейнерной сессии может выполняться несколько операций.

Создание операции «Ремонт», повреждения и стартовый статус

Повреждения создаются в рамках сценариев приёма или осмотра в Android-приложении.

Если в ходе приёма по сессии зафиксировано хотя бы одно повреждение, в системе автоматически создаётся операция «Ремонт» и связанные с ней повреждения. Сессия переводится в состояние «Поврежден», устанавливается соответствующая чипса «Контейнер поврежден».

Статус операции и повреждений определяется по следующей логике:

• Если есть терминальные исключения (политика терминала не допускает ремонт для данной специализации контейнера или загрузки контейнера) — стартовый статус всех повреждений и операции будет «Отклонен».

• Если есть клиентские исключения (по клиенту/терминалу/специализации/загрузке) — стартовый статус всех повреждений и операции будет «Отменен».

• Если исключений нет, операция «Ремонт» создаётся в статусе «Черновик», а зафиксированные повреждения — в статусе «Новое».

Если по сессии ранее уже были зафиксированы повреждения и создана операция «Ремонт», при добавлении новых повреждений в сценарии осмотра система анализирует текущий статус операции:

• Если статус существующей операции — «Черновик», «Отменена» или «Отклонена» (по причине терминальных или клиентских ограничений), новые повреждения будут добавлены в эту же операцию.

• Если подходящей операции не найдено — будет создана новая операция.

Технический осмотр контейнера

На этапе приёма контейнера выполняется операция технического осмотра, в рамках которой проверяется его текущее состояние.

• Фиксация результатов осмотра

  • Сотрудник заносит результаты проверки в мобильное приложение, включая сведения о состоянии контейнера.

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

• Автоматическое создание операции «Ремонт»

  • После регистрации повреждений в мобильном приложении в десктопной версии автоматически создаётся операция «Ремонт», содержащая все добавленные повреждения.

  • Операция привязывается к соответствующей контейнерной сессии и отображается в карточке контейнера на вкладке «Операции».

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

Отображение операции «Ремонт» в карточке контейнерной сессии в десктопной версии сайта

Добавить повреждение	Выбор зоны повреждения	Выбор типа повреждения	Отображение в списке

Вкладка «Повреждения»

Вкладка «Повреждения» предназначена для отображения, фиксации и управления информацией о дефектах контейнера в рамках операции «Ремонт». На вкладке представлен список всех зарегистрированных повреждений в виде таблицы с четко структурированными колонками.

Добавление повреждений

• Фиксация новых повреждений выполняется в мобильном приложении.

• После синхронизации данные автоматически попадают на вкладку «Повреждения» в веб-интерфейсе и становятся доступны для дальнейшей обработки.

Вкладка «Повреждения» операции «Ремонт»

Структура таблицы повреждений:

1. Повреждения

• Содержит кодировку и наименование повреждения.

• Название кликабельно — открывает карточку повреждения с детальной информацией.

2. Статус

• Показывает текущий статус повреждения.

3. Стоимость ремонта

• Отображает согласованную или расчетную стоимость ремонта.

4. Создано

• Отображает дату и время регистрации повреждения.

Структура таблицы повреждений и переход к карточке повреждений

Карточка повреждения

Карточка повреждения содержит подробную информацию о конкретном дефекте контейнера и включает следующие вкладки:

• Работы — перечень ремонтных операций с указанием стоимости;

• Материалы — список материалов, использованных при расчёте ремонта;

• Файлы — фотографии и документы, прикреплённые терминалом;

• История — хронология изменений по повреждению.

Левая часть карточки содержит основную информацию:

1. Код и наименование повреждения — идентификатор и краткое описание дефекта.

2. Статус повреждения — текущий этап согласования или ремонта.

3. Стоимость повреждения — согласованная или расчетная сумма ремонта.

4. Информация о клиенте — владелец контейнера.

5. Дополнительные параметры — тип контейнера, сток, направление (если указано).

6. Временные метки — дата создания и последнего обновления.

Вкладка «Работы»

Вкладка «Работы» используется для назначения, редактирования и удаления ремонтных операций, а также управления их стоимостью в рамках карточки повреждения.

• Добавление работ

  • Нажатие на кнопку «Добавить работу» открывает выпадающий список доступных операций.

  • После выбора операции она автоматически добавляется в таблицу.

• Редактирование стоимости

  • Для каждой добавленной работы предусмотрено редактируемое поле «Цена», куда стоимость вводится вручную.

• Сохранение изменений

  • После добавления работ и указания их стоимости необходимо нажать кнопку «Сохранить».

  • После сохранения система автоматически пересчитывает итоговую сумму и отображает её в карточке текущего повреждения, расположенной слева.

  • Итоговая сумма повреждения будет отображаться в столбце стоимость ремонта вкладки «Повреждения».

Добавление работ и редактирование стоимости

Отправка на согласование и новая структура таблицы работ

• После того как все работы добавлены и их стоимость указана, можно нажать кнопку «Сохранить и отправить на согласование».

• После отправки:

Статус повреждения автоматически изменяется на «Требуется согласование сметы», а статус операции переходит в режим «Требует согласования».

Отправка на согласование и новая структура таблицы работ

Отклонить работы

• При нажатии кнопки «Отклонить» статус повреждения меняется с «Новое» на «Отклонено».

Отклонение работ

• Изменения в таблице работ после действий

После отправки на согласование или отмены работ таблица работ получает новую структуру с расширенными колонками:

1. Работа — наименование выполненной или запланированной операции.

2. Сумма без НДС — стоимость работы без учёта налога.

3. НДС, % — ставка налога, применяемая к работе.

4. Налог — сумма налога, рассчитанная от стоимости работы.

5. Сумма с НДС — итоговая стоимость работы с учётом налога.

• В таблице автоматически пересчитываются все суммы и налоги для каждой работы.

• Такая структура предназначена для финального контроля стоимости работ после отправки на согласование.

Новая структура таблицы работ

• Удаление работ

  • Любую добавленную работу можно удалить с помощью кнопки «Удалить» в колонке «Действия».

  • После удаления работы и нажатия «Сохранить» система автоматически пересчитывает стоимость и обновляет итоговую сумму.

Удаление работ

Жизненный цикл повреждения и операции «Ремонт»

⓵ Согласование сметы внешним клиентом

• Внешний клиент выполняет согласование или отклонение повреждений.

• Статус каждого повреждения изменяется на:

  • «Смета согласована», если повреждение одобрено;

  • «Отклонена», если повреждение отклонено.

Согласование повреждения внешним клиентом

Отмена повреждения внешним клиентом

• Статус операции «Ремонт» меняется на «Согласована» только после того, как все повреждения в контейнерной сессии обработаны (согласованы или отклонены).

• Если все повреждения отменены, то статус операции «Ремонт» перейдёт в «Отменена».

Пример отмененной операции ремонта

⓶ Начало ремонта внутренним пользователем

• Для каждого согласованного повреждения в правом нижнем углу карточки появляется кнопка «В ремонт».

• После нажатия:

  • Статус повреждения меняется на «В ремонте».

  • Статус операции «Ремонт» для всей контейнерной сессии изменяется на «В работе».

  • В нижнем правом углу карточки вместо кнопки «В ремонт» появляется кнопка «Завершить».

⓷ Завершение ремонта

• При нажатии кнопки «Завершить» для конкретного повреждения:

  • Статус повреждения меняется на «Отремонтировано».

  • Статус операции «Ремонт» для контейнерной сессии меняется на «Завершена».

  • Значок повреждений исчезает.

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

Начало и завершение ремонта внутренним пользователем

Вкладка «Материалы»

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

Структура таблицы материалов

1. Материалы - отображает наименование или описание конкретного материала.

2. Цена - поле доступно для редактирования стоимости материалов.

3. Действия - содержит кнопку «Удалить» для удаления материалов.

Изменение структуры таблицы после отправки на согласование

• После нажатия кнопки «Сохранить и отправить на согласование» таблица материалов меняет структуру аналогично обновлённой таблице во вкладке «Работы».

• Новая структура отображает:

  1. Материал — наименование выбранного материала.

  2. Сумма без НДС — стоимость материала без учёта налога.

  3. НДС, % — ставка налога для позиции.

  4. Налог — рассчитанная сумма налога.

  5. Сумма с НДС — итоговая стоимость материала с учётом налога.

• Все суммы и налоги рассчитываются автоматически и отображаются в обновлённой таблице.

Измененная структура таблицы материалов после отправки на согласование

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

• Добавление материалов

  • Кнопка «Добавить материал» открывает выпадающий список доступных материалов.

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

  • Доступен поиск по названию или кодировке материала.

• Редактирование стоимости материалов

  • В таблице можно вводить стоимость единицы материала по каждой позиции.

• Удаление материалов

  • Ненужные материалы можно удалить с помощью кнопки «Удалить» в колонке «Действия».

• Автоматический перерасчёт общей стоимости происходит после нажатия кнопки «Сохранить» и система:

  • суммирует её с общей стоимостью работ;

  • отображает обновлённую итоговую сумму ремонта в карточке повреждения в левой части интерфейса.

Вкладка «Материалы»

Вкладка «Файлы»

В правом верхнем углу вкладки расположена кнопка «Загрузить файл» в верхнем углу раздела, по нажатию на которую начинается процесс загрузки файла. Поддерживается добавление как одного, так и нескольких файлов одновременно.

При попытке загрузить файл размером более 15 МБ всплывает предупреждение, информирующее пользователя о превышении допустимого размера. Такие файлы не загружаются.

Предупреждение, о превышении допустимого размера файла

Под кнопкой отображается таблица с колонками: Файл, Создан, Действие. Слева над таблицей имеется переключатель “Показать миниатюры”, который при активации добавляет новую колонку Изображение, отображающую миниатюры загруженных файлов.

Каждая строка таблицы содержит информацию о файле:

• Изображение — миниатюра загруженного файла,

• Файл — название файла,

• Создан — ФИО пользователя, загрузившего файл, а также дата и время загрузки,

• Действие — кнопка «Удалить файл». При нажатии на эту кнопку появляется модальное окно с запросом на подтверждение безвозвратного удаления файла. Для подтверждения необходимо нажать «Удалить», для отмены — «Закрыть».

Операции с файлами

Вкладка «История»

Вкладка «История» предназначена для отображения полного журнала всех действий, связанных с повреждением.

Структура таблицы

1. Дата

   • Отображает дату и время изменения.

   • Формат: ДД.ММ.ГГГГ ЧЧ:ММ:СС.

2. Статус

   • Показывает текущий статус повреждения или операции.

   • Для удобства навигации статусы выделяются разными цветами индикаторов.

3. Автор

   • Указывает пользователя, который выполнил действие.

Вкладка «История» повреждения

Вкладка «Файлы»

Вкладка «Файлы» предназначена для хранения и доступа к автоматически сформированным документам, связанным с операцией «Ремонт».

1. Условие формирования

   • После того как все повреждения в рамках текущей операции «Ремонт» были согласованы внешним клиентом, система автоматически создаёт Excel-документ со сметой.

2. Содержимое сметы
   В документ автоматически включаются:

   • Список всех повреждений
     Отображаются повреждения с указанием их кодов и описаний.

   • Перечень всех назначенных работ
     Для каждого повреждения указываются назначенные работы и их стоимость.

   • Общая стоимость материалов

   • Итоговая стоимость ремонта
     Отображается общая сумма ремонта для контейнера с учётом всех согласованных работ и материалов с НДС.

3. Размещение файла

   • Сформированный Excel-документ автоматически прикрепляется на вкладку «Файлы» в карточке операции «Ремонт».

Загрузка и пример сметы ремонта

Отмена, удаление и отклонение повреждения

Пока повреждение находится в статусе «Новое», с ним можно выполнить одно из следующих действий:

• Удалить (через сценарий осмотра в Android-приложении).

  • Если все повреждения удалены из операции и она единственная в сессии, операция переводится в статус «Отменена», состояние сессии меняется на «Без повреждений», чипса «Контейнер поврежден» удаляется.

• Отменить (пользователем клиента).

  • Если все повреждения по операции отменены и она единственная в сессии, операция переводится в статус «Отменена», состояние сессии остаётся «Поврежден», чипса «Контейнер поврежден» сохраняется.

• Отклонить (пользователем терминала или администратором).

  • Если все повреждения по операции отклонены и она единственная в сессии, операция переводится в статус «Отклонена», состояние сессии остаётся «Поврежден», чипса «Контейнер поврежден» сохраняется.

Формирование сметы ремонта повреждения

Пользователь терминала может составить смету по операциям, находящимся в статусе «Черновик».

Для этого из карточки операции он открывает конкретное повреждение контейнера и переходит в его карточку. В карточке предусмотрены отдельные вкладки для формирования сметы: пользователь добавляет необходимые работы и материалы для ремонта, указывая их стоимость. Количество не указывается — по умолчанию оно равно 1.

После того как все работы и материалы по повреждению добавлены, пользователь отправляет смету на согласование с помощью соответствующей кнопки в карточке повреждения. При этом статус повреждения меняется на «Требуется согласование сметы». С этого момента редактировать смету невозможно.

Когда пользователь терминала составил сметы по всем повреждениям в операции, статус операции меняется на «Требует согласования». Одновременно клиенту отправляется нотификация с типом **«Согласование ремонта»**следующего вида:

Уважаемый клиент!  

Требуется ваше согласование на ремонт контейнера [номер].  

Для ознакомления с перечнем повреждений и для согласования перейдите по ссылке:  
https://app.teus.pro/operations/[id_операции]?type=REPAIR  

Стандартная подпись

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

Этапы согласования сметы по повреждениям

1. Согласование сметы пользователем клиента или администратором
   Пользователь или администратор согласовывает все работы и материалы по повреждению с помощью кнопки «Согласовать». Частичное согласование не предусмотрено.

2. Изменение статуса повреждения после согласования
   После согласования статус повреждения меняется на «Смета согласована», после чего можно приступать к ремонту повреждения.

3. Отмена сметы пользователем клиента или администратором
   Если смета не согласована, пользователь или администратор нажимает «Отмена», и статус повреждения становится «Отменено».

4. Формирование печатной формы сметы
   Когда все повреждения в смете либо согласованы, либо отменены (при условии, что хотя бы одно повреждение имеет статус «Смета согласована»), формируется печатная форма сметы. Она доступна для скачивания во вкладке «Файлы» соответствующей карточки операции Ремонт.

Начало, прерывание и завершение ремонта повреждения

Начало ремонта

Пользователь терминала или администратор может начать ремонт повреждения из статуса «Смета согласована» при помощи соответствующей кнопки. В результате повреждение переводится в статус «В ремонте».

Прерывание ремонта

Если в ходе ремонта выясняется, что его выполнить невозможно, пользователь терминала может прервать ремонт повреждения с помощью соответствующей кнопки. В результате повреждение переводится в статус «Прервано», обновляется сумма ремонта и печатная форма сметы (работы и материалы по прерванному повреждению удаляются из неё).

Завершение ремонта

Пользователь терминала завершает ремонт при помощи соответствующей кнопки. В результате повреждение переводится в статус «Отремонтировано».

Если все повреждения по сессии отремонтированы, операция переходит в статус «Завершена», состояние сессии меняется с «Поврежден» на «Отремонтирован», чипса состояния меняется на «Контейнер отремонтирован».

Если хотя бы одно повреждение находится в статусах «Отменено», «Отклонено», «Прервано», состояние сессии остаётся «Поврежден», чипса «Контейнер поврежден» сохраняется.

Биллинг ремонта и связанных крановых операций

По факту завершения операции «Ремонт» система отправляет в модуль биллинга информацию по стоимости ремонта всех повреждений, а также по 2 крановым операциям.

Крановые операции выставляются в рамках счета с типом «Крановые».
Ремонт выставляется в рамках счета с типом «Дополнительные услуги».

Диаграмма перехода статусов повреждения

Сводный статус операции «Ремонт»

Статус операции «Ремонт» определяется самым "ранним" состоянием повреждений (по весу), если их несколько в операции.

Вес статусов повреждений и соответствующий статус операции: