Bridge-and-Join-s/deploy/depo/fancy-m2m-firebird/README.md

Обмен M2M с Fancy DEPO на Firebird 2.5

Перенос трансферных таблиц и процедур обработки MSSQL-версии (deploy/depo/fancy-m2m, Фонтвьель, тексты от 22.10.2026, FTV_M2M_PROCESS_OPERATION — от 24.10.2026) на Firebird 2.5. Логика процедур та же; отличия перечислены в шапке 10_FTV_M2M_PROCS.sql.

Файл	Что делает
00_FTV_M2M_TABLES.sql	таблицы FTV_M2M*, генераторы и триггеры ID, исключение FTV_M2M_ERROR, таблица привязок FTV_M2M_SETTINGS
10_FTV_M2M_PROCS.sql	процедуры: FTV_M2M_FAIL/GET/DT/DAY (вспомогательные), PROCESS_WIRING, PROCESS_OPERATION, UPDATE_HANDBOOK, PROCESS_EVENTS, PROCESS_CREATE, JOB
20_FTV_M2M_GRANTS.sql	права процедурам на таблицы Fancy и логину bj (:BJ_USER) на FTV_M2M_JOB и таблицы обмена
test/	заглушки таблиц Fancy (по схеме MSSQL), прогон всех веток на встроенном Firebird 2.5.9

Установка из bj

Мастер настройки bj, шаг «Учёт DEPO» → СУБД «Firebird» (27.10.2026): адрес сервера, порт 3050, путь к файлу базы на сервере (как в подключении Fancy) или псевдоним. «Дать логин администратора» — SYSDBA, разово, не сохраняется: bj проверит базу и функции Fancy (UDF), создаст логин bj SYSDBA_BJ, таблицы обмена, оператора Fancy для bj, кодировщик M2M, определит привязки FTV_M2M_SETTINGS, поставит процедуры и права и проверит обработку (BJ_PING). «Получить скрипт» — то же одним файлом для isql (WIN1251). Встроенные в bj копии этих файлов — internal/lkgateway/depoprocs/firebird (тест сверяет их с этим каталогом).

• Логин bj — SYSDBA_BJ: Fancy даёт права на документы только логинам SYSDBA% (FU_HAVE_RIGHT); для сервера Firebird это обычный пользователь — у него только выданные права: чтение учёта, таблицы обмена, FTV_M2M_JOB. Он же — оператор Fancy (OD_OPERATORS, «робот», U_FACE = депозитарий): по оператору Fancy нумерует документы.
• Обработку запускает bj (SQL Server Agent нет).
• Запросы bj к DEPO (T-SQL) подключение к Firebird переводит само: internal/lkgateway/fancyfb.go, точные переводы — fsql/fb.go. Проверка — go test -run FBLive с BJ_FB_TEST_DSN на копии базы клиента.

Установка вручную

Порядок установки: 00 → заполнить FTV_M2M_SETTINGS → 10 → 20 (под SYSDBA или владельцем базы).

Файлы — в UTF-8, а база Fancy обычно в кодировке NONE с данными в WIN1251. Ставить в WIN1251, иначе русские тексты процедур попадут в базу в UTF-8:

iconv -f utf-8 -t cp1251 10_FTV_M2M_PROCS.sql > 10.sql
isql -ch WIN1251 -user SYSDBA -i 10.sql <сервер>:<путь к базе>

(в IBExpert — кодировка подключения WIN1251, файл открыть в UTF-8).

Проверено на базе Fancy

27.10.2026, обезличенная база Fancy: Firebird 2.5.9, ODS 11.2, диалект 1, кодировка NONE, UDF ib_Fansy и штатные триггеры Fancy. Прошли установка 00–20, справочник участников (HANDBOOK), поручения IN и OUT, события до BJ_EXECUTED: операции зачисления и списания, входящие записи по отчёту НРД, проводки через OD_PR_INS_WIRS. Ошибки (неизвестный контрагент, повтор GUID, неизвестное событие, нет строки поручения) — текст в COMMENT.

Подтвердилось: имена и колонки таблиц; FU_NEXT_DOC_NUM (CAT_SYS_NAME, D_DATE, DIRECTION, FOR_DOC) — выполняемая, принимает SYS_NAME или ID категории; OD_PR_INS_WIRS — 31 входной и 4 выходных параметра; D_CLISER_M2M.DOC_GUID — VARCHAR(36); флаги LAST_FLAG = 1, E_DATE = '9999-01-01'; категории I_CLISER_M2M_ZACH/SPIS, OP_INV_ZACH/SPIS, D_FILER; состояние WAIT_RESP_DECIS; кодировщик НДЦ; таблицы D_CLISER_M2M*, U_OP_INV_ZACH/SPIS.

