@rt-tools/agent-kit 0.3.0 → 0.4.0

package/assets/patterns/component-structure-new.md

@@ -2,13 +2,13 @@
 name: component-structure-new
 kind: pattern
 rule: component-structure
-description: Паттерн правила component-structure. Брать при заведении или правке файла компонента — порядок свойств декоратора, группировка импортов, раскладка полей класса, договорённости шаблона и якорь для спек. Не брать для состояния и потоков — это паттерн angular-patterns-state.
+description: Паттерн правила component-structure. Брать при заведении или правке *.component.ts — готовый декоратор с порядком свойств, группировка импортов, раскладка полей класса, договорённости шаблона и qa-dataid. Не брать для состояния и потоков — это паттерн angular-patterns-state.
 ---
 
 # Файл компонента
 
 Паттерн правила `component-structure`. Что при этом должно быть верно — закон
-`{{lawsDir}}/frontend-application.md`.
+`docs/constitution/frontend-application.md`.
 
 ## Когда брать
 
@@ -25,14 +25,14 @@ description: Паттерн правила component-structure. Брать пр
     changeDetection: ChangeDetectionStrategy.OnPush, // 4. стратегия перерисовки
     imports: [
         // 5. импорты, группами
-        // каркас
+        // angular
         FormsModule,
 
-        // директивы разметки
+        // rt-tools
         BlockDirective,
         ElemDirective,
 
-        // компоненты
+        // components
         SomeChildComponent,
     ],
     providers: [], // 6. провайдеры
@@ -44,55 +44,56 @@ export class ComponentNameComponent {
     public readonly data: InputSignal<Item[]> = input.required<Item[]>();
     public readonly save: OutputEmitterRef<void> = output<void>();
 
+    protected readonly myButton: Signal<ElementRef | undefined> = viewChild<ElementRef>('button');
     protected readonly items: WritableSignal<Item[]> = signal<Item[]>([]);
     protected readonly itemCount: Signal<number> = computed((): number => this.items().length);
 }
 ```
 
-Группирующие комментарии в импортах обязательны: без них список растёт вперемешку, и первое,
-что в нём теряется, — свои компоненты среди чужих.
+Группирующие комментарии в `imports` обязательны: `// angular`, `// rt-tools`,
+`// components`, `// directives`, `// pipes`.
 
 ## Шаблон
 
-- Самозакрывающиеся теги у компонентов без содержимого.
-- Лишних обёрток нет — корнем работает хост, класс блока приходит его привязкой.
-- Сложный шаблон объявляет блок в корне отдельной директивой.
-- Один компонент в обеих ветках условия — это условная привязка:
+- Самозакрывающиеся теги у компонентов без содержимого: `<<префикс>-gallery />`.
+- Лишних обёрток нет — корнем работает `:host`, класс блока приходит с `host: { class: … }`.
+- Сложный шаблон объявляет блок `<ng-container rtBlock="component-name">` в корне.
+- Один компонент в обеих ветках `@if` — это условная привязка:
 
 ```html
 <!-- ✗ -->
-@if (isRangeMode()) {
-<calendar [rangeMode]="true" />
-} @else {
-<calendar [rangeMode]="false" />
-}
+@if (isRangeMode()) { <<префикс>-calendar [rangeMode]="true" /> } @else { <<префикс>-calendar [rangeMode]="false" /> }
 
 <!-- ✓ -->
-<calendar [rangeMode]="isRangeMode()" />
+<<префикс>-calendar [rangeMode]="isRangeMode()" />
 ```
 
-- Прокрутка по документу — средствами маршрутизатора, а не ссылкой на фрагмент: при объявленном
-  базовом адресе браузер разрешает фрагмент относительно него и уходит в полную навигацию.
+- Прокрутка по документу — через роутер, а не `href="#id"`:
+
+```html
+<a fragment="booking" [routerLink]="[]">…</a>
+```
 
-## Якорь для спек — на каждый интерактивный элемент
+## `qa-dataid` — на каждый интерактивный элемент
 
 ```html
-<button qa-dataid="calendar-retry-prices" type="button" (click)="retryPrices.emit()">Повторить</button>
+<button vmButton qa-dataid="calendar-retry-prices" type="button" (click)="retryPrices.emit()">Повторить</button>
 <div rtElem="grid" qa-dataid="admin-calendar-grid"></div>
 ```
 
