How derrickvericho/intelflow works
IntelFlow is an IDX-stock market-intelligence application. Users search for a ticker and open IntelScore or shareholder research; the backend gathers provider data, builds flow and fundamental evidence, calculates scores, and returns research responses. It also exposes separate flow, price-history, shareholder, and broker-series endpoints. The README documents Redis-backed caching and the Sectors API dependency. Some frontend feature and backend gateway internals are unsampled, so their detailed wiring is not inferred.
Main entry points: App.tsx Routes and shell · research.py Research service · cached.py Cached gateway · routes.py Stock API routes
Components 25
Frontend
- Routes and shell
src/frontend/app/App.tsx - Ticker search
src/frontend/components/SymbolSearch.tsx - IntelScore page
src/frontend/pages/IntelScorePage.tsx - Home research
src/frontend/pages/HomePage.tsx - Shareholder search
src/frontend/pages/ShareholdersSearchPage.tsx - Shareholder page
src/frontend/pages/ShareholdersPage.tsx - Flow feature
src/frontend/features/flow/FlowSection.tsx - Fundamentals feature
src/frontend/features/fundamentals/Fundamentals.tsx - Score feature
src/frontend/features/scores/Scores.tsx - Trends feature
src/frontend/features/trends/Trends.tsx - Shareholder composition
src/frontend/features/shareholders/composition.ts - HTTP client
src/frontend/api/client.ts
API and research
- Stock API routes
src/backend/api/routes.py - Research service
src/backend/services/research.py - Score calculations
src/backend/scoring - Research models
src/backend/models
Data integrations
- Cached gateway
src/backend/sectors/cached.py - Provider gateway
src/backend/sectors/gateway.py - Sectors client
src/backend/sectors/client.py - Redis cache
src/backend/cache/store.py
Application runtime
- App assembly
src/backend/main.py
Other components
- Investor
- Sectors API
- Redis
- Web browser
Connections 19
- Investor → Ticker search: enters ticker
- Ticker search → Routes and shell: navigates to
- Routes and shell → Home research: routes to
- Routes and shell → IntelScore page: routes to
- Routes and shell → Shareholder search: routes to
- Routes and shell → Shareholder page: routes to
- Web browser → HTTP client: requests data
- HTTP client → Stock API routes: HTTP requests
- App assembly → Stock API routes: mounts
- App assembly → Research service: constructs
- Stock API routes → Research service: calls use cases
- Research service → Cached gateway: requests market data
- Cached gateway → Provider gateway: delegates misses
- Cached gateway → Redis cache: reads and writes
- Provider gateway → Sectors client: calls provider client
- Sectors client → Sectors API: fetches data
- Redis cache → Redis: reads and writes
- Research service → Score calculations: calculates scores
- Research service → Research models: builds responses