How teddykwok/trading-alert-dashboard works
Trading Alert Dashboard is a single-operator system for ingesting TradingView alerts, enriching them with chart and AI analysis, and monitoring results live. Its principal workflow is webhook validation and persistence, queued worker processing, then browser updates and optional Telegram notification. The repository also includes a distinct execution and operator-control surface, including safety/capacity checks and trading-session controls, plus alert review and risk planning. Workflow links are grounded in the README; source excerpts provide only partial evidence for execution internals, so those links are limited to visible calls and imports.
Main entry points: vision-analysis.worker.ts Vision worker · webhook.routes.ts Webhook endpoint · App.tsx Dashboard app · trading-control-actions.service.ts Trading control actions
Components 27
Alert ingestion
- Webhook endpoint
apps/backend/src/routes/webhook.routes.ts - Payload validation
apps/backend/src/modules/webhook/webhook.schema.ts - Alert service
apps/backend/src/modules/alerts/alerts.service.ts
Alert analysis
- Vision worker
apps/backend/src/modules/jobs/vision-analysis.worker.ts - Market data
apps/backend/src/modules/market-data/market-data.service.ts - Binance provider
apps/backend/src/modules/market-data/binance.provider.ts - Mock candles
apps/backend/src/modules/market-data/mock-candles.ts - Chart rendering
apps/backend/src/modules/chart-renderer/chart-renderer.service.ts - Screenshot capture
apps/backend/src/modules/chart-renderer/screenshot.service.ts - AI vision analysis
apps/backend/src/modules/ai-vision/ai-vision.service.ts - OpenAI provider
apps/backend/src/modules/ai-vision/openai.provider.ts
Dashboard and review
- Realtime events
apps/backend/src/plugins/socket.ts - Telegram notifications
apps/backend/src/modules/notifications/telegram.service.ts - Dashboard app
apps/frontend/src/App.tsx - API client
apps/frontend/src/api/client.ts - Trade review service
apps/backend/src/modules/trade-review/trade-review.service.ts - Review repository
apps/backend/src/modules/trade-review/trade-review.repository.ts
Execution controls
- Operator routes
apps/backend/src/routes/operator.routes.ts - Trading control actions
apps/backend/src/modules/operator/trading-control-actions.service.ts - Safety decisions
apps/backend/src/modules/execution/safety-engine.ts - Canary readiness
apps/backend/src/modules/execution/canary-readiness.ts - Trading session
apps/backend/src/modules/execution/trading-session.ts - Execution capacity status
apps/backend/src/modules/execution/capacity-status.ts
Other components
- TradingView
- PostgreSQL
- Redis / BullMQ
- Operator browser
Connections 30
- TradingView → Webhook endpoint: sends alert
README.md - Webhook endpoint → Payload validation: validates payload
README.md - Webhook endpoint → Alert service: persists alert
README.md - Webhook endpoint → Realtime events: broadcasts event
README.md - Webhook endpoint → Redis / BullMQ: enqueues job
README.md - Alert service → PostgreSQL: writes alert
README.md - Redis / BullMQ → Vision worker: dispatches job
README.md - Vision worker → Market data: requests candles
README.md - Market data → Binance provider: uses provider
README.md - Market data → Mock candles: uses fallback
README.md - Vision worker → Chart rendering: renders chart
README.md - Chart rendering → Screenshot capture: captures image
README.md - Vision worker → AI vision analysis: analyzes screenshot
README.md - AI vision analysis → OpenAI provider: uses provider
README.md - Vision worker → PostgreSQL: saves result
README.md - Vision worker → Realtime events: broadcasts update
README.md - Vision worker → Telegram notifications: optionally notifies
README.md - Operator browser → Dashboard app: views dashboard
README.md - Dashboard app → API client: requests data
apps/frontend/src/App.tsx - API client → Webhook endpoint: calls backend
- Realtime events → Dashboard app: pushes updates
README.md - Dashboard app → Trade review service: submits reviews
README.md - Trade review service → Review repository: delegates reads
apps/backend/src/modules/trade-review/trade-review.service.ts - Review repository → PostgreSQL: reads and writes
apps/backend/src/modules/trade-review/trade-review.repository.ts - Dashboard app → Operator routes: uses control API
- Operator routes → Trading control actions: delegates actions
apps/backend/src/routes/operator.routes.ts - Trading control actions → Canary readiness: checks readiness
apps/backend/src/modules/operator/trading-control-actions.service.ts - Trading control actions → Trading session: validates session
apps/backend/src/modules/operator/trading-control-actions.service.ts - Trading control actions → Execution capacity status: reads capacity
apps/backend/src/modules/operator/trading-control-actions.service.ts - Safety decisions → Execution capacity status: uses capacity key
apps/backend/src/modules/execution/safety-engine.ts