https://github.com/ddubeyyy/smartbustracker
Smart Bus Tracking Web App using Java, JSP/Servlets, and MySQL with role-based login for Admin, Driver & Student. Supports bus & route management, simulated tracking, and is fully Dockerized with a Jenkins CI/CD pipeline for automated deployment.
https://github.com/ddubeyyy/smartbustracker
docker dockerfile github-actions java jdbc jenkins maven mysql spring-boot tomcat
Last synced: 5 months ago
JSON representation
Smart Bus Tracking Web App using Java, JSP/Servlets, and MySQL with role-based login for Admin, Driver & Student. Supports bus & route management, simulated tracking, and is fully Dockerized with a Jenkins CI/CD pipeline for automated deployment.
- Host: GitHub
- URL: https://github.com/ddubeyyy/smartbustracker
- Owner: ddubeyyy
- Created: 2025-07-11T00:16:20.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-07-11T05:28:14.000Z (7 months ago)
- Last Synced: 2025-07-11T07:22:54.332Z (7 months ago)
- Topics: docker, dockerfile, github-actions, java, jdbc, jenkins, maven, mysql, spring-boot, tomcat
- Language: Java
- Homepage:
- Size: 2.47 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# π Smart Bus Tracking Web App
A 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.
---
## β¨ Key Highlights
- π Role-based login for Admin, Student, and Driver
- π Add/edit buses, drivers, and routes
- π Track bus status and route
- π¨βπ« Admin dashboard to monitor everything
- π¦ CI/CD pipeline with Jenkins & Docker
- π Fully deployable using Apache Tomcat
---
## π§ Tech Stack
| Layer | Technologies |
|--------------|---------------------------------------------|
| Frontend | HTML, CSS, JSP, JavaScript |
| Backend | Java (Servlets & JSP), JDBC, MySQL |
| Server | Apache Tomcat 9 |
| DevOps | Jenkins, Docker, Git, GitHub |
| Build Tool | Maven |
---
## π§© Modules & Features
### π Authentication
- β
Login and Registration for **Student**, **Driver**, and **Admin**
- β
Password validation and session handling
- β
Role-based redirects
Login Page
Register Page
### π¨βπ« Admin Panel
- π Add, update, delete buses
- π¨ββοΈ Manage drivers and assign buses
- πΊοΈ Create and assign routes (source, stops, destination)
- π§Ύ View all users, buses, drivers, and routes
- π Generate reports of daily usage
### π Student Panel
- ποΈ View assigned bus and its current location
- πΊοΈ See route map (static or simulated)
- π Update profile and contact info
### π¨ββοΈ Driver Panel
- π View assigned bus and route details
- β
Mark trip as "Started" or "Completed"
- π§ Option to update simulated location/status (for now)
---
## ποΈ Database Schema (MySQL)
### `users`
| Field | Type | Description |
|-----------|----------|----------------------------------|
| id | INT | Primary Key |
| name | VARCHAR | Full name |
| email | VARCHAR | Unique email address |
| password | VARCHAR | Encrypted password |
| role | ENUM | 'admin', 'student', 'driver' |
| address | TEXT | Address (optional) |
### `buses`
| Field | Type | Description |
|-------------|----------|-------------------------------|
| id | INT | Primary Key |
| bus_number | VARCHAR | Unique Bus Number |
| driver_id | INT | Linked to `users.id` |
| route_id | INT | Linked to `routes.id` |
### `routes`
| Field | Type | Description |
|-------------|----------|-------------------------------|
| id | INT | Primary Key |
| source | VARCHAR | Starting point |
| destination | VARCHAR | Endpoint |
| stops | TEXT | Intermediate stop points |
---
## π Project Structure
```plaintext
SmartBusTracker/
βββ src/
β βββ main/
β βββ java/
β β βββ servlets/ # Login, Register, Dashboard, Controllers
β βββ webapp/
β βββ WEB-INF/
β β βββ web.xml # Servlet mapping
β βββ jsp/
β β βββ login.jsp
β β βββ register.jsp
β β βββ admin-dashboard.jsp
β β βββ student-dashboard.jsp
β β βββ driver-dashboard.jsp
β βββ assets/ # CSS, JS, images
βββ pom.xml
βββ Dockerfile
βββ Jenkinsfile
βββ README.md