@rt-tools/agent-kit 0.2.0 → 0.4.0

package/assets/rules/navigation.md

@@ -0,0 +1,78 @@
+---
+name: navigation
+kind: rule
+law: navigation
+description: Правило под «Закон о навигации по разделам». Брать при правке декларации меню, libs/admin/common/container/**, apps/admin/src/app/app.routes.ts и любого libs/admin/**/*.routes.ts. Называет декларацию меню, колонки и группы панели, гейтинг и вложение адресов. Готовый код — в паттерне admin-nav-item.
+---
+
+# Навигация админки — как это устроено здесь
+
+Правило под закон `docs/constitution/navigation.md`. Закон говорит, как пользователь
+находит раздел и попадает в него; здесь — из чего меню собрано в этом дереве и как
+выглядит. Про вид говорит правило: закон о нём молчит намеренно.
+
+## Как это называется здесь
+
+| В законе                 | Здесь                                                                   |
+| ------------------------ | ----------------------------------------------------------------------- |
+| пункт меню               | запись в декларации `admin-nav.items.ts`                                |
+| раздел с панелью         | пункт с колонками; своего адреса не имеет                               |
+| панель второго уровня    | попап `rt-page-header` из пакета кита, разложенный колонками и группами |
+| признак непросмотренного | точка, приходит предикатом по идентификатору пункта                     |
+| флаг «экрана ещё нет»    | `disabled` в декларации                                                 |
+
+## Где это лежит
+
+В этом дереве — таблица в `implementation.md` рядом. Пути живут там, а не здесь: правило
+переносится между репозиториями, раскладка — нет, и путь, названный в правиле, врёт в первом
+же дереве, которое держит код иначе.
+
+## Как закон применяется здесь
+
+- **Пункт объявляется один раз и служит источником и меню, и гейтинга маршрутов.** Второе
+  объявление рядом с маршрутами разошлось бы с первым, и получилось бы «пункта не видно, а
+  страница открывается».
+- **Декларация не импортирует ни один `shell`.** Иначе граф `shell → container/feature → shell`
+  замкнётся и проверка раскладки встанет.
+- **Гейтинг двухслойный: право пользователя и флаг раздела.** Пункт с флагом объявляется без
+  прав и без адреса — право открывает экран, а экрана нет; виден он при этом всем.
+- **Данные домена приходят в шапку токеном, а не импортом.** Интерфейс и `InjectionToken` живут
+  в `container/util`, связывает их с реализацией композиционный корень.
+
+## Чего из закона здесь нет
+
+В меню стоят семнадцать пунктов второго уровня и раздел «Финансы», у которых экрана пока нет:
+они выкачены недоступными, потому что исчезнувший пункт неотличим от того, которого никогда
+не было.
+
+Отрисовка самой шапки живёт в `rt-page-header` из `@rt-tools/ui-kit-v2`. Проект её не пишет и
+не может нарушить: он объявляет пункты, а рисует их кит. Китом заданы:
+
+- подсказка у недоступного пункта и `aria-disabled` вместо нативного `disabled`;
+- подсветка раздела по префиксу адреса;
+- открытие панели второго уровня наведением, а на касании — нажатием;
+- раскладка панели колонками, внутри колонки — группами с подписью; если первая группа в
+  колонке без заголовка, её пункты начинаются от верха панели;
+- ширина панели по числу колонок, а не по длине подписей, и её помещаемость от своего
+  раздела до правого края экрана;
+- указатель раскрытия у раздела с панелью и его отсутствие у раздела без неё;
+- отдельная мобильная раскладка: меню сворачивается в кнопку, раскрывается теми же разделами
+  и группами и прокручивается, когда пункты не помещаются по высоте.
+
+Ничего из этого правило к коду проекта не привязывает: привязывать нечего.
+
+## Паттерны
+
+- `admin-nav-item` — завести пункт меню и его маршрут: декларация, права, флаг, вложение
+  адреса, подпись во всех локалях.
+
+## Ловушки
+
+- Обработчика нажатия у недоступного пункта нет вовсе: `aria-disabled` нажатие не отбивает.
+- Ветка, куда забыли подмешать константу ro-маршрута, отличается только тем, что кнопка в
+  шапке на ней ничего не открывает.
+- Группы внутри раскрытого раздела на узком экране отдельно не сворачиваются, поэтому в
+  множестве раскрытых лежат только идентификаторы разделов.
+- Ширина панели считается числом колонок, а не содержимым; числа задаются токенами `--rt-*`,
+  сырые значения запрещены правилом стилей.
+- Переезд адреса трогает ссылки и спеки e2e — они ходят по адресам.

