Файлы и документы

К каждой заявке и отправлению можно прикреплять файлы: договоры, ТЗ, накладные, ТТН, путевые листы, фото груза, акты, скан-копии. LogiFlow хранит файлы в изолированном защищённом хранилище вне публичного веб-каталога: скачать файл напрямую по угаданной ссылке нельзя — доступ идёт только через защищённый эндпоинт с проверкой прав.

Где находятся файлы

В карточке заявки или отправления — вкладка Файлы.

Доступ к файлам по ролям

Доступ к файлам определяется ролью и принадлежностью к компании, а не пометками на отдельных файлах.

• Администратор, Руководитель, Менеджер — полный доступ к файлам заявок и отправлений своей компании.
• Кладовщик — может просматривать и скачивать файлы; загружать файлы отправлений кладовщик не может; удалять может только те файлы, которые загрузил сам.
• Клиент — файлы своих заявок видит и скачивает всегда; пока заявка в первичном статусе, он может загружать и удалять файлы и папки в ней. Файлы отправлений клиенту недоступны — вкладка скрыта.

Отдельного флага «показывать этот файл клиенту / это внутренний документ» в системе нет. Видимость работает на уровне всей записи и роли, а не отдельного файла.

Что клиент увидит в файлах заявки

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

Как только заявка уходит из первичного статуса, клиент остаётся с доступом на просмотр и скачивание, но загрузить или удалить уже ничего не может — при попытке система ответит «Изменить можно только пока заявка в первичном статусе».

Загрузка файлов

1. Откройте вкладку Файлы.
2. Перетащите файл в окно или нажмите Загрузить и выберите файл с компьютера.
3. Можно выбрать и загрузить несколько файлов сразу.
4. После загрузки появится индикатор прогресса; по достижении 100% файл сохранён.

Поддерживаемые форматы

Загружать можно файлы только из разрешённого списка типов:

• Документы: PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX.
• Изображения: JPG, JPEG, PNG, GIF, BMP, TIFF, WEBP, HEIC, HEIF.
• Текст и данные: TXT, CSV, RTF.
• Архивы: ZIP, RAR, 7Z.

Не любые файлы

Список форматов — закрытый. Файлы других типов, особенно потенциально опасные (исполняемые .exe, .bat, .msi, скрипты .js, .py, .sh, .php, библиотеки .dll и т. п.), система отклонит при загрузке. Это защита от загрузки замаскированных вредоносных файлов. Проверяется не только расширение, но и тип содержимого.

Ограничения по размеру

Лимит размера зависит от категории файла:

Категория	Максимальный размер
Изображения (JPG, PNG, HEIC, …)	10 МБ
Документы (PDF, DOC, XLS, PPT, …)	25 МБ
Архивы (ZIP, RAR, 7Z)	100 МБ
Прочие разрешённые типы (TXT, CSV, RTF)	50 МБ

Подписи в окнах загрузки могут отличаться

В разных окнах загрузки интерфейс показывает свой ориентировочный потолок размера: при создании заявки — 50 МБ, при загрузке файлов отправления — 100 МБ. Это клиентские подсказки конкретной формы. Решающими остаются серверные лимиты по категориям из таблицы выше (например, изображение всё равно не должно превышать 10 МБ, документ — 25 МБ). В обоих окнах за одну загрузку можно выбрать до 50 файлов.

Возможен дополнительный лимит сервера

Помимо лимитов приложения, на стороне веб-сервера компании может действовать собственный потолок размера запроса. Если очень большой файл не загружается, причина может быть в этой настройке сервера — уточните у администратора.

Папки

Чтобы вкладка не превращалась в свалку, заведите папки:

1. Нажмите Создать папку и введите имя.
2. Загружайте файлы в нужную папку.

И у заявок, и у отправлений папки поддерживаются.

Перемещение и переименование файлов не поддерживаются

В текущей версии нельзя:

• переместить уже загруженный файл из одной папки в другую;
• переименовать файл.

Поэтому выбирайте папку при загрузке. Если файл оказался не в той папке или с неудачным именем — удалите его и загрузите заново в нужную папку с нужным именем (имя берётся из загружаемого файла).

Типовые папки в логистических компаниях:

• От клиента — заявка, ТЗ, спецификация.
• От перевозчика — счёт, договор, путевые листы.
• Складские — фото при погрузке/выгрузке, ТТН.
• Закрывающие — акты, счета-фактуры.
• Внутренние — рабочие документы (напомним: клиент файлы всё равно не видит).

Скачивание

Клик по файлу открывает его (для PDF и изображений) или начинает скачивание (для остальных форматов). Изображения в формате HEIC/HEIF при просмотре автоматически конвертируются в JPEG, чтобы корректно отображаться в браузере.

Удаление

Удаление файла необратимо — корзины и восстановления нет.

Внимательно с удалением

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

Удалять файлы могут роли от менеджера и выше; кладовщик может удалить только те файлы, которые загрузил сам.

Безопасность файлов

LogiFlow защищает файлы несколькими механизмами:

• Изолированное хранилище. Файлы лежат вне публичного каталога сайта — веб-сервер не отдаёт их как статику. Получить файл можно только через защищённый эндпоинт.
• Проверка прав на каждый запрос. При скачивании система проверяет: суперпользователь, либо сотрудник той же компании, что и заявка/отправление, либо тот, кто сам загрузил файл. Иначе доступ запрещается.
• Защита от выхода за пределы хранилища. Подмена пути (попытка «вырваться» в системные каталоги) блокируется.
• Контроль типа при загрузке. Проверяются и расширение, и тип содержимого; опасные форматы отклоняются.
• Серверное логирование операций. Загрузки, скачивания и удаления пишутся в технические логи приложения (на стороне сервера). Это журнал для администраторов платформы и службы эксплуатации; отдельной пользовательской вкладки «журнал действий с файлами» в интерфейсе нет.

Чего система про файлы НЕ делает

Чтобы не возникало ложных ожиданий:

• Система не хранит контрольную сумму файла для проверки «подменён или нет» — гарантии целостности через хэш на уровне продукта нет.
• Нет перемещения файлов между папками и нет переименования (см. выше).
• Нет пометки отдельных файлов как «видимых клиенту» — доступ управляется ролью целиком.
• Нет корзины и восстановления удалённых файлов.

Временные файлы при создании заявки

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

Типичные ошибки при работе с файлами

• «Не загружается файл». Проверьте формат (он должен быть в списке поддерживаемых) и размер (лимит зависит от категории; архивы — до 100 МБ).
• «Загрузил архив с программой / скриптом — отклонило». Исполняемые файлы и скрипты запрещены. Упакуйте безопасно или передавайте другим каналом.
• «Хочу перенести файл в другую папку». Перемещение не поддерживается — удалите и загрузите заново в нужную папку.
• «Клиент не видит документы». Проверьте, куда они загружены: файлы заявки клиент видит и скачивает, файлы отправления — нет, и это штатное поведение.
• «Клиент не может приложить документ». Заявка уже вышла из первичного статуса — после этого клиенту остаётся только просмотр. Загрузите файл за него либо верните заявку в первичный статус.
• «Удалил нужный файл». Восстановление невозможно — загрузите файл заново из исходника.

Что дальше

• Заявки и Отправления — где файлы прикрепляются.
• Шаблоны печати — генерация документов из системы.