Перейти к основному содержимому

Интеграции

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 КБ.

Как искать

  1. В логах / S3 найти текст UX error:.
  2. В свойствах записи смотреть FrontendRequestId — это X-Request-Id исходного бизнес-запроса (если фронт его передал).
  3. Найти строки бизнес-API с тем же RequestId (= этот FrontendRequestId).
  4. Не путать: у самого POST приёма отчёта свой RequestId — id приёма, не исходного вызова.
  5. 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).