package/assets/rules/ownership-scope.md

@@ -0,0 +1,63 @@
+---
+name: ownership-scope
+kind: rule
+law: ownership
+description: Правило под «Закон о владеющей сущности». Брать, когда процедура или экран работает с записью, принадлежащей владеющей сущности — разрешение идентификатора, умолчание при единственной действующей, сводки по всем. Называет обе формы разрешения и коды отказа. Готовый код — в паттерне ownership-scope-resolve. Чем это названо здесь — в implementation.md рядом.
+---
+
+# Владеющая сущность — как это устроено здесь
+
+Правило под закон `docs/constitution/application/ownership.md`. Закон говорит, что должно быть
+верно; здесь — каким приёмом это держится. Как владеющая сущность названа в этом дереве и какие
+экраны считаются сводками — в `implementation.md` рядом.
+
+## Как это называется здесь
+
+| В законе                           | Здесь                                                                           |
+| ---------------------------------- | ------------------------------------------------------------------------------- |
+| владеющая сущность                 | запись своего домена; в запросах — поле `<сущность>_id`                         |
+| пустой идентификатор               | пустая строка, а не отсутствующее поле: необязательных скаляров в контракте нет |
+| сводка                             | списки и статистика, отвечающие сразу по всем действующим                       |
+| отказ при двух и более действующих | `Code.InvalidArgument`                                                          |
+| отказ, когда действующих нет вовсе | `Code.FailedPrecondition`                                                       |
+| ненайденный явный идентификатор    | `Code.NotFound`                                                                 |
+
+У списков, переведённых на общую выборку, идентификатор отдельным полем запроса не приходит
+вовсе: это условие отбора в модели фильтра, а прежний номер поля помечен `reserved`.
+
+## Где это лежит
+
+В этом дереве — таблица в `implementation.md` рядом. Пути живут там, а не здесь: правило
+переносится между репозиториями, раскладка — нет, и путь, названный в правиле, врёт в первом
+же дереве, которое держит код иначе.
+
+## Как закон применяется здесь
+
+- **Запись принадлежит владеющей сущности, а не системе.** Общих настроек, действующих сразу
+  на все, нет: заведение второй не меняет поведение первой.
+- **Пустой идентификатор означает единственную действующую.** Пока она одна, клиент вправе её
+  не называть.
+- **При двух и более действующих запрос обязан назвать сущность.** Умолчание перестаёт быть
+  однозначным, и запрос отбивается как неверный.
+- **Названная явно находится, даже если она скрыта.** У скрытой остаются записи, деньги и
+  переписка.
+- **Там, где показана сводка, пустой идентификатор означает все действующие.** Списки и
+  статистика отвечают по всему набору, а не требуют сперва выбрать одну.
+- **Когда действующих нет вовсе, запрос отбивается.** Скрытая вместо отсутствующей действующей
+  не подставляется.
+
+## Паттерны
+
+- `ownership-scope-resolve` — разрешение сущности в процедуре и обе формы умолчания.
+
+## Ловушки
+
+- **Разрешение разложено на две части намеренно:** чистая функция разбирает случай, обёртка
+  ходит в хранилище и переводит случай в отказ. Вторая реализация того же правила однажды уже
+  жила у обработчика статистики соседнего домена и успела разойтись порядком выборки.
+- **Отсутствие действующей сущности и ненайденный явный идентификатор — разные случаи для
+  вызывающего:** первое отвечает `FailedPrecondition`, второе — `NotFound`.
+- Таблица владеющих сущностей читается целиком одним запросом — она маленькая, и выборки ей не
+  нужно.
+- Выбор сущности стоит в шапке и действует на разделы, которые говорят об одной. Снаружи выбора
+  нет: пользователь приходит на страницу конкретной.

package/assets/rules/permissions.md

