Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sanjinkurelic/capitalbusconnect
Capital Bus Connect (CBC) is website for buying bus tickets using PayPal and viewing travel history.
https://github.com/sanjinkurelic/capitalbusconnect
aspectj expression-language gulp hibernate hibernate-orm hibernate-validator htmlcompressor jackson java jdk11 jpa2 jstl p6spy sass servlet servlet-jsp spring spring-data-jpa spring-mvc spring-security
Last synced: about 1 month ago
JSON representation
Capital Bus Connect (CBC) is website for buying bus tickets using PayPal and viewing travel history.
- Host: GitHub
- URL: https://github.com/sanjinkurelic/capitalbusconnect
- Owner: SanjinKurelic
- License: mit
- Created: 2019-03-08T20:39:52.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2022-02-13T21:56:16.000Z (almost 3 years ago)
- Last Synced: 2024-11-06T19:25:13.514Z (3 months ago)
- Topics: aspectj, expression-language, gulp, hibernate, hibernate-orm, hibernate-validator, htmlcompressor, jackson, java, jdk11, jpa2, jstl, p6spy, sass, servlet, servlet-jsp, spring, spring-data-jpa, spring-mvc, spring-security
- Language: Java
- Homepage:
- Size: 36.7 MB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Capital Bus Connect
Capital Bus Connect (CBC) is a website for buying bus tickets using PayPal or cash with ability of viewing travel history. CBC is written in Java using Spring and Hibernate framework. CBC is separated into 3 Maven modules that separate repository, business and presentation layer.
## Getting started
Directory *packed* contains a compiled version of the project (WAR file). The database is still required for running a project.
### Prerequisites
CBC is Maven project, which means all dependencies are handled by Maven (list of dependencies is available later in the documentation). For running the project you need to have the following items:
- Java SDK 11 or later - recommended is OpenJDK or [Oracle](https://www.oracle.com/technetwork/java/javase/downloads/jdk11-downloads-5066655.html) for developing only
- Servlet server - recommended is [Apache Tomcat 9](https://tomcat.apache.org/download-90.cgi) or later
- Java IDE - recommended is [Intellij IDEA Ultimate](https://www.jetbrains.com/idea/) (or Eclipse / NetBeans)
- [MySQL Community Server](https://dev.mysql.com/downloads/mysql/) 8 or later - it's also recommended to install MySQL Workbench
- Connector/J - available with MySQL Community Server installer
- [Node.js](https://nodejs.org/en/) 10 or later and NPM 6 or later
### Installing
Install Java SDK, Servlet server and Java IDE with the default options. Set the Java IDE the following instruction from the IDE web page, ex: [Defining Application Servers in IntelliJ IDEA](https://www.jetbrains.com/help/idea/configuring-and-managing-application-server-integration.html). Download and install Node.js - with the installer, you should also get NPM. Run MySQL Community Server Installer and install MySQL Server, MySQL Workbench, Connector/J and MySQL Router. While installing keep the default options - port should be 3306. If your production requires the other port or localhost url you need to change settings in CBC project as described later. After installing, open MySQL Workbench (or terminal) and create a new connection to the database:
```
Workbench menu bar > Database > Connect to database
```
Keep everything as default only set the username and the password as follow:
- database username: **cbcadmin**
- database password: **cbcadmin**
**Important: Setting time zone in hibernate.properties is crucial!** If you are not in **Europe/Zagreb** time zone, then you need to change the time zone in CBC project. In the project, go to:
```
CapitalBusConnect > CapitalBusConnectRepository > src > main > resources > hibernate.properties
```
Change both *hibernate.connection.url* and *hibernate.jdbc.time_zone* with the new time zone value (%2F is "URL code" for the slash). Here you can change other options as well. You could also set the Java IDE to connect to the database but that's optional. Connect to the database and run **database.sql** script which is provided by the project. This script will create required database tables and data for the testing.
After installing everything, open project as the Maven project and run Maven. Maven will install all required libraries used in this project.Run Node.js/NPM on the project (package.json). Before running the project you could also run **gulpfile.js** (script and style task). This will "compile" SCSS to CSS, uglify JS and combine everything in one file.
## Running
There are two accounts already registered with the downloaded project, which you can use for testing. Credentials of those users are:
*Administrator*:
username: **admin@cbc**
password: **password**
*User*:
username: **[email protected]**
password: **password**
#### Home page
After everything is set if you run the project you'll get to the home page. On the image below you can see how the page looks like on the big screen (ex. desktop PC) and small screen (ex. mobile phone). The web page is fully supported on mobile devices (aka responsive).
The home page consists of several parts: header with a menu (cart link, user page link and selector for changing web page language), banner with a search box, special offers list, traffic information box and a footer with a contact information (which is common to all pages).
There are several languages already included in this project: English, German, Italian and Croatian.
Search bar offers the user ability to search the lines between two cities by a given date. The city name is an autocomplete text box. You can select every capital city in Europe1, except remote ones like capital city of Cyprus, Iceland and Malta. This project uses Pikaday date picker.
#### Special offer page
Except search bar the user can find his or her trip by clicking some of the available special offers. If user clicks on "more" button in special offer list, he or she will be presented with a small description of the destination and buy ticket button.
#### Schedule page
When a user search for the desired destination by a given date, he or she is presented with the bus schedule as shown in the images below. The left image is a desktop version and the right is a mobile site version (note: some schedule items are **removed** from image **for cosmetic purposes**). From this page user can add items to the cart.
#### Cart page
All selected items are stored in the cart. The user can change number of adults and/or children and the cart items will update accordingly. The user can also remove items from the cart. If there are no items in the cart, the user will be presented with a message.
There are two types of payment: **money** (paying in bus) and **PayPal**. If the user is not authenticated he or she will be presented with a login page, before he or she can continue with payment. If the user is authenticated than he or she will be presented with the list of bought items and tickets (see *my travels page*).
#### Login and registration page
Before paying the bus ticket, the user must be authenticated. The user can either login or register a new account. *Name, date of birth, email* and *password* are required fields. *Name* and *surname* can only be alphabetic characters. *Date of birth* must be valid date (the user should be older than 18 years old) and *email* must be a valid email address. The password must be at least 8 characters long and must have at least one number. If some of this rules (or all) are not satisfied the user is presented with an error message as seen in the image below. Except email login you can login with Facebook account (**note:** Facebook login is not available as source code, so it's disabled in this version of CBC).
#### User page
The user page is visible only for the authenticated users. There are several pages on user disposal: Settings page, my travels page and discount page.
#### Settings page
The settings page offers the user ability to change their personal information (except the email address). Validation of user input is same as on the registration page. If the password is left empty, the password will not be updated while saving the form.
#### My travels page
The my travels page is the page where the user can see his or her travel history. By clicking on the ticket button, the server will generate a ticket and QR code for the user. The user is obligated to show his or her ticket in the bus before departure. The user can only view his or her tickets (security feature).
#### Discounts page
The user can receive bonuses/discounts for his loyalty. He or she can use them while buying the tickets. **Note:** This is not available as source code, so it's disabled in this version of CBC.
#### Admin page
The administrator can also login to CBC system. He can view travel statistics, view user login and travel history and they can also edit the bus lines.
#### Statistics page
The administrator can view the total number of passengers and the total number of trips. He can also view which users travel the most and what are the most used bus lines. This information provides better management of the bus lines and gives ability to award the users who travels a lot.
#### Users history page
The user history page show users ordered by login time. The administrator can search for specific users (using the search box) or he can choose from the provided list by clicking on the information button.
By choosing an specific user, the administrator can see his or her login and travel history. By choosing a specific date in the search box, the administrator can see history for that specific day.
#### Routes page
The routes page gives the administrator an ability to change or add bus routes. **Note:** This is not available as source code, so it's disabled in this version of CBC.
#### Error pages
There are several error pages:
- Not found error page - if requested source is not found
- Forbidden error page - if the user is not authenticated or doesn't have required permissions
- Bad request error page - if the user request is malformed2
Example of an error page:
## Dependencies
Maven dependencies:
- Servlet API
- JSP API
- JSTL
- Expression Language
- Google HTML Compressor
- Spring MVC
- Spring ORM
- Spring Test
- Spring Security
- Jackson
- Hibernate Validator
- AspectJ
- Apache Commons
- Hibernate and C3PO
- junit (Jupiter)
- SLF4J
- p6spy
NPM dependencies:
- Autoprefixer
- Gulp
- PostCSS
- SASS
- Uglify
HTML/JS dependencies:
- Pikaday
## Notice
1 Europe is here limited by Russia and Turkey, so Armenia, Azerbaijan and Kazakhstan are not included. There are also countries with limited to no international recognition, which are not included: Abkhazia, Republic of Artsakh, Northern Cyprus, South Ossetia and Transnistria. An exception to this rule is Kosovo because it's located in limited area of Europe (limited by Russia and Turkey) and it's recognized by a greater number of countries than for example Transnistria. I don't want to get into politics with these project, so someone can say that this project doesn't connect all capitals in Europe and that some cities on the list are not a capital city. This information is from 5.5.2019, in the future some data could change which may not reflect information used in this project.
2 The bad request error page can be thrown if the developer has error in his or her code.
## Known issues
The administrator can't view users tickets because he is not an owner of a ticket. Possible solutions are: remove ticket button from the administrator page (not needed) or add line of code in the *TicketService* which allow access for the administrator.
## Licence
See the LICENSE file. For every question write to [email protected]