-- Значение — через дефис, по смыслу элемента, без имени компонента-обёртки.
+- Значение — kebab-case по смыслу элемента, без имени компонента-обёртки: `calendar-day`,
+  `booking-submit`.
 - Уникальность — в пределах экрана; повторяющиеся элементы списка носят один якорь и
-  различаются атрибутами данных.
-- Декоративный элемент помечается признаком пропуска на самом теге.
+  различаются через `data-*` (`[attr.data-iso]`, `[attr.data-state]`).
+- Декоративный элемент помечается `qa-skip` на самом теге.
 
 ## Частые промахи
 
-- **Чужой префикс селектора** — компонент перестаёт узнаваться как свой.
-- **Множественная форма свойства стилей вместо единственной** — стиль молча не подключается.
-- **Вызов метода в привязке** — отбивается линтером; замена — вычисляемое значение, а там, где
-  оно зависит от контекста шаблона, — чистый преобразователь.
-- **Обёртка, которая существует только чтобы быть контейнером раскладки вокруг всех детей:** её
-  раскладка уезжает на хост.
-- **Глубокий относительный импорт между либами** вместо алиаса.
-- **Своя разметка вместо готового компонента** — правило `reuse-first`.
+- `selector: 'app-component'` вместо `<префикс>-component`.
+- `styleUrls: ['./component.scss']` вместо `styleUrl` — множественное число здесь не то.
+- Вызов метода в биндинге: `{{ getTotal() }}` отбивается линтером. Замена — `computed()`, а
+  там, где значение приходит из контекста шаблона, — чистый пайп.
+- Обёртка, которая существует только чтобы быть flex- или grid-контейнером вокруг всех детей:
+  её раскладка уезжает на `:host`.
+- Глубокий относительный импорт между либами вместо `@<область>/<семья>/<домен>/<слой>`.
+- Своя разметка вместо готового компонента кита — правило `reuse-first`.

package/assets/patterns/dependencies-upgrade.md

@@ -0,0 +1,65 @@
+---
+name: dependencies-upgrade
+kind: pattern
+rule: dependencies
+description: Паттерн правила dependencies. Брать при подъёме версий пакетов — выбор верхней границы по peer-диапазонам, порядок проверок, граница переформатирования после обновления форматтера, разбор новых правил линтера. Не брать для ветки, коммита и PR — это паттерн git-workflow-commit.
+---
+
+# Подъём версий
+
+Паттерн правила `dependencies`. Что при этом должно быть верно — закон
+`docs/constitution/delivery.md`.
+
+## Когда брать
+
+- Поднимается версия любого пакета.
+- Пришло предупреждение об уязвимости в транзитивной зависимости.
+- После установки посыпались замечания линтера или переформатировалось дерево.
+
+## Верхнюю границу задают peer-диапазоны
+
+```bash
+npm view @angular/compiler-cli@22.1.0 peerDependencies
+npm view typescript versions --json | tail -5
+```
+
+Пакет поднимают до последней версии, которая ещё попадает в peer-диапазон каждого, кто от него
+зависит, а не до последней в реестре. Проверять приходится по одному пакету: `autoInstallPeers:
+true` молча доставляет недостающее, и конфликт peer-диапазонов установку не останавливает.
+
+## Порядок
+
+1. `package.json` — точные номера, ни одного `^` и `~`.
+2. `pnpm install`; снимок едет тем же коммитом.
+3. `npx nx run-many -t build -p site admin api` — сборка **до** линтеров: о несовместимости
+   типов она говорит одной строкой, а линтер на том же дереве даёт сотню замечаний, и
+   настоящая причина в них теряется.
+4. `npm run lint` и `npm run stylelint`.
+5. Тесты — правило `testing`. После смены версии Playwright сначала
+   `npx playwright install chromium`.
+6. Обход экранов в браузере — правило `browser-verification`: если пакет рисует вёрстку, смену
+   его версии тесты не покрывают.
+
+## Переформатирование
+
+Обновлённый форматтер меняет все файлы дерева. Что из этого оставлять, решает не размер дифа,
+а то, чьё форматирование проверяет линтер: `.ts` и `.html` — `eslint.config.mjs`, `.scss` —
+`stylelint.config.js`. Остальное переформатируется потом, вместе с правкой, которая эти файлы
+и так трогает: полный прогон изменил 883 файла, из которых проверяются 85, и осмысленные
+правки в такой куче не разглядеть.
+
+## Новые правила линтера
+
+Правило, которое запрещает приём, принятый в этом дереве, выключают один раз в конфиге и
+пишут рядом причину. Правило, которое право по существу, обходят точечным
+`eslint-disable-next-line` — тоже с причиной. Смешивать нельзя: выключенное в конфиге без
+причины через месяц выглядит забытым, а шестьдесят пять точечных обходов одного правила —
+списком того, что надо было выключить один раз.
+
+## Частые промахи
+
+- `pnpm install` не двигает пакет, если он назван в `overrides`: строка из списка держит
+  прежнюю версию, а установка проходит без ошибок.
+- Линтеры до сборки — лишний круг: разбираешь замечания, которых после сборки не будет.
+- Обновление, попавшее в ветку с другой задачей, откатится только вместе с ней: у обновления
+  зависимостей своя задача и своя ветка.

