Закрытый раздел для скачки технической документации по продуктам. Чемодан

Начальная задачка

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

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

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

Цель проекта

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

Главные задачки:

  • ограничить доступ к разделу лишь для разрешенной группы юзеров;
  • вывести перечень препаратов с документами;
  • отдать возможность скачать все документы по одному продукту ZIP-архивом;
  • отдать возможность избрать отдельные документы снутри продукта;
  • воплотить общее скачка документов по нескольким продуктам;
  • сформировать общий архив по всем продуктам;
  • сохранить понятную структуру файлов снутри архива: документы должны раскладываться по папкам с наименованиями препаратов;
  • защитить прямой доступ к файлам и выдавать документы лишь опосля проверки прав.

Юзеры раздела

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

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

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

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

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

/docs/

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Общее скачка по продуктам

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

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

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

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

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

  Продукт 1/

    документ 1.pdf

    документ 2.docx

  Продукт 2/

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

    паспорт сохранности.pdf

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

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

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

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

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

Техно реализация

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

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

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

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

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

Сохранность

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

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

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

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

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

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

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

Главные решения:

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

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

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

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

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

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

Итог для клиента

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

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

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

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

Способности развития

В предстоящем раздел можно расширить доп способностями:

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

Читайте также:

  • Как посодействовать методу избрать ваш веб-сайт: почему нейросети цитируют соперников и что с сиим созодать
  • Как SEO посодействовало мед поликлинике прирастить количество записей практически в 10 раз
  • От упоминаний к советам: как определять итог SERM в ИИ-поиске

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *