Ultimate Crypto Analytics Platform

This repository is a full-stack, production-style project designed to showcase advanced skills across:

• Modern FastAPI backend with async I/O, auth, DB, and analytics
• React + Vite + TypeScript frontend with routing, charts, and dark mode
• Live API integration (Coindesk) + time series analytics (moving average)
• Persistent alerts stored in a database
• Auth with JWT + hashed passwords
• Dockerized dev experience + GitHub Actions CI

Architecture

• backend/

  • app/main.py – FastAPI app, CORS, router wiring, startup hooks
  • app/models.py – SQLAlchemy models: User, PriceSnapshot, Alert
  • app/schemas.py – Pydantic schemas and DTOs
  • app/routers/ – modular API routes for auth, crypto, analytics, alerts
  • app/database.py – async engine + session
  • app/config.py – environment-based settings
  • tests/ – example pytest test

• frontend/

  • Vite + React + TypeScript
  • Auth screen, dashboard, alerts page, settings page
  • Recharts line chart for BTC price history
  • Dark/light theme toggle

Running Locally (Simple)

Backend

cd backend
pip install -r requirements.txt
uvicorn app.main:app --reload

Backend lives at: http://localhost:8000

Interactive docs:

• Swagger: http://localhost:8000/docs
• ReDoc: http://localhost:8000/redoc

Frontend

cd frontend
npm install
npm run dev

Frontend lives at: http://localhost:5173

Quick Start Flow

1. Start backend and frontend.
2. Visit the frontend in your browser.
3. Register a user (any email + password).
4. After login:
   • Hit Refresh Live Price on the dashboard to:
     • Fetch live BTC price from Coindesk via FastAPI
     • Persist it in the DB
   • View BTC price history and moving average.
   • Create alerts that are stored in the database.

Docker (Optional)

If you have Docker and Docker Compose:

docker-compose up --build

This starts both backend and frontend containers.

CI

A minimal GitHub Actions workflow (.github/workflows/ci.yml) runs backend tests on push and PRs.