Эксплуатационная документация ПО ЛогистРу

1. Назначение документа

Документ описывает порядок эксплуатации экземпляра ПО пользователями и администраторами: вход в систему, основные рабочие сценарии, назначение разделов, требования к рабочему месту и действия при типовых сбоях.

2. Требования к эксплуатации

Параметр	Значение
Рабочее место	ПК или ноутбук с современным браузером.
Браузеры	Google Chrome, Mozilla Firefox, Microsoft Edge, Яндекс Браузер актуальных версий.
Сеть	Доступ по HTTPS к адресу экземпляра.
Учетная запись	Пользователь создается через регистрацию или администратором аккаунта.
Права доступа	Роль и разрешения назначаются администратором.

3. Вход, выход и восстановление доступа

3.1. Регистрация

1. Открыть страницу регистрации https://logistsystem.ru/register.

2. Указать данные организации или индивидуального предпринимателя, контактное лицо, email, телефон и пароль учетной записи.

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

4. Отправить заявку на регистрацию.

5. Перейти по ссылке из письма для подтверждения email.

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

3.2. Вход

1. Открыть https://logistsystem.ru/login.

2. Ввести email и пароль.

3. Нажать кнопку входа.

4. После успешного входа перейти к нужному разделу меню.

3.3. Выход

Для завершения работы использовать команду выхода в интерфейсе. Система завершит пользовательскую сессию.

3.4. Восстановление пароля

1. Открыть страницу восстановления пароля.

2. Указать email учетной записи.

3. Перейти по ссылке из письма и задать новый пароль.

4. Структура интерфейса

Раздел	Что выполняется в разделе
Дашборд	Просмотр сводной информации, быстрый переход к рабочим операциям, расчет маршрута.
Заявки	Создание и сопровождение заявок на перевозку, маршруты, груз, участники, стоимость, документы, статусы и события рейса.
Документооборот	Работа с документами заявки, оплатами, банковскими выписками и сканами.
Контрагенты	Ведение заказчиков, перевозчиков и иных контрагентов, контактов и реквизитов.
Водители	Ведение карточек водителей и контактных данных.
Транспорт	Ведение автомобилей, прицепов и транспортных единиц.
Справочники	Типы грузов, упаковки, погрузки, кузовов, маркировки и иные нормативно-справочные данные.
Отчеты	Финансовая и операционная аналитика, выгрузки.
Настройки	Профиль компании, юридические лица, пользователи, интеграции, договоры, ЭДО, внешний вид, биллинг.
Техподдержка	Обращения, чат и вложения.

5. Работа с заявкой на перевозку

1. Открыть раздел «Заявки» и нажать создание заявки.

2. Заполнить основные сведения: номер, даты, заказчик, параметры груза, стоимость и условия оплаты.

3. Заполнить маршрут: точки погрузки и выгрузки, адреса, последовательность, плановые даты.

4. Добавить или выбрать участников перевозки: заказчика, перевозчика, грузоотправителя, грузополучателя и контакты.

5. Назначить водителя, транспортное средство и прицеп при необходимости.

6. Сохранить заявку и проверить отображение карточки.

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

8. Сформировать договор, транспортную накладную, поручение экспедитору, экспедиторскую расписку или доверенность, если это требуется по процессу.

6. Портал водителя

Для водителя может быть сформирована токен-ссылка вида /driver/link/{token}. Водитель открывает ссылку без входа в основной интерфейс, просматривает информацию по рейсу и передает события исполнения. Доступ по ссылке ограничен данными конкретного рейса.

7. Работа с документами

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

• PDF-документы формируются из данных заявки и настроек юридического лица.

• XLSX- и XML-файлы формируются для транспортных документов и электронного обмена.

• Версии XML и артефакты подписания сохраняются для последующей проверки и аудита.

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

8. Настройки администратора аккаунта

• Заполнить профиль компании и юридические лица.

• Настроить договорные шаблоны, политику обработки персональных данных и согласия.

• Назначить пользователям роли и права.

• Ввести ключи интеграций DaData, Checko, ATI и tracking receiver при наличии договоров с этими сервисами; для GraphHopper указать URL локального сервиса маршрутизации.

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

9. Безопасная эксплуатация

• Не передавать логин и пароль третьим лицам.

• Назначать минимально необходимые права пользователям.

• Регулярно проверять список пользователей и блокировать неактуальные учетные записи.

• Не вводить ключи интеграций и внутренние URL сервисов в исходный код или общедоступные документы.

• При подозрении на компрометацию учетной записи сменить пароль и завершить активные сессии.

10. Типовые ошибки и действия пользователя

Симптом	Что проверить	Действие
Не удается войти	Email, пароль, статус пользователя, подтверждение email.	Восстановить пароль или обратиться к администратору.
Нет пункта меню	Роль, разрешения и тариф.	Запросить доступ у администратора аккаунта.
Не сохраняется заявка	Обязательные поля формы и корректность реквизитов.	Заполнить подсвеченные поля, повторить сохранение.
Не рассчитался маршрут	Адреса, route_url локального GraphHopper, профиль маршрутизации и доступность сервиса.	Уточнить адреса, проверить локальный сервис маршрутизации или выполнить расчет позже.
Не пришло письмо	Папка «Спам», настройки почты платформы.	Обратиться в поддержку.
Не формируется PDF/XML	Полноту данных заявки, участников и настроек юридического лица.	Заполнить недостающие данные и повторить формирование.

11. Действия администратора при сбоях

• Проверить журнал приложения storage/logs/laravel.log.

• Проверить доступность MySQL и свободное место на диске.

• Проверить права на каталоги storage и bootstrap/cache.

• Проверить состояние queue worker и наличие ошибок отложенных задач.

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

12. Завершение работы

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