package/assets/patterns/doc-style-sweep.md

@@ -8,8 +8,8 @@ description: Паттерн правила doc-style. Брать, когда д
 # Разбор документа, накопившего список работ
 
 Паттерн правила `doc-style`. Что при этом должно быть верно — закон
-`{{lawsDir}}/project-documentation.md`, статья о том, что предстоящая работа перечислена в одном
-месте.
+`docs/constitution/project-documentation.md`, статья о том, что предстоящая работа
+перечислена в одном месте.
 
 ## Когда брать
 
@@ -31,63 +31,99 @@ description: Паттерн правила doc-style. Брать, когда д
 | описание сделанного                                     | удаляется без переноса: о нём говорят закрытые задачи и история |
 | утверждение, разошедшееся с деревом                     | удаляется как протухшее, а не переносится в задачу              |
 
-Спрашивать владельца об этом наборе не нужно — он записан здесь. Спрашивать стоит одно: судьбу
-самого файла, когда в нём не осталось ничего.
+Спрашивать владельца об этом наборе не нужно — он записан здесь. Спрашивать стоит одно:
+судьбу самого файла, когда в нём не осталось ничего.
 
 ## Обход идёт по утверждениям, а не по пунктам
 
-Работа лежит и в прозе: раздел без единого маркера обход по списку не увидит вовсе. Абзац
-судится тем же признаком, что и пункт.
+Работа лежит и в прозе. Раздел «Экран заявок» перечислял недостающие якоря сплошным текстом,
+без единого маркера, и обход по `- ` его не увидел бы.
 
-## Номер задачи стоит в нескольких местах
+```bash
+# сколько чего в файле: пункты, абзацы, разделы
+grep -c '^- ' docs/BACKLOG.md
+grep -c '^## ' docs/BACKLOG.md
+```
 
-Прежде чем считать «пункты без задачи», надо знать все формы записи — в заголовке, отдельной
-строкой у раздела и в конце пункта. Разбор, знающий одну форму, ошибается молча. **Число,
+Абзац судится тем же признаком, что и пункт.
+
+## Номер задачи стоит в трёх местах
+
+Прежде чем считать «пункты без задачи», надо знать все формы записи. В этом дереве их три:
+
+```markdown
+## Раздел — #149 ← в заголовке
+
+**Тикеты:** #163, #164 ← отдельной строкой у раздела или подраздела
+
+- Пункт про дефект. #101 ← в конце пункта
+```
+
+Разбор, знающий одну форму, ошибается молча: «51 пункт без задачи» оказался шестью. **Число,
 полученное разбором текста, сверяется на выборке руками до того, как его называют.**
 
 ## Сверка с очередью работ
 
 У пункта есть задача — это ещё не значит, что задача несёт его содержание. Перед удалением
-меряется покрытие: сколько значимых слов пункта встречается в теле его задачи. Пункт, покрытый
-наполовину и меньше, читается глазами и разводится на три исхода:
+меряется покрытие: сколько значимых слов пункта встречается в теле его задачи.
+
+```bash
+/opt/homebrew/bin/gh issue list --state all --limit 400 --json number,title,body,state > /tmp/issues.json
+```
+
+Пункт, покрытый телом наполовину и меньше, читается глазами и разводится на три исхода:
 
 - живое уточнение, которого в задаче нет, — дописать в тело;
 - другой дефект — завести своей задачей;
-- протухшее — удалить, **не** перенося. Иначе разбор занесёт в задачу ложь.
+- протухшее — удалить, **не** перенося. Иначе разбор занесёт в задачу ложь: «гард не проверяет
+  каталог кита» переносить было некуда, каталога уже не существовало.
 
 **Наследование номера от заголовка — предположение, а не факт.** Пункт под заголовком с
