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

Watchers

Forks

Releases

Packages

Contributors

Languages