A final project for ALX Africa Software Engineering Internship

Table of Content

• Overview
• Technologies Used
• Features
• Requirements
• How to Contribute
• Setup and Installation
• Contributors
• Acknowledgment

Overview

About Us

Jil Is A Train Ticketing Website That Offers Travellers An Easy And Convenient Way To Book Their Tickets. We Offer A Wide Range Of Train Tickets, From Local And Regional Trains To High-Speed. We Also Offer A Variety Of Payment Options, So You Can Choose The One That Best Suits Your Needs.

Mission

Jil Is Committed To Making Train Ticketing Easy And Convenient For Customers. We Aim To Provide A Hassle-Free Experience By Offering A Simple And User-Friendly Platform. We Will Continue To Innovate And Improve Our Services So That Our Customers Can Enjoy A Seamless Journey

Live Link: https://jilticketing.onrender.com/

Project Status: in progress

Technologies Used

• Frontend
  

• Backend
  

• Database
  

• Project Mnagement
  

Features

Create Account Users are able to sign up with their email, phone number, facebook and password.

Login Retrieves users sign up details from a database compares the inputted login details and allows authenticated users gain full access to the platform.

Download Users can download their e-tickets.

Pricing Page Users can check the different prices of tickets and pick which one suits them.

Responsive Enables users to access the platform via their various devices without any issues with their display.

Requirements

• An IDE
• Git & GitHub
• A compatibility browser
• Python 3.7+

How to Contribute

• Fork the project repository
  In the project repository on github click the fork button in the upper right corner

• Clone the forked repository to your local machine

  git clone https://github.com/captjay98/jil_ticketing.git

• Navigate to the local directory and open in your IDE/ Text Editor

• In the IDE terminal set upstream branch

  git remote add upstream https://github.com/captjay98/jil_ticketing.git

• Pull upstream

  git pull upstream miyyahhhh

• Create a new branch to make your changes

  git checkout -b <your_branch_name>

• Stage the file After making edits, type the below command in your terminal

  git add <changed_files>

• Commit changes

  git commit -m "your_message"

• Push your local changes

  git push origin <your_branch_name>

• Create a pull request

• Wait till the admin accepts and merges your pull request

Setup and Installation

In your IDE run the following commands in the terminal to setup

• Install environment in the root directory jil_ticketing

  pip install virtualenv

• Create the virtual environment in the same root directory

  virtualenv <environment_name>

• Activate virtual environment

  <environment_name>\scripts\activate

• Install all packages/ Dependencies used

  pip install -r requirements.txt

• Run Migrations when changes are made

  python manage.py migrate

• Run Server

  python manage.py runserver

Contributors

Name
Adefila Islamiyyah Adebimpe
Jamal Umar Ibrahim

Acknowledgment

Appreciating the ALX Africa team for this wonderful initiative. During the course of this program we have been stretched beyond their limits going outside of their comfort zone seeking solutions, which has broaden their scope.