-несколькими номерами не принадлежит ни одному из них: привязка проверяется чтением.
+четырьмя номерами не принадлежит ни одному из них: привязка проверяется чтением.
 
 ## Сделанность читается по дереву
 
-Утверждение о том, что задача не сделана, стареет так же, как любое другое. Проверяется то, о
-чём собираешься сказать «не сделано», — поиском по дереву, а не памятью.
+Утверждение о том, что задача не сделана, стареет так же, как любое другое. Дважды за один
+разбор устаревшее было названо действующим: маркер непросмотренного уже вёз кит, а половина
+задачи про гейт скилов была сделана и покрыта сценариями.
+
+```bash
+# проверять то, о чём собираешься сказать «не сделано»
+grep -rn '<символ>' libs apps .claude/hooks
+grep -n '<имя>' node_modules/<пакет>/types/*.d.ts
+```
 
 ## Доводы за отсрочку — это «чего это стоит»
 
-Раздел «что стоит отложить» переезжает не в архив, а **в тела тех задач, которых он касается**:
-там он и есть оценка цены. В файле он остаётся, только если отсрочка — решение владельца, а не
-предложение разбора. Признак — записанный ответ владельца с датой.
+Раздел «что стоит отложить» переезжает не в архив, а **в тела тех задач, которых он
+касается**: там он и есть оценка цены. В файле он остаётся, только если отсрочка — решение
+владельца, а не предложение разбора. Признак — записанный ответ владельца с датой; нет
+его — значит, предложение.
 
 ## Ссылки на снятые разделы
 
-Задача, чьё тело ссылается на раздел документа, после разбора ведёт в пустоту, и проверка путей
-этого не видит: она читает файлы репозитория, а не тела задач. Строка снимается тем же заходом.
+Задача, чьё тело говорит `**Источник:** <документ>, раздел «…»`, после разбора ведёт в
+пустоту, и проверка путей этого не видит: она читает файлы репозитория, а не тела задач.
+Строка снимается тем же заходом.
 
 ## Судьба файла
 
-- Осталось незадачное — файл живёт, и его вступление объявляет новый признак отбора.
-- Не осталось ничего, а документ описывал состоявшуюся работу — уезжает в архив.
+- Осталось незадачное — файл живёт, и его преамбула объявляет новый признак отбора.
+- Не осталось ничего, а документ описывал состоявшуюся работу — уезжает в `docs/archive/`.
 - Не осталось ничего, и это был список работ — удаляется.
 
-Разбор целиком — одна задача и одна ветка: делится то, что придётся откатывать порознь, а здесь
-откат общий. Правка кода, найденная по дороге, в эту ветку не идёт — иначе откат разбора унесёт
-починку.
+Разбор целиком — одна задача и одна ветка: делится то, что придётся откатывать порознь, а
+здесь откат общий. Правка кода, найденная по дороге, в эту ветку не идёт — иначе откат разбора
+унесёт починку.
 
 ## Что чинится в дереве следом
 
-Документ — не единственное место, обещающее, что работа живёт в нём. Снятое имя вычищается одним
-проходом по всему дереву, включая описания ролей, скилы, README и комментарии в коде.
+Документ — не единственное место, обещающее, что работа живёт в нём. Снятое имя вычищается
+одним грепом, включая описания агентов, скилы, README и комментарии в коде:
+
+```bash
+grep -rn 'BACKLOG' --exclude-dir=node_modules --exclude-dir=.git --exclude-dir=archive .
+```
 
 ## Частые промахи
 
@@ -96,5 +132,6 @@ description: Паттерн правила doc-style. Брать, когда д
 - Число пунктов названо владельцу до сверки на выборке.
 - Протухшее утверждение перенесено в задачу и стало действующим указанием.
 - Доводы за отсрочку оставлены в документе: он снова становится вторым списком работ.
-- Разбор поделён на несколько задач «по объёму» — признак деления не объём, а раздельный откат.
+- Разбор поделён на несколько задач «по объёму» — признак деления не объём, а раздельный
+  откат.
 - Архив тронут: он описывает состояние на момент написания и под новые термины не правится.

package/assets/patterns/doc-style-write.md

@@ -8,52 +8,53 @@ description: Паттерн правила doc-style. Брать при напи
 # Как формулировать
 
 Паттерн правила `doc-style`. Что при этом должно быть верно — закон
