Интеграции
Google Drive и Sheets
Google-интеграция используется для:
- папок заказов;
- папок отгрузок;
- шаблонов заказов;
- таблиц заказов покупателей;
- синхронизации SKU;
- синхронизации изделий;
- синхронизации контрагентов;
- синхронизации плана отгрузок;
- хранения сгенерированных документов.
Пользовательские и системные OAuth-сценарии доступны через api/auth/google/*.
Vault
Vault используется для секретов системных и Google-авторизаций. Конфигурация API содержит mount point, имена ролей, role ids, token settings и secret paths.
DaData
DaData настроена через token, secret, daily limit, reserved count и RPS. Сервис используется в сценариях обогащения или проверки данных контрагентов и адресов.
1C
API содержит endpoints импорта файлов, связанных с 1C, включая синхронизацию заказов покупателей и счетов на оплату.
Логи и объектное хранилище
Serilog пишет логи в console, локальные файлы и S3-совместимое объектное хранилище. Отдельные sinks настроены для общих логов, ошибок и changelog-событий.
RequestId и клиентские UX error (ITR-3097 / 3099 / 3100)
На stage (бек PR #756, фронт PR #789).
Заголовок ответа. Каждый HTTP-ответ API отдаёт X-Request-Id (middleware). Тот же id пишется в Serilog как свойство RequestId. Клиент может прислать свой id во входящем заголовке (с санитизацией). CORS: заголовок в exposed headers — браузер может его прочитать.
Клиентские сбои. Авторизованный фронт шлёт отчёты на приём диагностик (POST …/ClientDiagnostics/error); в лог попадает строка с префиксом UX error:. Источники на фронте: axios interceptor, Error Boundary, window.error / unhandledrejection. Не шлёт при HTTP 4xx и 500 (они уже на беке). Отправка через fetch (не через axios refresh/redirect) — сбой/401 отчёта не редиректит на логин. Rate limit ориентир 50/мин на IP; лимит тела ~10 КБ.
Как искать
- В логах / S3 найти текст
UX error:. - В свойствах записи смотреть
FrontendRequestId— этоX-Request-Idисходного бизнес-запроса (если фронт его передал). - Найти строки бизнес-API с тем же
RequestId(= этотFrontendRequestId). - Не путать: у самого POST приёма отчёта свой
RequestId— id приёма, не исходного вызова. - HTTP 4xx / 500 с клиента в
UX error:не ждать — смотреть серверные логи того запроса.
ТЗ эпика: client-error-logging.md.
SignalR
Хабы: /hubs/notifications (bearer access token).
- UX-уведомления: событие
NotificationsUpdated(счётчик + тело) конкретному пользователю → колокольчик / realtime чатов. - Инвалидация кеша: событие
InvalidateCache— не колокольчик. См. signalr-cache-invalidation.md.
Подробнее: notifications.md, chats.md.
Web Push
Опциональная доставка уведомлений и сообщений чата в браузер/ОС. Подписки в профиле пользователя; на один endpoint браузера — один владелец-сотрудник (ограничение браузера + уникальность в БД). См. notifications.md (§ Web Push).