Skip to content

Repository files navigation

🟣 UniAssist – University Support Platform

A modern web-based platform to report, track, and manage campus issues efficiently — all in one place.

📌 Overview

UniAssist is a centralized university support system designed to streamline communication between students and administration.

It allows users to:

  • Report issues
  • Track complaint status
  • Submit feedback
  • Navigate using a built-in assistant

This project is developed as a Software Engineering academic prototype, focusing on UI/UX, workflow, and system design.

🎯 Objectives

  • Provide a centralized issue reporting system
  • Enable structured complaint tracking
  • Collect user feedback effectively
  • Simulate a real-world dashboard-based web application
  • Demonstrate frontend + workflow integration

🎨 UI / UX Design

  • Theme: Dark Blue / Purple gradient + White
  • Font: Clean modern typography (Inter-style)
  • Layout:
    • Sidebar navigation (left)
    • Top control bar
    • Card-based content sections

🧱 Tech Stack

  • Frontend: HTML, CSS, JavaScript
  • Framework: Vite
  • Styling: Tailwind CSS
  • Data Handling: LocalStorage / Mock Data

🔐 Authentication

  • Login-based access system
  • Validates university email (e.g., @srmist.edu.in)
  • Basic input validation and error handling

🚀 Features

🔑 1. Login Page

  • Split-screen design (Purple + White)
  • Email & password authentication
  • Demo login guidance
  • Clean and modern UI

📊 2. Dashboard

  • Overview of system activity
  • Statistics:
    • Total Issues
    • Pending Issues
    • Resolved Issues
  • Quick action buttons
  • Recent activity feed

📝 3. Register Issue

  • Submit new issues with:
    • Title, Category, Priority
    • Description
    • File upload (optional)
    • Student ID
  • Form validation and confirmation

📋 4. Issue Tracker

  • View all submitted issues
  • Status tracking:
    • Pending
    • Under Review
    • In Progress
    • Resolved
  • Filters for better navigation

📢 5. Complaints Module

  • View and manage complaints
  • Track complaint status
  • Simulated admin updates

⭐ 6. Feedback System

  • Rating-based feedback:
    • Very Poor → Excellent
  • Star rating (1–5)
  • Category selection
  • Optional comments

🤖 7. Chatbot Assistant

  • Floating support assistant
  • Rule-based responses
  • Helps navigate features:
    • Report Issue
    • Track Issues
    • Submit Complaint
    • Give Feedback

🌙 8. Dark Mode

  • Toggle between light and dark themes
  • Enhances accessibility and UI experience

🔄 System Flow

  1. User logs in
  2. Dashboard loads
  3. User selects an action:
    • Register issue
    • Track issues
    • Submit complaint
    • Give feedback
  4. Data is stored (mock/local)
  5. Status updates are reflected in tracker

💾 Data Handling

  • Uses LocalStorage / mock JSON
  • Stores:
    • Issues
    • Complaints
    • Feedback

🧪 Testing Scope

  • Functional testing (forms, tracking)
  • UI testing (navigation, responsiveness)
  • Validation testing (inputs & error handling)

⚠️ Limitations

  • Not production-ready
  • No real backend authentication
  • No real-time database (unless extended)
  • Chatbot is rule-based (not AI-powered)

📸 Screenshots

🔐 Login Page

Login Page

❌ Invalid Email Validation

Email Mislogin

📊 Dashboard

Dashboard

📝 Register Issue

Register Issue

📋 Issue Tracker (Student View)

Issue Tracker Student

📋 Issue Tracker (Admin View)

Admin Issue Tracker

📋 Issue Timeline View

Issue Timeline

📢 Complaints Module

Complaints Overview

📢 Complaints Detailed Page

Complaints Page

⭐ Feedback System

Feedback

🎨 UI Design (Figma Prototypes)

📊 Dashboard Design

Figma Dashboard

🔐 Login Design

Figma Login

📝 Register Issue Design

Figma Register Issue

📅 Project Management (MS Planner)

Used Microsoft Planner to organize tasks, track progress, and manage sprint workflow.

🔗 Planner Board:
https://planner.cloud.microsoft/webui/plan/eec2q2TmSEmYjZdlnpXgXMkAHSGI/view/board?tid=813e6569-4e44-4d95-88a0-16a97bd5277c

🛠️ Setup & Run

# Install dependencies
npm install

# Run development server
npm run dev

About

UniAssist – University Issue Management System

Resources

Stars

1 star

Watchers

0 watching

Forks

Contributors

Languages