@@ -0,0 +1,70 @@
+---
+name: permissions
+kind: rule
+law: access
+description: Правило под «Закон о доступе». Брать при заведении или правке процедуры Connect, перехватчика входа, гварда маршрута админки и декларации меню. Называет четыре вида доступа, декораторы, сложение пресета с оверрайдами и гейтинг разделов админки. Готовый код — в паттерне permissions-procedure.
+---
+
+# Доступ — как это устроено здесь
+
+Правило под закон `docs/constitution/application/access.md`. Закон говорит, что должно быть верно;
+здесь — чем это названо в этом дереве и где лежит. Устройство самих разделов админки —
+`navigation`.
+
+## Как это называется здесь
+
+| В законе           | Здесь                                                                                                                                                                   |
+| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| право              | пара «ресурс и действие» строкой: `bookings:manage`, `chat:manage`                                                                                                      |
+| объявление доступа | декоратор на классе процедуры: `@RequiresPermission('bookings:manage')`, `@RequiresAuth('причина')`, `@PublicProcedure('причина')`, `@OptionalAuthProcedure('причина')` |
+| пресет             | именованный набор прав, выдаваемый пользователю целиком                                                                                                                 |
+| оверрайд           | точечная правка права поверх пресета для одного пользователя                                                                                                            |
+| отбивка без входа  | `Code.Unauthenticated`                                                                                                                                                  |
+| отбивка без права  | `Code.PermissionDenied`                                                                                                                                                 |
+
+## Где это лежит
+
+В этом дереве — таблица в `implementation.md` рядом. Пути живут там, а не здесь: правило
+переносится между репозиториями, раскладка — нет, и путь, названный в правиле, врёт в первом
+же дереве, которое держит код иначе.
+
+## Как закон применяется здесь
+
+- **Каждая процедура объявляет свой доступ декоратором, и объявление ровно одно.**
+  Процедура без объявления или с двумя объявлениями не даёт приложению подняться.
+- **Видов доступа четыре: по праву, любому вошедшему, публично и публично с чтением входа.**
+  Последний отдаёт вошедшему больше, чем гостю, — так владелец видит скрытые объекты в общем
+  списке.
+- **Права пользователя — это права пресета, поверх которых применены его оверрайды.**
+- **Запрос без входа отбивается как неаутентифицированный, а вход без права — как отказ в
+  доступе.** Это разные ответы: первый лечится входом, второй — нет.
+- **Право проверяется перехватчиком до тела процедуры.** Обработчик не решает, пускать ли
+  вызывающего.
+- **Публичность объявляется с причиной.** Причина — аргумент декоратора, записанный для
+  читателя кода; ни в ответ, ни в лог она не уходит.
+- **Пункт меню и адрес раздела закрыты по одной декларации.** Иначе скрытый пункт закрывает
+  раздел лишь на вид: адрес открывается по прямой ссылке.
+- **Пока права не получены, админка ничего не прячет.** Пустая шапка после сетевого сбоя
+  выглядит как сломанная админка и не оставляет выхода.
+
+## Чего из закона здесь нет
+
+Право, отобранное посреди сессии, до перевхода не действует: токен живёт со своими правами до
+истечения — это `Q-A-1` в законе. Смены пароля из интерфейса нет вовсе: ни экрана, ни
+процедуры, ни восстановления забытого — `Q-A-2`.
+
+## Паттерны
+
+- `permissions-procedure` — объявление доступа у процедуры и гейтинг раздела админки.
+
+## Ловушки
+
+- **Процедура, о которой перехватчик ничего не знает, отбивается как отказ в доступе, а не
+  пропускается.**
+- **Гвард стоит на дочерних маршрутах защищённой группы, а не на самой группе:** гвард группы
+  отрабатывает один раз за загрузку страницы и переходов между разделами не видит.
+- **Права приходят ответом профиля уже внутри защищённой группы**, поэтому гвард дожидается
+  запуска админки. Отказ запроса ожидание не роняет: с неизвестными правами не закрывается
+  ничего.
+- Декораторы живут в `util` домена аутентификации, а не рядом с перехватчиком: их ставит
+  каждый домен с процедурами, и ребро к объявлениям дешевле ребра к секрету и базе.

package/assets/rules/platform-access.md

