How shashwat-akhilesh-shukla/fintracker works
Project Type and Purpose
• This is a full-stack, microservices-based financial portfolio management platform (“FinTracker Pro”) with:
• A React/TypeScript SPA frontend
• FastAPI-based backend microservices (API Gateway, Auth, Portfolio, News)
• A machine-learning component for AI-powered insights
• A data layer (PostgreSQL, Redis) and external APIs for market data and news
File Structure
• Top Level:
• backend/ (microservices)
• frontend/ (React + Redux + Material-UI)
• ml/ (model training & serving)
• infrastructure/ (Dockerfiles, config for Nginx, Postgres, Redis)
• docker-compose.yml orchestrates all containers
• backend/: Each service follows the same pattern:
• app/api/v1/endpoints → HTTP routes
• app/core → config, database, security
• app/models & schemas → Pydantic + SQLAlchemy
• app/services → business logic
• frontend/:
• src/pages → route-level components
• src/components → charts, common UI, layouts, sections
• src/services → API client wrappers
• src/store → Redux slices & RTK Query
• ml/:
• scripts/train.py → model training
• scripts/serve.py → model serving API
• models/price_model.pkl → trained artifact
README for Additional Insights
• Confirms microservices architecture with ports:
• API Gateway (8080) → Auth (8001), Portfolio (8002), News (8003)
• Data layer: three separate PostgreSQL instances + Redis cache
• External APIs: Alpha Vantage, Finnhub, NewsAPI
• ML: sentiment analysis and market prediction
• Infrastructure: Docker Compose, health checks, structured logging
Detailed Focus
• Service’s database and any caching or external API calls
• ML ingestion/training vs. serving pathways if needed
• Infrastructure elements (Docker network, Nginx) at the top or side