@rt-tools/agent-kit 0.3.0 → 0.5.0

package/assets/patterns/testing-e2e.md

@@ -2,89 +2,91 @@
 name: testing-e2e
 kind: pattern
 rule: testing
-description: Паттерн правила testing. Брать при правке и прогоне сквозных спек — что вообще закрывается сквозной спекой, прогон одним рабочим, стенд из прод-сборки под настоящим прокси, выключатели разрушающих спек. Не брать для юнитов — это паттерн testing-unit.
+description: Паттерн правила testing. Брать при правке и прогоне сквозных спек в apps/site-e2e и apps/admin-e2e — что закрывается сквозной спекой, готовые команды прогона, стенд из прод-сборки под настоящим nginx, выключатели спек. Не брать для юнитов — это паттерн testing-unit.
 ---
 
 # Сквозные спеки
 
 Паттерн правила `testing`. Что при этом должно быть верно — закон
-`{{lawsDir}}/verifiability.md`.
+`docs/constitution/verifiability.md`.
 
 ## Когда брать
 
-- Пишется или правится сквозная спека.
+- Пишется или правится спека в `apps/site-e2e/src` или `apps/admin-e2e/src`.
 - Надо воспроизвести дефект, который виден только на прод-конфигурации.
-- Готовится стенд под прогон против прокси.
+- Готовится стенд под прогон против nginx.
 
 ## Сквозной спекой закрывается накопленное состояние
 
-Случай для неё — тот, где состояние копится нажатиями: открытая панель, активный маршрут, страж
-прошлого экрана. Всё, что проверяется одним заходом по адресу, дешевле закрыть юнитом на чистой
-функции или замером экрана.
+Случай для неё — тот, где состояние копится нажатиями: открытая панель, активный маршрут,
+гард прошлого экрана. Всё, что проверяется одним заходом по адресу, дешевле закрыть юнитом на
+чистой функции или замером экрана.
 
 Отсюда и способ: нажатия по тем же элементам, что нажимает владелец, несколько подряд, без
 перезагрузки между ними. Заход по прямому адресу поднимает приложение заново, накопленного
-состояния у него нет, и проход читается как «дефект не подтверждается».
+состояния у него нет, и проход читается как «дефект не подтверждается» — так на прод уехала
+панель, застревавшая в адресе при уходе в соседний раздел.
 
-Элементы находятся по якорям спек: классы меняются вместе с вёрсткой, а поиск по роли и тексту
+Элементы находятся по `qa-dataid`: классы меняются вместе с вёрсткой, а поиск по роли и тексту
 ломается на переводах.
 
 ## Прогон
 
-По умолчанию конфиг идёт на порт разработки и подхватывает уже поднятый сервер. С заданным
-адресом стенда свой сервер не стартует вовсе.
-
-Полный набор спек с настоящей сессией гоняется **одним рабочим**: такие тесты правят одни и те
-же записи живого хранилища и в параллельном прогоне мешают друг другу. Одни и те же файлы дают
-падения на многих рабочих и ноль на одном.
+```bash
+npx nx e2e site-e2e -- --project=chromium
+npx nx e2e admin-e2e -- --project=chromium
+BASE_URL=http://localhost:{{dockerSitePort}} npx nx e2e site-e2e -- --project=chromium   # против внешнего стенда
+```
 
-## Стенд из прод-сборки под настоящим прокси
+По умолчанию конфиг идёт на {{sitePort}} и подхватывает уже поднятый сервер. С `BASE_URL` свой сервер
+не стартует вовсе.
 
-Дешевле полного состава прода: один контейнер прокси с боевым конфигом, а приложения за ним —
-процессы на хосте.
+Полный набор админки гоняется **одним воркером** (`--workers=1`): тесты с настоящей сессией
+правят одни и те же объекты живой базы и в параллельном прогоне мешают друг другу. Одни и те
+же файлы дали три падения на восьми воркерах и ноль на одном.
 
-```bash
-<сборка всех приложений>
-<адрес хранилища> <порт> node <собранный сервер> &
-docker run -d --name <стенд> \
-  --add-host <имя апстрима>:host-gateway \
-  -p <внешний порт>:80 \
-  -v "$PWD/<конфиг прокси>:/etc/nginx/conf.d/default.conf:ro" \
-  -v "$PWD/<каталог сборки>:/usr/share/nginx/html:ro" \
-  <образ прокси>
-```
+## Стенд из прод-сборки под настоящим nginx
 
