dsh-desktop-kit 1.0.0 → 2.0.0

package/skills/seo/references/page-templates.md

@@ -0,0 +1,56 @@
+> Часть навыка seo. ≈2 250 токенов. Читать, когда: пишешь title/description, проектируешь новую страницу или решаешь, что ставить в JSON-LD/robots/sitemap для конкретного типа страницы.
+
+# Шаблоны по типам страниц: мета, разметка, индексация
+
+> Готовые решения «по умолчанию»: не изобретай title и разметку заново для каждой страницы.
+> Правила самих элементов — `on-page.md`; шаблоны JSON-LD — `structured-data.md`. Проверено 04.11.2026.
+
+## 1. Матрица по типу страницы
+
+| Тип страницы | `title` (шаблон) | JSON-LD | `robots` | sitemap | priority |
+|---|---|---|---|---|---|
+| Главная | `{Клиника} — официальный сайт | {город}` | Organization+WebSite+MedicalClinic | index,follow | да | 1.0 |
+| Направление | `{Направление} в {Клиника}, {город} — врачи, цены, запись` | MedicalWebPage+BreadcrumbList+Service | index,follow | да | 0.8 |
+| Услуга | `{Услуга} в {Клиника} — цена от {X} ₽, запись онлайн` | MedicalProcedure/Service+FAQ+Breadcrumb | index,follow | да | 0.8 |
+| Врач | `{ФИО} — {специальность}, {Клиника}, {город}` | Physician+Person+Breadcrumb | index,follow | да | 0.7 |
+| Статья/блог | `{Вопрос/тема}: {уточнение} — {Клиника}` | Article/MedicalWebPage+FAQ+Breadcrumb | index,follow | да | 0.6 |
+| Новость | `{Событие} — {дата} | {Клиника}` | NewsArticle/Article | index,follow | да | 0.5 |
+| Цены | `Цены на {раздел} в {Клиника}, {город} — {год}` | MedicalWebPage+Offer (осторожно) | index,follow | да | 0.7 |
+| Контакты | `Контакты {Клиника} — адрес, телефон, схема проезда` | MedicalClinic+Organization | index,follow | да | 0.6 |
+| Документы/лицензии | `Лицензии и документы {Клиника} — {город}` | MedicalOrganization | index,follow | да | 0.4 |
+| Спасибо / личный кабинет | `{...}` | — | `noindex,follow` | нет | — |
+| Поиск / фильтры / мусорные фасеты | — | — | `noindex,follow` или robots+`Clean-param` | нет | — |
+| 404 / 410 | `Страница не найдена` | — | `noindex` | нет | — |
+
+Оговорки:
+- **`priority` и `changefreq` — подсказка**, а не рычаг: Google их игнорирует, Яндекс учитывает слабо. Ставь для
+  порядка в карте, не «оптимизируй» ими (`technical-seo.md` §4).
+- «Цены» с `Offer` — только если цены публичные, актуальные и совпадают с прайсом на странице.
+- «Документы/лицензии» — страница доверия: номер, дата, орган выдачи, ссылка на реестр Росздравнадзора
+  (`eeat-medical.md` §3).
+- Один кластер = одна страница: если под один интент уже есть страница, не создавай вторую (каннибализация).
+- Тип страницы определяет блоки контента: услуга/направление/статья — `content-seo.md` §4–5.
+
+## 2. Шаблоны `title` / `description` (RU, медицина)
+
+Правило: **что + где + выгода/факт + бренд** (не обязательно все, но первые два — всегда).
+`|` и бренд — не в начало. «Официальный сайт» — только если это действительно официальный сайт организации.
+
+| Тип | `title` | `description` |
+|---|---|---|
+| Главная | `организация, Москва — официальный сайт больницы` | `Многопрофильная больница в Москве: консультации врачей, диагностика, стационар. Запись по телефону и онлайн. Адрес и схема проезда.` |
+| Направление | `Кардиология в организация, Москва — врачи, диагностика, запись` | `Кардиологическое отделение: ЭКГ, ЭхоКГ, холтер, консультации кардиолога. Опытные врачи, современное оборудование. Запись онлайн.` |
+| Услуга | `МРТ головного мозга в Москве — цена от 4 500 ₽, запись в организация` | `МРТ головы на аппарате 1.5 Тл: расшифровка врачом, результат в день исследования. Цена от 4 500 ₽, запись онлайн и по телефону.` |
+| Врач | `Иванов Иван Иванович — кардиолог, организация, Москва` | `Кардиолог с 18-летним стажем: диагностика и лечение гипертонии, ИБС, аритмий. Кандидат медицинских наук. Запись на приём.` |
+| Статья | `Высокое давление: причины, симптомы и когда идти к врачу` | `Почему повышается давление, какие симптомы опасны, как измерять дома и когда нужен кардиолог. Разбор врача организация.` |
+| Новость | `День открытых дверей в организация — 12 апреля 2026` | `12 апреля 2026: бесплатная проверка сердца, консультации кардиолога и эндокринолога. Программа, запись, адрес.` |
+
+## 3. Чего избегать в `title` / `description`
+
+- `Купить, дёшево, в Москве недорого` для государственной клиники — конфликт с реальностью и YMYL-доверием.
+- Пунктуация-мусор `!!!`, эмодзи, слова «лучший», «№1» без доказательств.
+- Обрезанные фразы и «…» вручную — Google/Яндекс обрежут сами по ширине.
+- Дубли: один и тот же шаблон на сотнях страниц = дубли и потеря релевантности (`technical-seo.md` §6).
+- `description` «Читайте на сайте», набор ключей без пользы, обещания результата лечения.
+
+Детали и примеры «плохо → хорошо»: `on-page.md` §1–2, §13.

