🎓CampusFlow

A full-stack productivity platform designed to help students manage their academic life efficiently. The application combines task management, study tracking, reminders, notes, and analytics into a single system, helping students stay organized and improve their productivity.

---

🚀 Features

👤 Authentication & User Management

• Secure User Registration & Login
• JWT Authentication
• Protected Routes
• Password Hashing with Bcrypt
• User-specific Data Isolation

---

📚 Subject Management

Organize academic work by subjects.

Example Subjects

• DBMS
• Operating Systems
• Java
• Data Structures & Algorithms

Features

• Create Subject
• Update Subject
• Delete Subject
• View All Subjects

---

✅ Task Management

Manage assignments, projects, and study goals.

Features

• Create Tasks
• Update Tasks
• Delete Tasks
• Mark Tasks as Completed
• Set Priority Levels
• Set Due Dates
• Filter Tasks by Subject

Example

Subject: DBMS

Task:
Learn SQL Joins

---

📝 Subtask Management

Break large tasks into smaller actionable steps.

Example

Task: Build Authentication System

Subtasks:
✓ Create User Table
✓ Register API
□ Login API
□ JWT Middleware

---

📖 Notes Management

Store study notes for each subject.

Features

• Create Notes
• Update Notes
• Delete Notes
• Subject-wise Organization
• Search Notes

---

⏱️ Study Session Tracker

Track daily study time and productivity.

Features

• Start Study Session
• End Study Session
• Calculate Study Duration
• Subject-wise Tracking
• Daily & Weekly Statistics

Example

Subject: DBMS

Start Time: 7:00 PM
End Time: 9:00 PM

Duration: 120 Minutes

---

🔔 Smart Reminder System

Never miss an assignment or exam deadline.

Features

• Task Reminders
• Assignment Reminders
• Email Notifications
• Automated Alerts

Example

Reminder:

DBMS Assignment Due Tomorrow

---

📊 Analytics Dashboard

Visualize productivity and study performance.

Metrics

• Total Tasks Completed
• Study Hours
• Weekly Progress
• Subject-wise Performance
• Productivity Trends

---

🤖 AI Study Planner (Future Enhancement)

Generate personalized study schedules using AI.

Example

Input:
Exam in 30 Days

Subjects:
- DBMS
- OS
- Java

Output:
Week 1 → DBMS
Week 2 → OS
Week 3 → Java
Week 4 → Revision

---

🏗️ Tech Stack

Frontend

• React.js
• Tailwind CSS
• Axios
• React Router

Backend

• Node.js
• Express.js

Database

• PostgreSQL

Authentication

• JWT
• Bcrypt

Automation

• Node Cron
• Nodemailer

Deployment

• Vercel
• Render
• Neon PostgreSQL

---

🗄️ Database Schema

Users

id UUID PRIMARY KEY
name VARCHAR(255)
email VARCHAR(255)
password_hash TEXT
created_at TIMESTAMP

Subjects

id UUID PRIMARY KEY
user_id UUID
name VARCHAR(255)
color_hex VARCHAR(10)

Tasks

id UUID PRIMARY KEY
user_id UUID
subject_id UUID
title VARCHAR(255)
description TEXT
priority VARCHAR(50)
status VARCHAR(50)
due_date TIMESTAMP

Subtasks

id UUID PRIMARY KEY
task_id UUID
title VARCHAR(255)
completed BOOLEAN

Notes

id UUID PRIMARY KEY
user_id UUID
subject_id UUID
title VARCHAR(255)
content TEXT

Study Sessions

id UUID PRIMARY KEY
user_id UUID
subject_id UUID
started_at TIMESTAMP
ended_at TIMESTAMP
duration_minutes INT

Reminders

id UUID PRIMARY KEY
task_id UUID
remind_at TIMESTAMP
sent BOOLEAN

---

🔗 Entity Relationship Flow

User
│
├── Subjects
│     │
│     ├── Tasks
│     │     │
│     │     ├── Subtasks
│     │     └── Reminders
│     │
│     ├── Notes
│     │
│     └── Study Sessions
│
└── Analytics

---

📡 API Endpoints

Authentication

POST /api/auth/register
POST /api/auth/login
GET  /api/auth/profile

Subjects

POST   /api/subjects
GET    /api/subjects
PUT    /api/subjects/:id
DELETE /api/subjects/:id

Tasks

POST   /api/tasks
GET    /api/tasks
PUT    /api/tasks/:id
DELETE /api/tasks/:id

Notes

POST   /api/notes
GET    /api/notes
PUT    /api/notes/:id
DELETE /api/notes/:id

Study Sessions

POST /api/study-sessions/start
POST /api/study-sessions/end
GET  /api/study-sessions

Analytics

GET /api/analytics

---

📅 Development Roadmap

Phase 1

• Authentication System
• PostgreSQL Setup
• User Management

Phase 2

• Subject Management
• Task Management
• Subtask Management

Phase 3

• Notes Module
• Study Session Tracking

Phase 4

• Reminder System
• Email Notifications
• Scheduled Jobs

Phase 5

• Analytics Dashboard
• Reports & Statistics

Phase 6

• AI Study Planner
• Google Calendar Integration

---

🎯 Project Goals

• Improve student productivity
• Automate academic task management
• Track study habits and performance
• Reduce missed deadlines
• Provide actionable insights through analytics

---

📄 License

This project is licensed under the MIT License.

---

⭐ If you find this project useful, consider giving it a star on GitHub!