amirmehtab1973/digital-pakistan-quiz-system
0
Digital Pakistan Quiz Management System
A comprehensive quiz management system for educational institutions with separate panels for teachers and students.
🎯 Features
👨🏫 Teacher Admin Panel
- Secure Login: Admin authentication system
- Document Upload: Upload PDF/DOCX files with MCQs
- Auto Parsing: Automatically extracts questions and options
- Answer Setting: Set correct answers for each question
- Quiz Management: Enable/disable quizzes for students
- Results Dashboard: View all student results
- Excel Reports: Generate detailed student performance reports
🎓 Student Panel
- No Login Required: Students can directly access quizzes
- Quiz Selection: Choose from available enabled quizzes
- Interactive Interface: Clean, integrated question display
- Instant Results: Immediate score feedback after submission
- Privacy Protected: Students only see their own results
💾 Data Persistence
- Automatic Saving: All data persists across restarts
- JSON Storage: Quizzes, answers, and student records are saved
- Reliable Recovery: Data automatically loads on startup
🛠️ How to Use
For Teachers:
- Go to Teacher Admin Panel tab
- Login with credentials:
- Username:
admin - Password:
Admin123 - Upload PDF/DOCX files containing MCQs
- Set correct answers for each question
- Enable quizzes for students
- Monitor student results and generate reports
For Students:
- Go to Student Panel tab
- Select an available quiz
- Enter your name and email
- Answer all questions
- Submit to see your score
📁 Supported File Formats
- PDF (.pdf) - With extractable text
- Word Documents (.docx) - Standard DOCX format
🔧 Technical Details
- Built with Gradio for the interface
- Uses PyPDF2 and python-docx for document parsing
- Pandas for data management and reporting
- JSON files for persistent storage
🚀 Deployment
This app is deployed on Hugging Face Spaces and automatically handles all dependencies and persistence.
Developed for Digital Pakistan Initiative