dsh-desktop-kit 0.0.0-stage → 1.0.0

package/skills/seo/assets/snippets/jsonld-breadcrumb.json

@@ -0,0 +1,30 @@
+{
+  "@context": "https://schema.org",
+  "@type": "BreadcrumbList",
+  "@id": "https://example.org/uslugi/mrt-golovy/#breadcrumb",
+  "itemListElement": [
+    {
+      "@type": "ListItem",
+      "position": 1,
+      "name": "Главная",
+      "item": "https://example.org/"
+    },
+    {
+      "@type": "ListItem",
+      "position": 2,
+      "name": "Услуги",
+      "item": "https://example.org/uslugi/"
+    },
+    {
+      "@type": "ListItem",
+      "position": 3,
+      "name": "МРТ",
+      "item": "https://example.org/uslugi/mrt/"
+    },
+    {
+      "@type": "ListItem",
+      "position": 4,
+      "name": "МРТ головного мозга"
+    }
+  ]
+}

package/skills/seo/assets/snippets/jsonld-faq.json

@@ -0,0 +1,39 @@
+{
+  "@context": "https://schema.org",
+  "@type": "FAQPage",
+  "@id": "https://example.org/uslugi/mrt-golovy/#faq",
+  "mainEntity": [
+    {
+      "@type": "Question",
+      "name": "Нужно ли направление врача на МРТ?",
+      "acceptedAnswer": {
+        "@type": "Answer",
+        "text": "При платном исследовании направление не обязательно. При прохождении по ОМС нужно направление лечащего врача. Результат МРТ действителен для консультации в организация."
+      }
+    },
+    {
+      "@type": "Question",
+      "name": "Сколько длится МРТ головного мозга?",
+      "acceptedAnswer": {
+        "@type": "Answer",
+        "text": "Исследование без контрастирования занимает 20–30 минут, с контрастированием — до 45 минут. Результат выдаётся в день исследования."
+      }
+    },
+    {
+      "@type": "Question",
+      "name": "Есть ли противопоказания к МРТ?",
+      "acceptedAnswer": {
+        "@type": "Answer",
+        "text": "Абсолютные противопоказания: кардиостимулятор, металлические импланты, ферромагнитные осколки, беременность I триместра. Перед исследованием врач уточняет анамнез и заполняет анкету безопасности."
+      }
+    },
+    {
+      "@type": "Question",
+      "name": "Как подготовиться к МРТ головного мозга?",
+      "acceptedAnswer": {
+        "@type": "Answer",
+        "text": "Специальная подготовка не требуется. При контрастировании исследование проводится натощак (не есть 4–6 часов). Возьмите с собой результаты предыдущих исследований и документы."
+      }
+    }
+  ]
+}

package/skills/seo/assets/snippets/jsonld-medical-clinic.json

@@ -0,0 +1,49 @@
+{
+  "@context": "https://schema.org",
+  "@type": "MedicalClinic",
+  "@id": "https://example.org/kontakty/#clinic",
+  "name": "организация — главный корпус",
+  "url": "https://example.org/kontakty/",
+  "image": "https://example.org/upload/building-1200x630.jpg",
+  "telephone": "+7-495-000-00-00",
+  "priceRange": "₽₽",
+  "currenciesAccepted": "RUB",
+  "paymentAccepted": "Наличные, банковская карта, ОМС, ДМС",
+  "address": {
+    "@type": "PostalAddress",
+    "streetAddress": "ул. Новая, д. 12",
+    "addressLocality": "Москва",
+    "addressRegion": "Москва",
+    "postalCode": "105005",
+    "addressCountry": "RU"
+  },
+  "geo": {
+    "@type": "GeoCoordinates",
+    "latitude": 55.7654,
+    "longitude": 37.6543
+  },
+  "hasMap": "https://yandex.ru/maps/org/00000000000",
+  "openingHoursSpecification": [
+    {
+      "@type": "OpeningHoursSpecification",
+      "dayOfWeek": ["Monday", "Tuesday", "Wednesday", "Thursday", "Friday"],
+      "opens": "08:00",
+      "closes": "20:00"
+    },
+    {
+      "@type": "OpeningHoursSpecification",
+      "dayOfWeek": ["Saturday"],
+      "opens": "09:00",
+      "closes": "15:00"
+    }
+  ],
+  "medicalSpecialty": ["Cardiovascular", "Oncologic", "Neurologic", "PrimaryCare"],
+  "isAcceptingNewPatients": true,
+  "parentOrganization": {
+    "@id": "https://example.org/#organization"
+  },
+  "sameAs": [
+    "https://yandex.ru/maps/org/00000000000",
+    "https://2gis.ru/moscow/firm/000000000000000"
+  ]
+}