-Порты апстримов зашиты в конфиг именами — менять их нельзя, подстановка хоста заменяет только
-адрес.
+Как его поднять — паттерн `browser-verification-stand`; там же сказано, почему главный конфиг
+монтируется отдельной строкой и почему каталогом, а не файлом. Здесь важно одно: против такого
+стенда прогон идёт с `BASE_URL`, и вместе с ним включаются проверки перенаправлений локалей.
 
 ## Выключатели
 
-```
-const РАЗРЕШЕНО = окружение['<имя переменной>'] === '1';
-тест.пропустить(!РАЗРЕШЕНО, 'меняет живой адрес записи: включается переменной');
+```typescript
+const ALLOW_RENAME: boolean = process.env['E2E_ALLOW_SLUG_RENAME'] === '1';
+test.skip(!ALLOW_RENAME, 'меняет живой адрес объекта: включается E2E_ALLOW_SLUG_RENAME=1');
 ```
 
 - Спека, необратимо меняющая данные стенда, по умолчанию пропускается и включается своей
   переменной.
-- Проверки, которым нужен прокси, просыпаются вместе с адресом стенда. Голый сервер отдачи
-  страниц их не проходит, и падения выглядят регрессией.
-- Правило линтера, запрещающее выключенный тест, снимается в конфиге: выключатель здесь — приём,
-  а не забытый пропуск.
+- `BEHIND_NGINX` в `home.smoke.spec.ts` — это `!!process.env['BASE_URL']`: вместе с ним
+  просыпаются проверки перенаправлений локалей. Голый сервер отдачи страниц их не проходит, и
+  два падения выглядят регрессией.
+- `HAS_ADMIN_SESSION` в `sign-in.ts` — пара `E2E_ADMIN_EMAIL` и `E2E_ADMIN_PASSWORD`.
+- `playwright/no-skipped-test` выключен в `eslint.config.mjs`: выключатель теста здесь —
+  приём, а не забытый `test.skip`.
 
 ## Частые промахи
 
-- **Порт приложения занимать осторожно:** стенд разработчика ходит по тому же имени через
-  подстановку хоста, и пока на нём висит чужой процесс, стенд отдаёт чужую сборку.
-- **Браузер обычно установлен один.** Ошибка «Executable doesn't exist» разобрана в правиле
-  `testing`: она же приходит после смены версии прогонщика.
-- **Спеки без учётных данных пропускаются молча** — прогон выглядит успешным, а проверено
-  меньше половины.
-- **Конфиг прокси монтируется каталогом, а не одиночным файлом:** редактор пересоздаёт файл, и
+- **Порт {{ssrPort}} занимать осторожно:** стенд разработчика на {{sitePort}} ходит по тому же имени
+  `ssr:{{ssrPort}}` через `host-gateway`, и пока на нём висит чужой процесс, стенд отдаёт чужую
+  сборку.
+- Браузер стоит один — chromium; узкий экран — `--project=mobile-chrome`. Ошибка «Executable
+  doesn't exist» разобрана в правиле `testing`: она же приходит после смены версии Playwright.
+- Спеки админки без сессии пропускаются молча — прогон выглядит успешным, а проверено меньше
+  половины.
+- Конфиг nginx монтируется каталогом, а не одиночным файлом: редактор пересоздаёт файл, и
   контейнеру остаётся обрезанная копия.
-- **Подменяется не только то, что запрашивает экран, но и то, что запрашивает шапка.** Общий
-  запрос идёт на каждом экране; без подмены на него отвечает настоящий сервер, поддельный вход
-  он отбивает, перехватчик сбрасывает сессию — и десятки тестов падают на пропавшей шапке, что
-  выглядит дефектом экрана.
-- **Каталог сборки, удалённый под смонтированным томом, оставляет контейнер с пустым корнем:**
-  стенд отвечает отказом на всё, и падают сразу все тесты. Контейнер после такого удаления
-  пересоздаётся.
+- **Подменяется не только то, что запрашивает экран, но и то, что запрашивает шапка.** Счётчик
+  непрочитанного запрашивается на каждом экране под шапкой. Без подмены на этот запрос
+  отвечает настоящий сервер, поддельный вход он отбивает, интерцептор сбрасывает сессию, и
+  пятьдесят девять тестов падают на пропавшей шапке — выглядит это дефектом экрана.
+- **Состояние, которое живёт только во время операции, тестом не проверяется.** Список заливки
+  под кнопкой виден, пока файлы летят: на подменённых ответах они долетают раньше, чем тест
+  успевает его прочитать, и тест краснеет через раз. Проверяют либо конечное состояние
+  (`data-state` строки стал `done`), либо то же промежуточное — но на ответе, который тест сам
+  задержал и сам отпускает.
+- **Каталог сборки, удалённый под смонтированным томом, оставляет контейнер с пустым
+  корнем:** стенд отвечает 403 на всё, и падают сразу все тесты. Контейнер после
+  `rm -rf dist/apps/<приложение>` пересоздаётся.

package/assets/patterns/testing-unit.md

@@ -2,92 +2,116 @@
 name: testing-unit
 kind: pattern
 rule: testing
-description: Паттерн правила testing. Брать при заведении или правке файла спеки рядом с исходником — раскладка блоков, сборщик фикстур, идентификатор сценария в заголовке, спека обработчика серверной стороны с рукописным двойником хранилища, разовый тест-доказательство. Не брать для сквозных спек — это паттерн testing-e2e.
+description: Паттерн правила testing. Брать при заведении или правке *.spec.ts под Vitest — готовая раскладка describe и it, сборщик фикстур, идентификатор сценария в заголовке, спека процедуры Connect с рукописным двойником базы. Не брать для сквозных спек — это паттерн testing-e2e.
 ---
 
-# Спека на чистую функцию и на обработчик
+# Спека на чистую функцию и на процедуру
 
 Паттерн правила `testing`. Что при этом должно быть верно — закон
-`{{lawsDir}}/verifiability.md`.
+`docs/constitution/verifiability.md`.
 
 ## Когда брать
 
-- Заводится или правится файл спеки рядом с исходником.
-- Логику надо вынести из компонента или службы, чтобы её стало чем проверить.
-- Пишется спека на обработчик серверной стороны.
+- Заводится или правится `*.spec.ts` рядом с исходником.
+- Логику надо вынести из компонента или сервиса, чтобы её стало чем проверить.
+- Пишется спека на процедуру Connect.
 
 ## Импорты явные
 
-Даже когда прогонщик кладёт свои имена в глобальную область, список пишется: файл, читаемый
-без конфига, не должен зависеть от настройки, о которой в нём ни слова.
+`globals: true` в конфиге стоит, но список всё равно пишется:
 
-## Один блок на функцию
+```typescript
+import { describe, expect, it } from 'vitest';
+```
 
-Имя блока совпадает с именем функции дословно; заголовки тестов — предложения настоящим
-временем, о поведении, а не об устройстве:
+## Один `describe` на функцию
 
-```
-описание('applyDayClick', () => {
-    тест('SC-<ПРЕФИКС>-19 — нажатие по занятому дню ничего не меняет', () => {
-        ожидать(applyDayClick(day('2026-08-12'), selection)).равно(selection);
+Имя блока совпадает с именем функции дословно; заголовки `it` — предложения по-русски,
+настоящим временем, о поведении, а не об устройстве:
+
+```typescript
+describe('applyDayClick', () => {
+    it('SC-BK-19 — клик по занятому дню ничего не меняет', () => {
+        expect(applyDayClick(day('2026-08-12'), selection)).toEqual(selection);
     });
 });
 ```
 
-Идентификатор сценария из спека домена стоит в начале заголовка, через тире. Краевые случаи —
-отдельные тесты в том же блоке, а не один тест с десятком проверок.
+Идентификатор сценария из `docs/specs/<домен>/scenarios.md` стоит в начале заголовка, через
+тире. Краевые случаи — отдельные `it` в том же блоке, а не один тест с десятком проверок.
 
-## Фикстура собирается функцией с частичной подменой
+## Фикстура собирается функцией с `Partial<T>`
 
-Не повторяющимся литералом: литерал, размноженный по файлу, при первой же новой обязательной
-колонке правится в каждом месте — и в одном обязательно забывается.
+Не повторяющимся литералом:
 
-```
-функция day(iso, подмена = {}) {
-    вернуть { iso, dayOfMonth: число(iso.срез(8)), busyNight: занято(iso), past: ложь, ...подмена };
+```typescript
+function day(iso: string, overrides: Partial<ICalendarDay> = {}): ICalendarDay {
+    return {
+        iso,
+        dayOfMonth: Number(iso.slice(8)),
+        priceThb: 6000,
+        busyNight: isNightBusy(iso, BUSY),
+        past: false,
+        ...overrides,
+    };
 }
 ```
 
-Общие константы лежат наверху файла, в области модуля.
+Общие константы (`PRICING`, `BUSY`) лежат наверху файла, в области модуля.
 
 ## Решение выносится в чистую функцию
 
-Логика уезжает в отдельный файл рядом и проверяется вызовом — без подъёма каркаса и без
-подмены зависимостей. Компонент и служба остаются обёрткой, у которой своего ветвления нет.
+Господствующая форма в этом дереве: логика уезжает в `*.logic.ts`, `*.util.ts` или
+`*.calculator.ts`, и проверяется вызовом — без `TestBed`, без подмены зависимостей. Образцы —
+`libs/site/common/booking/util/src/lib/availability-calendar.logic.ts` и
+`libs/api/<домен расчёта>/util/src/lib/quote.calculator.ts`.
 
-## Обработчик зовётся напрямую
+## Процедура зовётся напрямую
 
-Обработчик — метод класса; двойник хранилища пишется руками. Проверяются порядок действий,
-откат при отказе половины, идемпотентность повтора и то, что именно ушло в хранилище. Раскладку
-полей стерегут тесты слоя обращения к серверу, и здесь она не повторяется.
+Обработчик — метод `handle` класса процедуры в слое `feature` своего домена. Двойник базы
+пишется руками; образец — `FakePrismaClient` в
+`libs/api/<домен заявок>/feature/src/lib/link-booking.procedure.spec.ts`:
+
+```typescript
+const prisma: FakePrismaClient = new FakePrismaClient();
+await procedureWith(prisma, emitter).handle(request());
+```
+
+Проверяются порядок действий, откат при отказе половины, идемпотентность повтора и то, что
+именно ушло в базу. Раскладку полей стерегут тесты слоя `api`, и здесь она не повторяется.
 
 ## Разовый тест-доказательство
 
 Дефект, который иначе подтверждается только чтением кода, доказывается тестом, написанным на
-время разбора: он поднимает настоящий обработчик, подменяет его единственный выход наружу и
+время разбора: он поднимает настоящую процедуру, подменяет её единственный выход наружу и
 считает походы.
 
-Число до правки и число после — единственная форма ответа, которую такая проверка даёт: «сто из
-ста» и «двадцать из ста» различимы, а «код выглядит правильным» — нет.
+```typescript
+globalThis.fetch = (): Promise<Response> => Promise.resolve(Response.json({ success: false }));
+```
+
+Число до правки и число после — единственная форма ответа, которую такая проверка даёт: «сто
+походов из ста» и «двадцать из ста» различимы, а «код выглядит правильным» — нет.
 
-Второй способ снять «до» — вернуть на место версию файла из точки расхождения ветки и прогнать
-тест ветки: падение теста и есть воспроизведение дефекта. Файл после этого восстанавливается
-копией, и восстановление проверяется прогоном того же теста, а не памятью.
+Второй способ снять «до» — вернуть на место версию файла из точки расхождения ветки и
+прогнать тест ветки: падение теста и есть воспроизведение дефекта. Файл после этого
+восстанавливается копией, и восстановление проверяется прогоном того же теста, а не памятью.
 
-Двойники соседей не выдумываются: рабочий набор берётся из теста соседнего обработчика того же
+Двойники соседей не выдумываются: рабочий набор берётся из теста соседней процедуры того же
 домена. Двойник, собранный по типу, падает не на утверждении, а на вызове метода, которого у
 него нет.
 
 **Такой файл не коммитится.** Он живёт до конца разбора и удаляется вместе с ним; проверка,
-которую стоит оставить, переписывается в обычную спеку с идентификатором сценария в заголовке.
-Признак временного файла — его заголовок не называет ни одного сценария.
+которую стоит оставить, переписывается в обычный `*.spec.ts` с идентификатором сценария в
+заголовке и едет в ветке. Признак временного файла — его заголовок не называет ни одного
+сценария.
 
 ## Частые промахи
 
-- **Либа без своего конфига прогонщика проходит зелёной, не запустив ни одного файла.** Прежде
-  чем писать первый тест в либе, проверить, что конфиг рядом есть.
-- **Подмена модуля скрыла бы то, ради чего тест и заводится** — какой именно вызов ушёл в
-  хранилище и в каком порядке. Двойник пишется руками.
-- **Своих помощников для проверок не заводить** — утверждения пишутся прямо.
-- **Заголовок с несуществующим идентификатором сценария роняет проверку спеков**, а сами тесты
-  при этом остаются зелёными.
+- Либа без своего `vitest.config.mts`: `nx test <проект>` пройдёт зелёным, не запустив ни
+  одного файла. Прежде чем писать первый тест в либе, проверить, что конфиг рядом есть.
+- Подмена модуля (`vi.mock`) скрыла бы то, ради чего тест и заводится, — какой именно вызов
+  ушёл в базу и в каком порядке. Двойник пишется руками.
+- Своих помощников для проверок не заводить: `expect(...).toBe(...)` и `.toEqual(...)` прямо.
+- Заголовок с несуществующим идентификатором сценария роняет `npm run check:specs`, а сами
+  тесты при этом остаются зелёными.

package/assets/patterns/translations-key.md

@@ -2,12 +2,13 @@
 name: translations-key
 kind: pattern
 rule: translations
-description: Паттерн правила translations. Брать, когда в интерфейсе появляется видимый текст — куда положить ключ, как подставить его в разметку и в класс, чем дозаполнить остальные локали и чем проверить полноту. Не брать для перевода содержимого записи — его заполняет серверная сторона.
+description: Паттерн правила translations. Брать, когда в интерфейсе появляется видимый текст — куда положить ключ, как подставить его в разметку и в класс, чем дозаполнить остальные семь локалей и чем проверить полноту. Не брать для перевода контента объекта — его заполняет бэкенд.
 ---
 
 # Ключ перевода
 
-Паттерн правила `translations`. Что при этом должно быть верно — закон `{{lawsDir}}/locales.md`.
+Паттерн правила `translations`. Что при этом должно быть верно — закон
+`docs/constitution/application/locales.md`.
 
 ## Когда брать
 
@@ -16,36 +17,48 @@ description: Паттерн правила translations. Брать, когда
 
 ## Куда кладётся ключ
 
-Словари разложены по разделам, и наборы ключей сверяются **внутри раздела**: общее для всех
-приложений, публичная часть, внутренняя часть, письма. Ключ заводится во всех локалях сразу —
-пустое значение считается пропуском, а не переводом.
+`libs/common/i18n/src/lib/dictionaries/<локаль>/<раздел>.json`. Разделов четыре, и наборы
+ключей сверяются внутри раздела:
+
+| Раздел        | Что в нём                   |
+| ------------- | --------------------------- |
+| `common.json` | общее для сайта и админки   |
+| `site.json`   | публичный сайт              |
+| `admin.json`  | админ-панель                |
+| `mail.json`   | письма и документ-основание |
+
+Локалей восемь: `en`, `ru`, `de`, `zh-Hans`, `zh-Hant`, `ko`, `th`, `hi`. Ключ заводится во
+всех — пустое значение считается пропуском, а не переводом.
 
 ## Подстановка
 
-В разметке — преобразователем, в классе — реактивным значением:
+В разметке — пайпом:
 
 ```html
-<h1 rtElem="title">{{ '<ключ заголовка>' | <перевод> }}</h1>
-<table [emptyMessage]="'<ключ пустого списка>' | <перевод>"></table>
+<h1 rtElem="title">{{ 'bookingsTitle' | transloco }}</h1>
+<<префикс>-table [emptyMessage]="'bookingsEmpty' | transloco" [ariaLabel]="'bookingsTableAria' | transloco">
 ```
 
+В классе — сигналом:
+
 ```typescript
-protected readonly title: Signal<string> = translateSignal('<ключ заголовка>');
+protected readonly title: Signal<string> = translateSignal('promoCodesTitle');
 ```
 
 ## Дозаполнить и проверить
 
-Дозаполнение недостающего делается командой, а полноту держит тест: он роняет прогон на
-недостающем или пустом ключе. Глазами это не проверяется — ключей тысячи.
+```bash
+npm run i18n:fill        # дозаполняет недостающее в остальных локалях
+npx nx test common-i18n  # роняет сборку на недостающем или пустом ключе
+```
 
 ## Частые промахи
 
-- **Текст строкой прямо в шаблоне:** он уедет в интерфейс на одном языке во всех локалях.
-- **Ключ заведён только в паре локалей:** тест полноты падает, но замечают это уже в гейте
-  пуша.
-- **Пустая строка вместо перевода:** на экране она выглядит как задуманная — кнопка без
-  подписи, заголовок без текста.
-- **Ключ положен не в свой раздел:** наборы сверяются внутри раздела, и расхождение вылезет как
+- Текст строкой прямо в шаблоне: он уедет в интерфейс по-английски во всех локалях перевода.
+- Ключ заведён только в `en` и `ru`: тест полноты падает, но замечают это уже в гейте пуша.
+- Пустая строка вместо перевода: на экране она выглядит как задуманная — кнопка без подписи,
+  заголовок без текста.
+- Ключ положен не в свой раздел: наборы сверяются внутри раздела, и расхождение вылезет как
   недостача в другом.
-- **Свой ключ успеха у панели правки записи:** текст успеха принадлежит самой операции и
-  заводится во всех локалях сразу.
+- Свой ключ успеха у панели правки записи: текст успеха принадлежит мутации, и заводится он во
+  всех локалях перевода сразу.

package/assets/patterns/ts-procedure.md

@@ -2,30 +2,30 @@
 name: ts-procedure
 kind: pattern
 rule: typescript-conventions
-description: Паттерн правила typescript-conventions. Брать при заведении или правке обработчика серверной стороны — класс с полем метода контракта и методом обработки, зависимости конструктором, имя файла и класса, почему форма именно такая. Не брать для объявления доступа — это паттерн permissions-procedure.
+description: Паттерн правила typescript-conventions. Брать при заведении или правке процедуры Connect на бэкенде — готовый класс с полем method и методом handle, зависимости конструктором, имя файла и класса, почему форма именно такая. Не брать для объявления доступа к процедуре — это паттерн permissions-procedure.
 ---
 
-# Обработчик серверной стороны
+# Процедура Connect
 
 Паттерн правила `typescript-conventions`. Что при этом должно быть верно — закон
-`{{lawsDir}}/code-structure.md`.
+`docs/constitution/code-structure.md`.
 
 ## Когда брать
 
-- Заводится новый обработчик серверной стороны.
-- Правится тело существующего.
+- Заводится новая процедура бэкенда.
+- Правится тело существующей.
 - Домен переезжает на вертикальную нарезку.
 
-## Один обработчик — один класс
+## Одна процедура — один класс
 
-Файл рядом со своим доменом, класс с публичным полем метода контракта и публичным методом
-обработки. Зависимости приходят конструктором: на серверной стороне внедрение конструкторное, и
-функции внедрения фронта там нет.
+Файл `<процедура>.procedure.ts` в слое `feature` своего домена, класс `<Процедура>Procedure`,
+публичное поле `method` с дескриптором из контракта и публичный метод `handle` с телом.
+Зависимости приходят конструктором — на бэкенде DI нестовский, `inject()` там нет.
 
 ```typescript
 @Injectable()
 @ConnectProcedure()
-@RequiresPermission('<ресурс>:<действие>')
+@RequiresPermission('bookings:manage')
 export class PingProcedure implements IConnectProcedure<typeof HealthService.method.ping> {
     readonly #health: HealthCheckService;
 
@@ -45,22 +45,21 @@ export class PingProcedure implements IConnectProcedure<typeof HealthService.met
 
 ## Почему форма такая
 
-Прежняя — регистрация с телами в замыканиях внутри вызова роутера — делала обработчик
-недостижимым для спеки: наружу торчал только метод регистрации. А регистрация сервиса целиком
-заглушает каждый непереданный метод ответом «не реализовано», поэтому один сервис контракта не
-мог обслуживаться двумя доменами.
+Прежняя — `register(router)` с телами в замыканиях внутри `router.service(...)` — делала
+обработчик недостижимым для спеки: наружу торчал только класс с методом `register`. А
+`router.service` заглушает каждый непереданный метод ответом `Unimplemented`, поэтому один
+proto-сервис не мог обслуживаться двумя доменами.
 
-Класс решает и то, и другое: метод обработки зовётся спекой напрямую, а реестр кладёт
-обработчики поштучно.
+Класс решает и то, и другое: `handle` зовётся спекой напрямую, а реестр кладёт процедуры
+поштучно через `router.rpc`.
 
 ## Частые промахи
 
-- **Третий суффикс имени файла:** прежние имена уходят вместе с последним переехавшим доменом,
-  и новых таких файлов не заводится.
-- **Функция внедрения фронта в классе обработчика:** зависимости идут конструктором.
-- **Тело в замыкании внутри регистрации:** спека до него не дотянется.
-- **Обработчик без объявления доступа:** приложение не поднимется.
-- **Приведение к типу в переводе моделей:** на серверной стороне оно запрещено так же, как во
-  фронтовом переводчике.
-- **Свой тип у результата группирующей выборки:** он условный, собирается из аргументов вызова
-  и с выписанным руками не сходится.
+- Третий суффикс: `*.rpc.ts` и `*.connect.ts` — прежние имена, они уходят вместе с последним
+  переехавшим доменом, и новых таких файлов не заводится.
+- `inject()` в классе процедуры: на бэкенде зависимости идут конструктором.
+- Тело в замыкании внутри регистрации роутера: спека до него не дотянется.
+- Процедура без объявления доступа: приложение не поднимется.
+- Приведение `as` в переводе моделей: на бэкенде оно запрещено так же, как в маппере фронта.
+- Свой тип у результата `groupBy` Prisma: он условный, собирается из аргументов вызова и с
+  выписанным руками не сходится. Там, где ключей единицы, идёт `count` на ключ в `Promise.all`.

package/assets/rules/angular-patterns.md

@@ -2,51 +2,74 @@
 name: angular-patterns
 kind: rule
 law: frontend-application
-description: Правило под закон «Фронтовое приложение». Брать при правке любого класса фронтового каркаса — компонента, стора, сервиса, директивы, преобразователя, стража, перехватчика. Реактивное состояние вместо ручного пересчёта, перерисовка по требованию, место подписки и её владелец. Не действует на серверной стороне. Готовый код — в паттерне angular-patterns-state. Чем это названо здесь — в implementation.md рядом.
+description: Правило под «Закон о фронтовом приложении». Брать при правке любого класса Angular — компонента, стора админки, сервиса, директивы, пайпа, гарда, интерцептора. Называет сигнальный API входов, OnPush, zoneless, inject и место, где живёт подписка. Не действует под libs/api и apps/api. Готовый код — в паттерне angular-patterns-state.
 ---
 
-# Реактивность экрана — каким приёмом
+# Реактивность экрана — как это устроено здесь
 
-Правило под закон `{{lawsDir}}/frontend-application.md`. Закон говорит, что должно быть верно;
-здесь — каким приёмом это держится. Чем названы реактивное значение, входы и выходы и как
-зовётся гашение подписки — `implementation.md` рядом. Раскладка файла компонента —
-`component-structure`, оформление — `styling-bem`, окружение браузера — `platform-access`, слой
+Правило под закон `docs/constitution/frontend-application.md`. Закон говорит, что должно быть
+верно; здесь — на чём это стоит в этом дереве. Раскладка файла компонента —
+`component-structure`, стили — `styling-bem`, окружение браузера — `platform-access`, слой
 обращения к серверу — `api-layer`. Все пять под одним законом.
 
-Правило про фронт: на серверной стороне своя среда, и ничего из перечисленного к ней не
-относится.
+Правило про фронт: `libs/api/**` и `apps/api/**` — это NestJS, там своя среда, и ничего из
+перечисленного не применяется.
 
-## Когда берётся
+## Как это называется здесь
 
-Правка любого класса фронтового каркаса: компонента, стора, сервиса, директивы,
-преобразователя, стража, перехватчика.
+| В законе                                | Здесь                                                                                              |
+| --------------------------------------- | -------------------------------------------------------------------------------------------------- |
+| состояние, которое пересчитывается само | `signal()` и `computed()`; Angular без Zone.js (`provideZonelessChangeDetection()`)                |
+| вход и выход компонента                 | `input()`, `input.required()`, `output()`; `viewChild()`, `contentChild()` и их множественные пары |
+| перерисовка по требованию               | `ChangeDetectionStrategy.OnPush` — на каждом компоненте                                            |
+| владелец подписки                       | `takeUntilDestroyed(this.#destroyRef)`                                                             |
+| источник действия                       | `Subject` с суффиксом `Source` в имени поля                                                        |
 
-## Что здесь действует
+## Где это лежит
 
-- **Подписка объявляется один раз, а не в методе действия.** Метод толкает значение в источник,
-  а долгоживущая подписка с переключением, отбрасыванием или очередью объявляется при создании
-  владельца.
-- **Подписка гасится вместе с владельцем.** Гашение ставится в тот же поток, где объявлена
-  подписка, — иначе поток переживает экран, на котором заведён.
-- **Источник действия носит суффикс в имени.** Иначе поток и значение в коде неотличимы, и
-  проталкивание уходит не туда.
+В этом дереве — таблица в `implementation.md` рядом. Пути живут там, а не здесь: правило
+переносится между репозиториями, раскладка — нет, и путь, названный в правиле, врёт в первом
+же дереве, которое держит код иначе.
+
+## Как закон применяется здесь
+
+- **Подписка объявляется один раз, а не в методе действия.** Метод толкает значение в
+  источник, а долгоживущая подписка со `switchMap`, `exhaustMap` или `concatMap` объявляется в
+  конструкторе, в `ngOnInit` или в инициализаторе поля.
+- **Подписка гасится вместе с владельцем.** `takeUntilDestroyed` ставится в тот же поток, где
+  объявлена подписка.
+- **Источник действия носит суффикс `Source` в имени.** Иначе поток и значение в коде
+  неотличимы, и `next` уходит не туда.
 - **Списочный стор наследует общую основу.** Записи, страница, порядок, условия отбора, строка
-  поиска и настройка выборки уже там, и наследнику остаются несколько строк.
+  поиска и конфиг выборки уже там, и наследнику остаются четыре строки.
+
+## Чего из закона здесь нет
+
+Ни `OnPush`, ни сигнальный API входов, ни отсутствие геттеров в компонентах не проверяет
+ничто: `@Input()` и геттер компилируются и работают, а расхождение видно только чтением.
+Обращение к окружению браузера тоже не проверяется — это `Q-FA-1` в законе.
 
 ## Паттерны
 
-- `angular-patterns-state` — реактивные значения, производные, состояние сервиса, подписка.
+- `angular-patterns-state` — сигналы, производные значения, состояние сервиса, подписка.
 
 ## Ловушки
 
-- **Производное значение объявляется вычисляемым, а не эффектом.** Эффект, кладущий значение в
-  реактивное поле, — это ручной пересчёт, и он рано или поздно отстаёт от источника.
+- **Производное значение считается `computed`, а не эффектом.** `effect`, кладущий значение в
+  сигнал, — это ручной пересчёт, и он рано или поздно отстаёт от источника.
 - **Геттеров в компонентах нет.** Геттер пересчитывается на каждой перерисовке, и цена его не
   видна ни в одном месте кода.
+- **Статический атрибут без значения задаёт входу пустую строку, а не умолчание.**
+  `<ng-template someControl>` даёт `''`, и вход с осмысленным умолчанием молча его теряет;
+  сигнальный вход с алиасом здесь ничем не отличается от `@Input()`. Вход, у которого умолчание
+  что-то значит, приводит пустую строку к нему сам — `transform` или проверка в `computed`.
 - **Подписка на каждый вызов метода не даёт выбрать, что делать с предыдущим запросом.**
   Быстрые нажатия дают гонку ответов, и побеждает тот, что вернулся последним, а не тот, что
   нажали последним.
-- **Запрет подписки в методе идёт по имени, а не по типу.** Вызов с таким именем у чего угодно
-  считается подпиской, а взятие метода без вызова — нет.
-- **Инициализация разметки после первой отрисовки делается своим крючком, а не крючком
-  жизненного цикла представления.** Когда страницу отдаёт сервер, разметка появляется позже.
+- Запрет подписки в методе идёт по имени `subscribe`, а не по типу: вызов с таким именем у
+  чего угодно считается подпиской, а `const fn = stream$.subscribe` без вызова — нет.
+  Разрешены конструктор, `ngOnInit`, инициализатор поля и всё, что объявлено вне класса;
+  запрещены остальные методы, включая приватные с `#`, геттеры и `ngAfterViewInit`.
+- Инициализация DOM после первой отрисовки — `afterNextRender()`, а не `ngAfterViewInit`:
+  сайт отдаётся сервером, и DOM там появляется позже.
+- `viewChild` на поле с `#` Angular не принимает — поле объявляется `protected`.