-`{{lawsDir}}/project-documentation.md`.
+`docs/constitution/project-documentation.md`.
 
 ## Когда брать
 
 - Пишется правило, статья закона, пункт спека или README.
 - Пишется комментарий в коде, тело коммита, описание PR.
 
-## Статья — одна фраза
+## Правило — одна фраза
 
-Сама статья укладывается в одно предложение. Следом — не больше двух предложений о том, что
+Само правило укладывается в одно предложение. Следом — не больше двух предложений о том, что
 сломается иначе, и только если из самой фразы это не видно. Обоснование, у которого была
-альтернатива, идёт в «Ловушки» правила, а не в закон: разросшийся пункт читают по диагонали, а
-закон говорит, что верно, — не почему когда-то выбрали так.
+альтернатива, идёт в «Ловушки» правила, а не в сам закон: разросшийся буллет читают по
+диагонали, а закон говорит, что верно, — не почему когда-то выбрали так.
 
 ```
-✗ **Взрослых в записи хотя бы один — на любом пути записи, без исключений.** Нижнюю
-  границу держит хранилище: путей записи три, и проверка в одном из них закрывает не все.
-  Верхнюю ограничением хранилища не выразить — она лежит в самой записи и меняется
-  владельцем.
+✗ **Взрослых в брони хотя бы один — на любом пути записи, без исключений.** Нижнюю
+  границу держит база: путей записи три, и проверка в одном из них закрывает не все.
+  Верхнюю (вместимость объекта) ограничением базы не выразить — она лежит в строке
+  объекта и меняется владельцем.
 
-✓ **Взрослых в записи хотя бы один.** Исключений нет.
-✓ **Взрослые и дети не превышают вместимость.**
+✓ **Взрослых в брони хотя бы один.** Исключений нет: заезда без взрослых не бывает.
+✓ **Взрослые и дети не превышают вместимость объекта.**
 ```
 
 ## Что верно, а не где это держится
 
-«Держит хранилище, а не служба», «проверяется в транзакции», «умолчание колонки», «на трёх
-путях записи из четырёх», имена функций и колонок внутри фразы — это устройство кода. Читателю
-нужно знать, **что** верно.
+«Держит база, а не сервис», «проверяется в транзакции», «умолчание колонки», «на трёх путях
+записи из четырёх», имена функций и колонок внутри фразы — это устройство кода. Читателю нужно
+знать, **что** верно.
 
-Место исполнения меняется при первом же переносе, и документ, который его называет, устаревает
-молча. Для него заведён отдельный файл — `implementation.md` рядом с правилом.
+Место исполнения меняется при первом же рефакторинге, и документ, который его называет,
+устаревает молча. Для него заведён отдельный файл — `implementation.md` рядом.
 
-Исключение — «Ловушки» правила: там устройство кода называется прямо, потому что ловушка и есть
-место, где на него наступают.
+Исключение — «Ловушки» правила: там устройство кода называется прямо, потому что ловушка и
+есть место, где на него наступают.
 
 ## Без утверждений о будущем
 
-«Не планируется», «не будет», «отдельная задача по запросу» — это намерение владельца, а не
+«Не планируется», «не будет», «отдельная фича по запросу» — это намерение владельца, а не
 свойство системы. Что не сделано — да, почему не сделано — да, что не будет сделано никогда —
-нет.
+нет. Вместо приговора — открытый вопрос `Q-N` с тем, что решение изменит.
 
-Ошибка беззвучная: сверять утверждение о будущем не с чем, оно проходит любую проверку.
+Ошибка беззвучная: сверять утверждение о будущем не с чем, оно проходит любую проверку. Так в
+первый живой спек попало «онлайн-оплаты нет и не планируется», хотя оплата в планах.
 
-Отсюда же: того, чего нет в документе о продукте, пересказ не утверждает. Домысел при пересказе
-звучит убедительнее исходника — он короче и категоричнее.
+Отсюда же: того, чего нет в `docs/PRD.md`, документ о продукте не утверждает. Домысел при
+пересказе звучит убедительнее исходника — он короче и категоричнее.
 
 ## Простыми словами
 