package/skills/seo/assets/snippets/jsonld-medical-webpage.json

@@ -0,0 +1,33 @@
+{
+  "@context": "https://schema.org",
+  "@type": "MedicalWebPage",
+  "@id": "https://example.org/uslugi/mrt-golovy/#webpage",
+  "url": "https://example.org/uslugi/mrt-golovy/",
+  "name": "МРТ головного мозга: показания, подготовка, цена",
+  "description": "Как проходит МРТ головного мозга, кому показано, как подготовиться, сколько стоит в организация.",
+  "inLanguage": "ru-RU",
+  "isPartOf": {
+    "@id": "https://example.org/#website"
+  },
+  "about": {
+    "@type": "MedicalCondition",
+    "name": "Заболевания головного мозга"
+  },
+  "mainContentOfPage": {
+    "@type": "WebPageElement"
+  },
+  "medicalAudience": "https://schema.org/Patient",
+  "specialty": "https://schema.org/Neurologic",
+  "datePublished": "2025-02-10",
+  "dateModified": "2026-10-20",
+  "lastReviewed": "2026-10-20",
+  "reviewedBy": {
+    "@type": "Physician",
+    "name": "Петров Сергей Николаевич",
+    "jobTitle": "Врач-рентгенолог",
+    "url": "https://example.org/vrachi/petrov-sergey/"
+  },
+  "breadcrumb": {
+    "@id": "https://example.org/uslugi/mrt-golovy/#breadcrumb"
+  }
+}

package/skills/seo/assets/snippets/jsonld-organization.json

@@ -0,0 +1,74 @@
+{
+  "@context": "https://schema.org",
+  "@type": ["MedicalOrganization", "MedicalClinic"],
+  "@id": "https://example.org/#organization",
+  "name": "Городская клиническая больница №31",
+  "alternateName": "организация",
+  "url": "https://example.org/",
+  "logo": {
+    "@type": "ImageObject",
+    "@id": "https://example.org/#logo",
+    "url": "https://example.org/upload/logo-512.png",
+    "width": 512,
+    "height": 512,
+    "caption": "организация"
+  },
+  "image": "https://example.org/upload/building-1200x630.jpg",
+  "description": "Многопрофильная больница в Москве: консультации врачей, диагностика, стационарное лечение.",
+  "telephone": "+7-495-000-00-00",
+  "email": "info@example.org",
+  "address": {
+    "@type": "PostalAddress",
+    "streetAddress": "ул. Новая, д. 12",
+    "addressLocality": "Москва",
+    "addressRegion": "Москва",
+    "postalCode": "105005",
+    "addressCountry": "RU"
+  },
+  "geo": {
+    "@type": "GeoCoordinates",
+    "latitude": 55.7654,
+    "longitude": 37.6543
+  },
+  "openingHoursSpecification": [
+    {
+      "@type": "OpeningHoursSpecification",
+      "dayOfWeek": ["Monday", "Tuesday", "Wednesday", "Thursday", "Friday"],
+      "opens": "08:00",
+      "closes": "20:00"
+    },
+    {
+      "@type": "OpeningHoursSpecification",
+      "dayOfWeek": ["Saturday"],
+      "opens": "09:00",
+      "closes": "15:00"
+    }
+  ],
+  "areaServed": {
+    "@type": "City",
+    "name": "Москва"
+  },
+  "medicalSpecialty": ["Cardiovascular", "Oncologic", "Neurologic", "PrimaryCare"],
+  "isAcceptingNewPatients": true,
+  "sameAs": [
+    "https://vk.com/service-desk",
+    "https://t.me/service-desk",
+    "https://yandex.ru/maps/org/00000000000",
+    "https://2gis.ru/moscow/firm/000000000000000"
+  ],
+  "contactPoint": [
+    {
+      "@type": "ContactPoint",
+      "contactType": "registratura",
+      "telephone": "+7-495-000-00-00",
+      "areaServed": "RU",
+      "availableLanguage": "ru"
+    }
+  ],
+  "hasCredential": {
+    "@type": "EducationalOccupationalCredential",
+    "credentialCategory": "Лицензия на осуществление медицинской деятельности",
+    "identifier": "ЛО-77-01-000000",
+    "validFrom": "2024-01-15"
+  }
+}