Исправлено по итогам: генераторы OD_DOCS_ID_GEN/OD_DOLS_ID_GEN; COMMENT без кавычек (в диалекте 1 "…" — строка); дата без времени — через FTV_M2M_DAY (в диалекте 1 CAST(… AS DATE) время не отрезает); количества — DOUBLE PRECISION, как в Fancy (bj подключается в диалекте 3, а создать в базе диалекта 1 процедуру с NUMERIC точнее 9 знаков из диалекта 3 нельзя).

Через bj (отдельный экземпляр на копии базы): мастер с нуля — все проверки пройдены; тестовый режим DEPO — К1 Бубликов, зачисление и списание SBER: поручение, события до BJ_EXECUTED, операции и проводки — без ошибок; очередь обмена, справочник НРД (171 строка) — работают.

Справочник участников — на настоящем справочнике НРД (169 участников, 2 места расчётов), записанном так же, как bj пишет его в MSSQL (полная перезапись FTV_M2M_HANDBOOK + событие HANDBOOK): первый прогон — 168 юрлиц с кодами M2M, повторный — «никаких изменений не обнаружено». Исправлено относительно MSSQL-версии (там осталось):

• место расчётов без кода участника (KIND = 'PLACE', например «СПБ Банк») — юрлицо создаётся без кода M2M (OD_FACE_CODERS.CODE — NOT NULL; в MSSQL-версии справочник падает целиком, если места ещё нет в Fancy);
• один ИНН дважды в справочнике (СПБ Банк — место расчётов и депозитарий) — одно юрлицо, код добавляет шаг 3 (в MSSQL-версии — два одинаковых юрлица).

Проверить у клиента

1. UDF Fancy ib_Fansy: без неё не читаются OD_DOCS, OD_BALANCES и не ставятся процедуры (вычисляемые поля и триггеры Fancy). На сервере Fancy она есть всегда. Тестовый стенд без Windows — Firebird 2.5 для Windows под wine с ib_Fansy.dll той же разрядности.
2. Кодировщик M2M — юрлицо OD_FACES с MNEM = 'M2M'. В проверенной базе его не было; без него HANDBOOK и создание поручений падают с понятной ошибкой. Установка из bj заводит его сама; вручную (остальные поля заполнят триггеры Fancy): INSERT INTO OD_FACES (ID, S_TYPE, NAME, MNEM) VALUES (GEN_ID(OD_FACES_ID_GEN, 1), 1, 'Кодировщик M2M (справочник участников НРД)', 'M2M');
3. Оператор: логин, под которым bj вызывает FTV_M2M_JOB, должен начинаться с SYSDBA (иначе триггер OD_DOCS_BI: «Создание документа запрещено для данного пользователя») и быть в OD_OPERATORS (USER_ID = логин, U_FACE = OD_SETS.WHOS): FU_NEXT_DOC_NUM берёт депозитарий и префикс номера по текущему пользователю. Установка из bj заводит SYSDBA_BJ оператором-роботом сама.
4. Привязки FTV_M2M_SETTINGS — ID из справочников клиента: WHOS (депозитарий), OPER_USER, FILER_CAT (категория D_FILER), D_NUM/K_NUM (балансовые счета 98010 и 98070), MARKET (Мосбиржа), B_TYPE («Отчёт депозитария» в DEPO96_DCLA), CORR_FACE (НКО АО НРД), FILER_RUBRICA. В проверенной базе счета, категория, биржа и тип основания совпали с Фонтвьель (313, 836, 255, 8106, 31) — справочники поставки Fancy; WHOS и CORR_FACE — свои (OD_SETS.WHOS; НРД — юрлицо с MNEM = 'НДЦ'). Установка из bj определяет все привязки сама (оператор bj, D_FILER, счета 98010/98070.04, мнемоники ММВБ и НДЦ, «Отчет депозитария», частая рубрика D_FILER); неопределённые показывает в итоге установки.
5. Кодировка и диалект: RDB$DATABASE.RDB$CHARACTER_SET_NAME, MON$DATABASE.MON$SQL_DIALECT. При NONE или WIN1251 — ставить в WIN1251 (см. выше); текст ошибки в FTV_M2M_JOB приводится к WIN1251.
6. Числа состояний в PROCESS_EVENTS (STATE = 1, 2, 3, 8) — как у Фонтвьель; в проверенной базе поручения дошли до STATE = 2, сверить с OD_DOC_STATES клиента.

Открытые вопросы логики (те же, что в MSSQL-версии)

• BJ_ORDER_REJECTED не обрабатывается — уходит в «неизвестное событие» (вопрос программисту от 16.10.2026).
• BJ_CP_CONFIRM с направлением OUT перехватывается веткой BJ_DECISION_CONFIRM выше.
• Депонент не найден — поручение создаётся без депонента, ошибки нет. Ищется по имени и серии+номеру документа: при пустой серии (NULL) не находится.