Стандарты разработки 1С

Свод правил разработки на 1С для нашей команды и аутсорс-подрядчиков. Главный рабочий инструмент здесь — чеклисты: короткие списки самопроверки по типу задачи, собранные из стандартов.

Как работать с чеклистом

1. Определите тип задачи — интеграция, отчёт на СКД, доработка формы, проведение и т.д.

2. Откройте все применимые чеклисты. Базовая проверка обязательна для любой задачи; профильных может быть несколько — задача обычно касается 2–3 тем (например, «загрузка из ДодоИс» = интеграция + сверка + автосоздание документа). Удобнее всего комплексная проверка: отметьте темы — пункты объединятся в один список без дублей. Нет профильной темы? Возьмите «Изменение бизнес-логики». Укажите № задачи — прогресс сохраняется отдельно для каждой проверки.

3. Проходите по пунктам по ходу работы, а не в конце. Каждый пункт — ссылка на стандарт, где написано, как правильно, как неправильно и когда правило не действует.

4. Приложите результат к задаче — ссылкой на чеклист или экспортом в Markdown/PDF. Это и есть подтверждение самопроверки перед сдачей.

Чеклисты по типам задач

Комплексная проверкаОтметьте темы задачи — единый список пунктов без дублей

Базовая проверкаОбщий минимум перед сдачей любой задачи

Изменение бизнес-логикиДоработки поведения системы, если нет специализированного чеклиста

ИнтеграцииHTTP-сервисы, обмены, внешние системы

Минорное изменение интеграцииТочечные правки действующего обмена

Отчёты на СКДСхема компоновки, отборы, производительность

Сверка и контроль данныхПолнота, ключ сопоставления, судьба расхождения

Автосоздание документаСоздание документа по основанию: без дублей, полно, с проведением

Внешние отчётыОтчёты через «Дополнительные отчёты и обработки»

Внешние печатные формыВПФ: пакетная печать, макеты, версия

Внешние обработкиОбработки, в т.ч. массово меняющие данные

ФормыДоработки управляемых форм

Проведение и регистрыДвижения, транзакции, блокировки

ОптимизацияЗадачи по производительности

Расширения (CFE)Доработки через расширение конфигурации

Права и ролиРоли, профили, пользователи (БСП)

Безопасность и инфраструктураДоступы, учётки, публикации, копии баз, сохранность данных

Миграции и обновленияОбработчики обновления ИБ, обновление платформы

Регламентные заданияФоновые и регламентные задания

Как читать стандарты

У каждого стандарта есть уровень (бейдж под заголовком):

• Директива — обязательное правило; автоматически попадает пунктом в чеклисты своих типов задач. Отход от директивы — только через «Когда не применять» на её странице или с явным согласованием.
• Рекомендация — сильный дефолт: делайте так, если нет причины иначе.

Чипы под заголовком связывают стандарт с первоисточником #std на v8std и с диагностикой BSL Language Server — то, что подчёркивает линтер, ведёт к правилу и способу исправления.

С чего начать новичку

Сначала — онбординг: инструменты и окружение (что поставить, какие доступы запросить, как проходит задача). Затем пять стандартов, которые покрывают большинство замечаний на ревью:

1. Структура модуля и областей
2. Код-стайл: корпоративные дополнения
3. Обработка ошибок и логирование
4. Короткие транзакции и каноничный шаблон
5. Не выполнять однотипные запросы в цикле

Затем — процесс сдачи изменений и шаблон описания изменения: как оформить работу, чтобы она прошла ревью с первого раза.

Разделы

• Общие — код-стайл, модули, ошибки, безопасность, БСП.
• Интеграции — HTTP-сервисы, обмены, аутентификация, кодировки.
• Оптимизация — запросы, планы, горячие места.
• Процесс — git, CI, quality gate, ревью.
• Примеры — витрина оформления страниц (для авторов стандартов) и образцы рабочих артефактов: описание задачи + паспорт интеграции, сквозной разбор загрузки из ДодоИс.
• Справочник — внешние источники и инструменты.