{"id":20306946,"url":"https://github.com/ctoic/hostel-management-system-using-flask","last_synced_at":"2025-04-11T15:06:36.620Z","repository":{"id":243985899,"uuid":"809695174","full_name":"Ctoic/Hostel-Management-System-Using-Flask","owner":"Ctoic","description":"Application to streamline your hostel buisness. ","archived":false,"fork":false,"pushed_at":"2024-12-24T09:35:56.000Z","size":33649,"stargazers_count":3,"open_issues_count":19,"forks_count":8,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-25T11:11:31.830Z","etag":null,"topics":["contributions-welcome","css3","flask","good-first-issue","hacktoberfest","hacktoberfest2024","html","javascript","python3","sqlite3","web"],"latest_commit_sha":null,"homepage":"https://hostel-management-system-using-flask.vercel.app","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Ctoic.png","metadata":{"files":{"readme":"Readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-06-03T09:15:56.000Z","updated_at":"2025-03-17T06:15:19.000Z","dependencies_parsed_at":"2024-10-19T23:44:36.260Z","dependency_job_id":"f3bf9666-7eaf-4f57-9b1c-715421215a64","html_url":"https://github.com/Ctoic/Hostel-Management-System-Using-Flask","commit_stats":null,"previous_names":["ctoic/hostel-management-system-using-flask"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ctoic%2FHostel-Management-System-Using-Flask","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ctoic%2FHostel-Management-System-Using-Flask/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ctoic%2FHostel-Management-System-Using-Flask/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ctoic%2FHostel-Management-System-Using-Flask/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Ctoic","download_url":"https://codeload.github.com/Ctoic/Hostel-Management-System-Using-Flask/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248429078,"owners_count":21101782,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["contributions-welcome","css3","flask","good-first-issue","hacktoberfest","hacktoberfest2024","html","javascript","python3","sqlite3","web"],"created_at":"2024-11-14T17:15:36.788Z","updated_at":"2025-04-11T15:06:36.598Z","avatar_url":"https://github.com/Ctoic.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Hostel Management System\n\nThis is a Flask-based web application for managing a hostel. It includes functionalities for enrolling students, managing rooms, tracking expenses, and more.\n\n## Features\n\n- Enroll students with details including name, fee, room number, and picture.\n- Manage rooms and see which students are assigned to which rooms.\n- Track monthly expenses by adding items and their prices.\n- View a list of all students and rooms.\n- Responsive design using Bootstrap.\n\n## Technologies Used\n\n- [Python](https://www.python.org/)\n- [Flask](https://flask.palletsprojects.com/en/3.0.x/)\n- [SQLAlchemy](https://www.sqlalchemy.org/)\n- [Flask-WTF](https://flask-wtf.readthedocs.io/en/1.2.x/)\n- [Bootstrap](https://getbootstrap.com/docs/5.3/getting-started/introduction/)\n- [SQLite](https://www.sqlite.org/)\n- [Pipenv](https://pipenv.pypa.io/en/latest/)\n\n## Recommended Dev Tools\n\n- [VS Code](https://code.visualstudio.com/download)\n- [Black Formatter](https://code.visualstudio.com/docs/python/formatting)\n\n## Setup and Installation\n\n1. Clone the repository:\n\n   ```bash\n   git clone https://github.com/yourusername/Hostel-Management-System-Using-Flask.git\n   cd Hostel-Management-System-Using-Flask\n   ```\n\n2. Create a virtual environment and activate it (virtual environment directory name is `.venv`):\n\n   ```bash\n   python3 -m venv .venv\n   source .venv/bin/activate  # On Windows use `.venv\\Scripts\\activate`\n   ```\n\n3. Install `pipenv` package manager\n\n   ```bash\n   pip install pipenv\n   ```\n\n4. Install the dependencies:\n\n   ```bash\n   pipenv install\n   ```\n\n5. Initialize the database:\n\n   ```bash\n   flask db init\n   flask db upgrade\n   ```\n\n6. Run the application:\n\n   ```bash\n   flask run\n   ```\n\n7. Open your browser and navigate to `http://127.0.0.1:5000`.\n\n## Application Structure\n\n- `app.py`: Main application file containing routes and logic.\n- `models.py`: Database models for Student, Room, and Expense.\n- `forms.py`: Forms for enrolling students and adding expenses.\n- `templates/`: HTML templates for the application pages.\n- `static/`: Static files including CSS and images.\n- `migrations/`: Database migration files.\n\n## Routes\n\n- `/`: Home page with links to enroll, view students, view rooms, and manage expenses.\n- `/enroll`: Form to enroll a new student.\n- `/students`: List of all enrolled students.\n- `/rooms`: List of all rooms and their assigned students.\n- `/expenses`: Form to add expenses and view total monthly expenses.\n\n## License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for more details.\n\n## Contributing\n\nContributions are welcome! Please open an issue or submit a pull request.\n\n## Contact\n\nFor any questions or suggestions, please contact [najamabass2020@gmail.com](mailto:your-email@example.com).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fctoic%2Fhostel-management-system-using-flask","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fctoic%2Fhostel-management-system-using-flask","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fctoic%2Fhostel-management-system-using-flask/lists"}