📚 EduTask Manager - Student Productivity System

A comprehensive Student Productivity Management System built with Spring Boot

Features • Architecture • Installation • Flow Diagrams • API

📋 Table of Contents

• ✨ Overview
• 🏗 System Architecture
• 📊 Flow Diagrams
• 🚀 Features
• 🛠 Technology Stack
• 📋 Prerequisites
• 🚀 Quick Start
• 📁 Project Structure
• 🎮 Usage Guide
• 🔧 API Endpoints
• 🐛 Troubleshooting
• 🤝 Contributing

✨ Overview

EduTask Manager is a powerful web application designed to help students and educators manage academic tasks, track deadlines, and boost productivity. With its intuitive interface and robust features, it streamlines the entire academic workflow.

🏗 System Architecture

High-Level Architecture Diagram

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   Client        │    │   Spring Boot    │    │   Database      │
│   (Browser)     │◄──►│   Application    │◄──►│   PostgreSQL    │
│                 │    │                  │    │                 │
│ - HTML/CSS/JS   │    │ - Controllers    │    │ - Students      │
│ - Bootstrap     │    │ - Services       │    │ - Tasks         │
│ - Thymeleaf     │    │ - Repositories   │    │ - Relations     │
└─────────────────┘    │ - Entities       │    └─────────────────┘
                       │ - Scheduling     │
                       └──────────────────┘

Component Architecture

┌─────────────────────────────────────────────────────────────────┐
│                      CLIENT LAYER                               │
├─────────────────────────────────────────────────────────────────┤
│  Thymeleaf Templates + Bootstrap + Custom CSS/JS                │
│  ┌─────────────┐ ┌─────────────┐ ┌─────────────┐               │
│  │   Home      │ │  Students   │ │   Tasks     │               │
│  │   Page      │ │   Pages     │ │   Pages     │               │
│  └─────────────┘ └─────────────┘ └─────────────┘               │
└─────────────────────────────────────────────────────────────────┘
                               │
┌─────────────────────────────────────────────────────────────────┐
│                    CONTROLLER LAYER                             │
├─────────────────────────────────────────────────────────────────┤
│  ┌─────────────┐ ┌─────────────┐ ┌─────────────┐               │
│  │ Home        │ │ Student     │ │ Task        │               │
│  │ Controller  │ │ Controller  │ │ Controller  │               │
│  └─────────────┘ └─────────────┘ └─────────────┘               │
└─────────────────────────────────────────────────────────────────┘
                               │
┌─────────────────────────────────────────────────────────────────┐
│                     SERVICE LAYER                               │
├─────────────────────────────────────────────────────────────────┤
│  ┌─────────────┐ ┌─────────────┐ ┌─────────────┐               │
│  │ Student     │ │ Task        │ │ Reminder    │               │
│  │ Service     │ │ Service     │ │ Service     │               │
│  └─────────────┘ └─────────────┘ └─────────────┘               │
└─────────────────────────────────────────────────────────────────┘
                               │
┌─────────────────────────────────────────────────────────────────┐
│                   REPOSITORY LAYER                              │
├─────────────────────────────────────────────────────────────────┤
│  ┌─────────────┐ ┌─────────────┐    Spring Data JPA            │
│  │ Student     │ │ Task        │    + Hibernate ORM            │
│  │ Repository  │ │ Repository  │                               │
│  └─────────────┘ └─────────────┘                               │
└─────────────────────────────────────────────────────────────────┘
                               │
┌─────────────────────────────────────────────────────────────────┐
│                    DATABASE LAYER                               │
├─────────────────────────────────────────────────────────────────┤
│  PostgreSQL Database with Tables:                               │
│  ┌─────────────┐        ┌─────────────┐                        │
│  │  students   │ ────── │   tasks     │                        │
│  │             │ 1:M    │             │                        │
│  └─────────────┘        └─────────────┘                        │
└─────────────────────────────────────────────────────────────────┘

