Skip to content

AhmedAlian7/Quizzly

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Quizzly Header

Quizzly - A Quickly Online Quiz Management System

Live Demo


🎯 Overview

Quizzly is an online quiz management system built with ASP.NET Core MVC that revolutionizes the way instructors create, manage, and grade quizzes. With AI-powered automated grading, real-time analytics, and an intuitive interface, Quizzly makes online assessments simple, efficient, and intelligent.

🌟 Why Quizzly?

  • πŸ€– AI-Powered Grading - Automated grading with Groq AI for consistent and fast results
  • πŸ“Š Advanced Analytics - Comprehensive insights into student performance and question difficulty
  • ⚑ Real-Time Experience - Instant feedback and live progress tracking
  • 🎨 Modern Interface - Responsive design that works seamlessly on all devices
  • πŸ”’ Secure & Scalable - Enterprise-grade security with role-based access control

πŸš€ Features

πŸ‘¨β€πŸ« For Instructors

πŸ“ Quiz Management
  • Multiple Question Types: MCQ, True/False, Short Answer, and Essay questions
  • Flexible Configuration: Time limits, shuffle options, passing scores, and attempt limits
  • Smart Access Control: Generate unique tokens for secure quiz distribution
  • Draft & Publish: Control when quizzes become available to students
  • Rich Media Support: Add images to questions using Cloudinary integration
βœ… Intelligent Grading System
  • AI-Powered Automation: Leverage Groq AI for consistent grading of subjective questions
  • Manual Grading: grades subjective questions with a manual grading tool
  • Flexible Scoring: Assign custom points per question
  • Detailed Analytics: Track grading patterns and identify trends
πŸ“ˆ Analytics & Reporting
  • Performance Dashboard: Real-time insights into student achievement
  • Question Analytics: Identify challenging questions and common mistakes
  • Score Distribution: Visual charts showing class performance
  • Time Tracking: Monitor average completion times
  • Category Insights: Performance breakdown by quiz categories
πŸ‘₯ Student Management
  • Progress Tracking: Monitor individual student journeys
  • Grade History: Complete records with timestamps and feedback
  • Performance Reports: Comprehensive student analytics

πŸŽ“ For Students

πŸ“š Quiz Taking Experience
  • One-Click Access: Join quizzes instantly with access tokens
  • Mobile Optimized: Seamless experience on any device
  • Smart Navigation: Easy movement between questions with progress indicators
  • Time Management: Real-time countdown timer and progress tracking
  • Auto-Save: Never lose your progress with automatic answer saving
🎯 Results & Feedback
  • Instant Results: Immediate feedback for auto-graded questions
  • Detailed Explanations: Comprehensive feedback and correct answers
  • History Tracking: Access all previous attempts and grades
  • Performance Insights: Track improvement over time with visual charts

βš™οΈ System Features

  • πŸ” Authentication: Google OAuth + ASP.NET Identity
  • πŸ€– AI Integration: Groq AI API for intelligent grading
  • πŸ“§ Email Notifications: Automated alerts for grading updates
  • ☁️ Cloud Storage: Cloudinary for image and file management
  • 🎨 Responsive Design: Bootstrap-powered modern UI

πŸ› οΈ Technology Stack

Backend

  • .NET 9.0 - Latest framework
  • ASP.NET Core MVC - Web framework
  • Entity Framework Core 9.0 - ORM
  • SQL Server - Database
  • ASP.NET Identity - Authentication

Frontend

  • Bootstrap 5 - UI framework
  • JavaScript (ES6+) - Interactivity
  • CSS3 - Modern styling
  • Razor Views - Server-side rendering

AI & Cloud Services

  • Groq AI API - Automated grading
  • Cloudinary - Image storage
  • SMTP/MailKit - Email service
  • Google OAuth 2.0 - Authentication

Architecture & Patterns

  • Repository Pattern & Unit Of Work - Clean data access layer
  • Dependency Injection - Built-in IoC container
  • MVC Architecture - Separation of concerns
  • Entity Framework Migrations - Database versioning

πŸ“Š Database Architecture

Database Diagram

Comprehensive database schema supporting all quiz and user management features


πŸ—οΈ Project Structure

Quizzly/
β”œβ”€β”€ 🌐 Quizzly.Web/                 # Web application layer
β”‚   β”œβ”€β”€ Areas/                       # MVC Areas for different user types
β”‚   β”‚   β”œβ”€β”€ Authentication/          # Login/Registration functionality
β”‚   β”‚   β”œβ”€β”€ Instructor/              # Instructor-specific features
β”‚   β”‚   └── Student/                 # Student-specific features
β”‚   β”œβ”€β”€ Controllers/                 # Main application controllers
β”‚   β”œβ”€β”€ Views/                       # Shared views and layouts
β”‚   └── wwwroot/                     # Static files (CSS, JS, images)
β”‚
β”œβ”€β”€ πŸ’Ό Quizzly.Business/             # Business logic layer
β”‚   β”œβ”€β”€ Services/                    # Service implementations
β”‚   β”‚   β”œβ”€β”€ Implementations/         # Concrete service implementations
β”‚   β”‚   └── Interfaces/              # Service contracts
β”‚   β”œβ”€β”€ ViewModels/                  # Data transfer objects
β”‚   └── Configuration/               # Application configuration
β”‚
β”œβ”€β”€ πŸ—„οΈ Quizzly.DataAccess/          # Data access layer
β”‚   β”œβ”€β”€ Entities/                    # Domain entities
β”‚   β”œβ”€β”€ Repositories/                # Repository pattern implementation
β”‚   β”œβ”€β”€ Data/                        # DbContext and configurations
β”‚   └── Migrations/                  # Entity Framework migrations
β”‚
└── πŸ“š docs/                         # Documentation and diagrams

πŸ“± Usage Guide

πŸ‘¨β€πŸ« For Instructors

graph LR
    A[Register/Login] --> B[Create Categories]
    B --> C[Build Quizzes]
    C --> D[Configure Settings]
    D --> E[Publish & Share]
    E --> F[Monitor & Grade]
    F --> G[Analyze Results]
Loading
  1. Register/Login - Create an instructor account or sign in
  2. Create Categories - Organize quizzes by subject or topic
  3. Build Quizzes - Add questions with various types and media
  4. Configure Settings - Set time limits, scoring, and access options
  5. Publish & Share - Generate access tokens and distribute to students
  6. Monitor & Grade - Track progress and grade manual questions
  7. Analyze Results - View comprehensive analytics and insights

πŸŽ“ For Students

graph LR
    A[Register/Login] --> B[Enter Token]
    B --> C[Take Quiz]
    C --> D[Submit Answers]
    D --> E[View Results]
    E --> F[Track Progress]
Loading
  1. Register/Login - Create a student account or sign in
  2. Enter Token - Use the access code provided by your instructor
  3. Take Quiz - Answer questions within the time limit
  4. Submit Answers - Review and submit your responses
  5. View Results - See scores and detailed feedback
  6. Track Progress - Access your complete quiz history

πŸ’‘ Getting Started

Want to try Quizzly? Visit our Live Demo to experience the platform firsthand!


🌟 Star Us!

If you find Quizzly helpful, please consider giving us a star ⭐


Quizzly - Make taking online quizzes more quickly βœ¨πŸ˜‰

Quizzly Logo

Β© 2025 Quizzly Team. All rights reserved.