@@ -0,0 +1,77 @@
+---
+name: platform-access
+kind: rule
+law: frontend-application
+description: Правило под «Закон о фронтовом приложении». Брать, когда правка задевает глобальный объект или среду исполнения — window, globalThis, PLATFORM_ID, isPlatformBrowser, document.defaultView, localStorage, IntersectionObserver. Называет токены DI, приведение типа и подводные камни отдачи страницы сервером. Не действует под libs/api и apps/api. Готовый код — в паттерне platform-access-di.
+---
+
+# Окружение браузера — как это устроено здесь
+
+Правило под закон `docs/constitution/frontend-application.md`. Закон говорит, что должно быть
+верно; здесь — чем в этом дереве заменяется прямое обращение к глобальному объекту. Состояние
+— `angular-patterns`, файл компонента — `component-structure`, стили — `styling-bem`, слой
+обращения к серверу — `api-layer`. Все пять под одним законом.
+
+Правило про фронт: `libs/api/**` и `apps/api/**` — это NestJS, там своя среда, и ничего из
+перечисленного не применяется.
+
+## Как это называется здесь
+
+| Прямое обращение                         | Здесь                                              |
+| ---------------------------------------- | -------------------------------------------------- |
+| `globalThis.open(...)`, `window.open()`  | `inject(WINDOW).open(...)`                         |
+| `globalThis.crypto.randomUUID()`         | `inject(WINDOW).crypto.randomUUID()`               |
+| `isPlatformBrowser(inject(PLATFORM_ID))` | `inject(PlatformService).isPlatformBrowser`        |
+| `document.defaultView`                   | `inject(WINDOW)`                                   |
+| прямой `document`                        | `inject(DOCUMENT)` из `@angular/common` — как было |
+| инициализация DOM после отрисовки        | `afterNextRender()`                                |
+
+`WINDOW`, `PlatformService` и `StorageService` приходят из `@rt-tools/core`.
+
+## Где это лежит
+
+В этом дереве — таблица в `implementation.md` рядом. Пути живут там, а не здесь: правило
+переносится между репозиториями, раскладка — нет, и путь, названный в правиле, врёт в первом
+же дереве, которое держит код иначе.
+
+## Как закон применяется здесь
+
+- **Глобальный объект приходит токеном `WINDOW`, а не берётся напрямую.** Тип уточняется
+  приведением к `Window & typeof globalThis`: конструкторы вроде `IntersectionObserver`
+  объявлены на глобальном объекте, а не на интерфейсе `Window`.
+- **Среда проверяется через `PlatformService`, а не через `typeof window`.** Проверка по
+  наличию глобала верна случайно и ломается на первой же среде, где глобал подставлен.
+- **Прямое обращение к глобальному объекту отбивает линтер.** Шестнадцать имён окружения
+  браузера запрещены на фронтовых деревьях; три места, где прямой доступ осознан, выведены
+  из-под запрета списком в конфиге, а не отключением в строке.
+
+## Чего из закона здесь нет
+
+Запрет действует на имена, а не на пути к ним: `this.#document.defaultView` линтер пропускает,
+потому что глобального имени в такой строке нет. Такое обращение законно — окно там уже пришло
+внедрением, — но и настоящий обход выглядел бы так же, и увидеть его можно только чтением.
+
+Прямой доступ остаётся в трёх местах, и это осознанно: встроенный скрипт против мелькания темы
+в `apps/site/src/index.html` (работает до подъёма приложения), обработчик отказа подъёма в
+`apps/*/src/main.ts`, и код внутри `page.evaluate` в сквозных спеках — он исполняется в
+странице, вне DI. Новое место в этот список не добавляется без явного согласования владельца.
+
+## Паттерны
+
+- `platform-access-di` — готовые инжекты, приведение типа, чистые функции, проверка среды.
+
+## Ловушки
+
+- **Фабрика токена бросает `Window is not available`, если у документа нет `defaultView`.**
+  Под отдачей страницы сервером `defaultView` есть, и инжект полем класса в root-сервисе
+  безопасен, но сервис, обязанный работать без DOM вообще, берёт окно внутри метода под
+  проверкой среды.
+- **После правки, добавляющей `WINDOW` в сервис, который создаётся на подъёме, нужна не только
+  сборка, но и поднятый сервер отдачи страниц.** Сайт — настоящий SSR, и падение видно только
+  там.
+- **Вокруг хранилища проверка среды не нужна:** `StorageService` и так уходит в память вне
+  браузера, и лишний `if (!isBrowser)` вокруг чтения и записи — мёртвый код.
+- **В `*.logic.ts` и `*.util.ts` нет DI:** окно принимается параметром, а инжектит его
+  вызывающий компонент.
+- **Подготавливать состояние сквозной спеки записью в хранилище нельзя:** спека проходит те же
+  шаги, что и пользователь.

package/assets/rules/pricing.md