package/skills/seo/references/stack-recipes.md

@@ -1,3 +1,5 @@
+> Часть навыка seo. ≈10 100 токенов. Читать, когда: пишешь SEO в коде — Laravel/Blade, Bitrix/Aspro, React/Vite, статика; один источник SEO-данных, мета и JSON-LD в исходном HTML, сервер/деплой.
+
 # Стек-рецепты: Laravel/Blade, Bitrix/Aspro, React/Vite, статика
 
 > Готовые паттерны, чтобы SEO-по-умолчанию не превращалось в ручную работу. Всё написано так, чтобы

package/skills/seo/references/structured-data.md

@@ -1,3 +1,5 @@
+> Часть навыка seo. ≈8 700 токенов. Читать, когда: добавляешь JSON-LD — шаблоны Organization, BreadcrumbList, MedicalWebPage, Physician, MedicalClinic, Service, FAQPage, Article; что не размечать; валидация.
+
 # Структурированные данные (JSON-LD) — шаблоны и правила
 
 > Разметка помогает поисковикам и ИИ-системам **понять сущности** страницы: кто вы, где вы, какие услуги, кто врач,

package/skills/seo/references/technical-seo.md

@@ -1,3 +1,5 @@
+> Часть навыка seo. ≈8 050 токенов. Читать, когда: техническая правка или просадка трафика — статусы, robots, sitemap, canonical, пагинация, фасеты, hreflang, CWV, JS/SPA, миграции URL.
+
 # Техническое SEO — краулинг, индексация, URL, скорость
 
 > Справочник по технической части. Всё, что здесь есть, проверяется **в коде и в инструментах**, а не «на глаз».

package/skills/service-desk-conventions/SKILL.md

@@ -1,40 +1,52 @@
 ---
 name: service-desk-conventions
-description: "Соглашения и инварианты проекта Service Desk организация — где что лежит, как устроены модули, темы и RBAC, что нельзя ломать."
-whenToUse: "Любая задача по проекту Service Desk (заявки, активы, склад, отчёты, справочник, AD/LDAP, UI) — читать перед правками."
+description: "Инварианты Service Desk: где что лежит, модули, маршруты и RBAC, темы, миграции и формы — что нельзя ломать перед правками."
+whenToUse: "Любая задача по Service Desk (заявки, активы, склад, отчёты, справочник, AD/LDAP, UI) — читать до правок."
 user-invocable: true
 ---
 
-# Service Desk организация — соглашения проекта
+# Service Desk — соглашения проекта
 
-## Где что
+## 0. Когда применять
+- Задачи по Service Desk: заявки, активы, склад, отчёты, справочник, AD/LDAP, UI.
+- Перед правками модулей, маршрутов, RBAC, тем, миграций.
+- Нужно понять, куда положить код.
+
+## 1. Главное
+
+**Где что**
 - Рабочая копия (1.39.0): `%USERPROFILE%\OneDrive\Документы\deepseek-harness\default-workspace\src\service-desk-1.38.1`
-- Досье проекта: `%USERPROFILE%\.dsh\memory\projects\service-desk.md`
-- Приватный архив (аудит/тесты/релизы/скриншоты): `%USERPROFILE%\.dsh\memory\projects\service-desk\`
-- Реальный сервер: `app-server`, `/var/www/service-desk`, PostgreSQL `servicedesk`, сайт `http://127.0.0.1:8000`.
+- Досье: `%USERPROFILE%\.dsh\memory\projects\service-desk.md`; архив: `%USERPROFILE%\.dsh\memory\projects\service-desk\` (аудит/тесты/релизы).
+- Сервер: `app-server`, `/var/www/service-desk`, PostgreSQL `servicedesk`, сайт `http://127.0.0.1:8000`.
 
-## Архитектура (коротко)
+**Архитектура**
 - Laravel 13 / PHP 8.5 / PostgreSQL / Blade + Vite + SCSS.