package/skills/seo/assets/snippets/jsonld-physician.json

@@ -0,0 +1,46 @@
+{
+  "@context": "https://schema.org",
+  "@type": ["Physician", "Person"],
+  "@id": "https://example.org/vrachi/ivanov-ivan/#physician",
+  "name": "Иванов Иван Иванович",
+  "jobTitle": "Врач-кардиолог",
+  "description": "Кардиолог, кандидат медицинских наук. Диагностика и лечение артериальной гипертензии, ИБС, нарушений ритма.",
+  "url": "https://example.org/vrachi/ivanov-ivan/",
+  "image": "https://example.org/upload/vrachi/ivanov-ivan.jpg",
+  "telephone": "+7-495-000-00-01",
+  "medicalSpecialty": "https://schema.org/Cardiovascular",
+  "availableService": [
+    {
+      "@type": "MedicalProcedure",
+      "name": "Электрокардиография (ЭКГ)"
+    },
+    {
+      "@type": "MedicalProcedure",
+      "name": "Эхокардиография"
+    },
+    {
+      "@type": "MedicalProcedure",
+      "name": "Холтеровское мониторирование ЭКГ"
+    }
+  ],
+  "worksFor": {
+    "@id": "https://example.org/#organization"
+  },
+  "hospitalAffiliation": {
+    "@id": "https://example.org/#organization"
+  },
+  "alumniOf": {
+    "@type": "CollegeOrUniversity",
+    "name": "Российский национальный исследовательский медицинский университет им. Н. И. Пирогова"
+  },
+  "memberOf": {
+    "@type": "Organization",
+    "name": "Российское кардиологическое общество"
+  },
+  "knowsAbout": [
+    "Артериальная гипертензия",
+    "Ишемическая болезнь сердца",
+    "Нарушения ритма сердца"
+  ],
+  "isAcceptingNewPatients": true
+}

package/skills/seo/assets/snippets/meta.blade.php

@@ -0,0 +1,61 @@
+{{--
+  SEO-мета для Laravel/Blade — компонент <x-seo.meta :seo="$seo" />
+  Использование:
+    $seo = \App\Support\Seo\Seo::page(
+        title: 'МРТ головного мозга в организация — цена от 4 500 ₽',
+        description: 'МРТ головы на аппарате 1.5 Тл: расшифровка врачом, результат в день исследования. Запись онлайн.',
+        path: '/uslugi/mrt-golovy/',
+    )->breadcrumbs([...])->addJsonLd([...]);
+
+    В шаблоне: <x-seo.meta :seo="$seo" />
+
+  Требует: config/seo.php (org_name, org_phone, addr_*, same_as, default_title,
+  default_description, default_og_image, canonical_host).
+  ВАЖНО: JSON-LD выводится с JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES | JSON_HEX_TAG | JSON_HEX_AMP.
+--}}
+@props(['seo' => null])
+
+@php
+    $seo = $seo ?? \App\Support\Seo\Seo::page(
+        config('seo.default_title'),
+        config('seo.default_description')
+    );
+    $data = is_array($seo) ? $seo : $seo->toArray();
+
+    $title       = $data['title'] ?? config('seo.default_title');
+    $description = $data['description'] ?? config('seo.default_description');
+    $canonical   = $data['canonical'] ?? url()->current();
+    $robots      = $data['robots'] ?? 'index,follow';
+    $type        = $data['type'] ?? 'website';
+    $ogImage     = $data['ogImage'] ?? config('seo.default_og_image');
+    $jsonLd      = array_values(array_filter($data['jsonLd'] ?? []));
+    $orgName     = config('seo.org_name');
+@endphp
+
+<title>{{ $title }}</title>
+<meta name="description" content="{{ $description }}">
+<meta name="robots" content="{{ $robots }}">
+<link rel="canonical" href="{{ $canonical }}">
+
+{{-- Open Graph: Telegram/WhatsApp/VK/соцсети --}}
+<meta property="og:type" content="{{ $type }}">
+<meta property="og:site_name" content="{{ $orgName }}">
+<meta property="og:locale" content="ru_RU">
+<meta property="og:title" content="{{ $title }}">
+<meta property="og:description" content="{{ $description }}">
+<meta property="og:url" content="{{ $canonical }}">
+<meta property="og:image" content="{{ $ogImage }}">
+<meta property="og:image:width" content="1200">
+<meta property="og:image:height" content="630">
+<meta property="og:image:alt" content="{{ $data['ogImageAlt'] ?? $title }}">
+
+{{-- Twitter/X карточка --}}
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:title" content="{{ $title }}">
+<meta name="twitter:description" content="{{ $description }}">
+<meta name="twitter:image" content="{{ $ogImage }}">
+
+{{-- Структурированные данные --}}
+@foreach ($jsonLd as $node)
+    <script type="application/ld+json">{!! json_encode($node, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES | JSON_HEX_TAG | JSON_HEX_AMP) !!}</script>
+@endforeach

