Разработка и аудит промпта
для генерации кода 1С:Предприятие 8.3

[РОЛЬ]
Ты — ведущий эксперт по разработке на платформе 1С:Предприятие 8.3, архитектор
прикладных решений и преподаватель со стажем. Отвечаешь как практик, который
пишет код в продакшн и проходит аудит по стандартам разработки 1С.

[КОНТЕКСТ ПРОЕКТА]
- Платформа: 1С:Предприятие 8.3.22 и выше.
- Конфигурация: «1С:Бухгалтерия предприятия, редакция 3.0» (демобаза).
- Режим: управляемое приложение, интерфейс «Такси».
- Библиотека: БСП 3.1.10 (состав общих модулей — по этой версии).
- Целевые клиенты: тонкий клиент (основной) и веб-клиент (обязателен к учёту).
- Артефакт: внешняя обработка .epf, запуск через «Файл → Открыть».
  Регистрация в справочнике «ДополнительныеОтчётыИОбработки» НЕ требуется.
- Подсистема размещения: «Сервис» (только для отображения команды, если применимо).

[УРОВЕНЬ ЗАДАЧИ]
- Бизнес-уровень: бухгалтеру нужна разовая ручная выгрузка справочника в Excel
  для сверки с контрагентом. Не регламентная операция, не обмен данными.
- Технический уровень: универсальная форма с выбором объекта выгрузки,
  один запрос к базе, формирование ТабличногоДокумента, сохранение в XLSX.

[ЦЕЛЬ]
Спроектировать логику и написать код внешней обработки, которая позволяет
пользователю выбрать один из трёх справочников («Контрагенты», «Номенклатура»,
«Физические лица») и выгрузить его данные в файл XLSX на локальный диск.

[СРЕДСТВА — РАЗРЕШЁННЫЙ ИНСТРУМЕНТАРИЙ]
- Запрос к базе (один), ТабличныйДокумент, Поток.
- Общие модули БСП: ФайловаяСистемаКлиент, ОбщегоНазначенияКлиент,
  ОбщегоНазначения.
- Асинхронная модель: Асинх/Ждать либо ОписаниеОповещения.
- Динамическое формирование текста запроса через Метаданные.

[ОГРАНИЧЕНИЯ — ЗАПРЕТЫ]
- ЗАПРЕЩЕНО использовать синхронные модальные вызовы: Предупреждение(), Вопрос(),
  ВвестиЗначение(), ОткрытьФормуМодально().
- ЗАПРЕЩЕНО выполнять запросы и вызовы сервера внутри циклов.
- ЗАПРЕЩЕНО использовать COM-объект Excel (Новый COMОбъект("Excel.Application")).
- ЗАПРЕЩЕНО использовать hardcode-пути к файлам и каталогам.
- ЗАПРЕЩЕНО вызывать платформенный метод Диалог.Показать() и его синхронный
  аналог Диалог.Выбрать(). Создавать объект «Новый ДиалогВыбораФайла» РАЗРЕШЕНО
  и НЕОБХОДИМО — но исключительно как параметр, передаваемый в
  ФайловаяСистемаКлиент.ПоказатьДиалогВыбора(Оповещение, Диалог).
  Показ диалога любым иным способом — нарушение.
- ЗАПРЕЩЕНО выводить пользователю строковые литералы напрямую: любой текст,
  видимый пользователю (сообщения, заголовки, фильтры, состояния, представления
  колонок), обязан быть обёрнут в НСтр("ru = '…'"). Хардкод-строка в интерфейсе —
  нарушение стандартов локализации.
- ЗАПРЕЩЕНО применять ПРЕДСТАВЛЕНИЕ() и условия вида «ГДЕ ИСТИНА» в запросе.
- ЗАПРЕЩЕНО выдумывать реквизиты, которых нет в метаданных БП 3.0.

[ПАРАМЕТРЫ ГЕНЕРАЦИИ]
- Температура: 0.0 — минимальная креативность, максимально предсказуемый ответ.
- Top-k: минимальный — только эталонные, стандартные конструкции 1С.
- Тон и стиль: строгий академический, профессиональный технический язык.
  Без вводных фраз, без маркетинговых оборотов, без похвалы задаче.

[ПРИОРИТЕТ МЕТРИК]
1. Поддерживаемость и читаемость кода.
2. Производительность.
При конфликте метрик выбирай читаемость и укажи это одной строкой.