-- Модули: `modules/{Tickets,Assets,Inventory,Reports,DirectorySync}`; регистрация — явно `config/modules.php` → `app/Providers/ModuleServiceProvider.php`; провайдер = `loadViewsFrom` + `loadMigrationsFrom` + `Route::middleware('web')->group(routes/web.php)`.
-- Маршруты модулей **без `auth`** — только `permission:*`; добавляя маршрут, ставь `auth` (или осознанно) и `permission:*`; не переименовывай route names.
-- RBAC: `CheckPermission` (`permission:`), `EnsureAdmin` (`admin`), `RoleGate` (ALLOWED/DENIED по именам). Админ-роль `admin` даёт все права.
-- Темы: каркас `themes/default/views/layouts/app.blade.php` (один на все палитры); страницы — `themes/default/views/*`, `resources/views`, `modules/*/resources/views` (namespace `tickets::` и т.п.).
-- UI-стили: `resources/scss/app.scss` → `_tokens.scss`, `_ui-refresh.scss` (новые правила сюда), `_legacy.scss` (только база).
+- Модули `modules/{Tickets,Assets,Inventory,Reports,DirectorySync}`; регистрация — `config/modules.php` → `app/Providers/ModuleServiceProvider.php`; провайдер: `loadViewsFrom` + `loadMigrationsFrom` + `Route::middleware('web')->group(routes/web.php)`.
+- Маршруты модулей **без `auth`** — только `permission:*`; новый маршрут — с `auth` (или осознанно) и `permission:*`; route names не переименовывать.
+- RBAC: `CheckPermission` (`permission:`), `EnsureAdmin` (`admin`), `RoleGate` (ALLOWED/DENIED по именам); роль `admin` даёт все права.
+- Темы: каркас `themes/default/views/layouts/app.blade.php` (один на все палитры); страницы — `themes/default/views/*`, `resources/views`, `modules/*/resources/views` (namespace `tickets::`).
+- Стили: `resources/scss/app.scss` → `_tokens.scss`, `_ui-refresh.scss` (новые правила), `_legacy.scss` (только база).
 - Аудит: `AuditObserver` (Ticket/Asset/Consumable/StockMove/Reminder/News) → `audit_logs`.
 
-## Нельзя ломать
-- Миграции — только новые, аддитивные; не редактировать старые.
+**Нельзя ломать**
+- Миграции — только новые и аддитивные; старые не редактировать.
 - `db:seed` в 1.39.1 идемпотентен — не переделывать на updateOrCreate/сброс паролей.
-- Формы: не убирать `name`-атрибуты, `required` и подписи под полями (на них тесты `FormHintsTest`, `TicketFormVisibilityTest`).
-- `@html` (HtmlSanitizer) — единственный безопасный вывод размеченного текста; не использовать `{!! !!}` для пользовательских данных.
-- Права/владельцы: не менять логику доступа без теста на обычного пользователя и админа.
-- Скрытые разделы: `MODULES_HIDDEN` (config `modules.hidden`), `Modules::visible()`.
-
-## Стиль кода
-- Русский язык комментариев/интерфейса; PHP PSR-12 (Laravel Pint), 4 пробела.
-- Транзакции для многозаписных операций, `lockForUpdate()` при гонках, валидация входящих данных.
-- После доработки — bump версии в `config/app.php` (feature → minor, fix → patch) по правилам из досье.
-
-## Полезное
-- Тесты: `php scripts/test.php` (из корня проекта), либо `make test` (Linux).
-- Стандарты правок и релиза: скиллы `service-desk-db-safety`, `service-desk-testing`, `service-desk-release`, `service-desk-ui`.
+- Формы: не убирать `name`, `required` и подписи (тесты `FormHintsTest`, `TicketFormVisibilityTest`).
+- `@html` (HtmlSanitizer) — единственный безопасный вывод разметки; не `{!! !!}` для пользовательских данных.
+- Права/владельцы: не менять доступ без теста на обычного пользователя и админа.
+- Скрытые разделы: `MODULES_HIDDEN` (`config modules.hidden`), `Modules::visible()`.
+
+**Стиль**
+- Русский язык комментариев/интерфейса; PSR-12 (Laravel Pint), 4 пробела.
+- Транзакции для многозаписных операций, `lockForUpdate()` при гонках, валидация.
+- После доработки — bump версии в `config/app.php`: feature → minor, fix → patch.
+
+## 2. Куда грузить дальше
+`service-desk-db-safety` — БД/бэкап; `service-desk-testing` — PHPUnit/Playwright; `service-desk-release` — tgz/`update.sh`; `service-desk-ui` — вёрстка/темы. Тесты: `php scripts/test.php` (Linux `make test`).
+
+## 3. Гейт перед сдачей
+- [ ] Досье и `AGENTS.md` прочитаны; правки локальны.
+- [ ] Старые миграции не тронуты, новые аддитивны.
+- [ ] Маршруты: `auth` + `permission:*`; route names целы.
+- [ ] Формы, `@html`, RBAC целы; проверены пользователь и админ.
+- [ ] `php scripts/test.php` зелёный; версия в `config/app.php` поднята.

package/skills/service-desk-db-safety/SKILL.md

@@ -1,33 +1,36 @@
 ---
 name: service-desk-db-safety
-description: "Безопасная работа с PostgreSQL проекта Service Desk — бэкапы, восстановление, запрещённые команды, имитация обновления на копии."
-whenToUse: "Перед любыми миграциями, сидами, загрузкой данных, релизом или действиями, которые могут изменить или удалить данные БД."
+description: "PostgreSQL Service Desk: бэкап и проверка копии, запрещённые команды, восстановление, миграции — без потери данных."
+whenToUse: "Перед миграциями, сидами, загрузкой данных, релизом или любым действием, которое может изменить/удалить данные БД."
 user-invocable: true
 ---
 
 # PostgreSQL: безопасность данных (Service Desk)
 
