Материал обновлён 21 октября 2026 года.
В личном кабинете подрядчика появляется кнопка "Прикрепить документ". За ней стоят разные задачи: принять файл, проверить его, связать с нужным заказом и предоставить доступ сотруднику. Если эти условия обсуждаются после разработки формы, обнаруживаются неприятные пробелы. Клиент видит сообщение об успехе, хотя проверка ещё идёт, или вложение оказывается доступным человеку из другого проекта.
Определите назначение каждого вложения
Начните с короткого описания рабочего процесса. Кто загружает документ, для какого объекта, кто его рассматривает и когда он перестаёт быть нужен? Для учебного кабинета можно выбрать один сценарий: клиент прикладывает PDF к конкретной заявке, менеджер получает доступ после проверки. Редактирование заявки и просмотр вложений считаются отдельными правами.
Затем согласуйте допустимый формат и предел размера. Учебное ограничение в 10 МБ подходит для обсуждения поведения формы; реальное значение выбирают по документам бизнеса и возможностям инфраструктуры. Опишите, разрешена ли замена файла, кто видит предыдущую версию и что происходит с вложениями после удаления заявки. Эти решения полезно включить в требования до появления интерфейса.
Разделите удобство формы и серверную защиту
Подсказка рядом с полем заранее сообщает формат и размер. Проверка в браузере помогает быстро заметить ошибку, однако окончательное решение принимает сервер. По рекомендациям OWASP проверяют разрешённые расширения, фактический тип и содержимое файла, ограничивают размер и доступ. Заголовку Content-Type, который прислал клиент, доверять как доказательству формата нельзя.
Для хранения приложение создаёт собственное имя. Исходное название можно отдельно показывать пользователю после безопасной обработки. Файл размещают в изолированном хранилище либо за пределами публичной папки сайта. При скачивании система снова проверяет право на конкретный документ. Секретность адреса сама по себе такого контроля не обеспечивает.
Проверку антивирусом, обработку содержимого и ограничения библиотек выбирают с разработчиком под допустимые форматы. Ни одна отдельная проверка не подтверждает абсолютную безопасность. Если документ временно недоступен до окончания анализа, это состояние должно быть отражено и в интерфейсе, и в правилах выдачи файла.
Сохраните понятный путь к исправлению
Состояния загрузки помогают отличить передачу байтов от готовности документа для менеджера. Для учебной формы согласуйте такие сообщения.
| Состояние | Что сообщить пользователю |
|---|---|
| Файл выбран | Документ выбран в текущем окне; передача ещё не подтверждена. |
| Передаётся | Идёт отправка файла на сервер. |
| Проверяется | "Документ получен, выполняется проверка". Вложение пока может быть недоступно менеджеру. |
| Доступен | Проверка завершена по правилам системы, документ доступен сотруднику с нужными правами. |
| Отклонён | Укажите причину отказа и допустимое действие для исправления. |
Показывать процент проверки следует лишь при наличии измеряемых данных о выполнении.
При слишком большом файле сообщите допустимый предел рядом с полем. При сбое сети сохраните остальные введённые сведения. По возможности оставьте выбранный файл в текущем окне для повторной попытки, учитывая ограничения браузера и требования безопасности. После перезагрузки страницы повторный выбор может потребоваться; интерфейс должен объяснять это заранее, когда такая ситуация вероятна.
Как принять эту функцию у разработчика
Проведите приёмку в согласованной тестовой среде с обезличенными документами.
- Подготовьте подходящий PDF, файл превышенного размера, документ с неожиданным типом и два файла с одинаковыми исходными именами.
- Проверьте загрузку с телефона и прерывание сети. Запишите, какое состояние формы видно в каждом случае.
- Создайте два учебных аккаунта разных клиентов. Второй аккаунт должен получить отказ при попытке открыть документ первого.
Зафиксируйте ожидаемое поведение каждого случая. После отказа в хранилище не должно оставаться доступного вложения, а повторная отправка после исправления должна давать понятный результат. Отдельно проверьте удаление временных файлов и сообщение об окончании проверки. Так приёмка охватывает весь путь документа от выбора до скачивания.
Разработку личного кабинета и требований к обработке вложений можно обсудить с Семёном Дулесовым.
Какие документы ваши клиенты чаще всего прикладывают к заявкам?