Major Refactor

[naveedkhan1998]

🚀 v1.3.0 — Impact v3: Data Model, API, and UI Overhaul

This release is a major architectural and performance upgrade across the backend data model, API layer, and charting UI. The focus of Impact v3 is scalability, bandwidth efficiency, and realistic market replay for technical analysis.

🔧 Backend: Candle Architecture Redesign

Problem (v2):

• A single Candle model stored both 1-minute and aggregated timeframe candles
• Heavy table scans, inefficient indexes, and high DB read egress
• Verbose API payloads with repeated key-value structures

Solution (v3):

• Split candle storage into two purpose-built models:

  • MinuteCandle → raw 1-minute candles
  • AggregateCandle → pre-aggregated higher timeframes

• Added time-series–friendly composite indexes for faster range queries and UI scans

• Optimized DB reads using values_list() to fetch only required fields, reducing unnecessary egress during large candle scans

📡 Candles API v3 (Breaking & Faster)

• Replaced v2 candles endpoint with Candles API v3

• Introduced cursor-based pagination using timestamps instead of offsets

  • Enables infinite scrolling, replay, and efficient historical navigation

• Reworked candle payload structure:

  • Before: list of objects ({ open, high, low, close, volume })
  • After: compact list[list] format + column metadata
  • Result: ~60% payload size reduction

🗜️ Bandwidth & Performance Gains

• Added GZip compression middleware on the backend

• Real-world results:

  • 1000 candles: ~250 KB → ~30 KB
  • Last 5 candles: ~0.6 KB

• Combined with payload restructuring, this dramatically improves:

  • Load times
  • Mobile usage
  • API cost efficiency

🎨 Frontend: Charting & UI Improvements

• Introduced a new theme and design system

• Refactored chart indicator architecture:

  • Modular, dynamic indicator registry
  • Mix & match indicators freely
  • Multiple EMAs with independent periods, colors, and visibility

• Merged volume chart directly into the main price chart

  • Eliminates separate panels
  • Better visual correlation with price action

• Expanded indicator support with proper composition rules

⏪ Candle Replay (Major UI Feature)

A fully integrated historical candle replay system:

• Step through real historical candles in sequence

• Indicators are recalculated per replay step

• Matches real-time behavior (no lookahead bias)

• Enables:

  • Strategy validation
  • Indicator behavior analysis
  • Education and debugging

This is not a visual mock — it’s a true data-driven replay pipeline tied directly to the new Candles API v3.

---

🧠 Why This Release Matters

Impact v3 lays the groundwork for:

• Large-scale historical datasets
• Lower infra and bandwidth costs
• Realistic backtesting and replay
• A more flexible and extensible charting system

This release prioritizes correctness, performance, and future scalability over surface-level features.

---

Full Changelog:
v1.1.0...v1.3.0

---

This discussion was created from the release Major Refactor.

[naveedkhan1998]

Check it out here: https://alpaca.mnaveedk.com