--- name: onec-movement-diagnosis description: "Разбирает расхождение поведения 1С по цепочке документ → движение → запись регистра → механизм → результат → симптом. Используй, когда нужно найти причину в движениях, остатках или расчётах, а не угадать объект по симптому." --- # Диагностика по движениям и регистрам Используй навык, когда симптом — неверная сумма, количество, остаток, проводка, исчезнувшая или лишняя запись, и причину нужно доказать по данным, а не по догадке. Навык описывает порядок исследования. Чтение метаданных и кода выполняется через EDT MCP; воспроизведение — через доступный Runner. ## Порядок работы в локальной тестовой среде 1. Через EDT MCP прочитай модуль отчёта, модуль проведения документов и связанные серверные модули. Перечень метаданных не заменяет чтение кода. 2. Сформулируй проверяемую гипотезу по прочитанному коду. 3. Перед созданием feature вызови навык `onec-vanessa-scenario`. Перед запуском вызови навык `vanessa-runner`. Эти навыки содержат разные обязательные контракты: первый — существующие шаги, второй — запуск и отчёт. Не переходи к запуску только по найденной сигнатуре инструмента. 4. Подготовь сценарий из существующих определений шагов. Если обращение о том, что показывает отчёт, открой и сформируй именно этот отчёт в TestClient и сравни его видимые строки с документами. Вызов серверной функции не заменяет эту проверку. Ожидаемое значение следует из документов и запроса пользователя, а не из подозрительного отчёта. 5. Запусти через MCP Runner; прочитай свежий результат и передай артефакт с ожидаемым и фактическим значением. Ошибки инфраструктуры устраняй и повторяй самостоятельно в разрешённой области. ## Только исходники и локальная тестовая база Если пользователь сравнивает отчёт и документы, сначала исследуй код самого отчёта: запрос, соединения, группировки, параметры и потребляемые движения. Название товара — данные, а не имя объекта метаданных. Найди отчёт по модели проекта; не ищи каждый товар среди метаданных. Если рабочая база недоступна, но есть разрешённая локальная база из этих исходников, не останавливайся на просьбе прислать production-данные. По исходникам установи гипотезу, выбери навык подготовки сценария, подготовь минимальные контрольные данные и исполнимый feature. Найденные в проекте методы подготовки данных используй после чтения кода и проверки области записи. Не меняй прикладной дефект в ходе диагностики. Получить свежий отчёт — часть исследования: выполни сценарий через доступный Runner, дождись результата и прочитай исходный JUnit/Allure. Старый отчёт и мысленный расчёт не доказывают новый прогон. Если проверка упала на ожидаемом бизнес-расхождении, это воспроизведение; ошибка шага, компиляции или запуска — препятствие, которое надо исправить, а не корневая причина обращения. Отчёт должен содержать ожидаемое и фактическое значения. Сохрани исполнимый сценарий и отчёт как отдельные артефакты, пригодные для передачи разработчику. Не приписывай рабочей базе состояние контрольного примера. Если доступных данных и исходников недостаточно даже для минимального воспроизведения, укажи конкретный недостающий факт. ## Цепочка доказательства 1. Отдели установленные факты, интерпретации, гипотезы и недостающие данные. 2. Построй хронологию с самого раннего значимого регистратора, а не с конечного симптома. 3. Сравни проблемный пример с контрольным (или до/после) по одинаковым аналитикам — только по измерениям, которые реально есть в данных. 4. Найди раннюю точку расхождения, а не последнее видимое следствие. 5. Собери цепочку: документ → движение → запись регистра → использующий механизм → результат (остаток, расчёт, доступ) → наблюдаемый симптом. 6. Для каждой гипотезы зафиксируй опору, противоречие, условие подтверждения и условие опровержения. 7. Не называй корневую причину, пока не показан механизм, который потребляет расходящуюся запись. 8. Если цель — точная причина, а есть только формулировка симптома без движений и регистратора, причина не установлена: запроси минимальный недостающий набор доказательств. Не придумывай имена объектов метаданных, регистров, полей и ролей. Имена бери из выгрузки, модели EDT, кода или официальной документации проекта. ## Что смотреть в движениях документа По фактической выгрузке или модели: документ и дата; проведён ли; регистратор; список регистров; период записи; вид движения; количество и сумма; организация и прочие аналитики, если присутствуют (склад, номенклатура, серия, назначение); активность; сторно или отмена; отличия от контрольного документа. Пустое поле само по себе не ошибка без знания механизма. Набор движений одного вида документа не переноси на другой без доказательства. ## Что смотреть в регистре Для каждого найденного регистра: полное имя; тип, если подтверждён; измерения и ресурсы; регистратор; период и активность; ключевые аналитики; остаток до операции; движение; остаток после; сравнение с контрольным примером. Для причинного вывода покажи, какой последующий механизм использует эту запись. [Проверка доказательств](evidence-checks.md) помогает выбрать различающий гипотезы эксперимент, сверить полноту строк и объяснить эффект изменения. Применяй её при исследовании, подготовке критериев спецификации, доработке и проверке результата. ## Итог Вывод называет раннюю точку расхождения, потребляющий механизм и какие данные ещё нужны, если цепочка не замкнута. Исправление без этой цепочки не предлагай как доказанное. ## От разового расхождения к контролю качества учета Когда пользователь поручил не только объяснить расхождение, но и предотвратить его повторение, проверь полноту проектирования контроля. Успешное проведение документа или закрытие месяца не доказывает соблюдение предметного правила. 1. Зафиксируй правило учета, область применимости и исключения. Свяжи нарушение с документами, аналитиками, движениями и кодом, который их потребляет. 2. Найди в конфигурации существующее рабочее место контроля, правила и механизм их запуска. Не утверждай, что типовая подсистема есть, пока не нашел ее. В упрощённой кастомной модели называй её кастомной; не переноси правила КА/ERP или ЗУП автоматически между продуктами. 3. Воспроизведи отсутствие нужного контроля тестом пользовательского сценария. Красный результат — несовпадение ожидаемого предметного результата, а не неизвестный шаг, недоступный клиент или ошибка подключения. 4. В разрешенной области добавь повторяемую проверку в найденный механизм. Результат должен содержать документ-источник, нарушенное правило, сумму или аналитику, понятное действие и переход к источнику. Не переноси оплаты, не меняй налоговый учет и не исправляй документы молча ради зеленого теста. 5. Выполни тот же тест после изменения, затем проверь корректный пример, исключения и повторный запуск. Контроль должен обнаруживать нарушение до исправления данных и переставать показывать его после исправления. Зеленый тест контроля может означать найденную учетную ошибку: это разные статусы. «Нет отклонений» допустимо только для успешно выполненного правила; отсутствие реализации или неполные данные показывай отдельным состоянием. 6. Сохрани исходные красный и зеленый отчеты и фактический экран рабочего места. Подготовленные данные и ручные исправления не выдавай за действия агента. Наличие двух регистров (например, бухгалтерского и управленческого) не доказывает расхождение между ними. Не заменяй исходный документ удобным соседним механизмом. Если документ не формирует движений, исследуй его реквизиты и потребляющий алгоритм: отсутствие модуля проведения не разрешает выдумать проводку. В выводе о причине должны быть фактическая запись либо воспроизведение на явно описанных данных и прочитанный код. Слова «вероятно» не превращают догадку в доказанную причину и основание для доработки. Повторное чтение неизменных метаданных не дает данных документов. После одинакового ответа не повторяй тот же вызов: переходи к модулю-потребителю, предоставленным материалам или разрешенному воспроизведению. Различай описание реквизита и его фактическое значение в конкретном документе.