Initial commit

src/common/checks.md

@@ -0,0 +1,92 @@
+---
+icon: material/file-refresh-outline
+tags: ["статусы", "плейлисты", "каналы", "iptvc"]
+---
+
+# :material-file-refresh-outline: Как проверяются плейлисты
+
+Плейлисты проверяются автоматически с некоей периодичностью при помощи [iptvc](../iptvc/how-it-works.md).
+Она может настраиваться мной в разное время, чтобы сбалансировать нагрузку на сервер.
+
+!!! danger "Я не гарантирую корректность и актуальность плейлистов, которые ты увидишь на сайте, как и корректность результатов их проверки."
+    После прочтения этой страницы ты поймёшь почему.
+
+Хотя я и стараюсь улучшать качество проверок, но всё же рекомендую проверять желаемые плейлисты самостоятельно вручную, ибо нет никаких гарантий:
+
+* что плейлист (не) работоспособен
+  * он может быть и рабочий, но проверка может не сработать из-за таймаута запроса;
+  * он уже может быть и нерабочим, но результаты последней проверки показывают обратное;
+* что плейлист корректно обработается (будут правильно определён список каналов, их названия, атрибуты и пр.);
+* что транслируемый контент соответствует названиям каналов;
+* что сейчас или через X времени там не окажется [заглушка](../faq.md#заглушка).
+
+<a id="плейлисты"></a>
+## Плейлисты
+
+Каждый плейлист может быть в одном из трёх статусов:
+
+* <span class="badge unknown">unknown</span> -- Плейлист в очереди на проверку  
+  Он сменит свой статус в ближайшие минуты.
+
+* <span class="badge online">online</span> -- Плейлист активен  
+  Это не значит, что он работает.
+  Это значит, что адрес плейлиста корректен и там, *вероятно*, *что-то* транслируется.
+  В нём может быть 0 каналов -- значит, содержимое потёрли.
+
+* <span class="badge offline">offline</span> -- Плейлист недоступен  
+  Если этот статус висит постоянно, значит это главный кандидат на удаление из проекта.
+  Но это может быть просто разовый сбой (например, таймаут проверки), и, *возможно*, скоро он станет доступен.
+
+!!! info "Обрати внимание"
+    Независимо от статуса плейлиста на сайте, его можно добавить в свой плеер по "Ссылке для ТВ" и проверить самостоятельно.
+    Проверка плейлиста не влияет на его работоспособность.
+
+<a id="каналы"></a>
+## Каналы
+
+Каждый канал в любом плейлисте может быть в одном из трёх статусов:
+
+* <span class="icon online"><ion-icon name="radio-button-on-outline"></ion-icon></span> -- *Возможно*, канал работает  
+  Но там может транслироваться какая-нибудь [заглушка](../faq.md#заглушка) (например, от [Wink](../faq.md#wink)).
+
+* <span class="icon offline"><ion-icon name="radio-button-on-outline"></ion-icon></span> -- *Возможно*, канал не работает  
+  Чем больше таких каналов в плейлисте, тем сложнее будет листать плейлист в плеере или на ТВ.
+  Но, *возможно*, *когда-нибудь* плейлист обновят и канал будет работать исправно.
+  Также и здесь может быть просто разовый сбой (например, таймаут проверки), и (возможно) скоро он станет доступен.
+
+!!! info "Обрати внимание"
+    Пропорции рабочих и нерабочих каналов в плейлистах может и будет меняться от проверки к проверке.
+    Это нормально, таковы технические особенности проверки.
+
+<a id="возможности"></a>
+## Возможности
+
+В описаниях плейлистов, которые находятся в статусе <span class="badge online">online</span>, можно встретить следующие иконки:
+
+* <ion-icon name="folder-open-outline"></ion-icon> -- каналы плейлиста разбиты на группы (например, музыкальные каналы и региональные);
+* <ion-icon name="newspaper-outline"></ion-icon> -- плейлист предоставляет программу передач для каналов;
+* <ion-icon name="play-back"></ion-icon> -- плейлист предоставляет возможность перемотки передач.
+
+Если плейлист недоступен или непроверен, этих иконок не будет.
+
+<a id="для-взрослых"></a>
+## Контент для взрослых
+
+Это откровенно порнографический, эротический или другой контент, неприемлемый для детской психики (например, жанровые каналы с фильмами ужасов).
+
+Если при проверке плейлиста обнаружен хотя бы один канал для взрослых, то сам канал и весь плейлист помечается значком <span class="badge adult">18+</span>
+
+Такие каналы определяются благодаря правилам, описанным в файле [channels.json](../formats/channels.md).
+Они применяются к названиям каналов и их атрибутам (`tvg-id`, `tvg-name`), которые описывают канал в плейлисте.
+
+Для каналов со взрослым контентом применяется тег `adult`.
+
+!!! warning "Обрати внимание"
+    Далеко не все каналы могут быть помечены таким тегом.
+    Хотя набор правил для тегов очень богат, но невозможно угадать все каналы с приемлемой точностью.
+    Почему -- читай [здесь](../formats/channels.md#warnings).
+
+!!! info "Примечание"
+    Теперь должно стать понятно, почему я не даю и не могу дать никаких гарантий относительно результатов проверок и тегов.
+    Каждый раз это просто непредсказуемый процесс.
+