Skip to content

hanak13/hanak13.github.io

Repository files navigation

📚 Academic Portal

Complete Student Result & Examination Management System

A comprehensive web-based academic management system that handles student marksheet generation, exam management, and administrative tasks — all running in the browser with zero server setup.


🌟 Features

👨‍🏫 Staff Panel

  • Marksheet Management

    • Create digital marksheets with student bio-data
    • Multi-semester marks entry (up to 8 semesters)
    • Automatic SGPA/CGPA calculation
    • Grade assignment based on customizable grading rules
    • QR code generation for verification
    • PDF export (Semester & Season results)
    • Digital signature integration
  • Exam Management

    • Create online exams with MCQ and text-based questions
    • Add students to exam system
    • Configure exam duration
    • Publish exams for student access
  • Role-Based Access Control

    • Admin/All: Full access to marksheet + exam
    • Marksheet Only: Can only create marksheets
    • Exam Only: Can only manage exams

👨‍🎓 Student Panel

  • Marksheet Viewing

    • Search and view results using Roll Number + DOB
    • View Semester Result (all semesters combined)
    • View Season Result (current semester)
    • Print marksheets directly
    • QR code verification
  • Exam Portal

    • Take online exams
    • Auto-submit on timer expiry
    • View results (if enabled by staff)

🛠️ Developer Console

Advanced features for system administrators:

  1. User Management — Create/assign roles to staff and students
  2. Subject Control — Pre-define subject codes and names
  3. Files & Analytics — Search, filter, bulk operations, analytics dashboard
  4. Backup & Restore — Full JSON export/import
  5. Security — Activity log tracking
  6. Theme Customization — Colors, dark mode, custom logo & watermark
  7. Storage Monitor — Real-time storage usage tracking
  8. System Settings — Grading rules, default marks, signatures, year range

🚀 Installation

Quick Start (Browser)

  1. Download all files to a folder
  2. Open index.html in a modern browser (Chrome, Firefox, Edge)
  3. That's it! No server required.

File Structure

academic-portal/
├── index.html               # Main application
├── exam.html                # Exam system interface
├── exam.css                 # Exam system styles
├── exam.js                  # Exam system logic
├── style.css                # Main application styles
├── script.js                # Main application logic
├── logo.png                 # Institute logo
├── background.jpeg          # Login background
├── qrcode.min.js            # QR code generation
├── html2pdf.bundle.min.js   # PDF generation
└── README.md                # This file

🔐 Default Login Credentials

Staff (Admin - Full Access)

  • Username: system
  • Password: root
  • Role: All permissions (Marksheet + Exam)

Student

  • Username: student
  • Password: kiss

Developer

  • Username: dev
  • Password: changeme

⚠️ Security Note: Change ALL default credentials before going live!


📖 Usage Guide

For Staff - Creating a Marksheet

  1. Login with staff credentials
  2. Choose "Marksheet Management"
  3. Step 0: Enter institute & staff details
  4. Step 1: Enter student bio-data (photo, personal details, class/stream/honours)
  5. Step 2: Enter marks — navigate semesters with Prev/Next, enter Theory/Practical/Other + credits
  6. Preview updates automatically
  7. Click "SAVE DATA TO SYSTEM"
  8. Print using the print buttons

For Staff - Creating an Exam

  1. Login with staff credentials
  2. Choose "Exam Management"
  3. Add students via Roll + DOB
  4. Create exam: set title, timer, questions (MCQ or text), correct answers
  5. Click "Publish Exam"

For Students - Viewing Results

  1. Login with student credentials
  2. Choose "Check Marksheet"
  3. Select result type → Enter Roll Number + DOB → Search & View → Print

For Students - Taking Exam

  1. Login with student credentials
  2. Choose "Give Exam" → Enter Roll + DOB → Answer → Submit

🎨 Customization

What How
Institute Name Login as Staff → Step 0
Custom Logo Developer → Theme tab → Upload logo
Grading Rules Developer → Settings → Grading Logic
Subject Control Developer → Settings → Enable Subject Control

🔧 Advanced Features

Role-Based Staff Access

Developer → Settings → User Management → Select "Staff" → Choose role (All / Marksheet Only / Exam Only)

Bulk Import Students (CSV)

Developer → Bulk Ops → Upload CSV with columns: roll, fname, lname, email, dob, class, stream, honours, year

Firebase Cloud Backup (Optional)

Add your own Firebase config in script.js (firebaseConfig object) for cloud sync.


💾 Data Storage

  • Primary: Browser localStorage (works offline, ~10MB limit)
  • Optional: Firebase Firestore (auto-sync when online)
  • Backup: Developer → Backup → Download Complete Backup (JSON)

🌐 Browser Compatibility

Browser Support
Chrome 90+ ✅ Full
Edge 90+ ✅ Full
Firefox 88+ ✅ Full
Safari 14+ ✅ Full
Internet Explorer ❌ Not recommended

📱 Mobile Support

  • ✅ Responsive design for tablets
  • ✅ Student panel mobile-friendly
  • ✅ Exam system fully mobile-compatible
  • ⚠️ Staff marksheet creation — best on desktop

🐛 Troubleshooting

Issue Fix
"Storage is full" Developer → Files → Delete old records
Marksheet not saving Check localStorage is enabled; try non-incognito
PDF not printing Enable pop-ups; verify html2pdf.bundle.min.js is loaded
Student login not working Check DOB format: YYYY-MM-DD
Exam not showing Ensure exam is published and student is added to the system

🔒 Security Notes

For Production Use:

  1. Change all default passwords immediately
  2. Host on HTTPS only
  3. Implement server-side authentication
  4. Add IP whitelisting for staff panel
  5. Enable Firebase security rules
  6. Schedule regular backups
  7. Review audit logs monthly

Data Privacy:

  • Student data stored locally in browser
  • No data sent to third parties
  • Optional Firebase backup (fully controlled by you)
  • QR codes contain minimal data

📊 System Limits

Item Limit
Students Unlimited (browser storage ~10MB)
Semesters 8 per student
Subjects Unlimited per semester
Exams Unlimited
Users Unlimited staff/student accounts

⚙️ Technical Stack

  • Frontend: HTML5, CSS3, Vanilla JavaScript
  • Storage: LocalStorage + Firebase Firestore (optional)
  • Libraries: QRCode.js, html2pdf.js
  • Authentication: Client-side (upgradeable to server-side)

🚀 Future Enhancements

  • Email/SMS result notifications
  • Certificate generator
  • Attendance management
  • Fee management
  • Library management
  • Timetable generator
  • Parent portal
  • Mobile app (React Native)

📝 License & Disclaimer

This software is developed for educational purposes. Provided as-is — maintain regular backups and do not rely solely on browser storage for critical data.

Libraries Used


🔄 Version History

v2.0 (Current)

  • Role-based access control
  • Exam management system
  • Subject control feature
  • Advanced developer console
  • Bulk operations & analytics
  • Theme customization
  • Cloud backup (Firebase)

v1.0

  • Basic marksheet generation
  • Student search & PDF export
  • Local storage

Last Updated: January 2026 | Version: 2.0

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors