About / Field Manual
Architecture
Data flow, services, and storage layers.
Architecture field manual
Architecture diagram
RankAlpha system overview
Data sources
Market Prices
Historical OHLCV and adjusted closes
Technical Inputs
Indicators, breadth, and screener signals
Research Inputs
News, AI memos, and valuation context
Ingestion
Fetch historical prices
Normalize Parquet files
Sync price facts
Scorer
Momentum and value factors
Model weights
Grades and screeners
AI Sentiment
AI memos
Scenario analysis
News sentiment
API Layer
FastAPI routers
Domain endpoints
Cached reads
Frontend
Next.js App Router
Rankings and research views
API-backed screens
Parquet Prices
/data/prices files
Canonical OHLCV schema
Adj Close preferred
Postgres
rankalpha schema
Scores, weights, news, AI outputs
Materialized views
Redis Cache
HTTP cache
Fast repeated reads
Refresh clears keys
Observability
Prometheus metrics
OpenTelemetry traces
Grafana dashboards
Storage layers
Zoom: 100%
Data flow
End-to-end path from raw data to user experience.
Prices
Historical OHLCV and adjusted close data
Ingestion
Collect, normalize, validate, deduplicate
Scorer
Compute factors, scores & rankings
AI Sentiment
Extract sentiment, events & insights
API
Serve cached domain endpoints
Frontend
Render API-backed research views
Use this diagram alongside Pipeline Health for live freshness checks.
Go to Pipeline Health