📊 Flow Diagrams

1. Application Startup Flow

graph TD
    A[Spring Boot Application Start] --> B[Load Configuration]
    B --> C[Initialize Database Connection]
    C --> D[Create JPA Entities]
    D --> E[Run DataInitializer]
    E --> F[Create Demo Data]
    F --> G[Start Embedded Tomcat]
    G --> H[Register Thymeleaf Templates]
    H --> I[Application Ready on Port 8080]
    I --> J[Start Scheduled Tasks]

Loading

2. User Request Flow

sequenceDiagram
    participant U as User
    participant B as Browser
    participant C as Controller
    participant S as Service
    participant R as Repository
    participant DB as Database
    
    U->>B: Access URL
    B->>C: HTTP Request
    C->>S: Process Request
    S->>R: Data Operation
    R->>DB: SQL Query
    DB->>R: Return Data
    R->>S: Entity Objects
    S->>C: Processed Data
    C->>B: Thymeleaf Template + Data
    B->>U: Rendered HTML Page

Loading

3. Task Creation Flow

flowchart TD
    A[User Clicks 'Add Task'] --> B[Load Create Task Form]
    B --> C[Display Form with Student List]
    C --> D[User Fills Form Data]
    D --> E{Form Validation}
    E -->|Valid| F[Create Task Object]
    E -->|Invalid| G[Show Error Messages]
    G --> C
    F --> H[Set Task Properties]
    H --> I[Assign Student to Task]
    I --> J[Save Task to Database]
    J --> K[Show Success Message]
    K --> L[Redirect to Tasks List]

Loading

4. Student Management Flow

stateDiagram-v2
    [*] --> StudentList
    StudentList --> AddStudent: Click Add
    StudentList --> ViewStudent: Click View
    StudentList --> EditStudent: Click Edit
    StudentList --> DeleteStudent: Click Delete
    
    AddStudent --> SaveStudent: Submit Form
    ViewStudent --> StudentList: Back to List
    EditStudent --> UpdateStudent: Save Changes
    DeleteStudent --> ConfirmDelete: User Confirmation
    
    SaveStudent --> StudentList: Redirect
    UpdateStudent --> StudentList: Redirect
    ConfirmDelete --> StudentList: Refresh List
    
    StudentList --> [*]

Loading

5. Reminder System Flow

graph LR
    A[Scheduled Task<br/>Every Hour] --> B[Query Tasks Due Soon]
    B --> C{Check Conditions}
    C -->|Due in 24hrs| D[Send Reminder]
    C -->|Not Due| E[Skip]
    C -->|Completed| E
    C -->|Reminder Sent| E
    D --> F[Mark Reminder Sent]
    F --> G[Log Activity]
    E --> H[Wait Next Cycle]

Loading

6. Database Relationship Flow

