--- name: onec-code-review-and-standards description: "Проводит двухпроходное ревью кода 1С (BSL, запросы, формы, метаданные, расширения) по стандартам разработки 1С и двухступенчатую самопроверку перед сдачей изменений. Используй для аудита модулей и diff-изменений с отсевом ложных замечаний по модели EDT и проверки готовности доработки." --- # Двухпроходное ревью кода 1С и предкоммитный контроль качества Используй навык, когда пользователь просит провести ревью модуля, запроса, расширения или набора изменений (PR / MR / diff), а также как финальный контур самопроверки перед сдачей собственной доработки 1С. ## Проход 1 (Аудитор) → Проход 2 (Критик по модели EDT) Никогда не выдавай список замечаний по первому впечатлению от изолированного фрагмента текста. Работай строго в два прохода: 1. **Проход Аудитора** — собери кандидатов в дефекты по приоритету: искажение учёта и данных → гонки и транзакции → права и безопасность → производительность (`N+1`, тяжёлые запросы, клиент-сервер) → совместимость с веб-клиентом и расширениями → стандарты оформления модулей. 2. **Проход Критика (самофальсификация через `edt-mcp`)** — перед включением любого замечания в отчёт попытайся **опровергнуть его фактами проекта**: - Прежде чем писать «нет `РАЗРЕШЕННЫЕ`», проверь свойства общего модуля: если модуль `Привилегированный` или вызывается внутри системного пересчёта с намеренным полным охватом, `РАЗРЕШЕННЫЕ` там было бы ошибкой! - Прежде чем писать «запрос или серверный вызов в цикле», проверь источник коллекции: обход фиксированного перечня из 2–3 видов учёта и обход табличной части товаров документа на 1 000 строк имеют разную критичность; проверь также, не является ли вызываемый общий модуль кэшируемым (`ПовтИсп`). - Прежде чем объявлять реквизит несуществующим или метод неиспользуемым, проверь базовую конфигурацию **вместе с проектами расширений**, определяемыми типами и подписками на события в `edt-mcp`. Отбрасывай неподтверждённые догадки и вкусовщину; оставляй только верифицированные замечания с точной строкой, объяснением последствия и конкретным вариантом исправления. ## Ключевые измерения стандартов разработки 1С ### 1. Распределение логики и директивы компиляции - Прикладные расчёты, проверки инвариантов и запись данных размещаются в **модуле объекта, модуле менеджера или серверном общем модуле**, а не в модуле управляемой формы. - В модуле формы предпочитай `&НаСервереБезКонтекста` (или вызов серверного общего модуля с флагом `ВызовСервера`), передавая только нужные примитивы и ссылки; контекстный `&НаСервере` оставляй только там, где реально меняется дерево элементов или реквизит `Объект` формы. - Обращение к базе данных, объектным типам (`ДокументОбъект`, `СправочникОбъект`) и запросам в процедурах `&НаКлиенте` недопустимо. ### 2. Современный асинхронный клиент вместо модальных вызовов - Устаревшие синхронные методы `Вопрос()`, `Предупреждение()`, `ВвестиСтроку()`, `ВвестиЧисло()`, `ОткрытьФормуМодально()` блокируют поток браузера и запрещены в современном управляемом и веб-клиенте. - На платформе **8.3.18+** предпочтителен линейный стиль **`Асинх` / `Ждать`** (`ВопросАсинх`, `ПредупреждениеАсинх`, `ОткрытьФормуАсинх`); на более ранних режимах совместимости — неблокирующие методы `ПоказатьВопрос` / `ОткрытьФорму` с `ОписаниеОповещения` (сверь режим совместимости конфигурации в `get_configuration_properties`!). Не ставь `Асинх` на серверные процедуры. ### 3. Структура модуля, именование, локализация и обработка исключений - Соблюдай стандартный порядок областей `#Область ... #КонецОбласти` (в общих и объектных модулях: `ПрограммныйИнтерфейс` → `СлужебныйПрограммныйИнтерфейс` → `ОбработчикиСобытий` → `СлужебныеПроцедурыИФункции`; в модулях форм: события формы → события элементов шапки → события таблиц → команды формы → служебные процедуры). - Заменяй «магические» коды, строки статусов и зашитые УИД на **перечисления**, **предопределённые элементы** и **константы**. Избегай `Выполнить()` и `Вычислить()` на динамических строках. - Все выводимые пользователю сообщения и заголовки оборачивай в **`НСтр(...)`** на языках конфигурации. - **Пустой блок `Исключение ... КонецПопытки` запрещён**: при перехвате сбоя откати открытую транзакцию (`Если ТранзакцияАктивна() Тогда ОтменитьТранзакцию()`), запиши техническую деталь через `ЗаписьЖурналаРегистрации(..., ПодробноеПредставлениеОшибки(ИнформацияОбОшибке()))` и верни пользователю понятный предметный отказ без SQL и внутренних путей. ## Двухэтапная проверка перед сдачей доработки (Статика + Проба ИБ) Не ограничивай самопроверку одним чтением собственного диффа: 1. **Этап 1 — Быстрая статика в `edt-mcp` (без запуска 1С)**: перечитай изменённые методы и метаданные, прогони `validate_query` для всех затронутых запросов/СКД и `get_project_errors` для изменённых объектов базового проекта и расширения. 2. **Этап 2 — Динамическая проба в тестовой копии ИБ (`vanessa-runner`)**: статика не ловит ошибки обновления таблиц СУБД, конфликт применения расширения `.cfe`, отсутствие прав у рабочей роли и ошибку типа в табличной части формы. Загрузи изменения в копию базы, обнови конфигурацию БД и выполни целевой сценарий под рабочей ролью (а не только под «Полными правами»).