валидатор веб-сайта PA

Приложение для оценки адгезии шаблона

Настольное приложение для поддержки разработчиков, которое помогает оценить качество институциональных сайтов муниципалитетов и школ, а также соответствие многим критериям соответствия меры 1.4.1 опыта PNRR Citizen в цифровых государственных услугах.

Оценочные приложения представляют собой инструменты, которые интегрируют библиотеку Lighthouse и проводят тесты для проверки правильности соблюдения модели муниципалитетов и модели школы Designers Italia.

Узнайте больше о приложениях для оценки.

Функциональность

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

Тестирование модели школ

Тест	Описание
Критерии соответствия	Показаны результаты проверок, касающихся критериев соответствия школьной модели.
Рекомендации по дизайну	Показаны результаты проверок, касающихся рекомендаций по проектированию модели школы.
Дополнительные тесты	Показаны стандартные результаты испытаний, предоставленные маяком. Они не имеют значения с точки зрения достижения критериев соответствия, но все же представляют собой полезные индикаторы для оценки любых улучшений сайта.
Рекомендация по проектированию «R.SC.3.1 – Скорость и время отклика»	Показан результат теста рекомендации по проектированию «R.SC.3.1 — Скорость и время отклика» для школьного сайта.

Тестирование модели муниципалитетов

Тест	Описание
Пакет «Информированный гражданин»: критерий «C.SI.4.1 — Скорость и время отклика»	Показан результат теста по критерию «C.SI.4.1 — Скорость и время отклика» для муниципального объекта.
Пакет «Информированный гражданин»: критерии соответствия	Приведены результаты проверок соответствия критериям муниципального объекта.
Пакет «Активный гражданин»: критерии соответствия	Показаны результаты проверок критериев соответствия муниципальных цифровых услуг.
Пакет «Информированный гражданин»: рекомендации проекта	Показаны результаты проверок рекомендаций по проектированию муниципального объекта.
Дополнительные тесты	Показаны стандартные результаты испытаний, предоставленные маяком. Они не имеют значения с точки зрения достижения критериев соответствия, но все же представляют собой полезные индикаторы для оценки любых улучшений сайта.

Отчеты и сообщения в консоли

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

 ...
https://esempio.scuola.edu.it/novita/ 200
https://esempio.scuola.edu.it/didattica/ 200
...

которые указывают результат загрузки рассматриваемой страницы (200 = успех). Эту информацию можно использовать для отладки сайта или самого приложения.

Технологии

PA Website Validator использует следующие технологии

• Node.js — среда выполнения Javascript
• npm — менеджер пакетов
• Lighthouse — расширенная базовая библиотека для проведения аудитов.
• Typescript — строго типизированный язык программирования, основанный на JavaScript.

Требования

Для проверки веб-сайта PA требуется Node.js v18+ (LTS), npm и Google Chrome.

Плагины

Валидатор веб-сайта PA использует следующие основные внешние зависимости

Плагины	Репозитории
Маяк	GitHub
Ярги	GitHub
Кукольник	GitHub
Приветствую вас	GitHub
JSDOM	GitHub
Гео IP	GitHub
Получить SSL-сертификат	GitHub

Локальная установка

Для локальной установки после клонирования репозитория запустите:

 cd pa-website-validator
npm install

Каталог dist будет заполнен результатами процесса сборки.

Использование:

 node dist --type  --destination  --report  --website  --scope  --view

Пример:

 node dist --type school --destination ~/pa-italia-crawler-reports --report myreport --website https://www.ismonnet.edu.it/ --scope online --view --accuracy all 

Глобальная установка

После завершения глобальной установки вы сможете использовать команду pa-website-validator из терминала без необходимости входа в клонированный каталог. Это процедура глобальной установки команды:

 cd pa-website-validator
npm install
npm install -g --install-links

NB : вам может потребоваться перезапустить оболочку/терминал для распространения команд и очистки кеша npm:

 npm cache clean

Использование:

 pa-website-validator --type  --destination  --report  --website  --scope  --view

Пример:

 pa-website-validator --type school --destination ~/pa-italia-crawler-reports --report myreport --website https://www.ismonnet.edu.it/ --scope online --view --accuracy all 

Параметры команды

Параметр команды	Описание	Обязательный	Возможные значения	По умолчанию
- -помощь	Показать карту команд	❌
- -версия	Версия пакета	❌
- -тип	Тип сканера для запуска	✅	«муниципалитет» «школа»
- -место назначения	Папка для сохранения отчетов	✅
- -отчет	Имя, которое нужно присвоить отчету	✅
- -сайт	URL-адрес веб-сайта для анализа	✅
- -объем	Объемы исполнения	❌	«местный» «онлайн»	"онлайн"
- -вид	Мгновенный просмотр отчета	❌
- -точность	Определяет болезненность сканирования	✅	«мин», «рекомендуется», «высокий», «все»	"предложенный"

Примечания:

• --type указывает, какой тип веб-сайта проверяется (муниципальный или школьный).

• --scope указывает тип аудита, который необходимо выполнить:

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

• --view если он передан команде в конце аудита, запускает экземпляр Chrome, который автоматически отображает сгенерированные отчеты.

• --accuracy указывает точность сканирования, определяемую как количество отсканированных страниц:

  • all сканирование выполняется на всех доступных страницах.