@@ -0,0 +1,64 @@
+---
+name: pricing
+kind: rule
+law: money
+description: Правило под «Закон о деньгах». Брать при правке расчёта цены, скидок, курсов валют, сумм в заказах, письмах и сводках. Называет хранение в целых единицах валюты хранения, единственное округление, выбор одной наибольшей скидки и справочный пересчёт. Готовый код — в паттерне pricing-quote. Чем это названо здесь — в implementation.md рядом.
+---
+
+# Суммы — как это устроено здесь
+
+Правило под закон `docs/constitution/application/money.md`. Закон говорит, что должно быть
+верно; здесь — каким приёмом это держится. Валюта хранения, набор справочных валют и имена
+колонок — при этом дереве, в `implementation.md` рядом.
+
+## Как это называется здесь
+
+| В законе      | Здесь                                                                                          |
+| ------------- | ---------------------------------------------------------------------------------------------- |
+| сумма         | целое число единиц валюты хранения; код валюты стоит в имени поля — `total<Код>`, `price<Код>` |
+| валюта показа | поле заказа с кодом валюты, в которой пользователь смотрел цену                                |
+| расчёт цены   | одна чистая функция: на входе — что заказано, на выходе — подытог, скидка и итог               |
+| скидка        | механики перечислены в `implementation.md`; правило про выбор одно на все                      |
+| курс          | кэш в хранилище, обновляется по расписанию                                                     |
+
+## Где это лежит
+
+В этом дереве — таблица в `implementation.md` рядом. Пути живут там, а не здесь: правило
+переносится между репозиториями, раскладка — нет, и путь, названный в правиле, врёт в первом
+же дереве, которое держит код иначе.
+
+## Как закон применяется здесь
+
+- **Сумма хранится в целых единицах валюты хранения.** Дробная часть даёт расхождение между
+  подытогом и итогом: показанное построчно перестаёт складываться в показанное внизу. Если
+  дробная часть в предметной области значима, единицей хранения становится она сама.
+- **Код валюты стоит в имени поля, а не подразумевается.** Поле `total` без кода читается как
+  «сумма вообще», и первый же пересчёт кладёт в него чужую валюту.
+- **Округление происходит один раз — при расчёте цены.** Сумма на экране, сумма в письме и
+  сумма в хранилище — одно и то же число, а не три результата одного пересчёта.
+- **Из подходящих скидок применяется одна — наибольшая.** Сравниваются они в валюте хранения:
+  доля и сумма иначе несравнимы.
+- **При равной выгоде побеждает та скидка, которую пользователь ввёл руками.** Он ждёт
+  подтверждения своему действию, а «код не сработал» при той же итоговой цене читается как
+  поломка.
+- **Скидка суммой ограничена подытогом.** Иначе она увела бы цену ниже нуля.
+- **Пересчёт в чужую валюту не хранится.** В заказе лежат сумма в валюте хранения и код валюты
+  показа; само число вычисляется на показ.
+- **Оплата идёт в валюте хранения, остальные валюты — справка.** Ни подтверждение, ни документ
+  не называют справочное число суммой к оплате.
+- **Валюта показа следует за пользователем.** Он выбрал её на экране — в письме сумма
+  пересчитана в неё же.
+- **Курс недоступен — сумма показывается в валюте хранения без пересчёта.** Пересчёт по
+  неизвестно какому курсу хуже отсутствующего: отсутствие видно, а неверный курс — нет.
+
+## Паттерны
+
+- `pricing-quote` — расчёт цены, выбор скидки, работа с курсом.
+
+## Ловушки
+
+- **Курс тянется по расписанию и кэшируется.** Само число в чужой валюте нигде не сохраняется.
+- **Дробная сумма в контракте — признак того, что округление уехало на показ.** Округление
+  одно, и живёт оно в расчёте.
+- **Справочная сумма рядом с суммой к оплате читается как цена.** В письме и в документе
+  справочное число подписывается как справка.

package/assets/rules/reuse-first.md

