Кейс: закрытый раздел для скачивания технической документации по препаратам

Исходная задача

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

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

Клиент хотел получить удобный интерфейс, похожий на структуру файлового хранилища: пользователь заходит на страницу, видит список препаратов, выбирает нужный препарат или несколько препаратов и скачивает документы архивом. 

Цель проекта

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

Основные задачи:

1. ограничить доступ к разделу только для разрешённой группы пользователей;
2. вывести список препаратов с документами;
3. дать возможность скачать все документы по одному препарату ZIP-архивом;
4. дать возможность выбрать отдельные документы внутри препарата;
5. реализовать массовое скачивание документов по нескольким препаратам;
6. сформировать общий архив по всем препаратам;
7. сохранить понятную структуру файлов внутри архива: документы должны раскладываться по папкам с названиями препаратов;
8. защитить прямой доступ к файлам и выдавать документы только после проверки прав.

Пользователи раздела

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

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

Для проекта настроена проверка доступа по группе пользователей: работать с разделом могут администраторы и пользователи группы №7. 

Структура закрытого раздела 

Раздел реализован на странице: 

/docs/ 

На странице выводится список препаратов. Для каждого препарата доступны действия: 

1. скачать все документы по препарату ZIP-архивом;
2. открыть модальное окно и выбрать отдельные документы;
3. отметить препарат чекбоксом для массового скачивания документов по нескольким препаратам.

В верхней части страницы размещены массовые действия: 

1. «Скачать документы на все препараты одним архивом»; 
2. «Скачать документы выбранных препаратов ZIP».

Кнопка скачивания выбранных препаратов изначально скрыта. Когда пользователь отмечает хотя бы один препарат, кнопка общего архива скрывается, а вместо неё появляется кнопка скачивания выбранных препаратов.

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

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

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

Пользователь может работать с документами несколькими способами:

1. Скачать все документы по конкретному препарату.
2. Открыть список документов препарата в модальном окне.
3. Скачать один конкретный файл.
4. Отметить несколько документов внутри препарата и скачать только выбранные.
5. Отметить несколько препаратов и скачать все документы по ним одним архивом. 
6. Скачать документы по всем препаратам одним общим архивом.

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

Модальное окно выбора документов 

Чтобы не перегружать страницу, список файлов по каждому препарату не выводится сразу при загрузке. Документы подгружаются AJAX-запросом только после клика на кнопку «Выбрать документы». 

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

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

Массовое скачивание по препаратам 

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

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

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

Внутри архива документы группируются по папкам: 

Общий архив.zip

   Препарат 1/

      документ 1.pdf

      документ 2.docx

   Препарат 2/

      декларация.pdf

      паспорт безопасности.pdf

Предупреждение при большом количестве выбранных препаратов 

Чтобы предупредить пользователя о возможной длительной загрузке, добавлено модальное предупреждение. 

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

1. «Скачать выбранное» — сразу запускает скачивание архива по выбранным препаратам; 
2. «Продолжить выбор» — закрывает предупреждение и позволяет выбирать препараты дальше.

Предупреждение повторяется при выборе 20-го, 30-го, 40-го препарата и далее каждые 10 выбранных позиций. Логика учитывает текущее количество выбранных чекбоксов при каждом изменении: если пользователь снял часть отметок, а затем снова дошёл до порогового значения, предупреждение появится повторно.

 Техническая реализация

Раздел реализован на сайте под управлением 1С-Битрикс. Для вывода списка препаратов используется компонент bitrix:news.list.

В целях оптимизации файловое свойство DOCS не загружается сразу для всех элементов списка. На странице может быть до 1000 препаратов, поэтому предварительная загрузка всех документов могла бы замедлять работу раздела. Вместо этого реализована ленивая AJAX-загрузка: список документов конкретного препарата запрашивается только при открытии модального окна.

Для проекта разработаны отдельные серверные обработчики:

1. /docs/get_documents.php — получает список документов конкретного препарата для модального окна;
2. /docs/download_file.php — скачивает один документ;
3. /docs/download_zip.php — формирует ZIP по одному препарату или выбранным документам;
4. /docs/download_zip_bulk.php — формирует ZIP по всем или выбранным препаратам.

ZIP-архивы формируются стандартными средствами PHP без сторонних библиотек. Временные архивы создаются в каталоге /docs/zipfile и удаляются после скачивания, чтобы не занимать место на сервере.

 Безопасность 

Раздел закрыт от неавторизованных пользователей. Доступ к странице и ко всем AJAX-обработчикам проверяется отдельно. 

Перед просмотром или скачиванием документов система проверяет: 

1. авторизован ли пользователь; 
2. входит ли пользователь в разрешённую группу; 
3. является ли пользователь администратором; 
4. корректна ли сессия Битрикс; 
5. корректна ли подпись переданных параметров; 
6. относится ли запрошенный файл к выбранному препарату

Прямые ссылки на файлы из /upload/iblock/ не используются для скачивания. Одиночные документы отдаются через защищённый PHP-обработчик /docs/download_file.php. Это позволяет не открывать документы публично и исключить скачивание файла без проверки прав.

Даже если пользователь узнает технический ID файла, он не сможет скачать его через обработчик, если этот файл не привязан к выбранному препарату в свойстве DOCS.

 Оптимизация производительности 

Так как раздел может содержать большое количество препаратов и документов, особое внимание было уделено скорости загрузки страницы. 

Основные решения:

1. документы не загружаются вместе со списком препаратов; 
2. список файлов подгружается только по клику; 
3. результат AJAX-загрузки кешируется на стороне браузера в рамках текущей страницы; 
4. ZIP формируется на диске, а не в оперативной памяти; 
5. временные архивы удаляются после скачивания; 
6. для массового скачивания добавлено предупреждение при выборе большого количества препаратов.

Такой подход позволяет сохранить быструю загрузку основной страницы и при этом поддерживать работу с большим объёмом файлов.

 Управление документами 

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

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

Участие программиста для стандартного добавления или замены документов не требуется. 

Результат для клиента 

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

Что изменилось после внедрения: 

1. документы стали доступны в единой закрытой точке; 
2. снизилась нагрузка на сотрудников, которые раньше вручную искали и отправляли файлы; 
3. пользователи могут скачивать документы по одному препарату, нескольким препаратам или всем препаратам сразу; 
4. появилась возможность выбирать только нужные файлы внутри препарата; 
5. архивы формируются автоматически и сохраняют понятную структуру по папкам;
6. прямой доступ к файлам закрыт, скачивание проходит через проверку прав;
7. обновление документов выполняется через административную панель сайта.

Функционал решил исходную бизнес-задачу: упростил передачу документов партнёрам и клиентам, сократил ручные операции и повысил контроль над доступом к технической документации.

 Возможности развития 

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

1. добавить поиск по названию препарата или документа; 
2. вывести дату загрузки и срок действия документа; 
3. добавить статусы актуальности сертификатов; 
4. реализовать уведомления об истечении срока действия документов; 
5. добавить журнал скачиваний; 
6. настроить статистику по пользователям и документам; 
7. реализовать разные уровни доступа для отдельных групп пользователей; 
8. добавить интеграцию с CRM, 1С или внутренней системой клиента.