Skip to content

A paperless reservation and queue system for classroom equipment like projectors, white screens, and AVRs.

License

Notifications You must be signed in to change notification settings

icodecedd/ReQuestor

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ReQuestor

Reservation Queue System for Classroom Equipment

Smart Requests. Seamless Reservations.


React Chakra UI Vite Node.js Express
PostgreSQL Supabase JWT License


📊 Project Status

Active Development Version 1.0.0

Under Development — ReQuestor is an upcoming web-based reservation and queue management platform designed to replace outdated paper-based equipment request forms with a streamlined, digital-first experience.


📖 Overview

ReQuestor is built for academic institutions such as PUP San Juan to simplify and modernize classroom equipment reservations — from projectors to white screens and beyond.

Key Benefits

  • 📄 Paperless Process – Submit reservation requests online in seconds.
  • ⏱ Fair Queueing System – First-come, first-served with timestamp-based ordering.
  • 🔎 On-Demand Availability Checker – Select your desired date, time, and equipment to instantly see what’s available.
  • 🛠 Admin Dashboard – Approve, reject, or cancel bookings with one click.
  • 🔔 Notifications – Email and in-app updates for every request status change.

✨ Features by User Role

👩‍🎓 Student / Requestor 🧑‍💼 Admin
Fully responsive interface for mobile, tablet, and desktop Desktop-first interface for efficient management
Submit equipment reservation requests online View, approve, reject, or cancel equipment requests
View request status (Pending, Approved, In Use, Returned) Manage equipment inventory and availability status
Use the On-Demand Availability Checker to confirm equipment availability before booking Track ongoing and upcoming reservations
Cancel pending requests before approval Configure reservation rules (e.g., max duration, advance booking time)

💡 Design Note:
The Student side of ReQuestor is fully responsive and optimized for mobile, tablet, and desktop devices.
The Admin dashboard is designed primarily for desktop use, given that most administrative workflows occur on larger screens for better visibility and data management efficiency.


🛠 Tech Stack

Tech Stack Overview Includes Frontend/Backend/Database/Auth/CI-CD

Layer Technology Description
Frontend React, Chakra UI, Vite Handles the user interface and interactive components with modern web frameworks.
Backend Node.js, Express Manages server-side logic, API endpoints, and request handling.
Database Supabase (PostgreSQL) Stores structured data securely and provides real-time database functionality.
Auth JWT Provides secure authentication and authorization for users.
CI/CD GitHub Actions Automates testing, building, and deployment pipelines for continuous integration.

🚀 Features

✅ Completed

  • User Accounts – Role-based access (Admin, Student)
  • Queue Management – Track requests through Pending → Approved → In Use → Returned stages
  • Admin Panel – Review, approve, reject, or cancel requests
  • Inventory Management – Admins can add, edit, or remove equipment items
  • Basic Reservation Rules – Prevent overlapping schedules and enforce availability
  • Advanced Search & Filters – Find requests by date, status, or equipment type

🔄 In Progress

  • Online Reservation Form – Fully paperless booking process
  • Email & In-App Notifications – Keep users informed instantly
  • Configurable Booking Settings – Admin-defined max booking time and advance request limits
  • Student Dashboard – View personal booking history, status updates, and announcements
  • Responsive Student UI – Mobile, tablet, and desktop optimization for requestors

🤝 Contributing

We Welcome Contributions

We love collaboration! Here’s how you can contribute:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature-name)
  3. Commit your changes (git commit -m 'Add new feature')
  4. Push to your branch (git push origin feature-name)
  5. Open a Pull Request

📢 Support the project and help improve campus resource management! 📢

Built for Campus Efficiency

GitHub Repo stars GitHub forks

© 2025 ReQuestor - Polytechnic University of the Philippines San Juan Campus

About

A paperless reservation and queue system for classroom equipment like projectors, white screens, and AVRs.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages