BusDetails Project

Overview

The BusDetails project is a comprehensive solution designed to streamline the management of bus operations for administrators. This platform enables efficient handling of bus information, including adding, deleting, updating, and viewing bus details. Built with a robust tech stack, the project utilizes Groovy and Grails for server-side operations, Angular for the frontend UI, and MySQL for database management.

Some Screenshot

Features

• Add Bus: Admins can add new bus entries to the system, including details like bus number, route, and timings.
• Delete Bus: Allows for the removal of bus entries from the database.
• Update Bus Details: Admins can modify existing bus information to ensure data is current.
• View Bus Details: Comprehensive view functionality for browsing through bus information.

Technology Stack

• Backend: Groovy + Grails
• Frontend: Angular
• Database: MySQL

Branches Overview

• main: Contains the overall project documentation and general information.
• dev1: Dedicated to the backend API code developed with Groovy and Grails.
• devUI: Focuses on the Angular-based UI code, showcasing frontend development efforts.

Getting Started

Prerequisites

Before you can run the BusDetails project locally, ensure you have the following installed:

• Git: Essential for cloning the repository and managing version control. Download Git.
• Java: Required for running Groovy and Grails. The project is compatible with Java 8. Download Java.
• Groovy: The project uses Groovy version 2.4.7 for server-side scripting. Groovy runs on the JVM, so make sure Java is installed first. Download Groovy.
• Grails: A powerful web application framework based on Groovy. This project uses Grails version 3.2.6. Download Grails.
• JVM: Ensure you have the Java Virtual Machine (JVM) version 1.8.0_181 installed, as it's required for Groovy and Grails.
• Node.js and npm: The project's frontend is developed with Angular, which requires Node.js and npm (Node Package Manager) for dependencies management and to run the development server. Download Node.js and npm.
• MySQL: The project uses MySQL for its database. Ensure you have MySQL installed and properly set up. Download MySQL.

After installing these prerequisites, you're ready to set up and run the project locally.

Setup

1. Clone the repository

   git clone https://github.com/mindexpert7546/busDetails-IIC-Training-Project.git
   

a.Navigate to the project directory

   cd busDetails-IIC-Training-Project

b.Switch to the backend branch (dev1) and set up the server-side

 git checkout dev1

Switch to the frontend branch (devUI) and set up the UI

 git checkout devUI

Running the Application

Backend

Navigate to the backend directory and run:

 ./grailsw run-app

Frontend

Navigate to the frontend directory and run:

 npm start