AshrayOS - Hostel Management System

AshrayOS is a robust, full-stack hostel management system built to simplify and automate day-to-day hostel operations for administrators, wardens, and students. Featuring secure authentication and role-based portals, AshrayOS enables seamless management of room allocations, complaints, guest requests, and laundry services in a user-friendly interface.

Deployed App: AshrayOS

🚀 Key Features

🔐 Secure Authentication System

The system provides secure login functionality for all user types with role-based access control. Users can authenticate as Students, Wardens, or Administrators, each with tailored access permissions and interface customizations.

Authentication Features:

Role-based login (Student/Warden/Admin)
Secure session management
Password encryption
Automatic logout for security

👑 Admin Portal

To login as an Admin you may take the UserID=202303009 and Password=mypassword

🛡️ Warden Management

Comprehensive warden administration:

Add new wardens to the system
View complete warden directory
Remove wardens when necessary
Assign warden responsibilities and permissions

📈 Student Records Management

Advanced student data management:

Access complete student database
Export student records for reporting
Monitor system-wide student activity
Generate comprehensive analytics

🛡️ Warden Portal

The warden portal offers comprehensive oversight tools for managing student requests and hostel operations efficiently

📊 Request Management Dashboard

Centralized request handling system:

Room Change Requests: Review and approve/reject room changes
Leave Applications: Process student leave requests
Complaint Resolution: Address and resolve student complaints
Guest Entry Approval: Manage visitor access requests

👨‍🎓 Student Directory

Complete student information access:

View detailed student profiles
Access room allocation information
Monitor student activity and requests
Generate student reports

🎓 Student Portal

The student portal provides a comprehensive dashboard with intuitive navigation and quick access to all essential hostel services.

📋 Personal Information Management

View Profile: Access complete personal and room information
Room Details: Current room assignment and roommate information
Contact Information: Update personal contact details
Academic Information: View enrolled course and semester details

🏠 Room Change Requests

Students can easily request room changes through an intuitive interface:

Submit new room change requests with reasons
Track application status in real-time
View request history and outcomes
Receive status updates

🎫 Leave Request Management

Streamlined leave application process:

Submit leave requests with dates and reasons
Monitor approval status
View leave history and remaining quota

📝 Complaint Management System

Comprehensive complaint handling with categorized issue reporting:

File complaints by category (Maintenance, Food, Cleanliness, etc.)
Track complaint resolution progress

👥 Guest Visit Management

Efficient guest entry request system:

Register guest visits in advance
Provide visitor details and purpose
Track approval status
Generate visitor passes upon approval

🧺 Smart Laundry Booking System

Advanced laundry management with real-time availability:

Real-time Slot Availability: View available washing machine slots
Time-bound Bookings: Auto-expiring sessions prevent slot hogging
Live Countdown: Track remaining time for current bookings
Flexible Unbooking: Cancel bookings when plans change
Usage History: Track personal laundry usage patterns

🧑‍💻 Technology Stack

Backend: Node.js, Express.js
Frontend: React.js, Vite, React Router DOM
Database: MySQL
Styling: CSS with responsive and accessible UI design

📁 Project Structure

AshrayOS/
├── Server/           # Node.js backend with API and database connection
│   ├── Routes/       # Organized API routes by feature
│   │   ├── auth.js   # Authentication routes
│   │   ├── student.js # Student-specific routes
│   │   ├── warden.js  # Warden-specific routes
│   │   └── admin.js   # Admin-specific routes
│   ├── db.js         # MySQL configuration and connection logic
│   └── index.js      # Entry point for the Express server
│
└── client/           # React frontend
    ├── src/
    │   ├── Components/  # Reusable components grouped by user role
    │   │   ├── Student/ # Student portal components
    │   │   ├── Warden/  # Warden portal components
    │   │   └── Admin/   # Admin portal components
    │   ├── Pages/       # Page components (Login, Dashboard, etc.)
    │   ├── App.jsx      # Main routing logic
    │   └── main.jsx     # React app entry point
    ├── public/          # Static assets
    └── .env           # Environment configuration

⚙️ Getting Started

Prerequisites

Node.js (v18.x or later)
npm (v8.x or later)
MySQL Server (v8.0 or later)

🔧 Backend Setup

Clone the repository:

git clone https://github.com/nidhidodiya1014/AshrayOS.git
cd AshrayOS/Server

Install dependencies:
```
npm install
```

Configure Environment Variables: Create a .env file in the Server directory:

HOST=localhost
USER=your_mysql_user
PASSWORD=your_mysql_password
NAME=ashrayos_db
PORT=3306
JWT_SECRET=your_jwt_secret_key

Database Setup:
- Create MySQL database: CREATE DATABASE ashrayos_db;
- Import the provided SQL schema file
- Ensure all tables are created successfully
Start the server:
```
npm start
```
Server runs on http://localhost:5000

🖥️ Frontend Setup

Navigate to client directory:
```
cd ../client
```
Install dependencies:
```
npm install
```
Configure environment: Create .env file in client directory:
```
VITE_API_BASE_URL=http://localhost:5000
```
Start development server:
```
npm run dev
```
Application opens at http://localhost:5173

🎯 Key System Benefits

For Students

24/7 Access: Submit requests anytime, anywhere
Real-time Tracking: Monitor request status instantly
Digital Records: Maintain complete history of all activities
Efficient Communication: Direct communication with wardens

For Wardens

Centralized Management: Handle all requests from one dashboard
Quick Processing: Streamlined approval workflows
Student Oversight: Complete visibility into student activities
Report Generation: Generate detailed reports for administration

For Administrators

System Overview: Bird's-eye view of entire hostel operations
User Management: Complete control over system users
Analytics: Comprehensive reporting and analytics
Scalability: Easy to scale across multiple hostels

🔒 Security & Privacy

Role-based Access: Strict permission controls for different user types

🤝 Contributing

We welcome contributions from the community! Here's how you can help:

Development Setup

Fork the repository
Create a feature branch: git checkout -b feature/amazing-feature
Make your changes and test thoroughly
Commit your changes: git commit -m 'Add amazing feature'
Push to the branch: git push origin feature/amazing-feature
Submit a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for complete details.

✨ Acknowledgments

Developed with ❤️ by Nidhi Dodiya

🔗 Links & Resources

GitHub Repository: AshrayOS

Last Updated: June 26, 2025

⭐ If you find AshrayOS helpful, please consider giving it a star on GitHub!

Name		Name	Last commit message	Last commit date
Latest commit History 20 Commits
.cph		.cph
.vscode		.vscode
Assets		Assets
Server		Server
client		client
README.md		README.md

NidhiDodiya1014/AshrayOS

Folders and files

Latest commit

History

Repository files navigation