ЛарджСпейс. Ключевые принципы разработки: различия между версиями
Irit (обсуждение | вклад) (Новая страница: «Ключевые принципы разработки компании ЛарджСпейс '''Принцип №1''': Вся разработка выполняется через расширения 1С. Снятие с поддержки типовой конфигурации 1С разрешено только в исклю...») |
Irit (обсуждение | вклад) Нет описания правки |
||
| Строка 3: | Строка 3: | ||
'''Принцип №1''': Вся разработка выполняется через [[Расширение конфигурации 1С|расширения 1С]]. Снятие с поддержки типовой [[Конфигурация 1С|конфигурации 1С]] разрешено только в исключительных случаях, которые должны быть обговорены среди всех специалистов-разработчиков 1С. | '''Принцип №1''': Вся разработка выполняется через [[Расширение конфигурации 1С|расширения 1С]]. Снятие с поддержки типовой [[Конфигурация 1С|конфигурации 1С]] разрешено только в исключительных случаях, которые должны быть обговорены среди всех специалистов-разработчиков 1С. | ||
'''Принцип №2''': Вся разработка ведется через систему контроля версий git, даже разработка в одного программиста. Все изменения должны быть сохранены в виде коммитов в соответствующей ветке. | '''Принцип №2''': Вся разработка ведется через [[Система контроля версий Git|систему контроля версий git]], даже разработка в одного программиста. Все изменения должны быть сохранены в виде [[Git. Коммит|коммитов]] в соответствующей [[Git. Ветка|ветке]]. | ||
Принцип №3: Чем меньше перехватов типового кода – тем надежнее решение. Идеальным вариантом является перехват вызовов через аннотации «& | '''Принцип №3''': Чем меньше перехватов типового кода – тем надежнее решение. Идеальным вариантом является перехват вызовов через аннотации «'''&Перед'''» и «'''&После'''», допустимо применять аннотацию «'''&Вместо'''», если в данной процедуре используется процедура «ПродолжитьВызов(…)» для передачи управления типовому коду. Аннотация «'''&ИзменениеИКонтроль'''» не рекомендуется, код должен быть переработан через другие виды перехвата. | ||
Принцип №4: Писать поясняющие комментарии, аннотацию к функциям и процедурам, документацию и автотесты – это хорошо. | '''Принцип №4''': Писать поясняющие комментарии, аннотацию к функциям и процедурам, документацию и автотесты – это хорошо. | ||
Принцип №5: все изменения на захваченных формах типовой конфигурации выполняются ТОЛЬКО кодом. Для упрощения жизни существует тиражная библиотека «ЛС_БиблиотекаФорм». | '''Принцип №5''': все изменения на захваченных формах типовой конфигурации выполняются ТОЛЬКО кодом. Для упрощения жизни существует тиражная библиотека «ЛС_БиблиотекаФорм». | ||
Принцип №6: Используйте существующие библиотеки вместо написания собственных реализаций кода. | '''Принцип №6''': Используйте существующие библиотеки вместо написания собственных реализаций кода. | ||
Принцип №7: Если один и тот же код выполняется в двух местах и больше – оформлять его в отдельную процедуру. Если функция очень большая (занимает больше 2 экранов) – дробить ее на подфункции. Каждая функция должна выполнять ровно одну задачу. | '''Принцип №7''': Если один и тот же код выполняется в двух местах и больше – оформлять его в отдельную процедуру. Если функция очень большая (занимает больше 2 экранов) – дробить ее на подфункции. Каждая функция должна выполнять ровно одну задачу. | ||
Текущая версия от 21:10, 8 марта 2023
Ключевые принципы разработки компании ЛарджСпейс
Принцип №1: Вся разработка выполняется через расширения 1С. Снятие с поддержки типовой конфигурации 1С разрешено только в исключительных случаях, которые должны быть обговорены среди всех специалистов-разработчиков 1С.
Принцип №2: Вся разработка ведется через систему контроля версий git, даже разработка в одного программиста. Все изменения должны быть сохранены в виде коммитов в соответствующей ветке.
Принцип №3: Чем меньше перехватов типового кода – тем надежнее решение. Идеальным вариантом является перехват вызовов через аннотации «&Перед» и «&После», допустимо применять аннотацию «&Вместо», если в данной процедуре используется процедура «ПродолжитьВызов(…)» для передачи управления типовому коду. Аннотация «&ИзменениеИКонтроль» не рекомендуется, код должен быть переработан через другие виды перехвата.
Принцип №4: Писать поясняющие комментарии, аннотацию к функциям и процедурам, документацию и автотесты – это хорошо.
Принцип №5: все изменения на захваченных формах типовой конфигурации выполняются ТОЛЬКО кодом. Для упрощения жизни существует тиражная библиотека «ЛС_БиблиотекаФорм».
Принцип №6: Используйте существующие библиотеки вместо написания собственных реализаций кода.
Принцип №7: Если один и тот же код выполняется в двух местах и больше – оформлять его в отдельную процедуру. Если функция очень большая (занимает больше 2 экранов) – дробить ее на подфункции. Каждая функция должна выполнять ровно одну задачу.