anshu-6537/resimate

Some Updates left

ResiMate - Hostel Management App

ResiMate is a comprehensive Android application developed in Kotlin with XML for layout design, using Firebase for real-time backend services. The app is tailored for college hostels, enabling wardens to manage room registrations, update mess menus, upload notices, and handle student complaints, while providing students with a convenient platform for communication and updates.

Table of Contents

• Introduction
• Features
• Getting Started
  • Prerequisites
  • Installation
• Usage
• Firebase Configuration
• Contributing
• License
• Contact

Introduction

ResiMate facilitates hostel management, allowing wardens to efficiently handle room registrations, mess menu updates, notice uploads, and student complaints. Students can use the app for communication and access important hostel-related information.

Features

For Wardens (Admin)

• Room Registration: Admins can register students in their respective rooms.
• Mess Menu Updates: Easily update and manage the hostel mess menu.
• Notice Board: Upload important notices for students to view.
• Student Complaints: Receive and manage complaints from students.

For Students

• Room Allocation: View room allocation and other relevant details.
• Mess Menu: Access the latest mess menu updates.
• Notice Board: Stay informed with important notices.
• Complaint Submission: Submit complaints or feedback to hostel administration.

Getting Started

Prerequisites

Before you begin, ensure you have the following installed:

• Android Studio
• Firebase Account and Project

Installation

1. Clone the repository:

   git clone https://github.com/anshu-6537/ResiMate.git

2. Open the project in Android Studio.

Build and run the application on an emulator or physical device.

Usage :-

Wardens:

1. Log in with admin credentials.
2. Navigate through the admin dashboard for room registrations, mess menu updates, notices, and complaints.

Students:

1. Log in with student credentials.
2. Access information about room allocation, mess menu, notices, and submit complaints.
3. Firebase Configuration
4. ResiMate uses Firebase for backend services. Follow these steps to configure Firebase:

Create a Firebase project.

Add an Android app to your Firebase project and follow the setup instructions. Download the google-services.json file and place it in the app directory of your Android Studio project. Contributing Contributions are welcome! Please follow the Contributing Guidelines for details on how to contribute to this project.

License

This project is licensed under the MIT License.

Contact

Have questions or suggestions? Feel free to reach out:

Email: [email protected]