[СПЕЦИФИКА МЕТАДАННЫХ И СВЕРКА]
- Справочники ссылочного типа, доступ — с учётом прав текущего пользователя.
- Иерархичность НЕ одинакова у трёх объектов:
  • Контрагенты — иерархический (иерархия групп и элементов);
  • Номенклатура — иерархическая;
  • Физические лица — НЕиерархический, реквизита «ЭтоГруппа» у него НЕТ.
  Условие «НЕ ЭтоГруппа» добавляй в запрос ТОЛЬКО тогда, когда
  Метаданные.Справочники[ИмяСправочника].Иерархический = Истина.
  Текст запроса формируй динамически с учётом этого признака.
- ОБЯЗАТЕЛЬНАЯ СВЕРКА: перед написанием запроса сверь каждое поле из матрицы
  ниже с реальным составом метаданных БП 3.0. Если реквизита у объекта нет —
  не подставляй похожий и не выдумывай: выведи строку
  «Расхождение с метаданными: <объект>.<реквизит> — отсутствует, решение: …».

[МАТРИЦА ПОЛЕЙ]
| Справочник       | Наименование | Код | ИНН                 | Ссылка |
|------------------|--------------|-----|---------------------|--------|
| Контрагенты      | да           | да  | да                  | да     |
| Номенклатура     | да           | да  | нет реквизита       | да     |
| ФизическиеЛица   | да           | да  | да                  | да     |

- Состав колонок XLSX ОДИНАКОВ для всех трёх справочников — ровно 4 колонки.
  Структура результата запроса не должна «плавать» между справочниками.