@@ -61,9 +62,10 @@ description: Паттерн правила doc-style. Брать при напи
 
 ```
 ✗ запись о прошлом не должна упираться в правило, появившееся позже
+✗ свою запись владельца стирать по молчанию площадки нельзя
 ✗ пустой список без текста и отказ без кнопки выглядят одинаково — как сломанная страница
 
-✓ запись, внесённую владельцем, пропажа события из ленты не снимает
+✓ бронь, которую владелец внёс сам, пропажа события из фида не снимает
 ✓ у пустого списка должен быть текст, у отказа — кнопка повтора
 ```
 
@@ -71,23 +73,24 @@ description: Паттерн правила doc-style. Брать при напи
 
 ## Факт проверяется, а не вспоминается
 
-Перед тем как написать, что код делает то-то, — открыть код и посмотреть. Пересказ по памяти
+Перед тем как написать, что код делает X, — открыть код и посмотреть. Пересказ по памяти
 выглядит так же уверенно, как проверенное утверждение, и отличить их потом нечем.
 
-Особенно это касается отказов: недостижимый отказ, названный в документе, живёт там годами —
-проверить его читателю нечем.
+Особенно это касается отказов: «вернётся `value out of range`» продержалось в двух документах,
+хотя такой отказ недостижим — в контракте и в колонке одна ширина.
 
 ## Не пересказывать то, у чего есть источник
 
-- типы и поля контракта — ссылкой на сам контракт;
-- колонки и индексы — ссылкой на схему хранилища;
-- числа, которые правит владелец, — только как они применяются;
+- типы и поля контракта — `libs/common/proto/proto/<область>/v1/`, ссылкой;
+- колонки и индексы — `prisma/schema.prisma`;
+- числа, которые правит владелец (базовая цена, min-nights, вместимость) — только как они
+  применяются;
 - слои и имена классов — правило `lib-layers` и сам код.
 
 ## Комментарии в коде
 
-Те же правила. Комментарий отвечает на вопрос «почему так, а не иначе» — если ответ неочевиден.
-Что делает строка, видно из строки.
+Те же правила. Комментарий отвечает на вопрос «почему так, а не иначе» — если ответ
+неочевиден. Что делает строка, видно из строки.
 
 Многострочный комментарий над каждой функцией — признак того, что объяснение подменило имя.
 Сначала переименовать, потом писать комментарий.
@@ -102,5 +105,5 @@ description: Паттерн правила doc-style. Брать при напи
   «портировано из», ни ссылок на его файлы — нигде.
 - Число написано по памяти, а не пересчитано командой в том же коммите.
 - Пункт плана вычеркнут по памяти о работе, а не по дереву.
-- Формулировка звучит как заголовок, а не как статья: «работа со скидками» нарушить нельзя,
+- Формулировка звучит как заголовок, а не как правило: «работа со скидками» нарушить нельзя,
   «применяется одна максимальная скидка» — можно.

package/assets/patterns/entity-aside.md

