Цикл синхронізації: що відбувається за розкладом

Запуск: ключ, ліза, бюджет

Виклик - GET або POST /api/sync/run з Authorization: Bearer CRON_SECRET. Секрету на хості немає - 503, ключ невірний - 401; без DATABASE_URL або BAS_ODATA_URL - теж 503
У репозиторії розклад Vercel Cron - раз на добу (0 3 * * *). Запуск кожні 15 хв через Supabase Cron (pg_cron + pg_net) на той самий маршрут описаний у документації; сам розклад живе поза кодом
Ліза - один рядок sync_lock з id = run; TTL = бюджет + 60 с, подовжується після кожного кроку. Поки вона зайнята, інший виклик отримує 200 зі skipped: locked і нічого не робить. Ліза спільна для крону і локального воркера sync:worker
Бюджет - SYNC_RUN_BUDGET_MS, типово 240 с при ліміті функції 300 с. Перший крок виконується завжди; якщо час вийшов, відповідь несе more: true і next, а наступний виклик продовжує з курсора sync_lock.step

Кроки 4-18; фіолетовий пунктир - у роботі

Порядок жорсткий: види цін першими, бо ціни й контрагенти зводять ВидЦен_Key через price_type_map; борг - після контрагентів
Каталог - єдина дельта: фільтр ДатаИзменения від watermark, сторінки по 5000. Перед нею крок щоразу читає довідки: групи, Catalog_КатегорииНоменклатуры, Catalog_СтраныМира і зріз цін. Решта кроків читають повні зрізи без пагінації
Кожен запит до 1С несе X-Portal-Key, коли задано BAS_EDGE_KEY. Шлюз окремою стрілкою показано раз, на кроках 4-5; решта стрілок до OData 1С ідуть тим самим шляхом
Добір черги (крок 17) планується, лише коли ORDERS_DISPATCH_MODE не runner: до 50 рядків orders_outbox у станах queued і failed за прогін. Кроки 17 і 18 додає план прогону runSync; у списку syncSteps їх немає
reconcile (крок 18) - кожен N-й прогін, SYNC_RECONCILE_EVERY_N, типово 96: звіряє кількість номенклатури і контрагентів у 1С і в репліці, розбіжність лише пише в лог
Фіолетовий пунктир - у роботі, у main цього ще немає: канали ORDERS_CREATE_VIA і ORDERS_CHANGE_VIA, клієнт сервісу /hs/portal, стан черги rejected. У цьому циклі зміниться лише доставка черги: крок 17 і доставка виконавцем. Читання 4-16, знімки, борг і фото лишаються на OData

Коли 1С не відповідає

Таймаут одного запиту - BAS_ODATA_TIMEOUT_MS, типово 90 с; у скрипта виконавця - 60 с. Таймаут чи недоступність 1С - помилка лише свого кроку: наступні кроки виконуються
Крок зі збоєм читання у таблиці даних не пише: у sync_state стає status error, watermark не рухається. Репліка лишається з останнього вдалого прогону
Маршрут і тоді відповідає 200, помилка видна у steps[].error; 500 - лише на збій поза кроками, наприклад недоступна база лізи
Борг читається строго: відповідь без масиву value або з некоректним рядком - помилка всього зрізу, а не «боргів нема». Старіший зріз свіжішого не перетирає
Виконавець так само: збій читання чи публікації лишає попередній знімок, а портал показує час останнього вдалого зрізу

Окремий виконавець

Скрипт на машині з приватним доступом до 1С: один прохід і вихід, від накладання - PID-lock. Запуск щохвилини описаний у документації та коментарі коду; сам планувальник - поза репозиторієм
Адресу 1С і ключ шлюзу він бере зі свого середовища (BAS_ODATA_URL, BAS_EDGE_KEY), тож шлях через шлюз залежить від цієї адреси; на схемі показано прямий доступ
Знімок замовлень: усі сторінки Document_ЗаказПокупателя плюс повторний прохід Ref_Key і DataVersion; ознаку вагового товару дає Catalog_Номенклатура. Один пакет complete=true; ключ ORDERS_SYNC_SECRET дозволяє лише orders і debts; пакет понад 4 MB не надсилається
Борг (кроки 26-28): і читання, і публікація не частіше ніж раз на 10 хв від останнього вдалого зрізу, після збою - не раніше ніж за 2 хв; вимикає ORDERS_SYNC_DEBTS=off. Реєстр той самий, що й у кроці 15
З ORDERS_DISPATCH=on той самий запуск спершу доставляє в 1С до 10 замовлень з черги: маршрути /api/sync/orders-outbox/claim і report, окремий ключ ORDERS_DISPATCH_SECRET
Фото (крок 29) - окремий скрипт зі своїм розкладом: читає Catalog_Номенклатура, довідник НоменклатураПрисоединенныеФайлы і регістр відомостей ДвоичныеДанныеФайлов, кладе WebP у приватне сховище Cloudflare R2, а не в базу порталу. Розклад (раз на добу) підтверджений лише документацією