--- name: onec-dcs-design description: "Объясняет, откуда берутся показатели отчётов 1С, и улучшает их представление. Проектирует и анализирует схемы компоновки данных по текущей модели EDT: запросы, поля, ресурсы, параметры и конкретные варианты отчёта. Формирует адресное предложение с учётом зависимостей и сохранения настроек; запись выполняет существующий edt-mcp." --- # Проектирование и изменение СКД Вход: утверждённая задача, проект EDT, владелец схемы, набор данных, вариант или настройки по умолчанию и критерии приёмки. Результат: карта зависимостей и предметное предложение владельцу EDT. 1. Подтвердить проект и владельца через list_projects и get_metadata_details. Прочитать текущие схемы инструментов и get_tool_guide для dcs и validate_query. Для основного макета отчёта подтвердить свойство Main Data Composition Schema. Другая схема адресуется точным FQN макета. Работать через существующий edt-mcp; отсутствие возможности сообщить как явное ограничение. Прямой редактор .dcs/.mdo/Template.xml не вводить. 2. Получить dcs(action="get", type="schema") для выбранного корня. По адресам ответа прочитать нужные наборы, параметры, ресурсы, вычисляемые поля, связи и варианты. Корневая сводка не доказывает полноту. Выбрать набор и вариант по сценарию; первый в списке не является целью. defaultSettings и settings именованного варианта — разные области. 3. Получить полный запрос по отдельному адресу #/dataSets/<имя>/query, если он указан ответом. На страницах соблюдать единицы offset/limit, Next offset и hash; читать до конца. Извлечь именно текст запроса из оформленного ответа, исключив Markdown-обрамление. Не обрезать запрос, не переводить идентификаторы и не нормализовать его содержимое. Разные hash означают несогласованное чтение: зафиксировать конфликт чтения. 4. Собрать [карту зависимостей и правила изменения](changes.md). Различать поле запроса, dataPath набора, вычисляемое поле, ресурс и выборку варианта. Для параметров связать объявление, выражение, использование в запросе и значение выбранных настроек. Проверить область группировок и условия, use, пользовательскую доступность, типы и порядок. Не создавать поле вывода вместе с полем набора молча. 5. Обосновать зерно данных, соединения и агрегации. Перечитать затронутые метаданные источников. Изменённый полный запрос проверить validate_query(projectName=<тот же проект>, dcsMode=true). success/isError описывают вызов; valid и issues — результат проверки. Параметры могут пройти синтаксическую проверку без значений: сопоставить их объявления отдельно. Ресурс и выражение СКД этим вызовом не доказаны. 6. Составить адресные изменения только для задачи. Копировать канонические адреса из get; учитывать hash и фактическую поддержку каждого свойства текущим guide. Предпочитать update существующего узла; создание требует явной цели upsert. replace сбрасывает пропущенное, remove удаляет узел. Диаграмма, неподдержанный тип значения или шаблон расшифровки не должны исчезнуть при замене родителя. Нет доказанного безопасного изменения — зафиксировать явное ограничение, сохранив предметное предложение. 7. Передать предложение существующему edt-mcp для разрешённой записи. Само исследование запись не разрешает. После записи владелец перечитывает целевой узел и затронутые зависимости, проверяет полный итоговый запрос в dcsMode и диагностику EDT. По критериям задачи проводится проверка строк, итогов, границ периода, прав, производительности и клиентского поведения согласно критериям; статическая модель их не подтверждает. ## Предметное предложение Указать проект, корень схемы и основной/иной макет, точный набор данных, выбранные настройки и сценарий. Для зависимости записать источник, потребитель, канонический адрес, подтверждённое значение и неизвестное. Для каждой правки указать цель, текущее и предлагаемое значение, причину, затронутые зависимости, действие/type/body по актуальному контракту dcs, нужный hash и проверяемый результат. При предложении нескольких записей указать зависимости между ними; не объявлять несколько вызовов атомарными. Порядок операций определяется зависимостями между узлами схемы. Отдельно назвать сохраняемые настройки и неподдержанный материал. Если текущая схема подходит задаче, обосновать её сохранение. Полные данные проекта хранить в операции хоста; полноту чтения ограничить явно. Успешное чтение и проверка запроса не означают, что отчёт изменён или выполнен в информационной базе. ## Если пользователь не понимает показатель Обычный вопрос «откуда берётся этот процент?» — повод проверить не только выражение, но и то, как отчёт объясняет результат человеку. Сначала установи числитель, знаменатель, единицы измерения, состав строк и уровень итогов. Процент по сумме и процент по количеству — разные показатели; совпадение сумм не доказывает выполнение заказа по количеству. Причину расхождения цен, состава или документов не придумывай: отделяй формулу от гипотезы о данных. Дай прикладное объяснение и предложи минимальное улучшение: точное название колонки, исходные значения рядом с процентом, доступная расшифровка. Если изменение представления уже разрешено условиями задачи, выполни его через EDT MCP в этом же проходе. Если разрешено только исследование, оставь предложение. Не меняй формулу, отборы, пользовательские варианты и учётную логику под видом косметики; новый показатель согласуется отдельно. Для существующего отчёта не создавай второй отчёт только ради объяснения. Подсказку или расшифровку показывай лишь там, где её поддерживает фактическая форма и текущий контракт инструмента. Сохранённое свойство не доказывает, что подсказка появилась в окне 1С. В ответе разделяй прочитанную формулу, сделанную правку и проверенный экран; не называй предложение выполнением. При отказе записи исправляй причину из ответа инструмента, а не повторяй тот же вызов. Например, логическое `use` передаётся JSON-значением `true`, не строкой `"true"`; поле выбора — `{ "kind": "field", "value": "ИмяПоля" }`. `expectedHash` передаётся на верхнем уровне аргументов, вне `body`, и обновляется после успешной записи. Если исправленный вызов снова отклонён, перечитай guide и адрес целевого узла; не запускай цикл одинаковых неуспешных записей. ## Дополнительная памятка - [Учётная достоверность отчётов, регистры-источники и сравнение выборок](accounting-reports-and-layouts.md) - Парный инструментальный навык EDT-MCP для работы с запросами и СКД: [`edt-mcp-project-query-dcs`](../edt-mcp-project-query-dcs/SKILL.md)