crm3-26.rhana

Расширение РАНА для целевой конфигурации crm3-26 (ИБ crm3, сервер 1c-srv.rhana.local).

Текущая версия: 1.3.1.82 — см. VERSION и src/Configuration.xml.

Префикс новых объектов расширения: РК_.

Назначение

Доработки целевой CRM3 редакции 3.1, не входящие в типовую конфигурацию:

• приём данных при синхронизации crm3-dev → crm3-26 (защита учётных настроек целевой ИБ);
• НСИ и бизнес-логика РАНА (контрагенты, договоры, реализация, заказы, отладка);
• совместимость обмена с исходной базой (EnterpriseData 1.8, ставки НДС 22%);
• проверка и исправление серий (РК_ПроверкаСерий: пустые реквизиты, дубли, срок годности).

Парное расширение исходной ИБ: crm3-dev.rhana.

Документация

Документ	Содержание
CHANGELOG.md	история версий и описание доработок
../docs/transfer/Анализ_синхронизации_crm3-dev_crm3-26.md	полный анализ синхронизации (монорепозиторий crm3-26)
../docs/1c_standarts/Выгрузка_в_файлы_ConfigDumpInfo.md	UUID и configVersion при выгрузке в файлы
../docs/meta/REPOSITORIES.md	связанные git-репозитории конфигураций

Синхронизация crm3-dev → crm3-26

Разделение ответственности

Сторона	Расширение	Роль
Исходная (crm3_placentapharm)	crm3-dev.rhana	совместимость отправки (XDTO 1.8, валюта банк.счетов, фильтр узла CRM3-26)
Целевая (crm3)	crm3-26.rhana	защита приёма (учёт номенклатуры, склады, виды, серии)

Доработки обмена на каждой стороне применяются только к узлу CRM3, без влияния на обмен с Бухгалтерией.

Ключевые функции (целевая ИБ)

Модуль: МенеджерОбменаЧерезУниверсальныйФормат, область Синхронизация_crm3_dev_crm3_26.

Функция	Назначение
РК_УзелCrm3Dev_GUID()	GUID узла «Рабочая CRM3» (97cd20ee-bb06-11f0-8dac-0cc47a7d055f)
РК_ЭтоОбменС_Crm3Dev(КомпонентыОбмена)	Истина только для обмена с исходной CRM

Защита при получении (v1.3.0.37+)

Объект	Поведение
Номенклатура (существует)	снимок и восстановление учётных реквизитов целевой ИБ после типового ПередЗаписью и отложенной обработки
Номенклатура (новая)	заполнение учёта по виду номенклатуры целевой ИБ
Виды номенклатуры (существует)	пропуск обновления (сопоставление по GUID сохраняется)
Склады (существует)	пропуск перезаписи реквизитов
Серии номенклатуры	проверка владельца + подбор по Номер/ГоденДо в рамках владельца вида (v1.3.0.43+)
Ставки НДС	ПКПД: НДС22, НДС22_122

Защищаемые реквизиты номенклатуры: ВидНоменклатуры, ОсобенностьУчета, ТипНоменклатуры, ИспользованиеХарактеристик, ВладелецСерий, ВладелецХарактеристик, ГруппаФинансовогоУчета, СкладскаяГруппа.

Контрагенты — уникальность ИНН/КПП (v1.3.0.39)

В crm3-26 проверка реализована в ПартнерыИКонтрагентыЛокализация (не в ПартнерыИКонтрагенты, как в crm3-dev).

Процедура/функция	Изменение
ИННКППУжеИспользуетсяВИнформационнойБазе	дубли ищутся только среди контрагентов без пометки удаления
ПроверитьКорректностьЗаполненияКонтрагента	для контрагента с ПометкаУдаления проверка уникальности не выполняется

Поведение согласовано с crm3-dev.rhana v1.0.1.333. Отдельная CRM-функция CRM_КлиентыСервер.ИННКППУжеИспользуетсяВИнформационнойБазе (поиск по Партнеры.CRM_ИНН) не затронута.

Состав расширения (основное)

Общие модули

Модуль	Назначение
МенеджерОбменаЧерезУниверсальныйФормат	синхронизация crm3-dev, защита учёта при получении
ПартнерыИКонтрагентыЛокализация	уникальность ИНН/КПП контрагентов
РК_ОбменСВнешнейБазой	HTTP-клиент Transfer API (ws-rhana) по настройкам справочника
РК_ОбщегоНазначения / РК_ОбщегоНазначенияВызовСервера / РК_ОбщегоНазначенияКлиентСервер	инфраструктура РАНА (режим отладки и др.)
ОбщегоНазначенияКлиентСервер	доработки отборов динамических списков

