How madhvendra1027/arthalens works
ArthaLens is an India macroeconomic intelligence platform: users explore official economic series and provenance, compare methodology, inspect diagnostics, and ask citation-grounded research questions. The principal data path is source adapters through validation and ingestion into persistent data, then API domain services to the web experience. The README documents additional capabilities such as forecasts and sovereign ratings. Sampled source confirms selected service and storage calls; unsampled wiring is omitted where it cannot be established.
Main entry points: ApiApplication.java Spring REST API · pipeline.py Validate and ingest · app Next.js experience · GdpService.java GDP and revisions
Components 22
Web experience
- Next.js experience
apps/web/src/app - Charts and pages
apps/web/src/components - Auth provider
apps/web/src/hooks/useAuth.tsx
Data ingestion
- Official source adapters
services/ingestion/ingestion/adapters - Validate and ingest
services/ingestion/ingestion/pipeline.py - Run provenance
services/ingestion/ingestion/core/run_manager.py - Invalid-row quarantine
services/ingestion/ingestion/core/quarantine.py
REST API
- Spring REST API
services/api/src/main/java/com/arthalens/api/ApiApplication.java - Dashboard metrics
services/api/src/main/java/com/arthalens/api/domain/dashboard/service/DashboardService.java - GDP and revisions
services/api/src/main/java/com/arthalens/api/domain/gdp/service/GdpService.java - Deflator series
services/api/src/main/java/com/arthalens/api/domain/deflator/service/DeflatorService.java - Methodology comparison
services/api/src/main/java/com/arthalens/api/domain/methodology/service/MethodologyService.java - Economic indicators
services/api/src/main/java/com/arthalens/api/domain/indicators/service/IndicatorService.java - Sovereign ratings
services/api/src/main/java/com/arthalens/api/domain/ratings/service/RatingsService.java - Source provenance
services/api/src/main/java/com/arthalens/api/domain/sources/service/SourceService.java - AI orchestration
services/api/src/main/java/com/arthalens/api/domain/ai/service/AiOrchestrationService.java
Research intelligence
- Citation-grounded RAG
services/ai/rag - ML diagnostics and forecasts
services/ml/ml
User identity
- Auth routes
apps/web/src/app/api/auth - Redis sessions
apps/web/src/lib/redis.ts
Other components
- Researcher
- Macroeconomic data
Connections 24
- Researcher → Next.js experience: explores
- Next.js experience → Charts and pages: renders
- Next.js experience → Spring REST API: requests data
- Auth provider → Auth routes: calls auth
- Auth routes → Redis sessions: reads and writes
- Official source adapters → Validate and ingest: provides source data
- Validate and ingest → Run provenance: updates run
- Validate and ingest → Invalid-row quarantine: quarantines invalid rows
- Validate and ingest → Macroeconomic data: upserts valid rows
- Spring REST API → Dashboard metrics: dispatches
- Spring REST API → GDP and revisions: dispatches
- Spring REST API → Deflator series: dispatches
- Spring REST API → Methodology comparison: dispatches
- Spring REST API → Economic indicators: dispatches
- Spring REST API → Sovereign ratings: dispatches
- Spring REST API → Source provenance: dispatches
- Spring REST API → AI orchestration: dispatches
- GDP and revisions → Macroeconomic data: queries observations
- Deflator series → Macroeconomic data: queries series
- Methodology comparison → Macroeconomic data: queries versions
- Economic indicators → Macroeconomic data: queries indexes
- Sovereign ratings → Macroeconomic data: queries ratings
- Source provenance → Macroeconomic data: queries sources
- AI orchestration → Citation-grounded RAG: posts query