-## Железные правила
-- Боевая БД — PostgreSQL на сервере `app-server` (`servicedesk`). Локальный кластер — только тестовый.
-- **НИКОГДА** без прямого разрешения пользователя:
-  - `migrate:fresh|refresh|reset`, `db:wipe`, `db:seed` на боевой БД, `migrate:rollback`, `dropdb`;
-  - `TRUNCATE` для `phonebook_entries` (каскад на `users` и связанные таблицы!);
-  - `composer run preview:reset` (при отсутствии `.env.preview` берёт боевой `.env` → `migrate:fresh` на проде);
-  - `clear-tickets.sh` / `tickets:purge` (удаляет все заявки и вложения).
-- Перед рискованным: бэкап + проверка окружения.
-- Никогда не подключаться к боевой БД с локальных экспериментов.
-
-## Бэкап (на сервере)
+## 0. Когда применять
+- Миграции, сиды, загрузка справочника/данных, релиз с изменениями схемы.
+- Восстановление и очистка заявок.
+- Любая запись/удаление на сервере.
+
+## 1. Главное
+
+**Железные правила**
+- Боевая БД — PostgreSQL на `app-server` (`servicedesk`); локальный кластер — только тестовый.
+- **Никогда** без прямого разрешения: `migrate:fresh|refresh|reset`, `db:wipe`, `db:seed` на боевой, `migrate:rollback`, `dropdb`, `TRUNCATE` `phonebook_entries` (каскад на `users` и связанные!), `composer run preview:reset` (без `.env.preview` берёт боевой `.env` → `migrate:fresh`), `clear-tickets.sh`/`tickets:purge` (удаляет все заявки и вложения).
+- Перед рискованным — бэкап и проверка окружения; никогда не подключаться к боевой БД с локальных экспериментов.
+
+**Бэкап (на сервере)**
 ```bash
 sudo -u den php artisan backup:run --reason="before-<что>"
 sudo -u postgres pg_dump -Fc -d servicedesk -f /var/backups/service-desk/pre-<версия>.dump
 sudo -u postgres pg_restore -l /var/backups/service-desk/pre-<версия>.dump | head
+sudo -u den php artisan backup:verify
 ```
-- `backup:run` кладёт database.dump + env.txt + files.zip в `BACKUP_PATH` (по умолчанию `/var/backups/service-desk`).
-- Копию обязательно скачать себе (WinSCP), не хранить только на том же сервере.
-- Требует `pg_dump` в PATH (на сервере есть; локально Windows — добавить `C:\Program Files\PostgreSQL\18\bin`).
+- `backup:run` кладёт `database.dump`, `env.txt`, `files.zip` в `BACKUP_PATH` (`/var/backups/service-desk`); `backup:verify` проверяет восстановление.
+- Копию скачать себе (WinSCP), не хранить только на сервере.
+- `pg_dump` в PATH (на сервере есть; локально Windows — `C:\Program Files\PostgreSQL\18\bin`).
 
-## Восстановление (только по разрешению)
+**Восстановление (только по разрешению)**
 ```bash
 cd /var/www/service-desk && sudo -u den php artisan down
 sudo -u postgres dropdb servicedesk && sudo -u postgres createdb servicedesk
@@ -35,18 +38,26 @@ sudo -u postgres pg_restore --no-owner --role=postgres -d servicedesk <dump>
 sudo -u den php artisan migrate --force && sudo -u den php artisan optimize:clear
 sudo -u den php artisan up
 ```
-`dropdb` — только после подтверждения и при наличии проверенного дампа.
+`dropdb` — только после подтверждения и проверенного дампа.
 
-## Локальная проверка (безопасно)
-- Локальный кластер: PostgreSQL 18, данные `...\default-workspace\pgruntime\data` (ICU locale ru-RU, порт 5432); БД `servicedesk` (dev) и `servicedesk_test` (PHPUnit, RefreshDatabase).
-- Имитация обновления: развернуть старую версию в отдельной папке/БД, засеять данные, снять контрольные суммы, наложить новый код, `migrate --force`, сверить counts/md5 — см. скилл `pg-upgrade-verify`.
-- В тестах `RefreshDatabase` работает только на `servicedesk_test`, не на прод.
+**Локальная проверка**
+- Кластер PG 18: `...\default-workspace\pgruntime\data` (ICU ru-RU, 5432); БД `servicedesk` (dev), `servicedesk_test` (PHPUnit, RefreshDatabase — только на тестовой).
+- Имитация обновления — по `pg-upgrade-verify`: отдельная папка/БД, counts/md5 до и после.
 
-## Перед релизом с миграциями
-1. Сравнить списки миграций старой и новой версии; прочитать новые: нет ли `dropColumn`, изменения NOT NULL, переименований.
-2. Прогнать `php artisan migrate --pretend` (на копии!) и посмотреть SQL.
-3. Сделать бэкап, только потом `migrate --force`.
+**Перед релизом с миграциями**
+1. Сравнить списки миграций; прочитать новые: `dropColumn`, NOT NULL, переименования.
+2. `migrate --pretend` на копии и посмотреть SQL.
+3. Бэкап — только потом `migrate --force`.
 
