Skip to content

sheisstarwithoutmoon/HostelManagement

Repository files navigation

Hostel Management System

Overview

The Hostel Management System is a comprehensive Flutter-based application designed to streamline the management of hostels. It supports both student and warden functionalities, providing an efficient way to handle complaints, announcements, room allocations, and other hostel-related tasks.

Features

For Students:

  • Complaint Registration: Easily lodge complaints and track their status.
  • Announcements: View important announcements from the warden.
  • Washing Machine Availability: Check the status of washing machines.
  • Dashboard: A unified space for all student-related features.

For Wardens:

  • Complaint Management: View and resolve complaints lodged by students.
  • Post Announcements: Share updates and important information with students.
  • Room Allocation: Allocate and manage room details for students.
  • Dashboard: A centralized hub for all warden-related tasks.

Directory Structure

sheisstarwithoutmoon-HostelManagement/
├── lib/
│   ├── main.dart                    # Entry point of the app
│   ├── routes.dart                  # Route management
│   ├── Models/                      # Data models for app entities
│   ├── FastApi/                     # API services and providers
│   ├── student/                     # Screens and logic for student features
│   ├── warden/                      # Screens and logic for warden features
│   └── data/                        # Sample data for testing
├── android/                         # Android-specific files
├── ios/                             # iOS-specific files
├── linux/                           # Linux-specific files
├── macos/                           # macOS-specific files

Technologies Used

  • Frontend: Flutter
  • Backend: FastAPI

Installation

  1. Clone the repository:
    git clone https://github.com/yourusername/HostelManagement.git
  2. Navigate to the project directory:
    cd HostelManagement
  3. Install dependencies:
    flutter pub get
  4. Run the application:
    flutter run

Contribution

Contributions are welcome! Please follow these steps:

  1. Fork the repository.
  2. Create a new branch for your feature or bug fix.
  3. Commit your changes and push to your forked repository.
  4. Open a pull request with a detailed description of your changes.

License

This project is licensed under the MIT License.


Built with Flutter and FastAPI to simplify hostel management.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published