Потоки даних з 1С у портал клієнтів Green Co

Каталог, ціни, залишки, клієнти: крон-синк /api/sync/run

Раз на 15 хв маршрут викликає Supabase Cron (pg_cron + pg_net); у vercel.json записано ще добовий виклик о 03:00 UTC. Ліза sync_lock не дає двом прогонам накластися.
Шість кроків читання по черзі: priceTypes, catalog, prices, stock, customers, debts. Збій одного кроку не спиняє решту. catalog бере лише змінене після попереднього прогону (ДатаИзменения), решта кроків - повний зріз. Запис у репліку - upsert, рядки не видаляються.
Колекції OData дослівно (у вузлах префікс регістрів скорочено до «…_»): Catalog_ВидыЦен, Catalog_Номенклатура, InformationRegister_ЦеныНоменклатуры/SliceLast, AccumulationRegister_ЗапасыНаСкладах/Balance, Catalog_Контрагенты, Catalog_ДоговорыКонтрагентов (вид ціни клієнта), AccumulationRegister_РасчетыСПокупателями/Balance. Для категорії і країни товару - ще Catalog_КатегорииНоменклатуры і Catalog_СтраныМира.
Вітрина, пошук і прайс кабінету (його ж бачить менеджер) беруть одну збірку каталогу. Вона живе в пам'яті 5 хв, потім перечитує репліку. Залишки дають у ній лише ознаку наявності.
Вітрина показує ціну сайтового виду цін (адмін може вимкнути показ цін), кабінет - ціну виду цін клієнта. Підказки пошуку віддають 7 полів без цін.

Замовлення, борг, фото: окремий виконавець

Окремий виконавець - процес, що бачить 1С; запускається щохвилини. Читає всі Document_ЗаказПокупателя сторінками, другим проходом звіряє DataVersion і публікує один повний зріз через POST /api/sync/inbound з ключем ORDERS_SYNC_SECRET. Цей ключ приймає лише сутності orders і debts.
Історію замовлень портал показує лише зі знімка orders_snapshot; поверх нього накладає свої orders_outbox і order_sidecar. Перед зміною замовлення перечитує документ з 1С наживо.
Борг пишуть двоє: крок debts крон-синку (раз на 15 хв) і виконавець (не частіше ніж раз на 10 хв, після збою - через 2 хв). Зріз той самий, старіший свіжішого не перетирає.
У списках борг - знімок з репліки. Екран боргу спершу питає 1С наживо через OData, а знімок з позначкою «станом на» показує, коли 1С недосяжна.
Фото: окремий запуск щоночі. Перелік - Catalog_Номенклатура (ФайлКартинки_Key), картка файлу - Catalog_НоменклатураПрисоединенныеФайлы, байти - InformationRegister_ДвоичныеДанныеФайлов. Незмінене не перезаливається. Віддає фото /api/product-image зі сховища, до 1С не звертається.

Сервіс розширення прт_Портал (/hs/portal): чого він НЕ віддає

НЕ віддає номенклатуру, види цін, ціни, залишки, контрагентів і договори: таких маршрутів у сервісі немає, ці дані йдуть лише через OData.
Замовлення і борг віддає по одному контрагенту (customerId, список до 500), фото - по одному товару. Повного зрізу для репліки він не дає, і портал цих маршрутів не читає.
Push змін з 1С (сервіс C): приймач POST /api/sync/inbound у порталі є, але модуль прт_ПорталПуш у збірку розширення не входить.
У роботі (пунктир): клієнт сервісу в порталі, у main його ще немає. Він лише пише замовлення в 1С, тому стрілка йде з порталу в 1С: канали ORDERS_CREATE_VIA і ORDERS_CHANGE_VIA, новий стан черги rejected. Читання через сервіс проєкт не передбачає.