erDiagram
    STUDENT ||--o{ TASK : creates
    STUDENT {
        bigint id PK
        varchar name
        varchar email UK
        varchar course
        datetime created_at
    }
    TASK {
        bigint id PK
        varchar title
        text description
        enum priority
        enum status
        datetime due_date
        datetime created_at
        boolean reminder_sent
        bigint student_id FK
    }

Loading

7. Complete User Journey Flow

journey
    title User Journey: Complete Task Management
    section Homepage
      Visit Homepage: 5: User
      View Statistics: 4: User
      See Recent Tasks: 3: User
    section Student Management
      Add New Student: 5: Admin
      View Student Details: 4: User
      Edit Student Info: 3: Admin
    section Task Management
      Create New Task: 5: User
      Assign to Student: 4: User
      Set Priority & Due Date: 5: User
      Track Progress: 4: User
      Mark Complete: 5: User
    section Dashboard
      View Analytics: 4: User
      Check Upcoming Deadlines: 5: User
      Monitor Productivity: 4: User

Loading

🚀 Features

🎯 Core Management

• 📝 Student Management - Complete CRUD operations for student profiles
• ✅ Task Management - Create, assign, and track academic tasks
• 🎯 Priority System - Four priority levels (LOW, MEDIUM, HIGH, URGENT)
• 📊 Status Tracking - Real-time progress monitoring (PENDING, IN_PROGRESS, COMPLETED, CANCELLED)
• ⏰ Automated Reminders - Smart deadline notifications
• 📈 Analytics Dashboard - Visual insights and productivity metrics

🎨 User Experience

• 💫 Modern UI - Beautiful gradient design with glass morphism effects
• 📱 Fully Responsive - Optimized for desktop, tablet, and mobile
• 🎭 Smooth Animations - Engaging hover effects and transitions
• ⚡ Real-time Updates - Instant feedback and flash messages
• 🔍 Intuitive Navigation - Clean, organized interface

🛠 Technology Stack

Backend

Technology	Version	Purpose
Java	17+	Core programming language
Spring Boot	3.2.0	Application framework
Spring Data JPA	3.2.0	Database operations
Spring MVC	6.2.12	Web layer
Spring Scheduling	6.2.12	Automated reminders

Frontend

Technology	Version	Purpose
Thymeleaf	3.1.3	Server-side templating
Bootstrap	5.3.0	CSS framework and components
Bootstrap Icons	1.10.0	Icon library
Custom CSS	-	Enhanced styling and animations

Database

Technology	Version	Purpose
PostgreSQL	17.6+	Primary database
Hibernate	6.6.33	ORM implementation
JPA	3.1.0	Data persistence specification

📋 Prerequisites

• Java Development Kit (JDK) 17 or higher
• Apache Maven 3.6 or higher
• PostgreSQL 17.6 or higher
• Git for version control

🚀 Quick Start

Step 1: Clone & Setup

git clone https://github.com/your-username/edutask-manager.git
cd edutask-manager

# Database setup
psql -U postgres -c "CREATE DATABASE edutask_db;"

Step 2: Configure

# application.properties
spring.datasource.url=jdbc:postgresql://localhost:5432/edutask_db
spring.datasource.username=postgres
spring.datasource.password=your_password

Step 3: Run

mvn clean spring-boot:run

Step 4: Access

http://localhost:8080

📁 Project Structure

src/main/java/com/edutask/
├── config/           # Configurations
├── controller/       # Web controllers  
├── model/           # JPA entities
├── repository/      # Data access
└── service/         # Business logic

🎮 Usage Guide

Student Management Flow

1. Add Student → Fill form → Validate → Save to DB
2. View Students → List all → Click details → Show profile + tasks
3. Edit Student → Load form → Update data → Save changes
4. Delete Student → Confirm → Remove + cascade delete tasks

Task Management Flow

1. Create Task → Select student → Set details → Validate → Save
2. Track Progress → Update status → Automatic reminders
3. Complete Task → Mark done → Update statistics

🔧 API Endpoints

Method	Endpoint	Description	Flow
GET	/students	List students	Controller → Service → Repository → DB
POST	/students/create	Create student	Form → Validation → Service → DB
GET	/tasks	List tasks	Query → Process → Render template
POST	/tasks/create	Create task	Form → Assign student → Save

🐛 Troubleshooting

Common Issues

1. DB Connection: Check PostgreSQL service and credentials
2. Port Conflict: Change server.port in properties
3. Template Errors: Clear cache, check Thymeleaf syntax
4. Bean Issues: Verify dependencies and configurations

🤝 Contributing

1. Fork the repository
2. Create feature branch (git checkout -b feature/amazing-feature)
3. Commit changes (git commit -m 'Add amazing feature')
4. Push to branch (git push origin feature/amazing-feature)
5. Open Pull Request

---

⭐ If you find this project helpful, please give it a star!

Happy Coding! 🚀

Built with ❤️ using Spring Boot and modern web technologies