-## Признаки проблемы
+**Сбой**
 - Сайт в maintenance → `sudo -u den php artisan up`.
-- Ошибки БД → `storage/logs/laravel.log`, `journalctl -u service-desk-queue`, не спешить с откатом/восстановлением.
+- Ошибки БД → `storage/logs/laravel.log`, `journalctl -u service-desk-queue`; не спешить с откатом/восстановлением.
+
+## 2. Куда грузить дальше
+`pg-upgrade-verify` — копия; `service-desk-release` — выкатка.
+
+## 3. Гейт перед сдачей
+- [ ] Окружение проверено, боевая БД не затронута.
+- [ ] Свежий бэкап создан, читается (`pg_restore -l` / `backup:verify`), копия вне сервера.
+- [ ] Запрещённые команды не выполнялись без разрешения.
+- [ ] Новые миграции аддитивны и прогнаны на копии; план отката есть.

package/skills/service-desk-release/SKILL.md

@@ -1,43 +1,61 @@
 ---
 name: service-desk-release
-description: "Выпуск и выкатка обновления Service Desk — версия, сборка tgz, checksums, deploy/update.sh, проверки и откат."
-whenToUse: "При подготовке любого обновления или релиза и при выкатке на сервер app-server."
+description: "Релиз Service Desk: версия в config/app.php, tgz без мусора, SHA-256, deploy/update.sh, smoke после выкатки и откат."
+whenToUse: "При подготовке обновления, сборке архива, выкатке на app-server, проверке после релиза и откате."
 user-invocable: true
 ---
 
 # Релиз Service Desk (tgz + update.sh)
 
-## Правила версии
-- Версия по умолчанию — `config/app.php`: `env('APP_VERSION', 'X.Y.Z')`.
-- feature → minor (1.39.0 → 1.40.0), fix → patch (1.39.0 → 1.39.1), breaking → major.
-- При обновлении `deploy-ubuntu.sh` берёт RELEASE из `config/app.php` и записывает в `.env`.
+## 0. Когда применять
+- Готовишь обновление Service Desk: версия, сборка, checksums.
+- Выкатываешь на `app-server` или нужен план отката.
+- В релизе есть миграции — сначала `service-desk-db-safety` и `pg-upgrade-verify`.
 
-## Сборка архива (как Claude Code)
-1. Правки проверены: `php scripts/test.php` зелёный, UI-скриншоты сделаны.
+## 1. Главное
+
+**Версия**
+- `config/app.php`: `env('APP_VERSION', 'X.Y.Z')`. feature → minor (1.39.0 → 1.40.0), fix → patch (1.39.0 → 1.39.1), breaking → major.
+- `deploy-ubuntu.sh` берёт RELEASE из `config/app.php` и записывает в `.env`; версия видна внизу меню.
+- Версия, тег и имя архива совпадают; версия поднята **до** сборки.
+
+**Сборка**
+1. `php scripts/test.php` зелёный, UI-скриншоты сделаны.
 2. Собрать tgz **без** `vendor/ node_modules/ public/build/ storage/ .env .env.preview .git .claude`.
-3. Надёжный способ: распаковать эталонную предыдущую версию в staging, наложить изменённые файлы, `tar -czf`.
-4. Посчитать sha256, записать в `checksums.txt`; файл положить на Рабочий стол.
+3. Надёжно: распаковать предыдущую версию в staging, наложить изменённые файлы, `tar -czf`.
+4. `sha256sum` → `checksums.txt`; архив и checksums — на Рабочий стол.
+5. Проверить листинг: нет секретов/мусора, все изменённые файлы на месте.
 
-## Выкатка (сервер app-server, пользователь den)
+**Выкатка (сервер `app-server`, пользователь `den`)**
 ```bash
-cd /tmp && sha256sum service-desk-X.Y.Z.tgz       # сверить с локальным
+cd /tmp && sha256sum service-desk-X.Y.Z.tgz     # сверить с локальным
 sudo tar --no-same-owner -xzf /tmp/service-desk-X.Y.Z.tgz -C /var/www/service-desk
 cd /var/www/service-desk && sudo APP_ADDR=127.0.0.1 bash deploy/update.sh
 ```
-`update.sh` сам: backup → maintenance → composer/npm/build → migrate → seed (идемпотентен) → services/caches → up.
+`update.sh` сам: backup → maintenance → composer/npm/build → migrate → seed (идемпотентен) → services/caches → up. При сбое сайт остаётся в maintenance — исправить и `php artisan up`.
 
-## Проверки после «Готово»
+**Проверки после «Готово»**
 1. Ctrl+F5 → версия внизу меню = X.Y.Z.
 2. Число заявок прежнее, старые номера/вложения открываются.
 3. Затронутый раздел/фича работает (сценарий из задачи).
 4. Админ и обычный пользователь — оба сценария.