@@ -0,0 +1,136 @@
+---
+name: entity-aside
+kind: pattern
+rule: entity-conventions
+description: Паттерн правила entity-conventions. Брать при сборке или правке панели создания и правки записи — готовый маршрут в аутлете ro, наследование общей основы, runMutation, гард несохранённых правок, шапка и футер, уход на связанную запись. Не брать для стора — это паттерн entity-store.
+---
+
+# Панель правки записи
+
+Паттерн правила `entity-conventions`. Что при этом должно быть верно — закон
+`docs/constitution/entity-editing.md`.
+
+## Когда брать
+
+- Заводится или правится панель создания и правки записи.
+- Появляется панель без записи — настройки таблицы, лента событий.
+
+## Панель объявляется маршрутом в аутлете `ro`
+
+```typescript
+{
+    path: 'booking/:id',
+    outlet: 'ro',
+    component: BookingDetailAsideComponent,
+}
+```
+
+Так панель переживает перезагрузку, передаётся ссылкой и попадает в историю браузера.
+Программного открытия через сервис в админке нет.
+
+Панель, которую открывают из шапки, объявляется константой и подмешивается в `children` каждой
+доменной ветки — аутлет стоит в шаблоне хрома, а хром надевает `shell` каждого домена:
+
+```typescript
+export const ACTIVITY_ASIDE_ROUTES: Route[] = [{ path: 'activity', outlet: 'ro', component: ActivityFeedAsideComponent }];
+```
+
+## Экран наследует общую основу
+
+`RtRouteAsideComponent<T>` держит `entity`, `entityId`, `isCreateMode`, `submitting`,
+`resolving`, `submitError`, открытие панели по маршруту, уход с адреса и всю механику записи.
+Имена из основы не переименовываются: `booking`, `feed`, `slug` вместо `entity` ломают то самое
+единообразие, ради которого основа заведена.
+
+## Запись идёт через `runMutation`
+
+```typescript
+protected save(): void {
+    if (!this.canSave()) {
+        return;
+    }
+
+    this.runMutation(this.#store.save(this.#draft()), {
+        successKey: 'promoCodeSaved',
+        errorText: (): string => this.#store.errorKey() ?? 'promoCodeSaveFailed',
+        closeOnSuccess: true,
+    });
+}
+```
+
+Занятость, гашение прежней ошибки, тост об успехе и закрытие панели держит основа. `errorText`
+— функция: причина отказа известна только после него. Поток мутации обязан отдать значение или
+ошибку — пустой поток гасит панель навсегда.
+
+## Гард несохранённых правок
+
+Ставит сама панель, и он встаёт на все четыре пути закрытия: кнопку в шапке, кнопку в футере,
+нажатие мимо панели и Esc.
+
+```typescript
+protected readonly panelForm: Signal<NgForm | undefined> = viewChild(NgForm);
+protected readonly formPristine: Signal<boolean> = this.pristineSignal(
+    computed((): AbstractControl | undefined => this.panelForm()?.control)
+);
+
+constructor() {
+    super();
+    this.guardUnsavedChanges({ pristine: this.formPristine, save: (): void => this.save() });
+}
+```
+
+`viewChild` на поле с `#` Angular не принимает — поле объявляется `protected`.
+
+## Шапка и футер
+
+```html
+<<префикс>-aside-header [title]="title()" [overline]="overline()" [loading]="resolving()" (dismiss)="onClose()">
+    <ng-container asideActions>
+        <!-- доменные действия иконками; больше двух — под одну кнопку меню -->
+    </ng-container>
+</<префикс>-aside-header>
+```
+
+Заголовок называет действие, имя записи идёт надстрочником. В футере две зоны и не больше двух
+кнопок: `asideDismiss` — закрытие, `asidePrimary` — запись. Доменные глаголы в футер не
+ставятся: подтверждение, отказ, снятие с публикации — иконки в шапке.
+
+Подписи кнопок закреплены, панель их не выбирает:
+
+| Кнопка                               | Подпись                                           |
+| ------------------------------------ | ------------------------------------------------- |
+| запись при создании                  | «Создать»                                         |
+| запись при правке                    | «Сохранить»                                       |
+| закрытие панели, которая записывает  | «Закрыть и не сохранять» (`uiCloseWithoutSaving`) |
+| закрытие панели только для просмотра | «Закрыть»                                         |
+
+Кнопка записи стоит у противоположного края от кнопки закрытия, а пока идёт запрос —
+показывает спиннер и не нажимается: занятость берётся из `submitting()` основы, своего флага
+панель не заводит. Шапка и футер при прокрутке остаются на месте — прокручивается только зона
+содержимого.
+
+## Уход на связанную запись
+
+```html
+<a rtElem="related" qa-dataid="promo-code-property-link" [href]="propertyHref()" (click)="openProperty($event)">
+    {{ 'propertyOpenLink' | transloco }} <<префикс>-icon name="arrow-right" size="sm" />
+</a>
+```
+
+Адрес даёт `relatedUrl(commands)`, уход — `openRelated(commands)`. `routerLink` здесь не
+годится: директива навигирует сама, `preventDefault` её не останавливает, и вопрос о
+несохранённых правках она обходит.
+
+## Частые промахи
+
+- Свой `router.navigate` в панели: абсолютные команды меняют только первичную ветку, аутлет
+  остаётся в адресе, и роутер отклоняет навигацию молча.
+- Скелетоны по `busy()`, а не по `resolving()`: `busy` включает и запись, и на сохранении поля
+  превратились бы в скелетоны.
+- Своё «не найдено» на панели: ненайденная запись уводит с адреса силами основы.
+- Свои отступы поверх общей основы: они дают разную ширину полей на разных панелях и срезают
+  обводку фокуса у края прокрутки.
+- Панель, остающаяся открытой после успеха, не сбросила нетронутость (`markAsPristine`) —
+  вопрос о правках задаётся сразу после записи.
+- Отключённые поля ввода вместо данных: запись, которую только смотрят, показывается через
+  `<dl>`, `<префикс>-detail-list`, `<префикс>-info-item`.