How wakeensito/clearvest works
ClearVest is an AI investment companion: users explore markets and learning content, link portfolio holdings, and receive personalized text or voice guidance. The frontend routes users to those experiences and calls a four-domain HTTP API; market history can refresh asynchronously, while shared backend services provide storage, caching, provider access, and advisor context. The graph preserves major README capabilities. Some links are documented or supported only by the SOURCE INDEX; unsampled implementation details are not inferred.
Main entry points: client.ts API client · portfolio/app.py Portfolio API · market/app.py Market API · router.tsx Page router
Components 34
Client experience
- Page router
frontend/src/router.tsx - API client
frontend/src/api/client.ts - Portfolio views
frontend/src/pages/PortfolioPage.tsx - Market views
frontend/src/pages/MarketsPage.tsx - Advisor chat
frontend/src/features/advisor/AdvisorPage.tsx - Learn experience
frontend/src/features/learn/LessonPage.tsx
Portfolio domain
- Portfolio API
src/portfolio/portfolio/app.py - Holdings and linking
src/portfolio/portfolio/routes/holdings.py - Account linking
src/portfolio/portfolio/routes/plaid.py - Exposure analysis
src/portfolio/portfolio/routes/exposure.py - Portfolio risk
src/portfolio/portfolio/routes/risk.py
Market research
- Market API
src/market/market/app.py - Security search
src/market/market/routes/search.py - Company research
src/market/market/routes/research.py - Fund analysis
src/market/market/routes/fund.py - Price history
src/market/market/routes/history.py - History refresh
src/market/market/history_refresh.py - Refresh worker
src/market/market/refresh_worker.py
Guidance and learning
- Advisor API
src/advisor/advisor/app.py - Chat route
src/advisor/advisor/routes/chat.py - Grounded advisor
src/layer/clearvest/advisor.py - Evidence context
src/layer/clearvest/scout_context.py - Voice API
src/voice/voice/app.py - Voice turn
src/voice/voice/routes/turn.py - Learning content
frontend/src/features/learn/LearningPractice.tsx
Shared backend
- HTTP framework
src/layer/clearvest/api.py - Provider cache
src/layer/clearvest/cache.py - Data access
src/layer/clearvest/db.py
Other components
- Investor
- DynamoDB
- Bedrock
- Plaid
- SQS queue
- Market data providers
Connections 44
- Investor → Page router: uses
README.md - Page router → Portfolio views: routes to
frontend/src/router.tsx - Page router → Market views: routes to
frontend/src/router.tsx - Page router → Advisor chat: routes to
frontend/src/router.tsx - Page router → Learn experience: routes to
frontend/src/router.tsx - Portfolio views → API client: requests data
- Market views → API client: requests data
- Advisor chat → API client: requests guidance
- Learn experience → Learning content: uses
- API client → Portfolio API: calls HTTP API
README.md - API client → Market API: calls HTTP API
README.md - API client → Advisor API: calls HTTP API
README.md - API client → Voice API: calls HTTP API
README.md - Portfolio API → HTTP framework: configures
src/portfolio/portfolio/app.py - Portfolio API → Holdings and linking: registers
src/portfolio/portfolio/app.py - Portfolio API → Account linking: registers
src/portfolio/portfolio/app.py - Portfolio API → Exposure analysis: registers
src/portfolio/portfolio/app.py - Portfolio API → Portfolio risk: registers
src/portfolio/portfolio/app.py - Holdings and linking → Data access: reads and writes
src/portfolio/portfolio/routes/holdings.py - Account linking → Holdings and linking: refreshes snapshot
src/portfolio/portfolio/routes/plaid.py - Account linking → Plaid: calls
src/portfolio/portfolio/routes/plaid.py - Market API → HTTP framework: configures
src/market/market/app.py - Market API → Security search: registers
src/market/market/app.py - Market API → Company research: registers
src/market/market/app.py - Market API → Fund analysis: registers
src/market/market/app.py - Market API → Price history: registers
src/market/market/app.py - Security search → Market data providers: queries providers
src/market/market/routes/search.py - Price history → History refresh: requests refresh
src/market/market/routes/history.py - Price history → Market data providers: fetches prices
src/market/market/routes/history.py - Refresh worker → History refresh: processes jobs
src/market/market/refresh_worker.py - Refresh worker → SQS queue: consumes jobs
README.md - Advisor API → HTTP framework: configures
src/advisor/advisor/app.py - Advisor API → Chat route: registers
src/advisor/advisor/app.py - Chat route → Grounded advisor: generates reply
src/advisor/advisor/routes/chat.py - Chat route → Evidence context: loads context
src/advisor/advisor/routes/chat.py - Grounded advisor → Bedrock: generates response
src/layer/clearvest/advisor.py - Grounded advisor → Data access: reads and stores chat
src/layer/clearvest/advisor.py - Evidence context → Data access: reads cached evidence
src/layer/clearvest/scout_context.py - Voice API → HTTP framework: configures
src/voice/voice/app.py - Voice API → Voice turn: registers
src/voice/voice/app.py - Voice turn → Grounded advisor: gets guidance
src/voice/voice/routes/turn.py - Voice turn → Evidence context: loads context
src/voice/voice/routes/turn.py - Data access → DynamoDB: reads and writes
src/layer/clearvest/db.py - Provider cache → Data access: stores cache rows
src/layer/clearvest/cache.py