Справочники и HTTP к исходной ИБ (v1.3.1.49+)

Объект	Назначение
РК_НастройкиПодключенияКВнешнейБазе	адрес /hs/transfer, токен, логин/пароль, таймаут, ИмяТекущейБазы, Активно
Менеджер справочника	ПроверитьСоединение(Источник), СоединениеАктивно(Ссылка), ИмяТекущейИнформационнойБазы()
РК_РабочееПодключениеЧерезАПИ	константа — текущая рабочая настройка
РК_ЗагрузкаОстатков	дерево групп, склады/организации, свои и комиссия 2.5, два количества, ввод остатков

Проверка соединения (форма элемента или любой код):

// по ссылке
Р = Справочники.РК_НастройкиПодключенияКВнешнейБазе.ПроверитьСоединение(СсылкаНастройки);
// по полям формы / структуре (АдресПодключения|Адрес, Токен, …)
Р = Справочники.РК_НастройкиПодключенияКВнешнейБазе.ПроверитьСоединение(СтруктураПолей);
// Р.Успех, Р.Текст, Р.Ответ, Р.Ошибка — GET /v1/health через РК_ОбменСВнешнейБазой

HTTP-клиент передаёт IBSession: start (публикация с повторным использованием сеансов) и X-Transfer-Token.

Пара: расширение ws-rhana на исходной ИБ (≥ 0.0.0.42 для дерева групп номенклатуры; комиссия 2.5 / серии — с 0.0.0.36–0.0.0.39).

Обработки и формы

Объект	Назначение
РК_ЗагрузкаОстатков	загрузка собственных и комиссионных (переданные 2.5) остатков через Transfer API
РК_ПроверкаСерий	поиск проблем в СерииНоменклатуры, заполнение реквизитов, объединение дублей (#14, #15)
РК_ОбработкаПарнеровКонтрагентов	работа с партнёрами и контрагентами
РК_ФормаНастроекРана	настройки расширения
ЗагрузкаДанныхИзФайла	доработки загрузки НСИ

РК_ПроверкаСерий (v1.3.1.70+)

Обработка по справочнику СерииНоменклатуры с учётом политики вида (ИспользоватьНомерСерии, ИспользоватьСрокГодностиСерии).

Вкладка / действие	Поведение
Заполнение реквизитов	проблемы: пустой номер, пустой срок, наименование не по шаблону; предложения из наименования; срок годности по умолчанию (сохраняется в настройках формы, v1.3.1.81–82)
Найти проблемы / Сформировать предложения / Заполнить по предложениям	без записи в ИБ, пока не нажато «Исправить отмеченные»
Объединение дублей	группы: вид + номер + срок годности (без даты производства); остатки из ТоварыНаСкладах; замена ссылок через ОбщегоНазначения.ЗаменитьСсылки
Режим тест	запись в ИБ не выполняется

Ключевые issues: crm3_26.rhana#14, #15.

Подсистемы

• РК_РАНА — общие доработки РАНА
• РК_РАНА326 — доработки, специфичные для целевой конфигурации

Репозиторий

https://git.p7net.ru/1c/crm3_26.rhana.git

Каталог в монорепозитории: crm3-26.rhana/.

Обновление из конфигуратора

После выгрузки из 1С EDT / конфигуратора:

scripts/normalize_1c_export.sh crm3-26.rhana   # из корня crm3-26
cd crm3-26.rhana && git add -A && git status

В src/ConfigDumpInfo.xml атрибут configVersion — SHA-1, ровно 40 hex. Кривая длина (41/42) при ручном добавлении объектов роняет конфигуратор при выгрузке поверх src без сообщения об ошибке. Подробнее: docs/1c_standarts/Выгрузка_в_файлы_ConfigDumpInfo.md, задача crm3-migration#19.

Синхронизация .gitattributes / .editorconfig: scripts/sync_git_1c_config.sh (см. tools/git_1c/README.md).

Связанные конфигурации

Сторона	Конфигурация	ИБ	Расширение
Исходная	crm3-dev	crm3_placentapharm	crm3-dev.rhana
Целевая	crm3-26	crm3	crm3-26.rhana