{"id":28493494,"url":"https://github.com/nazmusweb-coding/bus-management-system","last_synced_at":"2026-01-31T15:34:39.311Z","repository":{"id":291498001,"uuid":"977800792","full_name":"nazmusweb-coding/Bus-Management-System","owner":"nazmusweb-coding","description":null,"archived":false,"fork":false,"pushed_at":"2025-05-27T20:43:30.000Z","size":26875,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-08T11:43:17.254Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/nazmusweb-coding.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":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-05T01:28:03.000Z","updated_at":"2025-05-27T20:43:33.000Z","dependencies_parsed_at":"2025-05-05T02:36:32.255Z","dependency_job_id":"60d72e3f-a479-433f-9bd2-f7888cb78a6c","html_url":"https://github.com/nazmusweb-coding/Bus-Management-System","commit_stats":null,"previous_names":["nazmusweb-coding/bus-management-system"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/nazmusweb-coding/Bus-Management-System","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nazmusweb-coding%2FBus-Management-System","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nazmusweb-coding%2FBus-Management-System/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nazmusweb-coding%2FBus-Management-System/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nazmusweb-coding%2FBus-Management-System/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nazmusweb-coding","download_url":"https://codeload.github.com/nazmusweb-coding/Bus-Management-System/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nazmusweb-coding%2FBus-Management-System/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28946778,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-31T14:26:55.697Z","status":"ssl_error","status_checked_at":"2026-01-31T14:26:52.545Z","response_time":128,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":[],"created_at":"2025-06-08T09:09:10.345Z","updated_at":"2026-01-31T15:34:39.306Z","avatar_url":"https://github.com/nazmusweb-coding.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Bus Management System\n\nA **Bus Management System** built using **Python** and the **Django** web framework. This backend-focused project implements full CRUD functionality with a structured database. The system allows users to book bus tickets, view invoices, check bus availability, and manage bookings, while admins have full control over bus data through the Django admin panel.\n\n## Features\n\n### User Features:\n\n* **Signup / Signin**: New users can register and log in to their accounts.\n* **Book Tickets**: Book bus tickets by selecting destination, time, and available seats.\n* **Invoice Generation**: View booking details and download invoices.\n* **Availability Check**: Check bus availability for specific routes and times.\n* **Cancel Booking**: Cancel existing bookings and see status in user dashboard.\n* **See Bookings**: View current and past bookings, along with status.\n\n### Admin Features:\n\n* **Admin Panel**: Access Django's built-in admin interface.\n* **Manage Section**: Centralized tools for admin-level operations:\n  - **Manage Buses**: Add, update, and delete bus details.\n  - **Bookings**: View and manage all user bookings.\n  - **Booking Details**: Inspect detailed records of each booking.\n  - **Blog**: Post travel updates, announcements, and notices.\n  - **Gallery**: Upload and manage images related to buses or services.\n* **Monitor Bookings**: Track booking statuses and user activity.\n* **Custom Booking**: Manually create or cancel bookings as an admin.\n* **Seat Auto-Allocation**: Automatically assign seats if none are specified.\n* **Monitor Bookings**: View all user bookings and statuses.\n\n## Technologies Used\n\n* **Backend**: Django (Python)\n* **Frontend**: HTML5, Tailwind CSS, JavaScript\n* **Database**: SQLite (default), easily extendable to PostgreSQL or MySQL\n* **Deployment**: Compatible with platforms like PythonAnywhere\n\n## Installation\n\n1. **Clone the repository**\n\n```bash\nhttps://github.com/nazmusweb.coding/bus-management-system.git\n```\n\n2. **Navigate to the project directory**\n\n```bash\ncd Bus-Management-System/myproject\n```\n\n3. **Create a virtual environment**\n\n```bash\npython -m venv env\nsource env/bin/activate  # On Windows use `env\\Scripts\\activate`\n```\n\n4. **Install dependencies**\n\n```bash\npip install -r requirements.txt\n```\n\n5. **Apply migrations**\n\n```bash\npython manage.py migrate\n```\n\n6. **Create a superuser**\n\n```bash\npython manage.py createsuperuser\n```\n\n7. **Run the development server**\n\n```bash\npython manage.py runserver\n```\n\n8. **Access the application**\n\n* User Interface: `http://127.0.0.1:8000/`\n* Admin Panel: `http://127.0.0.1:8000/admin/`\n* Live Host (until Saturday, 16 August 2025): `https://nazmusweb.pythonanywhere.com/`\n\n## Screenshots\n\n### Homepage\n\n| Desktop View                              | Mobile View                               |\n|-------------------------------------------|-------------------------------------------|\n| ![Desktop](readme_images/image.png)       | ![Mobile](readme_images/image-1.png)      |\n\n### Available Buses\n\n| Desktop View                                  | Mobile View                                   |\n|-----------------------------------------------|-----------------------------------------------|\n| ![Desktop](readme_images/image-2.png)         | ![Mobile](readme_images/image-3.png)          |\n\n### Admin - Manage Buses\n\n| Desktop View                                     | Mobile View                                      |\n|--------------------------------------------------|--------------------------------------------------|\n| ![Desktop](readme_images/image-4.png)            | ![Mobile](readme_images/image-5.png)             |\n\n\n## Contributing\n\nPull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.\n\n## License\n\nThis project is licensed under the MIT License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnazmusweb-coding%2Fbus-management-system","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnazmusweb-coding%2Fbus-management-system","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnazmusweb-coding%2Fbus-management-system/lists"}