🚀 CodeAlert

Competitive Programming Tracker & Contest Reminder

CodeAlert is a full-stack mobile application built to centralize competitive programming activities across multiple coding platforms.

Track ratings, solved questions, upcoming contests, and reminders — all from one dashboard.

---

📌 Features

✅ User Authentication (Signup/Login)

✅ JWT Session Management

✅ Platform Handle Integration

✅ Contest Tracking

✅ Contest Countdown Timer

✅ Coding Profile Monitoring

✅ Theme Support (Dark / Light)

---

🏗️ High Level Design (HLD)

System Overview

---

⚙️ Low Level Design (LLD)

Frontend Structure

---

Backend Structure

backend/
│
├── app/
│
├── routers/
│   ├── users.py
│   ├── dashboard.py
│   ├── contests.py
│   ├── leetcode.py
│   ├── codeforces.py
│   ├── reminders.py
│
├── auth/
│   └── auth_handler.py
│
├── database/
│   └── database.py
│
└── main.py

---

🧩 System Architecture

---

🗄️ Database Schemas

users

{
 "_id":"ObjectId",
 "name":"Revant",
 "email":"user@gmail.com",
 "password":"****",
 "handles":{
   "cf_handle":"abc",
   "lc_handle":"xyz"
 }
}

---

lc_profile

{
"user_id":"123",
"rating":1824,
"global_ranking":40000,
"problems_solved":745
}

---

cf_profile

{
"user_id":"123",
"rating":1487
}

---

contests

{
"name":"Weekly Contest",
"platform":"LeetCode",
"start_time":"timestamp"
}

---

reminders

{
"user_id":"123",
"contest_name":"Codeforces Round",
"time":"timestamp"
}

---

🔌 API Endpoints

Auth

POST /signup
POST /login

User

PUT /users/handles
POST /dashboard/sync

Contest

GET /contests

Reminder

POST /reminder
GET /reminders/{id}

---

🛠️ Tech Stack

Frontend

Backend

Database

---

External APIs

• LeetCode GraphQL
• Codeforces API
• CodeChef Data Source

---

📈 Current Progress

Completed

• Authentication
• JWT Login
• Contest Fetch
• Contest Countdown
• Profile Page
• Platform Handle Setup
• Dashboard Sync
• Rating Tracking
• Questions Solved Tracking
• Theme Support
• Auto Refresh

---

In Progress

• Notification Integration
• Profile Analytics
• Contest Filtering
• Better Error Handling
• Background Sync

---

Planned

• Push Notifications
• Leaderboards
• AI Contest Recommendation
• Statistics Dashboard
• Activity Graph
• Multi-device Sync

---

🚀 Installation

git clone <repo>

cd codealert

flutter pub get

flutter run

Backend:

cd backend

uvicorn app.main:app --host 0.0.0.0 --reload

---

👨‍💻 Contributors

Built with ❤️ using Flutter + FastAPI + MongoDB