- Отсутствующий реквизит ИНН (Номенклатура) НЕ пропускается и НЕ заменяется
  NULL: в тексте запроса подставляется пустая строковая константа с тем же
  псевдонимом — "" КАК ИНН. Это гарантирует одинаковый состав и типы колонок.
  ВНИМАНИЕ на синтаксис: в коде 1С кавычки внутри строкового литерала
  удваиваются, поэтому фрагмент записывается как  """"" КАК ИНН"  (см. Пример 2).
- Наличие реквизита определяй программно, а не жёстким перебором имён:
  ОбъектМД.Реквизиты.Найти("ИНН") <> Неопределено.
- Колонка «Ссылка» выгружается строкой: в запросе выбирается сама Ссылка,
  а при заполнении ячейки применяется Строка(Ссылка.УникальныйИдентификатор()).
  Вызов УникальныйИдентификатор() в тексте запроса недопустим.

[ТРЕБОВАНИЯ К ЗАПРОСУ]
- Ровно ОДИН запрос к базе. Операция только на чтение.
- Транзакции и управляемые блокировки НЕ использовать: блокировки нужны при
  записи, для чтения справочника они избыточны.
- Временные таблицы и индексирование НЕ требуются — обоснуй это одной строкой.
- Обязательно: ключевое слово РАЗРЕШЕННЫЕ (учёт RLS).
- Обязательно: явное перечисление полей с псевдонимами. Без «*», без ПРЕДСТАВЛЕНИЕ().
- Обязательно в ГДЕ: НЕ ПометкаУдаления; НЕ ЭтоГруппа — по условию иерархичности.
- Обязательно: УПОРЯДОЧИТЬ ПО Наименование.

[УПРАВЛЕНИЕ ФОРМОЙ]
- Код строго разделён на клиентский и серверный контекст, директивы компиляции
  проставлены явно.
- Серверный вызов — без контекста формы, если это возможно.
- На время формирования файла: блокируй команду выгрузки и выводи индикацию
  через Состояние(НСтр("ru = 'Формирование файла…'")).
- По завершении записи — асинхронное уведомление с путём к файлу
  (ОповеститьПользователя или асинхронный аналог предупреждения).
- Обновление данных формы (Refresh / ОповеститьОбИзменении) — N/A: обработка
  не изменяет данные базы. Отметь это явно одной строкой.
- Обработай два сценария отказа: (а) справочник не выбран; (б) пользователь
  закрыл диалог выбора файла без сохранения. Молча завершаться нельзя.

[БСП — КОНКРЕТНЫЕ МЕХАНИЗМЫ]
- Диалог сохранения файла: ФайловаяСистемаКлиент.ПоказатьДиалогВыбора —
  он сам инициирует подключение расширения работы с файлами в веб-клиенте.
- Сообщения пользователю: ОбщегоНазначенияКлиент.СообщитьПользователю.
- Все интерфейсные тексты — через НСтр("ru = '…'") без исключений.
- Именование процедур, функций и переменных — по стандартам разработки 1С (СТД).
  Экспортные методы снабжай комментарием-описанием.

[ВАРИАНТЫ АРХИТЕКТУРЫ — ToT]
Предложи 2 варианта реализации:
  А. Сервер формирует ТабличныйДокумент и возвращает его на клиент;
     клиент записывает файл методом Записать(Путь, ТипФайлаТабличногоДокумента.XLSX).
  Б. Сервер формирует файл и помещает его во временное хранилище;
     клиент получает его по адресу и сохраняет.
Сравни строго по двум критериям: поддерживаемость и работоспособность
в веб-клиенте. Выбери один вариант. Обоснование — не более 3 предложений.

[МЕТАКОГНИТИВНЫЙ ПОДХОД — CoT, Top-Down]
Работай сверху вниз. До написания кода выведи текстовое описание логики:
  Шаг 0. Пересказ сути задачи одним предложением — фиксация ТЗ.
  Шаг 1. Структура реквизитов и команд формы (ИмяСправочника — тип Строка,
         список выбора из трёх значений).
  Шаг 2. Алгоритм работы: что выполняется на клиенте, что на сервере,
         как данные передаются между слоями.
Если после Шага 0 в ТЗ остаются неоднозначности — задай не более 3 уточняющих
вопросов и дождись ответа.

[ИНТЕРАКТИВНАЯ ФИКСАЦИЯ — КРИТИЧЕСКОЕ ТРЕБОВАНИЕ]
После Шагов 0–2 ОСТАНОВИСЬ. Код в этом сообщении не выводи ни в каком виде —
ни целиком, ни фрагментом, ни «для наглядности», ни в виде псевдокода.
Заверши сообщение вопросом:
«Структура и логика утверждены? Можно переходить к генерации кода?»

Если ты работаешь в обычном интерактивном чате (ChatGPT, Claude, Gemini и любой
диалоговый интерфейс, где пользователь может ответить следующим сообщением) —
остановка ОБЯЗАТЕЛЬНА. Вывод кода до получения явного подтверждения считается
критической ошибкой выполнения задания и обесценивает весь ответ.
Стремление «сэкономить пользователю время» и выдать всё сразу — не оправдание.
Единственное исключение: неинтерактивный запуск (одиночный вызов API, batch,
автоматизированный конвейер), где ответ пользователя технически невозможен.
Только в этом случае выведи строку «Продолжаю без подтверждения» и переходи
к коду. Если сомневаешься, интерактивен ли режим, — считай, что интерактивен,
и остановись.

[ОБЪЁМ]
- Шаги 0–2 (описание логики): до 15 строк.
- Код модуля формы: до 150 строк.
- Сопроводительный текст (без учёта строк кода): до 700 слов.
- Порог рефакторинга: если код превышает 80 строк, декомпозируй его.
  Логику заполнения шапки и строк ТабличногоДокумента вынеси в отдельные
  вспомогательные процедуры/функции ТОГО ЖЕ серверного контекста —
  с директивой &НаСервереБезКонтекста, вызываемые из
  СформироватьТабличныйДокументНаСервере.
  УЧТИ ОГРАНИЧЕНИЕ ПЛАТФОРМЫ: из процедуры &НаСервереБезКонтекста нельзя
  обращаться к контексту формы и вызывать процедуры с директивой &НаСервере.
  Допустимы только вызовы других &НаСервереБезКонтекста-методов этой формы
  и методов серверных общих модулей. Декомпозиция не должна нарушать это правило.

[СБОРКА ПО ЧАСТЯМ]
Код выдавай четырьмя отдельными блоками в этом порядке:
  1) Реквизиты и команды формы (списком, с типами).
  2) Формирование шапки ТабличногоДокумента.
  3) // --- СЕРВЕР --- : запрос и заполнение ТабличногоДокумента.
  4) // --- КЛИЕНТ --- : команда, диалог выбора файла, обработчик завершения.
Каждый блок кода оформляй в ограждении ```bsl.

[ПРИМЕРЫ — FEW-SHOT]
Пример 1. Клиент: подготовка объекта диалога и его показ средствами БСП.
&НаКлиенте
Процедура Выгрузить(Команда)
    Если НЕ ЗначениеЗаполнено(ИмяСправочника) Тогда
        ОбщегоНазначенияКлиент.СообщитьПользователю(
            НСтр("ru = 'Не выбран справочник для выгрузки.'"), , "ИмяСправочника");
        Возврат;
    КонецЕсли;
    // Объект диалога создаётся, но НЕ показывается напрямую:
    // метод Диалог.Показать() запрещён, показ — только через БСП.
    Диалог = Новый ДиалогВыбораФайла(РежимДиалогаВыбораФайла.Сохранение);
    Диалог.Заголовок  = НСтр("ru = 'Укажите файл для сохранения'");
    Диалог.Фильтр     = НСтр("ru = 'Книга Excel (*.xlsx)|*.xlsx'");
    Диалог.Расширение = "xlsx";
    Оповещение = Новый ОписаниеОповещения("ВыгрузитьЗавершение", ЭтотОбъект);
    ФайловаяСистемаКлиент.ПоказатьДиалогВыбора(Оповещение, Диалог);
КонецПроцедуры

Пример 2. Сервер: динамический текст запроса с учётом иерархии и отсутствия ИНН.
&НаСервереБезКонтекста
Функция ТекстЗапросаВыгрузки(ИмяСправочника)
    ОбъектМД = Метаданные.Справочники[ИмяСправочника];
    // Условие по группам — только для иерархических справочников.
    УсловиеГруппы = ?(ОбъектМД.Иерархический, "
        |   И НЕ Спр.ЭтоГруппа", "");
    // Реквизита ИНН может не быть: подставляем пустую строковую константу,
    // чтобы состав и типы колонок совпадали для всех справочников.
    // Внутри литерала кавычки удвоены: получится  "" КАК ИНН
    ПолеИНН = ?(ОбъектМД.Реквизиты.Найти("ИНН") = Неопределено,
        """"" КАК ИНН",
        "Спр.ИНН КАК ИНН");
    Возврат
        "ВЫБРАТЬ РАЗРЕШЕННЫЕ
        |   Спр.Наименование КАК Наименование,
        |   Спр.Код          КАК Код,
        |   " + ПолеИНН + ",
        |   Спр.Ссылка       КАК Ссылка
        |ИЗ
        |   Справочник." + ИмяСправочника + " КАК Спр
        |ГДЕ
        |   НЕ Спр.ПометкаУдаления" + УсловиеГруппы + "
        |УПОРЯДОЧИТЬ ПО
        |   Наименование";
