How basiltt/candleviewer works
CandleViewer is a pre-alpha charting platform with a React web client, GPU-oriented chart-engine package, and Python API. The implemented backend has concrete ingestion, instrument-catalogue, market-data, authentication, audit, and trading-domain modules; the README’s indicators, scripting, collaboration, and richer charting features are largely roadmap goals, so those are shown as planned capabilities rather than verified runtime integrations. The clearest evidenced runtime path is web app startup and routing, plus API composition and lifecycle. Several API modules were not sampled, so some subsystem links are documented or left unverified.
Main entry points: app.py API composition · main.tsx Web application · main.py ASGI lifecycle · service.py Feed ingestion
Components 22
Client
- Web application
apps/web/src/main.tsx - Route tree
apps/web/src/routes/tree.tsx - Chart engine
packages/chart-engine/src/core/handle.ts - Desktop shell
apps/desktop/src/main/shellPort.ts
Market data
- Feed ingestion
services/api/candleviewer/ingestion/service.py - Instrument refresh
services/api/candleviewer/ingestion/instruments_refresh.py - Exchange adapters
services/api/candleviewer/exchange/base/instruments.py - Market data store
services/api/candleviewer/storage/questdb/repository.py
API and domains
- API composition
services/api/candleviewer/app.py - ASGI lifecycle
services/api/candleviewer/main.py - Storage lifecycle
services/api/candleviewer/storage/service.py - Domain events
services/api/candleviewer/domain/events.py - Trading services
services/api/candleviewer
Identity and audit
- Session service
services/api/candleviewer/auth/session_service.py - Session endpoints
services/api/candleviewer/api/sessions.py - Audit queries
services/api/candleviewer/audit/query.py
Planned capabilities
- Indicators
- Alerts
services/api/candleviewer/alerts/service.py - Replay and backtest
services/api/candleviewer/replay/service.py - Script sandbox
- Live collaboration
Other components
- Trader
Connections 21
- Trader → Web application: uses
README.md - Web application → Route tree: renders
- Web application → API composition: REST / WebSocket
README.md - Chart engine → Web application: renders charts
README.md - Desktop shell → Web application: hosts client
README.md - ASGI lifecycle → API composition: creates app
services/api/candleviewer/main.py - ASGI lifecycle → API composition: starts modules
services/api/candleviewer/main.py - API composition → Feed ingestion: composes modules
services/api/candleviewer/app.py - Feed ingestion → Instrument refresh: starts scheduler
services/api/candleviewer/ingestion/service.py - Instrument refresh → Exchange adapters: refreshes instruments
services/api/candleviewer/ingestion/instruments_refresh.py - Storage lifecycle → Market data store: owns tier
- API composition → Storage lifecycle: composes modules
services/api/candleviewer/app.py - API composition → Session endpoints: registers endpoints
services/api/candleviewer/app.py - Session endpoints → Session service: uses sessions
- Session service → Market data store: persists sessions
- API composition → Trading services: supervises modules
services/api/candleviewer/app.py - Trader → Indicators: analyzes charts
README.md - Trader → Alerts: configures alerts
README.md - Trader → Replay and backtest: tests strategies
README.md - Trader → Script sandbox: writes scripts
README.md - Trader → Live collaboration: co-edits charts
README.md