KLKLine FrontendDashboard · Preview · Embed shell

Runtime integration scenarios

Bootstrap + Bars + Realtime contract scenario audit

این صفحه سناریوهای حساس اتصال فرانت/بک‌اند را بدون نیاز به روشن بودن backend واقعی چک می‌کند: bootstrap config، data quality، realtime envelope، stream contract و public identity validation. هدف این است که قبل از E2E واقعی، regressionهای خطرناک سریع دیده شوند.

Scenario count

5

این‌ها smokeهای قراردادی‌اند؛ جایگزین E2E واقعی نیستند ولی جلوی regressionهای رایج را می‌گیرند.

Passed

5

سناریوهایی که با قرارداد فعلی فرانت و بک‌اند سازگارند.

Failed

0

اگر عدد این بخش غیرصفر شد، قبل از اتصال real backend باید اصلاح شود.
pass

Runtime bootstrap config normalization

Bootstrap response maps backend snake_case/period objects into safe frontend runtime config without leaking the token.

bootstrap_runtime_config
  • allowed_periods -> allowedIntervals
  • runtime_token -> RuntimeBootstrapResponse.runtimeToken
pass

Bars data quality gate

Candles normalize seconds to milliseconds, replace duplicate timestamps and reject invalid order before chart runtime.

bars_data_quality_gate
  • seconds -> ms
  • duplicate timestamp replaced
  • BARS_INVALID_ORDER
pass

Socket.IO realtime envelope normalization

latest_update quality and candle_update partial/status metadata are consumed instead of guessing freshness from wall-clock time.

realtime_envelope_normalization
  • latest_update.payload.quality.status=stale
  • candle_update.payload.candle.partial=true
pass

Socket.IO stream contract guard

Stream namespace, subscribe payload and terminal security errors match the backend handoff contract.

socket_contract_guard
  • namespace=/v1/market/stream
  • subscribe={symbols,interval}
  • PLAN_WEBSOCKET_DISABLED terminal
pass

Public widget identity validation

Widget id and public key are accepted only in public-safe formats before bootstrap/embed/loader code paths.

public_identity_validation
  • valid widget id
  • valid public key
  • path traversal rejected
  • runtime-token-looking key rejected