-5. При желании: `sudo -u den php artisan launch:check`.
+5. `php artisan migrate:status`, логи без ошибок; при желании `sudo -u den php artisan launch:check`.
+
+**Откат**
+- Код: папка `Task.old-<дата>` (если копировали) или предыдущий архив; распаковать, вернуть версию.
+- БД: только если релиз менял данные/схему (см. `service-desk-db-safety`); обычно не нужно.
+- `sudo -u den php artisan up`, повторить smoke.
+
+**Журнал**
+- Записать факт выкатки и проверки в `%USERPROFILE%\.dsh\memory\SESSIONS.md` и досье.
+- Пример структуры — `...\memory\projects\service-desk\release\UPDATE-1.39.0.md`.
 
-## Откат
-- Код: вернуть папку `Task.old-<дата>` (если делали копию до обновления) или распаковать предыдущий архив.
-- БД: восстанавливать только если релиз менял данные/схему (см. `service-desk-db-safety`); обычно не нужно.
-- Снять maintenance: `sudo -u den php artisan up`.
+## 2. Куда грузить дальше
+`service-desk-db-safety` — бэкап/восстановление; `pg-upgrade-verify` — миграции на копии; `release-and-deploy` — общие правила; `git-and-ci` — тег.
 
-## Журнал
-- Записать факт выкатки и проверки в `%USERPROFILE%\.dsh\memory\SESSIONS.md` + досье проекта.
-- Структуру/команды и пример — `...\memory\projects\service-desk\release\UPDATE-1.39.0.md`.
+## 3. Гейт перед сдачей
+- [ ] Версия поднята в `config/app.php`; тег и архив совпадают.
+- [ ] Тесты зелёные, скриншоты сделаны; архив без секретов/мусора.
+- [ ] sha256 локально и на сервере совпал; бэкап перед выкаткой есть.
+- [ ] `update.sh` прошёл; версия, заявки/вложения, фича, админ + пользователь проверены.
+- [ ] Логи и `migrate:status` чистые; откат описан; запись в память сделана.

package/skills/service-desk-testing/SKILL.md

@@ -1,47 +1,61 @@
 ---
 name: service-desk-testing
-description: "Как тестировать Service Desk — PHPUnit на PostgreSQL, baseline, известные особенности, Playwright E2E и визуальные проверки."
-whenToUse: "При любой правке кода или UI проекта — до и после изменений; при подготовке релиза."
+description: "Тесты Service Desk: PHPUnit на PostgreSQL, baseline, права и формы, Playwright E2E, скриншоты, Pint и PHPStan."
+whenToUse: "Перед и после любой правки кода/UI Service Desk, при подготовке релиза и при разборе упавших тестов."
 user-invocable: true
 ---
 
 # Тестирование Service Desk
 
-## Рабочая копия
-`%USERPROFILE%\OneDrive\Документы\deepseek-harness\default-workspace\src\service-desk-1.38.1`
+## 0. Когда применять
+- Любая правка кода/UI: сначала baseline, после — сравнение.
+- Нужны feature/unit-тесты, проверка прав или форм.
+- Подготовка релиза, E2E или визуальная проверка.
 
-## PHPUnit на PostgreSQL (обязательно)
+## 1. Главное
+
+**PHPUnit на PostgreSQL (обязательно)**
 ```powershell
 # из корня проекта (Windows)
 php scripts/test.php
+php scripts/test.php --filter=TicketFormVisibilityTest
+php scripts/test.php --stop-on-failure
 # Linux/CI
 make test
 ```