КонецФункции

Пример 3. Клиент: обработчик завершения диалога с отработкой отказа.
&НаКлиенте
Процедура ВыгрузитьЗавершение(ВыбранныеФайлы, ДополнительныеПараметры) Экспорт
    Если ВыбранныеФайлы = Неопределено ИЛИ ВыбранныеФайлы.Количество() = 0 Тогда
        Возврат; // Пользователь отказался от сохранения — молча выходим корректно.
    КонецЕсли;
    Состояние(НСтр("ru = 'Формирование файла…'"));
    ТабДок = СформироватьТабличныйДокументНаСервере(ИмяСправочника);
    ТабДок.Записать(ВыбранныеФайлы[0], ТипФайлаТабличногоДокумента.XLSX);
КонецПроцедуры

[САМОПРОВЕРКА — ОБЯЗАТЕЛЬНЫЙ ЧЕК-ЛИСТ]
Сразу после кода пройди чек-лист и выведи результат по каждому пункту
в формате «пункт — ОК / нарушение: <описание>»:
  1. Нет вызовов сервера и запросов внутри циклов.
  2. Все клиентские взаимодействия асинхронные, модальных вызовов нет,
     Диалог.Показать() не используется.
  3. Директивы компиляции проставлены и корректны; из &НаСервереБезКонтекста
     нет обращений к контексту формы и к &НаСервере-процедурам.
  4. Обработаны оба сценария отказа: справочник не выбран; диалог закрыт без выбора.
  5. Условие «НЕ ЭтоГруппа» не применяется к неиерархическому справочнику;
     колонка ИНН присутствует у всех трёх справочников.
  6. Все интерфейсные строки обёрнуты в НСтр() — хардкод-текста нет.
Если найдено нарушение — приведи исправленный фрагмент кода, а не только описание.

[ПОВЕДЕНИЕ ПРИ НЕВОЗМОЖНОСТИ ВЫПОЛНИТЬ ТРЕБОВАНИЕ]
Если какой-либо пункт невыполним или противоречит другому — не пропускай его
молча и не подменяй близким по смыслу. Вынеси в раздел «Не выполнено и почему»
с указанием причины и предложи альтернативу.

[ФИКСАЦИЯ РЕЗУЛЬТАТА]
Заверши ответ двумя элементами:
  1. Блок «Готово: <краткий статус в одну строку>».
  2. Следующий шаг — в виде готового, автономного, самодостаточного промпта
     для следующей итерации (например: добавление отбора по периоду создания,
     сохранение настроек выгрузки, выгрузка нескольких справочников за раз).

Приступай с Шага 0.