{"id":29427533,"url":"https://github.com/ddubeyyy/smartbustracker","last_synced_at":"2026-04-07T08:01:38.659Z","repository":{"id":304089114,"uuid":"1017688960","full_name":"ddubeyyy/SmartBusTracker","owner":"ddubeyyy","description":"Smart Bus Tracking Web App using Java, JSP/Servlets, and MySQL with role-based login for Admin, Driver \u0026 Student. Supports bus \u0026 route management, simulated tracking, and is fully Dockerized with a Jenkins CI/CD pipeline for automated deployment.","archived":false,"fork":false,"pushed_at":"2025-07-11T05:28:14.000Z","size":2585,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-11T07:22:54.332Z","etag":null,"topics":["docker","dockerfile","github-actions","java","jdbc","jenkins","maven","mysql","spring-boot","tomcat"],"latest_commit_sha":null,"homepage":"","language":"Java","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/ddubeyyy.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-07-11T00:16:20.000Z","updated_at":"2025-07-11T05:31:57.000Z","dependencies_parsed_at":"2025-07-11T07:33:44.445Z","dependency_job_id":null,"html_url":"https://github.com/ddubeyyy/SmartBusTracker","commit_stats":null,"previous_names":["ddubeyyy/smartbustracker"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/ddubeyyy/SmartBusTracker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ddubeyyy%2FSmartBusTracker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ddubeyyy%2FSmartBusTracker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ddubeyyy%2FSmartBusTracker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ddubeyyy%2FSmartBusTracker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ddubeyyy","download_url":"https://codeload.github.com/ddubeyyy/SmartBusTracker/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ddubeyyy%2FSmartBusTracker/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266057171,"owners_count":23870120,"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":["docker","dockerfile","github-actions","java","jdbc","jenkins","maven","mysql","spring-boot","tomcat"],"created_at":"2025-07-12T13:09:20.092Z","updated_at":"2026-04-07T08:01:38.651Z","avatar_url":"https://github.com/ddubeyyy.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚍 Smart Bus Tracking Web App\n\nA web-based Smart Bus Tracking System that helps **students**, **drivers**, and **administrators** track and manage buses in real time. This project aims to increase safety, convenience, and operational efficiency in educational or private transportation systems.\n\n---\n\n## ✨ Key Highlights\n\n- 🔒 Role-based login for Admin, Student, and Driver\n- 🚌 Add/edit buses, drivers, and routes\n- 📍 Track bus status and route\n- 👨‍🏫 Admin dashboard to monitor everything\n- 📦 CI/CD pipeline with Jenkins \u0026 Docker\n- 🌐 Fully deployable using Apache Tomcat\n\n\n\n\n---\n\n## 🔧 Tech Stack\n\n| Layer        | Technologies                                |\n|--------------|---------------------------------------------|\n| Frontend     | HTML, CSS, JSP, JavaScript                  |\n| Backend      | Java (Servlets \u0026 JSP), JDBC, MySQL          |\n| Server       | Apache Tomcat 9                             |\n| DevOps       | Jenkins, Docker, Git, GitHub                |\n| Build Tool   | Maven                                       |\n\n---\n\n## 🧩 Modules \u0026 Features\n\n### 🔐 Authentication\n- ✅ Login and Registration for **Student**, **Driver**, and **Admin**\n- ✅ Password validation and session handling\n- ✅ Role-based redirects\n   Login Page\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"src/main/resources/Screenshot%202025-07-11%20070626.png\" alt=\"Login Page\" width=\"400\"/\u003e\n\u003c/p\u003e\n\n  Register Page\n  \u003cp align=\"center\"\u003e\n  \u003cimg src=\"src/main/resources/Screenshot%202025-07-11%20070641.png\" alt=\"Login Page\" width=\"400\"/\u003e\n\u003c/p\u003e\n\n\n### 👨‍🏫 Admin Panel\n- 🚌 Add, update, delete buses\n- 👨‍✈️ Manage drivers and assign buses\n- 🗺️ Create and assign routes (source, stops, destination)\n- 🧾 View all users, buses, drivers, and routes\n- 📊 Generate reports of daily usage\n  \u003cp align=\"center\"\u003e\n  \u003cimg src=\"src/main/resources/Screenshot%202025-07-11%20070755.png\" alt=\"Login Page\" width=\"600\"/\u003e\n\u003c/p\u003e\n\n### 🎓 Student Panel\n- 👁️ View assigned bus and its current location\n- 🗺️ See route map (static or simulated)\n- 🔁 Update profile and contact info\n  \u003cp align=\"center\"\u003e\n  \u003cimg src=\"src/main/resources/Screenshot%202025-07-11%20070737.png\" alt=\"Login Page\" width=\"600\"/\u003e\n\u003c/p\u003e\n\n### 👨‍✈️ Driver Panel\n- 🚌 View assigned bus and route details\n- ✅ Mark trip as \"Started\" or \"Completed\"\n- 🧭 Option to update simulated location/status (for now)\n\n  \u003cp align=\"center\"\u003e\n  \u003cimg src=\"src/main/resources/Screenshot%202025-07-11%20070716.png\" alt=\"Login Page\" width=\"600\"/\u003e\n\u003c/p\u003e\n\n---\n\n## 🗄️ Database Schema (MySQL)\n\n### `users`\n| Field     | Type     | Description                      |\n|-----------|----------|----------------------------------|\n| id        | INT      | Primary Key                      |\n| name      | VARCHAR  | Full name                        |\n| email     | VARCHAR  | Unique email address             |\n| password  | VARCHAR  | Encrypted password               |\n| role      | ENUM     | 'admin', 'student', 'driver'     |\n| address   | TEXT     | Address (optional)               |\n\n### `buses`\n| Field       | Type     | Description                   |\n|-------------|----------|-------------------------------|\n| id          | INT      | Primary Key                   |\n| bus_number  | VARCHAR  | Unique Bus Number             |\n| driver_id   | INT      | Linked to `users.id`          |\n| route_id    | INT      | Linked to `routes.id`         |\n\n### `routes`\n| Field       | Type     | Description                   |\n|-------------|----------|-------------------------------|\n| id          | INT      | Primary Key                   |\n| source      | VARCHAR  | Starting point                |\n| destination | VARCHAR  | Endpoint                      |\n| stops       | TEXT     | Intermediate stop points      |\n\n---\n\n## 📂 Project Structure\n\n```plaintext\nSmartBusTracker/\n├── src/\n│   └── main/\n│       ├── java/\n│       │   └── servlets/         # Login, Register, Dashboard, Controllers\n│       └── webapp/\n│           ├── WEB-INF/\n│           │   └── web.xml       # Servlet mapping\n│           ├── jsp/\n│           │   ├── login.jsp\n│           │   ├── register.jsp\n│           │   ├── admin-dashboard.jsp\n│           │   ├── student-dashboard.jsp\n│           │   └── driver-dashboard.jsp\n│           └── assets/           # CSS, JS, images\n├── pom.xml\n├── Dockerfile\n├── Jenkinsfile\n└── README.md\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fddubeyyy%2Fsmartbustracker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fddubeyyy%2Fsmartbustracker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fddubeyyy%2Fsmartbustracker/lists"}