-Скрипт поднимает env: `DB_CONNECTION=pgsql DB_HOST=127.0.0.1 DB_PORT=5432 DB_DATABASE=servicedesk_test DB_USERNAME=postgres DB_PASSWORD= APP_URL=http://localhost`.
-- Тесты используют `RefreshDatabase` на **servicedesk_test** — боевую БД не трогают.
-- Локальный кластер PostgreSQL 18: `pgruntime/data` (ICU locale ru-RU — важно для ILIKE кириллицы), порт 5432.
-- Если PG не запущен: `Start-Process "$pgbin\pg_ctl.exe" -ArgumentList @('-D', $data, '-l', $log, 'start') -WindowStyle Hidden`.
-- Baseline (эталон): 542 теста / 2750 assertions — все зелёные (предупреждение PHPUnit deprecation — нормально).
-- Пропуски `markTestSkipped` — только для отсутствующих пользовательских файлов (`docs/requests/*.xlsx`), это норм.
-
-## Что проверять
-1. До правки — зафиксировать baseline (`php scripts/test.php`), после — сравнить.
-2. Новую функциональность покрывать: feature-тест доступов/валидации/сценария + unit для логики.
-3. Права: отдельно проверить админа и обычного пользователя (нельзя открывать служебные поля/разделы).
-4. Данные: форма не должна терять/подменять значения (см. `TicketStrictAccountingTest`).
-
-## E2E/UI (Playwright)
-- Инструменты: `%USERPROFILE%\OneDrive\Документы\deepseek-harness\default-workspace\tools\e2e` (`npx.cmd playwright test`).
-- Стенд: `php artisan serve --port=8125` из рабочей копии (PG dev-БД `servicedesk`); вход `admin@example.com/admin`, `user@example.com/user`.
-- Скриншоты складывать в `...\default-workspace\audit\screenshots\` (desktop 1440 + mobile 390/412, светлая/тёмная темы).
-- Эталонные e2e: `tools\e2e\tests\priority.spec.js` (фича 1.39.0).
-
-## Известные особенности
-- Тесты требуют собранный `public/build` (`@vite` в layout). Пересобрать: `npm run build`.
-- Локальный Windows: `is_writable` мог быть false под старыми политиками — сейчас полный доступ.
-- Не запускай полный набор параллельно с другим прогоном (общая БД `servicedesk_test`).
-- При падении: читать `storage/logs/laravel.log` (в тестах `LOG_CHANNEL=null` в скрипте) и полный вывод PHPUnit.
-
-## Качество
-- `make lint` / `php scripts/lint.php` — Pint по изменённым файлам (vs HEAD);
-- `make stan` / `php scripts/stan.php` — PHPStan/Larastan (baseline для legacy).
+Скрипт поднимает env: `DB_CONNECTION=pgsql DB_HOST=127.0.0.1 DB_PORT=5432 DB_DATABASE=servicedesk_test DB_USERNAME=postgres DB_PASSWORD= APP_URL=http://localhost`; кэш/очередь/сессии/почта — array/sync, `LOG_CHANNEL=null`.
+- `RefreshDatabase` — на **servicedesk_test**, боевую БД не трогает.
+- PG 18: `pgruntime/data` (ICU ru-RU — важно для ILIKE кириллицы), порт 5432. Если не запущен: `Start-Process "$pgbin\pg_ctl.exe" -ArgumentList @('-D', $data, '-l', $log, 'start') -WindowStyle Hidden`.
+- Baseline (эталон): 542 теста / 2753 assertions, все зелёные; deprecation PHPUnit — норма. Пропуски `markTestSkipped` — только для отсутствующих `docs/requests/*.xlsx`.
+
+**Что проверять**
+1. До правки — baseline, после — сравнить; новые падения — блокер.
+2. Новое: feature на доступы/валидацию/сценарий + unit логики.
+3. Права: админ и обычный пользователь; служебные поля/разделы закрыты.
+4. Данные: форма не теряет/не подменяет значения (`TicketStrictAccountingTest`).
+
+**E2E/UI (Playwright)**
+- `...\default-workspace\tools\e2e` → `npx.cmd playwright test`.
+- Стенд: `php artisan serve --port=8125` (PG dev `servicedesk`); вход `admin@example.com/admin`, `user@example.com/user`.
+- Скриншоты — `...\default-workspace\audit\screenshots\`: desktop 1440 + mobile 390/412, light/dark; смотреть через `read_image`.
+- Эталон: `tools\e2e\tests\priority.spec.js` (1.39.0).
+
+**Известные особенности**
+- Нужен собранный `public/build` (`@vite`); пересобрать `npm run build`.
+- Не запускать полный набор параллельно (общая `servicedesk_test`).
+- Падение: `storage/logs/laravel.log` (в тестах `LOG_CHANNEL=null`) + полный вывод PHPUnit.
+- Windows: `is_writable` сейчас полный доступ.
+
+**Качество**
+- `make lint` / `php scripts/lint.php` — Pint по изменённым (vs HEAD); `--fix` / `make fmt`.
+- `make stan` / `php scripts/stan.php` — PHPStan/Larastan (baseline legacy).
+
+## 2. Куда грузить дальше
+`service-desk-ui` — UI/скриншоты; `service-desk-db-safety` — тестовая БД; `service-desk-release` — релиз; `testing-strategy` — общая стратегия.
+
+## 3. Гейт перед сдачей
+- [ ] Baseline снят до правки; после — не хуже.
+- [ ] Новые тесты: feature + unit; права админа и пользователя.
+- [ ] `php scripts/test.php` зелёный; боевая БД не тронута.
+- [ ] `npm run build`; E2E/скриншоты 1440/390, light/dark проверены.
+- [ ] `lint`/`stan` без новых ошибок; baseline обновлён при необходимости.

package/skills/service-desk-ui/SKILL.md

@@ -1,33 +1,52 @@
 ---
 name: service-desk-ui
-description: "Правила UI/UX проекта Service Desk — где править вёрстку и темы, дизайн-токены, скриншоты и визуальная проверка."
-whenToUse: "Любая правка интерфейса, тем, вёрстки, SCSS/JS или UX-текстов в Service Desk."
+description: "UI Service Desk: где править вёрстку и темы, дизайн-токены, состояния и адаптив, сборка, скриншоты и визуальная проверка."
+whenToUse: "Любая правка интерфейса, тем, вёрстки, SCSS/JS или UX-текстов Service Desk; визуальный баг и проверка перед сдачей."
 user-invocable: true
 ---
 
 # UI/UX Service Desk
 
-## Где править
-- Каркас (меню/шапка/футер): `themes/default/views/layouts/app.blade.php` (темы — только палитры; отдельные папки тем удалены).
-- Страницы: `themes/default/views/*` (dashboard, news, reminders, users, access), `resources/views/*` (auth/login, errors/403, phonebook, partials, pagination), `modules/*/resources/views/*` (заявки, активы, склад, отчёты — namespace `tickets::` и т.п.).
-- Стили: `resources/scss/app.scss` — точка входа; новые правила в `_ui-refresh.scss`, базовое — `_legacy.scss`; токены — `_tokens.scss`.
-- JS: `resources/js/app.js` (+ Bootstrap, виджеты React по требованию). Сборка: `npm run build` (иначе production 500 и тесты падают).
+## 0. Когда применять
+- Любая правка интерфейса, тем, вёрстки, SCSS/JS или UX-текстов.
+- Новая страница, форма, таблица, дашборд; визуальный баг.
+- Перед сдачей UI нужны скриншоты и проверка тем.
+
+## 1. Главное
+
+**Где править**
+- Каркас (меню/шапка/футер): `themes/default/views/layouts/app.blade.php` (темы — только палитры; отдельных папок тем нет).
+- Страницы: `themes/default/views/*` (dashboard, news, reminders, users, access), `resources/views/*` (auth/login, errors/403, phonebook, partials, pagination), `modules/*/resources/views/*` (namespace `tickets::`).
+- Стили: `resources/scss/app.scss` — вход; `_tokens.scss` — токены, `_ui-refresh.scss` — новые правила, `_legacy.scss` — только база.
+- JS: `resources/js/app.js` (+ Bootstrap, React-виджеты); сборка `npm run build` — без неё production 500 и тесты падают.
 - Иконки: `public/themes/default/icons/*.svg`; шрифты: `public/fonts`.
 
-## Дизайн-правила проекта
-- Прямые углы (радиусы 0), спокойная медицинская палитра, 4 палитры: light/dark/contrast/modern.
-- Обязательные состояния: hover, focus-visible, active, disabled, loading, empty, error.
-- Адаптив: ≤560px (одна колонка), ≤960px (меню сверху), >960px (сайдбар); широкие таблицы — в `.table-wrap`.
-- Под каждым полем — `.field-help` (одно предложение, без терминов); ошибки — `.field-error`; обязательные — `label-required`.
-- Не использовать `{!! !!}` для пользовательского контента — только `@html` (HtmlSanitizer).
-- Тексты — по-русски, коротко и по делу; кнопки — глаголом («Создать заявку», «Сохранить»).
-
-## Проверка UI
-1. `php artisan serve --port=8125` из рабочей копии; вход `admin@example.com/admin` / `user@example.com/user`.
-2. Playwright: `...\default-workspace\tools\e2e` → `npx.cmd playwright test`; скриншоты desktop 1440 и mobile (Pixel 7).
-3. Проверить светлую и тёмную темы, пустые состояния, длинные тексты, кириллицу, ошибки форм.
-4. Скриншоты «до/после» приложить к отчёту (`...\default-workspace\audit\screenshots`).
-
-## Полезное
-- Прошлые скриншоты: `%USERPROFILE%\.dsh\memory\projects\service-desk\screenshots\`
-- Правила вывода ошибок/валидации: `resources/lang` нет — `lang/ru/validation.php`; сообщения на русском.
+**Дизайн-правила**
+- Прямые углы (radius 0), спокойная медицинская палитра; 4 палитры: light/dark/contrast/modern.
+- Состояния: hover, focus-visible, active, disabled, loading, empty, error.
+- Адаптив: ≤560px — одна колонка; ≤960px — меню сверху; >960px — сайдбар; широкие таблицы — `.table-wrap`.
+- Под полем — `.field-help` (одно предложение, без терминов); ошибки — `.field-error`; обязательные — `label-required`.
+- Не `{!! !!}` для пользовательского контента — только `@html` (HtmlSanitizer).
+- Тексты по-русски, коротко; кнопки — глаголом («Создать заявку», «Сохранить»).
+- Контраст AA, клавиатура и focus-visible; иконки — SVG, не эмодзи; без horizontal scroll на 390.
+
+**Проверка UI**
+1. `php artisan serve --port=8125`; вход `admin@example.com/admin` / `user@example.com/user`.
+2. Playwright: `...\default-workspace\tools\e2e` → `npx.cmd playwright test`.
+3. Скриншоты desktop 1440 и mobile (Pixel 7 / 390), светлая и тёмная темы; смотреть через `read_image`.
+4. Проверить пустые состояния, длинные тексты, кириллицу, ошибки форм, фокус.
+5. «До/после» — в `...\default-workspace\audit\screenshots`.
+
+**Полезное**
+- Прошлые скриншоты: `%USERPROFILE%\.dsh\memory\projects\service-desk\screenshots\`.
+- Валидация: `lang/ru/validation.php` (`resources/lang` нет).
+
+## 2. Куда грузить дальше
+`wow-design` — арт-направление/токены; `design-critique` — аудит UI; `service-desk-testing` — E2E; `service-desk-conventions` — инварианты.
+
+## 3. Гейт перед сдачей
+- [ ] Правка в правильном слое; `npm run build` выполнен.
+- [ ] 4 палитры/темы, состояния, адаптив 1440/390 проверены.
+- [ ] `.table-wrap`, `.field-help`, `.field-error`, `label-required` на месте.
+- [ ] `@html` вместо `{!! !!}`; тексты по-русски, кнопки-глаголы.
+- [ ] Скриншоты light/dark 1440/390 сняты и просмотрены; overflow нет.