moex-vibe/apps/docs/docs/adr/ADR-003-rate-limiting-strategy.md
Sergey Krylov 106467e5c4
All checks were successful
CI / lint (pull_request) Successful in 2m8s
CI / test (pull_request) Successful in 1m57s
CI / build (pull_request) Successful in 2m5s
CI / lint (push) Successful in 2m1s
CI / test (push) Successful in 1m51s
CI / build (push) Successful in 2m9s
docs: translate docs to russian
2026-06-16 05:13:34 +03:00

1.7 KiB

ADR-003: Стратегия rate limiting для MOEX client

Статус: Accepted
Дата: 2026-06-13
Участники решения: Architect, Tech Lead

Контекст

MOEX ISS не документирует жёсткие лимиты на количество запросов, но массовые запросы могут привести к блокировке или ухудшению качества обслуживания. Backend является единственным клиентом MOEX и должен контролировать исходящий трафик.

Решение

Внедрить два механизма в MoexClient:

  1. Request queue (p-queue): конфигурируемый лимит запросов в секунду (по умолчанию: 10 req/s). Запросы сверх лимита ставятся в очередь и выполняются по расписанию.

  2. Circuit Breaker (@nestjs/axios + interceptor): при 5+ последовательных ошибках (5xx, timeout, network error) клиент перестаёт отправлять запросы к MOEX на 30 секунд. После таймаута — пробный запрос для восстановления.

Последствия

  • Плавная нагрузка на MOEX, без пиков
  • Автоматическое восстановление после сбоев MOEX
  • Graceful degradation: при отключённом circuit breaker возвращаются кешированные данные
  • Параметр конфигурации MOEX_RATE_LIMIT (int, req/s)