Hackathon Prototype
This project was built during a limited-time hackathon. Our primary focus was on designing a scalable architecture, implementing the backend, creating an intuitive user interface, and integrating the core modules.
While several core features have been completed, a several planned functionalities are only partially integrated due to time constraints. The project demonstrates the overall vision, architecture, and development approach, and is intended to be extended beyond the hackathon.
git clone https://github.com/<your-username>/TransitOps.git
cd TransitOpsOpen the following file:
backend/config.py
Update the PostgreSQL connection details if needed.
Note
If you're using the provided Docker setup, the default configuration is already configured to work with the Docker containers. In most cases, you only need to update the PostgreSQL password if you've changed it.
Build and start all services:
docker compose up --build -dVerify that the containers are running:
docker psYou should see both containers running successfully.
- backend
- postgres
Populate the database with sample data by running:
docker exec -it backend python -m backend.seedIf the command executes successfully, the database will be populated with dummy data required to explore the application.
If you want to inspect the database using pgAdmin, create a new server with the following configuration:
| Property | Value |
|---|---|
| Host | localhost |
| Port | 5433 |
| Username | postgres |
| Password | Your PostgreSQL Password |
Important
Use Port 5433 instead of 5432. This prevents conflicts with any PostgreSQL instance already installed on your local machine.
Open the application in your browser:
http://localhost:8000/login
Use the default administrator account:
admin@fleet.com
Password
admin123
- PostgreSQL runs inside a Docker container.
- Sample data is not added automatically; run the seed command after starting the containers.
- Swagger API documentation is available at:
http://localhost:8000/docs
- Secure Admin Authentication
- User Creation /deletion
- Driver Creation/deletion
- Vehicle Management
- Route Management
- Database Design using PostgreSQL
- FastAPI Backend
- REST APIs
- Responsive Frontend
- JWT Authentication with access token and refresh token
- Modular Project Structure
- Complete end-to-end integration of all modules
- Live vehicle tracking
- Analytics Dashboard
- Notification System
- Advanced Reporting
- Role-based permissions
- Production deployment
- FastAPI Backend
- PostgreSQL Database
- SQLAlchemy ORM
- JWT Authentication
- HTML
- Tailwind CSS
- JavaScript
- RESTful API Design
- Modular Architecture
This repository represents the hackathon version of the project.
Due to the limited development time available during the event:
- Some modules are partially integrated with databases .
- Certain features are available only as prototypes.
- Additional testing and optimization are required before production deployment.
These limitations are expected for a hackathon prototype and do not reflect the intended final product.
- Complete module integration
- GPS Tracking
- Real-time Notifications
- Analytics Dashboard
- Passenger Mobile Application
- Cloud Deployment
- Performance Optimization
- Security Enhancements
This project was developed with dedication during a hackathon under strict time constraints. The primary objective was to build a strong foundation and demonstrate the feasibility of the proposed solution. We look forward to continuing its development beyond the event.