@@ -0,0 +1,83 @@
+---
+name: reuse-first
+kind: rule
+law: reuse-first
+description: Правило под «Закон о единообразии приложения». Брать перед заведением любого нового экрана, компонента, поля, стора, сервиса, маппера или процедуры — на что опираться, что уже готово в ките и базовых классах, по каким признакам видно, что готовое обошли. Что делать, когда готового не хватило, — в паттерне reuse-first-extend.
+---
+
+# Единообразие — как это устроено здесь
+
+Правило под закон `docs/constitution/reuse-first.md`. Закон говорит, что одинаковые вещи ведут
+себя одинаково; здесь — на чём это стоит в этом дереве и чем названо.
+
+## Как это называется здесь
+
+| В законе                         | Здесь                                                                                                                                                      |
+| -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| готовое                          | компоненты кита `@rt-tools/ui-kit-v2` с префиксом `rt-` — сегодня их больше семидесяти — и базовые классы без селектора, наследуемые в `@Component` экрана |
+| раскладка страниц, форм и окон   | `apps/<app>/src/styles/`, применяется директивами BEM                                                                                                      |
+| оформление части приложения      | файл `.scss` рядом с компонентом                                                                                                                           |
+| отступление, решённое владельцем | маркер `native-ok` в той же строке с объяснением                                                                                                           |
+
+## Где это лежит
+
+В этом дереве — таблица в `implementation.md` рядом. Пути живут там, а не здесь: правило
+переносится между репозиториями, раскладка — нет, и путь, названный в правиле, врёт в первом
+же дереве, которое держит код иначе.
+
+## Как закон применяется здесь
+
+- **Работа начинается с чтения готового, а не с чистого файла.** Сначала находится опора —
+  компонент кита, базовый класс, образец в соседнем домене, — потом пишется своё поверх неё.
+- **Свой примитив и своя основа заводятся только с явного одобрения владельца.** Спрашивается
+  это до того, как написан первый файл.
+- **Панель правки записи наследует общую основу, а не собирается своей разметкой.** Тогда она
+  открывается, закрывается и спрашивает про несохранённое одинаково во всех разделах.
+- **Об удаче и об отказе сообщает общая шина, а не своя разметка на экране.** Своё сообщение
+  расходится с соседним видом, местом и временем показа.
+- **Компонент объявляется тремя файлами: `.ts`, `.html`, `.scss`.** `template:` и `styles:` в
+  декораторе, атрибут `style=` и правка размеров через `[ngStyle]` — это стили, до которых не
+  дотянется ни кит, ни `stylelint`.
+- **У компонента экрана вне кита файл стилей по умолчанию пустой.** Раскладка объявлена один
+  раз в общем слое приложения, а экран её только применяет теми же директивами BEM.
+- **Готовое расширяется, а не клонируется рядом.** Недостающий вариант заводится в ките или в
+  базовом классе, и его видят остальные экраны.
+- **Накопленное до гарда сосчитано сплошной проверкой и в список только не растёт.** Признаки
+  у неё те же, что у гарда, а смотрит она файл целиком: гейт падает на новом месте, старое
+  остаётся числом в сводке.
+
+## Чего из закона здесь нет
+
+Одинаковый ответ поля ввода на ошибку держит кит: `RtFormControlBase` в этом дереве не
+наследует никто, потому что поля берутся его готовыми компонентами. Привязать эту статью
+закона здесь не к чему.
+
+Инлайновый шаблон стоит у одного компонента, и у него же единственный `styles:` — это шапка
+админки. `role="alert"` написан руками в шестнадцати шаблонах, а `rt-message` зовёт один
+потребитель. Это долг, а не разрешённое отступление.
+
+## Паттерны
+
+- `reuse-first-extend` — что делать, когда готового не хватило: расширить кит, объявить
+  отступление маркером, снять его.
+
+## Признаки, по которым видно, что готовое обошли
+
+- в шаблоне фичи стоит нативный `<input>`, `<button>`, `<select>`, `<table>` или `<dialog>`;
+- отказ или предупреждение собраны руками — свой `role="alert"` вместо `rt-message`;
+- в `.scss` фичи появились `position: fixed` на весь экран, свой backdrop, `z-index` от тысячи,
+  `@keyframes` вращения или мерцания;
+- в файле стилей экрана объявлена раскладка — `display: flex` с `gap` и `padding` на `:host`;
+- компонент реализует `ControlValueAccessor` сам, а не наследует `RtFormControlBase`;
+- имя файла кончается на `-button`, `-input`, `-dialog`, `-spinner` или `-table` вне
+  кита;
+- маппер переводит поля вручную, без `BaseMapper`;
+- процедура бэкенда объявлена без `@ConnectProcedure()`.
+
+## Ловушки
+
+- Перенос переизобретением не считается: строку, которая уже лежит в файле, гард из
+  проверяемого текста вычёркивает, а сверка идёт без отступов — при переезде блок меняет
+  отступ, оставаясь тем же кодом.
+- Ответ, данный до чтения образца, образец отменяет: согласованная форма выборки списка
+  переигрывалась вместе с контрактом через два вопроса после того, как была принята.

package/assets/rules/seo.md