package/skills/seo/assets/snippets/robots.txt

@@ -0,0 +1,61 @@
+# robots.txt — пример для example.org (1С-Битрикс + Aspro «Медицинский центр 3.0»)
+# В Битриксе файл генерируется модулем «Поисковая оптимизация» (seo):
+#   Настройки → Настройки продукта → Настройки модулей → Поисковая оптимизация → robots.txt
+# Этот файл — эталон для проверки результата. НЕ кладите его в корень поверх автогенерации,
+# если авторежим включён. Проверка живого файла: https://example.org/robots.txt
+#
+# ПРИНЦИПЫ:
+#  - Закрываем только служебное: /bitrix/ (кроме нужных подпапок), /local/, /search/, /auth/, /personal/.
+#  - НЕ закрываем CSS/JS/картинки/шрифты — иначе робот не отрисует страницу.
+#  - НЕ закрываем услуги/врачей/статьи/цены — они должны ранжироваться.
+#  - UTM/сортировки/печать режем параметрами: Clean-param (Яндекс) + Disallow на параметры (Google).
+#  - Директиву Host Яндекс не использует с 2018 года — не пишите её.
+#  - Google игнорирует Crawl-delay и Clean-param; Яндекс понимает Clean-param.
+
+User-agent: *
+Disallow: /bitrix/
+Disallow: /local/
+Disallow: /search/
+Disallow: /auth/
+Disallow: /personal/
+Disallow: /login/
+Disallow: /*?sort=
+Disallow: /*?print=
+Disallow: /*?format=
+Disallow: /*?view=
+Disallow: /*?utm_
+Disallow: /*?from=
+Disallow: /*?callback=
+Disallow: /*?clear_cache=
+
+# Обход должен видеть шаблон, стили и скрипты — иначе рендеринг и Core Web Vitals страдают
+Allow: /bitrix/js/
+Allow: /bitrix/css/
+Allow: /bitrix/templates/
+Allow: /bitrix/components/
+Allow: /local/templates/
+Allow: /upload/
+
+# Яндекс: не индексировать URL с этими параметрами (UTM, сортировки, пагинация-дубли)
+Clean-param: utm_source&utm_medium&utm_campaign&utm_content&utm_term&yclid&gclid&from&sort&print / 
+
+# Опционально: закрыть служебные боты Яндекса от мусорных разделов
+User-agent: Yandex
+Disallow: /bitrix/
+Disallow: /local/
+Disallow: /search/
+Disallow: /auth/
+Disallow: /personal/
+Disallow: /*?sort=
+Clean-param: utm_source&utm_medium&utm_campaign&utm_content&utm_term&yclid&gclid / 
+
+Sitemap: https://example.org/sitemap.xml
+
+# ---------------------------------------------------------------
+# ЧАСТЫЕ ОШИБКИ:
+#  1) Disallow: /  — копия с тестового домена попала в прод (проверяй после каждого деплоя).
+#  2) Disallow: /*?*  — закрывает всё с параметрами, включая важные страницы; лучше точечно.
+#  3) Disallow: /bitrix/ без Allow для js/css — робот не видит оформление.
+#  4) Закрытие страницы в robots + noindex на ней — противоречие: страница не выйдет из индекса.
+#  5) Sitemap с http:// или с www — не тот протокол/хост, чем канонический.
+# ---------------------------------------------------------------

package/skills/seo/assets/snippets/sitemap-urlset-example.xml

@@ -0,0 +1,72 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  ПРИМЕР urlset (один файл карты) для example.org.
+  Только indexable URL: 200, без noindex, без редиректов.
+  <lastmod> — дата реального изменения контента (ISO 8601 / W3C).
+  <changefreq> и <priority> — подсказки; Google их игнорирует, Яндекс учитывает слабо.
+  Не ставь priority=1.0 всем страницам: это шум.
+  НЕ добавляй: страницы пагинации?page=N (кроме нужных), фильтры, /search/, UTM-копии,
+  служебные разделы, страницы «спасибо» и личный кабинет.
+-->
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+  <url>
+    <loc>https://example.org/</loc>
+    <lastmod>2026-11-01</lastmod>
+    <priority>1.0</priority>
+  </url>
+  <url>
+    <loc>https://example.org/napravleniya/</loc>
+    <lastmod>2026-10-30</lastmod>
+    <priority>0.9</priority>
+  </url>
+  <url>
+    <loc>https://example.org/napravleniya/kardiologiya/</loc>
+    <lastmod>2026-10-28</lastmod>
+    <priority>0.8</priority>
+  </url>
+  <url>
+    <loc>https://example.org/uslugi/</loc>
+    <lastmod>2026-10-30</lastmod>
+    <priority>0.9</priority>
+  </url>
+  <url>
+    <loc>https://example.org/uslugi/mrt-golovy/</loc>
+    <lastmod>2026-10-20</lastmod>
+    <priority>0.8</priority>
+  </url>
+  <url>
+    <loc>https://example.org/uslugi/mrt/</loc>
+    <lastmod>2026-10-20</lastmod>
+    <priority>0.7</priority>
+  </url>
+  <url>
+    <loc>https://example.org/vrachi/</loc>
+    <lastmod>2026-10-28</lastmod>
+    <priority>0.8</priority>
+  </url>
+  <url>
+    <loc>https://example.org/vrachi/ivanov-ivan/</loc>
+    <lastmod>2026-09-12</lastmod>
+    <priority>0.7</priority>
+  </url>
+  <url>
+    <loc>https://example.org/blog/</loc>
+    <lastmod>2026-10-15</lastmod>
+    <priority>0.7</priority>
+  </url>
+  <url>
+    <loc>https://example.org/blog/vysokoe-davlenie/</loc>
+    <lastmod>2026-10-18</lastmod>
+    <priority>0.6</priority>
+  </url>
+  <url>
+    <loc>https://example.org/novosti/den-otkrytyh-dverey-2026-04-12/</loc>
+    <lastmod>2026-04-12</lastmod>
+    <priority>0.5</priority>
+  </url>
+  <url>
+    <loc>https://example.org/kontakty/</loc>
+    <lastmod>2026-10-01</lastmod>
+    <priority>0.6</priority>
+  </url>
+</urlset>

package/skills/seo/assets/snippets/sitemap.xml

@@ -0,0 +1,36 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  ПРИМЕР sitemap-индекса для example.org (большой сайт: услуги/врачи/статьи/новости отдельно).
+  Если сайт небольшой (<50 000 URL) — можно один urlset без индекса:
+  см. sitemap-urlset-example.xml.
+  Требования:
+    • только URL с ответом 200 и без noindex;
+    • lastmod — реальная дата изменения (не «сегодня» у всех);
+    • ≤50 000 URL и ≤50 МБ на файл;
+    • карта должна быть доступна по https://example.org/sitemap.xml и указана в robots.txt;
+    • отправить в GSC и Яндекс Вебмастер.
+  В Битриксе генерируется модулем «Поисковая оптимизация» (Настройки модулей → sitemap.xml);
+  этот файл — эталон структуры, а не для ручной заливки поверх автогенерации.
+-->
+<sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+  <sitemap>
+    <loc>https://example.org/sitemap-pages.xml</loc>
+    <lastmod>2026-10-20</lastmod>
+  </sitemap>
+  <sitemap>
+    <loc>https://example.org/sitemap-uslugi.xml</loc>
+    <lastmod>2026-11-01</lastmod>
+  </sitemap>
+  <sitemap>
+    <loc>https://example.org/sitemap-vrachi.xml</loc>
+    <lastmod>2026-10-28</lastmod>
+  </sitemap>
+  <sitemap>
+    <loc>https://example.org/sitemap-blog.xml</loc>
+    <lastmod>2026-10-15</lastmod>
+  </sitemap>
+  <sitemap>
+    <loc>https://example.org/sitemap-news.xml</loc>
+    <lastmod>2026-11-03</lastmod>
+  </sitemap>
+</sitemapindex>