How yaubernice/portfolytix works
Portfolytix is a personal portfolio workspace: users manage portfolios and transactions, then view ledger-derived holdings and portfolio analytics, with screening, market data, live quotes, and evidence-grounded explanations as supporting capabilities. The dashboard calls a FastAPI API; services apply domain logic over PostgreSQL and Redis. The README documents the main request and background-job flows. Some feature internals are unsampled, so those branches are shown only where documentation supports their connections.
Main entry points: main.py FastAPI application · market_data_job.py Market-data job · ledger_service.py Transaction ledger · __init__.py PostgreSQL
Components 22
User interfaces
- Next.js dashboard
web/app/portfolio/page.js - Web API client
web/lib/api.js
API and domain
- FastAPI application
app/main.py - Authentication
app/services/auth_service.py - Portfolio service
app/services/portfolio_service.py - Transaction ledger
app/services/ledger_service.py - Derived holdings
app/services/holdings.py - Portfolio analytics
app/services/analytics_service.py - Fundamental screening
app/services/screening_service.py - Research suggestions
app/services/research_service.py
Persistence and cache
- Live quote store
app/quotes/store.py - Data repositories
app/repositories/portfolio_repository.py - PostgreSQL
app/db/models/__init__.py - Redis cache
app/core/cache.py - Redis quote state
app/quotes/store.py
Market and assistant
- Evidence assistant
app/services/assistant_service.py - Evidence construction
app/ai/evidence.py - Market-data scheduler
app/jobs/scheduler.py - Market-data job
app/jobs/market_data_job.py - Market-data providers
app/market_data/factory.py - Live quote worker
app/workers/quote_worker.py
Other components
- Investor
Connections 23
- Investor → Next.js dashboard: uses
README.md - Next.js dashboard → Web API client: requests data
web/app/portfolio/page.js - Web API client → FastAPI application: calls API
README.md - FastAPI application → Authentication: authenticates
README.md - FastAPI application → Portfolio service: routes requests
README.md - Portfolio service → Data repositories: reads and writes
README.md - Transaction ledger → PostgreSQL: stores fills
README.md - Transaction ledger → Redis cache: queues invalidation
README.md - Portfolio service → Transaction ledger: records fills
README.md - Derived holdings → Transaction ledger: derives quantities
README.md - Portfolio analytics → Data repositories: loads portfolio data
app/services/analytics_service.py - Portfolio analytics → Redis cache: reads and caches
README.md - Fundamental screening → PostgreSQL: queries fundamentals
README.md - Research suggestions → PostgreSQL: reads snapshots
app/services/research_service.py - Evidence assistant → Portfolio analytics: loads evidence
README.md - Evidence assistant → Evidence construction: grounds answers
app/ai/evidence.py - Market-data scheduler → Market-data job: schedules job
README.md - Market-data job → Market-data providers: fetches market data
app/jobs/market_data_job.py - Market-data job → PostgreSQL: upserts prices
README.md - Market-data job → Redis cache: invalidates prices
README.md - Live quote worker → Live quote store: publishes quotes
app/workers/quote_worker.py - Live quote store → Redis quote state: stores and broadcasts
README.md - FastAPI application → Redis quote state: serves live quotes
README.md