vault backup: 2026-07-28 20:45:34

Галс/Разработка/Правила разработки. Код-ревью.md

@@ -24,6 +24,95 @@
 
 1. Сначала всегда создаем объект самостоятельно, затем переходим в "Мастер разделов"
 2. Нажимаем "Выбрать существующий объект" - Выбираем нужный нам объект
-3. В поле "Заголовок" изменяем единственное число названия объекта на множественное "Заявка -> Заявки"
+3. В поле "Заголовок" изменяем единственное число названия объекта на множественное "Клиент -> Клиенты". Нажимаем "Сохранить", настройку страницу делаем позже.
+![[Pasted image 20260728193259.png]]
 
-### Создание детали
+4. Поле "Рабочее место" не заполняем
+5. После этого создадутся две записи "Клиентского модуля"
+   `HalsCorvetClient1Page` и `HalsCorvetCliente285b5ebSection`
+   Нужно изменить их название, иначе непонятные названия
+   Именования по принципу <объект>+<Page/Section> `HalsCorvetClientPage` или `HalsCorvetClientSection`
+   Изменяем в `define` и настройке модуля
+   ![[Pasted image 20260728193622.png]]![[Pasted image 20260728193630.png]]
+
+### Создание детали
+
+1. Сначала всегда создаем объект самостоятельно, затем переходим в "Мастер деталей", никаких созданий через страницу редактирования
+2. Заголовок = множественное число названия объекта
+3. Редактируемый реестр делаем тогда, когда знаем, что деталь будет редактироваться, не открывая страницу записи
+4. Если реестр не редактируемый, то нужно настроить страницу для удобного просмотра и редактирования записи
+5. После этого создадутся две записи "Клиентского модуля"
+   `HalsSchema501397caDetail` и `HalsHalsClientAppeal1d349ac3Page`
+   Нужно изменить их название, иначе непонятные названия
+6. Именования по принципу <объект>+<Detail/Page> `HalsCorvetClientPage` или `HalsCorvetClientSection`
+   Изменяем в `define` и настройке модуля
+   ![[Pasted image 20260728203120.png]]![[Pasted image 20260728203134.png|1218]]
+   ![[Pasted image 20260728203234.png]]
+### Изменение страницы раздела
+
+1. Поле `name` для полей объекта в секции `diff` каждой страницы должно быть равно `bindTo`
+   То есть `name` = коду поля
+   Неверно `GalsName7dcd5698-2a16-42d6-8283-c76deb6ab0b3`
+   Верно `HalsName`
+   Неверно `LOOKUP9d81a3c8-8702-4451-acfd-705952c2b8ff`
+   Верно `Type`
+   ==Данная проблема решается, если сначала создать поля, а потом делать раздел и настраивать страницу==![[Pasted image 20260728200945.png]]
+
+2. При создании новой вкладки нужно писать читаемый и понятный код для вкладки. Код должен содержать содержать информацию отображаемого названия и/или логику полей, деталей вкладки
+   Неверно `Tabf4ed05f9TabLabel`
+   Верно `TabClientAppeal`
+   ![[Pasted image 20260728200923.png]]
+
+3. Детали добавляем на страницу только после создания объекта детали и создания самой детали через "Мастер деталей", иначе на странице будут вот такие непонятные названия `GalsSchema13c15d98Detailfa2c0e05`.
+   А должно быть что-то в формате `HalsClientAppeals`
+   Заполняем в поле "Код (на английском)" при добавлении детали на страницу
+    ![[Pasted image 20260728201104.png]]
+    На этапе добавления детали на страницу уже создан объект, инициализирована деталь через мастер, а также изменены стандартные названия для схемы **см. правило выше "Создание детали"**
+    ![[Pasted image 20260728201244.png]]
+
+4. Добавление группы полей похоже на добавлении вкладки
+   Заголовок - русское название
+   Код - читаемый и понятный по названию и логике
+   
+   Неверно - `GeneralInfoTabGroupc6801bb1`
+   Верно - `ClientAppealTabGroup`
+
+### Создание и привязка справочника
+
+1. После создания объекта, который будет справочником нужно создать справочник и привязать его к пакетам
+2. Добавляем справочник
+   Объект - наш объект, по которому делаем справочник `Тип объекта недвижимости`
+   Название - название объекта во множественном числе `Типы объектов недвижимости`
+3. После этого добавляем записи в справочник, которые нужно привязать к пакетам, чтобы между стендами Id были одинаковыми
+4. Привязка справочника включает в себя
+	1. Привязка самого справочника
+	   Нажимаем добавить "Данные". В поле "Объект" указываем `Lookup`
+	   Далее в название добавляем `_код объекта`, например `Lookup_HalsRealPropertyType`
+	   Обязательно для обновления - Name
+	   
+	2. Привязка данных объекта
+	   Нажимаем добавить "Данные". В поле "Объект" указываем наш объект `HalsRealPropertyType`
+	   Далее в название добавляем `_All`, например `HalsRealPropertyType_All`
+	   Обязательно для обновления - выбираем поля, которые могут меняться в рамках цикла разработки. Галочка означает, что если мы добавим запись в справочник, выльем на ветку, то если у старых имя отличается от того, которое у нас было на локальном стенде, то оно изменится.
+	   Переходим на "Привязанные данные". Нажимаем "Добавить" и добавляем все записи объекта, которые нужно переносить между стендами
+
+### Привязка настройки колонок для детали, раздела, справочника
+
+1. Настраиваем колонки в разделе, детали, справочнике
+2. Нажимаем "Сохранить" и стрелочку, там будет "Сохранить для всех пользователей"
+3. Далее привязываем настройку
+   Нажимаем добавить "Данные". В поле "Объект" указываем `SysProfileData`
+   Переходим на "Привязанные данные". Нажимаем "Добавить", в левом столбце выбираем "Ключ"
+   В "Поиск" вбиваем примерное название, например
+   делали настройку раздела "Контакты" - `ContactSectionV2`
+   делали настройку детали "Обращения" - `ClientAppealDetail`
+   ![[Pasted image 20260728202050.png|679]]
+   
+   Далее нужно выбрать правильный ключ
+   Раздел - `ContactSectionV2GridSettingsGridDataView`, тут главное ваш раздел + `GridSettingsGridDataView`
+   Код детали - `ContactPageV2ConfItemInContactDetail`, тут главное код страницы, на которой настраивали деталь `ContactPageV2` + код детали `ConfItemInContactDetail`
+   А поле "Контакт" должно быть пустым
+   ![[Pasted image 20260728202526.png]]
+   
+   Обязательно для обновления - `ObjectDifference` и `ObjectData`
+   Далее в название добавляем `_ключ`, например `SysProfileData_ContactPageV2ConfItemInContactDetail`