@@ -0,0 +1,71 @@
+---
+name: seo
+kind: rule
+law: search-visibility
+description: Правило под «Закон о видимости в поиске». Брать при любой правке, доходящей до разметки публичного сайта — шаблоны страниц, meta/title/description, JSON-LD, canonical, hreflang, маршруты сайта, sitemap, robots, nginx. Называет восемь локалей, где что лежит и чего у нас нет. Готовый код — в паттернах seo-page и seo-verify.
+---
+
+# Видимость в поиске — как это устроено здесь
+
+Правило под закон `docs/constitution/application/search-visibility.md`. Закон говорит, что должно быть
+верно; здесь — чем это названо в этом коде, где лежит и что из закона у нас не применяется.
+
+## Как это называется здесь
+
+| В законе                     | Здесь                                                                        |
+| ---------------------------- | ---------------------------------------------------------------------------- |
+| язык страницы                | локаль; их восемь — `en`, `ru`, `de`, `zh-Hans`, `zh-Hant`, `ko`, `th`, `hi` |
+| язык по умолчанию            | `DEFAULT_LOCALE`, то есть `en`; отдаётся из корня, без префикса в адресе     |
+| язык, перевод которого готов | `readyLocales` — поле объекта, а не список локалей сайта                     |
+| канонический адрес           | `${SITE_ORIGIN}${propertyPath(slug, locale)}`                                |
+| структурированные данные     | JSON-LD типа `LodgingBusiness`                                               |
+| прежний адрес страницы       | прежний slug объекта                                                         |
+
+Локаль по умолчанию отдаётся из корня, остальные — с префиксом `/<код>/`. Префикс — часть
+маршрута, а не часть сборки: `<base href>` в разметке всегда `/`.
+
+## Где это лежит
+
+В этом дереве — таблица в `implementation.md` рядом. Пути живут там, а не здесь: правило
+переносится между репозиториями, раскладка — нет, и путь, названный в правиле, врёт в первом
+же дереве, которое держит код иначе.
+
+## Как закон применяется здесь
+
+- **Свои теги помечены атрибутом `data-<префикс>-seo`** и при повторном применении переписываются.
+  Чужое в `<head>` не трогается: после гидратации там остаются теги от отдачи сервером.
+- **`canonical` ведёт на локализованный путь** `${SITE_ORIGIN}${propertyPath(slug, locale)}`,
+  а не на корень и не на адрес локали по умолчанию.
+- **`hreflang` строится по `readyLocales`**, плюс `x-default` на локаль по умолчанию. Список
+  локалей сайта для этого не годится: переводы контента заполняет бэк, и готовы они не всегда.
+- **`og:locale:alternate` не включает локаль самой страницы** — иначе она объявлена и
+  основной, и альтернативной сразу.
+- **`url` в JSON-LD — канонический адрес страницы объекта**, не корень сайта.
+- **Корень локали отдаёт страницу единственного объекта** с каноническим адресом на `/{slug}`;
+  посетителя уводит туда nginx ответом 302.
+- **Перенаправление с прежнего адреса отдаётся с `Cache-Control: max-age`** и покрыто
+  `proxy_cache_valid 200 301`. Ключ кэша строится без `$args`, поэтому запросы со строкой
+  запроса идут мимо кэша (`proxy_cache_bypass` / `proxy_no_cache $is_args`).
+
+## Чего из закона здесь нет
+
+Листинга объектов нет — корень локали отдаёт единственный объект. Появится листинг —
+канонический адрес корня пересматривается; это `Q-SV-1` в законе.
+
+## Паттерны
+
+- `seo-page` — правка разметки страницы: теги, JSON-LD, новый маршрут, новая страница в карте.
+- `seo-verify` — проверка отданной разметки на прод-сборке.
+
+## Ловушки
+
+- Тег, добавленный мимо `PropertySeoService`, не помечен `data-<префикс>-seo` — он не будет ни
+  переписан, ни удалён при следующем применении и переживёт переход между страницами.
+- Новый маршрут сайта без ветки в `app.routes.ts` под каждую локаль существует только в
+  локали по умолчанию: `/de/<путь>` отдаст 404 и поисковику, и гостю.
+- Новая страница не попадает в `sitemap.xml` сама — карта строится из объектов, а не из
+  маршрутов.
+- Адрес режется по **первому** `?` и только им: `req.url.split('?')` теряет всё после второго
+  знака, и перенаправление приходит на страницу без UTM-хвоста — источник заявки считается
+  неверно. Разрез живёт в `splitRequestUrl`
+  (слой `util` домена страницы объекта) и покрыт спеками; свой не заводить.

package/assets/rules/shared-code.md

@@ -0,0 +1,70 @@
+---
+name: shared-code
+kind: rule
+law: shared-code
+description: Правило под «Закон об общем коде приложений». Брать, когда значение должно одинаково пониматься сайтом, админкой и бэкендом — предел выборки, набор операторов условия, направление порядка, длина поля, форма запроса и ответа списка. Называет, что берётся из @rt-tools/utils, что из @<область>/common/util и что ловит check:dupes. Готовый код — в паттерне shared-code-new.
+---
+
+# Общий код — как это устроено здесь
+
+Правило под закон `docs/constitution/shared-code.md`. Закон говорит, что общим быть обязано;
+здесь — откуда это берётся в этом дереве, чем названо и чего у нас нет.
+
+## Как это называется здесь
+
+| В законе                  | Здесь                                                                                         |
+| ------------------------- | --------------------------------------------------------------------------------------------- |
+| общий пакет               | `@rt-tools/utils` — собран без фреймворка, зависит от одного `tslib`, грузится под голым Node |
+| общая либа проекта        | `@<область>/common/util`; её тег входит в набор `UNIVERSAL` и виден всем трём приложениям     |
+| число-настройка           | `DEFAULT_PAGE_SIZE`, `MAX_PAGE_SIZE`                                                          |
+| набор значений            | `FILTER_OPERATOR_TYPE_ENUM`, `LIST_SORT_ORDER_ENUM`                                           |
+| сверка значения с набором | `listSortOrderOf`, `listFilterOperatorOf`                                                     |
+| выборка списка            | `IPageModel`, `ISortModel`, `IFilterModel`, `IListState`                                      |
+
+## Где это лежит
+
+В этом дереве — таблица в `implementation.md` рядом. Пути живут там, а не здесь: правило
+переносится между репозиториями, раскладка — нет, и путь, названный в правиле, врёт в первом
+же дереве, которое держит код иначе.
+
+## Как закон применяется здесь
+
+- **Число-настройка лежит в `libs/common/util` и оттуда берётся обеими сторонами.** Умолчание
+  доводом не передаётся: пока довод есть, домен вправе назвать своё число, и у промокодов так
+  появилось `25` против `20` у остальных.
+- **Набор значений из `@rt-tools/utils` заново не объявляется.** Своё перечисление с теми же
+  членами считается копией, даже если имена разошлись.
+- **Значение из набора сверяется парой общих функций, а промах разбирает вызывающий.** Сервер
+  отбивает запрос `InvalidArgument`, экран берёт умолчание.
+- **Общим стал только маппер страницы.** У сторон разная политика на непонятное значение, и
+  общим может быть лишь то, где она одна: номер меньше единицы обе стороны читают как первую
+  страницу.
+- **Перечисления полей порядка и отбора домена копией не считаются.** `EActivitySortProperty`
+  и подобные повторяют имена, по которым сортирует сервер именно этого домена.
+- **Строковая настройка и таблица соответствий сверяются по значению, а не по имени.** Имя
+  здесь не ключ: `BEM_BLOCK` и `LOG_CONTEXT` объявлены десятками, и значения у них свои, а
+  один и тот же перевод статуса живёт под тремя разными именами.
+
+## Чего из закона здесь нет
+
+Перевод сущности устроен по-разному: фронт переводит наследником `BaseMapper`, бэкенд —
+свободными функциями `xxxToProto` без общей основы. Это долг `Q-S-1`, а не выбор: новый код на
+бэкенде общей основы не заводит, но и своей второй не пишет.
+
+Найденные совпадения строк и таблиц приняты долгом целиком: перевод статуса брони в контракт
+лежит тремя копиями, набор принимаемых вложений — двумя, имя события правки — тремя.
+Сокращать это — работа по доменам, и она заведена вопросом `Q-S-3`.
+
+## Паттерны
+
+- `shared-code-new` — как завести новое общее число, функцию или тип и не оставить копию.
+
+## Ловушки
+
+- `typeCast.getAsType` для сверки с набором не годится: значение вне набора он пишет в консоль
+  и возвращает строкой `'unknown'`.
+- Накопленные повторы лежат в `tools/dupes-allowlist.json` под ключом `debt` и отказом не
+  считаются — гейт падает только на новом. Список только сокращается.
+- Ту же логику, написанную заново под другим именем, проверка не ловит, и такой проверки не
+  будет: две одинаковые по форме проверки из разных доменов копией не считаются. Заметить это
+  может только тот, кто читает правку, — так сказано и в законе.